@motir/design-system 0.1.0

package/dist/theme/appearance-resolution.js

@@ -0,0 +1,379 @@
+// src/theme/typography.ts
+var TYPE_REGISTRY = {
+  motir: {
+    id: "motir",
+    name: "Motir",
+    tagline: "Editorial serif headlines over a clean sans body \u2014 the house pairing.",
+    faces: "Source Serif 4 headlines \xB7 Inter body \xB7 JetBrains Mono meta.",
+    designDoc: "docs/typography/motir.md"
+  },
+  "motir-sans": {
+    id: "motir-sans",
+    name: "Motir Sans",
+    tagline: "All-sans \u2014 Inter for headlines and body; structural, no serif.",
+    faces: "Inter headlines + body \xB7 JetBrains Mono meta.",
+    designDoc: "docs/typography/motir-sans.md"
+  },
+  "motir-mono": {
+    id: "motir-mono",
+    name: "Motir Mono",
+    tagline: "Monospace throughout \u2014 a code-native UI, headlines, body and all.",
+    faces: "JetBrains Mono headlines + body/UI + meta.",
+    designDoc: "docs/typography/motir-mono.md"
+  },
+  grotesk: {
+    id: "grotesk",
+    name: "Grotesk",
+    tagline: "Geometric neo-grotesque across the whole UI \u2014 tight, confident, product-y.",
+    faces: "Space Grotesk headlines + body/UI \xB7 JetBrains Mono meta.",
+    designDoc: "docs/typography/grotesk.md"
+  },
+  editorial: {
+    id: "editorial",
+    name: "Editorial",
+    tagline: "A characterful display serif over a humanist sans \u2014 magazine, considered.",
+    faces: "Fraunces display headlines \xB7 Inter body \xB7 JetBrains Mono meta.",
+    designDoc: "docs/typography/editorial.md"
+  },
+  "mono-technical": {
+    id: "mono-technical",
+    name: "Mono-Technical",
+    tagline: "IBM Plex Mono throughout \u2014 a precise, developer-grade UI.",
+    faces: "IBM Plex Mono headlines + body/UI + meta/code.",
+    designDoc: "docs/typography/mono-technical.md"
+  }
+};
+var DEFAULT_TYPE_ID = "motir";
+function isTypeId(value) {
+  return typeof value === "string" && Object.prototype.hasOwnProperty.call(TYPE_REGISTRY, value);
+}
+
+// src/theme/styles.ts
+var STYLE_REGISTRY = {
+  "warm-editorial": {
+    id: "warm-editorial",
+    name: "Warm Editorial",
+    tagline: "Thoughtful, warm, technical-but-not-cold, slightly editorial.",
+    inspiration: "Notion's warm palette + Source Serif headlines over Inter body.",
+    designDoc: "docs/styles/warm-editorial.md",
+    defaultTypeId: "motir",
+    dimensions: {
+      silhouette: "Sober rectangles \u2014 8px buttons, 12px cards. Restrained, document-like.",
+      stroke: "Hairline borders (1px warm-grey); structure drawn quietly, never heavy.",
+      elevation: "Modest, low-spread shadows; surfaces sit close to the page.",
+      surface: "Opaque cream surfaces over a white canvas; pastel tints for feature cards only.",
+      density: "Comfortable default rhythm \u2014 18\xD710 button padding, 24px card padding.",
+      motion: "Brisk 150ms ease; understated, gets out of the way.",
+      typography: "Source Serif 4 editorial headlines + Inter body + JetBrains Mono meta.",
+      components: "Rectangular buttons/inputs, hairline-bordered cards, badge pills for status only."
+    }
+  },
+  "soft-playful": {
+    id: "soft-playful",
+    name: "Soft / Playful",
+    tagline: "More energy \u2014 rounded, generous, gently animated.",
+    inspiration: "Figma's pill-shape language (50px pills, roomy spacing).",
+    designDoc: "docs/styles/soft-playful.md",
+    defaultTypeId: "motir",
+    dimensions: {
+      silhouette: "Pill buttons (fully rounded) and large 24px card/input radii. Friendly, bubbly.",
+      stroke: "Same hairline borders as the base; identity comes from radius, not stroke weight.",
+      elevation: "Softer, more diffused shadows \u2014 surfaces float a touch more.",
+      surface: "Opaque, like the base \u2014 colour stays the palette axis; only the shape softens.",
+      density: "Roomier \u2014 20\xD712 button padding, 28px card padding, taller controls.",
+      motion: "Gentler 200ms ease and a slightly deeper press scale for a springy feel.",
+      typography: "Inherits the base type pairing; the personality is in shape, not type.",
+      components: "Pill buttons, heavily-rounded inputs/cards/modals, rounder small affordances."
+    }
+  },
+  "swiss-minimal-flat": {
+    id: "swiss-minimal-flat",
+    name: "Swiss / Minimal-Flat",
+    tagline: "International-typographic, structural, calm \u2014 flat, sharp, gridded.",
+    inspiration: "Swiss International Typographic Style \u2014 M\xFCller-Brockmann grids, flat surfaces.",
+    designDoc: "docs/styles/swiss-minimal-flat.md",
+    defaultTypeId: "motir-sans",
+    dimensions: {
+      silhouette: "Sharp near-square corners (2px) on every surface \u2014 hard right angles, structural.",
+      stroke: "Hairline borders do ALL the structural work; with elevation removed, the 1px rule is the only divider.",
+      elevation: "Flat \u2014 every shadow is removed (none). Depth comes from borders + whitespace, not lift.",
+      surface: "Opaque, untinted panels delineated by hairline rules; no floating, no glass, no wash.",
+      density: "Tight, gridded controls (crisp 16\xD79 buttons, 34px control height) with generous 28px card whitespace.",
+      motion: "Minimal \u2014 fast 100ms transitions and NO press-scale (calm, mechanical, never springy).",
+      typography: "Restrained neo-grotesque sans throughout \u2014 headlines drop the editorial serif for Inter, tight and strong.",
+      components: "Square buttons/inputs/cards/modals, rectangular (non-pill) status chips, flat hairline-ruled surfaces."
+    }
+  },
+  "neo-brutalism": {
+    id: "neo-brutalism",
+    name: "Neo-Brutalism",
+    tagline: "Raw, punchy, utilitarian \u2014 0px corners, thick borders, hard-offset shadows.",
+    inspiration: "Neo-brutalist web design \u2014 Gumroad / Figma-community brutalism: blocky, unpolished, loud.",
+    designDoc: "docs/styles/neo-brutalism.md",
+    defaultTypeId: "motir-mono",
+    dimensions: {
+      silhouette: "Zero radius \u2014 hard 0px corners on EVERY surface (buttons, cards, inputs, modals, status chips). Blocky and uncompromising.",
+      stroke: "Heavy solid 2px outlines do the structural work \u2014 borders are LOUD, not hairline (the defining neo-brutalist move, applied via a style-scoped component-variant block).",
+      elevation: "Hard-offset drop shadows with ZERO blur (e.g. 4px 4px 0 0) \u2014 a solid block of shadow, never a soft lift; the chunky frame, not diffusion.",
+      surface: "Opaque, flat, untinted panels framed by the thick border + the hard shadow; no glass, no wash, no gradient.",
+      density: "Tight, utilitarian controls (16\xD710 buttons, 36px control height) with compact 20px card padding \u2014 no wasted space.",
+      motion: "Snappy and mechanical \u2014 near-instant 60ms transitions and NO press-scale; the UI reacts, it does not animate.",
+      typography: "Raw monospace headlines \u2014 the editorial serif is re-pointed at the JetBrains Mono stack, against the Inter grotesk body.",
+      components: "Square buttons/inputs/cards/modals, rectangular (non-pill) status chips, thick-bordered surfaces with hard-offset shadows."
+    }
+  },
+  glassmorphism: {
+    id: "glassmorphism",
+    name: "Glassmorphism",
+    tagline: "Translucent frosted glass floating over a soft, vibrant gradient.",
+    inspiration: "Apple's visionOS / macOS Big Sur 'frosted glass' material \u2014 backdrop-blur over depth.",
+    designDoc: "docs/styles/glassmorphism.md",
+    defaultTypeId: "motir",
+    dimensions: {
+      silhouette: "Soft, rounded glass tiles \u2014 12px buttons/inputs, 18px cards, 22px modals. Friendly, never sharp.",
+      stroke: "Light 1px hairlines at reduced opacity \u2014 a glass edge catching light, not a structural rule.",
+      elevation: "Layered, diffuse, low-opacity shadows \u2014 panels float as hovering frosted sheets above the canvas.",
+      surface: "The identity axis: translucent frosted panels (backdrop-blur) over a soft palette-derived gradient canvas \u2014 material, not opaque.",
+      density: "Comfortable, a touch roomy \u2014 20\xD711 buttons, 26px card padding, 38px controls; glass tiles want air.",
+      motion: "Gentle, smooth \u2014 220ms ease and a light press-scale; glass slides into place, it never snaps.",
+      typography: "Inherits the base editorial type pairing; the personality is in the material, not the type.",
+      components: "Rounded frosted cards / popovers / modals / sidebar / inputs (the data-surface material layer), pill status chips."
+    }
+  },
+  "cybercore-y2k": {
+    id: "cybercore-y2k",
+    name: "Cybercore / Y2K",
+    tagline: "Neon-on-dark retro-tech \u2014 glowing HUD panels, a tech grid, mono headlines.",
+    inspiration: "Y2K / cyberpunk HUDs \u2014 neon-on-dark terminals, Tron grids, glowing edges, monospace displays.",
+    designDoc: "docs/styles/cybercore-y2k.md",
+    defaultTypeId: "motir-mono",
+    dimensions: {
+      silhouette: "Hard terminal-frame corners (sharp 2\u20134px) \u2014 chiseled HUD panels, not soft cards.",
+      stroke: "Structure drawn by a lit edge \u2014 a 1px glow-ring (currentColor halo) on every surface, not a heavier border.",
+      elevation: "Neon GLOW instead of drop-shadow \u2014 surfaces emit an outward currentColor halo, lit rather than lifted.",
+      surface: "A faint tech grid (scanline/grid texture) washes the canvas behind opaque HUD panels.",
+      density: "Tight, technical HUD rhythm \u2014 compact controls (18\xD79 buttons, 34px control height) over snug 20px card padding.",
+      motion: "Snappy and electric \u2014 very fast 90ms transitions with a crisp press-scale.",
+      typography: "Mono/display headlines \u2014 the serif headline face is swapped to JetBrains Mono for a terminal read; body stays sans.",
+      components: "Sharp glow-ringed panels, mono headings, rectangular chips; the lit edge replaces the drop shadow everywhere."
+    }
+  },
+  aurora: {
+    id: "aurora",
+    name: "Aurora",
+    tagline: "Soft, drifting aurora light behind fluid, gently-glowing surfaces.",
+    inspiration: 'The northern lights \u2014 slow ribbons of colour over a night sky \u2014 and the soft animated-gradient "aurora" hero look (Stripe / Vercel ambient gradients).',
+    designDoc: "docs/styles/aurora.md",
+    defaultTypeId: "motir",
+    dimensions: {
+      silhouette: "Fluid, soft corners \u2014 14px buttons/inputs, 20px cards, 26px modals. Organic and rounded, a touch softer than glass.",
+      stroke: "Quiet 1px hairlines; structure is implied by the gentle glow and elevation, never drawn by a heavy rule.",
+      elevation: "A soft neutral lift PLUS a gentle palette-derived COLOUR glow halo \u2014 surfaces feel lit from within, never hard-edged.",
+      surface: "The identity axis: opaque fluid surfaces floating over a slowly-DRIFTING, animated aurora gradient canvas (palette-derived ribbons).",
+      density: "Comfortable and roomy \u2014 20\xD711 buttons, 26px card padding, 38px controls; the light wants space to breathe.",
+      motion: "Smooth and slow \u2014 260ms eased transitions, a faint press-scale, and a 28s ambient drift of the aurora canvas (stilled under prefers-reduced-motion).",
+      typography: "Inherits the base editorial pairing (Source Serif headlines + Inter body); the personality is in the moving light, not the type.",
+      components: "Fluid, gently-glowing cards / popovers / modals / sidebar (the data-surface material layer); pill status chips."
+    }
+  },
+  "3d-immersive": {
+    id: "3d-immersive",
+    name: "3D / Immersive",
+    tagline: "Depth and perspective \u2014 dimensional cards floating over the page.",
+    inspiration: "Spatial / depth UI \u2014 visionOS spatial layers, Stripe-era layered cards, soft real-world light.",
+    designDoc: "docs/styles/3d-immersive.md",
+    defaultTypeId: "motir",
+    dimensions: {
+      silhouette: "Generously rounded dimensional tiles \u2014 14px buttons/inputs, 20px cards, 28px modals. Soft, tactile, never sharp.",
+      stroke: "Borders nearly vanish (a faint hairline) \u2014 structure is read from depth + shadow, not an outline.",
+      elevation: "The identity axis: deep multi-layer shadows float every surface off the canvas, and on tilt a card becomes a TRUE 3D object \u2014 perspective + preserve-3d + per-slot translateZ planes (header pops forward, footer behind) parallax under a cursor-tracked glare. Not a flat-plane tilt.",
+      surface: "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 \u2014 depth (not tint or glass) is the material; nothing sits flat.",
+      density: "Roomy and immersive \u2014 22\xD712 buttons, 28px card padding, 40px controls; depth wants air around each tile.",
+      motion: 'The standard "3D card" pointer-parallax \u2014 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.',
+      typography: "Inherits the base editorial type pairing; the personality is in depth + light, not the type.",
+      components: "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."
+    }
+  },
+  neumorphism: {
+    id: "neumorphism",
+    name: "Neumorphism",
+    tagline: "Soft extruded surfaces that swell out of a single monochrome field.",
+    inspiration: 'Neumorphism / soft-UI \u2014 Dribbble-era "soft shadow" interfaces where panels are pressed OUT of (or INTO) one continuous surface by a paired light + dark shadow.',
+    designDoc: "docs/styles/neumorphism.md",
+    defaultTypeId: "motir",
+    dimensions: {
+      silhouette: "Soft, generously rounded pebbles \u2014 12px buttons/inputs, 18px cards, 22px modals. Tactile and friendly, the rounding that lets a shadow wrap a surface.",
+      stroke: "Borders nearly vanish \u2014 a faint hairline kept ONLY as the accessibility fallback (see below); structure is read from the paired soft shadow, not an outline.",
+      elevation: "The identity axis: a DUAL soft shadow \u2014 a light highlight top-left + a palette-derived dark shadow bottom-right \u2014 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.",
+      surface: '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 \u2014 the soft-UI "single material" look. Opaque (text AA preserved), with the depth carried entirely by the shadows.',
+      density: "Comfortable and roomy \u2014 20\xD711 buttons, 26px card padding, 38px controls; the soft shadows need air around each surface to read as extruded.",
+      motion: "Gentle \u2014 200ms ease and a soft press-scale; nothing snaps, matching the moulded surfaces (form fields rest as concave inset wells, panels swell out raised).",
+      typography: "Inherits the base editorial type pairing; the personality is in the moulded surfaces, not the type.",
+      components: "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."
+    }
+  },
+  "hand-drawn-indie": {
+    id: "hand-drawn-indie",
+    name: "Hand-Drawn / Indie",
+    tagline: "Sketchy and friendly \u2014 rough hand-inked edges, wonky corners, soft offset shadows, a playful bounce.",
+    inspiration: "Indie / zine + hand-drawn web design \u2014 Excalidraw\u2019s rough hand-sketched strokes and doodled notebook UIs: warm, imperfect, human.",
+    designDoc: "docs/styles/hand-drawn-indie.md",
+    defaultTypeId: "editorial",
+    dimensions: {
+      silhouette: "Wonky hand-drawn corners \u2014 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.",
+      stroke: "Genuinely ROUGH, wavy ink edges \u2014 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.",
+      elevation: "Soft, hand-placed offset shadows \u2014 a gentle blurred drop nudged down-right (a doodled shadow), friendly and low; never a hard brutalist block nor a flat removal.",
+      surface: "Opaque, warm, paper-like panels \u2014 colour stays the palette axis; the personality is in the rough wavy outline + the soft shadow, not a tint or a wash.",
+      density: "Roomy and relaxed \u2014 generous 20\xD712 buttons, 26px card padding, taller 38px controls; the hand-drawn feel wants air, like margins round a sketch.",
+      motion: "Springy and playful \u2014 gentle 200ms transitions with a bouncy hover lift (1.02) and a deeper press squish (0.97); the UI has a friendly wobble.",
+      typography: "Ships the Editorial pairing (Fraunces display headlines + Inter body) \u2014 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.",
+      components: "Wonky-cornered buttons/inputs/cards/modals, irregular (non-pill) status chips, rough wavy-ink-bordered surfaces with soft hand-placed shadows."
+    }
+  },
+  retrofuturism: {
+    id: "retrofuturism",
+    name: "Retrofuturism",
+    tagline: "Chrome, gradient sweeps and a synthwave horizon \u2014 70s/80s sci-fi.",
+    inspiration: "Retrofuturism / Outrun \u2014 70s\u201380s sci-fi: chrome lettering, synthwave sunset gradients, airbrushed sci-fi paperbacks, and wide geometric display type.",
+    designDoc: "docs/styles/retrofuturism.md",
+    defaultTypeId: "grotesk",
+    dimensions: {
+      silhouette: "Streamlined chrome capsules \u2014 fully-rounded pill buttons + chips, 16px cards, 22px modals. Aerodynamic 70s/80s curves, never sharp.",
+      stroke: "A lit chrome edge \u2014 a bright inset highlight + a dark base line over a faint hairline, reading as a polished metal rim rather than a drawn border.",
+      elevation: "Chrome bevels + a diagonal SPECULAR streak + a palette-derived glow \u2014 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.",
+      surface: "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 \u2014 the neon horizon + grid read strongest on a dark palette.",
+      density: "Confident and roomy \u2014 22\xD711 chrome-capsule buttons, 24px card padding, 38px controls; the chrome wants room to catch the light.",
+      motion: "Smooth and gliding \u2014 200ms eased transitions and a confident press-scale; the synthwave horizon + grid are a STATIC backdrop (no motion to distract the work surface).",
+      typography: "Wide geometric grotesque display (the `grotesk` type pairing) \u2014 the retro-futurist sci-fi headline read; body stays a legible sans.",
+      components: "Chrome-capsule buttons with a metallic glint, specular-streaked bevelled cards / popovers / modals / sidebar / inputs (the data-surface material layer), pill status chips \u2014 a synthwave horizon + neon grid behind it all."
+    }
+  }
+};
+var STYLE_IDS = Object.keys(STYLE_REGISTRY);
+var DEFAULT_STYLE_ID = "warm-editorial";
+function isStyleId(value) {
+  return typeof value === "string" && Object.prototype.hasOwnProperty.call(STYLE_REGISTRY, value);
+}
+function resolveStyle(value) {
+  return STYLE_REGISTRY[isStyleId(value) ? value : DEFAULT_STYLE_ID];
+}
+Object.fromEntries(
+  STYLE_IDS.map((id) => [id, STYLE_REGISTRY[id].defaultTypeId])
+);
+function defaultTypeForStyle(styleValue) {
+  return isStyleId(styleValue) ? STYLE_REGISTRY[styleValue].defaultTypeId : DEFAULT_TYPE_ID;
+}
+
+// src/theme/palettes.ts
+var PALETTE_REGISTRY = {
+  motir: {
+    id: "motir",
+    name: "Motir",
+    tagline: "Warm and editorial \u2014 cream surfaces, charcoal ink, a purple primary, pastel tints.",
+    inspiration: "Notion's warm marketing palette \u2014 the product's house colours.",
+    designDoc: "docs/palettes/motir.md"
+  },
+  cobalt: {
+    id: "cobalt",
+    name: "Cobalt",
+    tagline: "Cool and institutional \u2014 slate-cool surfaces, a confident cobalt primary, cooled tints.",
+    inspiration: "Coinbase's clean institutional blue + IBM's structured blue, on Radix Blue/Indigo/Slate scales.",
+    designDoc: "docs/palettes/cobalt.md"
+  },
+  graphite: {
+    id: "graphite",
+    name: "Graphite",
+    tagline: "Stark and editorial \u2014 cool greyscale surfaces + ink, an ink CTA, a single restrained cool-blue accent.",
+    inspiration: "Vercel's black-and-white precision + Linear's ultra-minimal, on Radix Slate/Blue scales.",
+    designDoc: "docs/palettes/graphite.md"
+  },
+  evergreen: {
+    id: "evergreen",
+    name: "Evergreen",
+    tagline: "Fresh and technical \u2014 an emerald primary over cooled forest neutrals, a green-leaning UI.",
+    inspiration: "getdesign.md \u2014 Supabase (dark emerald) / Spotify (vibrant green) / MongoDB (spring green), on Radix green/jade ramps.",
+    designDoc: "docs/palettes/evergreen.md"
+  },
+  spectrum: {
+    id: "spectrum",
+    name: "Spectrum",
+    tagline: "Vibrant and playful \u2014 crisp cool surfaces, a bright violet primary, a candy-bright multi-hue accent & tint set.",
+    inspiration: "Figma's vibrant multi-colour brand + Airtable's colourful, friendly palette, on Radix Violet/Iris/Pink/Blue scales.",
+    designDoc: "docs/palettes/spectrum.md"
+  },
+  amber: {
+    id: "amber",
+    name: "Amber",
+    tagline: "Warm and electric \u2014 Binance trading-floor gold over the exchange\u2019s graphite near-blacks; dark labels on the gold.",
+    inspiration: "Binance \u2014 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.",
+    designDoc: "docs/palettes/amber.md"
+  },
+  sienna: {
+    id: "sienna",
+    name: "Sienna",
+    tagline: "Warm and vivid \u2014 Mistral flame-orange over the Mediterranean warm-cream surfaces; dark labels on the flame.",
+    inspiration: "Mistral AI \u2014 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.",
+    designDoc: "docs/palettes/sienna.md"
+  },
+  garnet: {
+    id: "garnet",
+    name: "Garnet",
+    tagline: "Rich and bold \u2014 Pinterest Pushpin red over the brand\u2019s neutral greys; white labels on the red.",
+    inspiration: "Pinterest \u2014 its whole documented palette: Pushpin red #E60023/#BD081C over Cod-Gray ink (#111111) and neutral greys (#767676/#EFEFEF), with Gestalt \u201CSkycicle\u201D blue links.",
+    designDoc: "docs/palettes/garnet.md"
+  },
+  citrine: {
+    id: "citrine",
+    name: "Citrine",
+    tagline: "Bright and collaborative \u2014 Miro\u2019s Sunglow yellow over the whiteboard greys, with the Miro action-blue accent.",
+    inspiration: "Miro \u2014 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.",
+    designDoc: "docs/palettes/citrine.md"
+  },
+  candy: {
+    id: "candy",
+    name: "Candy",
+    tagline: "Sweet and playful \u2014 a light bubblegum-pink primary over candy-paper pinks, with a full pastel-candy rainbow.",
+    inspiration: "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.",
+    designDoc: "docs/palettes/candy.md"
+  }
+};
+var DEFAULT_PALETTE_ID = "motir";
+function isPaletteId(value) {
+  return typeof value === "string" && Object.prototype.hasOwnProperty.call(PALETTE_REGISTRY, value);
+}
+function resolvePalette(value) {
+  return PALETTE_REGISTRY[isPaletteId(value) ? value : DEFAULT_PALETTE_ID];
+}
+
+// src/theme/types.ts
+var THEME_DEFAULTS = {
+  pattern: "system"};
+function isThemePattern(value) {
+  return value === "system" || value === "light" || value === "dark";
+}
+function resolvePattern(value) {
+  return isThemePattern(value) ? value : THEME_DEFAULTS.pattern;
+}
+
+// src/theme/appearance-resolution.ts
+function resolveAxesToApplied(axes) {
+  const pattern = resolvePattern(axes.pattern);
+  const styleId = resolveStyle(axes.styleId).id;
+  const paletteId = resolvePalette(axes.paletteId).id;
+  const typePinned = isTypeId(axes.typeId);
+  const typeId = typePinned ? axes.typeId : defaultTypeForStyle(styleId);
+  return { pattern, styleId, paletteId, typeId, typePinned };
+}
+function resolveAppliedAppearance(server, local) {
+  if (server) return server;
+  return resolveAxesToApplied({
+    pattern: local.pattern,
+    styleId: local.style,
+    paletteId: local.palette,
+    typeId: local.type
+  });
+}
+
+export { resolveAppliedAppearance, resolveAxesToApplied };
+//# sourceMappingURL=appearance-resolution.js.map
+//# sourceMappingURL=appearance-resolution.js.map

package/dist/theme/appearance-resolution.js.map

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

package/dist/theme/init-script.d.ts

@@ -0,0 +1,48 @@
+import { AppliedAppearanceDto } from '../appearance.js';
+import './types.js';
+import './styles.js';
+import './typography.js';
+import './palettes.js';
+
+/**
+ * Build the inline `<script>` content that runs BEFORE React hydrates, applying
+ * the user's appearance to `<html>` (`data-theme` + `data-style` + `data-palette`
+ * + `data-type`). Without this the page briefly flashes the SSR default before
+ * the client applies the real preference — a classic FOUC.
+ *
+ * `serverPref` is the signed-in user's APPLIED appearance (Subtask 7.3.61); pass
+ * `null` for an anonymous visitor. The precedence (the FOUC-critical rule):
+ *
+ * - **Signed-in (serverPref present)** → the SERVER preference is authoritative
+ *   (it followed the user to this device). The script applies the server values
+ *   and IGNORES localStorage for the applied value, so a stale localStorage from
+ *   another device can never clobber a present server value. It then RECONCILES
+ *   localStorage FROM the server pref — keeping it an accurate instant-apply
+ *   cache and preserving the user's look if they later sign out. An unpinned
+ *   type is reconciled by REMOVING the `type` key (so the anonymous path keeps
+ *   following the style default); a pinned type is written.
+ * - **Anonymous (serverPref null)** → unchanged from the original behaviour:
+ *   read localStorage, resolve each axis through the registries (baked in at
+ *   build time), and fall an unpinned type back to the active style's default.
+ *
+ * For `data-theme` the script still resolves `pattern==='system'` via
+ * `matchMedia` at runtime — the one axis the server cannot know — so the root
+ * layout renders `data-theme` server-side only for an explicit `light`/`dark`
+ * and leaves `system` (and the anonymous case) to this script.
+ *
+ * Safety: the only per-request data embedded is `serverPref`, whose every field
+ * is a CLOSED-ENUM registry id (`[a-z0-9-]`) / `system|light|dark` / a boolean —
+ * never free user input. It is JSON-serialised with `<` escaped to `<` so
+ * it cannot break out of the `<script>` element. The rest is a static,
+ * compile-time string. This is the standard theme-init pattern (next-themes,
+ * shadcn/ui, dooooWeb).
+ */
+declare function buildThemeInitScript(serverPref: AppliedAppearanceDto | null): string;
+/**
+ * The anonymous baseline init script (no server preference). Kept as a named
+ * export for callers / tests that don't need per-request data; the root layout
+ * uses {@link buildThemeInitScript} with the signed-in user's applied pref.
+ */
+declare const themeInitScript: string;
+
+export { buildThemeInitScript, themeInitScript };