chore: keep .impeccable out of git

It holds local Impeccable tool state (the design sidecar and critique
snapshots), not project source.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
yuriy.pandClaude Opus 5.5 committed 2026-10-18 20:28:13 +06:00
1 parent 555d0ca749
commit 9c8ba2a4dc
3 files changed
+1 -650

No files matched your search

+1
View File
@@ -6,3 +6,4 @@
/packaging/arch/pkg /packaging/arch/pkg
/packaging/arch/musyx /packaging/arch/musyx
/packaging/arch/*.pkg.tar.* /packaging/arch/*.pkg.tar.*
/.impeccable
@@ -1,163 +0,0 @@
---
target: whole app (crates/musyx/src)
total_score: 22
max_score: 40
na_heuristics:
p0_count: 1
p1_count: 2
target_identity: "file:/Users/yp/Projects/musyx/crates/musyx/src"
timestamp: 2026-10-18T09-24-01Z
slug: crates-musyx-src
---
Method: dual-agent (A: design review · B: detector + pixel/source evidence). The app is native iced, so the web detector ran only on design/mockup.html. B replaced the browser overlay with contrast measured from snapshot pixels, hit-target measurements and static source scans. The evidence is 21 snapshots: dark/English and light/Russian, sample data, no network.
## Design Health Score
| # | Heuristic | Score | Key Issue |
|---|-----------|-------|-----------|
| 1 | Visibility of System Status | 2 | Every loading state is a grey sentence. Buffering is drawn as a half-alpha pause glyph that renders as a normal one, because the SVG tint drops alpha. The playing row can't show paused. |
| 2 | Match System / Real World | 3 | Copy and Russian plurals are strong. "Tap the heart" is phone wording in a desktop app. Up to three "Go to artist" items appear without names. |
| 3 | User Control and Freedom | 2 | Dislike can't be undone, and nothing lists disliked tracks. One click replaces the queue. The queue is read-only. Esc closes nothing. |
| 4 | Consistency and Standards | 2 | The track menu opens as a centred modal, with no right-click. Space doesn't toggle playback. Play sits in a different place on list screens than on detail screens. |
| 5 | Error Prevention | 2 | The one-click Dislike sits 12px from Like. It skips the track and silently unlikes it. |
| 6 | Recognition Rather Than Recall | 2 | 16 icon-only buttons have no tooltips. Chart is missing from the nav. |
| 7 | Flexibility and Efficiency | 1 | There are no in-app shortcuts, no multi-select, no filter on Liked tracks and no drag reordering. |
| 8 | Aesthetic and Minimalist Design | 3 | The design is quiet and coherent. The hero is repeated on Home and My Wave, and "more" shows on every row. |
| 9 | Error Recovery | 3 | Every failure names the next step and offers "Try again". Failures look the same as loading text. |
| 10 | Help and Documentation | 2 | The sign-in steps and quality explanations are good. There is no shortcut list or tuning hint, and "OAuth token" appears on the first screen. |
| **Total** | | **22/40** | **Acceptable** |
## Design Specificity Verdict
**LLM assessment:** The structure belongs to Yandex Music; the interaction layer could belong to any player. My Wave is the hero, mood, character and language tuning is built in, Dislike sits in the player bar, Plus status and 30-second previews are explained, and "Podcasts and books" mirrors Yandex's catalogue. Aubergine with a single amber, Unbounded and the dotted wordmark make a real identity, and it holds in both themes. But the shell is the standard Spotify layout: a 232px sidebar, pill search, a three-zone player bar and a numbered table with a clock icon over durations. The "tape-deck VU needle" behind the accent appears only in DESIGN.md: nothing in the app moves like a needle. The hero is 14 generic sine lines, identical on Home and My Wave, and they hold still until My Wave plays. The build also loses most of the mockup's character: the Tune button in the hero, display-face chart ranks, the card hover play, the animated equaliser on the playing row, and the live sign-in canvas.
**Deterministic scan:** On design/mockup.html the detector found 10 low-contrast findings, all in the light palette. Nine are `#FFF7E6` on `#A86C05` at 4.1:1, which covers primary buttons and pressed segments. One is `#2E8A55` on white at 4.3:1 ("Plus subscription"). Both carry over to the iced app, and the second is worse there: the sidebar renders on `bg`, not `panel`, so "Подписка Плюс" measures 3.83:1 in pixels. The play-fab finding is mockup-only. The scan found no false positives for the native app. Beyond what the review saw, the measurements show:
- Disabled prev/next render at full `muted`, so the 0.45 alpha is lost.
- The seek rail is 1.13:1 against the player bar, so it is invisible when idle.
- Line borders on ghost buttons and chips are 1.3–1.5:1.
- The danger button is white on `like` at 2.79:1 in dark.
- 19 hardcoded colours sit outside theme.rs, including a non-token `#4A4458`.
- 16 font sizes and 52 spacing values are off the scale.
theme.rs matches DESIGN.md exactly, 10 of 10 tokens.
**Visual overlays:** None. iced exposes no DOM or CDP, so nothing was injected.
## Overall Impression
Musyx is a well-built, disciplined player: the tokens are exact, the copy is excellent in both languages, and the OS integration is real. The weak spot is how the app reacts to input. It ignores the keyboard, routine track actions open a modal, the most destructive one-click action has no undo, and several state changes never reach the screen. The biggest opportunity is to make it behave like a desktop app: keys, right-click, focus, undo. After that, give the VU-needle idea a real form so the identity lives in the controls and not just in the colours.
## What's Working
1. **Token discipline and dark-mode legibility.** Every sampled pixel matched its token. Every dark-mode text pair passes: muted on bg is 6.5:1, accent_ink on accent 8.7:1, accent on bg 9.1:1. The chip, tab and ghost styles are shared by Settings, My Wave and Search.
2. **Copy and localisation craft.**
- 253 keys, none missing in Russian.
- Correct Russian plurals, genitive months and "4,1 млн"-style numbers.
- Quality options state their cost.
- Every error names the next step. "You're still signed in" on the offline screen is exactly the reassurance that moment needs.
3. **Native integration.**
- Media keys and Now Playing through souvlaki.
- A macOS menu-bar mini player that appears only when the window is minimised.
- Lazy track lists that don't rebuild on every position tick.
## Priority Issues
**[P0] There is no keyboard path.**
- *Why:* app.rs:265 subscribes to theme, audio, media keys and timers, and nothing else. Buttons have no focused style, so Tab reaches only text inputs. Space, Cmd/Ctrl+F and Esc do nothing. `topbar::SEARCH_ID` is defined but never focused, even when you click Search. People keep a player open for hours, and a keyboard-only user can't use it at all.
- *Fix:* add an `iced::event::listen_with` keyboard subscription, ignored while a text input has focus:
- Space: play/pause.
- Cmd/Ctrl+F or `/`: focus search.
- Esc: close the sheet, then the drawer, then suggestions.
- Cmd+←/→: previous/next track.
- Cmd+↑/↓: volume.
- Cmd+L: like.
- Cmd+[: back.
- Cmd+1–5: nav items.
Also focus the field on `Navigate(Route::Search)`, and add a focus ring through a focusable wrapper.
- *Suggested command:* /impeccable harden
**[P1] The track menu is a modal centred on the window.**
- *Why:* sheet.rs:40 dims the whole window for routine actions. It lists 8–13 items with one divider, repeats "Go to artist" without names, and stays open after an action. Reordering a playlist means reopening it once per position. There is no right-click, which breaks the most basic desktop convention for a list.
- *Fix:*
- Open the menu from `mouse_area::on_right_press` on rows, or from "…", as a popover at the cursor.
- Use three groups: (Play next, Add to queue) · (Like, Add to playlist…, Don't recommend) · (Go to album, Go to {artist name}).
- Close the menu on action and confirm with a toast.
- Bring back the mockup's grip column for drag reordering.
- *Suggested command:* /impeccable shape
**[P1] Dislike fires on one click, with hidden side effects and no recovery.**
- *Why:* the unlabelled ban icon sits 12px from the heart (player_bar.rs:86). One click skips the track, removes it from Liked tracks (edit.rs:76) and shows a toast with no undo. The Disliked tab from the mockup was dropped, so nothing in the app lists dislikes. A mis-click silently loses a liked track.
- *Fix:*
- Add Undo to the toast: re-like the track and send `DislikeTrack(track, false)`.
- Add a tooltip.
- Space Dislike away from Like.
- Restore the Disliked tab in collection.rs.
- *Suggested command:* /impeccable harden
**[P2] The light theme and the boundaries fail contrast.** The detector and the pixels agree.
- *Why:* light accent_ink on accent is 4.09:1, which covers every primary button and selected chip. Light accent as text is 3.89:1: the playing row, the current track in the drawer, the Lossless badge. ok text is 3.83:1. In both themes, the seek and volume rails are about 1.1–1.2:1 and the line borders 1.3–1.5:1. The dark danger button is 2.79:1. Genre tiles put white text on colours from the API without checking contrast. In light, the selected nav fill is about 1.1:1 against bg, so only the amber icon marks the current page.
- *Fix:*
- Light accent `#8F5B00` (5.4:1 with ink, 5.1:1 on bg).
- Light ok `#25744A`.
- Rail track at `line` or brighter.
- A dark-ink label on the danger button.
- A luminance-based text colour or a scrim on genre tiles.
- A 2–3px amber bar on the active nav row.
- Update DESIGN.md alongside theme.rs.
- *Suggested command:* /impeccable colorize (palette correction), then /impeccable audit
**[P2] Several states never reach the screen.**
- *Why:* `svg::Style::color` ignores alpha. B measured disabled prev/next at full `muted`. The same code path should make the Loading disc look identical to Playing (player_bar.rs:116), and the idle row heart look like an enabled control (track_row.rs:97); these two weren't captured in snapshots. The playing row uses a static glyph, so pause doesn't show. Errors use the loading paragraph style. The album column is cut mid-glyph with no ellipsis ("Солнц", "любов" with the drawer open). On light/RU Home, the two-line subtitle pushes the hero title 14pt into the wave lines.
- *Fix:*
- Pass fully opaque tints that are pre-mixed with the surface instead of using `scale_alpha` on icons.
- Show buffering as a spinner or pulsing ring on the disc.
- Make the playing indicator an animated meter that freezes when paused.
- Give errors an icon and a `like` lead line.
- Add ellipsis truncation or a fade mask for the album column.
- Anchor the wave band to the hero's top, or add a scrim under the title.
- *Suggested command:* /impeccable polish
## Persona Red Flags
**Alex (power user)**
- No shortcuts.
- A single click plays and replaces the queue, so there is no selection or batch "Add to playlist".
- No filter or sort on a Liked list of 1,000+ tracks.
- The queue can't be edited: no remove, reorder or clear.
- Reordering a playlist takes one modal per position.
- Chart is reachable only through Home's "Show all".
- The window title doesn't show the track that is playing.
**Sam (keyboard-only, low vision)**
- Tab reaches no button, and there is no focus indicator.
- 16 icon buttons have no tooltip. iced 0.14 exposes no accessibility tree, so screen readers get nothing; the README should say so.
- Light-theme failures at 3.8–4.1:1.
- The paused and playing states differ only by colour and a static glyph.
- Text sizes are 11.5–12.5pt for the quality badge, the plan line and the player times.
**Jordan (first-timer)**
- Sign-in adds a "Get sign-in code" click before any code appears.
- The QR area is a white card with a grey lock, which reads as locked or broken.
- "OAuth token" appears on the first screen.
- Clicking Search opens a page titled "Browse" with no cursor in the field.
- The microphone icon means lyrics, and nothing labels it.
- First Home is a stack of "Loading…" lines next to a disabled grey play disc that could have offered "Play My Wave".
## Minor Observations
- **Detail pages:** Play and Shuffle sit in a separate right-aligned row with an empty left half (detail.rs:181). On your own playlist, Delete sits next to the title while Play is lower down. Put Play, Shuffle, heart and "…" together in the header, and move Rename, visibility and Delete into "…".
- **Sidebar:** DESIGN.md says it uses the `panel` fill, but it renders on `bg` (app.rs:1037). The playlist list mixes owned and liked playlists without a divider.
- **"More" on rows:** DESIGN.md says it appears on hover, but it is always visible.
- **Volume fill:** it uses `fg`, which makes it the brightest mark in the player bar and pulls attention from the amber progress bar.
- **Scroll position:** the page scrollable has no id and is never reset, so new routes may open at the old offset and Back doesn't restore position. This was not confirmed at runtime.
- **"Show all":** the links use the tab style, which reads as a tab rather than a link.
- **Collection tabs:** the counts pop in one at a time.
- **Off-scale values:** about 16 font sizes (13.5 ×6, 12, 15, 17, 11.5, 9) and 52 spacing values (16 ×9, 9 ×8, 24 ×7) are off the DESIGN.md scale. Either fold them in or record them.
- **Podcasts:** the mockup's "Continue listening" is gone, so there is no resume point for podcasts or audiobooks.
## Questions to Consider
- If the accent is a VU needle, why does nothing move like one? Should the seek or volume control become the needle, with a sweep and settle on each track change, and the generic sine lines retired?
- Home and My Wave show the same hero. Once My Wave is playing, should Home give that space to "Continue" content, or should My Wave simply be the home screen?
- What would Musyx feel like with desktop selection rules: click selects, double-click or Enter plays, Space toggles, right-click opens the menu? Does a one-click Dislike belong in the player bar during a session that lasts hours?
-487
View File
@@ -1,487 +0,0 @@
{
"schemaVersion": 2,
"generatedAt": "2026-10-18T13:49:28+00:00",
"title": "Design System: Musyx",
"extensions": {
"colorMeta": {
"bg": {
"role": "neutral",
"displayName": "Aubergine Graphite",
"canonical": "#1C1A22",
"tonalRamp": [
"#24212B",
"#3F3A4C",
"#5A546D",
"#756D8E",
"#948DA8",
"#B3AEC1",
"#D2D0DB",
"#F1F1F4"
]
},
"panel": {
"role": "neutral",
"displayName": "Casing Panel",
"canonical": "#23202B",
"tonalRamp": [
"#24212C",
"#3F3A4D",
"#5A526F",
"#756B90",
"#948CAA",
"#B3AEC2",
"#D2CFDB",
"#F1F0F4"
]
},
"raised": {
"role": "neutral",
"displayName": "Raised Plate",
"canonical": "#2D2937",
"tonalRamp": [
"#24212C",
"#3F3A4D",
"#5B526F",
"#766B90",
"#958CA9",
"#B4AEC2",
"#D2CFDB",
"#F1F0F4"
]
},
"line": {
"role": "neutral",
"displayName": "Seam",
"canonical": "#3A3546",
"tonalRamp": [
"#24212C",
"#403A4D",
"#5B536E",
"#776C8F",
"#958DA9",
"#B4AEC2",
"#D3CFDB",
"#F2F0F4"
]
},
"fg": {
"role": "neutral",
"displayName": "Label White",
"canonical": "#EEEAF3",
"tonalRamp": [
"#251C31",
"#413156",
"#5E467B",
"#7A5BA0",
"#9880B6",
"#B6A5CB",
"#D4CAE1",
"#F2EFF6"
]
},
"muted": {
"role": "neutral",
"displayName": "Faded Label",
"canonical": "#A39CB0",
"tonalRamp": [
"#25222B",
"#413C4B",
"#5D566B",
"#79708C",
"#9790A6",
"#B6B0C0",
"#D4D0DA",
"#F2F1F4"
]
},
"accent": {
"role": "primary",
"displayName": "Indicator Amber",
"canonical": "#F0B23E",
"tonalRamp": [
"#473006",
"#7D550A",
"#B37A0E",
"#E99E12",
"#F1B545",
"#F5CA7B",
"#F9E0B1",
"#FDF6E7"
]
},
"accent-ink": {
"role": "primary",
"displayName": "Amber Ink",
"canonical": "#2A1D04",
"tonalRamp": [
"#463007",
"#7B550C",
"#B07A11",
"#E69E16",
"#EEB548",
"#F3CA7D",
"#F8E0B3",
"#FDF6E8"
]
},
"like": {
"role": "secondary",
"displayName": "Heart Rose",
"canonical": "#F27286",
"tonalRamp": [
"#460610",
"#7B0B1D",
"#B11029",
"#E61536",
"#EE4862",
"#F37D8F",
"#F8B2BD",
"#FDE8EB"
]
},
"ok": {
"role": "secondary",
"displayName": "Signal Green",
"canonical": "#7FCB9B",
"tonalRamp": [
"#163622",
"#27603C",
"#388956",
"#49B370",
"#71C590",
"#9AD6B0",
"#C3E7D0",
"#EDF8F1"
]
},
"bg-light": {
"role": "neutral",
"displayName": "Aubergine Graphite (light)",
"canonical": "#F3F1F6",
"tonalRamp": [
"#251E2F",
"#403552",
"#5C4C76",
"#786299",
"#9685B1",
"#B5A9C7",
"#D3CCDE",
"#F2EFF5"
]
},
"panel-light": {
"role": "neutral",
"displayName": "Casing Panel (light)",
"canonical": "#FFFFFF",
"tonalRamp": [
"#262626",
"#434343",
"#616161",
"#7E7E7E",
"#9B9B9B",
"#B8B8B8",
"#D5D5D5",
"#F2F2F2"
]
},
"raised-light": {
"role": "neutral",
"displayName": "Raised Plate (light)",
"canonical": "#EAE6F0",
"tonalRamp": [
"#241D30",
"#403354",
"#5C4879",
"#775E9D",
"#9682B4",
"#B4A6CA",
"#D3CBE0",
"#F2EFF5"
]
},
"line-light": {
"role": "neutral",
"displayName": "Seam (light)",
"canonical": "#DCD6E4",
"tonalRamp": [
"#251E2E",
"#413651",
"#5E4D74",
"#7A6498",
"#9886AF",
"#B6A9C7",
"#D4CCDE",
"#F2F0F5"
]
},
"fg-light": {
"role": "neutral",
"displayName": "Label White (light)",
"canonical": "#1F1B27",
"tonalRamp": [
"#241F2D",
"#3F3750",
"#5B4F72",
"#766795",
"#9589AD",
"#B4ABC5",
"#D3CDDD",
"#F1F0F5"
]
},
"muted-light": {
"role": "neutral",
"displayName": "Faded Label (light)",
"canonical": "#686178",
"tonalRamp": [
"#25222A",
"#413C4B",
"#5D566B",
"#78708B",
"#9790A5",
"#B5B0BF",
"#D3D1DA",
"#F2F1F4"
]
},
"accent-light": {
"role": "primary",
"displayName": "Indicator Amber (light)",
"canonical": "#A86C05",
"tonalRamp": [
"#4A3002",
"#835404",
"#BB7906",
"#F49D07",
"#F9B43C",
"#FBCA75",
"#FDE0AE",
"#FEF5E6"
]
},
"accent-ink-light": {
"role": "primary",
"displayName": "Amber Ink (light)",
"canonical": "#FFF7E6",
"tonalRamp": [
"#4C3400",
"#875C00",
"#C18300",
"#FBAB00",
"#FFBF37",
"#FFD271",
"#FFE4AB",
"#FFF7E6"
]
},
"like-light": {
"role": "secondary",
"displayName": "Heart Rose (light)",
"canonical": "#D2405A",
"tonalRamp": [
"#3E0F17",
"#6D1A29",
"#9C253A",
"#CB304C",
"#D95D73",
"#E48C9C",
"#EFBBC4",
"#FAEAED"
]
},
"ok-light": {
"role": "secondary",
"displayName": "Signal Green (light)",
"canonical": "#2E8A55",
"tonalRamp": [
"#133923",
"#22653E",
"#309159",
"#3FBD74",
"#69CD93",
"#94DBB3",
"#C0EAD2",
"#ECF9F1"
]
}
},
"typographyMeta": {
"display": {
"displayName": "Display",
"purpose": "My Wave hero, detail titles, sign-in headline, screen titles (46/40/34/30)."
},
"wordmark": {
"displayName": "Wordmark",
"purpose": "musyx plus the amber dot."
},
"section": {
"displayName": "Section",
"purpose": "Section headings, sheet and settings card titles."
},
"body": {
"displayName": "Body",
"purpose": "Rows, menu entries, buttons, paragraphs."
},
"meta": {
"displayName": "Meta",
"purpose": "Artist lines, album column, durations, help text."
},
"small": {
"displayName": "Small",
"purpose": "Column headers, sidebar labels, player times."
}
},
"shadows": [
{
"name": "primary-lift",
"value": "0 4px 12px rgba(0,0,0,0.18)",
"purpose": "Primary pill buttons only."
},
{
"name": "menu-float",
"value": "0 10px 28px rgba(0,0,0,0.30)",
"purpose": "Context menu and its submenu."
},
{
"name": "toast-float",
"value": "0 6px 18px rgba(0,0,0,0.30)",
"purpose": "The status pill above the player bar."
},
{
"name": "dialog-float",
"value": "0 18px 50px rgba(0,0,0,0.35)",
"purpose": "Dialogs, over a 45% black backdrop."
}
],
"motion": [],
"breakpoints": []
},
"components": [
{
"name": "Primary Button",
"kind": "button",
"refersTo": "button-primary",
"description": "The one amber action on a screen: Play, Create, Rename.",
"html": "<button class=\"ds-btn-primary\"><svg width=\"18\" height=\"18\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\"><polygon points=\"6 3 20 12 6 21 6 3\" fill=\"currentColor\"/></svg><span>Play</span></button>",
"css": ".ds-btn-primary { display:inline-flex; align-items:center; gap:8px; font-family: Onest, system-ui, sans-serif; font-weight:600; font-size:14px; background:#F0B23E; color:#2A1D04; border:none; border-radius:999px; padding:10px 18px; box-shadow:0 4px 12px rgba(0,0,0,0.18); cursor:pointer; } .ds-btn-primary:hover { background:#F1BC59; } .ds-btn-primary:active { background:#D59E3B; } .ds-btn-primary:focus-visible { outline:2px solid #EEEAF3; outline-offset:2px; }"
},
{
"name": "Ghost Button",
"kind": "button",
"refersTo": "button-ghost",
"description": "Secondary action beside Primary, e.g. Shuffle, Cancel.",
"html": "<button class=\"ds-btn-ghost\">Shuffle</button>",
"css": ".ds-btn-ghost { font-family: Onest, system-ui, sans-serif; font-weight:500; font-size:14px; background:transparent; color:#EEEAF3; border:1px solid #3A3546; border-radius:999px; padding:10px 18px; cursor:pointer; } .ds-btn-ghost:hover { background:#2D2937; } .ds-btn-ghost:focus-visible { outline:2px solid #F0B23E; outline-offset:2px; }"
},
{
"name": "Chip",
"kind": "chip",
"refersTo": "chip",
"description": "Single-choice settings: quality, appearance, language, wave tuning.",
"html": "<div class=\"ds-chips\"><button class=\"ds-chip\">Standard</button><button class=\"ds-chip ds-chip-on\">Lossless</button></div>",
"css": ".ds-chips { display:flex; gap:6px; } .ds-chip { font-family: Onest, system-ui, sans-serif; font-weight:500; font-size:13.5px; background:transparent; color:#EEEAF3; border:1px solid #3A3546; border-radius:999px; padding:7px 13px; cursor:pointer; } .ds-chip:hover { background:#2D2937; } .ds-chip-on, .ds-chip-on:hover { background:#F0B23E; border-color:#F0B23E; color:#2A1D04; cursor:default; }"
},
{
"name": "Search Field",
"kind": "input",
"refersTo": "search-field",
"description": "The top bar's pill search; amber border on focus.",
"html": "<input class=\"ds-search\" placeholder=\"Search artists, tracks, podcasts\">",
"css": ".ds-search { font-family: Onest, system-ui, sans-serif; font-size:14px; width:420px; max-width:100%; background:#23202B; color:#EEEAF3; border:1px solid #3A3546; border-radius:999px; padding:10px 16px; outline:none; } .ds-search::placeholder { color:#A39CB0; } .ds-search:focus { border-color:#F0B23E; } .ds-search::selection { background:rgba(240,178,62,0.35); }"
},
{
"name": "Sidebar Nav Item",
"kind": "nav",
"refersTo": "nav-item-active",
"description": "Sidebar navigation; the active item is raised with an amber icon.",
"html": "<nav class=\"ds-nav\"><a class=\"ds-nav-item ds-nav-on\"><svg width=\"18\" height=\"18\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\"><path d=\"m16 6 4 14\"/><path d=\"M12 6v14\"/><path d=\"M8 8v12\"/><path d=\"M4 4v16\"/></svg>Collection</a><a class=\"ds-nav-item\"><svg width=\"18\" height=\"18\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\"><circle cx=\"11\" cy=\"11\" r=\"8\"/><path d=\"m21 21-4.3-4.3\"/></svg>Search</a></nav>",
"css": ".ds-nav { display:flex; flex-direction:column; gap:2px; width:208px; } .ds-nav-item { display:flex; align-items:center; gap:12px; font-family: Onest, system-ui, sans-serif; font-weight:500; font-size:14px; color:#A39CB0; padding:9px 10px; border-radius:8px; cursor:pointer; } .ds-nav-item:hover { background:#2D2937; color:#EEEAF3; } .ds-nav-on { background:#2D2937; color:#EEEAF3; } .ds-nav-on svg { color:#F0B23E; }"
},
{
"name": "Track Row",
"kind": "custom",
"refersTo": "track-row",
"description": "52pt list row; click plays, right-click or … opens the menu; lit while its menu is open.",
"html": "<div class=\"ds-row\"><span class=\"ds-row-n\">2</span><span class=\"ds-row-cover\"></span><span class=\"ds-row-text\"><b>Хочешь?</b><small>Земфира</small></span><span class=\"ds-row-album\">Прости меня моя любовь</span><span class=\"ds-row-heart\"><svg width=\"18\" height=\"18\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\"><path d=\"M19 14c1.49-1.46 3-3.21 3-5.5A5.5 5.5 0 0 0 16.5 3c-1.76 0-3 .5-4.5 2-1.5-1.5-2.74-2-4.5-2A5.5 5.5 0 0 0 2 8.5c0 2.3 1.5 4.05 3 5.5l7 7Z\"/></svg></span><span class=\"ds-row-time\">3:45</span><span class=\"ds-row-more\"><svg width=\"18\" height=\"18\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\"><circle cx=\"12\" cy=\"12\" r=\"1\"/><circle cx=\"19\" cy=\"12\" r=\"1\"/><circle cx=\"5\" cy=\"12\" r=\"1\"/></svg></span></div>",
"css": ".ds-row { display:flex; align-items:center; gap:12px; height:52px; padding:0 10px; border-radius:8px; font-family: Onest, system-ui, sans-serif; color:#EEEAF3; cursor:pointer; } .ds-row:hover { background:#2D2937; } .ds-row-n { width:36px; text-align:center; color:#A39CB0; font-size:13px; } .ds-row-cover { width:40px; height:40px; border-radius:6px; background:linear-gradient(135deg,#5BD08A,#2E5B3A 55%,#1C2A1F); } .ds-row-text { display:flex; flex-direction:column; flex:22; min-width:0; } .ds-row-text b { font-weight:500; font-size:14px; } .ds-row-text small, .ds-row-album { font-size:13px; color:#A39CB0; } .ds-row-album { flex:14; white-space:nowrap; overflow:hidden; text-overflow:ellipsis; } .ds-row-heart { color:#F27286; display:flex; padding:8px; } .ds-row-heart svg { fill:currentColor; } .ds-row-time { width:52px; text-align:right; font-size:13px; color:#A39CB0; } .ds-row-more { color:#A39CB0; display:flex; padding:8px; border-radius:8px; } .ds-row-more:hover { background:#3A3546; color:#EEEAF3; }"
},
{
"name": "Context Menu",
"kind": "custom",
"refersTo": "context-menu",
"description": "Opens at the pointer or under …; grouped entries, no backdrop, every action closes it.",
"html": "<div class=\"ds-menu\"><button class=\"ds-mi\"><svg width=\"18\" height=\"18\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\"><polygon points=\"5 4 15 12 5 20 5 4\"/><line x1=\"19\" x2=\"19\" y1=\"5\" y2=\"19\"/></svg>Play next</button><button class=\"ds-mi ds-mi-on\"><svg width=\"18\" height=\"18\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\"><path d=\"M21 15V6\"/><path d=\"M18.5 18a2.5 2.5 0 1 0 0-5 2.5 2.5 0 0 0 0 5Z\"/><path d=\"M12 12H3\"/><path d=\"M16 6H3\"/><path d=\"M12 18H3\"/></svg>Add to queue</button><hr class=\"ds-msep\"><button class=\"ds-mi\"><svg width=\"18\" height=\"18\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\"><path d=\"M19 14c1.49-1.46 3-3.21 3-5.5A5.5 5.5 0 0 0 16.5 3c-1.76 0-3 .5-4.5 2-1.5-1.5-2.74-2-4.5-2A5.5 5.5 0 0 0 2 8.5c0 2.3 1.5 4.05 3 5.5l7 7Z\"/></svg>Add to Liked tracks</button><button class=\"ds-mi\"><svg width=\"18\" height=\"18\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\"><path d=\"M5 12h14\"/><path d=\"M12 5v14\"/></svg>Add to playlist<span class=\"ds-mchev\"><svg width=\"18\" height=\"18\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\"><path d=\"m9 18 6-6-6-6\"/></svg></span></button><hr class=\"ds-msep\"><button class=\"ds-mi ds-mi-danger\"><svg width=\"18\" height=\"18\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\"><path d=\"M3 6h18\"/><path d=\"M19 6v14c0 1-1 2-2 2H7c-1 0-2-1-2-2V6\"/><path d=\"M8 6V4c0-1 1-2 2-2h4c1 0 2 1 2 2v2\"/></svg>Remove from this playlist</button></div>",
"css": ".ds-menu { width:280px; box-sizing:border-box; padding:6px; background:#23202B; border:1px solid #3A3546; border-radius:10px; box-shadow:0 10px 28px rgba(0,0,0,0.30); display:flex; flex-direction:column; } .ds-mi { display:flex; align-items:center; gap:12px; height:32px; padding:0 10px; font-family: Onest, system-ui, sans-serif; font-size:14px; color:#EEEAF3; background:none; border:none; border-radius:8px; text-align:left; cursor:pointer; } .ds-mi svg { color:#A39CB0; flex:none; } .ds-mi:hover, .ds-mi-on { background:#2D2937; } .ds-mi-danger, .ds-mi-danger svg { color:#F27286; } .ds-mchev { margin-left:auto; display:flex; } .ds-msep { border:none; height:1px; background:#3A3546; margin:4px; }"
},
{
"name": "Cover Card",
"kind": "card",
"refersTo": "card",
"description": "168pt cover, title and one muted line; right-click for Play/Shuffle/collection.",
"html": "<div class=\"ds-card\"><div class=\"ds-card-cover\"></div><b>Группа крови</b><small>Кино · 1988</small></div>",
"css": ".ds-card { width:168px; padding:6px; border-radius:8px; display:flex; flex-direction:column; gap:2px; font-family: Onest, system-ui, sans-serif; color:#EEEAF3; cursor:pointer; } .ds-card:hover { background:#2D2937; } .ds-card-cover { width:168px; height:168px; border-radius:10px; margin-bottom:7px; background:linear-gradient(135deg,#E3C24F,#2E7A3A 55%,#18233A); } .ds-card b { font-weight:500; font-size:14px; } .ds-card small { font-size:13px; color:#A39CB0; }"
},
{
"name": "Toast",
"kind": "custom",
"refersTo": "toast",
"description": "Confirms every action from menus, likes and edits.",
"html": "<div class=\"ds-toast\">Added to Liked tracks</div>",
"css": ".ds-toast { display:inline-block; font-family: Onest, system-ui, sans-serif; font-weight:500; font-size:14px; background:#EEEAF3; color:#1C1A22; border-radius:999px; padding:10px 18px; box-shadow:0 6px 18px rgba(0,0,0,0.30); }"
}
],
"narrative": {
"northStar": "The Late-Night Tape Deck",
"overview": "Musyx looks like a piece of dark hardware playing in a dim room late at night. The casing is aubergine graphite. The controls are quiet and almost the same colour as the casing. Exactly one thing glows: an amber lamp that marks what is playing, what you chose and what you can press next. People leave the window open for hours, so nothing moves or competes for attention unless the music asks for it.\n\nThe layout is the familiar desktop player shell: sidebar, content, player bar, and an optional drawer. Its brand shows in the details, not the structure. There is one display face for titles and one plain face for everything else. Depth comes from three close tonal steps, not from shadows. Interactions follow desktop rules: right-click menus at the pointer, keyboard shortcuts, and drag to reorder. The My Wave hero is the one place that animates. Its amber lines drift only while My Wave is actually playing.\n\nThe theme is dark first. The light theme follows the system setting, or the choice in Settings, and keeps every role.",
"keyCharacteristics": [
"One amber accent on an aubergine ground. Amber means \"this one, now\".",
"Three tonal surfaces (bg, panel, raised) do the layering. Shadows appear only on things that float.",
"Unbounded for titles, Onest for everything else. Icons are Lucide at 18pt.",
"Dense, scannable lists with 52pt track rows.",
"Desktop-native interaction: context menus, shortcuts, drag reorder, media keys, and a macOS menu-bar mini player."
],
"rules": [
{
"name": "The One Lit Lamp Rule",
"body": "Amber marks state (playing, selected, primary, focused) and nothing else. Never use it to decorate. If a screen has two amber things, they must be the same \"now\".",
"section": "colors"
},
{
"name": "The Light-Theme Contrast Rule",
"body": "In the light theme, amber text on `bg` measures 3.9:1 and `ok` text measures 3.8:1. Both are below AA for body text. Until the light accent is darkened, keep amber text in light mode to titles of 14pt medium or larger, and never use it for small meta text.",
"section": "colors"
},
{
"name": "The Two Faces Rule",
"body": "Unbounded appears only at display sizes and in the wordmark. Everything interactive is Onest.",
"section": "typography"
},
{
"name": "The Float-Only Shadow Rule",
"body": "If it isn't floating above the content (menu, toast, dialog) and it isn't the primary button, it has no shadow.",
"section": "elevation"
},
{
"name": "The No-Dim Rule",
"body": "Only dialogs dim the window. Menus, the drawer and toasts never do.",
"section": "elevation"
}
],
"dos": [
"**Do** take every colour from `Tokens` in `theme.rs`, and change DESIGN.md in the same commit.",
"**Do** use Lucide 0.460 icons at 18pt, tinted with the colour of the text they sit beside. New icons go in `assets/icons` with the Lucide license header.",
"**Do** put routine actions on an item in its context menu, and confirm them with a toast.",
"**Do** give every new action a keyboard path, and add it to the Settings shortcut list.",
"**Do** translate every string through `tr`/`trf` with a Russian entry in `i18n/ru.rs`. The test suite fails otherwise.",
"**Do** test new screens in both themes and both languages with the snapshot tool (`MUSYX_SNAPSHOT_*`, see `snapshot.rs`). Russian labels run about 30% longer."
],
"donts": [
"**Don't** use amber for decoration, borders or illustrations other than the My Wave hero.",
"**Don't** open a dialog for anything that doesn't need typing or a destructive confirmation.",
"**Don't** dim the window for menus, the drawer or toasts.",
"**Don't** fade icons with `scale_alpha`. iced's SVG tint drops alpha, so a faded icon renders at full strength. Disabled previous/next already do this. Pre-mix the colour with the surface.",
"**Don't** add hardcoded colours outside `theme.rs`. About 19 still exist (sign-in, genre tiles, dialogs) and should move into tokens when touched.",
"**Don't** add shadows to resting surfaces. Depth comes from `bg` → `panel` → `raised`."
]
}
}