docs: describe the design system as built

Rewrite DESIGN.md in the standard eight-section format around "The
Late-Night Tape Deck": the same tokens, components as they ship
(context menu, drag reorder, shortcuts), named rules, known contrast
and token debt, and a History section listing what the build dropped
from the mockup. The mockup is now marked historical; the build is the
authority.

Add the Impeccable sidecar (.impeccable/design.json) and the first
critique snapshot.

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:05:41 +06:00
1 parent ac5c8c4c8c
commit 9cbda56abc
5 files changed
+1116 -50

No files matched your search

+487
View File
@@ -0,0 +1,487 @@
{
"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`."
]
}
}