@mkbabb/glass-ui 4.0.0 → 4.1.0

package/src/styles/theme/bridges.css

@@ -47,6 +47,9 @@
 
     /* Letter spacing → tracking-* utilities */
     --tracking-tight:  var(--type-tracking-tight);
+    /* BB.W-DISPLAY-TRACKING — the display-ONLY Apple −1.5% tracking rung bridged
+       to the `tracking-display` utility (the token-first consumer affordance). */
+    --tracking-display: var(--type-tracking-display);
     --tracking-snug:   var(--type-tracking-snug);
     --tracking-normal: var(--type-tracking-normal);
     --tracking-wide:   var(--type-tracking-wide);
@@ -219,6 +222,14 @@
     --color-silver-dark: var(--silver-dark);
     --color-silver-deep: var(--silver-deep);
 
+    /* BB.W-METAL-SHIMMER — the bronze brand metal (the third member of the
+       gold·silver·bronze triad; the @theme namespace bridge so a `text-bronze`/
+       `bg-bronze` utility resolves through, mirroring gold/silver). */
+    --color-bronze: var(--bronze);
+    --color-bronze-light: var(--bronze-light);
+    --color-bronze-dark: var(--bronze-dark);
+    --color-bronze-deep: var(--bronze-deep);
+
     --color-rainbow-red:    var(--rainbow-red);
     --color-rainbow-orange: var(--rainbow-orange);
     --color-rainbow-yellow: var(--rainbow-yellow);
@@ -304,6 +315,14 @@
     --shadow-cartoon-md: var(--cartoon-shadow-md);
     --shadow-cartoon-lg: var(--cartoon-shadow-lg);
 
+    /* BC.W-CONTROL-SMOOTH — the warm focus-ring box-shadow bridged to the
+       `shadow-focus-ring` utility (AW.W26 --focus-ring-shadow register). The
+       `.focus-ring` utility auto-arms on :focus-visible; this bridge lets a
+       surface compose the SAME warm ring on a NON-:focus-visible state (the
+       TagsInputItem reka roving-tabindex `data-[state=active]` selection) via the
+       @theme utility, not a `shadow-[var(--focus-ring-shadow)]` arbitrary wrap. */
+    --shadow-focus-ring: var(--focus-ring-shadow);
+
     /* ═══════════════════════════════════════════════
        Blur → blur-* and backdrop-blur-* utilities
        ═══════════════════════════════════════════════ */
@@ -321,6 +340,15 @@
     --ease-spring-snappy: var(--spring-snappy);
     --ease-spring-bouncy: var(--spring-bouncy);
     --ease-spring-gentle: var(--spring-gentle);
+    /* BC.W-SPRING-EASE — the minted iOS interactive press register's @theme alias
+       (the documented public register the consumers reach by name; the JS path
+       reads it via useSpringPress + --glass-btn-press-t). */
+    --ease-spring-press: var(--spring-press);
+    /* BC.W-DECK — the deck slide-transition spring's @theme alias (the documented
+       public register a consumer's slide `transition-timing-function` reaches by
+       name: `ease-spring-deck`). --spring-deck aliases --spring-smooth; the headless
+       library mints the register, the deck consumer reads it (presets-in-consumers). */
+    --ease-spring-deck: var(--spring-deck);
 
     --ease-standard: var(--motion-ease-standard);
     --ease-out: var(--motion-ease-out);
@@ -341,6 +369,11 @@
     --transition-duration-panel: var(--duration-panel);
     --transition-duration-xl: var(--duration-xl);
     --transition-duration-xxl: var(--duration-xxl);
+    /* BC.W-CONTROL-SMOOTH — the named iOS control-press surface beat (0.12s, the
+       calm bg/color/box-shadow cross-fade clock the `.control-surface`/Toggle
+       family rides). Bridged to the `duration-control` utility so a control
+       composes the named clock, not a `duration-[var(--duration-control)]` wrap. */
+    --transition-duration-control: var(--duration-control);
     /* BA.W-GLASS-CAL — `--transition-duration-sparkle` bridge DELETED with the
        `--duration-sparkle` token (the disco retirement); no `duration-sparkle`
        utility consumer. */

package/src/styles/theme/literals.css

@@ -30,10 +30,19 @@
        band-pass vs one-pass sweep) want different tempos. The pre-V audit
        (C-c §5.3) flagged this as a "naming inversion"; it is intentional —
        documented here so the offset is searchable. The orphan
-       `--duration-shimmer-slow` (8s) was excised in V.W2 T5. */
+       `--duration-shimmer-slow` (8s) was excised in V.W2 T5.
+
+       BB.W-METAL-SHIMMER — `--animate-gold-shimmer` re-points onto the metal-
+       PARAMETERIZED `metal-shimmer-sweep` keyframe (the gold-only
+       `gold-shimmer-slide` RETIRED — clean break, no alias); the duration/tempo
+       are byte-preserved (the gold READ unchanged). `--animate-metal` is the
+       brand-metal family's own row on the slow `--duration-metal` (6s) clock — the
+       `.metal-{gold,silver,bronze}`/`.metal-*-border`/`.metal-rainbow-rim`
+       utilities read it (utilities/metal.css). */
     --animate-shimmer: shimmer var(--duration-shimmer-fast) linear infinite;
     --animate-shimmer-sweep: shimmer-sweep var(--duration-shimmer) ease-in-out infinite;
-    --animate-gold-shimmer: gold-shimmer-slide var(--duration-shimmer) linear infinite;
+    --animate-gold-shimmer: metal-shimmer-sweep var(--duration-shimmer) linear infinite;
+    --animate-metal: metal-shimmer-sweep var(--duration-metal) linear infinite;
     --animate-shake: shake 0.5s ease-in-out;
 
     /* ═══════════════════════════════════════════════

package/src/styles/theme/radius.css

@@ -42,9 +42,26 @@
        on Checkbox + base Tabs onto a softer, named radius. One geometry language
        across the form family — token + class only, no new primitive. */
     --radius-field:   var(--radius-2xl);
-    --radius-control: var(--radius-md);
+    /* BC.W-CONTROL-SMOOTH — the small-inline-control corner rung is a STADIUM, not a
+       fixed small px. The prior `--radius-md` (6px) read SQUARE on a 16-24px control
+       (6px on a 16px box = 0.38-of-height — a rounded-rect, not a pill); the iOS-27
+       small-control silhouette is a near-stadium pill where the radius SCALES with the
+       control (clamped to half-height by `--radius-pill`'s 9999px geometry, so a 16px
+       control reads an 8px-radius pill — soft at every size). This retires the raw
+       `rounded-sm` (4px) on Checkbox + base Tabs AND the small-control square class in
+       ONE rung. The `card` toggle TILE keeps `--radius-card` (the large glass surface
+       keeps its 1rem squircle — only the small inline controls re-round). The corner-
+       SHAPE squircle axis reads at LARGE radius only (ROUND set = card+pill for small),
+       so the small pills stay ROUND (no regression). */
+    --radius-control: var(--radius-pill);
     --radius-badge:   var(--radius-pill);
     --radius-dock:    var(--radius-pill);
+    /* BC.W-TABS-IOS — the iOS-27 segmented-control stadium register. The pill is a
+       stadium by construction (--radius-pill clamps to half-height on a short box →
+       a true end-cap), so the tab strip stops being a squared rounded-rect. The
+       value.js DESIGN.md idiom: the role-bearing pill token, NOT a hand-rolled
+       `rounded-full`. A consumer retunes the tab geometry via `:root { --radius-tab }`. */
+    --radius-tab:     var(--radius-pill);
     /* AW.W3b — the big-dock card shell's default (comfortable-density) radius.
        The density-scaled --dock-card-radius (dock.css) resolves through this. */
     --radius-dock-card: var(--radius-3xl);
@@ -64,7 +81,12 @@
        |x|^(2K) + |y|^(2K) = 1, so the curve exponent n = 2K. The CSS `squircle`
        keyword == `superellipse(2)` == n=4 — the iOS-idiomatic web squircle. The
        k-PRIMITIVE band (a consumer dials 1.7–2.4 to taste; W42's dock-morph calc()s
-       its animated k against this ONE vocabulary — do not re-define a second k). */
+       its animated k against this ONE vocabulary — do not re-define a second k).
+       (BB.W-DEAD-SWEEP re-ground: --corner-k-soft / --corner-k-sharp have no
+       runtime var() consumer but ARE pinned by proof:squircle-language (the
+       TOKEN-AXIS-EXISTS clause asserts both rungs are minted) — so KEPT, not
+       swept; the clean-break delete is a coordination follow-up once the gate
+       re-anchors.) */
     --corner-k-squircle: 2;   /* the squircle — superellipse(2), n=4               */
     --corner-k-soft:     1.7; /* gentler, between round and squircle — n≈3.4       */
     --corner-k-sharp:    2.4; /* crisper square-bias for large surfaces — n≈4.8    */

package/src/styles/tokens/color-radius.css

@@ -121,6 +121,16 @@
        `--border` (which is `var(--neutral-4)`, light-dark()-resolved). */
     --border-soft: color-mix(in srgb, var(--border) 45%, transparent);
 
+    /* BC.W-SEPARATOR-FIX — the warm separator hairline ink. A rule reads as
+       WARM material, not a grey `--border` line (BA.W-NO-GRAY floor): the
+       split-rule segments + un-labelled hairline both paint `--separator-ink`.
+       It is a `color-mix` off `--foreground` (`light-dark()`-resolved, so it
+       auto-darks warm in both modes — the warm-ink hairline, not `--neutral-4`
+       grey). 22% is a visible-but-whisper rule (crisper than `--border-soft`'s
+       45%-of-grey; this one is foreground-derived so it carries the warm hue
+       directly). A consumer retints every separator from this single rung. */
+    --separator-ink: color-mix(in srgb, var(--foreground) 22%, transparent);
+
     /* AQ.W3 §W3.4 — tokenized scrollbar thumb + track. Minted in the color
        block so the `scrollbar-color` / `::-webkit-scrollbar-thumb` rungs read a
        single source. Auto-dark via `--muted-foreground` (light-dark()-resolved,
@@ -224,9 +234,9 @@
        keyframes.js ω₀ = 2π/response convention, mints no second ω). */
     --constellation-warp-response:    0.55;   /* s — keyframes.js angular period (NOT a settle) */
     --constellation-warp-zeta:        1.0;    /* critically damped — a focal mark must NOT ring */
-    --constellation-well-gain:        14000;  /* inverse-square force scale (the held-pull gain) */
+    --constellation-well-gain:        19000;  /* inverse-square force scale (the held-pull gain). Lifted 14000→19000 (BC.W-VIZ-CONSTELLATION): the GPU substrate's high-refresh frame loop ramps the held strength to only ~0.70 within the egg-live π perturb window, so the weaker effective force (fought by the |v|→speed ease-back) fell under the gate's ≥20% perturb floor — a stronger pull restores the heat. Held-physics only; rest is byte-untouched. Mirrors DEFAULT_WELL_CONFIG.gain. */
     --constellation-well-reach:       340;    /* base-width px — the well's reach (k-scaled at step) */
-    --constellation-well-ramp:        4.0;    /* 1/s — the ARM rate (≈0.25s bloom; release is the fixed brisk WELL_RELEASE_RAMP — the field-cools invariant, not consumer-tunable) */
+    --constellation-well-ramp:        8.0;    /* 1/s — the ARM rate. Doubled 4→8 (BC.W-VIZ-CONSTELLATION) so the strength reaches near-full power within the gate's 40-frame perturb window at the GPU substrate's high refresh (~0.12s bloom); release is the fixed brisk WELL_RELEASE_RAMP — the field-cools invariant, not consumer-tunable. Mirrors DEFAULT_WELL_CONFIG.ramp. */
     --constellation-well-max-speed:   4.0;    /* base-width px/frame cap — the no-slingshot clamp */
     --constellation-well-hold-ms:     140;    /* ms hold before the well arms */
     --constellation-wander-idle:      8000;   /* ms — min idle between auto re-targets (the W-CON1 drift cadence) */
@@ -243,7 +253,7 @@
     --section-color-2:  oklch(0.484 0.163 265.5);  /* indigo     */
     --section-color-3:  oklch(0.542 0.089 222.8);  /* teal-cyan  */
     --section-color-4:  oklch(0.551 0.088 171.1);  /* forest     */
-    --section-color-5:  oklch(0.623 0.124 69.6);   /* amber      */
+    --section-color-5:  oklch(0.530 0.124 69.6);   /* amber — BC.W-ACCENT-TONE #13: the safeAccentColor-derived rebaseline (HEAD 0.623 → 0.530, 3.49:1 → 5.11:1 vs the warm-cream card; the dark arm already clears 8.07:1 so it stays). --viz-amber auto-tracks; fourier's :root override deletes on adopt. */
     --section-color-6:  oklch(0.579 0.201 30.4);   /* tomato-red */
     --section-color-7:  oklch(0.532 0.180 317.5);  /* violet     */
     --section-color-8:  oklch(0.520 0.176 8.4);    /* ruby       */

package/src/styles/tokens/dark-arm.css

@@ -57,7 +57,17 @@
        --accent{,-foreground} / --border / --input are pure var()-aliases —
        DELETED here (AQ.W2 §2a): they auto-track the --neutral-* ladder +
        --foreground above. Re-declaring them would be redundant. */
-    --foreground: hsl(48 10% 90%);
+    /* BB.W-DARK-INK-WARM — the dark --foreground warmed off hsl(48 10% 90%) (OKLab H95.1°,
+       the EXACT yellow-green W-NO-GRAY condemned as "a cast, not warm material") onto the
+       no-gray warm identity hsl(30 14% 90%) (OKLab L0.926 C0.0063 H75.4° — the --foreground
+       56° warm-amber family, L held within ±0.001 of HEAD, chroma off the gray floor,
+       chroma-only at constant L). The contrast contract holds (the dark ink over the L4 page
+       stays ≥ the body floor). EVERY dark var(--foreground) consumer (body copy, the lifted
+       muted register, --glass-tint-ink, the cartoon shadow, the configurator divider, the
+       dock-selected-accent, the --surface-tint-* relative-color recipe below) re-resolves
+       warm in lockstep, zero per-site edit. LOCKSTEP light-dark.css:92 (the §2c discipline —
+       both mode arms warm together or the FOUC/enhancement split paints two inks). */
+    --foreground: hsl(30 14% 90%);
     /* BA.W-DARK-MATERIAL scope 1 — the --card plate LIFTS L10→L16 (a warm-dark elevated
        surface, macOS-window territory) so it sits ~5× the deepened L4 page relL — a
        clearly distinct surface the five glass rungs ladder up from. LOCKSTEP light-dark.css:80. */
@@ -190,15 +200,27 @@
     --constellation-edge-floor:          0;
     --constellation-edge-accent-alpha:   0.34;
 
-    /* Glass opacity + grain for dark — five-tier ladder, alpha-monotonic.
-       Each rung lifts ~0.08 from its light counterpart so the dark surfaces
-       carry comparable read-weight against the deeper canvas. */
+    /* Glass opacity + grain for dark — the per-tier canonical alpha, DARK arm
+       (BB.W-CARD-TIER-ALPHA). The SAME named `--glass-opacity-{tier}` register as
+       the light arm (tokens/glass.css), per-mode — the dark identity. Five-tier
+       ladder, alpha-monotonic; each rung lifts ~0.08 from its light counterpart so
+       the dark surfaces carry comparable read-weight against the deeper canvas. A
+       consumer reads these named tokens; a divergent register stays a consumer preset.
+       Machine-locked by `proof:card-tier-alpha` (the dark-arm-present + monotonic +
+       lift-over-light asserts). */
     --glass-opacity-wash:     0.38;
     --glass-opacity-quiet:    0.58;
     --glass-opacity-resting:  0.72;
     --glass-opacity-floating: 0.88;
     --glass-opacity-overlay:  0.96;
     --glass-opacity-chassis:  0.36;
+    /* BC.W-DIALOG-GLASS — the dialog dark register lifts ~0.08 over the light arm
+       (0.68 → 0.76) for read-weight over the deep canvas, mirroring the dark opacity
+       ladder (it sits between dark `resting` 0.72 and `floating` 0.88 — see-through
+       but legible over the deep page). The SAME named token as the light arm, per-
+       mode; the composed `--glass-bg-dialog` (glass.css :root) re-resolves from it
+       automatically per mode. */
+    --glass-opacity-dialog:   0.76;
     --glass-grain-opacity: 0.045;
     --glass-highlight: inset 0 0.5px 0 0 hsl(0 0% 100% / 0.08);
 
@@ -210,14 +232,46 @@
        aurora/page behind reads with chroma + a glow. The blur() RADIUS is the
        light-arm primitive UNTOUCHED (W-GLASS-CAL owns the radius dial-back) — only the
        saturate/brightness COMPANIONS lift here. The lower rungs lift more (they're
-       thinner, the backdrop carries the read); the heavy overlay lifts least. */
-    --glass-blur-wash:     blur(calc(var(--glass-blur-wash-radius) * var(--glass-level))) saturate(1.35) brightness(1.18);
-    --glass-blur-quiet:    blur(calc(var(--glass-blur-quiet-radius) * var(--glass-level))) saturate(1.35) brightness(1.16);
-    --glass-blur-resting:  blur(calc(var(--glass-blur-resting-radius) * var(--glass-level))) saturate(1.30) brightness(1.14);
-    --glass-blur-floating: blur(calc(var(--glass-blur-floating-radius) * var(--glass-level))) saturate(1.28) brightness(1.10);
-    --glass-blur-overlay:  blur(calc(var(--glass-blur-overlay-radius) * var(--glass-level))) saturate(1.22) brightness(1.06);
+       thinner, the backdrop carries the read); the heavy overlay lifts least.
+
+       BC.W-GLASS-LEGIBILITY-MEASURED — the per-rung `--glass-saturate-{tier}` knob
+       (the speedtest-AX BC-W10 fold) is the SAME named register as the light arm
+       (tokens/glass.css), per-mode — the dark identity. The dark values ARE this
+       scope's luminosity lift (wash/quiet 1.35, resting 1.30, floating 1.28, overlay
+       1.22) become the dark token defaults, and each `--glass-blur-{tier}` reads
+       `saturate(var(--glass-saturate-{tier}))` THROUGH — so a `.dark` override re-
+       resolves the rung saturation with ZERO recipe edit, AND the composed dark blur
+       is BYTE-IDENTICAL to the old baked literal. The `brightness()` companions stay
+       baked (this fold mints ONLY the saturate knob). The dark dock/deep saturate stay
+       baked (off-ladder footprint rungs, not part of the {wash..overlay} ladder).
+       Machine-locked by `proof:glass-legibility` L7. */
+    --glass-saturate-wash:     1.35;
+    --glass-saturate-quiet:    1.35;
+    --glass-saturate-resting:  1.30;
+    --glass-saturate-floating: 1.28;
+    --glass-saturate-overlay:  1.22;
+    --glass-blur-wash:     blur(calc(var(--glass-blur-wash-radius) * var(--glass-level))) saturate(var(--glass-saturate-wash)) brightness(1.18);
+    --glass-blur-quiet:    blur(calc(var(--glass-blur-quiet-radius) * var(--glass-level))) saturate(var(--glass-saturate-quiet)) brightness(1.16);
+    --glass-blur-resting:  blur(calc(var(--glass-blur-resting-radius) * var(--glass-level))) saturate(var(--glass-saturate-resting)) brightness(1.14);
+    --glass-blur-floating: blur(calc(var(--glass-blur-floating-radius) * var(--glass-level))) saturate(var(--glass-saturate-floating)) brightness(1.10);
+    --glass-blur-overlay:  blur(calc(var(--glass-blur-overlay-radius) * var(--glass-level))) saturate(var(--glass-saturate-overlay)) brightness(1.06);
     --glass-blur-dock:     blur(calc(var(--glass-blur-dock-radius) * var(--glass-level))) saturate(1.30) brightness(1.12);
 
+    /* BB.W-DEEP-GLASS — the DARK arm of the OPT-IN deep tier (the luminous-dark
+       deep mirror, the W-DARK-MATERIAL scope-2 "dark glass glows where light
+       passes" model). The deep tier is even more transmissive in dark — the deep
+       dark glass glows MORE where the backdrop passes — so its saturate/brightness
+       companion lifts HARDER than the calm dark floating (1.28/1.10): the deep
+       arm carries saturate(1.55) brightness(1.16), in LOCKSTEP with the light deep
+       arm (which sits at saturate 1.5 / depth-LERPed, glass-deep.css). The RADIUS
+       is the SAME --glass-blur-deep-active-radius × --glass-level (radius-only
+       across modes, the §2c discipline — only the saturate/brightness companions
+       differ between light/dark). This is a SEPARATE deep token the calm dark
+       ladder never reads (CALM-UNCHANGED in dark too — proof:glass-cal GREEN). */
+    --glass-blur-deep:
+        blur(var(--glass-blur-deep-active-radius))
+        saturate(1.55) brightness(1.16);
+
     /* BA.W-DARK-MATERIAL scope 3 — the dark arm of the adaptive --glass-tint-* seam (the
        SAME seam, NO third fork). The W55 self-engage block (glass/ladder.css) re-points
        --glass-tint-source → --glass-tint-ink at --glass-tint-strength-aa. In LIGHT that is
@@ -242,28 +296,59 @@
        mode arms — the content-tier self-engage needs no mode branch. */
     --glass-tint-strength-floor: 12%;
 
-    /* BA.W-DARK-MATERIAL scope 5 — the --surface-tint-* dark arm. The light family is
-       color-mix(in srgb, var(--foreground) N%, transparent) — over a near-black dark card
-       a LIGHT-ink (dark --foreground IS light cream) tint composites to near-black: the
-       9-rung chip/hairline/divider scale is INVISIBLE in dark. The dark arm KEEPS the
-       in-srgb space (the AW.W26 fence — NEVER oklab) but re-anchors the mix ink to a
-       BRIGHTER warm off-white so a chip/hairline LIFTS off the deep card (the inverse
-       intent of light's dark-ink tint). This re-resolves every --surface-tint-* consumer
-       (chip backplates, the dock-rail divider, the spine, the timeline dot) in lockstep,
-       zero per-site edit. The brighter ink is a near-white warm (hsl(48 12% 96%)) so the
-       higher rungs read as genuine hairlines on the L16 card. */
-    --surface-tint-4:  color-mix(in srgb, hsl(48 12% 96%)  4%, transparent);
-    --surface-tint-6:  color-mix(in srgb, hsl(48 12% 96%)  6%, transparent);
-    --surface-tint-8:  color-mix(in srgb, hsl(48 12% 96%)  8%, transparent);
-    --surface-tint-10: color-mix(in srgb, hsl(48 12% 96%) 10%, transparent);
-    --surface-tint-12: color-mix(in srgb, hsl(48 12% 96%) 12%, transparent);
-    --surface-tint-15: color-mix(in srgb, hsl(48 12% 96%) 15%, transparent);
-    --surface-tint-18: color-mix(in srgb, hsl(48 12% 96%) 18%, transparent);
-    --surface-tint-22: color-mix(in srgb, hsl(48 12% 96%) 22%, transparent);
-    --surface-tint-25: color-mix(in srgb, hsl(48 12% 96%) 25%, transparent);
-    --surface-tint-35: color-mix(in srgb, hsl(48 12% 96%) 35%, transparent);
-    --surface-tint-40: color-mix(in srgb, hsl(48 12% 96%) 40%, transparent);
-    --surface-tint-70: color-mix(in srgb, hsl(48 12% 96%) 70%, transparent);
+    /* BB.W-ON-GLASS-FG — the surface-aware FOREGROUND register, DARK arm (the N13
+       whisper collapse where it bites hardest). The dark page-muted --neutral-5 (L62,
+       "AA: 7.64:1 vs page") COLLAPSES over the lifted luminous-dark plate (the L16 card
+       at the 12% --glass-tint-strength-floor composites the bright backdrop UP — the
+       measured 1.15-3.29:1). The on-glass muted rung lifts BRIGHTER (the mirror of the
+       light arm's darkening) so it clears AA over the composited dark plate WHILE
+       staying subordinate to the L90 --foreground ink (the quiet-subordinate hierarchy
+       preserved — NOT a blanket lift to full ink, which the bright bucket already does).
+       Warm-amber (the BB.W-DARK-INK-WARM identity), NOT the slides deck hsl(45 …) literal
+       (the deck is the REFERENCE; the library re-derives against its own --card). The
+       light arm lives in tokens/glass.css (the plain per-mode pair — the house idiom). */
+    --on-glass-muted:        hsl(34 16% 72%);   /* brighter than the collapsed --neutral-5 L62 (6.63:1 vs the luminous-dark plate; subordinate to --foreground) */
+    --on-glass-muted-strong: hsl(36 14% 78%);   /* the -strong rung, one step more present (7.75:1 vs plate) */
+    --input-on-glass:        hsl(26 12% 22%);   /* the form-well fill — grounded warm-dark so the L90 input TEXT reads against a stable base (9.3:1) */
+    --progress-track-on-glass: hsl(28 14% 26%); /* the recessed meter track — a warm-dark channel distinct from the fill silhouette */
+
+    /* BA.W-DARK-MATERIAL scope 5 + BB.W-DARK-INK-WARM — the --surface-tint-* dark arm,
+       --foreground-DERIVED. The light family is color-mix(in srgb, var(--foreground) N%,
+       transparent) — over a near-black dark card a LIGHT-ink (dark --foreground IS light
+       cream) tint composites to near-black: the 9-rung chip/hairline/divider scale is
+       INVISIBLE in dark. The dark arm re-anchors the mix ink to a BRIGHTER warm off-white
+       so a chip/hairline LIFTS off the deep card (the inverse intent of light's dark-ink
+       tint). BA executed that intent as a hardcoded hsl(48 12% 96%) literal ×12 — at the
+       EXACT OKLab H95.1° yellow-green the SAME tranche's W-NO-GRAY ruled "a cast, not warm
+       material", AND a per-rung literal a --foreground re-point can never reach (the
+       architectural asymmetry with the light arm + the substitution-vs-redeclaration trap
+       at the token mint). BB re-expresses each rung as a oklch(from var(--foreground) 0.975
+       c h) RELATIVE-COLOR derivation: the recipe extracts the (now-warmed) dark --foreground's
+       warm hue + chroma and lifts the lightness to 0.975 (≈ HEAD's 0.973 ink L, so the chip
+       lift off the L16 card is preserved) — the ink CARRIES the --foreground's warm hue
+       (OKLab H75.4°) BY DERIVATION (re-point the dark ink → every rung re-resolves warm; a
+       future re-tune reaches all 12 from ONE --foreground edit — the symmetry the light arm
+       has had since L.W5). The OUTER mix STAYS color-mix(in srgb, … N%, transparent) — the
+       SAME 12-rung α ladder + the SAME in-srgb interpolation space the light arm uses (the
+       AW.W26 fence holds — the oklch(from …) is the INK SOURCE, not the tint mix space).
+       This re-resolves every --surface-tint-* consumer (chip backplates, the dock-rail
+       divider, the spine, the timeline dot) in lockstep, zero per-site edit. The 0.975 lift
+       sits well under the sRGB gamut edge (the AX css-relative-color book's "browsers don't
+       gamut-map yet" caveat does not bite — at 0.975 the small high-L chroma resolves clean;
+       lift→1.0 drifts the hue, so 0.975 is the calibrated pin). The css-relative-color
+       chronic's FIRST live consumer (the tolerant α-mix the AX book was waiting for). */
+    --surface-tint-4:  color-mix(in srgb, oklch(from var(--foreground) 0.975 c h)  4%, transparent);
+    --surface-tint-6:  color-mix(in srgb, oklch(from var(--foreground) 0.975 c h)  6%, transparent);
+    --surface-tint-8:  color-mix(in srgb, oklch(from var(--foreground) 0.975 c h)  8%, transparent);
+    --surface-tint-10: color-mix(in srgb, oklch(from var(--foreground) 0.975 c h) 10%, transparent);
+    --surface-tint-12: color-mix(in srgb, oklch(from var(--foreground) 0.975 c h) 12%, transparent);
+    --surface-tint-15: color-mix(in srgb, oklch(from var(--foreground) 0.975 c h) 15%, transparent);
+    --surface-tint-18: color-mix(in srgb, oklch(from var(--foreground) 0.975 c h) 18%, transparent);
+    --surface-tint-22: color-mix(in srgb, oklch(from var(--foreground) 0.975 c h) 22%, transparent);
+    --surface-tint-25: color-mix(in srgb, oklch(from var(--foreground) 0.975 c h) 25%, transparent);
+    --surface-tint-35: color-mix(in srgb, oklch(from var(--foreground) 0.975 c h) 35%, transparent);
+    --surface-tint-40: color-mix(in srgb, oklch(from var(--foreground) 0.975 c h) 40%, transparent);
+    --surface-tint-70: color-mix(in srgb, oklch(from var(--foreground) 0.975 c h) 70%, transparent);
 
     /* Hairline-accent dark mirror — see light counterpart at line ~404. */
     --hairline-catch-light: inset 0 0.5px 0 0 rgb(255 255 255 / 0.05);
@@ -277,6 +362,15 @@
        resolves to the `-dark` alpha on the deeper canvas. */
     --glass-edge-light: var(--glass-edge-light-dark);
 
+    /* BC.W-BLACK-BAR D2 — the DIRECTIONAL rim dark arm (plain per-mode pair, NEVER
+       light-dark() round an inset — MEMORY: the inset-shadow trap). The top
+       catch-light lifts to 0.40 (the dark plate's fill barely separates from the deep
+       page, so the rim is the PRIMARY silhouette device — dark glass glows where light
+       passes; mirrors the --glass-edge-light-dark 0.18→0.22 lift). The bottom warm
+       under-shadow holds at 6% — the shadow grounds the plate in BOTH modes. */
+    --glass-rim-top: inset 0 1px 0 hsl(0 0% 100% / 0.40);
+    --glass-rim-bottom: inset 0 -1px 0 color-mix(in srgb, var(--foreground) 6%, transparent);
+
     /* AW.W23 — the chromatic-fringe + adaptive-tint dark arm. The fringe drops
        to a lower-luminance warm/cool pair on the deep canvas; `--glass-tint-
        source` auto-flips with `--card` (no override needed — the default already
@@ -304,5 +398,16 @@
     --silver: oklch(0.792 0.012 255);
     --silver-light: oklch(0.912 0.010 255);
     --silver-dark: oklch(0.648 0.014 255);
+
+    /* Bronze — lifted for dark (BB.W-METAL-SHIMMER; mirrors gold's dark arm: the
+       warm metal lifts ~+0.03 L so the bronze register reads on the deep canvas.
+       `--bronze-deep` is mode-invariant — NOT re-declared here, exactly as
+       `--gold-deep`/`--silver-deep` are omitted from this dark block). The warm hue
+       holds; the chroma stays above the W-NO-GRAY floor. The `.dark`-class fallback
+       for engines without `light-dark()` (the §2c lockstep — the light-dark arm AND
+       this dark fallback move TOGETHER). */
+    --bronze: oklch(0.650 0.090 54.0);
+    --bronze-light: oklch(0.790 0.110 60.0);
+    --bronze-dark: oklch(0.560 0.085 50.0);
 }
 

package/src/styles/tokens/glass-deep.css

@@ -0,0 +1,100 @@
+/*
+ * glass-deep.css — BB.W-DEEP-GLASS — the OPT-IN deep-glass token family.
+ *
+ * A SEPARATE `--glass-blur-deep-*` token family ABOVE the W-GLASS-CAL calm
+ * default (the Apple iOS-27 Liquid-Glass deep register: `saturate(1.8) blur(20px)`
+ * measured on Apple's live nav material; glass-ui lands the deep tier in the
+ * 14-20px band at a budget-clearing 16px + saturate 1.5). The calm content
+ * default is BYTE-UNTOUCHED — this family is minted ALONGSIDE the calm
+ * `--glass-blur-*` ladder (tokens/glass.css), which NEVER reads these tokens, so
+ * `proof:glass-cal` B1-B3 stay GREEN by construction (the calm default is the
+ * user's "a hair too much" call, INVIOLATE).
+ *
+ * This is the §8-ladder partial sibling of tokens/glass.css (kept OUT of glass.css
+ * so the ratchet-baselined glass.css stays at 505); @import-ed in tokens.css
+ * AFTER glass.css (the deep family resolves in the same :root cascade slot,
+ * adjacent same-selector blocks). The dark deep arm lives in tokens/dark-arm.css
+ * (the W-DARK-MATERIAL discipline — the luminous-dark companion beside the calm
+ * dark companions).
+ *
+ * ── The Apple-range derivation (DELTA cross-ref) ───────────────────────────
+ * Apple home nav:       saturate(1.8) blur(20px)  (the canonical measure; the CEILING)
+ * Apple product tiers:  blur(14-20px)             (the band)
+ * glass-ui calm ceiling: floating 13px / saturate 1.18  (W-GLASS-CAL dial-back)
+ * glass-ui DEEP:        16px / saturate 1.5        (STRICTLY deeper on BOTH axes,
+ *                       in-band, the budget-clearing landing — the full 20px is
+ *                       a BOOKED successor with the recorded throttle number).
+ * The deep saturate lands at the LOW end of the 1.5-1.8 band: the Apple 1.8 is
+ * measured over a NEUTRAL backdrop; glass-ui's deep tier sits over warm-aurora,
+ * and the warm-cream light-concentration ceiling (AX.W52 D19 — a saturate that
+ * over-juices a colored substrate reads as a garish smear) keeps it just-rich.
+ * The deepest BLUR carries the "more glass" read; the saturate stays restrained.
+ *
+ * ── The deep-tier BUDGET CALL (BC.W-GLASS-LEGIBILITY-MEASURED L4) ───────────
+ * The deep blur radius is the most expensive idiom glass-ui ships (`backdrop-
+ * filter` cost is super-linear in the radius past ~16px). The wave's call:
+ * STAY at the budget-clearing 16px and BOOK the 18-20px push (toward the live-
+ * measured apple.com nav `blur(20px)` ceiling, research/apple-glass.md §1.1)
+ * behind a recorded `profile:budget` clearance — the full 20px is the BOOKED
+ * successor (apple-ios27.md §1.4 "the full 20px booked"), NOT a silent over-
+ * spend. `--glass-saturate-deep-ceiling` BAKES the apple.com nav saturate 1.8 as
+ * the deep-tier CEILING (the load-bearing term — research/apple-glass.md §4
+ * "saturate 1.5 shipped, bake 1.8 as the deep ceiling"); the shipped
+ * `--glass-saturate-deep` 1.5 sits at the low end (≤ ceiling), warm-aurora-safe.
+ * `proof:glass-legibility` L4 reads BOTH: the 16px-stay is honest IFF the budget
+ * booking is recorded here, and the shipped deep saturate never crosses the 1.8
+ * ceiling. When a `profile:budget` run clears the 18-20px push, the radius
+ * lifts toward 20px on the SAME LERP (the booked successor lands, no recipe edit).
+ */
+:root {
+    /* The Apple-range deep ENDPOINTS — the radius + saturate the deep tier reaches
+       at full depth (`--glass-depth: 1`). The calm `floating` rung (13px / 1.18)
+       is the depth-0 floor; the deep recipe LERPs between the two on `--glass-depth`
+       so the axis is a genuine driver, not a literal. */
+    --glass-blur-deep-radius:    16px; /* in [14,20], STRICTLY > calm floating 13px;
+                                          BUDGET CALL (L4): stays 16px, the 18-20px push
+                                          toward the apple.com nav ceiling is BOOKED
+                                          behind a recorded profile:budget clearance. */
+    --glass-saturate-deep:       1.5;  /* >= 1.5 (toward Apple 1.8), > calm floating 1.18;
+                                          ≤ --glass-saturate-deep-ceiling (the apple.com
+                                          nav 1.8 bound — never over-shot, L4). */
+    --glass-saturate-deep-ceiling: 1.8; /* the apple.com-nav saturate CEILING, BAKED as
+                                           the deep-tier load-bearing term (research/
+                                           apple-glass.md §4); the deep saturate never
+                                           exceeds it (the warm-cream identity bound). */
+
+    /* The deep blur RADIUS — LERPed from the calm floating radius (depth 0) to the
+       Apple-deep radius (depth 1) on `--glass-depth`, THEN scaled by the ONE
+       `--glass-level` clarity scalar (the W54 seam reaches the deep plate, so the
+       opaque escape + the a11y brackets compose: at `--glass-level: 0` the deep
+       blur resolves blur(0), the same solid floor). NOT a parallel recipe — the
+       deep blur COMPOSES `var(--glass-level)` exactly like every calm rung, and
+       reads `var(--glass-depth)` so a host dials the depth on any ancestor. */
+    --glass-blur-deep-active-radius:
+        calc(
+            (
+                var(--glass-blur-floating-radius)
+                + (var(--glass-blur-deep-radius) - var(--glass-blur-floating-radius))
+                * var(--glass-depth)
+            )
+            * var(--glass-level)
+        );
+    /* The deep SATURATE — LERPed from the calm floating saturate (1.18, depth 0)
+       to the deep saturate (depth 1) on `--glass-depth`. The saturate is the
+       light-concentration lift (chroma-only — it LIFTS the backdrop's existing
+       chroma, it does NOT inject a hue; the warm-cream `--card` base is the same). */
+    --glass-saturate-deep-active:
+        calc(
+            1.18 + (var(--glass-saturate-deep) - 1.18) * var(--glass-depth)
+        );
+
+    /* The composed deep backdrop-filter — the SEPARATE deep family. The calm
+       ladder never reads this; `.glass-deep` (glass/deep.css) is its only
+       consumer. The brightness companion mirrors the calm floating arm's
+       light-concentration (the calm floating carries saturate only; the deep
+       tier adds a small brightness lift for the thicker-glass read — still no
+       hue inject). */
+    --glass-blur-deep:
+        blur(var(--glass-blur-deep-active-radius))
+        saturate(var(--glass-saturate-deep-active));
+}