css-is-awesome 1.1.0

package/public/themes/cupertino/theme.css

@@ -0,0 +1,165 @@
+@charset "UTF-8";
+@import 'https://fonts.googleapis.com/css2?family=Caveat:wght@400;500;600;700&display=swap';
+:root, :root[data-theme=cupertino] {
+  color-scheme: light dark;
+  /* Surfaces — AppKit panels */
+  --paper: light-dark(#F5F5F7, #1E1E1E);
+  --paper-raised: light-dark(#FFF, #2A2A2A);
+  --paper-sunk: light-dark(#E9E9EC, #141414);
+  --paper-glass: light-dark(rgba(255, 255, 255, 0.72), rgba(42, 42, 42, 0.72));
+  /* Ink — warm black / warm white, never pure */
+  --ink: light-dark(#1D1D1F, #F5F5F7);
+  --ink-soft: light-dark(#3A3A3C, #C7C7CC);
+  --ink-faint: light-dark(#66666B, #98989D);
+  --graphite: light-dark(#2C2C2E, #AEAEB2);
+  --muted: light-dark(#6E6E73, #6E6E73);
+  /* Hairlines — solid in light, translucent white in dark */
+  --guide: light-dark(#D2D2D7, rgba(255, 255, 255, 0.16));
+  --guide-soft: light-dark(#E5E5EA, rgba(255, 255, 255, 0.08));
+  --hair: light-dark(#D2D2D7, rgba(255, 255, 255, 0.12));
+  --hair-soft: light-dark(#E5E5EA, rgba(255, 255, 255, 0.06));
+  /* Primary accent — Apple system blue (dark variant brighter) */
+  --ai: light-dark(#005EBB, #0A84FF);
+  --ai-ink: light-dark(#0058B0, #409CFF);
+  --ai-wash: light-dark(#E5F0FB, rgba(10, 132, 255, 0.16));
+  /* Seal — Apple system red */
+  --shu: light-dark(#FF3B30, #FF453A);
+  --shu-wash: light-dark(#FFEAE8, rgba(255, 69, 58, 0.16));
+  /* Accent — Apple system orange */
+  --ochre: light-dark(#FF9F0A, #FF9F0A);
+  --ochre-wash: light-dark(#FFF4E0, rgba(255, 159, 10, 0.16));
+  /* Code surface — Xcode dark in both modes (intentional editorial) */
+  --code-bg: light-dark(#1C1C1E, #0F0F0F);
+  --code-ink: light-dark(#F2F2F7, #F2F2F7);
+  --code-muted: #8E8E93;
+  --code-accent: #FF9F0A;
+  --code-green: #30D158;
+  --code-blue: #64D2FF;
+  /* Typography — SF system stack, identical */
+  --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 — AppKit corners, identical */
+  --r-sm: 8px;
+  --r-md: 10px;
+  --r-lg: 14px;
+  /* Shadows — small, diffuse, lifted, deeper on dark */
+  --shadow-sm: 0 1px 2px light-dark(rgba(0, 0, 0, 0.04), rgba(0, 0, 0, 0.30)),
+               0 0 0 0.5px light-dark(rgba(0, 0, 0, 0.04), rgba(0, 0, 0, 0.30));
+  --shadow-md: 0 4px 14px light-dark(rgba(0, 0, 0, 0.06), rgba(0, 0, 0, 0.40)),
+               0 1px 3px light-dark(rgba(0, 0, 0, 0.04), rgba(0, 0, 0, 0.30));
+  --shadow-lg: 0 12px 40px light-dark(rgba(0, 0, 0, 0.10), rgba(0, 0, 0, 0.50)),
+               0 2px 6px light-dark(rgba(0, 0, 0, 0.04), rgba(0, 0, 0, 0.30));
+  --shadow-xl: 0 20px 50px light-dark(rgba(0, 0, 0, 0.14), rgba(0, 0, 0, 0.60)),
+               0 4px 10px light-dark(rgba(0, 0, 0, 0.05), rgba(0, 0, 0, 0.32));
+  --shadow-2xl: 0 28px 70px light-dark(rgba(0, 0, 0, 0.20), rgba(0, 0, 0, 0.72)),
+                0 6px 14px light-dark(rgba(0, 0, 0, 0.06), rgba(0, 0, 0, 0.36));
+  /* Blur — vibrancy signature, identical */
+  --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, identical */
+  --duration-fast: 160ms;
+  --duration-normal: 220ms;
+  --duration-slow: 320ms;
+  --ease: cubic-bezier(0.25, 0.1, 0.25, 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(--ink);
+  --border-focus: var(--ai);
+  --interactive-hover: light-dark(rgba(0, 0, 0, 0.04), rgba(255, 255, 255, 0.06));
+  --interactive-active: light-dark(rgba(0, 0, 0, 0.08), 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: var(--code-green);
+  --feedback-warning: var(--ochre);
+  --feedback-error: var(--shu);
+  --info-default: var(--ai);
+  --info-subtle: var(--ai-wash);
+  --info-text: var(--ai-ink);
+  --success-default: light-dark(var(--code-green), #30D158);
+  --success-subtle: light-dark(rgba(48, 209, 88, 0.12), rgba(48, 209, 88, 0.16));
+  --success-text: light-dark(#0F6E22, #5FE37F);
+  --warning-default: var(--ochre);
+  --warning-subtle: var(--ochre-wash);
+  --warning-text: light-dark(#985000, #FFB340);
+  --error-default: var(--shu);
+  --error-subtle: light-dark(rgba(255, 59, 48, 0.12), rgba(255, 69, 58, 0.16));
+  --error-text: light-dark(#A8281F, #FF6961);
+  /* 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: 0.75rem;
+  --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 — AppKit identity */
+  --btn-radius: var(--r-md);
+  --card-radius: var(--r-lg);
+  --card-shadow: var(--shadow-sm);
+  --input-radius: var(--r-sm);
+  --modal-radius: var(--r-lg);
+  --tooltip-radius: var(--r-sm);
+}

package/public/themes/cupertino-dark/theme.css

@@ -0,0 +1,200 @@
+@charset "UTF-8";
+/* ============================================================
+   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.
+   ============================================================ */
+@import 'https://fonts.googleapis.com/css2?family=Caveat:wght@400;500;600;700&display=swap';
+:root, :root[data-theme=cupertino-dark] {
+  color-scheme: 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 */
+}

package/public/themes/cupertino-light/theme.css

@@ -0,0 +1,227 @@
+@charset "UTF-8";
+/* ============================================================
+   THEME — Cupertino (light)
+   -----------------------------------------------------------
+   Standalone file for `[data-theme="cupertino-light"]` consumers.
+   This is the ONE FILE users swap to reskin their site.
+   Replace this file with any other theme.css to change the
+   entire look & feel. Tokens only — no component CSS lives here.
+
+   TOKEN CONTRACT
+   -----------------------------------------------------------
+   Every theme MUST declare every variable in this file, even
+   if it sets it to a neutral value (e.g. --glow-md: 0 0 0 transparent;).
+   That's what guarantees a clean one-file swap.
+
+   Slots:
+     Surfaces : --paper, --paper-raised, --paper-sunk, --paper-glass
+     Ink      : --ink, --ink-soft, --ink-faint, --graphite, --muted
+     Lines    : --guide, --guide-soft, --hair, --hair-soft
+     Primary  : --ai, --ai-ink, --ai-wash           (system blue in cupertino)
+     Seal     : --shu, --shu-wash                    (system red)
+     Accent   : --ochre, --ochre-wash                (system orange / amber)
+     Code     : --code-bg/ink/muted/accent/green/blue
+     Type     : --font-display/script/serif/sans/mono
+     Radius   : --r-sm, --r-md, --r-lg
+     Shadow   : --shadow-sm, --shadow-md, --shadow-lg
+     Blur     : --blur-sm, --blur-md, --blur-lg     (vibrancy)
+     Glow     : --glow-sm, --glow-md, --glow-lg     (cupertino lifts, doesn't glow)
+     Motion   : --duration-fast, --duration-normal, --duration-slow, --ease
+   ============================================================ */
+@import 'https://fonts.googleapis.com/css2?family=Caveat:wght@400;500;600;700&display=swap';
+:root, :root[data-theme=cupertino-light] {
+  color-scheme: light;
+  /* Surfaces — AppKit panels */
+  --paper: #F5F5F7;
+  --paper-raised: #FFF;
+  --paper-sunk: #E9E9EC;
+  --paper-glass: rgba(255, 255, 255, 0.72);
+  /* Ink — warm black, never pure */
+  --ink: #1D1D1F;
+  --ink-soft: #3A3A3C;
+  --ink-faint: #66666B;
+  --graphite: #2C2C2E;
+  --muted: #6E6E73;
+  /* Hairlines / guides */
+  --guide: #D2D2D7;
+  --guide-soft: #E5E5EA;
+  --hair: #D2D2D7;
+  --hair-soft: #E5E5EA;
+  /* Primary accent — system blue */
+  --ai: #005EBB;
+  --ai-ink: #0058B0;
+  --ai-wash: #E5F0FB;
+  /* Seal — system red */
+  --shu: #FF3B30;
+  --shu-wash: #FFEAE8;
+  /* Accent — system orange / amber */
+  --ochre: #FF9F0A;
+  --ochre-wash: #FFF4E0;
+  /* Code surface — native Xcode dark */
+  --code-bg: #1C1C1E;
+  --code-ink: #F2F2F7;
+  --code-muted: #8E8E93;
+  --code-accent: #FF9F0A;
+  --code-green: #30D158;
+  --code-blue: #64D2FF;
+  /* Typography — 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 — AppKit corners */
+  --r-sm: 8px;
+  --r-md: 10px;
+  --r-lg: 14px;
+  /* Shadows — small, diffuse, lifted */
+  --shadow-sm: 0 1px 2px rgba(0, 0, 0, 0.04), 0 0 0 0.5px rgba(0, 0, 0, 0.04);
+  --shadow-md: 0 4px 14px rgba(0, 0, 0, 0.06), 0 1px 3px rgba(0, 0, 0, 0.04);
+  --shadow-lg: 0 12px 40px rgba(0, 0, 0, 0.10), 0 2px 6px rgba(0, 0, 0, 0.04);
+  /* Blur — vibrancy (Cupertino's signature) */
+  --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 */
+  --duration-fast: 160ms;
+  --duration-normal: 220ms;
+  --duration-slow: 320ms;
+  --ease: cubic-bezier(0.25, 0.1, 0.25, 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) — macOS faint ink overlay */
+  --interactive-hover: rgba(0, 0, 0, 0.04);
+  --interactive-active: rgba(0, 0, 0, 0.08);
+  /* 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 (macOS system green) */
+  --success-default: var(--code-green);
+  --success-subtle: rgba(48, 209, 88, 0.12);
+  --success-text: #0F6E22;
+  /* Status — warning (macOS system orange) */
+  --warning-default: var(--ochre);
+  --warning-subtle: var(--ochre-wash);
+  --warning-text: #985000;
+  /* Status — error (macOS system red) */
+  --error-default: var(--shu);
+  --error-subtle: rgba(255, 59, 48, 0.12);
+  --error-text: #A8281F;
+  /* ----------------------------------------------------------
+     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.
+     ---------------------------------------------------------- */
+  /* Space scale (rem for accessibility) */
+  /* 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 — 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;
+  /* Shadow — higher-elevation slots (AppKit floating surfaces) */
+  --shadow-xl: 0 20px 50px rgba(0, 0, 0, 0.14), 0 4px 10px rgba(0, 0, 0, 0.05);
+  --shadow-2xl: 0 28px 70px rgba(0, 0, 0, 0.20), 0 6px 14px rgba(0, 0, 0, 0.06);
+  /* Typography — base body font + key scale slots (SF Pro stack) */
+  --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;
+  /* ----------------------------------------------------------
+     OPTIONAL COMPONENT OVERRIDES (Feature 1.3)
+     -----------------------------------------------------------
+     Cupertino expresses AppKit UI: softly rounded controls,
+     diffuse card lift, larger panel radii. Overrides are
+     intentionally sparse — pick the ones that carry the
+     identity of the OS, leave the rest on library defaults.
+     ---------------------------------------------------------- */
+  --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 */
+}