css-is-awesome 1.1.0

package/scss/themes/boilerplate-light.scss

@@ -0,0 +1,209 @@
+// ============================================================================
+// THEME — boilerplate-light
+// ============================================================================
+// Daylight half of Boilerplate.
+//
+// Promoted from a bundle-only block to a real source 2026-08-29.
+//
+// Selector: :root, :root[data-theme="boilerplate-light"]
+// ============================================================================
+@use '../mixins' as m;
+
+@include m.theme('boilerplate-light', light) {
+  /* Surfaces — off-white paper, light gray sunk */
+  --paper:        #fff;
+  --paper-raised: #f2f2f2;
+  --paper-sunk:   #f8fafc;
+  --paper-glass:  rgba(255, 255, 255, 0.85);
+
+  /* Ink — slate neutral ramp */
+  --ink:        #0f172a;
+  --ink-soft:   #1e293b;
+  --ink-faint:  #475569;
+  --graphite:   #0f172a;
+  --muted:      #64748b;
+
+  /* Lines — light slate borders */
+  --guide:      #cbd5e1;
+  --guide-soft: #e2e8f0;
+  --hair:       #e2e8f0;
+  --hair-soft:  #f1f5f9;
+
+  /* Primary accent — clean, recognizable blue */
+  --ai:         #2563eb;
+  --ai-ink:     #1d4ed8;
+  --ai-wash:    #eff6ff;
+
+  /* Seal — red (used for error / secondary action) */
+  --shu:        #dc2626;
+  --shu-wash:   #fef2f2;
+
+  /* Tertiary — amber (used for warning) */
+  --ochre:      #d97706;
+  --ochre-wash: #fffbeb;
+
+  /* Code — neutral light syntax surface */
+  --code-bg:     #f8fafc;
+  --code-ink:    #0f172a;
+  --code-muted:  #64748b;
+  --code-accent: #c2410c;
+  --code-green:  #15803d;
+  --code-blue:   #2563eb;
+
+  /* Typography — system stacks only (no @import) */
+  --font-display: ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, sans-serif;
+  --font-script:  ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
+  --font-serif:   ui-serif, Georgia, Cambria, 'Times New Roman', Times, serif;
+  --font-sans:    ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, sans-serif;
+  --font-mono:    ui-monospace, SFMono-Regular, 'SF Mono', Menlo, Consolas, 'Liberation Mono', monospace;
+
+  /* Radius — standard, unsurprising */
+  --r-sm: 4px;
+  --r-md: 6px;
+  --r-lg: 8px;
+
+  /* Shadow — subtle, neutral slate */
+  --shadow-sm:  0 1px 2px rgba(15, 23, 42, .04);
+  --shadow-md:  0 1px 3px rgba(15, 23, 42, .06), 0 1px 2px rgba(15, 23, 42, .04);
+  --shadow-lg:  0 4px 12px -2px rgba(15, 23, 42, .08), 0 2px 4px -2px rgba(15, 23, 42, .05);
+  --shadow-xl:  0 12px 24px -8px rgba(15, 23, 42, .10), 0 4px 8px -4px rgba(15, 23, 42, .06);
+  --shadow-2xl: 0 24px 48px -12px rgba(15, 23, 42, .15);
+
+  /* Blur — Boilerplate doesn't use frosted surfaces */
+  --blur-sm: none;
+  --blur-md: none;
+  --blur-lg: none;
+
+  /* Glow — Boilerplate doesn't use glow effects */
+  --glow-sm: 0 0 0 transparent;
+  --glow-md: 0 0 0 transparent;
+  --glow-lg: 0 0 0 transparent;
+
+  /* Motion — moderate, not flashy */
+  --duration-fast:   120ms;
+  --duration-normal: 180ms;
+  --duration-slow:   280ms;
+  --ease:            cubic-bezier(.4, 0, .2, 1);
+
+  /* Backgrounds */
+  --background-default: var(--paper);
+  --background-subtle:  var(--paper-sunk);
+  --background-navbar:  var(--paper);
+
+  /* Surfaces (semantic) */
+  --surface-default:   var(--paper);
+  --surface-raised:    var(--paper-raised);
+  --surface-sunk:      var(--paper-sunk);
+  --surface-muted:     var(--paper-sunk);
+  --surface-subtle:    var(--paper-sunk);
+  --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 overlays */
+  --interactive-hover:  rgba(15, 23, 42, 0.04);
+  --interactive-active: rgba(15, 23, 42, 0.08);
+
+  /* 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:  #16a34a;
+  --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 */
+  --success-default: #16a34a;
+  --success-subtle:  #f0fdf4;
+  --success-text:    #15803d;
+
+  /* Status — warning */
+  --warning-default: var(--ochre);
+  --warning-subtle:  var(--ochre-wash);
+  --warning-text:    #b45309;
+
+  /* Status — error */
+  --error-default: var(--shu);
+  --error-subtle:  var(--shu-wash);
+  --error-text:    #b91c1c;
+
+  /* Space scale */
+  --space-2xs: 0.25rem;
+  --space-xs:  0.5rem;
+  --space-sm:  0.75rem;
+  --space-md:  1rem;
+  --space-lg:  1.5rem;
+  --space-xl:  2rem;
+
+  /* Radius alias */
+  --radius-sm:   var(--r-sm);
+  --radius-md:   var(--r-md);
+  --radius-lg:   var(--r-lg);
+  --radius-xl:   12px;
+  --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;
+
+  /* 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;
+}

package/scss/themes/boilerplate.scss

@@ -0,0 +1,181 @@
+// ============================================================================
+// THEME — Boilerplate
+// ============================================================================
+// The recommended starter theme. Neutral, low-flourish, easy to override —
+// intentionally a "blank canvas" rather than an opinion.
+//
+// Design intent:
+//   - Slate neutral grays + one restrained blue accent
+//   - System UI fonts (no @import — fastest first paint)
+//   - Subtle shadows. Standard radii (4 / 6 / 8 px).
+//   - No glass, no glow, no decorative texture.
+//
+// Selector: :root, :root[data-theme="boilerplate"]
+// Replaces: [data-theme="boilerplate-light"] + [data-theme="boilerplate-dark"]
+// ============================================================================
+@use '../mixins' as m;
+
+@include m.theme('boilerplate') {
+  /* Surfaces */
+  --paper:        light-dark(#fff, #0f172a);
+  --paper-raised: light-dark(#f2f2f2, #1e293b);
+  --paper-sunk:   light-dark(#f8fafc, #020617);
+  --paper-glass:  light-dark(rgba(255, 255, 255, 0.85), rgba(15, 23, 42, 0.85));
+
+  /* Ink — slate neutral ramp */
+  --ink:       light-dark(#0f172a, #f8fafc);
+  --ink-soft:  light-dark(#1e293b, #e2e8f0);
+  --ink-faint: light-dark(#475569, #94a3b8);
+  --graphite:  light-dark(#0f172a, #f1f5f9);
+  --muted:     light-dark(#64748b, #64748b);
+
+  /* Lines */
+  --guide:      light-dark(#cbd5e1, #334155);
+  --guide-soft: light-dark(#e2e8f0, #1e293b);
+  --hair:       light-dark(#e2e8f0, #1e293b);
+  --hair-soft:  light-dark(#f1f5f9, #0f172a);
+
+  /* Primary accent */
+  --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(#d97706, #f59e0b);
+  --ochre-wash: light-dark(#fffbeb, #422006);
+
+  /* Code surface */
+  --code-bg:     light-dark(#f8fafc, #020617);
+  --code-ink:    light-dark(#0f172a, #e2e8f0);
+  --code-muted:  light-dark(#5E6D83, #6F8098);
+  --code-accent: light-dark(#C1410C, #fb923c);
+  --code-green:  light-dark(#147C3B, #4ade80);
+  --code-blue:   light-dark(#2362EB, #60a5fa);
+
+  /* Typography — system stacks, no @import, identical */
+  --font-display: ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, sans-serif;
+  --font-script:  ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
+  --font-serif:   ui-serif, Georgia, Cambria, 'Times New Roman', Times, serif;
+  --font-sans:    ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, sans-serif;
+  --font-mono:    ui-monospace, SFMono-Regular, 'SF Mono', Menlo, Consolas, 'Liberation Mono', monospace;
+
+  /* Radius — identical */
+  --r-sm: 4px;
+  --r-md: 6px;
+  --r-lg: 8px;
+
+  /* Shadow — subtle, neutral slate / heavier on dark */
+  --shadow-sm:  0 1px 2px      light-dark(rgba(15, 23, 42, 0.04), rgba(0, 0, 0, 0.30));
+  --shadow-md:  0 1px 3px      light-dark(rgba(15, 23, 42, 0.06), rgba(0, 0, 0, 0.40)),
+                0 1px 2px      light-dark(rgba(15, 23, 42, 0.04), rgba(0, 0, 0, 0.30));
+  --shadow-lg:  0 4px 12px -2px  light-dark(rgba(15, 23, 42, 0.08), rgba(0, 0, 0, 0.55)),
+                0 2px 4px -2px   light-dark(rgba(15, 23, 42, 0.05), rgba(0, 0, 0, 0.30));
+  --shadow-xl:  0 12px 24px -8px light-dark(rgba(15, 23, 42, 0.10), rgba(0, 0, 0, 0.65)),
+                0 4px 8px -4px   light-dark(rgba(15, 23, 42, 0.06), rgba(0, 0, 0, 0.40));
+  --shadow-2xl: 0 24px 48px -12px light-dark(rgba(15, 23, 42, 0.15), rgba(0, 0, 0, 0.75));
+
+  /* Blur / glow — none */
+  --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 — identical */
+  --duration-fast:   120ms;
+  --duration-normal: 180ms;
+  --duration-slow:   280ms;
+  --ease:            cubic-bezier(.4, 0, .2, 1);
+
+  /* Semantic aliases */
+  --background-default: var(--paper);
+  --background-subtle:  var(--paper-sunk);
+  --background-navbar:  light-dark(var(--paper), var(--paper-raised));
+  --surface-default:    var(--paper);
+  --surface-raised:     var(--paper-raised);
+  --surface-sunk:       var(--paper-sunk);
+  --surface-muted:      var(--paper-sunk);
+  --surface-subtle:     light-dark(var(--paper-sunk), 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(15, 23, 42, 0.04), rgba(248, 250, 252, 0.05));
+  --interactive-active: light-dark(rgba(15, 23, 42, 0.08), rgba(248, 250, 252, 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: var(--ochre);
+  --warning-subtle:  var(--ochre-wash);
+  --warning-text:    light-dark(#b45309, #fbbf24);
+
+  --error-default: var(--shu);
+  --error-subtle:  var(--shu-wash);
+  --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;
+}

package/scss/themes/cupertino-dark.scss

@@ -0,0 +1,238 @@
+/* ============================================================
+   THEME — Cupertino Dark
+   -----------------------------------------------------------
+   Dark companion to Cupertino (macOS native light). Same
+   AppKit design language: SF system stack, soft AppKit radii
+   (8/10/14), vibrancy blurs, lifted (not glowing) shadows.
+   Only the COLOR palette inverts.
+
+   Mood: macOS Dark Mode. SF-symbol-adjacent, system-blue
+   accent brightened for dark surfaces (Apple's #0A84FF dark
+   variant), warm ink-black panels (never purple, never pure
+   black). Trivial inversion — most macOS Dark conventions
+   are well-established.
+
+   Opt-in via `<html data-theme="cupertino-dark">`. Pair with
+   cupertino/theme.css to ship a project with a default light
+   AppKit mode and an opt-in dark AppKit mode.
+   ============================================================ */
+
+@use '../mixins' as m;
+
+@import 'https://fonts.googleapis.com/css2?family=Caveat:wght@400;500;600;700&display=swap';
+
+@include m.theme('cupertino-dark', dark) {
+    /* Surfaces — AppKit dark panels */
+    --paper:        #1E1E1E;
+    --paper-raised: #2A2A2A;
+    --paper-sunk:   #141414;
+    --paper-glass:  rgba(42, 42, 42, 0.72);
+
+    /* Ink — warm white, never pure */
+    --ink:        #F5F5F7;
+    --ink-soft:   #C7C7CC;
+    --ink-faint:  #98989D;
+    --graphite:   #AEAEB2;
+    --muted:      #6E6E73;
+
+    /* Hairlines / guides — translucent white */
+    --guide:      rgba(255, 255, 255, 0.16);
+    --guide-soft: rgba(255, 255, 255, 0.08);
+    --hair:       rgba(255, 255, 255, 0.12);
+    --hair-soft:  rgba(255, 255, 255, 0.06);
+
+    /* Primary accent — Apple system blue (dark variant) */
+    --ai:         #0A84FF;
+    --ai-ink:     #409CFF;
+    --ai-wash:    rgba(10, 132, 255, 0.16);
+
+    /* Seal — Apple system red (dark variant) */
+    --shu:        #FF453A;
+    --shu-wash:   rgba(255, 69, 58, 0.16);
+
+    /* Accent — Apple system orange (dark variant) */
+    --ochre:      #FF9F0A;
+    --ochre-wash: rgba(255, 159, 10, 0.16);
+
+    /* Code surface — AppKit dark code panel */
+    --code-bg:     #0F0F0F;
+    --code-ink:    #F2F2F7;
+    --code-muted:  #8E8E93;
+    --code-accent: #FF9F0A;
+    --code-green:  #30D158;
+    --code-blue:   #64D2FF;
+
+    /* Typography — match Cupertino (SF system stack) */
+    --font-display: -apple-system, BlinkMacSystemFont, 'SF Pro Display', 'Inter', 'Segoe UI', Helvetica, Arial, sans-serif;
+    --font-script:  'Caveat', 'Shadows Into Light', cursive;
+    --font-serif:   ui-serif, 'New York', 'Iowan Old Style', 'Palatino', Georgia, serif;
+    --font-sans:    -apple-system, BlinkMacSystemFont, 'SF Pro Text', 'Inter', 'Segoe UI', Helvetica, Arial, sans-serif;
+    --font-mono:    'SF Mono', ui-monospace, 'JetBrains Mono', 'Menlo', Consolas, monospace;
+
+    /* Radius — match Cupertino (AppKit corners) */
+    --r-sm: 8px;
+    --r-md: 10px;
+    --r-lg: 14px;
+
+    /* Shadows — small, diffuse, lifted (deeper for dark) */
+    --shadow-sm: 0 1px 2px rgba(0, 0, 0, 0.30), 0 0 0 0.5px rgba(0, 0, 0, 0.30);
+    --shadow-md: 0 4px 14px rgba(0, 0, 0, 0.40), 0 1px 3px rgba(0, 0, 0, 0.30);
+    --shadow-lg: 0 12px 40px rgba(0, 0, 0, 0.50), 0 2px 6px rgba(0, 0, 0, 0.30);
+    --shadow-xl: 0 20px 50px rgba(0, 0, 0, 0.60), 0 4px 10px rgba(0, 0, 0, 0.32);
+    --shadow-2xl: 0 28px 70px rgba(0, 0, 0, 0.72), 0 6px 14px rgba(0, 0, 0, 0.36);
+
+    /* Blur — vibrancy (Cupertino's signature, match light) */
+    --blur-sm: blur(20px) saturate(180%);
+    --blur-md: blur(30px) saturate(180%);
+    --blur-lg: blur(40px) saturate(180%);
+
+    /* Glow — Cupertino doesn't glow, it lifts */
+    --glow-sm: 0 0 0 transparent;
+    --glow-md: 0 0 0 transparent;
+    --glow-lg: 0 0 0 transparent;
+
+    /* Motion — Apple-snappy, match Cupertino */
+    --duration-fast:   160ms;
+    --duration-normal: 220ms;
+    --duration-slow:   320ms;
+    --ease:            cubic-bezier(0.25, 0.1, 0.25, 1);
+
+    /* ----------------------------------------------------------
+       SEMANTIC ALIASES
+       ---------------------------------------------------------- */
+
+    /* Backgrounds */
+    --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 — translucent white on dark (macOS Dark convention) */
+    --interactive-hover:  rgba(255, 255, 255, 0.06);
+    --interactive-active: rgba(255, 255, 255, 0.10);
+
+    /* 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 (macOS dark green) */
+    --success-default: #30D158;
+    --success-subtle:  rgba(48, 209, 88, 0.16);
+    --success-text:    #5FE37F;
+
+    /* Status — warning (macOS dark orange) */
+    --warning-default: var(--ochre);
+    --warning-subtle:  var(--ochre-wash);
+    --warning-text:    #FFB340;
+
+    /* Status — error (macOS dark red) */
+    --error-default: var(--shu);
+    --error-subtle:  var(--shu-wash);
+    --error-text:    #FF6961;
+
+    /* ----------------------------------------------------------
+       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 */
+    --z-sticky:   1020;
+    --z-dropdown: 1030;
+    --z-backdrop: 1040;
+    --z-modal:    1050;
+    --z-popover:  1060;
+    --z-tooltip:  1070;
+
+    /* ----------------------------------------------------------
+       OPTIONAL COMPONENT OVERRIDES — match Cupertino
+       ---------------------------------------------------------- */
+    --btn-radius:    var(--r-md);            /* 10px — AppKit control */
+    --card-radius:   var(--r-lg);            /* 14px — panel corner */
+    --card-shadow:   var(--shadow-sm);       /* diffuse, lifted */
+    --input-radius:  var(--r-sm);            /* 8px — text field */
+    --modal-radius:  var(--r-lg);            /* matches panel */
+    --tooltip-radius: var(--r-sm);           /* bezel tooltip */
+}