tyrell-components 1.0.0-TC47 → 1.0.0-TC48

package/css/tyrell-theme.css

@@ -13,8 +13,8 @@
  *   <link rel="stylesheet" href=".../tyrell-theme.css">
  *
  *   :root {
- *     --ty-brand-hue: 200;        // teal. Try 260 indigo, 30 orange, 145 emerald.
- *     --ty-brand-chroma: 0.13;
+ *     --ty-primary-hue: 200;        // teal. Try 260 indigo, 30 orange, 145 emerald.
+ *     --ty-primary-chroma: 0.13;
  *   }
  *
  * =====================================================================
@@ -24,9 +24,9 @@
  * Every color in the library is one formula on five axes:
  *
  *     oklch(
- *       L = L-curve[shade] × flavor-l-factor            ← Tier 3 × Tier 5
- *       C = flavor-chroma  × saturation-curve[shade]    ← Tier 2 × Tier 4
- *       H = flavor-hue                                  ← Tier 2
+ *       L = L-curve[shade] × flavor-l-factor            ← Tier 2 × Tier 4
+ *       C = flavor-chroma  × saturation-curve[shade]    ← Tier 1 × Tier 3
+ *       H = flavor-hue                                  ← Tier 1
  *     )
  *
  * Pick a flavor (primary / success / warning / danger /
@@ -61,15 +61,15 @@
  *
  *   SECTION 1 — KNOBS
  *     The variables you might want to override. Six tiers from drop-in
- *     rebrand (Tier 1) to surgical per-flavor tweak (Tier 5) plus solid
- *     buttons (Tier 6).
+ *     rebrand (Tier 1) to surgical per-flavor tweak (Tier 4) plus solid
+ *     buttons (Tier 5).
  *
  *   SECTION 2 — IMPLEMENTATION
  *     The oklch() expressions that wire the knobs through to the actual
  *     color tokens. Rarely needs editing — Section 1 is the contract.
  *
  * Browser support: oklch() is in every evergreen browser since mid-2023.
- * Tier 6 (solid) additionally uses OKLCH relative color — oklch(from …) —
+ * Tier 5 (solid) additionally uses OKLCH relative color — oklch(from …) —
  * which lands later: Chrome 119, Safari 16.4, Firefox 128 (mid-2024).
  * Solid fills have no fallback below those versions.
  *
@@ -83,59 +83,53 @@
  * these in your own `:root` (or `html.dark` for per-mode tuning) —
  * your declaration wins by source order.
  *
- *   Tier 1 — SEEDS                 brand-hue + chroma. Rebrand in 2 lines.
- *   Tier 2 — PER-FLAVOR ANCHORS    each flavor's hue + chroma.
- *   Tier 3 — L-CURVE               5 lightness stops for the emphasis ramp.
- *   Tier 4 — SATURATION CURVE      per-shade chroma multipliers.
- *   Tier 5 — PER-FLAVOR L-FACTOR   per-flavor lightness multiplier — push
+ *   Tier 1 — FLAVOR SEEDS          each flavor's hue + chroma, incl. primary.
+ *   Tier 2 — L-CURVE               5 lightness stops for the emphasis ramp.
+ *   Tier 3 — SATURATION CURVE      per-shade chroma multipliers.
+ *   Tier 4 — PER-FLAVOR L-FACTOR   per-flavor lightness multiplier — push
  *                                  one flavor up or down without touching
  *                                  the others. Default 1.
- *   Tier 6 — SOLID FILLS           solid-button system: hover/active/tone
+ *   Tier 5 — SOLID FILLS           solid-button system: hover/active/tone
  *                                  L offsets + per-theme dim/desaturate.
  * ===================================================================== */
 
 :root {
   /* ----------------------------------------------------------------
-   * Tier 1 — SEEDS
-   * Brand-hue + chroma drive primary, neutral, surfaces, inputs,
-   * solid buttons. One slider rebrands the page.
+   * Tier 1 — FLAVOR SEEDS
+   * Every flavor — including primary — is one hue + one chroma. No
+   * flavor derives from another; each is a standalone dial:
+   *   --ty-success-hue: 160;     (more teal)
+   *   --ty-warning-chroma: 0.2;  (more vivid)
+   * Rebrand by overriding --ty-primary-hue/-chroma alone; touch the
+   * others only when a specific flavor needs its own tuning.
    * --------------------------------------------------------------*/
 
-  --ty-brand-hue: 252;
-  --ty-brand-chroma: 0.08; /* restrained default; the loud 0.2 read as "bollywood" */
+  --ty-primary-hue: 252;
+  --ty-primary-chroma: 0.08; /* restrained default; the loud 0.2 read as "bollywood" */
 
-  /* Surface tint. 0 = monochrome surfaces (default, no brand leak).
-   * Bump to ~0.005 (light) / ~0.012 (dark) to warm surfaces toward brand. */
+  /* Surface tint. 0 = monochrome surfaces (default, no primary leak).
+   * Bump to ~0.005 (light) / ~0.012 (dark) to warm surfaces toward primary. */
   --ty-surface-chroma: 0;
 
-  /* ----------------------------------------------------------------
-   * Tier 2 — PER-FLAVOR ANCHORS
-   * Semantic colors (success/warning/danger/neutral) have their own
-   * hue + chroma seeds so they keep meaning across brand changes.
-   * Override any individually:
-   *   --ty-success-hue: 160;     (more teal)
-   *   --ty-warning-chroma: 0.2;  (more vivid)
-   * --------------------------------------------------------------*/
-
   --ty-success-hue: 145;
-  --ty-success-chroma: calc(var(--ty-brand-chroma) * 1.08);
+  --ty-success-chroma: 0.086;
 
   --ty-warning-hue: 76;
-  --ty-warning-chroma: calc(var(--ty-brand-chroma) * 2.22);
+  --ty-warning-chroma: 0.178;
 
   --ty-danger-hue: 31;
-  --ty-danger-chroma: calc(var(--ty-brand-chroma) * 1.95);
+  --ty-danger-chroma: 0.134;
 
-  /* Neutral is ACHROMATIC by default — greys do not follow the brand.
+  /* Neutral is ACHROMATIC by default — greys do not follow primary.
    * Most of an interface is monochrome; a rebrand should not drift it.
-   * To warm greys toward the brand (the pre-2026-08 behavior), opt in:
-   *   --ty-neutral-hue: var(--ty-brand-hue);
-   *   --ty-neutral-chroma: calc(var(--ty-brand-chroma) * 0.04); */
+   * To warm greys toward primary (the pre-2026-08 behavior), opt in:
+   *   --ty-neutral-hue: var(--ty-primary-hue);
+   *   --ty-neutral-chroma: 0.003; */
   --ty-neutral-hue: 0;
   --ty-neutral-chroma: 0;
 
   /* ----------------------------------------------------------------
-   * Tier 3 — L-CURVE (light mode)
+   * Tier 2 — L-CURVE (light mode)
    * 5 lightness stops per flavor for the emphasis ramp.
    * Lower L = darker = more emphasis in light mode.
    * Plus 3 bg L stops for the soft-tint backgrounds.
@@ -209,7 +203,7 @@
   --ty-focus-ring-alpha: 5%; /* focus ring mix strength (dark needs more) */
 
   /* ----------------------------------------------------------------
-   * Tier 4 — SATURATION CURVE
+   * Tier 3 — SATURATION CURVE
    * Per-shade chroma multipliers. Each shade's chroma =
    * flavor-chroma × multiplier. Drops near the extremes so
    * near-white and near-black can hold their tint.
@@ -222,13 +216,13 @@
   --ty-c-faint-mult: 0.46;
 
   /* ----------------------------------------------------------------
-   * Tier 5 — PER-FLAVOR L-FACTOR
+   * Tier 4 — PER-FLAVOR L-FACTOR
    * Multiplies the L-curve values for that flavor only. Default 1 =
-   * no change. Useful when one flavor's brand-default sits too close
-   * to brand-hue on the wheel and the buttons blend.
+   * no change. Useful when one flavor's hue sits too close to
+   * primary's on the wheel and the buttons blend.
    *
-   * Example: brand-hue: 47° (gold). Warning sits at 75° (amber).
-   * Both render as similar warm browns at brand-chroma. Drop warning
+   * Example: primary-hue: 47° (gold). Warning sits at 75° (amber).
+   * Both render as similar warm browns at that chroma. Drop warning
    * a notch and it darkens enough to stand apart:
    *   --ty-warning-l-factor: 0.85;
    *
@@ -238,24 +232,24 @@
    * light AND set its inverse (1 / factor, roughly) in `html.dark`.
    * --------------------------------------------------------------*/
 
-  --ty-primary-l-factor: 1;
+  --ty-primary-l-factor: 0.96;
   --ty-success-l-factor: 1;
   --ty-warning-l-factor: 1.3;
-  --ty-danger-l-factor: 1.01;
+  --ty-danger-l-factor: 0.93;
   --ty-neutral-l-factor: 1;
 
   /* ----------------------------------------------------------------
-   * Tier 6 — SOLID FILLS
+   * Tier 5 — SOLID FILLS
    * Solid buttons are their OWN system, not the emphasis ramp. Each
    * flavor's fill defaults to --ty-color-{flavor}; the knobs below
    * derive its hover / active / tone+ / tone- and per-theme adjust.
-   * Math lives in SECTION 2 (search "Tier 6 — SOLID"); these are the
+   * Math lives in SECTION 2 (search "Tier 5 — SOLID"); these are the
    * dials.
    *
    * Axis A — interaction & tone, OKLCH L offsets on the fill.
    * Axis B — per-theme adjust applied to the base fill (dim/desaturate).
    *
-   * NOTE: like Tier 5, the emphasis curve flips for dark, so these L
+   * NOTE: like Tier 4, the emphasis curve flips for dark, so these L
    * offsets are sign-flipped in `html.dark` below (darken in light =
    * lighten in dark). Keep the two blocks in sync.
    * --------------------------------------------------------------*/
@@ -284,26 +278,27 @@
 }
 
 /* Dark mode overrides for the L-curve and saturation curve, plus Tier 1
- * (brand-hue/chroma), Tier 2 (per-flavor hue/chroma) and Tier 5 (l-factor)
- * — dark ships its own distinct brand/semantic tuning here, not a
+ * (per-flavor hue/chroma, incl. primary) and Tier 4 (l-factor)
+ * — dark ships its own distinct flavor tuning here, not a
  * carry-through of :root's light values. */
 html.dark,
 html[data-theme="dark"],
 [data-ty-theme].dark,
 [data-ty-theme][data-theme="dark"] {
+  --ty-primary-l-factor: 1;
   --ty-solid-fg-threshold: 0.5 !important;
-  --ty-brand-hue: 233;
-  --ty-brand-chroma: 0.095;
+  --ty-primary-hue: 226;
+  --ty-primary-chroma: 0.065;
   --ty-success-hue: 129;
-  --ty-success-chroma: calc(var(--ty-brand-chroma) * 1.42);
+  --ty-success-chroma: 0.092;
   --ty-success-l-factor: 1.09;
   --ty-danger-hue: 13;
-  --ty-danger-chroma: calc(var(--ty-brand-chroma) * 1.96);
+  --ty-danger-chroma: 0.101;
   --ty-danger-l-factor: 1.06;
   --ty-warning-hue: 82;
-  --ty-warning-chroma: calc(var(--ty-brand-chroma) * 3);
+  --ty-warning-chroma: 0.195;
   --ty-warning-l-factor: 1.5;
-  /* Tier 3 dark — inverted curve. Higher L = lighter text = more
+  /* Tier 2 dark — inverted curve. Higher L = lighter text = more
    * emphasis on a dark background. */
   --ty-l-strong: 0.72;
   --ty-l-bold: 0.66;
@@ -349,12 +344,12 @@ html[data-theme="dark"],
   --ty-l-bg-neutral-faint: 0.15;
   --ty-c-bg-neutral-faint-mult: 2;
 
-  /* Tier 5 dark — neutral inks pulled down a notch against dark surfaces. */
+  /* Tier 4 dark — neutral inks pulled down a notch against dark surfaces. */
   --ty-neutral-l-factor: 0.8;
 
   --ty-focus-ring-alpha: 20%;
 
-  /* Tier 4 dark — dim shades hold more chroma so they don't grey out;
+  /* Tier 3 dark — dim shades hold more chroma so they don't grey out;
    * strong shades trim chroma so bright tones don't over-pop. */
   --ty-c-strong-mult: 0.77;
   --ty-c-bold-mult: 1;
@@ -362,7 +357,7 @@ html[data-theme="dark"],
   --ty-c-soft-mult: 0.77;
   --ty-c-faint-mult: 0.5;
 
-  /* Tier 6 dark — interaction offsets flip sign (press LIGHTENS on dark),
+  /* Tier 5 dark — interaction offsets flip sign (press LIGHTENS on dark),
    * and the per-theme adjust dims + desaturates the fills against the
    * dark canvas. (Computed solid tokens are declared once at html:root.) */
   /* Bigger than light mode's 0.04/0.08: small L deltas at the dark end of
@@ -401,8 +396,8 @@ html[data-theme="dark"],
  * Formulas are declared ONCE, at `html:root` (specificity 0,1,1 — NOT
  * plain `:root` (0,1,0)): they out-rank tyrell.css's hardcoded light
  * tokens by specificity and its hardcoded `html.dark` hexes (0,1,1) by
- * source order, since the brand layer loads after. Dark mode needs no
- * formula duplicates — the dials they read (Tier 3/4, SECTION 1) are
+ * source order, since the theme layer loads after. Dark mode needs no
+ * formula duplicates — the dials they read (Tier 2/3, SECTION 1) are
  * what flip per mode. The `html.dark` block at the END of this file
  * holds only genuine per-mode DATA (surface ladder, hand-pinned
  * absolutes) — never formulas. If you add a token here, do NOT mirror
@@ -418,8 +413,8 @@ html:root,
    * ramp formula reads that seed's c + h channels via relative color
    * syntax; L always comes from the mode-flipped curve. Two ways in:
    *
-   *   numbers (default) — the Tier 1/2 hue+chroma dials construct the
-   *   seed:      --ty-brand-hue: 200; --ty-brand-chroma: 0.13;
+   *   numbers (default) — the Tier 1 hue+chroma dials construct the
+   *   seed:      --ty-primary-hue: 200; --ty-primary-chroma: 0.13;
    *
    *   a color   — set the seed directly and the dials are bypassed:
    *              --ty-primary-seed: #76467c;
@@ -444,10 +439,10 @@ html:root,
    *   - l-factor points rather than shoves: it moves the ink a little,
    *     and only alpha × that movement reaches the tint.
    *
-   * The wash amount is the --ty-a-bg-* dials (Tier 3 area). */
+   * The wash amount is the --ty-a-bg-* dials (Tier 2 area). */
   --ty-primary-seed-resolved: var(
     --ty-primary-seed,
-    oklch(0.5 var(--ty-brand-chroma) var(--ty-brand-hue))
+    oklch(0.5 var(--ty-primary-chroma) var(--ty-primary-hue))
   );
   --ty-success-seed-resolved: var(
     --ty-success-seed,
@@ -659,7 +654,7 @@ html:root,
   );
 
   /* ----------------------------------------------------------------
-   * Global neutral borders — own family, own L ladder (Tier 3).
+   * Global neutral borders — own family, own L ladder (Tier 2).
    * Tinted by the neutral seeds like everything grey, but NOT tied to
    * the text emphasis curve or --ty-neutral-l-factor. Per-flavor
    * accent borders (--ty-border-{flavor}) stay ink aliases — a colored
@@ -683,7 +678,7 @@ html:root,
 
   /* ----------------------------------------------------------------
    * Text ladder + surface borders — engine-wired versions of tokens
-   * tyrell.css hardcodes as hexes. Own L dials (Tier 3), neutral
+   * tyrell.css hardcodes as hexes. Own L dials (Tier 2), neutral
    * hue/chroma tint. These out-rank the base hexes the same way every
    * other token here does; a rebrand now reaches body text too.
    * --------------------------------------------------------------*/
@@ -738,7 +733,7 @@ html:root,
   );
 
   /* ----------------------------------------------------------------
-   * Inputs — tied to neutral ramp so form controls retint with brand.
+   * Inputs — tied to neutral ramp so form controls retint with primary.
    * --------------------------------------------------------------*/
   --ty-input-bg: var(--ty-surface-input);
   --ty-input-color: var(--ty-color-neutral-strong);
@@ -757,10 +752,10 @@ html:root,
 }
 
 /* ----------------------------------------------------------------
- * Tier 6 — SOLID (implementation)
+ * Tier 5 — SOLID (implementation)
  * Solid is its OWN system, NOT the text/emphasis ramp. The dials
  * (--ty-solid-hover-l / -active-l / -strong-l / -soft-l and
- * --ty-solid-l / -c / -h) live in SECTION 1, Tier 6. Below is the
+ * --ty-solid-l / -c / -h) live in SECTION 1, Tier 5. Below is the
  * derivation only: base fill bakes in the per-theme adjust (Axis B);
  * hover/active/strong/soft offset the base by Axis A. Override any
  * single --ty-solid-{flavor}-{state} to recolor just that segment.
@@ -768,8 +763,8 @@ html:root,
  * Declared at `html:root` (specificity 0,1,1) — NOT plain `:root` (0,1,0) —
  * on purpose: it must out-rank tyrell.css's hardcoded dark solids at
  * `html.dark` (0,1,1). It wins light by specificity over base's `html{}`,
- * and wins dark by source order over base's `html.dark` (brand loads after).
- * That's what lets dark solids re-tint with --ty-brand-hue. Declared ONCE —
+ * and wins dark by source order over base's `html.dark` (theme layer loads after).
+ * That's what lets dark solids re-tint with --ty-primary-hue. Declared ONCE —
  * the oklch(from var(--ty-color-*)) formulas resolve per-mode automatically,
  * so no dark duplicate is needed.
  * --------------------------------------------------------------*/
@@ -806,7 +801,7 @@ html:root,
    * SOLID FOREGROUNDS — auto-contrast.
    *
    * Each fill gets a foreground picked from its OWN lightness, so a
-   * rebrand (--ty-brand-hue / --ty-brand-chroma / any L-curve override)
+   * rebrand (--ty-primary-hue / --ty-primary-chroma / any L-curve override)
    * can't strand white text on a pale fill. Branchless, no JS:
    *
    *   clamp(0, (threshold - l) * 1000, 1)  ->  1 (white) when the fill
@@ -993,15 +988,15 @@ html:root,
  * work, switches just snap (the pre-TC37 behavior).
  * ===================================================================== */
 
-@property --ty-brand-hue {
+@property --ty-primary-hue {
   syntax: "<number>";
   inherits: true;
-  initial-value: 45;
+  initial-value: 252;
 }
-@property --ty-brand-chroma {
+@property --ty-primary-chroma {
   syntax: "<number>";
   inherits: true;
-  initial-value: 0.125;
+  initial-value: 0.08;
 }
 @property --ty-surface-chroma {
   syntax: "<number>";
@@ -1378,20 +1373,21 @@ html:root,
   html,
   [data-ty-theme] {
     transition-property:
-      --ty-brand-hue, --ty-brand-chroma, --ty-surface-chroma, --ty-success-hue,
-      --ty-success-chroma, --ty-warning-hue, --ty-warning-chroma,
-      --ty-danger-hue, --ty-danger-chroma, --ty-neutral-hue,
-      --ty-neutral-chroma, --ty-l-strong, --ty-l-bold, --ty-l-base, --ty-l-soft,
-      --ty-l-faint, --ty-a-bg-base, --ty-a-bg-bold, --ty-a-bg-soft,
-      --ty-l-text-strong, --ty-l-text-bold, --ty-l-text-base, --ty-l-text-soft,
-      --ty-l-text-faint, --ty-l-border-content, --ty-l-border-elevated,
-      --ty-l-border-floating, --ty-l-border-strong, --ty-l-border-bold,
-      --ty-l-border, --ty-l-border-soft, --ty-l-border-faint,
-      --ty-l-surface-canvas, --ty-l-surface-content, --ty-l-surface-elevated,
-      --ty-l-surface-floating, --ty-l-surface-input, --ty-l-solid-neutral,
-      --ty-l-solid-neutral-strong, --ty-l-bg-neutral-strong,
-      --ty-l-bg-neutral-faint, --ty-c-bg-neutral-faint-mult, --ty-c-strong-mult,
-      --ty-c-bold-mult, --ty-c-base-mult, --ty-c-soft-mult, --ty-c-faint-mult,
+      --ty-primary-hue, --ty-primary-chroma, --ty-surface-chroma,
+      --ty-success-hue, --ty-success-chroma, --ty-warning-hue,
+      --ty-warning-chroma, --ty-danger-hue, --ty-danger-chroma,
+      --ty-neutral-hue, --ty-neutral-chroma, --ty-l-strong, --ty-l-bold,
+      --ty-l-base, --ty-l-soft, --ty-l-faint, --ty-a-bg-base, --ty-a-bg-bold,
+      --ty-a-bg-soft, --ty-l-text-strong, --ty-l-text-bold, --ty-l-text-base,
+      --ty-l-text-soft, --ty-l-text-faint, --ty-l-border-content,
+      --ty-l-border-elevated, --ty-l-border-floating, --ty-l-border-strong,
+      --ty-l-border-bold, --ty-l-border, --ty-l-border-soft,
+      --ty-l-border-faint, --ty-l-surface-canvas, --ty-l-surface-content,
+      --ty-l-surface-elevated, --ty-l-surface-floating, --ty-l-surface-input,
+      --ty-l-solid-neutral, --ty-l-solid-neutral-strong,
+      --ty-l-bg-neutral-strong, --ty-l-bg-neutral-faint,
+      --ty-c-bg-neutral-faint-mult, --ty-c-strong-mult, --ty-c-bold-mult,
+      --ty-c-base-mult, --ty-c-soft-mult, --ty-c-faint-mult,
       --ty-primary-l-factor, --ty-success-l-factor, --ty-warning-l-factor,
       --ty-danger-l-factor, --ty-neutral-l-factor, --ty-primary-solid-l,
       --ty-success-solid-l, --ty-warning-solid-l, --ty-danger-solid-l,

package/css/tyrell.css

@@ -1369,3 +1369,22 @@ RESPONSIVE VARIANTS
     --ty-font-sm: 1rem;
   }
 }
+
+/* =================================================================
+   MODAL BACKDROP ZOOM (opt-in)
+   While any <ty-modal backdrop-zoom open> is open, the component toggles
+   .ty-modal-zoom on <html> and the page body scales down slightly
+   (Vaul/shadcn-style). The modal itself renders in the top layer, which
+   escapes ancestor transforms — only the page behind it moves.
+   Caveat: a scaled <body> becomes the containing block for position:fixed
+   descendants — apps with fixed headers/sidebars should not use backdrop-zoom.
+================================================================= */
+
+body {
+  transition: scale var(--ty-modal-duration, 200ms) ease-out;
+}
+
+html.ty-modal-zoom body {
+  scale: 0.99;
+  transform-origin: 50% 50%;
+}