@mkbabb/glass-ui 4.2.0 → 5.0.0

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

@@ -15,6 +15,18 @@
    `--background`/`*-foreground` aliases) are DELETED — they auto-track the
    `--neutral-*` ladder + `--foreground` resolved above; only EXPLICIT-color
    dark values (and the non-color overrides §2d) stay.
+
+   IDIOM-REVERSAL (BG.W-GLASS-BASIS-CONSOLIDATE, R16 MN-1) — one mechanism per
+   token TYPE. COLOR tokens: light-dark.css is the CANONICAL single source; the
+   `.dark {}` color values below are the fallback-floor LOCKSTEP WITNESSES —
+   they MUST byte-agree with the light-dark() dark arg, never a second value
+   (`proof:glass` clause DA1 reds a divergence). SHADOW / INSET /
+   inheritance-sensitive tokens (the rims, the specular, the cartoon/modal
+   shadows, the recess ink) are the PRIMARY residents here as plain `.dark {}`
+   arms — NEVER `light-dark()` (a `light-dark()` wrapping shadow fragments
+   computes the WHOLE box-shadow to `none`, the inset-shadow trap; `proof:glass`
+   DA2 reds a shadow-valued light-dark()). This SUPERSEDES the plain per-mode
+   pair idiom for COLOR tokens (the reversal is INTENTIONAL, recorded here).
    ═══════════════════════════════════════════════ */
 .dark {
     /* §1 — hard-pin native chrome to dark regardless of OS preference. §4 —
@@ -97,9 +109,16 @@
        (4.60:1 as ink over --card / 5.03:1 as a plate vs page). */
     --destructive: hsl(0 80% 60%);
     --destructive-foreground: hsl(48 10% 90%);
-    --ring: hsl(48 10% 70%);
+    /* BG.W-DESHADCN — the dark arm of the renamed house focus-accent register
+       (off the shadcn `--ring` token; the value is byte-identical to the prior
+       dark `--ring` mid-tone). */
+    --focus-ring-color: hsl(48 10% 70%);
     --shadow: hsl(0 0% 5%);
 
+    /* BG.W-DESHADCN — the `ai` label ink, dark arm (lifted off the light 0.55 to
+       clear the deep canvas; the plain per-mode pair). */
+    --accent-ai-ink: oklch(0.80 0.13 75);
+
     /* Section palette — brightened for dark backgrounds (oklch; AV.W16 TW2 —
        mirrors the light-dark() dark halves above; hue preserved) */
     --section-color-0:  oklch(0.721 0.145 354.0);
@@ -164,21 +183,22 @@
     --warning-foreground: hsl(24 10% 10%);
     --info-foreground:    hsl(48 10% 96%);
 
-    /* BD.W-CARTOON-CEL-INK — the WARM DARK ink. In dark, `--foreground` flips to
-       near-cream, so the SAME `oklch(from --foreground …)` construction would lift the
-       ink toward a light warm LINE (the iOS-7-sticker glow). A cel cast is dark INK on
-       any cel — so the dark ink is built by the SAME `oklch(from)` mechanism (NOT a
-       hardcoded `oklch(0.22 0.07 70)` literal — the H3/R6 retirement) but L-TARGETED to
-       a warm MID-tone: `clamp(0.20, 1 − l, 0.30)` deepens the flipped-cream L back down
-       to a warm dark mid that READS as a defined edge against the near-black `--card`
-       (ΔL ≥ 0.12), chroma floored `max(c, 0.11)` for TECHNICOLOR, hue preserved. The
-       opacity rungs floor UP (46/38/26%) for presence on the dark ground. Plain `.dark`
-       ancestor — NO `:global()`, NO `light-dark()` (the recorded traps). */
-    --cartoon-ink: oklch(from var(--foreground) clamp(0.20, calc(1 - l), 0.30) max(c, 0.11) h);
+    /* BG.W-CARTOON-INK-GAMUT — the DRY-collapse. The dark `--cartoon-ink:` re-declaration
+       is DELETED — the `:root` in-gamut pin (shadow.css) cascades through the dark
+       `--foreground` directly. In dark, `--foreground` is near-cream (high L) so the
+       pin's `clamp(0.28, l, 0.34)` clamps L UP to its 0.34 ceiling — a warm-brown dark
+       sticker (the maroon `clamp(0.20, 1−l, 0.30) max(c, 0.11)` re-paste is retired; that
+       out-of-gamut chroma floor collapsed to `rgb(48,5,0)`, B=0). The dark pin resolves
+       ~rgb(65,54,38) at OKLab hue ~77° — warm brown (R>G>B>0) in the [45,85]° register.
+       ONLY the mode-correct alpha rungs (46/38/26% — a heavier ink for presence on the
+       dark ground than light's 32/26/18%) + the re-derived warm fallback stay here. */
     --cartoon-ink-lead:    color-mix(in oklab, var(--cartoon-ink) 46%, transparent);
     --cartoon-ink-mid:     color-mix(in oklab, var(--cartoon-ink) 38%, transparent);
     --cartoon-ink-contact: color-mix(in oklab, var(--cartoon-ink) 26%, transparent);
-    --cartoon-ink-fallback: #5a3f28;
+    /* Re-derived from the dark pin's RESOLVED sRGB at the dark `--foreground`
+       (`oklch(0.34 0.030 75°)` → ~rgb(65,54,38)); the old `#5a3f28` assumption is dropped
+       (the painted L floors below nominal — a warm-brown, never gray, never maroon). */
+    --cartoon-ink-fallback: #413626;
 
     --shadow-cartoon:       -3px 3px 0px 0px var(--cartoon-ink-lead);
     --shadow-cartoon-hover: -4px 4px 0px 0px var(--cartoon-ink-lead);
@@ -246,59 +266,6 @@
     --paper-grain-opacity: 0.16;
     --glass-highlight: inset 0 0.5px 0 0 hsl(0 0% 100% / 0.08);
 
-    /* BA.W-DARK-MATERIAL scope 2 — dark glass is TRANSMISSIVE. The dark rung
-       backdrop-filter carries a saturate/brightness LUMINOSITY LIFT (the iOS-dark
-       "dark glass glows where light passes" model) so a backdrop GLOWS through the
-       plate instead of dying behind it. The light arm sits at saturate(1.05) — over a
-       near-black canvas that reads as no transmission; the dark arm lifts it so the
-       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.
-
-       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);
-    /* W-NAV-DOCK-FIX — re-point the dark dock saturate to the named --glass-saturate-dock
-       knob (the single retune point in BOTH modes; the dark value 1.30 is declared here
-       so the descendant var() substitutes the dark value — the substitution-vs-redeclare
-       discipline). Value unchanged. */
-    --glass-saturate-dock: 1.30;
-    --glass-blur-dock:     blur(calc(var(--glass-blur-dock-radius) * var(--glass-level))) saturate(var(--glass-saturate-dock)) 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
@@ -341,11 +308,38 @@
        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) */
+    --on-glass-muted:        hsl(34 16% 72%);   /* brighter than the collapsed --neutral-5 L62 (WCAG 7.52:1 / APCA |Lc| 61.7 vs the luminous-dark composited quiet plate; subordinate to --foreground — F2.R1 census witness) */
+    --on-glass-muted-strong: hsl(36 13% 81%);   /* the -strong rung, one step more present. RECALIBRATED at F2.R2 (paint re-open) from L78 → L81: the full-route re-run census found the BRIGHTEST on-glass mid-tone plate (the configurator preset-label glass-capsule, composited [100,85,68] L≈0.10) drove the -strong caption to WCAG 4.33 — below AA. L81 clears the whole census plate set (configurator 4.68 · shadow-stage 6.89 · texture-panel 6.47 · feedback-tone 6.74 · selected-chip 5.10) while STAYING subordinate to the L90 --foreground ink (L0.634 < L0.794). One register re-point, all -strong consumers lift in lockstep — the DRY register-level fix, NOT a per-site paste. */
     --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 */
 
+    /* ── F2.R1 W-DARK-READABILITY-REPAIR — the card field-floor DARK ARM (A1) ──────
+       The BD.W-CARD-FIELD-FLOOR orphan fallback (cards.css) paints two amber radials
+       (oklch(0.96 0.04 78 / .5) + oklch(0.9 0.075 72 / .5)) SCREEN-blended on every
+       glass card with no `[data-paper-field]` ancestor — and it shipped NO dark arm,
+       so under `.dark` the near-white L≈0.9-0.96 stops paint at FULL strength + the
+       dark-arm `brightness()` backdrop lift compounds them into a hot in-card LAMP
+       (value.js card-lighting-forensics 2026-07-05, artifacts 1+3: the cream-label
+       hot-zone contrast collapsed to ~1.5-2.6:1). The dark arm collapses the two hot
+       SCREEN radials to ONE damped warm-DARK sink — oklch(L 0.34, warm hue 66, C
+       0.055 ABOVE the W-NO-GRAY strong gray floor 0.020) blended NORMAL (a warm
+       depth that SINKS into the deep plate, NEVER a screen lamp). The plate STAYS
+       dark, so the cream `--foreground` label reads WCAG ≥ 11:1 / APCA |Lc| ≥ 88 over
+       the hot zone (proven by the census), while the card keeps its warm-not-gray
+       identity (the card material `--glass-tint-strength: 8%` + the `--glass-rim-top`
+       0.40 catch carry the lit-glass read; the light-mode amber KEY is a light-mode
+       device). The 0-alpha stop is explicit `oklch(… / 0)`, NEVER bare `transparent`
+       (the WebKit black-premultiply hole, build-trap-(d)). The light default lives in
+       the cards.css var() fallback (this token unset in light → byte-identical light
+       paint). Machine-locked by `proof:glass` dark-legibility DL1. */
+    --card-field-floor-image:
+        radial-gradient(
+            120% 110% at 78% 22%,
+            oklch(0.34 0.055 66 / 0.35),
+            oklch(0.34 0.055 66 / 0) 72%
+        );
+    --card-field-floor-blend: normal;
+
     /* 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
@@ -459,4 +453,3 @@
     --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

@@ -1,60 +1,67 @@
 /*
- * glass-deep.css — BB.W-DEEP-GLASS — the OPT-IN deep-glass token family.
+ * glass-deep.css — BG.W-DEEP-GLASS-DECIDE — 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).
+ * DEEP-GLASS-DECIDED: retired-at-16px-cost-0B-profile-budget-per-frame-blind
  *
- * 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 TERMINAL VERDICT — the 5-tranche ride ENDS here (GA-7) ──────────────
+ * The deep tier ships at 16px / saturate 1.8. The Apple `blur(20px)` push is NOT
+ * "the successor" — it is DECIDED: 16px IS this substrate's blur ceiling, stated
+ * as IDENTITY, not debt. The BB->BC->BD->BE->BF->BG ride TERMINATES. The recorded
+ * number that fenced it:
+ *   - `profile:budget` (the repo's ONLY committed budget gate) is BYTE-measuring:
+ *     the 16->20px change is a 2-char CSS literal that gzip-compresses IDENTICALLY,
+ *     so a 20px bump "clears" it at delta-0 bytes (dist/glass-ui.css gzip ~10.04
+ *     kB, unmoved). That clearance is PER-FRAME-BLIND — it proves nothing about
+ *     the deep blur's real cost, so landing 20px on it would be a green-over-broken
+ *     close. The profile:budget number can NOT fence this decision.
+ *   - The GENUINE per-frame fence is `proof:nested-backdrop-budget` — a LOCAL pi
+ *     60fps/16.7ms frame-budget gate over the live nested-glass stack. `backdrop-
+ *     filter: blur()` cost is super-linear in the radius past ~16px, and the deep
+ *     tier renders over LIVE animated backdrops (the dock over aurora, the hero
+ *     CTA) — the worst case for per-frame backdrop re-rasterization. No committed
+ *     per-frame render-cost harness clears 20px on that surface.
+ *   - The whole design trajectory dials blur DOWN: W-GLASS-CAL cut every calm rung
+ *     ~15-20% (floating 16->13px) on the user's "a hair too much" over-diffusion
+ *     call. 20px would push the deep tier BACK toward the diffusion the user
+ *     rejected — wrong direction. The warm-cream light-concentration ceiling
+ *     (AX.W52 D19 — a saturate/blur that over-juices a colored substrate reads as
+ *     a garish smear) keeps 16px "just-rich" over warm-aurora.
+ * So: 16px is the ceiling. The saturate ALREADY reached the Apple 1.8 ceiling
+ * (BD.W-GLASS-ABROGATE-GRAY), so the deep tier IS at its design-language depth on
+ * BOTH axes — deeper blur than calm floating (16>13px), richer saturate (1.8>1.6).
  *
- * ── 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 family shape ───────────────────────────────────────────────────────
+ * A SEPARATE `--glass-blur-deep-*` token family ABOVE the W-GLASS-CAL calm
+ * default. 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). §8-ladder partial
+ * sibling of tokens/glass.css (kept OUT so glass.css stays under the 500-line
+ * ratchet); @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 luminous-dark companion).
  *
- * ── 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).
+ * ── The Apple-range derivation (DELTA cross-ref) ───────────────────────────
+ * Apple home nav:        saturate(1.8) blur(20px)  (the canonical measure)
+ * Apple product tiers:   blur(14-20px)             (the band)
+ * glass-ui calm ceiling: floating 13px / saturate 1.6   (W-GLASS-CAL dial-back)
+ * glass-ui DEEP (ship):  16px / saturate 1.8       (STRICTLY deeper blur + richer
+ *                        saturate; 16px is the DECIDED ceiling — see the verdict
+ *                        above, IDENTITY not debt).
  */
 :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-blur-deep-radius:    16px; /* in [14,20], STRICTLY > calm floating 13px.
+                                          DECIDED CEILING (BG.W-DEEP-GLASS-DECIDE):
+                                          16px IS this substrate's blur ceiling —
+                                          IDENTITY, not debt. The 20px push is RETIRED
+                                          (per the header verdict), never a successor:
+                                          the per-frame cost is super-linear past ~16px
+                                          over the deep tier's live animated backdrops
+                                          + the W-GLASS-CAL dial-back is binding. */
     --glass-saturate-deep:       1.8;  /* BD.W-GLASS-ABROGATE-GRAY — lifted 1.5→1.8 (the
                                           apple.com nav ceiling) IN LOCKSTEP with FIX-D's
                                           content/floating saturate lift, so the deep tier
@@ -66,39 +73,54 @@
                                            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(
-            var(--glass-saturate-floating)
-            + (var(--glass-saturate-deep) - var(--glass-saturate-floating)) * var(--glass-depth)
-        );
+    /* ── The deep LERP is COMPUTED AT THE CONSUMING `.glass-deep` ELEMENT, not here
+       (BG.W-GLASS-DEPTH-TIER freeze-fix) ────────────────────────────────────────
+       The deep blur/saturate LERP intermediates — `--glass-blur-deep-active-radius`,
+       `--glass-saturate-deep-active`, `--glass-blur-deep` — are NOT declared in this
+       `:root` block. They live on the `.glass-deep` rule (glass/deep.css). WHY: they
+       read `var(--glass-depth)` (AND `var(--glass-level)`), and BOTH are REGISTERED
+       `@property`s (property-regs.css §glass-level / §deep, `inherits: true`,
+       `initial-value: 1`). A `var()` reference to a REGISTERED custom property inside
+       ANOTHER custom property is eager-substituted with the referenced property's
+       COMPUTED value AT THE DECLARING ELEMENT (CSS Properties & Values API). Declared
+       here at `:root`, `--glass-depth` computes to its `@property` `initial-value` 1,
+       so the LERP would BAKE `calc(… * 1)` and inherit that FROZEN string down — every
+       deep surface would paint the depth-1 (16px / saturate 1.8) ceiling REGARDLESS of
+       its tier grade (the painted DEAD-KNOB the C18 dual-engine judge caught 2026-07-05:
+       a deep BUTTON read as thick as a deep MENU). The tier map (glass/deep.css
+       `:where()` rules) sets `--glass-depth` PER TIER on the base rung; the LERP must
+       therefore be declared on `.glass-deep` — the SAME element, at/below the tier-grade
+       site — so `var(--glass-depth)` resolves to the element's LIVE tier grade and the
+       ladder PAINTS (content ~14px < popover ~15px < menu 16px). Only the ENDPOINTS +
+       GRADES stay here (they are literals — no registered-`@property` read — so their
+       `:root` declaration is safe); the COMPOSITION moves to the consuming element. */
+
+    /* ── The tier-depth MAP — thickness tracks surface PROMINENCE (BG.W-GLASS-DEPTH-TIER) ──
+       iOS-27 grammar: larger glass = thicker material AUTOMATICALLY — a control
+       flexing into a menu GAINS depth as part of the morph (WWDC25). glass-ui's deep
+       tier was opt-in per class at a UNIFORM --glass-depth: 1, so thickness did NOT
+       track prominence (a deep button read as thick as a deep menu). This MAP grades
+       the ONE --glass-depth scalar onto the tier ladder: the more-prominent overlay/
+       menu rungs default a HIGHER depth than the content rungs, so ANY deep surface
+       resolves its thickness BY CONSTRUCTION — menu > popover > button.
+
+       ZERO new machinery: the deep recipe already LERPs blur+saturate on --glass-depth
+       (D1), so a grade is a pure per-rung DEFAULT of the EXISTING scalar — no new blur
+       family, no new @property, no new compositing seam. The three grades span the
+       decided deep band [depth 0 ≡ the calm floating 13px floor, depth 1 ≡ the 16px
+       Apple-deep ceiling], so a content-tier deep control still clears the calm
+       floating floor (depth > 0) while only the menu/overlay rung reaches the full
+       ceiling: content ~14px < popover ~15px < menu 16px, saturate 1.67 < 1.74 < 1.8.
 
-    /* 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));
+       The grades are NAMED (not magic literals) so a consumer retunes a WHOLE BAND
+       from ONE ancestor override (`--glass-depth-popover: …`) — the per-band twin of
+       the global `--glass-depth` ancestor dial; the tier rules (glass/deep.css) read
+       these, so the override cascades in. */
+    --glass-depth-content: 0.35; /* content/button deep (wash/quiet/resting base) — the
+                                    LEAST-prominent deep rung: ~14.05px / saturate ~1.67. */
+    --glass-depth-popover: 0.7;  /* popover/dialog/menu-content + Card deep (floating
+                                    base) — the mid rung: ~15.1px / saturate ~1.74. */
+    --glass-depth-menu:    1;    /* menu/modal (overlay base) — the MOST-prominent deep
+                                    rung, at the full Apple-deep ceiling (16px / 1.8);
+                                    == the resting --glass-depth initial-value. */
 }

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

@@ -23,8 +23,12 @@
     /* BD.W-PAPER-MORPHISM — re-calibrated to the JND floor for the CORRECTED coarse
        tooth + multiply blend (std ≥ 4.5 light, the no-squint floor): multiply on the
        cream pole is GENTLE so it needs MORE alpha. The prior 0.08 rode a blend
-       (overlay) that was mathematically incapable of moving a near-white pixel. */
-    --paper-grain-opacity: 0.22;
+       (overlay) that was mathematically incapable of moving a near-white pixel.
+       BG.W-PAPER-GRAIN-OPTIN — the universal grain plane is RETIRED (the shell field
+       is the recessive aurora; grain is now PER-SURFACE opt-in). The opt-in alpha is
+       nudged sub-JND (0.22 → 0.21) for the per-surface register — barely perceptible,
+       so opt-in cards/panels read tactile-but-calm without the full-page wash. */
+    --paper-grain-opacity: 0.21;
     /* BB.W-LIQUIDHOVER — the grain ENGAGE clock: a hover/active grain lift cross-fades
        the grain `::after` OPACITY on this thin ~120ms linear write while the
        `background-image` stays ALWAYS PRESENT (never a none→image swap — the one-frame
@@ -111,6 +115,20 @@
     --glass-key-lit-y: 1px; /* …and the TOP edge — the upper-right key */
     --glass-key-shade-x: 1px; /* the under-shadow grounds the LEFT edge */
     --glass-key-shade-y: -1px; /* …and the BOTTOM edge — opposite the key */
+    /* BI.W-SURFACE-EXTRACT / atlas GU-1 · O-E2 — the `--glass-key-direction`
+       under-shadow KEY-LIGHT LEAN. The two-stop rim (above) SELECTS which edge is lit
+       vs shade (edge-select px tokens); this is the DISTINCT cast-RATIO knob for the
+       non-inset under-shadow FILL family (the 3 tiers below), which historically cast
+       STRAIGHT DOWN (X = 0). ONE write leans the whole under-shadow register
+       library-wide (the 3 tiers + the dock-wrap vivid consumer all read it). It is a
+       RATIO (unitless), multiplied into each tier's Y magnitude to give the X:
+       -0.375 = tan 20.56° down-LEFT is the cel-coherent FILL lean atlas sets (cel cast
+       = 45° KEY, under-shadow = 20.56° FILL — one light). The LIBRARY DEFAULT is `0`
+       (straight-down) so the shipped under-shadow is byte-identical (the
+       BI.W-SURFACE-EXTRACT refactor-not-repaint π holds); atlas / a future identity
+       wave sets `-0.375` via this ONE token (presets-in-consumers). The spine rung is
+       INTENTIONALLY-OMNIDIRECTIONAL (an edge-thickness cue, not a cast) — left unleaned. */
+    --glass-key-direction: 0;
     /* BC.W-BLACK-BAR D2 + BD.W-GLASS-KEY-EDGE — the two-stop directional rim, now
        KEY-DRIVEN: the bright catch-light `--glass-rim-top` rides the lit (key-facing)
        edges, the faint warm under-shadow `--glass-rim-bottom` rides the shade edges.
@@ -202,6 +220,14 @@
                                 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).
+                                BG.W-GLASS-SIGNAL-TRUTH (M7) — the band-driver decision
+                                RECONCILED to ONE: the declarative bucket above IS the
+                                BAND driver; the continuous `--glass-backdrop-luma` clamp
+                                (glass/ladder.css) is the DYNAMIC REFINEMENT that engages
+                                WHERE A WRITER FIRES (the dock; a wired band surface). The
+                                ladder.css "clamp retires the bucket as driver" claim was
+                                the contradictory-canon half, now removed — one recorded
+                                text, no double-ownership.
          --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
@@ -427,9 +453,13 @@
        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);
+    /* atlas GU-1/O-E2 — the X cast leans off the ONE `--glass-key-direction` ratio
+       (default 0 → byte-identical straight-down cast; atlas sets -0.375 for the
+       cel-coherent down-left FILL lean). Y/blur/spread/α byte-unchanged. The spine
+       rung stays INTENTIONALLY-OMNIDIRECTIONAL (an edge-thickness cue, no cast). */
+    --glass-under-shadow-quiet:   calc(2px * var(--glass-key-direction)) 2px 8px -1px oklch(0 0 0 / 0.04);
+    --glass-under-shadow-default: calc(4px * var(--glass-key-direction)) 4px 16px -2px oklch(0 0 0 / 0.08);
+    --glass-under-shadow-vivid:   calc(8px * var(--glass-key-direction)) 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.