yonlu
96a9dc43d5
- Add 7-SUMMARY.md with implementation details and self-check - Update STATE.md with quick task 007 entry and session context
73 lines
3.4 KiB
Markdown
73 lines
3.4 KiB
Markdown
---
|
|
phase: quick-7
|
|
plan: 1
|
|
subsystem: favorites
|
|
tags: [config, playlist, sort, favorites, full-stack]
|
|
dependency_graph:
|
|
requires: []
|
|
provides: [pin-default-playlist]
|
|
affects: [playlist-view, config-page, favorites-store]
|
|
tech_stack:
|
|
added: []
|
|
patterns: [toggle-config-field, sort-pinning]
|
|
key_files:
|
|
created: []
|
|
modified:
|
|
- backend/favorites/config.go
|
|
- backend/config/config.go
|
|
- frontend/src/store/favorites-store.ts
|
|
- frontend/src/store/controllers/favorites-controller.ts
|
|
- frontend/src/components/playlist-view/playlist-view.ts
|
|
- frontend/src/components/config-page/config-page.ts
|
|
- frontend/wailsjs/go/config/Config.js
|
|
- frontend/wailsjs/go/config/Config.d.ts
|
|
decisions:
|
|
- "Default PinDefault to true for new installs; existing configs without the field get Go zero-value (false) from TOML"
|
|
metrics:
|
|
duration: 10 min
|
|
completed: "2026-03-01"
|
|
---
|
|
|
|
# Quick Task 7: Pin Default Playlist to Top of Playlist View
|
|
|
|
Full-stack pin-to-top feature: PinDefault bool config field, Go getter/setter with event emission, frontend store/controller/view wiring, and config page toggle.
|
|
|
|
## Completed Tasks
|
|
|
|
| # | Task | Commit | Key Changes |
|
|
|---|------|--------|-------------|
|
|
| 1 | Add PinDefault to backend config and expose getter/setter | `6e123bd` | PinDefault field on favorites.Config, Get/SetPinDefaultPlaylist methods, event payload update, applyDefaults with true |
|
|
| 2 | Wire frontend store, controller, playlist-view sort logic, and config page toggle | `e6378e1` | favorites-store pinDefault state + getter/setter, controller delegation, sortedEntries pinning logic, config-page toggle, Wails bindings |
|
|
|
|
## Implementation Details
|
|
|
|
### Backend (Task 1)
|
|
|
|
- Added `PinDefault bool` with `toml:"PinDefault"` tag to `favorites.Config` struct
|
|
- Added `GetPinDefaultPlaylist() bool` — returns `true` when `Favorites` is nil (safe default)
|
|
- Added `SetPinDefaultPlaylist(pin bool) error` — follows existing setter pattern (nil guard, save, emit, log)
|
|
- Updated `emitFavoritesChanged()` to include `"PinDefault"` in the event payload map
|
|
- In `applyDefaults()`, new `favorites.Config` structs are created with `PinDefault: true`
|
|
|
|
### Frontend (Task 2)
|
|
|
|
- **favorites-store.ts**: Added `pinDefault` private field (default `true`), `getPinDefault()` getter, `setPinDefault()` action (optimistic update + backend call), included in `loadConfig()` Promise.all, and event handler reads `data.PinDefault`
|
|
- **favorites-controller.ts**: Added `get pinDefault(): boolean` and `async setPinDefault(pin)` delegating to store
|
|
- **playlist-view.ts**: Updated `sortedEntries` getter — when `this.favCtrl.pinDefault` is true, the playlist matching `this.favCtrl.playlistId` always sorts to index 0, regardless of sort field/direction
|
|
- **config-page.ts**: Added `<config-field type="toggle">` for "Pin to Top" in the Favorites section with `handlePinDefaultChange` handler
|
|
- **Wails bindings**: `GetPinDefaultPlaylist():Promise<boolean>` and `SetPinDefaultPlaylist(arg1:boolean):Promise<void>` (pre-generated)
|
|
|
|
## Deviations from Plan
|
|
|
|
None - plan executed exactly as written.
|
|
|
|
## Verification
|
|
|
|
- [x] `go build ./...` passes (backend compiles)
|
|
- [x] `npx tsc --noEmit` passes (frontend TypeScript compiles)
|
|
- [x] `config-field` supports `type: 'toggle'` (confirmed in config-field.ts)
|
|
|
|
## Self-Check: PASSED
|
|
|
|
All 8 modified files verified on disk. Both task commits (6e123bd, e6378e1) found in git history.
|