@mkbabb/glass-ui 4.0.0 → 4.1.0

package/dist/styles/tokens/glass.css

@@ -1,7 +1,13 @@
 /* tokens/glass.css
-   §8 glassmorphism — the five-tier surface ladder (bg/blur/border/shadow rungs + the glass-level + tint axes).
+   §8 glassmorphism — the five-tier surface ladder (opacity/blur/saturate rungs +
+   composed bg/border) + the --glass-level axis + the control-REST register.
    Carved from the tokens.css cascade root; @import-ed by tokens.css in
-   cascade order. Same :root cascade context as its siblings. */
+   cascade order. Same :root cascade context as its siblings. The decorative/fx
+   tail (grain/specular/edge-light + the adaptive tint-source/backdrop-luma bucket +
+   fringe/curvature/chart-palette + the per-tier shadow/spine/under-shadow/overlay-
+   scrim) carved to tokens/glass-fx.css at BB.W-CARVE4 — @import-ed IMMEDIATELY AFTER
+   this partial so the two adjacent same-selector :root{} blocks resolve identically
+   (the dist is byte-isomorphic). */
 :root {
     /* ═══════════════════════════════════════════════
        §8  GLASSMORPHISM — Five-tier surface ladder (v0.8.0)
@@ -18,7 +24,33 @@
        breaking change. R3-spec §A.
        ═══════════════════════════════════════════════ */
 
-    /* Opacity primitives */
+    /* ── Per-tier alpha — the CANONICAL named opacity register (BB.W-CARD-TIER-ALPHA) ──
+       Each `--glass-opacity-{tier}` IS the library's canonical alpha for that tier —
+       a NAMED, documented input to the ONE compose recipe below, NOT a magic number
+       a consumer re-pins. The values here are the library IDENTITY: the warm-cream
+       glass ladder, alpha-monotonic (wash < quiet < resting < floating < overlay), with
+       the dock (0.42) + chassis (0.28) carrying their own footprint-calibrated rungs.
+       The dark arm (tokens/dark-arm.css) lifts each ~0.08 for read-weight over the
+       deeper canvas — the SAME named tokens, per-mode (the plain per-mode pair idiom).
+
+       A consumer that wants the LIBRARY register reads these named tokens (or composes
+       a `<Card tier>` rung) and re-pins NOTHING; a consumer whose surface needs a
+       divergent composited luminance (the speedtest dark-AA register: instrument 0.72 /
+       document 0.78) keeps that as a NAMED preset IN ITS OWN repo (presets-in-consumers)
+       — the library default is its identity, the consumer preset is the consumer's.
+
+       THE SUBSTITUTION-VS-INHERITANCE SEAM (the recurring trap, recorded). The composed
+       `--glass-bg-{tier}` below is declared HERE at `:root`, so a custom-property
+       substitution resolves at THIS element — overriding `--glass-opacity-{tier}` on a
+       DESCENDANT does NOT re-compose the inherited `--glass-bg-{tier}` (the value is
+       already resolved). A consumer that needs a per-scope tier alpha therefore RE-DECLARES
+       the composed `--glass-bg-{tier}` on the scope (the same recipe, the pinned alpha) —
+       the documented retune path, mirroring the dock's own `--glass-bg-dock` self-re-point.
+       The named alpha is the canonical INPUT; the per-scope `--glass-bg-*` re-declaration is
+       the sanctioned consumer pin. (The `--glass-level` recipe MECHANISM below is the
+       AX.W54 seam — UNTOUCHED by this register; this canonicalizes the alpha INPUTS only.)
+       Machine-locked by `proof:card-tier-alpha`. */
+    /* Opacity primitives — the per-tier canonical alpha (light arm). */
     --glass-opacity-wash:     0.30;
     --glass-opacity-quiet:    0.50;
     --glass-opacity-resting:  0.65;
@@ -59,12 +91,38 @@
        opacity-only register. */
     --glass-blur-dock-radius:     9px;
 
+    /* ── Per-rung SATURATE — the CANONICAL named saturate register (BC.W-GLASS-
+       LEGIBILITY-MEASURED, the speedtest-AX BC-W10 fold) ───────────────────────
+       The saturate term is the LOAD-BEARING glass knob (research/apple-glass.md §4:
+       the apple.com nav rides `saturate(1.8)` — the highest term, blur moderate).
+       Each `--glass-saturate-{tier}` is the library's canonical saturation for that
+       rung — a NAMED, `:root`-overridable input the composed `--glass-blur-{tier}`
+       reads THROUGH, the SAME substitution-vs-redeclaration discipline as the
+       `--glass-opacity-{tier}` alpha register above. A `:root { --glass-saturate-
+       quiet: … }` override re-resolves the rung's saturation with ZERO recipe edit
+       (the speedtest "dark cards" chronic + the apple-glass saturate-as-load-bearing
+       lever). The values here ARE the W52-D19 bake (wash/quiet/resting 1.05,
+       floating 1.18, overlay 1.2) become the token defaults — so the composed blur
+       is BYTE-IDENTICAL to the old baked literal (proof:glass-cal / proof:card-tier-
+       alpha stay GREEN by construction). The deep-tier `--glass-saturate-deep` 1.8
+       ceiling (glass-deep.css) is the upper bound; no rung saturate exceeds it. The
+       dark arm (tokens/dark-arm.css) re-declares this register with the W-DARK-
+       MATERIAL luminosity lift — the SAME named tokens, per-mode (the plain per-mode
+       pair idiom). The brightness() companions stay baked (this fold mints ONLY the
+       saturate knob). Machine-locked by `proof:glass-legibility` L7. */
+    --glass-saturate-wash:     1.05;
+    --glass-saturate-quiet:    1.05;
+    --glass-saturate-resting:  1.05;
+    --glass-saturate-floating: 1.18;
+    --glass-saturate-overlay:  1.2;
+
     /* AX.W54 — each blur radius is scaled by the ONE `--glass-level` scalar (in
        lockstep with the opacity seam above): level=1 byte-identical; level=0 →
        blur(0) (the clean solid floor with the opacity); level>1 → more diffusion.
-       The per-rung `saturate()`/`brightness()` companions are UNTOUCHED (the level
+       The per-rung `saturate()` companion reads the named `--glass-saturate-{tier}`
+       knob (BC.W-GLASS-LEGIBILITY-MEASURED); `brightness()` stays baked (the level
        scales the RADIUS, not the saturation — W52's calm light-concentration). */
-    --glass-blur-wash:     blur(calc(var(--glass-blur-wash-radius) * var(--glass-level))) saturate(1.05);
+    --glass-blur-wash:     blur(calc(var(--glass-blur-wash-radius) * var(--glass-level))) saturate(var(--glass-saturate-wash));
     /* AV.W15 M1 — the `quiet` rung gained `saturate(1.05) brightness(1.02)`
        so the lower ladder reads with the same saturation life as `resting`+
        (Apple: Liquid Glass concentrates light, it does not desaturate). The
@@ -72,27 +130,34 @@
        between bare `wash` and `resting` without over-brightening the rung.
        The `prefers-reduced-transparency: reduce` bracket at glass.css maps
        `--glass-blur-quiet: none`, so this whole chain drops with the blur. */
-    --glass-blur-quiet:    blur(calc(var(--glass-blur-quiet-radius) * var(--glass-level))) saturate(1.05) brightness(1.02);
-    --glass-blur-resting:  blur(calc(var(--glass-blur-resting-radius) * var(--glass-level))) saturate(1.05);
+    --glass-blur-quiet:    blur(calc(var(--glass-blur-quiet-radius) * var(--glass-level))) saturate(var(--glass-saturate-quiet)) brightness(1.02);
+    --glass-blur-resting:  blur(calc(var(--glass-blur-resting-radius) * var(--glass-level))) saturate(var(--glass-saturate-resting));
     /* AX.W52 D19 — the floating/overlay backdrop saturate tamed from 1.4/1.5 to a
        gentle ~1.18/1.2 (real liquid glass concentrates light ~1.1–1.2×; the prior
        1.4–1.5× over-juiced the bleed-through into a garish smear over a colored
        substrate). wash/quiet/resting already sit at 1.05 — untouched. */
-    --glass-blur-floating: blur(calc(var(--glass-blur-floating-radius) * var(--glass-level))) saturate(1.18);
-    --glass-blur-overlay:  blur(calc(var(--glass-blur-overlay-radius) * var(--glass-level))) saturate(1.2);
+    --glass-blur-floating: blur(calc(var(--glass-blur-floating-radius) * var(--glass-level))) saturate(var(--glass-saturate-floating));
+    --glass-blur-overlay:  blur(calc(var(--glass-blur-overlay-radius) * var(--glass-level))) saturate(var(--glass-saturate-overlay));
     /* Dock blur composes blur() only — no saturate. */
     --glass-blur-dock:     blur(calc(var(--glass-blur-dock-radius) * var(--glass-level)));
 
-    /* AX.W52 — the GLASS BUTTON blur. The `glass`/`glass-wash` button variants
-       compose the `.glass-wash` tier (`--glass-blur-wash` = blur(1px)) — a
-       sub-perceptual diffusion authored for a small detail TILE, not a button
-       the user reads as "glass." A button is a hero control: it wants a real
-       glass blur. `--glass-blur-btn` lifts the variant onto the `quiet`-tier
-       radius (10px — a genuine liquid-glass diffusion) with the same gentle
-       `saturate(1.05) brightness(1.02)` light-concentration the quiet rung
-       carries (NOT a colour-juice). The wash TILE tier (MetricCell et al.) keeps
-       its 1px — only the glass BUTTON variants reach for this. */
-    --glass-blur-btn:      blur(calc(var(--glass-blur-quiet-radius) * var(--glass-level))) saturate(1.05) brightness(1.02);
+    /* AX.W52 → BC.W-GLASS-LEGIBILITY-MEASURED — the GLASS BUTTON blur, lifted to
+       the FLOATING-tier "more glass" register. The `glass`/`glass-wash` button
+       variants compose the `.glass-wash` tier (`--glass-blur-wash` = blur(1px)) — a
+       sub-perceptual diffusion authored for a small detail TILE, not a button the
+       user reads as "glass." A button is a hero control: it wants a real glass blur.
+       The AX.W52 landing sat at the quiet-tier 8px/saturate(1.05) — "quieter than
+       even the calm floating tier" (apple-ios27.md §4.2). This wave lifts it to the
+       FLOATING-tier register (apple-ios27.md §5 bake-table "button blur lift to
+       10-13 / 1.18"): the floating radius (13px, in the 10-13 band) + the named
+       `--glass-saturate-floating` knob (1.18) — a genuinely MORE-glass transmissive
+       capsule revealing the craft beneath (the apple-glass SUPERSET: apple.com's web
+       CTA is a SOLID blue capsule, zero blur — research/apple-glass.md §1.4). The
+       `brightness(1.02)` light-concentration the quiet rung carried is KEPT (no
+       colour-juice). Clean break — the old 8px/quiet value is GONE, no alias. The
+       wash TILE tier (MetricCell et al.) keeps its 1px — only the glass BUTTON
+       variants reach for this. Machine-locked by `proof:glass-legibility` L3. */
+    --glass-blur-btn:      blur(calc(var(--glass-blur-floating-radius) * var(--glass-level))) saturate(var(--glass-saturate-floating)) brightness(1.02);
 
     /* Dock-specific opacity (0.42) — lighter than `resting` (0.65) so the dock
        reads as a translucent overlay rather than a panel, backdrop bleed
@@ -101,6 +166,20 @@
        dock reads as painted chrome, not a frosted ghost. */
     --glass-opacity-dock: 0.42;
 
+    /* Dialog-specific opacity (0.68) — BC.W-DIALOG-GLASS. The iOS-27 control-
+       center modal register: SEE-THROUGH frosted glass that reveals the page
+       beneath, NOT the floating-tier near-opaque slab (0.80 read as "NOT glassy
+       at all"). 0.68 sits between `resting` (0.65 — transparent enough to read
+       through) and `floating` (0.80 — opaque enough for AA legibility against
+       the bright bucket), so the modal floats with the FLOATING-tier lift (edge/
+       rim/under-shadow) while reading at the RESTING-tier transparency. The
+       LIBRARY iOS-modal identity (presets-in-consumers — a consumer retunes
+       `--glass-bg-dialog` via :root). Consumed by DialogContent.vue, which re-
+       declares `--glass-bg-floating: var(--glass-bg-dialog)` on the dialog scope
+       (the self-re-point recipe, the dock precedent — NOT a raw rung override
+       that won't re-compose). */
+    --glass-opacity-dialog: 0.68;
+
     /* Dock foreground over an animated backdrop. A dock floating over an
        aurora/animated surface (`value.js` dock-over-aurora, a slides routed
        control, bbnf) sits on a mid-luminance, shifting field where the muted
@@ -146,24 +225,36 @@
        second hand-rolled recipe. */
     --glass-bg-dock:     color-mix(in oklab, color-mix(in srgb, var(--card) calc((1 - (1 - var(--glass-opacity-dock)) * var(--glass-level)) * 100%), transparent), var(--glass-tint-source) var(--glass-tint-strength));
     --glass-bg-chassis:  color-mix(in srgb, var(--card) calc((1 - (1 - var(--glass-opacity-chassis)) * var(--glass-level)) * 100%), transparent);
-
-    /* Composed borders — foreground-tinted. BA.W-NO-GRAY L3 — the warm RIM
-       re-anchor (G9). The rim IS warm (it rides --foreground, hsl-24 warm ink),
-       but at 8-12% α over a near-white plate it was a near-invisible hairline —
-       the plate had no carved silhouette, reading as a borderless gray rectangle
-       (the user's "no gray ... for cards"). The α lifts a few points per rung so
-       the warm hairline CARVES the silhouette (the WWDC25 "rim that defines the
-       silhouette" device, on the warm-ink register). Still bounded low — the rim
-       is a whisper that defines the edge, never a hard rule. The source stays
-       --foreground (the warm-ink tint, NOT a new color); only the presence lifts. */
-    --glass-border-wash:     color-mix(in srgb, var(--foreground) 11%, transparent);
-    --glass-border-quiet:    color-mix(in srgb, var(--foreground) 13%, transparent);
-    --glass-border-resting:  color-mix(in srgb, var(--foreground) 16%, transparent);
-    --glass-border-floating: color-mix(in srgb, var(--foreground) 19%, transparent);
-    --glass-border-overlay:  color-mix(in srgb, var(--foreground) 22%, transparent);
-    --glass-border-dock:     color-mix(in srgb, var(--foreground) 14%, transparent);
+    /* BC.W-DIALOG-GLASS — the dialog plate bg, composed the SAME oklab-tint-wrapped
+       way the dock self-re-points (so the BC.W-ADAPTIVE-RECONCILE darken reaches the
+       modal over a bright backdrop without a second hand-rolled recipe). The 0.68
+       opacity is the iOS-27 control-center register (see `--glass-opacity-dialog`).
+       DialogContent.vue re-declares `--glass-bg-floating: var(--glass-bg-dialog)` on
+       the dialog scope (the documented retune path — the self-re-point, NOT a raw
+       rung override) so the floating edge/rim/under-shadow LIFT survives the
+       transparency drop. */
+    --glass-bg-dialog:   color-mix(in oklab, color-mix(in srgb, var(--card) calc((1 - (1 - var(--glass-opacity-dialog)) * var(--glass-level)) * 100%), transparent), var(--glass-tint-source) var(--glass-tint-strength));
+
+    /* Composed borders — foreground-tinted. BC.W-BLACK-BAR D2 — the perimeter
+       hairline is RETIRED as the silhouette device. The old 11-22% warm-ink rung
+       borders rode --foreground (oklab L 0.216, near-black warm ink); over a
+       near-white cream plate the full-perimeter hairline read as the user's "wtf
+       is this black bar" — worst on the TOP edge where the bright white catch-light
+       ring sat just inside a dark border (a bright rim and a dark line at war on the
+       SAME edge). The silhouette is now carved by the directional rim
+       (--glass-rim-top catch-light + --glass-rim-bottom under-shadow, glass-fx.css),
+       NOT by this perimeter ink. So each rung drops to ≤5% α — the warm hue stays
+       --foreground (the warm-not-tinted identity, BA.W-NO-GRAY), only the PRESENCE
+       falls below the read-threshold so the hairline can never read as a bar. The
+       +1% on the two heaviest rungs (floating/overlay) holds a faint tier-presence
+       ordering without crossing the threshold (apple-ios27.md §5 "top ≤4%" target). */
+    --glass-border-wash:     color-mix(in srgb, var(--foreground) 4%, transparent);
+    --glass-border-quiet:    color-mix(in srgb, var(--foreground) 4%, transparent);
+    --glass-border-resting:  color-mix(in srgb, var(--foreground) 4%, transparent);
+    --glass-border-floating: color-mix(in srgb, var(--foreground) 5%, transparent);
+    --glass-border-overlay:  color-mix(in srgb, var(--foreground) 5%, transparent);
+    --glass-border-dock:     color-mix(in srgb, var(--foreground) 4%, transparent);
     --glass-border:          var(--glass-border-quiet);
-    --glass-border-strong:   var(--glass-border-floating);
 
     /* ── The control REST register (BA.W-SURFACE-AXIS scope 7) ────────────────
        ONE shared resting surface for the FORM family — Input/Textarea/Select/
@@ -182,319 +273,8 @@
     --control-surface-blur:      var(--glass-blur-quiet);
     --control-surface-bg-hover:  color-mix(in oklab, var(--glass-bg-quiet), var(--glass-bg-resting) 35%);
 
-    /* Shared decorative. Light grain dropped 0.035 → 0.025 in P.W1.B —
-       at the chassis scale the original alpha read as crawl over the new
-       lower-alpha chassis bg; the grain's role is texture, not reading,
-       so it sits at the perceptual floor. Dark companion drops 0.06 →
-       0.045 below to keep the soft-light blend alive without stippling. */
-    --glass-grain-opacity: 0.025;
-    /* BA.W-GLASS-CAL — `--glass-grain-opacity-disco` (0.08) DELETED with the disco
-       recipe retirement (H2a): no surviving consumer once `btn-audacious` + the
-       dock-tab primary phase-grain collapse onto the calm glass register. */
-    --glass-highlight: inset 0 0.5px 0 0 hsl(0 0% 100% / 0.25);
-
-    /* Hairline-accent — 0.5px catch-light + under-shadow pair.
-       Single token composes the canonical 2-stop hairline used by dock,
-       instrument-chassis. The `.hairline-accent` utility
-       (utilities.css §hairline) adopts these via `box-shadow:`. */
-    --hairline-catch-light: inset 0 0.5px 0 0 rgb(255 255 255 / 0.06);
-    --hairline-under-shadow: 0 0.5px 0 0 rgb(0 0 0 / 0.04);
-    --border-hairline: var(--hairline-catch-light), var(--hairline-under-shadow);
-
-    /* Specular catch-light — 1.5px-tall top-edge highlight that swaps in for
-       --glass-highlight on interactive moments (e.g. primary-action hover).
-       Reads as a real catch-light on a curved surface. The `-dark` companion
-       is overridden inside `.dark`; the named token here is the explicit
-       handle consumers can reference to compose dark-aware layers. */
-    --glass-specular: inset 0 1.5px 0 0 hsl(0 0% 100% / 0.45);
-    --glass-specular-dark: inset 0 1.5px 0 0 hsl(0 0% 100% / 0.30);
-
-    /* AV.W15 M3 — Full-perimeter rim light (the "rim that defines the
-       silhouette", WWDC25 sess. 219). Distinct from the top-only
-       `--glass-highlight` (a 0.5px top-edge catch-light): this is a 0.75px
-       inset ring around the WHOLE silhouette, four edges, reading as the
-       catch-light that wraps the glass plate the way iOS-26 Liquid Glass
-       carries a rim, not just a top highlight. Composed as a SECOND inset
-       box-shadow layer alongside `--glass-highlight` on the floating/dock
-       tiers (glass.css wires it). The alpha is deliberately low (0.18 light
-       / 0.10 dark) — the rim is decoration and must not eat AA legibility
-       over a busy backdrop; it sits below the perceptual reading threshold
-       on text. The `-dark` companion is overridden inside `.dark` mirroring
-       the `--glass-specular-dark` precedent. */
-    --glass-edge-light:      inset 0 0 0 0.75px hsl(0 0% 100% / 0.18);
-    /* BA.W-DARK-MATERIAL scope 2 — the dark edge/rim is the PRIMARY silhouette device in
-       dark. The light register's fill+shadow carry the plate; in dark the fill barely
-       separates (the deep page is near-black), so the EDGE + the transmitted glow carry the
-       silhouette — two registers, one design language. HEAD α 0.10 sits below the reading
-       threshold over the deep canvas; lifted to 0.22 so the rim DEFINES the plate (the
-       WWDC25 "rim that defines the silhouette" device, dialed up for the dark substrate). */
-    --glass-edge-light-dark: inset 0 0 0 0.75px hsl(0 0% 100% / 0.22);
-
-    /* AW.W23 — content-aware adaptive tint (the Baseline-2025 "tint informed by
-       surrounding content" axis, WWDC25 sess. 219). A surface can tint toward a
-       consumer-provided dominant backdrop color via a `color-mix(in oklab, …)`
-       recipe (oklab is the mwg-preferred space for tint generation; NEVER a
-       lightness-shift in `oklch(from …)` — browsers don't gamut-map yet).
-
-       DEFAULT is zero delta: `--glass-tint-source` is the warm-white card itself
-       and `--glass-tint-strength` is 0%, so the rung background mixes 0% toward
-       the source = byte-identical to today. A consumer sets `--glass-tint-source`
-       to a sampled aurora hue + a strength ≤30% to bias the surface. Alpha-safe:
-       the mix is bounded ≤30% and never re-points the card's own alpha.
-
-       AX.W55 — the DEFAULTS stay `var(--card)`/`0%` (the zero-delta rest state).
-       The backdrop-luminance probe (`--glass-backdrop`, below) is what OVERRIDES
-       them under a bright backdrop; the `:root` defaults are NEVER touched — the
-       bucket blocks (glass.css / dock.css `@container style(--glass-backdrop:
-       light)`) do the lift, so a surface over today's rich/dark background reads
-       byte-identical. */
-    --glass-tint-source:   var(--card);
-    --glass-tint-strength: 0%;
-
-    /* AX.W55 — adaptive glass legibility (the iOS-26/27 "locally darken the glass
-       over light content" move; G2). There is NO web API that reads the pixels
-       painted BEHIND a `backdrop-filter` element, so the backdrop-luminance signal
-       is a DECLARATIVE BUCKET a consumer sets where it KNOWS the backdrop is bright
-       (a near-white card surface, a pale aurora bleed, a bright data grid). It is
-       read by the `@container style(--glass-backdrop: light)` blocks on every glass
-       family (the shipped density-cascade mechanism — utilities.css §density) which
-       lift `--glass-tint-strength` toward the AA floor + re-point `--glass-tint-
-       source` to the warm-ink below, mixing the rung TOWARD ink via the EXISTING
-       `color-mix(in oklab)` seam — ZERO new compositing seam.
-
-         --glass-backdrop:      the bucket. `dark` (or unset) = today's zero-delta;
-                                `light` engages the bright-bucket darken. An
-                                INHERITING ident set on any ancestor reaches every
-                                descendant glass surface (the @container read).
-         --glass-backdrop-luma: the numeric escape hatch — a sampled backdrop
-                                relative-luminance (0..1) a heavier JS observer sets
-                                when the declarative bucket is too coarse. The TOKEN
-                                is minted (the cascade reads it if set); the OBSERVER
-                                that sets it stays demo-private until a 2nd consumer
-                                arrives (the no-overfitting bar — the DEFAULT path is
-                                the declarative bucket, not a speculative sampler).
-         --glass-tint-ink:      the LOW-LUMINANCE warm-ink the bright bucket re-points
-                                `--glass-tint-source` to — the warm dark `--foreground`
-                                family (NOT white; a lightener over light content is
-                                exactly the W52-fixed wrong direction). It auto-flips
-                                with `--foreground` (dark-mode it resolves the light
-                                warm ink — but the bright-backdrop case is a light-mode
-                                concern). Overridable like every magnitude here.
-
-       The bright-bucket `--glass-tint-strength` is clamped to a BOUNDED AA-clearing
-       floor — `--glass-tint-strength-aa` (≤24%, the iOS clamp; the lowest value that
-       clears 4.5:1 over synthetic white, capped LOW so the surface STAYS translucent,
-       "let as much content through as possible"). Recorded here as the ceiling the
-       bucket blocks drive to; the live 4.5:1 readback (proof:adaptive-glass π arm)
-       ratifies the exact value. */
-    --glass-backdrop:           dark;
-    --glass-backdrop-luma:      ;
-    --glass-tint-ink:           var(--foreground);
-    /* AZ.W-ADAPTIVE-AUTO Arm 1 — recalibrated 18% → 20%. The bump strengthens the
-       G2 surface-SILHOUETTE darken (ΔL ≈ 0.40 over synthetic white, the plate is
-       distinguishable from a bright page behind) while staying bounded ≤ 24% (the
-       iOS clamp — the surface STAYS translucent, "let content through"). The body
-       register over the engaged plate is the full warm-ink `--foreground` (~10.6:1
-       over white at 20%) — the muted L40 tier is lifted to the full ink by the
-       self-engage rules (it cannot clear 4.5:1 on a translucent darkened plate;
-       darkening moves the plate toward muted's own luminance). The shipped overlay-
-       band engaged appearance re-ratifies at the new floor: `--foreground` reads
-       ~10.6–10.9:1 (within the ~11:1 ratified register — the bump is a silhouette
-       strengthening, not a silent re-tint below AA). The live π readback ratifies. */
-    --glass-tint-strength-aa:   20%;
-
-    /* BA.W-DARK-MATERIAL scope 7 — the calm-light recalibration (R9-1; the slides gray-slab
-       fix). The AZ unconditional content-tier self-engage applied the full 20% AA darken to
-       EVERY .glass-card/.glass-resting/.glass-quiet/.glass-wash mode- and backdrop-agnostically
-       — over a plain LIGHT page (not a bright/busy backdrop) the 20% warm-ink darken + the
-       muted→ink lift composited the translucent cream card into a flat gray slab (the slides
-       presenter card: 20% → oklab(0.785) gray). The recalibration: the FULL AA darken is now
-       gated on the declared/sampled bright signal (the @container --glass-backdrop:light bucket /
-       the observer); the UNCONDITIONAL content-tier floor drops to this sub-perceptual SILHOUETTE
-       tint — just enough edge over a busy backdrop without graying a calm-light card (the
-       calm-light plate stays warm, L ≈ 0.94 at the slides-equivalent fixture). The overlay band
-       (.glass-floating/.glass-overlay) keeps the FULL unconditional darken (floating over an
-       UNKNOWN consumer surface, darkening is the correct default). A consumer opts out on a
-       light-page ancestor via --glass-tint-strength: 0%. Bounded > 0%, ≤ 10%. The DARK arm
-       re-tunes --glass-tint-strength-aa directly (dark-arm.css scope 3) — the luminous-dark lift
-       is the desired default there, NOT a sub-perceptual floor, so the floor is a light-mode knob. */
-    --glass-tint-strength-floor: 4%;
-
-    /* R5-7 — the VEIL text-plate feather. The `veil-surface` decoration
-       (cards.css) paints a borderless/rimless translucent glass plate as a LOCAL
-       text-legibility surface over a busy backdrop; its `--veil-feather` axis is
-       an OPTIONAL `mask-image` that fades the plate edges into the page (the
-       soft-edged "bleed" the slides deck text plates use). The default is `none`
-       (a clean rectangle); a consumer opts into the feather by pointing
-       `--veil-feather` at this ready-made radial, or any `mask-image` value.
-       The 70%→100% falloff feathers the outer ~30% of the plate; override the
-       token to retune the fade radius library-wide. */
-    --veil-feather-radial: radial-gradient(
-        ellipse 100% 100% at 50% 50%,
-        black 0%,
-        black 70%,
-        transparent 100%
-    );
-
-    /* AW.W23 — chromatic edge dispersion (the "polished glass" rim fringe Apple
-       shows). A warm fringe on one edge + a cool fringe on the other, low-alpha,
-       biased warm-cream/NCSU-red (NOT iOS-blue). Composed OVER the W22 uniform
-       rim under `prefers-reduced-transparency: no-preference`; dropped under
-       `reduce` (it is a transparency garnish). The two directional inset rings
-       read as light refracting through the glass edge. */
-    --glass-fringe-warm: oklch(0.92 0.06 40 / 0.22);
-    --glass-fringe-cool: oklch(0.90 0.05 230 / 0.16);
-    --glass-edge-dispersion:
-        inset 0.75px 0 0 0 var(--glass-fringe-warm),
-        inset -0.75px 0 0 0 var(--glass-fringe-cool);
-
-    /* AX.W52 D19 — the moving-specular gleam radius (glass.css `.glass-material::
-       before`). The ONE knob that BOUNDS the gleam geometry as a percentage of the
-       plate so it can NEVER again become a whole-surface disc (the prior implicit
-       `circle at …` ran its stops to 55–75% of the half-diagonal — a wash on a
-       small tile). 36% reads as a tracked edge glint. Override on `:root` to retune
-       library-wide; a per-surface override clips the gleam tighter/wider. */
-    --glass-specular-size: 36%;
-
-    /* Chassis curvature illusion — a subtle radial gradient at the chassis
-       top centre that lifts the surface without committing to literal 3D.
-       Composed into <InstrumentChassis>'s background stack. AX.W52 D19 — the
-       prior pure-white `hsl(0 0% 100% / 0.06)` reaching `transparent 60%` was a
-       broad top-centre WASH (the #1 fixed-anchor rest-bloom culprit). Re-derived
-       onto the warm-cream house identity (`hsl(40 30% 96%)`, L < 100% so the warm
-       hue survives — mirroring the moving gleam), the alpha routed through the
-       SINGLE overridable `--glass-curvature-intensity` knob (0.02 default, a third
-       of the old 0.06), and the ellipse tightened to `transparent 38%` so it reads
-       as a thin top-edge sheen, not a central wash. */
-    --glass-curvature-intensity: 0.02;
-    --glass-curvature-overlay: radial-gradient(
-        ellipse at 50% -20%,
-        hsl(40 30% 96% / var(--glass-curvature-intensity)),
-        transparent 38%
-    );
-    /* The light-arm dark alias kept on the same warm-cream + token recipe so a
-       non-`.dark` consumer reading `…-overlay-dark` still resolves a softened
-       sheen; the `.dark` block below lowers `--glass-curvature-intensity` so the
-       deep-canvas arm is genuinely softer (the prior byte-identical dark arm read
-       HARDER over the dark canvas). */
-    --glass-curvature-overlay-dark: var(--glass-curvature-overlay);
-
-    /* Chart palette aliases — speedtest et al. read these for phase tinting.
-       Defaults map to viz-basis hues; consumers can override per app. */
-    --chart-ping:     var(--viz-chebyshev);
-    --chart-download: var(--viz-fourier);
-    --chart-upload:   var(--viz-amber);
-    --chart-jitter:   var(--viz-legendre);
-
-    /* O.W6 Lane D — WCAG companion `--chart-{phase}-label` tokens
-       (speedtest AC.W6c.T2 — F1.V-04 closure).
-
-       The canvas-side hues above preserve their saturated brand register
-       (correct against the meter dial); the COMPANION tokens darken to
-       L≈0.40 so phase-label text on `--background` clears the WCAG 2.1
-       AA-body 4.5:1 contrast floor. Mirrors the two-token discipline
-       already established by `--meter-{background-color,track-stroke}`:
-       one token feeds the canvas/visual, the second feeds the label
-       text.
-
-       Light-mode L≈0.40 in OKLCH preserves the hue rotation while
-       dropping luminance enough for body contrast; dark-mode flips to
-       L≈0.85 against the dark canvas. Consumers reach these via
-       `color: var(--chart-ping-label)` (etc.) on label elements ONLY —
-       chart strokes/fills continue to read `--chart-ping`. */
-    --chart-ping-label:     oklch(0.40 0.18 230);
-    --chart-download-label: oklch(0.40 0.20 22);
-    --chart-upload-label:   oklch(0.40 0.16 55);
-    --chart-jitter-label:   oklch(0.40 0.20 305);
-
-    /* O.W6 Lane D — Meter track stroke (speedtest AC.W6c.T3 — F1.V-02
-       closure). Promoted from speedtest's consumer-side declaration so
-       glass-ui owns the canonical light + dark values. The light-mode
-       value reads opaque foreground (composes through canvas
-       `globalAlpha` in consumer renderers; e.g., speedtest's `rings.ts`
-       `globalAlpha = 0.22` lands the phantom-track at the perceptual
-       sweet-spot). The dark-mode companion lives under `.dark` below
-       and ALSO reads `var(--foreground)` — the prior speedtest value
-       `var(--background)` rendered bg-on-bg invisible at dark mode. */
-    --meter-track-stroke: var(--foreground);
-
-    /* Shadow per tier — complete box-shadow lists for glass surface classes */
-    --glass-shadow-wash:     var(--shadow-sm), var(--glass-highlight);
-    --glass-shadow-quiet:    var(--shadow-md), var(--glass-highlight);
-    --glass-shadow-resting:  var(--shadow-lg), var(--glass-highlight);
-    --glass-shadow-floating: var(--shadow-xl),
-        0 0 0 0.5px color-mix(in srgb, var(--shadow-color) 5%, transparent),
-        var(--glass-highlight);
-    --glass-shadow-overlay:  var(--shadow-2xl),
-        0 0 0 0.5px color-mix(in srgb, var(--shadow-color) 8%, transparent),
-        var(--glass-highlight);
-    --glass-shadow:    var(--glass-shadow-quiet);
-    --glass-shadow-lg: var(--glass-shadow-floating);
-
-    /* ─────────────────────────────────────────────────────────────
-       AL-W1-α augmented — SPINE 8th tier (HOUSING register)
-
-       Closes the AK W2 chassis-spine architectural underclaim per
-       AL-X5 §4.1. The spine register is a polished SLEEVE, not glass:
-       NO backdrop-filter, NO plate opacity, hairline outer stroke,
-       interior radial vignette that subtly carries the phase-color
-       cascade. Consumed exclusively by `<InstrumentChassis variant="spine">`
-       at App-level mount paths (quiet-content routes).
-
-       The 4 tokens here cover the minimum viable substrate the SLIM
-       Y4/Y6/Y7 retention set ratified. The 35 rejected axes (saturate
-       band, edge-light per tier, depth-shadow per tier, tier-up macro)
-       stay rejected per the conservative-creation mandate.
-       ───────────────────────────────────────────────────────────── */
-    --glass-spine-opacity: 0;
-    --glass-spine-blur: 0px;
-    --glass-spine-border: var(--surface-tint-8);
-    --glass-spine-vignette: radial-gradient(
-        ellipse at 50% 0%,
-        color-mix(in oklab, var(--phase-color, var(--surface-tint-8)) 8%, transparent),
-        transparent 60%
-    );
-
-    /* ─────────────────────────────────────────────────────────────
-       AL-W10 SLIM — UNDER-SHADOW recipe rungs
-
-       Per AL-X5 §4 + Y7 §3. iOS Liquid Glass surfaces carry a 0.5px
-       dark hairline along the bottom edge (reads as under-shadow /
-       glass thickness). The substrate `--hairline-under-shadow`
-       already publishes one quiet rung; the four-rung ladder here
-       names the SLIM retention set (Y4 §3.2 / Y6 §4.3) — `quiet`,
-       `default`, `vivid`, `spine` cover the consumer landings without
-       multiplying tokens per tier. The 3 hand-rolled literals at
-       `instrument-chassis.css:52`, `dock.css:279`, `dock.css:952`
-       retire to these.
-
-       Composes as a NON-INSET box-shadow layer alongside the existing
-       `--glass-shadow-*` recipe (the inset under-shadow stays at the
-       hand-rolled literal where it's load-bearing on chassis-internal
-       surfaces).
-       ───────────────────────────────────────────────────────────── */
-    --glass-under-shadow-quiet:   0 2px 8px -1px oklch(0 0 0 / 0.04);
-    --glass-under-shadow-default: 0 4px 16px -2px oklch(0 0 0 / 0.08);
-    --glass-under-shadow-vivid:   0 8px 32px -4px oklch(0 0 0 / 0.12);
-    --glass-under-shadow-spine:   0 1px 0 0 oklch(0 0 0 / 0.06);
-
-    /* Overlay scrim rungs — substrate-aware modal/dialog backdrop tints.
-       Three weights cover the deployed range: dialog-scroll (subtle),
-       canonical modal (default), drawer/full-cover (strong).
-
-       AY.W-PRIM-POLISH D3 — the scrim is its OWN identity token, NOT derived
-       from `--shadow-color`. A scrim's role is to RECEDE: it must pin to INK in
-       BOTH modes. The cartoon-shadow family rides `--shadow-color: var(--foreground)`
-       (correct — a shadow re-tints under `.dark` by construction), but a scrim
-       that does the same FLOODS the dark room with a cream fog (the old dark
-       overlay painted `srgb(0.91… / 0.5)`, a near-white wash that BRIGHTENED the
-       page at the modal moment). `--overlay-scrim-ink` is a fixed warm near-black
-       (the light-mode `--foreground` value), re-resolved verbatim in `.dark` so
-       the scrim recedes in both modes. Clean break, no alias (no-backwards-compat).
-       The `--shadow-color` / `--shadow-cartoon-*` family is UNTOUCHED. */
-    --overlay-scrim-ink:     hsl(24 10% 10%);
-    --overlay-scrim:         color-mix(in srgb, var(--overlay-scrim-ink) 50%, transparent);
-    --overlay-scrim-strong:  color-mix(in srgb, var(--overlay-scrim-ink) 80%, transparent);
-    --overlay-scrim-subtle:  color-mix(in srgb, var(--overlay-scrim-ink) 40%, transparent);
-
+    /* The decorative/fx tail (grain/specular/edge-light + the adaptive tint-source/
+       backdrop-luma bucket + fringe/curvature/chart-palette + per-tier shadow/spine/
+       under-shadow/overlay-scrim) lives in tokens/glass-fx.css (carved at BB.W-CARVE4
+       — the next adjacent :root{} block in the cascade). */
 }

package/dist/styles/tokens/light-dark.css

@@ -88,8 +88,11 @@
         --neutral-5: light-dark(hsl(30 22% 40%), hsl(34 14% 62%));
         --neutral-6: light-dark(hsl(28 24% 30%), hsl(36 14% 72%));
 
-        /* Core surfaces + ink */
-        --foreground:                 light-dark(hsl(24 10% 10%), hsl(48 10% 90%));
+        /* Core surfaces + ink. BB.W-DARK-INK-WARM — the DARK arg warmed off the H95.1°
+           yellow-green hsl(48 10% 90%) onto the no-gray identity hsl(30 14% 90%) (OKLab
+           H75.4°, L held) in LOCKSTEP with the .dark fallback floor (dark-arm.css:60). The
+           LIGHT arg hsl(24 10% 10%) is already the warm-amber identity (H56°) — untouched. */
+        --foreground:                 light-dark(hsl(24 10% 10%), hsl(30 14% 90%));
         /* BA.W-DARK-MATERIAL scope 1 — the dark --card plate LIFTS L10→L16 (LOCKSTEP
            dark-arm.css:51); the public-data panel re-anchors L12→L18 to stay above it.
            BA.W-NO-GRAY L1 — the LIGHT arm DECOUPLES off the near-achromatic page onto the
@@ -128,7 +131,7 @@
         --section-color-2:   light-dark(oklch(0.484 0.163 265.5), oklch(0.718 0.107 268.4));
         --section-color-3:   light-dark(oklch(0.542 0.089 222.8), oklch(0.767 0.091 219.9));
         --section-color-4:   light-dark(oklch(0.551 0.088 171.1), oklch(0.776 0.105 172.6));
-        --section-color-5:   light-dark(oklch(0.623 0.124 69.6),  oklch(0.813 0.109 78.2));
+        --section-color-5:   light-dark(oklch(0.530 0.124 69.6),  oklch(0.813 0.109 78.2));
         --section-color-6:   light-dark(oklch(0.579 0.201 30.4),  oklch(0.693 0.151 28.1));
         --section-color-7:   light-dark(oklch(0.532 0.180 317.5), oklch(0.739 0.134 318.1));
         --section-color-8:   light-dark(oklch(0.520 0.176 8.4),   oklch(0.709 0.142 2.3));
@@ -183,5 +186,15 @@
         --silver:       light-dark(oklch(0.760 0.012 255), oklch(0.792 0.012 255));
         --silver-light: light-dark(oklch(0.902 0.010 255), oklch(0.912 0.010 255));
         --silver-dark:  light-dark(oklch(0.582 0.014 255), oklch(0.648 0.014 255));
+
+        /* Bronze family (BB.W-METAL-SHIMMER) — the `light-dark()` arm mirroring
+           gold's exact shape: light value, dark-lifted value (~+0.03 L so the warm
+           metal reads on the deep canvas). The third brand metal (warm-brown ~54°,
+           chroma above the W-NO-GRAY floor). `--bronze-deep` is mode-invariant —
+           not a `light-dark()` pair, exactly as `--gold-deep`/`--silver-deep` are
+           omitted from this block. */
+        --bronze:       light-dark(oklch(0.620 0.092 54.0), oklch(0.650 0.090 54.0));
+        --bronze-light: light-dark(oklch(0.760 0.112 60.0), oklch(0.790 0.110 60.0));
+        --bronze-dark:  light-dark(oklch(0.500 0.082 50.0), oklch(0.560 0.085 50.0));
     }
 }