@motir/design-system 0.8.1 → 0.8.2

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.
@@ -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 * ── 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"]}
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 restrained cool-blue accent and a few warm touches.',\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
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@motir/design-system",
3
- "version": "0.8.1",
3
+ "version": "0.8.2",
4
4
  "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.",
5
5
  "license": "GPL-3.0-only",
6
6
  "repository": {
package/theme.css CHANGED
@@ -3274,6 +3274,16 @@
3274
3274
  --el-accent-on-surface: var(--color-primary);
3275
3275
  --el-accent-pressed: var(--color-primary-pressed);
3276
3276
  --el-highlight: var(--color-accent); /* brand pink — decorative accents */
3277
+ /* Progress FILL for a determinate bar (MOTIR-7584) — upload / import bars.
3278
+ Resolves to the CTA fill, which is what those bars painted before the role
3279
+ existed, so every palette that does not override it is pixel-identical.
3280
+ (The planning node's done/total meter is NOT this role: it means DONE and
3281
+ stays --el-success.) */
3282
+ --el-progress-fill: var(--color-primary-fill);
3283
+ /* The rich-text editor's FOCUS indicator (MOTIR-7584). Resolves to the
3284
+ decorative accent the editor borrowed before the role existed; a palette
3285
+ whose accent is decorative-only (motir) points it back at its focus hue. */
3286
+ --el-editor-focus: var(--color-accent);
3277
3287
 
3278
3288
  /* ── Surfaces ──────────────────────────────────────────────────── */
3279
3289
  --el-surface: var(--color-surface);
@@ -4079,7 +4089,12 @@
4079
4089
  --color-tint-sky: #dcecfa;
4080
4090
  --color-tint-yellow: #fef7d6;
4081
4091
  --color-warning: #dd5b00;
4092
+ /* MOTIR-7584 — carried for the same reason as --el-status-approved below:
4093
+ `motir` overrides all three, so a scoped amethyst tile under a motir page
4094
+ would otherwise inherit motir's warm values. */
4095
+ --el-editor-focus: var(--color-accent);
4082
4096
  --el-priority-high: var(--color-warning);
4097
+ --el-progress-fill: var(--color-primary-fill);
4083
4098
  --el-sidebar-item-bg-hover: #eeede9;
4084
4099
  /* MOTIR-5139 — carried here because `evergreen` OVERRIDES it. A token this
4085
4100
  block omits leaks from the ANCESTOR into a scoped `motir` tile, so an
@@ -4095,6 +4110,7 @@
4095
4110
  --el-status-implemented: color-mix(in srgb, var(--color-accent) 75%, var(--color-charcoal));
4096
4111
  --el-status-in-review: var(--color-primary);
4097
4112
  --el-status-planning: var(--color-accent-teal);
4113
+ --el-type-design: var(--color-accent);
4098
4114
  }
4099
4115
 
4100
4116
  /* The base palette's DARK arm — only the tokens the global dark block
@@ -4376,19 +4392,24 @@
4376
4392
  --color-border: #e2e4e9;
4377
4393
 
4378
4394
  /* accent secondary — the cool-blue highlight replaces the warm brand pink */
4379
- --color-accent: #2563c9; /* cool-blue decorative highlight / epic & design hue */
4395
+ /* WARM TOUCH (MOTIR-7582 / design MOTIR-7583 §8): the decorative accent —
4396
+ highlight, Epic, chart segment 6, the progress fill — is a warm orange.
4397
+ It sits in the narrow slot between the burnt-orange warning #c2410c and the
4398
+ amber priority-high step #ab6400: ΔE2000 11.0 from each, and 3.08:1 or
4399
+ better on every light surface (the selected row is the tightest). */
4400
+ --color-accent: #d66000; /* warm orange — decorative highlight / epic hue */
4380
4401
  --color-accent-orange: #c2410c; /* review hue / warning — cooled */
4381
4402
  --color-accent-teal: #0e8f86; /* subtask / content hue */
4382
4403
  --color-accent-green: #18804a; /* story hue / success — cooled */
4383
4404
 
4384
4405
  /* card tints — cooled pastel washes (6 distinct feature hues; charcoal text
4385
4406
  on them clears AA in both themes) */
4386
- --color-tint-peach: #f7e6d6;
4407
+ --color-tint-peach: #fde0c8; /* warmed (MOTIR-7582) — ink on it 12.38:1 */
4387
4408
  --color-tint-rose: #f6dfe8;
4388
4409
  --color-tint-mint: #d9efe1;
4389
4410
  --color-tint-lavender: #e4e6f3; /* cool indigo wash */
4390
4411
  --color-tint-sky: #dde9f6; /* cool blue wash — the accent tint */
4391
- --color-tint-yellow: #f6f1d6;
4412
+ --color-tint-yellow: #fdf0c6; /* warmed (MOTIR-7582) — ink on it 13.70:1 */
4392
4413
 
4393
4414
  /* semantic */
4394
4415
  --color-success: #18804a;
@@ -4441,6 +4462,19 @@
4441
4462
  here and reads as "not yet coloured in", which is what the state is:
4442
4463
  ΔE 15.9 light / 11.8 dark from the nearest status. */
4443
4464
  --el-status-implemented: var(--color-charcoal);
4465
+
4466
+ /* Warm touches (MOTIR-7582 / design MOTIR-7583 §8) — the Tier-3 half.
4467
+ Design takes the Citrine palette's own gold, its --color-primary #746019
4468
+ (Mirotone yellow-700), so it reads apart from the orange Epic: ΔE2000 16.3
4469
+ from its nearest glyph neighbour (priority-high) and 4.97:1 or better on
4470
+ every light surface. Set directly, as --el-sidebar-item-bg-hover is, since
4471
+ no Tier-0 source carries it. */
4472
+ --el-type-design: #746019;
4473
+ /* progress bars take the warm accent instead of the ink CTA fill */
4474
+ --el-progress-fill: var(--color-accent);
4475
+ /* the editor's focus border / rings stay the blue focus hue — the accent they
4476
+ borrowed is decorative-only here now */
4477
+ --el-editor-focus: var(--color-primary);
4444
4478
  }
4445
4479
 
4446
4480
  /* Motir (formerly Graphite) — dark companion. A cool near-black slate canvas; the CTA fill
@@ -4476,14 +4510,16 @@
4476
4510
  --color-primary-fill: #edeef0; /* near-white ink CTA fill (black-on AA) */
4477
4511
 
4478
4512
  /* cooled tints, dimmed for the near-black canvas */
4479
- --color-tint-peach: #2e2418;
4513
+ --color-tint-peach: #36230f; /* warmed (MOTIR-7582) — ink on it 10.58:1 */
4480
4514
  --color-tint-rose: #2f1c26;
4481
4515
  --color-tint-mint: #15271e;
4482
4516
  --color-tint-lavender: #1f2236;
4483
4517
  --color-tint-sky: #15233a;
4484
- --color-tint-yellow: #2a2716;
4518
+ --color-tint-yellow: #302a12; /* warmed (MOTIR-7582) — ink on it 10.14:1 */
4485
4519
 
4486
- --color-accent: #5b9dff; /* bright cool-blue highlight on dark */
4520
+ /* warm touch — a deeper, redder orange than the dark warning #f08a4b clears
4521
+ it by ΔE2000 11.5, and is 4.77:1 or better on every dark surface */
4522
+ --color-accent: #fa5500; /* warm orange highlight on dark */
4487
4523
  --color-accent-orange: #f08a4b;
4488
4524
  --color-accent-teal: #2db6a8;
4489
4525
  --color-accent-green: #34b86e;
@@ -4519,6 +4555,14 @@
4519
4555
  themes so the light value cannot cascade into dark (the cascade trap this
4520
4556
  suite checks for). */
4521
4557
  --el-status-implemented: var(--color-charcoal);
4558
+
4559
+ /* Warm touches — the dark halves of the light block's Tier-3 overrides, in
4560
+ BOTH themes for the cascade reason above. Design takes the Citrine
4561
+ palette's dark --color-primary, Miro Sunglow #ffd02f: ΔE2000 27.5 from its
4562
+ nearest glyph neighbour, 10.0:1 or better on every dark surface. */
4563
+ --el-type-design: #ffd02f;
4564
+ --el-progress-fill: var(--color-accent);
4565
+ --el-editor-focus: var(--color-primary);
4522
4566
  }
4523
4567
 
4524
4568
  /* ── Palette: Evergreen (data-palette="evergreen") — Subtask 7.3.50 ──────────