npm - @motir/design-system - Versions diffs - 0.5.1 → 0.6.0 - Mend

@motir/design-system 0.5.1 → 0.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (24) hide show

package/dist/components/theme/AppearancePickers.js +11 -11
package/dist/components/theme/AppearancePickers.js.map +1 -1
package/dist/components/ui/Combobox.d.ts +7 -0
package/dist/components/ui/Combobox.js +4 -1
package/dist/components/ui/Combobox.js.map +1 -1
package/dist/contexts/theme-context.js +33 -13
package/dist/contexts/theme-context.js.map +1 -1
package/dist/index.d.ts +2 -2
package/dist/index.js +3 -0
package/dist/specimen/TokensSpecimen.js +33 -13
package/dist/specimen/TokensSpecimen.js.map +1 -1
package/dist/theme/appearance-resolution.js +9 -9
package/dist/theme/appearance-resolution.js.map +1 -1
package/dist/theme/init-script.d.ts +5 -0
package/dist/theme/init-script.js +32 -10
package/dist/theme/init-script.js.map +1 -1
package/dist/theme/palettes.d.ts +48 -17
package/dist/theme/palettes.js +12 -10
package/dist/theme/palettes.js.map +1 -1
package/dist/theme/types.d.ts +26 -1
package/dist/theme/types.js +19 -2
package/dist/theme/types.js.map +1 -1
package/package.json +1 -1
package/theme.css +40 -35

package/dist/theme/types.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"sources":["../../src/theme/typography.ts","../../src/theme/styles.ts","../../src/theme/palettes.ts","../../src/theme/types.ts"],"names":[],"mappings":"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","file":"types.js","sourcesContent":["/*\n The Motir TYPOGRAPHY LIBRARY — the named-pairing registry (Subtask 7.3.53).\n \n A \"type pairing\" is a named TYPOGRAPHY scheme the whole UI can swap to at\n * runtime — the THIRD design axis, completing the token decomposition\n * (Colour `data-palette` · Type `data-type` · Shape/feel `data-style`). It is\n * deliberately INDEPENDENT of the other two: a pairing decides which TYPEFACES\n * the product wears (the headline / body / mono role mapping); it never touches\n * a hue (palette axis) or a radius (style axis).\n \n ── The three-axis runtime contract ─────────────────────────────────────\n * data-type=\"<type-id>\" — THIS axis. A `[data-type='<id>']` block in\n * app/globals.css re-points the `--font-`\n role tokens (sans / serif / mono) — and ONLY\n * font tokens, never colour or shape.\n * data-palette=\"<palette-id>\" — the INDEPENDENT colour axis (`--el-`).\n data-style=\"<style-id>\" — the INDEPENDENT shape/feel axis.\n \n The shared `--font-size-` SCALE stays common across pairings — sizes are\n layout, not brand; a pairing remaps the FACES, not the type scale.\n \n ── A style declares a DEFAULT pairing (overridable) ────────────────────\n * Typography used to be BUNDLED into the style axis: `swiss-minimal-flat`,\n * `neo-brutalism` and `cybercore-y2k` each re-pointed `--font-serif` inside\n * their own `[data-style]` block. That is now a disjointness violation (two\n * axes setting `--font-`). The fix: each style declares a `defaultTypeId`\n (see ./styles.ts) — the pairing applied when the user has NOT pinned an\n * explicit type — and the per-style font overrides move here, as pairings.\n * So out-of-the-box looks are UNCHANGED; the new freedom is that type is now\n * independently overridable (e.g. Swiss shape + a serif pairing).\n \n ── v1 — the base faces only (no new payload) ───────────────────────────\n * v1 registered three pairings built from the THREE already-loaded next/font\n * faces (Inter · Source Serif 4 · JetBrains Mono) — so they add ZERO font\n * payload and carry NO new-typeface design decision:\n * - `motir` — the base: editorial serif headlines over a sans body.\n * - `motir-sans` — all-sans (Inter headlines); reproduces the Swiss look.\n * - `motir-mono` — mono THROUGHOUT (headlines + body/UI); a code-native UI.\n * `motir` is the base — like the `motir` palette / `warm-editorial` style it\n * needs NO `[data-type]` override block; the base `--font-` tokens already are\n it.\n \n ── New-typeface pairings (Grotesk / Editorial / Mono-Technical, 7.3.54–56) ──\n * Each adds a real type-design decision and loads its own next/font face(s),\n * re-pointing a role in its own `[data-type]` block:\n * - `grotesk` (7.3.54) — Space Grotesk THROUGHOUT (headlines + body/UI).\n * - `editorial` (7.3.55) — Fraunces display-serif headlines over the Inter\n * body; a magazine, considered pairing (one new face — Inter + JetBrains reused).\n * Body STAYS Inter — a display serif is unreadable as UI, so this pairing\n * re-types headlines only (the legibility exception to whole-UI re-typing).\n * - `mono-technical` (7.3.56) — IBM Plex Mono THROUGHOUT (headlines + body/UI +\n * meta); a precise, developer-grade UI (one new face — Inter reused for nothing\n * now, kept as the ultimate fallback).\n \n ── Whole-UI re-typing (Yue, 2026-06-19) ────────────────────────────────\n * A type pairing re-types the WHOLE app, chrome included (nav, header, buttons),\n * not just headlines: a pairing whose signature face reads as a UI sans/mono\n * (`grotesk`, `motir-mono`, `mono-technical`) ALSO re-points the body/UI role\n * (`--font-sans`) in its `[data-type]` block. The display-serif `editorial` and\n * the all-Inter `motir` / `motir-sans` keep the Inter body for legibility.\n * Each later \"Type: …\" subtask ADDS its entry here + a `[data-type]` block (its\n * face loaded in `app/layout.tsx`) + its `docs/typography/<id>.md`.\n /\n\n/* A registered, runtime-selectable type pairing. /\nexport interface TypographyDefinition {\n /* The `data-type` attribute value. Stable; used as the localStorage value. /\n id: string;\n /* Display name shown in the gallery / `/tokens` toggle. /\n name: string;\n /* One-line characterization of the typographic feel. /\n tagline: string;\n /* The headline / body / mono face mapping (credit / what it loads). /\n faces: string;\n /\n Repo-relative path to this pairing's doc — the type-role reference a later\n * getdesign-style swap or the `/tokens` composer reads. Every registered\n * pairing maps to exactly one.\n /\n designDoc: string;\n}\n\n/\n The registry. Insertion order is the gallery order. Each non-base `id`\n * matches a `[data-type='<id>']` block in app/globals.css (`motir` is the base,\n * so its block is the Tier-0 `--font-` defaults — no override block needed).\n /\nexport const TYPE_REGISTRY = {\n motir: {\n id: 'motir',\n name: 'Motir',\n tagline: 'Editorial serif headlines over a clean sans body — the house pairing.',\n faces: 'Source Serif 4 headlines · Inter body · JetBrains Mono meta.',\n designDoc: 'docs/typography/motir.md',\n },\n 'motir-sans': {\n id: 'motir-sans',\n name: 'Motir Sans',\n tagline: 'All-sans — Inter for headlines and body; structural, no serif.',\n faces: 'Inter headlines + body · JetBrains Mono meta.',\n designDoc: 'docs/typography/motir-sans.md',\n },\n 'motir-mono': {\n id: 'motir-mono',\n name: 'Motir Mono',\n tagline: 'Monospace throughout — a code-native UI, headlines, body and all.',\n faces: 'JetBrains Mono headlines + body/UI + meta.',\n designDoc: 'docs/typography/motir-mono.md',\n },\n grotesk: {\n id: 'grotesk',\n name: 'Grotesk',\n tagline: 'Geometric neo-grotesque across the whole UI — tight, confident, product-y.',\n faces: 'Space Grotesk headlines + body/UI · JetBrains Mono meta.',\n designDoc: 'docs/typography/grotesk.md',\n },\n editorial: {\n id: 'editorial',\n name: 'Editorial',\n tagline: 'A characterful display serif over a humanist sans — magazine, considered.',\n faces: 'Fraunces display headlines · Inter body · JetBrains Mono meta.',\n designDoc: 'docs/typography/editorial.md',\n },\n 'mono-technical': {\n id: 'mono-technical',\n name: 'Mono-Technical',\n tagline: 'IBM Plex Mono throughout — a precise, developer-grade UI.',\n faces: 'IBM Plex Mono headlines + body/UI + meta/code.',\n designDoc: 'docs/typography/mono-technical.md',\n },\n} satisfies Record<string, TypographyDefinition>;\n\n/** The id of every registered pairing — `data-type` value space. /\nexport type TypeId = keyof typeof TYPE_REGISTRY;\n\n/* All registered pairing ids, in gallery order. /\nexport const TYPE_IDS = Object.keys(TYPE_REGISTRY) as TypeId[];\n\n/\n The default pairing a fresh install / unset preference resolves to when the\n * active style declares none. Motir is the house pairing and the Tier-0 base.\n /\nexport const DEFAULT_TYPE_ID: TypeId = 'motir';\n\n/* Narrowing guard — is an arbitrary string a registered pairing id? /\nexport function isTypeId(value: unknown): value is TypeId {\n return typeof value === 'string' && Object.prototype.hasOwnProperty.call(TYPE_REGISTRY, value);\n}\n\n/* Resolve a (possibly stale / unknown) value to a valid pairing definition. /\nexport function resolveType(value: unknown): TypographyDefinition {\n return TYPE_REGISTRY[isTypeId(value) ? value : DEFAULT_TYPE_ID];\n}\n","/\n The Motir STYLE LIBRARY — the named-aesthetic registry (Subtask 7.3.32).\n \n A \"style\" is a named, end-to-end AESTHETIC the whole UI can swap to at\n * runtime — the foundation the onboarding design wizard (7.3.27) and the\n * `/tokens` composer (7.3.30) build on. It is the SHAPE/feel axis, and it is\n * deliberately INDEPENDENT of the COLOR axis (`data-palette` — see below): a\n * style decides how the product FEELS (silhouette, stroke, elevation, surface\n * treatment, density, motion, typography, component silhouettes); a palette\n * decides what colours it WEARS. Picking a style never changes a hue, and\n * picking a palette never changes a radius.\n \n ── The two-axis runtime contract ───────────────────────────────────────\n * data-style=\"<style-id>\" — THIS axis. Layers per-style shape/feel\n * tokens (+ component-variant overrides) over\n * the Tier-0 base scale in app/globals.css.\n * data-palette=\"<palette-id>\" — the INDEPENDENT colour axis (re-skins the\n * `--el-` layer). Orthogonal to data-style.\n data-theme=\"light\|dark\" — the light/dark base within a palette.\n \n A `[data-style='…']` TOKEN block in globals.css MUST override ONLY shape/feel\n * tokens (radius / spacing / shadow / sizing / transition / type) — NEVER a\n * `--color-` or `--el-` colour token. That is the palette axis's job, and\n * keeping the two disjoint is what makes \"style × palette\" a true product of\n * two independent choices rather than 2×N hand-tuned combinations.\n \n A SURFACE-MATERIAL style (glassmorphism, 7.3.35; later cybercore, aurora,\n * neumorphism …) owns a richer surface — translucency, a gradient canvas,\n * frosted backdrop-blur — that the token block cannot express. It adds a\n * palette-DERIVED MATERIAL LAYER: style-scoped component rules\n * (`[data-style='id'] [data-surface='…'] { … }`) whose colour comes ONLY from\n * `color-mix()`/`var(--color-\|--el-)` over the ACTIVE palette, never a raw\n * hue — so the two axes stay disjoint (a palette swap re-tints the material; a\n * style swap leaves hues untouched). Surfaces opt in via the `data-surface`\n * hook the shared primitives emit. Both rules are enforced by\n * tests/theme/styleRegistry.test.ts.\n \n ── Why a style is MORE than a token swap ───────────────────────────────\n * The feel-bearing DIMENSIONS below are the axes a pure token swap ignores:\n * two styles can share the Tier-0 scale yet feel utterly different because\n * their silhouette, elevation philosophy, surface treatment, and component\n * silhouettes diverge. The registry names those dimensions so each style (and\n * its DESIGN.md) is authored against the same rubric.\n \n This module is the schema + the registration of the styles. Each \"Style: …\"\n * subtask (7.3.33–7.3.42) ADDS its entry here, ships a `[data-style='<id>']`\n * token block in globals.css (plus, for a surface-material style, the\n * palette-derived material layer above), and authors its `docs/styles/<id>.md`\n * DESIGN.md.\n /\n\nimport { DEFAULT_TYPE_ID, type TypeId } from './typography';\n\n/\n The feel-bearing axes a named style controls. A token-only swap reaches the\n * first few; the rest (surface treatment, motion, typography, component\n * silhouettes) are what give a style its identity and must be authored, not\n * derived. The order here is the canonical presentation order (the `/tokens`\n * page + each style's DESIGN.md walk them in this sequence).\n /\nexport const STYLE_DIMENSIONS = [\n {\n key: 'silhouette',\n label: 'Shape / silhouette',\n description:\n 'Corner-radius personality — sober rectangles vs. soft pills vs. hard right angles.',\n },\n {\n key: 'stroke',\n label: 'Border / stroke',\n description: 'Hairline vs. heavy outline; whether structure is drawn with borders at all.',\n },\n {\n key: 'elevation',\n label: 'Elevation philosophy',\n description: 'How depth is expressed — soft diffuse shadows, hard offset shadows, or flat.',\n },\n {\n key: 'surface',\n label: 'Surface / background treatment',\n description:\n 'Opaque cards vs. translucent glass vs. tinted washes — the material of a surface.',\n },\n {\n key: 'density',\n label: 'Density rhythm',\n description: 'Padding/sizing cadence — compact and efficient vs. roomy and relaxed.',\n },\n {\n key: 'motion',\n label: 'Motion',\n description: 'Transition speed and easing — snappy, gentle, or springy.',\n },\n {\n key: 'typography',\n label: 'Typography',\n description:\n \"The style's DEFAULT type pairing — type is the independent `data-type` axis now (see ./typography.ts + `defaultTypeId`); this describes the pairing the style ships with: editorial serif, all-sans, or mono headlines.\",\n },\n {\n key: 'components',\n label: 'Component silhouettes',\n description:\n 'Per-component shape overrides beyond tokens (e.g. a pill button vs. a square one).',\n },\n] as const;\n\nexport type StyleDimensionKey = (typeof STYLE_DIMENSIONS)[number]['key'];\n\n/* A registered, runtime-selectable style. /\nexport interface StyleDefinition {\n /* The `data-style` attribute value. Stable; used as the localStorage value. /\n id: string;\n /* Display name shown in the gallery / `/tokens` toggle. /\n name: string;\n /* One-line characterization of the feel. /\n tagline: string;\n /* Where the look is drawn from (credit / mood anchor). /\n inspiration: string;\n /* One line per feel-bearing dimension — the authored rubric for this style. /\n dimensions: Record<StyleDimensionKey, string>;\n /\n Repo-relative path to this style's DESIGN.md — the doc the `/tokens` page\n * composes (and a later getdesign-style swap reads). Every registered style\n * maps to exactly one.\n /\n designDoc: string;\n /\n The type pairing (`data-type`, see ./typography.ts) this style applies when\n * the user has NOT pinned an explicit type — the style's curated default,\n * overridable. Type is its own axis now; this is how a style keeps its\n * out-of-the-box typographic feel (e.g. swiss → `motir-sans`, neo-brutalism /\n * cybercore-y2k → `motir-mono`) without owning `--font-` in its own block.\n /\n defaultTypeId: TypeId;\n}\n\n/*\n The registry. Insertion order is the gallery order. Each `id` matches a\n * `[data-style='<id>']` block in app/globals.css (Warm Editorial is the base,\n * so its block is the Tier-0 defaults — no override block needed).\n /\nexport const STYLE_REGISTRY = {\n 'warm-editorial': {\n id: 'warm-editorial',\n name: 'Warm Editorial',\n tagline: 'Thoughtful, warm, technical-but-not-cold, slightly editorial.',\n inspiration: \"Notion's warm palette + Source Serif headlines over Inter body.\",\n designDoc: 'docs/styles/warm-editorial.md',\n defaultTypeId: 'motir',\n dimensions: {\n silhouette: 'Sober rectangles — 8px buttons, 12px cards. Restrained, document-like.',\n stroke: 'Hairline borders (1px warm-grey); structure drawn quietly, never heavy.',\n elevation: 'Modest, low-spread shadows; surfaces sit close to the page.',\n surface: 'Opaque cream surfaces over a white canvas; pastel tints for feature cards only.',\n density: 'Comfortable default rhythm — 18×10 button padding, 24px card padding.',\n motion: 'Brisk 150ms ease; understated, gets out of the way.',\n typography: 'Source Serif 4 editorial headlines + Inter body + JetBrains Mono meta.',\n components:\n 'Rectangular buttons/inputs, hairline-bordered cards, badge pills for status only.',\n },\n },\n 'soft-playful': {\n id: 'soft-playful',\n name: 'Soft / Playful',\n tagline: 'More energy — rounded, generous, gently animated.',\n inspiration: \"Figma's pill-shape language (50px pills, roomy spacing).\",\n designDoc: 'docs/styles/soft-playful.md',\n defaultTypeId: 'motir',\n dimensions: {\n silhouette: 'Pill buttons (fully rounded) and large 24px card/input radii. Friendly, bubbly.',\n stroke: 'Same hairline borders as the base; identity comes from radius, not stroke weight.',\n elevation: 'Softer, more diffused shadows — surfaces float a touch more.',\n surface: 'Opaque, like the base — colour stays the palette axis; only the shape softens.',\n density: 'Roomier — 20×12 button padding, 28px card padding, taller controls.',\n motion: 'Gentler 200ms ease and a slightly deeper press scale for a springy feel.',\n typography: 'Inherits the base type pairing; the personality is in shape, not type.',\n components: 'Pill buttons, heavily-rounded inputs/cards/modals, rounder small affordances.',\n },\n },\n 'swiss-minimal-flat': {\n id: 'swiss-minimal-flat',\n name: 'Swiss / Minimal-Flat',\n tagline: 'International-typographic, structural, calm — flat, sharp, gridded.',\n inspiration: 'Swiss International Typographic Style — Müller-Brockmann grids, flat surfaces.',\n designDoc: 'docs/styles/swiss-minimal-flat.md',\n defaultTypeId: 'motir-sans',\n dimensions: {\n silhouette:\n 'Sharp near-square corners (2px) on every surface — hard right angles, structural.',\n stroke:\n 'Hairline borders do ALL the structural work; with elevation removed, the 1px rule is the only divider.',\n elevation:\n 'Flat — every shadow is removed (none). Depth comes from borders + whitespace, not lift.',\n surface:\n 'Opaque, untinted panels delineated by hairline rules; no floating, no glass, no wash.',\n density:\n 'Tight, gridded controls (crisp 16×9 buttons, 34px control height) with generous 28px card whitespace.',\n motion:\n 'Minimal — fast 100ms transitions and NO press-scale (calm, mechanical, never springy).',\n typography:\n 'Restrained neo-grotesque sans throughout — headlines drop the editorial serif for Inter, tight and strong.',\n components:\n 'Square buttons/inputs/cards/modals, rectangular (non-pill) status chips, flat hairline-ruled surfaces.',\n },\n },\n 'neo-brutalism': {\n id: 'neo-brutalism',\n name: 'Neo-Brutalism',\n tagline: 'Raw, punchy, utilitarian — 0px corners, thick borders, hard-offset shadows.',\n inspiration:\n 'Neo-brutalist web design — Gumroad / Figma-community brutalism: blocky, unpolished, loud.',\n designDoc: 'docs/styles/neo-brutalism.md',\n defaultTypeId: 'motir-mono',\n dimensions: {\n silhouette:\n 'Zero radius — hard 0px corners on EVERY surface (buttons, cards, inputs, modals, status chips). Blocky and uncompromising.',\n stroke:\n 'Heavy solid 2px outlines do the structural work — borders are LOUD, not hairline (the defining neo-brutalist move, applied via a style-scoped component-variant block).',\n elevation:\n 'Hard-offset drop shadows with ZERO blur (e.g. 4px 4px 0 0) — a solid block of shadow, never a soft lift; the chunky frame, not diffusion.',\n surface:\n 'Opaque, flat, untinted panels framed by the thick border + the hard shadow; no glass, no wash, no gradient.',\n density:\n 'Tight, utilitarian controls (16×10 buttons, 36px control height) with compact 20px card padding — no wasted space.',\n motion:\n 'Snappy and mechanical — near-instant 60ms transitions and NO press-scale; the UI reacts, it does not animate.',\n typography:\n 'Raw monospace headlines — the editorial serif is re-pointed at the JetBrains Mono stack, against the Inter grotesk body.',\n components:\n 'Square buttons/inputs/cards/modals, rectangular (non-pill) status chips, thick-bordered surfaces with hard-offset shadows.',\n },\n },\n glassmorphism: {\n id: 'glassmorphism',\n name: 'Glassmorphism',\n tagline: 'Translucent frosted glass floating over a soft, vibrant gradient.',\n inspiration:\n \"Apple's visionOS / macOS Big Sur 'frosted glass' material — backdrop-blur over depth.\",\n designDoc: 'docs/styles/glassmorphism.md',\n defaultTypeId: 'motir',\n dimensions: {\n silhouette:\n 'Soft, rounded glass tiles — 12px buttons/inputs, 18px cards, 22px modals. Friendly, never sharp.',\n stroke:\n 'Light 1px hairlines at reduced opacity — a glass edge catching light, not a structural rule.',\n elevation:\n 'Layered, diffuse, low-opacity shadows — panels float as hovering frosted sheets above the canvas.',\n surface:\n 'The identity axis: translucent frosted panels (backdrop-blur) over a soft palette-derived gradient canvas — material, not opaque.',\n density:\n 'Comfortable, a touch roomy — 20×11 buttons, 26px card padding, 38px controls; glass tiles want air.',\n motion:\n 'Gentle, smooth — 220ms ease and a light press-scale; glass slides into place, it never snaps.',\n typography:\n 'Inherits the base editorial type pairing; the personality is in the material, not the type.',\n components:\n 'Rounded frosted cards / popovers / modals / sidebar / inputs (the data-surface material layer), pill status chips.',\n },\n },\n 'cybercore-y2k': {\n id: 'cybercore-y2k',\n name: 'Cybercore / Y2K',\n tagline: 'Neon-on-dark retro-tech — glowing HUD panels, a tech grid, mono headlines.',\n inspiration:\n 'Y2K / cyberpunk HUDs — neon-on-dark terminals, Tron grids, glowing edges, monospace displays.',\n designDoc: 'docs/styles/cybercore-y2k.md',\n defaultTypeId: 'motir-mono',\n dimensions: {\n silhouette:\n 'Hard terminal-frame corners (sharp 2–4px) — chiseled HUD panels, not soft cards.',\n stroke:\n 'Structure drawn by a lit edge — a 1px glow-ring (currentColor halo) on every surface, not a heavier border.',\n elevation:\n 'Neon GLOW instead of drop-shadow — surfaces emit an outward currentColor halo, lit rather than lifted.',\n surface:\n 'A faint tech grid (scanline/grid texture) washes the canvas behind opaque HUD panels.',\n density:\n 'Tight, technical HUD rhythm — compact controls (18×9 buttons, 34px control height) over snug 20px card padding.',\n motion: 'Snappy and electric — very fast 90ms transitions with a crisp press-scale.',\n typography:\n 'Mono/display headlines — the serif headline face is swapped to JetBrains Mono for a terminal read; body stays sans.',\n components:\n 'Sharp glow-ringed panels, mono headings, rectangular chips; the lit edge replaces the drop shadow everywhere.',\n },\n },\n aurora: {\n id: 'aurora',\n name: 'Aurora',\n tagline: 'Soft, drifting aurora light behind fluid, gently-glowing surfaces.',\n inspiration:\n 'The northern lights — slow ribbons of colour over a night sky — and the soft animated-gradient \"aurora\" hero look (Stripe / Vercel ambient gradients).',\n designDoc: 'docs/styles/aurora.md',\n defaultTypeId: 'motir',\n dimensions: {\n silhouette:\n 'Fluid, soft corners — 14px buttons/inputs, 20px cards, 26px modals. Organic and rounded, a touch softer than glass.',\n stroke:\n 'Quiet 1px hairlines; structure is implied by the gentle glow and elevation, never drawn by a heavy rule.',\n elevation:\n 'A soft neutral lift PLUS a gentle palette-derived COLOUR glow halo — surfaces feel lit from within, never hard-edged.',\n surface:\n 'The identity axis: opaque fluid surfaces floating over a slowly-DRIFTING, animated aurora gradient canvas (palette-derived ribbons).',\n density:\n 'Comfortable and roomy — 20×11 buttons, 26px card padding, 38px controls; the light wants space to breathe.',\n motion:\n 'Smooth and slow — 260ms eased transitions, a faint press-scale, and a 28s ambient drift of the aurora canvas (stilled under prefers-reduced-motion).',\n typography:\n 'Inherits the base editorial pairing (Source Serif headlines + Inter body); the personality is in the moving light, not the type.',\n components:\n 'Fluid, gently-glowing cards / popovers / modals / sidebar (the data-surface material layer); pill status chips.',\n },\n },\n '3d-immersive': {\n id: '3d-immersive',\n name: '3D / Immersive',\n tagline: 'Depth and perspective — dimensional cards floating over the page.',\n inspiration:\n 'Spatial / depth UI — visionOS spatial layers, Stripe-era layered cards, soft real-world light.',\n designDoc: 'docs/styles/3d-immersive.md',\n defaultTypeId: 'motir',\n dimensions: {\n silhouette:\n 'Generously rounded dimensional tiles — 14px buttons/inputs, 20px cards, 28px modals. Soft, tactile, never sharp.',\n stroke:\n 'Borders nearly vanish (a faint hairline) — structure is read from depth + shadow, not an outline.',\n elevation:\n 'The identity axis: deep multi-layer shadows float every surface off the canvas, and on tilt a card becomes a TRUE 3D object — perspective + preserve-3d + per-slot translateZ planes (header pops forward, footer behind) parallax under a cursor-tracked glare. Not a flat-plane tilt.',\n surface:\n 'A palette-derived immersive background atmosphere on every page, with opaque dimensional panels (cards, tables, board columns, widgets) floating above it on deep resting shadows — depth (not tint or glass) is the material; nothing sits flat.',\n density:\n 'Roomy and immersive — 22×12 buttons, 28px card padding, 40px controls; depth wants air around each tile.',\n motion:\n 'The standard \"3D card\" pointer-parallax — tiles tip toward the cursor (rotateX/rotateY over a perspective) via the ImmersiveTilt engine, lifting as they turn; reduced-motion-gated, settling flat on leave.',\n typography:\n 'Inherits the base editorial type pairing; the personality is in depth + light, not the type.',\n components:\n 'Rounded cards / board cards / modals that tilt toward the pointer with layered parallax; PHYSICAL buttons with real thickness (a solid base edge) that press DOWN on click; each board column floats as its own card. Nothing is flat.',\n },\n },\n neumorphism: {\n id: 'neumorphism',\n name: 'Neumorphism',\n tagline: 'Soft extruded surfaces that swell out of a single monochrome field.',\n inspiration:\n 'Neumorphism / soft-UI — Dribbble-era \"soft shadow\" interfaces where panels are pressed OUT of (or INTO) one continuous surface by a paired light + dark shadow.',\n designDoc: 'docs/styles/neumorphism.md',\n defaultTypeId: 'motir',\n dimensions: {\n silhouette:\n 'Soft, generously rounded pebbles — 12px buttons/inputs, 18px cards, 22px modals. Tactile and friendly, the rounding that lets a shadow wrap a surface.',\n stroke:\n 'Borders nearly vanish — a faint hairline kept ONLY as the accessibility fallback (see below); structure is read from the paired soft shadow, not an outline.',\n elevation:\n 'The identity axis: a DUAL soft shadow — a light highlight top-left + a palette-derived dark shadow bottom-right — extrudes each surface OUT of the canvas (raised), while inputs and pressed controls invert it to an INSET well (pressed in). Depth is a soft swell, never a hard drop.',\n surface:\n 'Monochrome and continuous: the page canvas and every panel share ONE opaque palette surface, so a card looks moulded out of the background rather than placed on top of it — the soft-UI \"single material\" look. Opaque (text AA preserved), with the depth carried entirely by the shadows.',\n density:\n 'Comfortable and roomy — 20×11 buttons, 26px card padding, 38px controls; the soft shadows need air around each surface to read as extruded.',\n motion:\n 'Gentle — 200ms ease and a soft press-scale; nothing snaps, matching the moulded surfaces (form fields rest as concave inset wells, panels swell out raised).',\n typography:\n 'Inherits the base editorial type pairing; the personality is in the moulded surfaces, not the type.',\n components:\n 'Raised, soft-shadowed cards / popovers / modals / sidebar (the data-surface material layer); concave inset inputs; pill status chips. Every surface swells from or sinks into the one field.',\n },\n },\n 'hand-drawn-indie': {\n id: 'hand-drawn-indie',\n name: 'Hand-Drawn / Indie',\n tagline:\n 'Sketchy and friendly — rough hand-inked edges, wonky corners, soft offset shadows, a playful bounce.',\n inspiration:\n 'Indie / zine + hand-drawn web design — Excalidraw’s rough hand-sketched strokes and doodled notebook UIs: warm, imperfect, human.',\n designDoc: 'docs/styles/hand-drawn-indie.md',\n defaultTypeId: 'editorial',\n dimensions: {\n silhouette:\n 'Wonky hand-drawn corners — every surface gets a strongly asymmetric multi-value radius (one corner near-sharp, the opposite generously round, no two alike) so cards/buttons/inputs read as DRAWN boxes, never machined rectangles.',\n stroke:\n 'Genuinely ROUGH, wavy ink edges — a turbulence-displacement filter (Excalidraw / rough.js style) warps each outline into a hand-inked wobble, drawn on a content-safe pseudo-border so the lines are sketchy but the text stays crisp.',\n elevation:\n 'Soft, hand-placed offset shadows — a gentle blurred drop nudged down-right (a doodled shadow), friendly and low; never a hard brutalist block nor a flat removal.',\n surface:\n 'Opaque, warm, paper-like panels — colour stays the palette axis; the personality is in the rough wavy outline + the soft shadow, not a tint or a wash.',\n density:\n 'Roomy and relaxed — generous 20×12 buttons, 26px card padding, taller 38px controls; the hand-drawn feel wants air, like margins round a sketch.',\n motion:\n 'Springy and playful — gentle 200ms transitions with a bouncy hover lift (1.02) and a deeper press squish (0.97); the UI has a friendly wobble.',\n typography:\n 'Ships the Editorial pairing (Fraunces display headlines + Inter body) — the warmest, most characterful registered face, its soft optical wonk echoing the hand-drawn shapes; an actual marker/script face is a future data-type addition.',\n components:\n 'Wonky-cornered buttons/inputs/cards/modals, irregular (non-pill) status chips, rough wavy-ink-bordered surfaces with soft hand-placed shadows.',\n },\n },\n retrofuturism: {\n id: 'retrofuturism',\n name: 'Retrofuturism',\n tagline: 'Chrome, gradient sweeps and a synthwave horizon — 70s/80s sci-fi.',\n inspiration:\n 'Retrofuturism / Outrun — 70s–80s sci-fi: chrome lettering, synthwave sunset gradients, airbrushed sci-fi paperbacks, and wide geometric display type.',\n designDoc: 'docs/styles/retrofuturism.md',\n defaultTypeId: 'grotesk',\n dimensions: {\n silhouette:\n 'Streamlined chrome capsules — fully-rounded pill buttons + chips, 16px cards, 22px modals. Aerodynamic 70s/80s curves, never sharp.',\n stroke:\n 'A lit chrome edge — a bright inset highlight + a dark base line over a faint hairline, reading as a polished metal rim rather than a drawn border.',\n elevation:\n 'Chrome bevels + a diagonal SPECULAR streak + a palette-derived glow — a bright top highlight fading to a dark base with a swept light-bar across each panel, so surfaces read as polished reflective metal, not flat cards.',\n surface:\n 'The identity axis: a synthwave SKY + a bright HORIZON GLOW band + a receding neon perspective GRID floor (all palette-derived) behind chrome-bevelled, specular-streaked surfaces. Dark-first — the neon horizon + grid read strongest on a dark palette.',\n density:\n 'Confident and roomy — 22×11 chrome-capsule buttons, 24px card padding, 38px controls; the chrome wants room to catch the light.',\n motion:\n 'Smooth and gliding — 200ms eased transitions and a confident press-scale; the synthwave horizon + grid are a STATIC backdrop (no motion to distract the work surface).',\n typography:\n 'Wide geometric grotesque display (the `grotesk` type pairing) — the retro-futurist sci-fi headline read; body stays a legible sans.',\n components:\n 'Chrome-capsule buttons with a metallic glint, specular-streaked bevelled cards / popovers / modals / sidebar / inputs (the data-surface material layer), pill status chips — a synthwave horizon + neon grid behind it all.',\n },\n },\n} satisfies Record<string, StyleDefinition>;\n\n/* The id of every registered style — `data-style` value space. /\nexport type StyleId = keyof typeof STYLE_REGISTRY;\n\n/* All registered style ids, in gallery order. /\nexport const STYLE_IDS = Object.keys(STYLE_REGISTRY) as StyleId[];\n\n/\n The default style a fresh install / unset preference resolves to. Warm\n * Editorial is Motir's house style and the Tier-0 base.\n /\nexport const DEFAULT_STYLE_ID: StyleId = 'warm-editorial';\n\n/* Narrowing guard — is an arbitrary string a registered style id? /\nexport function isStyleId(value: unknown): value is StyleId {\n return typeof value === 'string' && Object.prototype.hasOwnProperty.call(STYLE_REGISTRY, value);\n}\n\n/* Resolve a (possibly stale / unknown) value to a valid style definition. /\nexport function resolveStyle(value: unknown): StyleDefinition {\n return STYLE_REGISTRY[isStyleId(value) ? value : DEFAULT_STYLE_ID];\n}\n\n/\n styleId → its `defaultTypeId` — the type pairing applied when the user has\n * not pinned an explicit `data-type`. Baked into the FOUC init script (so the\n * pre-hydration pass can resolve the right type for the active style) and used\n * by the theme context's effective-type derivation. `resolveType` (the\n * registry) supplies the ultimate fallback, so every value here is a real id.\n /\nexport const STYLE_DEFAULT_TYPE: Record<StyleId, TypeId> = Object.fromEntries(\n STYLE_IDS.map((id) => [id, STYLE_REGISTRY[id].defaultTypeId]),\n) as Record<StyleId, TypeId>;\n\n/* The default type for a (possibly unknown) style value — the fallback chain. /\nexport function defaultTypeForStyle(styleValue: unknown): TypeId {\n return isStyleId(styleValue) ? STYLE_REGISTRY[styleValue].defaultTypeId : DEFAULT_TYPE_ID;\n}\n","/\n The Motir PALETTE LIBRARY — the named-colour registry (Subtask 7.3.48).\n \n A \"palette\" is a named COLOUR scheme the whole UI can swap to at runtime —\n * the second half of the two-axis contract the style schema (7.3.32) wrote but\n * did not implement. It is the COLOUR/hue axis, and it is deliberately\n * INDEPENDENT of the SHAPE axis (`data-style` — see ./styles.ts): a palette\n * decides what colours the product WEARS (surfaces, ink, accent, tints,\n * semantic hues); a style decides how it FEELS (silhouette, elevation,\n * density, motion). Picking a palette never changes a radius, and picking a\n * style never changes a hue.\n \n ── The two-axis runtime contract ───────────────────────────────────────\n * data-palette=\"<palette-id>\" — THIS axis. Layers per-palette `--el-`\n element-token overrides over the Tier-3\n * base in app/globals.css.\n * data-style=\"<style-id>\" — the INDEPENDENT shape/feel axis.\n * data-theme=\"light\|dark\" — the light/dark base WITHIN a palette\n * (`--color-`); orthogonal to the palette.\n \n * A `[data-palette='…']` block in globals.css MUST override ONLY `--el-`\n element colour tokens — NEVER a shape/feel token (radius / spacing / shadow\n * / sizing / motion / type). That is the style axis's job, and keeping the two\n * disjoint is what makes \"style × palette\" a true product of two independent\n * choices rather than N×M hand-tuned combinations.\n \n ── v1 — Motir's own palette ─────────────────────────────────────────────\n * v1 ships exactly ONE registered palette: Motir — the warm, Notion-warm\n * scheme the product already wears (cream surfaces, charcoal ink, purple\n * primary, pastel feature tints). It is the Tier-0/Tier-3 BASE, so — exactly\n * like the `warm-editorial` base style — it needs NO `[data-palette]` override\n * block; the base `--el-` tokens already are it. (Per Yue, 2026-06-17: \"use\n Motir's colour palette for the v1.\") Each later \"Palette: …\" subtask ADDS its\n * entry here, ships a `[data-palette='<id>']` block in globals.css overriding\n * the `--el-` layer, and authors its `docs/palettes/<id>.md` doc — exactly the\n shape the per-style subtasks (7.3.33+) follow on the other axis.\n /\n\n/* A registered, runtime-selectable colour palette. /\nexport interface PaletteDefinition {\n /* The `data-palette` attribute value. Stable; used as the localStorage value. /\n id: string;\n /* Display name shown in the gallery / `/tokens` toggle. /\n name: string;\n /* One-line characterization of the colour mood. /\n tagline: string;\n /* Where the colours are drawn from (credit / mood anchor). /\n inspiration: string;\n /\n Repo-relative path to this palette's doc — the colour-role reference a\n * later getdesign-style swap or the `/tokens` composer reads. Every\n * registered palette maps to exactly one.\n /\n designDoc: string;\n}\n\n/\n The registry. Insertion order is the gallery order. Each `id` matches a\n * `[data-palette='<id>']` block in app/globals.css (Motir is the base, so its\n * block is the Tier-3 defaults — no override block needed).\n /\nexport const PALETTE_REGISTRY = {\n motir: {\n id: 'motir',\n name: 'Motir',\n tagline: 'Warm and editorial — cream surfaces, charcoal ink, a purple primary, pastel tints.',\n inspiration: \"Notion's warm marketing palette — the product's house colours.\",\n designDoc: 'docs/palettes/motir.md',\n },\n cobalt: {\n id: 'cobalt',\n name: 'Cobalt',\n tagline:\n 'Cool and institutional — slate-cool surfaces, a confident cobalt primary, cooled tints.',\n inspiration:\n \"Coinbase's clean institutional blue + IBM's structured blue, on Radix Blue/Indigo/Slate scales.\",\n designDoc: 'docs/palettes/cobalt.md',\n },\n graphite: {\n id: 'graphite',\n name: 'Graphite',\n tagline:\n 'Stark and editorial — cool greyscale surfaces + ink, an ink CTA, a single restrained cool-blue accent.',\n inspiration:\n \"Vercel's black-and-white precision + Linear's ultra-minimal, on Radix Slate/Blue scales.\",\n designDoc: 'docs/palettes/graphite.md',\n },\n evergreen: {\n id: 'evergreen',\n name: 'Evergreen',\n tagline:\n 'Fresh and technical — an emerald primary over cooled forest neutrals, a green-leaning UI.',\n inspiration:\n 'getdesign.md — Supabase (dark emerald) / Spotify (vibrant green) / MongoDB (spring green), on Radix green/jade ramps.',\n designDoc: 'docs/palettes/evergreen.md',\n },\n spectrum: {\n id: 'spectrum',\n name: 'Spectrum',\n tagline:\n 'Vibrant and playful — crisp cool surfaces, a bright violet primary, a candy-bright multi-hue accent & tint set.',\n inspiration:\n \"Figma's vibrant multi-colour brand + Airtable's colourful, friendly palette, on Radix Violet/Iris/Pink/Blue scales.\",\n designDoc: 'docs/palettes/spectrum.md',\n },\n amber: {\n id: 'amber',\n name: 'Amber',\n tagline:\n 'Warm and electric — Binance trading-floor gold over the exchange’s graphite near-blacks; dark labels on the gold.',\n inspiration:\n 'Binance — its whole documented palette: the bold gold #F0B90B/#FCD535 over cool graphite trading-floor blacks (#0B0E11/#1E2329) + greys, with the buy-green/sell-red semantics.',\n designDoc: 'docs/palettes/amber.md',\n },\n sienna: {\n id: 'sienna',\n name: 'Sienna',\n tagline:\n 'Warm and vivid — Mistral flame-orange over the Mediterranean warm-cream surfaces; dark labels on the flame.',\n inspiration:\n 'Mistral AI — its whole documented palette (getdesign.md/mistral.ai): the flame #fa520f + Block-gradient + Sunshine ambers over Warm-Ivory cream surfaces (#fffaeb) and Mistral-Black ink.',\n designDoc: 'docs/palettes/sienna.md',\n },\n garnet: {\n id: 'garnet',\n name: 'Garnet',\n tagline:\n 'Rich and bold — Pinterest Pushpin red over the brand’s neutral greys; white labels on the red.',\n inspiration:\n 'Pinterest — its whole documented palette: Pushpin red #E60023/#BD081C over Cod-Gray ink (#111111) and neutral greys (#767676/#EFEFEF), with Gestalt “Skycicle” blue links.',\n designDoc: 'docs/palettes/garnet.md',\n },\n citrine: {\n id: 'citrine',\n name: 'Citrine',\n tagline:\n 'Bright and collaborative — Miro’s Sunglow yellow over the whiteboard greys, with the Miro action-blue accent.',\n inspiration:\n 'Miro — its whole Mirotone palette (every value a documented Mirotone step): Sunglow yellow #FFD02F (primary) + the action-blue #3859FF over the gray ramp + Stratos ink #050038, with the green/red semantic ramps.',\n designDoc: 'docs/palettes/citrine.md',\n },\n candy: {\n id: 'candy',\n name: 'Candy',\n tagline:\n 'Sweet and playful — a light bubblegum-pink primary over candy-paper pinks, with a full pastel-candy rainbow.',\n inspiration:\n 'A candy concept grounded entirely in documented Radix Colors scales (every value a Radix step): Pink primary + Mauve neutrals + a Sky/Jade/Violet/Amber/Crimson candy rainbow; Glossier Pink #F5DADF as the pastel-pink mood reference.',\n designDoc: 'docs/palettes/candy.md',\n },\n} satisfies Record<string, PaletteDefinition>;\n\n/* The id of every registered palette — `data-palette` value space. /\nexport type PaletteId = keyof typeof PALETTE_REGISTRY;\n\n/* All registered palette ids, in gallery order. /\nexport const PALETTE_IDS = Object.keys(PALETTE_REGISTRY) as PaletteId[];\n\n/\n The default palette a fresh install / unset preference resolves to. Motir is\n * the house palette and the Tier-3 base.\n /\nexport const DEFAULT_PALETTE_ID: PaletteId = 'motir';\n\n/* Narrowing guard — is an arbitrary string a registered palette id? /\nexport function isPaletteId(value: unknown): value is PaletteId {\n return typeof value === 'string' && Object.prototype.hasOwnProperty.call(PALETTE_REGISTRY, value);\n}\n\n/* Resolve a (possibly stale / unknown) value to a valid palette definition. /\nexport function resolvePalette(value: unknown): PaletteDefinition {\n return PALETTE_REGISTRY[isPaletteId(value) ? value : DEFAULT_PALETTE_ID];\n}\n","/\n Theme types for Motir's THREE-axis design system.\n \n Axis 1 — COLOR (`data-theme` light/dark base · `data-palette` full\n * `--el-` palette swap — the colour axis)\n Axis 2 — STYLE (`data-style` — a named aesthetic controlling shape /\n * silhouette / elevation / surface / density / motion /\n * component silhouettes)\n * Axis 3 — TYPE (`data-type` — a named pairing controlling the `--font-`\n role mapping; a style declares a default pairing, overridable)\n \n The three axes are INDEPENDENT: a style never touches a hue or a face, a\n * palette never touches a radius, a type pairing never touches colour or shape.\n * The registries live in `./styles.ts`, `./palettes.ts`, `./typography.ts`.\n \n Architecture mirrors dooooWeb. See docs/DESIGN.md for the rationale.\n /\n\nimport { DEFAULT_STYLE_ID, type StyleId } from './styles';\nimport { DEFAULT_PALETTE_ID, type PaletteId } from './palettes';\nimport { DEFAULT_TYPE_ID, type TypeId } from './typography';\n\n/* Tier 1 — light/dark base. `system` follows OS preference at runtime. /\nexport type ThemePattern = 'system' \| 'light' \| 'dark';\n\n/* Resolved pattern (what data-theme is set to after `system` resolves). /\nexport type ResolvedThemePattern = 'light' \| 'dark';\n\n/\n Axis 2 — the active named style (`data-style`). The value space + the\n * registry of every style live in `./styles.ts`; this re-export keeps\n * `lib/theme/` the single import surface for theme consumers.\n /\nexport type { StyleId } from './styles';\n\n/*\n Axis 1 (colour) — the active named palette (`data-palette`). The value space\n * + the registry of every palette live in `./palettes.ts`; re-exported here so\n * `lib/theme/` stays the single import surface for theme consumers.\n /\nexport type { PaletteId } from './palettes';\n\n/*\n Axis 3 — the active named type pairing (`data-type`). The value space + the\n * registry live in `./typography.ts`; re-exported here so `lib/theme/` stays\n the single import surface for theme consumers.\n /\nexport type { TypeId } from './typography';\n\n/* Storage keys for persisting user preferences. /\nexport const THEME_STORAGE_KEYS = {\n pattern: 'motir.theme.pattern',\n style: 'motir.theme.style',\n palette: 'motir.theme.palette',\n type: 'motir.theme.type',\n} as const;\n\n/\n Sensible defaults if localStorage is empty. Note `type` is the GLOBAL fallback\n * only — when no explicit type is pinned, the active STYLE's `defaultTypeId`\n * wins (see `STYLE_DEFAULT_TYPE` / the theme context); this is the floor under\n * an unknown style.\n /\nexport const THEME_DEFAULTS = {\n pattern: 'system' as ThemePattern,\n style: DEFAULT_STYLE_ID as StyleId,\n palette: DEFAULT_PALETTE_ID as PaletteId,\n type: DEFAULT_TYPE_ID as TypeId,\n} as const;\n\n/\n Narrowing guard — is an arbitrary value a valid `pattern` axis id? The\n * colour / style / type axes each ship `isXId` in their registry file; the\n * pattern axis is a fixed three-value union, so its guard lives here next to\n * the type. Mirrors `isStyleId` / `isPaletteId` / `isTypeId`.\n /\nexport function isThemePattern(value: unknown): value is ThemePattern {\n return value === 'system' \|\| value === 'light' \|\| value === 'dark';\n}\n\n/\n Resolve a (possibly stale / unknown / null) value to a valid `pattern`,\n * falling back to `THEME_DEFAULTS.pattern`. The pattern-axis analogue of\n * `resolveStyle` / `resolvePalette` / `resolveType`.\n */\nexport function resolvePattern(value: unknown): ThemePattern {\n return isThemePattern(value) ? value : THEME_DEFAULTS.pattern;\n}\n"]}
1	+ {"version":3,"sources":["../../src/theme/typography.ts","../../src/theme/styles.ts","../../src/theme/palettes.ts","../../src/theme/types.ts"],"names":[],"mappings":"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","file":"types.js","sourcesContent":["/*\n The Motir TYPOGRAPHY LIBRARY — the named-pairing registry (Subtask 7.3.53).\n \n A \"type pairing\" is a named TYPOGRAPHY scheme the whole UI can swap to at\n * runtime — the THIRD design axis, completing the token decomposition\n * (Colour `data-palette` · Type `data-type` · Shape/feel `data-style`). It is\n * deliberately INDEPENDENT of the other two: a pairing decides which TYPEFACES\n * the product wears (the headline / body / mono role mapping); it never touches\n * a hue (palette axis) or a radius (style axis).\n \n ── The three-axis runtime contract ─────────────────────────────────────\n * data-type=\"<type-id>\" — THIS axis. A `[data-type='<id>']` block in\n * app/globals.css re-points the `--font-`\n role tokens (sans / serif / mono) — and ONLY\n * font tokens, never colour or shape.\n * data-palette=\"<palette-id>\" — the INDEPENDENT colour axis (`--el-`).\n data-style=\"<style-id>\" — the INDEPENDENT shape/feel axis.\n \n The shared `--font-size-` SCALE stays common across pairings — sizes are\n layout, not brand; a pairing remaps the FACES, not the type scale.\n \n ── A style declares a DEFAULT pairing (overridable) ────────────────────\n * Typography used to be BUNDLED into the style axis: `swiss-minimal-flat`,\n * `neo-brutalism` and `cybercore-y2k` each re-pointed `--font-serif` inside\n * their own `[data-style]` block. That is now a disjointness violation (two\n * axes setting `--font-`). The fix: each style declares a `defaultTypeId`\n (see ./styles.ts) — the pairing applied when the user has NOT pinned an\n * explicit type — and the per-style font overrides move here, as pairings.\n * So out-of-the-box looks are UNCHANGED; the new freedom is that type is now\n * independently overridable (e.g. Swiss shape + a serif pairing).\n \n ── v1 — the base faces only (no new payload) ───────────────────────────\n * v1 registered three pairings built from the THREE already-loaded next/font\n * faces (Inter · Source Serif 4 · JetBrains Mono) — so they add ZERO font\n * payload and carry NO new-typeface design decision:\n * - `motir` — the base: editorial serif headlines over a sans body.\n * - `motir-sans` — all-sans (Inter headlines); reproduces the Swiss look.\n * - `motir-mono` — mono THROUGHOUT (headlines + body/UI); a code-native UI.\n * `motir` is the base — like the `motir` palette / `warm-editorial` style it\n * needs NO `[data-type]` override block; the base `--font-` tokens already are\n it.\n \n ── New-typeface pairings (Grotesk / Editorial / Mono-Technical, 7.3.54–56) ──\n * Each adds a real type-design decision and loads its own next/font face(s),\n * re-pointing a role in its own `[data-type]` block:\n * - `grotesk` (7.3.54) — Space Grotesk THROUGHOUT (headlines + body/UI).\n * - `editorial` (7.3.55) — Fraunces display-serif headlines over the Inter\n * body; a magazine, considered pairing (one new face — Inter + JetBrains reused).\n * Body STAYS Inter — a display serif is unreadable as UI, so this pairing\n * re-types headlines only (the legibility exception to whole-UI re-typing).\n * - `mono-technical` (7.3.56) — IBM Plex Mono THROUGHOUT (headlines + body/UI +\n * meta); a precise, developer-grade UI (one new face — Inter reused for nothing\n * now, kept as the ultimate fallback).\n \n ── Whole-UI re-typing (Yue, 2026-06-19) ────────────────────────────────\n * A type pairing re-types the WHOLE app, chrome included (nav, header, buttons),\n * not just headlines: a pairing whose signature face reads as a UI sans/mono\n * (`grotesk`, `motir-mono`, `mono-technical`) ALSO re-points the body/UI role\n * (`--font-sans`) in its `[data-type]` block. The display-serif `editorial` and\n * the all-Inter `motir` / `motir-sans` keep the Inter body for legibility.\n * Each later \"Type: …\" subtask ADDS its entry here + a `[data-type]` block (its\n * face loaded in `app/layout.tsx`) + its `docs/typography/<id>.md`.\n /\n\n/* A registered, runtime-selectable type pairing. /\nexport interface TypographyDefinition {\n /* The `data-type` attribute value. Stable; used as the localStorage value. /\n id: string;\n /* Display name shown in the gallery / `/tokens` toggle. /\n name: string;\n /* One-line characterization of the typographic feel. /\n tagline: string;\n /* The headline / body / mono face mapping (credit / what it loads). /\n faces: string;\n /\n Repo-relative path to this pairing's doc — the type-role reference a later\n * getdesign-style swap or the `/tokens` composer reads. Every registered\n * pairing maps to exactly one.\n /\n designDoc: string;\n}\n\n/\n The registry. Insertion order is the gallery order. Each non-base `id`\n * matches a `[data-type='<id>']` block in app/globals.css (`motir` is the base,\n * so its block is the Tier-0 `--font-` defaults — no override block needed).\n /\nexport const TYPE_REGISTRY = {\n motir: {\n id: 'motir',\n name: 'Motir',\n tagline: 'Editorial serif headlines over a clean sans body — the house pairing.',\n faces: 'Source Serif 4 headlines · Inter body · JetBrains Mono meta.',\n designDoc: 'docs/typography/motir.md',\n },\n 'motir-sans': {\n id: 'motir-sans',\n name: 'Motir Sans',\n tagline: 'All-sans — Inter for headlines and body; structural, no serif.',\n faces: 'Inter headlines + body · JetBrains Mono meta.',\n designDoc: 'docs/typography/motir-sans.md',\n },\n 'motir-mono': {\n id: 'motir-mono',\n name: 'Motir Mono',\n tagline: 'Monospace throughout — a code-native UI, headlines, body and all.',\n faces: 'JetBrains Mono headlines + body/UI + meta.',\n designDoc: 'docs/typography/motir-mono.md',\n },\n grotesk: {\n id: 'grotesk',\n name: 'Grotesk',\n tagline: 'Geometric neo-grotesque across the whole UI — tight, confident, product-y.',\n faces: 'Space Grotesk headlines + body/UI · JetBrains Mono meta.',\n designDoc: 'docs/typography/grotesk.md',\n },\n editorial: {\n id: 'editorial',\n name: 'Editorial',\n tagline: 'A characterful display serif over a humanist sans — magazine, considered.',\n faces: 'Fraunces display headlines · Inter body · JetBrains Mono meta.',\n designDoc: 'docs/typography/editorial.md',\n },\n 'mono-technical': {\n id: 'mono-technical',\n name: 'Mono-Technical',\n tagline: 'IBM Plex Mono throughout — a precise, developer-grade UI.',\n faces: 'IBM Plex Mono headlines + body/UI + meta/code.',\n designDoc: 'docs/typography/mono-technical.md',\n },\n} satisfies Record<string, TypographyDefinition>;\n\n/** The id of every registered pairing — `data-type` value space. /\nexport type TypeId = keyof typeof TYPE_REGISTRY;\n\n/* All registered pairing ids, in gallery order. /\nexport const TYPE_IDS = Object.keys(TYPE_REGISTRY) as TypeId[];\n\n/\n The default pairing a fresh install / unset preference resolves to when the\n * active style declares none. Motir is the house pairing and the Tier-0 base.\n /\nexport const DEFAULT_TYPE_ID: TypeId = 'motir';\n\n/* Narrowing guard — is an arbitrary string a registered pairing id? /\nexport function isTypeId(value: unknown): value is TypeId {\n return typeof value === 'string' && Object.prototype.hasOwnProperty.call(TYPE_REGISTRY, value);\n}\n\n/* Resolve a (possibly stale / unknown) value to a valid pairing definition. /\nexport function resolveType(value: unknown): TypographyDefinition {\n return TYPE_REGISTRY[isTypeId(value) ? value : DEFAULT_TYPE_ID];\n}\n","/\n The Motir STYLE LIBRARY — the named-aesthetic registry (Subtask 7.3.32).\n \n A \"style\" is a named, end-to-end AESTHETIC the whole UI can swap to at\n * runtime — the foundation the onboarding design wizard (7.3.27) and the\n * `/tokens` composer (7.3.30) build on. It is the SHAPE/feel axis, and it is\n * deliberately INDEPENDENT of the COLOR axis (`data-palette` — see below): a\n * style decides how the product FEELS (silhouette, stroke, elevation, surface\n * treatment, density, motion, typography, component silhouettes); a palette\n * decides what colours it WEARS. Picking a style never changes a hue, and\n * picking a palette never changes a radius.\n \n ── The two-axis runtime contract ───────────────────────────────────────\n * data-style=\"<style-id>\" — THIS axis. Layers per-style shape/feel\n * tokens (+ component-variant overrides) over\n * the Tier-0 base scale in app/globals.css.\n * data-palette=\"<palette-id>\" — the INDEPENDENT colour axis (re-skins the\n * `--el-` layer). Orthogonal to data-style.\n data-theme=\"light\|dark\" — the light/dark base within a palette.\n \n A `[data-style='…']` TOKEN block in globals.css MUST override ONLY shape/feel\n * tokens (radius / spacing / shadow / sizing / transition / type) — NEVER a\n * `--color-` or `--el-` colour token. That is the palette axis's job, and\n * keeping the two disjoint is what makes \"style × palette\" a true product of\n * two independent choices rather than 2×N hand-tuned combinations.\n \n A SURFACE-MATERIAL style (glassmorphism, 7.3.35; later cybercore, aurora,\n * neumorphism …) owns a richer surface — translucency, a gradient canvas,\n * frosted backdrop-blur — that the token block cannot express. It adds a\n * palette-DERIVED MATERIAL LAYER: style-scoped component rules\n * (`[data-style='id'] [data-surface='…'] { … }`) whose colour comes ONLY from\n * `color-mix()`/`var(--color-\|--el-)` over the ACTIVE palette, never a raw\n * hue — so the two axes stay disjoint (a palette swap re-tints the material; a\n * style swap leaves hues untouched). Surfaces opt in via the `data-surface`\n * hook the shared primitives emit. Both rules are enforced by\n * tests/theme/styleRegistry.test.ts.\n \n ── Why a style is MORE than a token swap ───────────────────────────────\n * The feel-bearing DIMENSIONS below are the axes a pure token swap ignores:\n * two styles can share the Tier-0 scale yet feel utterly different because\n * their silhouette, elevation philosophy, surface treatment, and component\n * silhouettes diverge. The registry names those dimensions so each style (and\n * its DESIGN.md) is authored against the same rubric.\n \n This module is the schema + the registration of the styles. Each \"Style: …\"\n * subtask (7.3.33–7.3.42) ADDS its entry here, ships a `[data-style='<id>']`\n * token block in globals.css (plus, for a surface-material style, the\n * palette-derived material layer above), and authors its `docs/styles/<id>.md`\n * DESIGN.md.\n /\n\nimport { DEFAULT_TYPE_ID, type TypeId } from './typography';\n\n/\n The feel-bearing axes a named style controls. A token-only swap reaches the\n * first few; the rest (surface treatment, motion, typography, component\n * silhouettes) are what give a style its identity and must be authored, not\n * derived. The order here is the canonical presentation order (the `/tokens`\n * page + each style's DESIGN.md walk them in this sequence).\n /\nexport const STYLE_DIMENSIONS = [\n {\n key: 'silhouette',\n label: 'Shape / silhouette',\n description:\n 'Corner-radius personality — sober rectangles vs. soft pills vs. hard right angles.',\n },\n {\n key: 'stroke',\n label: 'Border / stroke',\n description: 'Hairline vs. heavy outline; whether structure is drawn with borders at all.',\n },\n {\n key: 'elevation',\n label: 'Elevation philosophy',\n description: 'How depth is expressed — soft diffuse shadows, hard offset shadows, or flat.',\n },\n {\n key: 'surface',\n label: 'Surface / background treatment',\n description:\n 'Opaque cards vs. translucent glass vs. tinted washes — the material of a surface.',\n },\n {\n key: 'density',\n label: 'Density rhythm',\n description: 'Padding/sizing cadence — compact and efficient vs. roomy and relaxed.',\n },\n {\n key: 'motion',\n label: 'Motion',\n description: 'Transition speed and easing — snappy, gentle, or springy.',\n },\n {\n key: 'typography',\n label: 'Typography',\n description:\n \"The style's DEFAULT type pairing — type is the independent `data-type` axis now (see ./typography.ts + `defaultTypeId`); this describes the pairing the style ships with: editorial serif, all-sans, or mono headlines.\",\n },\n {\n key: 'components',\n label: 'Component silhouettes',\n description:\n 'Per-component shape overrides beyond tokens (e.g. a pill button vs. a square one).',\n },\n] as const;\n\nexport type StyleDimensionKey = (typeof STYLE_DIMENSIONS)[number]['key'];\n\n/* A registered, runtime-selectable style. /\nexport interface StyleDefinition {\n /* The `data-style` attribute value. Stable; used as the localStorage value. /\n id: string;\n /* Display name shown in the gallery / `/tokens` toggle. /\n name: string;\n /* One-line characterization of the feel. /\n tagline: string;\n /* Where the look is drawn from (credit / mood anchor). /\n inspiration: string;\n /* One line per feel-bearing dimension — the authored rubric for this style. /\n dimensions: Record<StyleDimensionKey, string>;\n /\n Repo-relative path to this style's DESIGN.md — the doc the `/tokens` page\n * composes (and a later getdesign-style swap reads). Every registered style\n * maps to exactly one.\n /\n designDoc: string;\n /\n The type pairing (`data-type`, see ./typography.ts) this style applies when\n * the user has NOT pinned an explicit type — the style's curated default,\n * overridable. Type is its own axis now; this is how a style keeps its\n * out-of-the-box typographic feel (e.g. swiss → `motir-sans`, neo-brutalism /\n * cybercore-y2k → `motir-mono`) without owning `--font-` in its own block.\n /\n defaultTypeId: TypeId;\n}\n\n/*\n The registry. Insertion order is the gallery order. Each `id` matches a\n * `[data-style='<id>']` block in app/globals.css (Warm Editorial is the base,\n * so its block is the Tier-0 defaults — no override block needed).\n /\nexport const STYLE_REGISTRY = {\n 'warm-editorial': {\n id: 'warm-editorial',\n name: 'Warm Editorial',\n tagline: 'Thoughtful, warm, technical-but-not-cold, slightly editorial.',\n inspiration: \"Notion's warm palette + Source Serif headlines over Inter body.\",\n designDoc: 'docs/styles/warm-editorial.md',\n defaultTypeId: 'motir',\n dimensions: {\n silhouette: 'Sober rectangles — 8px buttons, 12px cards. Restrained, document-like.',\n stroke: 'Hairline borders (1px warm-grey); structure drawn quietly, never heavy.',\n elevation: 'Modest, low-spread shadows; surfaces sit close to the page.',\n surface: 'Opaque cream surfaces over a white canvas; pastel tints for feature cards only.',\n density: 'Comfortable default rhythm — 18×10 button padding, 24px card padding.',\n motion: 'Brisk 150ms ease; understated, gets out of the way.',\n typography: 'Source Serif 4 editorial headlines + Inter body + JetBrains Mono meta.',\n components:\n 'Rectangular buttons/inputs, hairline-bordered cards, badge pills for status only.',\n },\n },\n 'soft-playful': {\n id: 'soft-playful',\n name: 'Soft / Playful',\n tagline: 'More energy — rounded, generous, gently animated.',\n inspiration: \"Figma's pill-shape language (50px pills, roomy spacing).\",\n designDoc: 'docs/styles/soft-playful.md',\n defaultTypeId: 'motir',\n dimensions: {\n silhouette: 'Pill buttons (fully rounded) and large 24px card/input radii. Friendly, bubbly.',\n stroke: 'Same hairline borders as the base; identity comes from radius, not stroke weight.',\n elevation: 'Softer, more diffused shadows — surfaces float a touch more.',\n surface: 'Opaque, like the base — colour stays the palette axis; only the shape softens.',\n density: 'Roomier — 20×12 button padding, 28px card padding, taller controls.',\n motion: 'Gentler 200ms ease and a slightly deeper press scale for a springy feel.',\n typography: 'Inherits the base type pairing; the personality is in shape, not type.',\n components: 'Pill buttons, heavily-rounded inputs/cards/modals, rounder small affordances.',\n },\n },\n 'swiss-minimal-flat': {\n id: 'swiss-minimal-flat',\n name: 'Swiss / Minimal-Flat',\n tagline: 'International-typographic, structural, calm — flat, sharp, gridded.',\n inspiration: 'Swiss International Typographic Style — Müller-Brockmann grids, flat surfaces.',\n designDoc: 'docs/styles/swiss-minimal-flat.md',\n defaultTypeId: 'motir-sans',\n dimensions: {\n silhouette:\n 'Sharp near-square corners (2px) on every surface — hard right angles, structural.',\n stroke:\n 'Hairline borders do ALL the structural work; with elevation removed, the 1px rule is the only divider.',\n elevation:\n 'Flat — every shadow is removed (none). Depth comes from borders + whitespace, not lift.',\n surface:\n 'Opaque, untinted panels delineated by hairline rules; no floating, no glass, no wash.',\n density:\n 'Tight, gridded controls (crisp 16×9 buttons, 34px control height) with generous 28px card whitespace.',\n motion:\n 'Minimal — fast 100ms transitions and NO press-scale (calm, mechanical, never springy).',\n typography:\n 'Restrained neo-grotesque sans throughout — headlines drop the editorial serif for Inter, tight and strong.',\n components:\n 'Square buttons/inputs/cards/modals, rectangular (non-pill) status chips, flat hairline-ruled surfaces.',\n },\n },\n 'neo-brutalism': {\n id: 'neo-brutalism',\n name: 'Neo-Brutalism',\n tagline: 'Raw, punchy, utilitarian — 0px corners, thick borders, hard-offset shadows.',\n inspiration:\n 'Neo-brutalist web design — Gumroad / Figma-community brutalism: blocky, unpolished, loud.',\n designDoc: 'docs/styles/neo-brutalism.md',\n defaultTypeId: 'motir-mono',\n dimensions: {\n silhouette:\n 'Zero radius — hard 0px corners on EVERY surface (buttons, cards, inputs, modals, status chips). Blocky and uncompromising.',\n stroke:\n 'Heavy solid 2px outlines do the structural work — borders are LOUD, not hairline (the defining neo-brutalist move, applied via a style-scoped component-variant block).',\n elevation:\n 'Hard-offset drop shadows with ZERO blur (e.g. 4px 4px 0 0) — a solid block of shadow, never a soft lift; the chunky frame, not diffusion.',\n surface:\n 'Opaque, flat, untinted panels framed by the thick border + the hard shadow; no glass, no wash, no gradient.',\n density:\n 'Tight, utilitarian controls (16×10 buttons, 36px control height) with compact 20px card padding — no wasted space.',\n motion:\n 'Snappy and mechanical — near-instant 60ms transitions and NO press-scale; the UI reacts, it does not animate.',\n typography:\n 'Raw monospace headlines — the editorial serif is re-pointed at the JetBrains Mono stack, against the Inter grotesk body.',\n components:\n 'Square buttons/inputs/cards/modals, rectangular (non-pill) status chips, thick-bordered surfaces with hard-offset shadows.',\n },\n },\n glassmorphism: {\n id: 'glassmorphism',\n name: 'Glassmorphism',\n tagline: 'Translucent frosted glass floating over a soft, vibrant gradient.',\n inspiration:\n \"Apple's visionOS / macOS Big Sur 'frosted glass' material — backdrop-blur over depth.\",\n designDoc: 'docs/styles/glassmorphism.md',\n defaultTypeId: 'motir',\n dimensions: {\n silhouette:\n 'Soft, rounded glass tiles — 12px buttons/inputs, 18px cards, 22px modals. Friendly, never sharp.',\n stroke:\n 'Light 1px hairlines at reduced opacity — a glass edge catching light, not a structural rule.',\n elevation:\n 'Layered, diffuse, low-opacity shadows — panels float as hovering frosted sheets above the canvas.',\n surface:\n 'The identity axis: translucent frosted panels (backdrop-blur) over a soft palette-derived gradient canvas — material, not opaque.',\n density:\n 'Comfortable, a touch roomy — 20×11 buttons, 26px card padding, 38px controls; glass tiles want air.',\n motion:\n 'Gentle, smooth — 220ms ease and a light press-scale; glass slides into place, it never snaps.',\n typography:\n 'Inherits the base editorial type pairing; the personality is in the material, not the type.',\n components:\n 'Rounded frosted cards / popovers / modals / sidebar / inputs (the data-surface material layer), pill status chips.',\n },\n },\n 'cybercore-y2k': {\n id: 'cybercore-y2k',\n name: 'Cybercore / Y2K',\n tagline: 'Neon-on-dark retro-tech — glowing HUD panels, a tech grid, mono headlines.',\n inspiration:\n 'Y2K / cyberpunk HUDs — neon-on-dark terminals, Tron grids, glowing edges, monospace displays.',\n designDoc: 'docs/styles/cybercore-y2k.md',\n defaultTypeId: 'motir-mono',\n dimensions: {\n silhouette:\n 'Hard terminal-frame corners (sharp 2–4px) — chiseled HUD panels, not soft cards.',\n stroke:\n 'Structure drawn by a lit edge — a 1px glow-ring (currentColor halo) on every surface, not a heavier border.',\n elevation:\n 'Neon GLOW instead of drop-shadow — surfaces emit an outward currentColor halo, lit rather than lifted.',\n surface:\n 'A faint tech grid (scanline/grid texture) washes the canvas behind opaque HUD panels.',\n density:\n 'Tight, technical HUD rhythm — compact controls (18×9 buttons, 34px control height) over snug 20px card padding.',\n motion: 'Snappy and electric — very fast 90ms transitions with a crisp press-scale.',\n typography:\n 'Mono/display headlines — the serif headline face is swapped to JetBrains Mono for a terminal read; body stays sans.',\n components:\n 'Sharp glow-ringed panels, mono headings, rectangular chips; the lit edge replaces the drop shadow everywhere.',\n },\n },\n aurora: {\n id: 'aurora',\n name: 'Aurora',\n tagline: 'Soft, drifting aurora light behind fluid, gently-glowing surfaces.',\n inspiration:\n 'The northern lights — slow ribbons of colour over a night sky — and the soft animated-gradient \"aurora\" hero look (Stripe / Vercel ambient gradients).',\n designDoc: 'docs/styles/aurora.md',\n defaultTypeId: 'motir',\n dimensions: {\n silhouette:\n 'Fluid, soft corners — 14px buttons/inputs, 20px cards, 26px modals. Organic and rounded, a touch softer than glass.',\n stroke:\n 'Quiet 1px hairlines; structure is implied by the gentle glow and elevation, never drawn by a heavy rule.',\n elevation:\n 'A soft neutral lift PLUS a gentle palette-derived COLOUR glow halo — surfaces feel lit from within, never hard-edged.',\n surface:\n 'The identity axis: opaque fluid surfaces floating over a slowly-DRIFTING, animated aurora gradient canvas (palette-derived ribbons).',\n density:\n 'Comfortable and roomy — 20×11 buttons, 26px card padding, 38px controls; the light wants space to breathe.',\n motion:\n 'Smooth and slow — 260ms eased transitions, a faint press-scale, and a 28s ambient drift of the aurora canvas (stilled under prefers-reduced-motion).',\n typography:\n 'Inherits the base editorial pairing (Source Serif headlines + Inter body); the personality is in the moving light, not the type.',\n components:\n 'Fluid, gently-glowing cards / popovers / modals / sidebar (the data-surface material layer); pill status chips.',\n },\n },\n '3d-immersive': {\n id: '3d-immersive',\n name: '3D / Immersive',\n tagline: 'Depth and perspective — dimensional cards floating over the page.',\n inspiration:\n 'Spatial / depth UI — visionOS spatial layers, Stripe-era layered cards, soft real-world light.',\n designDoc: 'docs/styles/3d-immersive.md',\n defaultTypeId: 'motir',\n dimensions: {\n silhouette:\n 'Generously rounded dimensional tiles — 14px buttons/inputs, 20px cards, 28px modals. Soft, tactile, never sharp.',\n stroke:\n 'Borders nearly vanish (a faint hairline) — structure is read from depth + shadow, not an outline.',\n elevation:\n 'The identity axis: deep multi-layer shadows float every surface off the canvas, and on tilt a card becomes a TRUE 3D object — perspective + preserve-3d + per-slot translateZ planes (header pops forward, footer behind) parallax under a cursor-tracked glare. Not a flat-plane tilt.',\n surface:\n 'A palette-derived immersive background atmosphere on every page, with opaque dimensional panels (cards, tables, board columns, widgets) floating above it on deep resting shadows — depth (not tint or glass) is the material; nothing sits flat.',\n density:\n 'Roomy and immersive — 22×12 buttons, 28px card padding, 40px controls; depth wants air around each tile.',\n motion:\n 'The standard \"3D card\" pointer-parallax — tiles tip toward the cursor (rotateX/rotateY over a perspective) via the ImmersiveTilt engine, lifting as they turn; reduced-motion-gated, settling flat on leave.',\n typography:\n 'Inherits the base editorial type pairing; the personality is in depth + light, not the type.',\n components:\n 'Rounded cards / board cards / modals that tilt toward the pointer with layered parallax; PHYSICAL buttons with real thickness (a solid base edge) that press DOWN on click; each board column floats as its own card. Nothing is flat.',\n },\n },\n neumorphism: {\n id: 'neumorphism',\n name: 'Neumorphism',\n tagline: 'Soft extruded surfaces that swell out of a single monochrome field.',\n inspiration:\n 'Neumorphism / soft-UI — Dribbble-era \"soft shadow\" interfaces where panels are pressed OUT of (or INTO) one continuous surface by a paired light + dark shadow.',\n designDoc: 'docs/styles/neumorphism.md',\n defaultTypeId: 'motir',\n dimensions: {\n silhouette:\n 'Soft, generously rounded pebbles — 12px buttons/inputs, 18px cards, 22px modals. Tactile and friendly, the rounding that lets a shadow wrap a surface.',\n stroke:\n 'Borders nearly vanish — a faint hairline kept ONLY as the accessibility fallback (see below); structure is read from the paired soft shadow, not an outline.',\n elevation:\n 'The identity axis: a DUAL soft shadow — a light highlight top-left + a palette-derived dark shadow bottom-right — extrudes each surface OUT of the canvas (raised), while inputs and pressed controls invert it to an INSET well (pressed in). Depth is a soft swell, never a hard drop.',\n surface:\n 'Monochrome and continuous: the page canvas and every panel share ONE opaque palette surface, so a card looks moulded out of the background rather than placed on top of it — the soft-UI \"single material\" look. Opaque (text AA preserved), with the depth carried entirely by the shadows.',\n density:\n 'Comfortable and roomy — 20×11 buttons, 26px card padding, 38px controls; the soft shadows need air around each surface to read as extruded.',\n motion:\n 'Gentle — 200ms ease and a soft press-scale; nothing snaps, matching the moulded surfaces (form fields rest as concave inset wells, panels swell out raised).',\n typography:\n 'Inherits the base editorial type pairing; the personality is in the moulded surfaces, not the type.',\n components:\n 'Raised, soft-shadowed cards / popovers / modals / sidebar (the data-surface material layer); concave inset inputs; pill status chips. Every surface swells from or sinks into the one field.',\n },\n },\n 'hand-drawn-indie': {\n id: 'hand-drawn-indie',\n name: 'Hand-Drawn / Indie',\n tagline:\n 'Sketchy and friendly — rough hand-inked edges, wonky corners, soft offset shadows, a playful bounce.',\n inspiration:\n 'Indie / zine + hand-drawn web design — Excalidraw’s rough hand-sketched strokes and doodled notebook UIs: warm, imperfect, human.',\n designDoc: 'docs/styles/hand-drawn-indie.md',\n defaultTypeId: 'editorial',\n dimensions: {\n silhouette:\n 'Wonky hand-drawn corners — every surface gets a strongly asymmetric multi-value radius (one corner near-sharp, the opposite generously round, no two alike) so cards/buttons/inputs read as DRAWN boxes, never machined rectangles.',\n stroke:\n 'Genuinely ROUGH, wavy ink edges — a turbulence-displacement filter (Excalidraw / rough.js style) warps each outline into a hand-inked wobble, drawn on a content-safe pseudo-border so the lines are sketchy but the text stays crisp.',\n elevation:\n 'Soft, hand-placed offset shadows — a gentle blurred drop nudged down-right (a doodled shadow), friendly and low; never a hard brutalist block nor a flat removal.',\n surface:\n 'Opaque, warm, paper-like panels — colour stays the palette axis; the personality is in the rough wavy outline + the soft shadow, not a tint or a wash.',\n density:\n 'Roomy and relaxed — generous 20×12 buttons, 26px card padding, taller 38px controls; the hand-drawn feel wants air, like margins round a sketch.',\n motion:\n 'Springy and playful — gentle 200ms transitions with a bouncy hover lift (1.02) and a deeper press squish (0.97); the UI has a friendly wobble.',\n typography:\n 'Ships the Editorial pairing (Fraunces display headlines + Inter body) — the warmest, most characterful registered face, its soft optical wonk echoing the hand-drawn shapes; an actual marker/script face is a future data-type addition.',\n components:\n 'Wonky-cornered buttons/inputs/cards/modals, irregular (non-pill) status chips, rough wavy-ink-bordered surfaces with soft hand-placed shadows.',\n },\n },\n retrofuturism: {\n id: 'retrofuturism',\n name: 'Retrofuturism',\n tagline: 'Chrome, gradient sweeps and a synthwave horizon — 70s/80s sci-fi.',\n inspiration:\n 'Retrofuturism / Outrun — 70s–80s sci-fi: chrome lettering, synthwave sunset gradients, airbrushed sci-fi paperbacks, and wide geometric display type.',\n designDoc: 'docs/styles/retrofuturism.md',\n defaultTypeId: 'grotesk',\n dimensions: {\n silhouette:\n 'Streamlined chrome capsules — fully-rounded pill buttons + chips, 16px cards, 22px modals. Aerodynamic 70s/80s curves, never sharp.',\n stroke:\n 'A lit chrome edge — a bright inset highlight + a dark base line over a faint hairline, reading as a polished metal rim rather than a drawn border.',\n elevation:\n 'Chrome bevels + a diagonal SPECULAR streak + a palette-derived glow — a bright top highlight fading to a dark base with a swept light-bar across each panel, so surfaces read as polished reflective metal, not flat cards.',\n surface:\n 'The identity axis: a synthwave SKY + a bright HORIZON GLOW band + a receding neon perspective GRID floor (all palette-derived) behind chrome-bevelled, specular-streaked surfaces. Dark-first — the neon horizon + grid read strongest on a dark palette.',\n density:\n 'Confident and roomy — 22×11 chrome-capsule buttons, 24px card padding, 38px controls; the chrome wants room to catch the light.',\n motion:\n 'Smooth and gliding — 200ms eased transitions and a confident press-scale; the synthwave horizon + grid are a STATIC backdrop (no motion to distract the work surface).',\n typography:\n 'Wide geometric grotesque display (the `grotesk` type pairing) — the retro-futurist sci-fi headline read; body stays a legible sans.',\n components:\n 'Chrome-capsule buttons with a metallic glint, specular-streaked bevelled cards / popovers / modals / sidebar / inputs (the data-surface material layer), pill status chips — a synthwave horizon + neon grid behind it all.',\n },\n },\n} satisfies Record<string, StyleDefinition>;\n\n/* The id of every registered style — `data-style` value space. /\nexport type StyleId = keyof typeof STYLE_REGISTRY;\n\n/* All registered style ids, in gallery order. /\nexport const STYLE_IDS = Object.keys(STYLE_REGISTRY) as StyleId[];\n\n/\n The default style a fresh install / unset preference resolves to. Warm\n * Editorial is Motir's house style and the Tier-0 base.\n /\nexport const DEFAULT_STYLE_ID: StyleId = 'warm-editorial';\n\n/* Narrowing guard — is an arbitrary string a registered style id? /\nexport function isStyleId(value: unknown): value is StyleId {\n return typeof value === 'string' && Object.prototype.hasOwnProperty.call(STYLE_REGISTRY, value);\n}\n\n/* Resolve a (possibly stale / unknown) value to a valid style definition. /\nexport function resolveStyle(value: unknown): StyleDefinition {\n return STYLE_REGISTRY[isStyleId(value) ? value : DEFAULT_STYLE_ID];\n}\n\n/\n styleId → its `defaultTypeId` — the type pairing applied when the user has\n * not pinned an explicit `data-type`. Baked into the FOUC init script (so the\n * pre-hydration pass can resolve the right type for the active style) and used\n * by the theme context's effective-type derivation. `resolveType` (the\n * registry) supplies the ultimate fallback, so every value here is a real id.\n /\nexport const STYLE_DEFAULT_TYPE: Record<StyleId, TypeId> = Object.fromEntries(\n STYLE_IDS.map((id) => [id, STYLE_REGISTRY[id].defaultTypeId]),\n) as Record<StyleId, TypeId>;\n\n/* The default type for a (possibly unknown) style value — the fallback chain. /\nexport function defaultTypeForStyle(styleValue: unknown): TypeId {\n return isStyleId(styleValue) ? STYLE_REGISTRY[styleValue].defaultTypeId : DEFAULT_TYPE_ID;\n}\n","/\n The Motir PALETTE LIBRARY — the named-colour registry (Subtask 7.3.48).\n \n A \"palette\" is a named COLOUR scheme the whole UI can swap to at runtime —\n * the second half of the two-axis contract the style schema (7.3.32) wrote but\n * did not implement. It is the COLOUR/hue axis, and it is deliberately\n * INDEPENDENT of the SHAPE axis (`data-style` — see ./styles.ts): a palette\n * decides what colours the product WEARS (surfaces, ink, accent, tints,\n * semantic hues); a style decides how it FEELS (silhouette, elevation,\n * density, motion). Picking a palette never changes a radius, and picking a\n * style never changes a hue.\n \n ── The two-axis runtime contract ───────────────────────────────────────\n * data-palette=\"<palette-id>\" — THIS axis. Layers per-palette `--el-`\n element-token overrides over the Tier-3\n * base in app/globals.css.\n * data-style=\"<style-id>\" — the INDEPENDENT shape/feel axis.\n * data-theme=\"light\|dark\" — the light/dark base WITHIN a palette\n * (`--color-`); orthogonal to the palette.\n \n * A `[data-palette='…']` block in globals.css MUST override ONLY `--el-`\n element colour tokens — NEVER a shape/feel token (radius / spacing / shadow\n * / sizing / motion / type). That is the style axis's job, and keeping the two\n * disjoint is what makes \"style × palette\" a true product of two independent\n * choices rather than N×M hand-tuned combinations.\n \n ── Motir's own palette, and the one that used to be ──────────────────────\n * Motir is the palette Motir wears when a person has chosen none: the stark\n * monochrome scheme (cool greyscale surfaces + ink, an ink CTA, a single\n * restrained cool-blue accent). It shipped as \"Graphite\" (7.3.51) and took the\n * product's name in MOTIR-6471, so its colours arrive through its\n * `[data-palette='motir']` block.\n \n Amethyst is the warm scheme the product wore until then (cream surfaces,\n * charcoal ink, purple primary, pastel feature tints), which carried the name\n * \"Motir\" from v1 (Per Yue, 2026-06-17) until that rename. It is still the\n * Tier-0/Tier-3 BASE in theme.css, so — exactly like the `warm-editorial` base\n * style — the base `--el-` tokens already are it; its `[data-palette='amethyst']`\n blocks only re-assert that base inside a scoped subtree. `<html>` always\n * carries a `data-palette`, so the base is a fallback, never what a person sees\n * by default. Each later \"Palette: …\" subtask ADDS its entry here, ships a\n * `[data-palette='<id>']` block overriding the `--el-` layer, and authors its\n `docs/palettes/<id>.md` doc — exactly the shape the per-style subtasks\n * (7.3.33+) follow on the other axis.\n \n ⚠️ A STORED palette id written before the rename means the OTHER palette:\n * `motir` meant today's `amethyst`, and `graphite` meant today's `motir`. Every\n * store is migrated once (`PALETTE_ID_MIGRATION` in ./types.ts, and the\n * `user_appearance_preference` migration) — never alias the old spellings.\n /\n\n/* A registered, runtime-selectable colour palette. /\nexport interface PaletteDefinition {\n /* The `data-palette` attribute value. Stable; used as the localStorage value. /\n id: string;\n /* Display name shown in the gallery / `/tokens` toggle. /\n name: string;\n /* One-line characterization of the colour mood. /\n tagline: string;\n /* Where the colours are drawn from (credit / mood anchor). /\n inspiration: string;\n /\n Repo-relative path to this palette's doc — the colour-role reference a\n * later getdesign-style swap or the `/tokens` composer reads. Every\n * registered palette maps to exactly one.\n /\n designDoc: string;\n}\n\n/\n The registry. Insertion order is the gallery order. Each `id` matches a\n * `[data-palette='<id>']` block in theme.css (Amethyst is the Tier-3 base, so its\n * blocks only re-assert the defaults inside a scoped subtree).\n /\nexport const PALETTE_REGISTRY = {\n motir: {\n id: 'motir',\n name: 'Motir',\n tagline:\n 'Stark and editorial — cool greyscale surfaces + ink, an ink CTA, a single restrained cool-blue accent.',\n inspiration:\n \"Vercel's black-and-white precision + Linear's ultra-minimal, on Radix Slate/Blue scales.\",\n designDoc: 'docs/palettes/motir.md',\n },\n amethyst: {\n id: 'amethyst',\n name: 'Amethyst',\n tagline: 'Warm and editorial — cream surfaces, charcoal ink, a purple primary, pastel tints.',\n inspiration:\n \"Notion's warm marketing palette — Motir's house colours until the monochrome rename.\",\n designDoc: 'docs/palettes/amethyst.md',\n },\n cobalt: {\n id: 'cobalt',\n name: 'Cobalt',\n tagline:\n 'Cool and institutional — slate-cool surfaces, a confident cobalt primary, cooled tints.',\n inspiration:\n \"Coinbase's clean institutional blue + IBM's structured blue, on Radix Blue/Indigo/Slate scales.\",\n designDoc: 'docs/palettes/cobalt.md',\n },\n evergreen: {\n id: 'evergreen',\n name: 'Evergreen',\n tagline:\n 'Fresh and technical — an emerald primary over cooled forest neutrals, a green-leaning UI.',\n inspiration:\n 'getdesign.md — Supabase (dark emerald) / Spotify (vibrant green) / MongoDB (spring green), on Radix green/jade ramps.',\n designDoc: 'docs/palettes/evergreen.md',\n },\n spectrum: {\n id: 'spectrum',\n name: 'Spectrum',\n tagline:\n 'Vibrant and playful — crisp cool surfaces, a bright violet primary, a candy-bright multi-hue accent & tint set.',\n inspiration:\n \"Figma's vibrant multi-colour brand + Airtable's colourful, friendly palette, on Radix Violet/Iris/Pink/Blue scales.\",\n designDoc: 'docs/palettes/spectrum.md',\n },\n amber: {\n id: 'amber',\n name: 'Amber',\n tagline:\n 'Warm and electric — Binance trading-floor gold over the exchange’s graphite near-blacks; dark labels on the gold.',\n inspiration:\n 'Binance — its whole documented palette: the bold gold #F0B90B/#FCD535 over cool graphite trading-floor blacks (#0B0E11/#1E2329) + greys, with the buy-green/sell-red semantics.',\n designDoc: 'docs/palettes/amber.md',\n },\n sienna: {\n id: 'sienna',\n name: 'Sienna',\n tagline:\n 'Warm and vivid — Mistral flame-orange over the Mediterranean warm-cream surfaces; dark labels on the flame.',\n inspiration:\n 'Mistral AI — its whole documented palette (getdesign.md/mistral.ai): the flame #fa520f + Block-gradient + Sunshine ambers over Warm-Ivory cream surfaces (#fffaeb) and Mistral-Black ink.',\n designDoc: 'docs/palettes/sienna.md',\n },\n garnet: {\n id: 'garnet',\n name: 'Garnet',\n tagline:\n 'Rich and bold — Pinterest Pushpin red over the brand’s neutral greys; white labels on the red.',\n inspiration:\n 'Pinterest — its whole documented palette: Pushpin red #E60023/#BD081C over Cod-Gray ink (#111111) and neutral greys (#767676/#EFEFEF), with Gestalt “Skycicle” blue links.',\n designDoc: 'docs/palettes/garnet.md',\n },\n citrine: {\n id: 'citrine',\n name: 'Citrine',\n tagline:\n 'Bright and collaborative — Miro’s Sunglow yellow over the whiteboard greys, with the Miro action-blue accent.',\n inspiration:\n 'Miro — its whole Mirotone palette (every value a documented Mirotone step): Sunglow yellow #FFD02F (primary) + the action-blue #3859FF over the gray ramp + Stratos ink #050038, with the green/red semantic ramps.',\n designDoc: 'docs/palettes/citrine.md',\n },\n candy: {\n id: 'candy',\n name: 'Candy',\n tagline:\n 'Sweet and playful — a light bubblegum-pink primary over candy-paper pinks, with a full pastel-candy rainbow.',\n inspiration:\n 'A candy concept grounded entirely in documented Radix Colors scales (every value a Radix step): Pink primary + Mauve neutrals + a Sky/Jade/Violet/Amber/Crimson candy rainbow; Glossier Pink #F5DADF as the pastel-pink mood reference.',\n designDoc: 'docs/palettes/candy.md',\n },\n} satisfies Record<string, PaletteDefinition>;\n\n/* The id of every registered palette — `data-palette` value space. /\nexport type PaletteId = keyof typeof PALETTE_REGISTRY;\n\n/* All registered palette ids, in gallery order. /\nexport const PALETTE_IDS = Object.keys(PALETTE_REGISTRY) as PaletteId[];\n\n/\n The palette Motir wears when a person has chosen none — a fresh install, a\n * signed-out visitor, an unset (null) server preference. Its VALUE has been\n * `'motir'` since v1; what it NAMES changed in MOTIR-6471, from the warm scheme\n * (now `amethyst`) to the monochrome one (formerly `graphite`).\n /\nexport const DEFAULT_PALETTE_ID: PaletteId = 'motir';\n\n/\n The palette theme.css's Tier-0/Tier-3 BASE carries — the one with no root\n * `[data-palette]` override block, only a scoped re-assertion. It is the\n * reference every other palette's override is measured AGAINST. Until\n * MOTIR-6471 it was also {@link DEFAULT_PALETTE_ID}; since the rename the two\n * differ, so a reader asking \"which palette is the base?\" names this and never\n * the default.\n /\nexport const BASE_PALETTE_ID: PaletteId = 'amethyst';\n\n/\n The default look the onboarding Design step offers for a user's OWN project —\n * a different question from the one {@link DEFAULT_PALETTE_ID} answers. It stays\n * on the warm scheme the step has always opened on (MOTIR-6470's scope boundary,\n * confirmed by the requester).\n /\nexport const DEFAULT_PROJECT_PALETTE_ID: PaletteId = 'amethyst';\n\n/* Narrowing guard — is an arbitrary string a registered palette id? /\nexport function isPaletteId(value: unknown): value is PaletteId {\n return typeof value === 'string' && Object.prototype.hasOwnProperty.call(PALETTE_REGISTRY, value);\n}\n\n/* Resolve a (possibly stale / unknown) value to a valid palette definition. /\nexport function resolvePalette(value: unknown): PaletteDefinition {\n return PALETTE_REGISTRY[isPaletteId(value) ? value : DEFAULT_PALETTE_ID];\n}\n","/\n Theme types for Motir's THREE-axis design system.\n \n Axis 1 — COLOR (`data-theme` light/dark base · `data-palette` full\n * `--el-` palette swap — the colour axis)\n Axis 2 — STYLE (`data-style` — a named aesthetic controlling shape /\n * silhouette / elevation / surface / density / motion /\n * component silhouettes)\n * Axis 3 — TYPE (`data-type` — a named pairing controlling the `--font-`\n role mapping; a style declares a default pairing, overridable)\n \n The three axes are INDEPENDENT: a style never touches a hue or a face, a\n * palette never touches a radius, a type pairing never touches colour or shape.\n * The registries live in `./styles.ts`, `./palettes.ts`, `./typography.ts`.\n \n Architecture mirrors dooooWeb. See docs/DESIGN.md for the rationale.\n /\n\nimport { DEFAULT_STYLE_ID, type StyleId } from './styles';\nimport { DEFAULT_PALETTE_ID, type PaletteId } from './palettes';\nimport { DEFAULT_TYPE_ID, type TypeId } from './typography';\n\n/* Tier 1 — light/dark base. `system` follows OS preference at runtime. /\nexport type ThemePattern = 'system' \| 'light' \| 'dark';\n\n/* Resolved pattern (what data-theme is set to after `system` resolves). /\nexport type ResolvedThemePattern = 'light' \| 'dark';\n\n/\n Axis 2 — the active named style (`data-style`). The value space + the\n * registry of every style live in `./styles.ts`; this re-export keeps\n * `lib/theme/` the single import surface for theme consumers.\n /\nexport type { StyleId } from './styles';\n\n/*\n Axis 1 (colour) — the active named palette (`data-palette`). The value space\n * + the registry of every palette live in `./palettes.ts`; re-exported here so\n * `lib/theme/` stays the single import surface for theme consumers.\n /\nexport type { PaletteId } from './palettes';\n\n/*\n Axis 3 — the active named type pairing (`data-type`). The value space + the\n * registry live in `./typography.ts`; re-exported here so `lib/theme/` stays\n the single import surface for theme consumers.\n /\nexport type { TypeId } from './typography';\n\n/* Storage keys for persisting user preferences. /\nexport const THEME_STORAGE_KEYS = {\n pattern: 'motir.theme.pattern',\n style: 'motir.theme.style',\n palette: 'motir.theme.palette',\n type: 'motir.theme.type',\n /\n The version marker of the STORED palette id's meaning. Absent (or anything\n * but {@link PALETTE_IDS_VERSION}) means the stored `palette` was written\n * before MOTIR-6471 swapped the palette identities, so it is read through\n * {@link PALETTE_ID_MIGRATION} once and the marker is then written.\n /\n paletteIds: 'motir.theme.paletteIds',\n} as const;\n\n/* The current meaning of a stored palette id — see `THEME_STORAGE_KEYS.paletteIds`. /\nexport const PALETTE_IDS_VERSION = '2';\n\n/\n What a palette id stored BEFORE MOTIR-6471 means today. The two palettes\n * swapped identities: the warm scheme called `motir` is now `amethyst`, and the\n * monochrome scheme called `graphite` is now `motir`. A value absent from this\n * map meant the same palette before and after. Applied ONCE per store — a\n * second pass would map a migrated `motir` on to `amethyst`, so it is keyed on\n * a version marker, never on the value.\n /\nexport const PALETTE_ID_MIGRATION: Readonly<Partial<Record<string, string>>> = {\n motir: 'amethyst',\n graphite: 'motir',\n};\n\n/\n Read a stored palette id through the rename. `marker` is the stored\n * `THEME_STORAGE_KEYS.paletteIds` value: at {@link PALETTE_IDS_VERSION} the\n * value is already current and is returned untouched; otherwise a value the\n * rename changed is mapped. `null` (nothing stored) stays `null`.\n /\nexport function migrateStoredPaletteId(value: string \| null, marker: string \| null): string \| null {\n if (value === null \|\| marker === PALETTE_IDS_VERSION) return value;\n // Own properties only — a stored `constructor` must not reach Object.prototype.\n if (!Object.prototype.hasOwnProperty.call(PALETTE_ID_MIGRATION, value)) return value;\n return PALETTE_ID_MIGRATION[value] ?? value;\n}\n\n/\n Sensible defaults if localStorage is empty. Note `type` is the GLOBAL fallback\n * only — when no explicit type is pinned, the active STYLE's `defaultTypeId`\n * wins (see `STYLE_DEFAULT_TYPE` / the theme context); this is the floor under\n * an unknown style.\n /\nexport const THEME_DEFAULTS = {\n pattern: 'system' as ThemePattern,\n style: DEFAULT_STYLE_ID as StyleId,\n palette: DEFAULT_PALETTE_ID as PaletteId,\n type: DEFAULT_TYPE_ID as TypeId,\n} as const;\n\n/\n Narrowing guard — is an arbitrary value a valid `pattern` axis id? The\n * colour / style / type axes each ship `isXId` in their registry file; the\n * pattern axis is a fixed three-value union, so its guard lives here next to\n * the type. Mirrors `isStyleId` / `isPaletteId` / `isTypeId`.\n /\nexport function isThemePattern(value: unknown): value is ThemePattern {\n return value === 'system' \|\| value === 'light' \|\| value === 'dark';\n}\n\n/\n Resolve a (possibly stale / unknown / null) value to a valid `pattern`,\n * falling back to `THEME_DEFAULTS.pattern`. The pattern-axis analogue of\n * `resolveStyle` / `resolvePalette` / `resolveType`.\n */\nexport function resolvePattern(value: unknown): ThemePattern {\n return isThemePattern(value) ? value : THEME_DEFAULTS.pattern;\n}\n"]}

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@motir/design-system",
-  "version": "0.5.1",
+  "version": "0.6.0",
   "description": "Motir's 3-axis design system (colour · style · type): distributable token CSS, the axis registries, the theme-apply API, and framework-agnostic React primitives. Shared by motir-core and planner-scaffolded products.",
   "license": "GPL-3.0-only",
   "repository": {

package/theme.css CHANGED Viewed

@@ -3305,7 +3305,7 @@
      --el-danger-on-surface is the ink for danger text ON a page: the palette's
      own danger hue pulled 30% toward that theme's body ink, which is the
      smallest move that clears AA everywhere. Raw --el-danger does NOT — it is
-     4.25:1 (base), 4.11:1 (cobalt) and 4.24:1 (graphite) on the DARK page, and
+     4.25:1 (base), 4.11:1 (cobalt) and 4.24:1 (motir, then graphite) on the DARK page, and
      under 4.5 on most tints in both themes.
      DERIVED rather than listed, deliberately: both inputs are tokens, so it
      re-skins with data-palette and a new palette is covered on the day it is
@@ -3375,7 +3375,7 @@
      palettes x both themes (tests/theme/statusHueSeparation.test.ts).
      ⚠️ It is NOT --color-accent, which `design/boards/implemented-column.mock.html`
      originally specified: that reads clean in the base palette and collides in
-     five of the ten (amber/candy/citrine/graphite/sienna, ΔE as low as 0.0). The
+     five of the ten (amber/candy/citrine/graphite — now motir — /sienna, ΔE as low as 0.0). The
      asset carries the correction and the measurement. */
   /* pink — BUILT, waiting on checks (MOTIR-3003). The one saturated Tier-0 hue
      no other STATUS spends; sharing a hue across FAMILIES is this file's own
@@ -3397,7 +3397,7 @@
      the four palettes that ride this base value (cobalt, evergreen, spectrum,
      garnet) re-skin it as before and each GAINS contrast; ΔE2000 to the nearest
      sibling stays >= 13.7 in all ten palettes x both themes (27.1 / 26.8 here).
-     Why the base and not a [data-palette='motir'] block: <html> carries no
+     Why the base and not a [data-palette='amethyst'] block: <html> carries no
      data-appearance-scope, so a root palette block would be a second cascade
      nobody renders — the base layer IS how the browser reaches these values. */
   --el-status-implemented: color-mix(in srgb, var(--color-accent) 75%, var(--color-charcoal));
@@ -3417,7 +3417,7 @@
      palette-tuned, so the nine palettes that ride this base value re-skin it as
      before and each keeps its own --color-success; ΔE2000 to the nearest
      sibling stays >= 11.3 in all ten palettes x both themes. Why the base and
-     not a [data-palette='motir'] block: same as --el-status-implemented above —
+     not a [data-palette='amethyst'] block: same as --el-status-implemented above —
      <html> carries no data-appearance-scope, so the base layer IS how the
      browser reaches these values. */
   /* A person's YES, and NOT yet shipped (MOTIR-5139). The `done` green one ink
@@ -3998,10 +3998,13 @@
    motion / type). That is the data-style axis's job; keeping the two disjoint
    is what makes "style × palette" a product of two independent choices.
-   v1 ships exactly one palette — `motir` (Yue, 2026-06-17: "use Motir's colour
-   palette for the v1"). It IS the Tier-3 base, so — exactly like the
-   `warm-editorial` base style — it needs NO override block: setting
-   data-palette="motir" simply leaves the base --el-* tokens in force. Each
+   v1 shipped exactly one palette, the warm one (Yue, 2026-06-17: "use Motir's
+   colour palette for the v1"), then called `motir` and since MOTIR-6471 called
+   `amethyst`. It IS the Tier-3 base, so — exactly like the `warm-editorial`
+   base style — it needs NO root override block: data-palette="amethyst" simply
+   leaves the base --el-* tokens in force. `motir` now names the monochrome
+   palette (formerly `graphite`), whose block is below; it is the default id,
+   and <html> always carries a data-palette, so the base is a fallback. Each
    later "Palette: …" subtask ADDS its `[data-palette='<id>']` block here,
    overriding --el-* (light + dark via [data-palette='<id>'][data-theme='dark']
    where the palette diverges from the base flip), and authors its
@@ -4009,21 +4012,22 @@
    [data-style] block on the other axis.
    ═══════════════════════════════════════════════════════════════════════ */
-/* `motir` needs no block — it is the Tier-3 base above. Each later palette
-   ADDS its [data-palette='<id>'] override here (light + dark companion). */
+/* `amethyst` needs no root block — it is the Tier-3 base above. Each other
+   palette ADDS its [data-palette='<id>'] override here (light + dark companion). */
-/* ── The `motir` BASE palette, re-asserted for a SCOPED subtree (MOTIR-3933) ──
-   `motir` is the Tier-0 default, so it historically had NO block: the base
-   values simply were the palette. That is correct for `<html>` and wrong for a
-   NESTED scope, which inherits its ancestor's palette and has nothing to
-   override it with — a `motir` preview under a `graphite` document rendered as
-   graphite. Every other palette re-asserts, so the base must too.
+/* ── The `amethyst` BASE palette, re-asserted for a SCOPED subtree (MOTIR-3933) ──
+   The warm palette is the Tier-0 default (it was called `motir` until
+   MOTIR-6471), so it historically had NO block: the base values simply were
+   the palette. That is correct for `<html>` and wrong for a NESTED scope, which
+   inherits its ancestor's palette and has nothing to override it with — a warm
+   preview under a monochrome document rendered as monochrome. Every other
+   palette re-asserts, so the base must too.
    ⚠️ SCOPED BY `[data-appearance-scope]`, DELIBERATELY. `<html>` never carries
    that attribute, so this block matches only a nested preview and the ROOT
    cascade is byte-identical to before. It also keeps the block from reading as
    a palette OVERRIDE: several `tests/theme/*` guards DERIVE "which palettes
-   override this token" from the stylesheet, and a bare `[data-palette='motir']`
+   override this token" from the stylesheet, and a bare `[data-palette='amethyst']`
    block silently enrolled the BASE palette in bars written for overrides. It is
    not an override — it is a scope reset — and the selector now says so.
@@ -4037,7 +4041,7 @@
    which is a file that has never existed, and the VALUE assertion it promised
    had never been written either — only the token-SET one had. Both are true
    now. A citation to a guard is worth exactly as much as the guard. */
-[data-appearance-scope][data-palette='motir'] {
+[data-appearance-scope][data-palette='amethyst'] {
   --color-accent: #ff64c8;
   --color-accent-green: #1aae39;
   --color-accent-orange: #dd5b00;
@@ -4097,8 +4101,8 @@
    overrides; the rest keep the light block's values above. Two selectors for
    the same reason every other palette now has two: the compound one for
    `<html>`, the descendant one for a nested scope. */
-[data-theme='dark'] [data-appearance-scope][data-palette='motir']:not([data-theme]),
-[data-appearance-scope][data-palette='motir'][data-theme='dark'] {
+[data-theme='dark'] [data-appearance-scope][data-palette='amethyst']:not([data-theme]),
+[data-appearance-scope][data-palette='amethyst'][data-theme='dark'] {
   --color-background: #0f0f0f;
   --color-border: #2a2a2a;
   --color-canvas: #0e0e0e;
@@ -4308,9 +4312,10 @@
   --el-priority-high: var(--color-warning);
 }
-/* ── Palette: Graphite (data-palette="graphite") — Subtask 7.3.51 ───────────
+/* ── Palette: Motir (data-palette="motir") — Subtask 7.3.51, renamed from
+   "Graphite" (the retired `graphite` id) and made the default in MOTIR-6471 ──
    A stark, editorial, COOL-NEUTRAL MONOCHROME re-skin — the cool foil to
-   Motir's warmth: true greyscale surfaces + ink on a clean Radix Slate scale,
+   Amethyst's warmth (the base): true greyscale surfaces + ink on a clean Radix Slate scale,
    a single restrained accent. The accent is expressed two ways, exactly as
    Vercel / Linear do it: the primary CTA is a high-contrast INK fill (near-black
    on light, near-white on dark — the monochrome statement), while the one
@@ -4337,8 +4342,8 @@
    Accessibility: every text-on-surface, white-on-fill, link, and chip-tint
    pairing clears WCAG AA (≥4.5; ≥3.0 for icon/UI hues) in BOTH light and dark —
    verified numerically + by rendered specimen, never eyeballed. See
-   docs/palettes/graphite.md for the colour-role reference. */
-[data-palette='graphite'] {
+   docs/palettes/motir.md for the colour-role reference. */
+[data-palette='motir'] {
   /* brand & primary — the high-contrast INK CTA + the single cool-blue accent.
      --color-primary is the accent AS text/icon/focus on a surface (the cool
      blue, AA on white & the slate surface); --color-primary-fill is the CTA
@@ -4346,7 +4351,7 @@
   --color-primary: #155bc4; /* cool-blue accent — links / active / focus / icon */
   --color-primary-foreground: #ffffff; /* white labels on the ink fill */
   --color-primary-pressed: #2b2f35; /* pressed ink CTA (one step off the fill) */
-  --color-primary-fill: #1a1d21; /* near-black graphite CTA fill (white-on AA) */
+  --color-primary-fill: #1a1d21; /* near-black ink CTA fill (white-on AA) */
   /* surfaces — pure white canvas over cool slate sections (Radix Slate) */
   --color-background: #ffffff; /* stark white canvas */
@@ -4404,7 +4409,7 @@
   /* Status ramp — the one place the mono identity COLLIDES with the Tier-0
      indirection (MOTIR-2073). `--el-status-in-progress` rides --color-info and
      `--el-status-in-review` rides --color-primary; every other palette keeps
-     those two sources apart, but Graphite deliberately unifies them (info =
+     those two sources apart, but Motir (then Graphite) deliberately unifies them (info =
      the accent, above), which re-collapsed in_review onto in_progress — the
      exact differentiation MOTIR-1273 delivered. The fix keeps BOTH deliberate
      choices by giving the status ramp its own SECOND STEP of the same accent
@@ -4418,7 +4423,7 @@
   /* Priority ramp — highest vs high (MOTIR-2094, the MOTIR-2085 shape in a
      second palette). `--el-priority-highest` rides --color-destructive
      (#c92a2a) and `--el-priority-high` rides --color-warning (#c2410c);
-     Graphite's warning is a RED-leaning burnt orange sitting beside its danger
+     this palette's warning is a RED-leaning burnt orange sitting beside its danger
      red, so the two land ΔE2000 10.02 apart. That PASSES the ΔE 10 bar a
      coloured priority GLYPH needs — by 0.02, which is rounding, not margin: the
      two marks are at the perceptual minimum, and any future nudge to either
@@ -4426,24 +4431,24 @@
      identity (the chrome is greyscale; semantic hues stay chromatic on purpose),
      so it is a collision to fix, not a choice to document.
      The fix is Cobalt's: neither semantic moves — danger stays danger, warning
-     stays warning — and the PRIORITY ramp takes its own step of a hue Graphite
+     stays warning — and the PRIORITY ramp takes its own step of a hue this palette
      already owns, Radix Amber 11, one of this palette's documented Radix
      sources. Separation from highest ΔE 24.7 (nearest other step, medium, ΔE
      32.2); contrast 4.6:1 card / 4.0:1 surface, past the 3:1 icon/UI bar. */
   --el-priority-high: #ab6400; /* Radix Amber 11 — the ramp's own amber step */
-  /* implemented (MOTIR-3003) — Graphite's --color-accent is its blue accent, a
+  /* implemented (MOTIR-3003) — this palette's --color-accent is its blue accent, a
      step from the same family as --el-status-in-progress. The ink step is free
      here and reads as "not yet coloured in", which is what the state is:
      ΔE 15.9 light / 11.8 dark from the nearest status. */
   --el-status-implemented: var(--color-charcoal);
 }
-/* Graphite — dark companion. A cool near-black slate canvas; the CTA fill
+/* Motir (formerly Graphite) — dark companion. A cool near-black slate canvas; the CTA fill
    inverts to near-WHITE ink (Vercel's dark white-button), the accent blue
    brightens so it reads AS text on the dark canvas, and semantic/type hues
    brighten to clear AA on near-black. */
-[data-theme='dark'] [data-palette='graphite']:not([data-theme]),
-[data-palette='graphite'][data-theme='dark'] {
+[data-theme='dark'] [data-palette='motir']:not([data-theme]),
+[data-palette='motir'][data-theme='dark'] {
   --color-background: #0c0d0f; /* stark cool near-black canvas */
   --color-foreground: #edeef0;
   --color-surface: #18191c; /* cool slate section */
@@ -4679,7 +4684,7 @@
   /* Status ramp (MOTIR-2075) — two collisions in this theme.
      in_review vs done: emerald #3ddc97 against grass #34d27a, ΔE2000 4.7. Same
      fix as light, inverted: Radix Jade 12's DARK step, pale rather than deep —
-     the light/dark inversion Graphite's accent step already uses. ΔE 17.2;
+     the light/dark inversion this palette's accent step already uses. ΔE 17.2;
      contrast 13.3:1 surface / 14.5:1 card.
      todo vs cancelled: --color-stone #5a6b62 against --color-steel #6f8077,
      ΔE 8.3 — this palette's neutral ramp is compressed against the base's
@@ -4921,7 +4926,7 @@
   --el-sidebar-item-bg-hover: #261f3d;
   /* Priority ramp — the dark half of the light block's amber step (MOTIR-2107).
-     UNLIKE cobalt and graphite (whose dark hues were already far enough apart to
+     UNLIKE cobalt and motir (whose dark hues were already far enough apart to
      re-assert the source here), Spectrum's dark destructive #f0555f and warning
      #fb8b4c render a chip only ΔE 4.8 apart, so dark carries its own amber too:
      the brighter #fbab4c the other dark palettes already use, which reads as an
@@ -5471,7 +5476,7 @@
      Miro's OTHER brand hue at its own depth — the action blue, blue-650 — which
      leaves blocked on the warning gold where its semantics belong. Note
      in_progress rides blue-500 #3859ff: same family, two depths, ΔE 17.0 apart,
-     the Graphite idiom. Contrast 9.2:1 surface / 10.2:1 card.
+     the Motir (ex-Graphite) idiom. Contrast 9.2:1 surface / 10.2:1 card.
      todo vs cancelled: gray-450 #7f8497 vs gray-500 #656b81, ΔE 10.0 — one step
      apart on Mirotone's gray ramp. cancelled drops to gray-600. ΔE 20.6;
      contrast 7.5:1 / 8.3:1. */