css-is-awesome 1.1.0

package/scss/themes/prism.scss

@@ -0,0 +1,190 @@
+// ============================================================================
+// THEME — Prism
+// ============================================================================
+// Clean component-library aesthetic inspired by Vercel/Linear/Radix/shadcn.
+// Neutral grays do heavy lifting; one restrained refined-blue accent;
+// border-driven (not shadow-driven); generous whitespace.
+//
+// Fonts, radii, motion identical across modes. Only colors and shadow alphas
+// differ — handled with light-dark().
+//
+// Selector: :root, :root[data-theme="prism"]
+// Replaces: [data-theme="prism-light"] + [data-theme="prism-dark"]
+// ============================================================================
+@use '../mixins' as m;
+
+@import 'https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&family=JetBrains+Mono:wght@400;500;600;700&display=swap';
+
+@include m.theme('prism') {
+  /* Surfaces */
+  --paper:        light-dark(#fff, #09090b);
+  --paper-raised: light-dark(#fff, #18181b);
+  --paper-sunk:   light-dark(#f4f4f5, #27272a);
+  --paper-glass:  light-dark(rgba(255, 255, 255, 0.80), rgba(24, 24, 27, 0.80));
+
+  /* Ink — zinc neutral ramp */
+  --ink:       light-dark(#09090b, #fafafa);
+  --ink-soft:  light-dark(#27272a, #e4e4e7);
+  --ink-faint: light-dark(#52525b, #a1a1aa);
+  --graphite:  light-dark(#18181b, #f4f4f5);
+  --muted:     light-dark(#71717a, #71717a);
+
+  /* Lines */
+  --guide:      light-dark(#d4d4d8, #3f3f46);
+  --guide-soft: light-dark(#e4e4e7, #27272a);
+  --hair:       light-dark(#e4e4e7, #27272a);
+  --hair-soft:  light-dark(#f4f4f5, #18181b);
+
+  /* Primary accent — refined blue (brighter for dark) */
+  --ai:      light-dark(#2563eb, #3b82f6);
+  --ai-ink:  light-dark(#1d4ed8, #60a5fa);
+  --ai-wash: light-dark(#eff6ff, #1e3a8a);
+
+  /* Seal — red */
+  --shu:      light-dark(#dc2626, #ef4444);
+  --shu-wash: light-dark(#fef2f2, #450a0a);
+
+  /* Tertiary — amber */
+  --ochre:      light-dark(#ca8a04, #eab308);
+  --ochre-wash: light-dark(#fefce8, #422006);
+
+  /* Code surface */
+  --code-bg:     light-dark(#fafafa, #0a0a0a);
+  --code-ink:    light-dark(#18181b, #e4e4e7);
+  // Must be light-dark(): --code-bg is light-dark(#fafafa, #0a0a0a), and no
+  // single grey clears 4.5:1 on both a near-white and a near-black surface —
+  // the two constraints are arithmetically disjoint (needs L <= 0.174 AND
+  // L >= 0.189). A single value here was a latent a11y failure on one scheme.
+  --code-muted:  light-dark(#6B6B73, #808089);
+  --code-accent: light-dark(#C1410C, #fb923c);
+  --code-green:  light-dark(#117D39, #4ade80);
+  --code-blue:   light-dark(#2462EB, #60a5fa);
+
+  /* Typography — identical across modes */
+  --font-display: 'Inter', -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, sans-serif;
+  --font-script:  'Inter', cursive;
+  --font-serif:   Georgia, 'Times New Roman', Times, serif;
+  --font-sans:    'Inter', -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, sans-serif;
+  --font-mono:    'JetBrains Mono', 'SF Mono', 'Roboto Mono', Consolas, Menlo, monospace;
+
+  /* Radius — identical */
+  --r-sm: 4px;
+  --r-md: 6px;
+  --r-lg: 8px;
+
+  /* Shadow — extremely subtle, heavier on dark */
+  --shadow-sm:  0 1px 1px  light-dark(rgba(9, 9, 11, 0.03), rgba(0, 0, 0, 0.30));
+  --shadow-md:  0 1px 2px  light-dark(rgba(9, 9, 11, 0.05), rgba(0, 0, 0, 0.40));
+  --shadow-lg:  0 4px 12px -4px  light-dark(rgba(9, 9, 11, 0.08), rgba(0, 0, 0, 0.60));
+  --shadow-xl:  0 16px 32px -16px light-dark(rgba(9, 9, 11, 0.15), rgba(0, 0, 0, 0.70));
+  --shadow-2xl: 0 0 0 1px light-dark(#e4e4e7, #27272a), 0 8px 24px -8px light-dark(rgba(9, 9, 11, 0.12), rgba(0, 0, 0, 0.60));
+
+  /* Blur / glow — Prism uses neither */
+  --blur-sm: none; --blur-md: none; --blur-lg: none;
+  --glow-sm: 0 0 0 transparent; --glow-md: 0 0 0 transparent; --glow-lg: 0 0 0 transparent;
+
+  /* Motion — fast + crisp, identical */
+  --duration-fast:   100ms;
+  --duration-normal: 150ms;
+  --duration-slow:   250ms;
+  --ease:            cubic-bezier(.32, .72, 0, 1);
+
+  /* Semantic aliases */
+  --background-default: var(--paper);
+  --background-subtle:  var(--paper-sunk);
+  --background-navbar:  var(--paper-raised);
+  --surface-default:    var(--paper);
+  --surface-raised:     var(--paper-raised);
+  --surface-sunk:       var(--paper-sunk);
+  --surface-muted:      var(--paper-sunk);
+  --surface-subtle:     var(--paper-raised);
+  --surface-emphasis:   var(--ink);
+  --surface-glass:      var(--paper-glass);
+
+  --text-primary:    var(--ink);
+  --text-secondary:  var(--ink-soft);
+  --text-muted:      var(--ink-faint);
+  --text-tertiary:   var(--muted);
+  --text-inverse:    var(--paper);
+  --text-link:       var(--ai);
+  --text-link-hover: var(--ai-ink);
+
+  --border-default:  var(--hair);
+  --border-subtle:   var(--hair-soft);
+  --border-emphasis: var(--guide);
+  --border-focus:    var(--ai);
+
+  --interactive-hover:  light-dark(rgba(9, 9, 11, 0.05),   rgba(255, 255, 255, 0.05));
+  --interactive-active: light-dark(rgba(9, 9, 11, 0.10),   rgba(255, 255, 255, 0.10));
+
+  --brand-primary:       var(--ai);
+  --brand-primary-hover: var(--ai-ink);
+
+  --action-primary-default:   var(--ai);
+  --action-primary-hover:     var(--ai-ink);
+  --action-primary-active:    var(--ai-ink);
+  --action-primary-wash:      var(--ai-wash);
+  --action-secondary-default: var(--shu);
+  --action-secondary-hover:   var(--shu);
+  --action-secondary-active:  var(--shu);
+  --action-secondary-wash:    var(--shu-wash);
+  --action-tertiary-default:  var(--ochre);
+  --action-tertiary-hover:    var(--ochre);
+  --action-tertiary-active:   var(--ochre);
+  --action-tertiary-wash:     var(--ochre-wash);
+
+  --feedback-info:    var(--ai);
+  --feedback-success: light-dark(#16a34a, #22c55e);
+  --feedback-warning: var(--ochre);
+  --feedback-error:   var(--shu);
+
+  --info-default: var(--ai);
+  --info-subtle:  var(--ai-wash);
+  --info-text:    light-dark(var(--ai-ink), #85BFFF);
+
+  --success-default: light-dark(#16a34a, #22c55e);
+  --success-subtle:  light-dark(#f0fdf4, #14532d);
+  --success-text:    light-dark(#15803d, #4ade80);
+
+  --warning-default: light-dark(#ca8a04, #eab308);
+  --warning-subtle:  light-dark(#fefce8, #422006);
+  --warning-text:    light-dark(#854d0e, #fde047);
+
+  --error-default: light-dark(#dc2626, #ef4444);
+  --error-subtle:  light-dark(#fef2f2, #450a0a);
+  --error-text:    light-dark(#b91c1c, #fca5a5);
+
+  /* Library scales — identical */
+
+  /* Spacing rhythm — THE knob for how dense or airy this theme feels.
+     The numbered scale is the source of truth: every component reads
+     var(--space-N), and the t-shirt aliases (--space-md, --space-lg …)
+     are emitted by the library as references to these, so they follow
+     automatically. Change a value here and the whole page re-proportions.
+     Halve them for a compact UI; raise 4/5/6 for an airy editorial feel. */
+  --space-0: 0;          /* flush            */
+  --space-1: 0.5rem;     /* tight inner gap  */
+  --space-2: 0.75rem;    /* control padding  */
+  --space-3: 0.875rem;   /* (no t-shirt)     */
+  --space-4: 1rem;       /* default rhythm   */
+  --space-5: 1.5rem;     /* section gap      */
+  --space-6: 2rem;       /* block gap        */
+  --space-7: 3rem;       /* major gap        */
+  --space-8: 4rem;       /* page section     */
+  --space-9: 6rem;       /* hero rhythm      */
+
+  --radius-sm: var(--r-sm); --radius-md: var(--r-md); --radius-lg: var(--r-lg);
+  --radius-xl: 12px; --radius-full: 9999px;
+  --font-primary: var(--font-sans);
+  --font-size-base: 1rem; --line-height-normal: 1.5; --font-weight-medium: 500;
+  --z-sticky: 1020; --z-dropdown: 1030; --z-backdrop: 1040;
+  --z-modal: 1050; --z-popover: 1060; --z-tooltip: 1070;
+
+  /* Component overrides — border-driven, tight radii */
+  --btn-radius:   var(--r-md);
+  --card-radius:  var(--r-md);
+  --card-shadow:  var(--shadow-sm);
+  --card-border:  1px solid var(--hair);
+  --input-radius: var(--r-md);
+  --modal-radius: var(--r-lg);
+}

package/scss/themes/sketchbook-dark.scss

@@ -0,0 +1,231 @@
+/* ============================================================
+   THEME — Sketchbook Dark
+   -----------------------------------------------------------
+   Dark companion to Sketchbook (the css-is-awesome default,
+   warm-paper editorial light). Same hand-sketched personality:
+   serif display, Caveat script accents, soft warm hairlines,
+   slow ink-bleed motion. Only the COLOR palette inverts —
+   radius / fonts / shadows / motion all match the partner.
+
+   Mood: charcoal-paper editorial dark — late-night studio,
+   pencil-on-toned-paper, warm grays instead of cold blacks.
+   --paper is a warm charcoal; --ink is a warm cream. The
+   indigo accent (--ai) brightens for dark surfaces; the
+   vermilion seal (--shu) stays warm; ochre (--ochre) stays
+   gold; the code panel inverts to a warm cream slab.
+
+   Opt-in via `<html data-theme="sketchbook-dark">`. Pair with
+   the default Sketchbook (which lives in the consolidated
+   bundle / public/theme.css) to ship a project with a default
+   light mode and an opt-in dark mode.
+   ============================================================ */
+
+@use '../mixins' as m;
+
+@import 'https://fonts.googleapis.com/css2?family=DM+Serif+Display:ital@0;1&family=Caveat:wght@400;500;600;700&family=Noto+Serif+JP:wght@400;500;700&family=Noto+Sans+JP:wght@300;400;500;600&family=JetBrains+Mono:wght@400;500;700&display=swap';
+
+@include m.theme('sketchbook-dark', dark) {
+    /* Surfaces — warm charcoal paper */
+    --paper:        #1A1815;
+    --paper-raised: #2A2520;
+    --paper-sunk:   #11100E;
+    --paper-glass:  rgba(42, 37, 32, 0.78);
+
+    /* Ink — warm cream pencil */
+    --ink:        #F4EFE2;
+    --ink-soft:   #D8D0BE;
+    --ink-faint:  #A89E89;
+    --graphite:   #E8E0CE;
+    --muted:      #7A715F;
+
+    /* Construction lines — warm dark hairlines */
+    --guide:      #4A4239;
+    --guide-soft: #382F27;
+    --hair:       #3F362C;
+    --hair-soft:  #2A241E;
+
+    /* Primary accent — lifted indigo for dark paper */
+    --ai:         #6E8FBF;
+    --ai-ink:     #8DA8D1;
+    --ai-wash:    #1F2B3F;
+
+    /* Seal — vermilion (stays warm, brightened slightly) */
+    --shu:        #E36148;
+    --shu-wash:   #3A1A14;
+
+    /* Draft / marginalia — warm gold */
+    --ochre:      #D4A04B;
+    --ochre-wash: #382B14;
+
+    /* Code surface — invert: warm cream slab */
+    --code-bg:     #F7F3EA;
+    --code-ink:    #2B2420;
+    --code-muted:  #6B5E50;
+    --code-accent: #826226;
+    --code-green:  #537035;
+    --code-blue:   #1F3A5F;
+
+    /* Typography — match Sketchbook */
+    --font-display: 'DM Serif Display', 'Playfair Display', 'Cormorant Garamond', Georgia, serif;
+    --font-script:  'Caveat', 'Shadows Into Light', cursive;
+    --font-serif:   'Noto Serif JP', 'Cormorant Garamond', Georgia, serif;
+    --font-sans:    'Noto Sans JP', -apple-system, BlinkMacSystemFont, 'Segoe UI', Helvetica, Arial, sans-serif;
+    --font-mono:    'JetBrains Mono', 'SFMono-Regular', Consolas, Menlo, monospace;
+
+    /* Radius — match Sketchbook */
+    --r-sm: 2px;
+    --r-md: 3px;
+    --r-lg: 6px;
+
+    /* Shadows — heavier on dark, ink bleeding behind paper */
+    --shadow-sm: 0 1px 2px rgba(0, 0, 0, .35);
+    --shadow-md: 0 4px 18px rgba(0, 0, 0, .45);
+    --shadow-lg: 0 12px 40px rgba(0, 0, 0, .55);
+    --shadow-xl: 0 20px 50px rgba(0, 0, 0, .65);
+    --shadow-2xl: 0 28px 70px rgba(0, 0, 0, .75);
+
+    /* Blur — paper themes don't use it; declared so swap stays lossless */
+    --blur-sm: none;
+    --blur-md: none;
+    --blur-lg: none;
+
+    /* Glow — faint warm rim (charcoal paper, not phosphor) */
+    --glow-sm: 0 0 0 transparent;
+    --glow-md: 0 0 0 transparent;
+    --glow-lg: 0 0 0 transparent;
+
+    /* Motion — match Sketchbook (editorial pace) */
+    --duration-fast:   180ms;
+    --duration-normal: 240ms;
+    --duration-slow:   380ms;
+    --ease:            cubic-bezier(0.33, 0.66, 0.33, 1);
+
+    /* ----------------------------------------------------------
+       SEMANTIC ALIASES
+       ---------------------------------------------------------- */
+
+    /* Backgrounds (page-level) */
+    --background-default: var(--paper);
+    --background-subtle:  var(--paper-sunk);
+    --background-navbar:  var(--paper-raised);
+
+    /* Surfaces */
+    --surface-default:   var(--paper);
+    --surface-raised:    var(--paper-raised);
+    --surface-sunk:      var(--paper-sunk);
+    --surface-muted:     var(--paper-sunk);
+    --surface-subtle:    var(--paper-raised);
+    --surface-emphasis:  var(--ink);
+    --surface-glass:     var(--paper-glass);
+
+    /* Text */
+    --text-primary:      var(--ink);
+    --text-secondary:    var(--ink-soft);
+    --text-muted:        var(--ink-faint);
+    --text-tertiary:     var(--muted);
+    --text-inverse:      var(--paper);
+    --text-link:         var(--ai);
+    --text-link-hover:   var(--ai-ink);
+
+    /* Borders */
+    --border-default:    var(--hair);
+    --border-subtle:     var(--hair-soft);
+    --border-emphasis:   var(--guide);
+    --border-focus:      var(--ai);
+
+    /* Interactive (hover / active wash layers) — warm cream on charcoal */
+    --interactive-hover:  rgba(244, 239, 226, 0.06);
+    --interactive-active: rgba(244, 239, 226, 0.12);
+
+    /* Brand */
+    --brand-primary:        var(--ai);
+    --brand-primary-hover:  var(--ai-ink);
+
+    /* Action triplets */
+    --action-primary-default:   var(--ai);
+    --action-primary-hover:     var(--ai-ink);
+    --action-primary-active:    var(--ai-ink);
+    --action-primary-wash:      var(--ai-wash);
+    --action-secondary-default: var(--shu);
+    --action-secondary-hover:   var(--shu);
+    --action-secondary-active:  var(--shu);
+    --action-secondary-wash:    var(--shu-wash);
+    --action-tertiary-default:  var(--ochre);
+    --action-tertiary-hover:    var(--ochre);
+    --action-tertiary-active:   var(--ochre);
+    --action-tertiary-wash:     var(--ochre-wash);
+
+    /* Feedback */
+    --feedback-info:     var(--ai);
+    --feedback-success:  var(--code-green);
+    --feedback-warning:  var(--ochre);
+    --feedback-error:    var(--shu);
+
+    /* Status — info */
+    --info-default: var(--ai);
+    --info-subtle:  var(--ai-wash);
+    --info-text:    var(--ai-ink);
+
+    /* Status — success (lifted moss-green for dark paper) */
+    --success-default: #8DA86A;
+    --success-subtle:  #1F2B14;
+    --success-text:    #B8CC8E;
+
+    /* Status — warning */
+    --warning-default: var(--ochre);
+    --warning-subtle:  var(--ochre-wash);
+    --warning-text:    #E8BF6E;
+
+    /* Status — error */
+    --error-default: var(--shu);
+    --error-subtle:  var(--shu-wash);
+    --error-text:    #F08A72;
+
+    /* ----------------------------------------------------------
+       LIBRARY SCALES
+       ---------------------------------------------------------- */
+
+    /* Space scale */
+
+  /* Spacing rhythm — THE knob for how dense or airy this theme feels.
+     The numbered scale is the source of truth: every component reads
+     var(--space-N), and the t-shirt aliases (--space-md, --space-lg …)
+     are emitted by the library as references to these, so they follow
+     automatically. Change a value here and the whole page re-proportions.
+     Halve them for a compact UI; raise 4/5/6 for an airy editorial feel. */
+  --space-0: 0;          /* flush            */
+  --space-1: 0.5rem;     /* tight inner gap  */
+  --space-2: 0.75rem;    /* control padding  */
+  --space-3: 0.875rem;   /* (no t-shirt)     */
+  --space-4: 1rem;       /* default rhythm   */
+  --space-5: 1.5rem;     /* section gap      */
+  --space-6: 2rem;       /* block gap        */
+  --space-7: 3rem;       /* major gap        */
+  --space-8: 4rem;       /* page section     */
+  --space-9: 6rem;       /* hero rhythm      */
+
+
+
+
+
+    /* Radius alias */
+    --radius-sm:   var(--r-sm);
+    --radius-md:   var(--r-md);
+    --radius-lg:   var(--r-lg);
+    --radius-xl:   0.75rem;
+    --radius-full: 9999px;
+
+    /* Typography */
+    --font-primary:       var(--font-sans);
+    --font-size-base:     1rem;
+    --line-height-normal: 1.5;
+    --font-weight-medium: 500;
+
+    /* Z-index layers */
+    --z-sticky:   1020;
+    --z-dropdown: 1030;
+    --z-backdrop: 1040;
+    --z-modal:    1050;
+    --z-popover:  1060;
+    --z-tooltip:  1070;
+}

package/scss/themes/sketchbook-light.scss

@@ -0,0 +1,231 @@
+// ============================================================================
+// THEME — sketchbook-light
+// ============================================================================
+// Daylight half of Sketchbook, and the docs site's DEFAULT theme
+// (src/app/layout.tsx boots with data-theme="sketchbook-light").
+//
+// Promoted from a bundle-only block to a real source 2026-08-29. It had no
+// scss/ file and no public/themes/ directory, so nothing rebuilt it and the
+// contract gate could not see it.
+//
+// Selector: :root, :root[data-theme="sketchbook-light"]
+// ============================================================================
+@use '../mixins' as m;
+
+@include m.theme('sketchbook-light', light) {
+  /* Surfaces — warm paper */
+  --paper:        #F7F3EA;
+  --paper-raised: #FDFAF2;
+  --paper-sunk:   #ECE5D3;
+  --paper-glass:  rgba(253, 250, 242, 0.75);
+
+  /* Ink — warm pencil + sumi */
+  --ink:        #2A241E;
+  --ink-soft:   #4A4037;
+  --ink-faint:  #726858;
+  --graphite:   #3A332B;
+  --muted:      #948977;
+
+  /* Construction lines */
+  --guide:      #C9BDA5;
+  --guide-soft: #DDD4C0;
+  --hair:       #D4CCBB;
+  --hair-soft:  #E8E2D4;
+
+  /* Primary accent — indigo */
+  --ai:         #1F3A5F;
+  --ai-ink:     #14263F;
+  --ai-wash:    #E5EBF1;
+
+  /* Seal — vermilion (reserve for emphasis) */
+  --shu:        #C1272D;
+  --shu-wash:   #F6E3E1;
+
+  /* Draft / marginalia — warm gold */
+  --ochre:      #A37B30;
+  --ochre-wash: #F0E5CC;
+
+  /* Code surface */
+  --code-bg:     #2B2420;
+  --code-ink:    #F7F3EA;
+  --code-muted:  #A39787;
+  --code-accent: #E5B660;
+  --code-green:  #A8B86C;
+  --code-blue:   #94AFC9;
+
+  /* Typography */
+  --font-display: 'DM Serif Display', 'Playfair Display', 'Cormorant Garamond', Georgia, serif;
+  --font-script:  'Caveat', 'Shadows Into Light', cursive;
+  --font-serif:   'Noto Serif JP', 'Cormorant Garamond', Georgia, serif;
+  --font-sans:    'Noto Sans JP', -apple-system, BlinkMacSystemFont, 'Segoe UI', Helvetica, Arial, sans-serif;
+  --font-mono:    'JetBrains Mono', 'SFMono-Regular', Consolas, Menlo, monospace;
+
+  /* Radius */
+  --r-sm: 2px;
+  --r-md: 3px;
+  --r-lg: 6px;
+
+  /* Shadows — ink bleeding through paper */
+  --shadow-sm: 0 1px 2px rgba(42, 36, 30, .06);
+  --shadow-md: 0 4px 18px rgba(42, 36, 30, .08);
+  --shadow-lg: 0 12px 40px rgba(42, 36, 30, .12);
+  --shadow-xl: 0 20px 50px rgba(42, 36, 30, .16);
+  --shadow-2xl: 0 28px 70px rgba(42, 36, 30, .22);
+
+  /* Blur — paper themes don't use it; declared so swap stays lossless */
+  --blur-sm: none;
+  --blur-md: none;
+  --blur-lg: none;
+
+  /* Glow — faint ink bleed, not phosphor */
+  --glow-sm: 0 0 0 transparent;
+  --glow-md: 0 0 0 transparent;
+  --glow-lg: 0 0 0 transparent;
+
+  /* Motion */
+  --duration-fast:   180ms;
+  --duration-normal: 240ms;
+  --duration-slow:   380ms;
+  --ease:            cubic-bezier(0.33, 0.66, 0.33, 1);
+
+  /* ----------------------------------------------------------
+  SEMANTIC ALIASES
+  -----------------------------------------------------------
+  Bridge the library's expected names to this theme's native
+  palette. Components can now write m.color(surface-default)
+  or var(--surface-default) and reskin with the theme
+  automatically.
+  ---------------------------------------------------------- */
+
+  /* Backgrounds (page-level) */
+  --background-default: var(--paper);
+  --background-subtle:  var(--paper-sunk);
+  --background-navbar:  var(--paper-raised);
+
+  /* Surfaces */
+  --surface-default:   var(--paper);
+  --surface-raised:    var(--paper-raised);
+  --surface-sunk:      var(--paper-sunk);
+  --surface-muted:     var(--paper-sunk);
+  --surface-subtle:    var(--paper-raised);
+  --surface-emphasis:  var(--ink);
+  --surface-glass:     var(--paper-glass);
+
+  /* Text */
+  --text-primary:      var(--ink);
+  --text-secondary:    var(--ink-soft);
+  --text-muted:        var(--ink-faint);
+  --text-tertiary:     var(--muted);
+  --text-inverse:      var(--paper);
+  --text-link:         var(--ai);
+  --text-link-hover:   var(--ai-ink);
+
+  /* Borders */
+  --border-default:    var(--hair);
+  --border-subtle:     var(--hair-soft);
+  --border-emphasis:   var(--ink);
+  --border-focus:      var(--ai);
+
+  /* Interactive (hover / active wash layers) */
+  --interactive-hover:  rgba(42, 36, 30, 0.06);
+  --interactive-active: rgba(42, 36, 30, 0.12);
+
+  /* Brand (identity — action-primary usually references these) */
+  --brand-primary:        var(--ai);
+  --brand-primary-hover:  var(--ai-ink);
+
+  /* Action (primary / secondary / tertiary) */
+  --action-primary-default:   var(--ai);
+  --action-primary-hover:     var(--ai-ink);
+  --action-primary-active:    var(--ai-ink);
+  --action-primary-wash:      var(--ai-wash);
+  --action-secondary-default: var(--shu);
+  --action-secondary-hover:   var(--shu);
+  --action-secondary-active:  var(--shu);
+  --action-secondary-wash:    var(--shu-wash);
+  --action-tertiary-default:  var(--ochre);
+  --action-tertiary-hover:    var(--ochre);
+  --action-tertiary-active:   var(--ochre);
+  --action-tertiary-wash:     var(--ochre-wash);
+
+  /* Feedback / status (high-level semantic) */
+  --feedback-info:     var(--ai);
+  --feedback-success:  var(--code-green);
+  --feedback-warning:  var(--ochre);
+  --feedback-error:    var(--shu);
+
+  /* Status — info (three-part: default / subtle / text) */
+  --info-default: var(--ai);
+  --info-subtle:  var(--ai-wash);
+  --info-text:    var(--ai-ink);
+
+  /* Status — success */
+  --success-default: #5A7A3A;
+  --success-subtle:  #EAEFDC;
+  --success-text:    #3F5627;
+
+  /* Status — warning */
+  --warning-default: var(--ochre);
+  --warning-subtle:  var(--ochre-wash);
+  --warning-text:    #6B4E1E;
+
+  /* Status — error */
+  --error-default: var(--shu);
+  --error-subtle:  var(--shu-wash);
+  --error-text:    #7A1A1F;
+
+  /* ----------------------------------------------------------
+  LIBRARY SCALES (space / radius / type / motion / z)
+  -----------------------------------------------------------
+  The library mixins emit var(--space-<key>), var(--radius-<key>),
+  var(--font-primary), var(--font-size-<key>), var(--z-<key>), …
+  Themes declare the slots so those mixins always resolve.
+  Override any of these to change the whole system's rhythm.
+  ---------------------------------------------------------- */
+
+  /* Space scale (rem for accessibility) */
+  --space-2xs: 0.25rem;
+  --space-xs:  0.5rem;
+  --space-sm:  0.75rem;
+  --space-md:  1rem;
+  --space-lg:  1.5rem;
+  --space-xl:  2rem;
+
+  /* Radius alias — mirrors --r-* with standard names so
+  `m.radius(size)` in the library finds --radius-<size>. */
+  --radius-sm:   var(--r-sm);
+  --radius-md:   var(--r-md);
+  --radius-lg:   var(--r-lg);
+  --radius-xl:   0.75rem;
+  --radius-full: 9999px;
+
+  /* Typography — base body font + key scale slots */
+  --font-primary: var(--font-sans);
+  --font-size-base: 1rem;
+  --line-height-normal: 1.5;
+  --font-weight-medium: 500;
+
+  /* Z-index layers */
+  --z-sticky:   1020;
+  --z-dropdown: 1030;
+  --z-backdrop: 1040;
+  --z-modal:    1050;
+  --z-popover:  1060;
+  --z-tooltip:  1070;
+
+  /* Spacing rhythm — THE knob for how dense or airy this theme feels.
+     The numbered scale is the source of truth: every component reads
+     var(--space-N), and the t-shirt aliases (--space-md, --space-lg …)
+     are emitted by the library as references to these, so they follow
+     automatically. Change a value here and the whole page re-proportions. */
+  --space-0: 0;
+  --space-1: 0.5rem;
+  --space-2: 0.75rem;
+  --space-3: 0.875rem;
+  --space-4: 1rem;
+  --space-5: 1.5rem;
+  --space-6: 2rem;
+  --space-7: 3rem;
+  --space-8: 4rem;
+  --space-9: 6rem;
+}