@mkbabb/glass-ui 4.1.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 —
@@ -71,8 +83,8 @@
     /* 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. */
-    --card: hsl(24 8% 16%);
-    --popover: hsl(24 8% 16%);
+    --card: hsl(26 22% 17%);
+    --popover: hsl(26 22% 17%);
 
     /* R0G-5 (AO.W4) — dark mirror of the warm-neutral public-data panel.
        --card's dark hsl(24 8% 16%) nudged one warmth step toward amber
@@ -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,12 +183,29 @@
     --warning-foreground: hsl(24 10% 10%);
     --info-foreground:    hsl(48 10% 96%);
 
-    --shadow-cartoon:       3px 3px 0px 0px color-mix(in srgb, var(--foreground) 6%, transparent);
-    --shadow-cartoon-hover: 4px 4px 0px 0px color-mix(in srgb, var(--foreground) 8%, transparent);
+    /* 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);
+    /* 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);
     --shadow-soft:     0 4px 12px rgba(0, 0, 0, 0.3);
     --shadow-elevated: 0 8px 24px rgba(0, 0, 0, 0.35);
     --shadow-modal:
-        4px 4px 0px 0px color-mix(in srgb, var(--foreground) 6%, transparent),
+        -4px 4px 0px 0px var(--cartoon-ink-lead),
         0 24px 64px color-mix(in srgb, var(--foreground) 18%, transparent);
 
     --shadow-cartoon-color:            rgb(255 255 255 / 0.07);
@@ -222,56 +258,14 @@
        automatically per mode. */
     --glass-opacity-dialog:   0.76;
     --glass-grain-opacity: 0.045;
+    /* BD.W-PAPER-MORPHISM — re-calibrated to the JND floor for the CORRECTED coarse
+       tooth + SCREEN blend (std ≥ 3.86 dark): screen on the ink pole BITES HARD so it
+       needs LESS alpha (the honest inversion the measurements force — the opacity
+       ladder light→dark 0.22→0.16 ≈ ×1/√φ, dark steps DOWN). Was 0.11 on the
+       self-cancelling soft-light arm. */
+    --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);
-    --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
@@ -288,6 +282,13 @@
        self-engage uses the AA arm directly (the luminous-dark lift is the desired default,
        not a sub-perceptual silhouette). */
     --glass-tint-strength-aa: 12%;
+    /* BD.W-DOCK-CORE (D4) — the dark §2c dock-ink lockstep (the MIRROR of the light
+       darken). In dark the dock tint is a LIFT toward a luminous warm-cream (L 0.90,
+       C 0.045) — `oklch(from var(--foreground) …)` extracts the dark foreground's warm
+       hue/chroma and lifts L (the dark `--foreground` is the light cream, so this stays a
+       luminous lift). The dark `--glass-tint-strength-aa` stays 12% (FROZEN,
+       W-DARK-MATERIAL). The dock self-engage reads this dock-scoped ink in BOTH modes. */
+    --glass-tint-ink-dock: oklch(from var(--foreground) 0.90 0.045 h);
     /* The unconditional content-tier self-engage (glass/ladder.css) reads
        --glass-tint-strength-floor. In LIGHT that is the 4% sub-perceptual silhouette (the
        calm-light card stays warm); in DARK the content tiers WANT the full luminous-dark
@@ -307,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
@@ -368,8 +396,23 @@
        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);
+    /* BD.W-GLASS-KEY-EDGE — the dark rim rides the SAME `--glass-key-{lit,shade}-{x,y}`
+       sign tokens (inherited from :root — not re-declared here) so the dark plate's
+       lit edge agrees with the cartoon cast's key in both modes. The top/lit catch
+       lifts to 0.40 (the dark silhouette device); the key-facing side stop a touch
+       brighter (0.24). The shade under-shadow holds warm at 6%/4%. */
+    --glass-rim-top:
+        inset 0 var(--glass-key-lit-y) 0 hsl(0 0% 100% / 0.40),
+        inset var(--glass-key-lit-x) 0 0 hsl(0 0% 100% / 0.24);
+    --glass-rim-bottom:
+        inset 0 var(--glass-key-shade-y) 0 color-mix(in srgb, var(--foreground) 6%, transparent),
+        inset var(--glass-key-shade-x) 0 0 color-mix(in srgb, var(--foreground) 4%, transparent);
+
+    /* BD.W-TAB-IOS-CAPSULE — the `.glass-capsule-track` recess ink, DARK arm (the
+       PLAIN per-mode pair's dark leg; the light arm is in `tokens/glass-fx.css`).
+       NEVER a `light-dark()` fragment (the inset-shadow trap). Deeper on the dark
+       canvas (11%) so the sunken well still reads against the near-black page. */
+    --tab-track-recess-ink: color-mix(in srgb, var(--foreground) 11%, 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-
@@ -410,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,100 +1,126 @@
 /*
- * 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-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-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
+                                          STAYS the richest register (calm floating now 1.6;
+                                          deep must clear it). == --glass-saturate-deep-ceiling
+                                          (1.8 — at the bound, never over-shot, L4 holds). */
     --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 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

@@ -15,6 +15,20 @@
        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;
+    /* BD.W-PAPER-MORPHISM — the PAPER grain is its OWN register (~3× the glass grain):
+       paper texture is MEANT to READ (the user: "I don't see any paper grain or grit
+       anywhere"), not sit at the glass perceptual floor. ONE token retunes paper grit
+       library-wide WITHOUT coarsening the subtle glass-material grain (the split keeps
+       glass calm + paper tactile). The dark arm (dark-arm.css) lifts it for soft-light. */
+    /* 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.
+       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
@@ -85,8 +99,53 @@
        re-declares both in dark-arm.css; light-dark() round an inset computes the WHOLE
        box-shadow to none). The dark arm lifts the top to 0.40 (dark glass glows where
        light passes) + keeps the bottom under-shadow at 6%. */
-    --glass-rim-top:         inset 0 1px 0 hsl(0 0% 100% / 0.30);
-    --glass-rim-bottom:      inset 0 -1px 0 color-mix(in srgb, var(--foreground) 6%, transparent);
+    /* BD.W-GLASS-KEY-EDGE — the cel KEYSTONE. ONE light vector (the 1940s cel
+       upper-right key) drives WHICH edge of the existing two-stop directional rim
+       reads LIT vs SHADE, in lockstep with the shipped `.shadow-cartoon-*` down-LEFT
+       cast (shadow.css `-Npx Npx` → key upper-right). The key is expressed NOT as a
+       `-58deg` angle with sign-inverted cos()/sin() trig (the glass-material sign
+       trap — banned here), but as two PLAIN per-axis sign tokens the rim stops read
+       directly: the LIT catch wraps the key-facing edges (top + right), the SHADE
+       under-shadow grounds the opposite edges (bottom + left). A consumer re-points
+       `--glass-key-lit-x`/`--glass-key-lit-y` to move the key (e.g. upper-LEFT →
+       `1px`/`1px`) and the rim re-reads off it with ZERO new layer, ZERO new conic,
+       ZERO new DOM node. The key's SIGN tokens below are the wired form (the
+       upper-right keystone). */
+    --glass-key-lit-x: -1px; /* the lit catch sits on the RIGHT edge (key-facing) */
+    --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.
+       Which edge each lands on is `--glass-key-{lit,shade}-{x,y}` so the rim and the
+       cartoon cast AGREE on one light source (the cel coherence). At the default
+       upper-right key these resolve byte-compatibly to the shipped top-lit/bottom-shade
+       silhouette (top catch + bottom under-shadow) PLUS the key-facing side stops, so
+       the lit edge reads as a real lit pane corner, not a flat omnidirectional halo.
+       The accent (BB.W-GLASS-ACCENT) still mixes onto the lit ink in rim.css — at 0%
+       strength byte-identical. Plain per-mode arms — NEVER an inset fragment inside
+       light-dark() (the dark arm re-declares both in dark-arm.css). */
+    --glass-rim-top:
+        inset 0 var(--glass-key-lit-y) 0 hsl(0 0% 100% / 0.30),
+        inset var(--glass-key-lit-x) 0 0 hsl(0 0% 100% / 0.18);
+    --glass-rim-bottom:
+        inset 0 var(--glass-key-shade-y) 0 color-mix(in srgb, var(--foreground) 6%, transparent),
+        inset var(--glass-key-shade-x) 0 0 color-mix(in srgb, var(--foreground) 4%, transparent);
     /* 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
@@ -116,6 +175,29 @@
     --glass-tint-source:   var(--card);
     --glass-tint-strength: 0%;
 
+    /* BD.W-TAB-IOS-CAPSULE — the `.glass-capsule` warm-floor (C6). `--card` itself
+       is too pale to clear the meanChroma ≥ 0.02 floor (its own OKLab chroma is
+       ~0.015), so the capsule composes a SMALL fixed floor toward an explicitly
+       WARM oklch source — a warm cream/amber that carries real chroma. This is the
+       build-trap-(d) safe form (a warm color, never bare `transparent`). At the 16%
+       floor the painted capsule fill clears chroma ≥ 0.02 with negligible L lift
+       (stays near-white). Mode-invariant warm (the oklch reads warm on both the
+       light cream page and the dark canvas — the warm-floor is a property of the
+       LOZENGE, not the page); the floor is INDEPENDENT of the `--glass-tint-strength:
+       0%` adaptive default (which is zero-delta at rest, lifting only under the
+       bright bucket). Both are composed in `.glass-capsule`'s fill. */
+    --glass-capsule-warm: oklch(0.88 0.1 75);
+    --glass-capsule-warm-floor: 16%;
+
+    /* BD.W-TAB-IOS-CAPSULE — the `.glass-capsule-track` recess ink (the iOS-27
+       sunken-well inner-top edge). A PLAIN per-mode pair — this light arm + the dark
+       arm in `tokens/dark-arm.css`. NEVER a `light-dark()` fragment: an inset-shadow
+       leg inside `light-dark()` computes the WHOLE `box-shadow` to `none` (the
+       binding MEMORY lesson) and the recess would silently vanish. Bounded warm ink
+       so it darkens the inner-top edge without re-coloring the warm fill (no gray
+       well). */
+    --tab-track-recess-ink: color-mix(in srgb, var(--foreground) 7%, transparent);
+
     /* 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
@@ -138,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
@@ -155,6 +245,20 @@
     --glass-backdrop:           dark;
     --glass-tint-ink:           var(--foreground);
 
+    /* BD.W-DOCK-CORE (D1) — the warm-CHROMATIC dock tint ink (the keystone, RESEARCH-3).
+       The dock self-engage (dock/morph.css) mixes its thin ~0.42-alpha plate toward the
+       near-black `--foreground` (chroma ≈ 0.0062) → it darkens L with chroma DEAD-FLAT (the
+       gray dock the user reports). This dock-SCOPED ink extracts the foreground's warm
+       hue/chroma via `oklch(from …)` (the BB.W-DARK-INK-WARM idiom — NOT a new mechanism),
+       LIFTS the chroma to 0.05 (well above foreground's 0.0062), and DROPS L to 0.42 (the
+       darken anchor). At the bright-bucket AA engage the composited plate yields a WARM
+       material darken (C ≈ 0.016, ~2× HEAD, H ≈ 62°) — never gray. The OUTER mix stays
+       `color-mix(in oklab)` (the glass-tint family, AW.W26 in-srgb fence untouched); this
+       `oklch(from)` is only the INK SOURCE. The GLOBAL `--glass-tint-ink` above is FROZEN
+       (W-DARK-MATERIAL's whole-system register) — this is a NEW dock-scoped token read ONLY
+       by the dock self-engage (file-line-disjoint, no-dual-path). */
+    --glass-tint-ink-dock:      oklch(from var(--foreground) 0.42 0.05 h);
+
     /* BC.W-ADAPTIVE-RECONCILE — the ONE retune knob for the continuous observer
        driver. `--glass-backdrop-luma` (the measured sampled relative-luminance the
        useGlassBackdropLuminance observer WRITES, registered typed in property-regs.css)
@@ -349,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.