@mkbabb/glass-ui 4.2.0 → 6.0.0

package/src/styles/theme/radius.css

@@ -42,6 +42,14 @@
        on Checkbox + base Tabs onto a softer, named radius. One geometry language
        across the form family — token + class only, no new primitive. */
     --radius-field:   var(--radius-2xl);
+    /* BI.W-RADIUS-GRAMMAR (Law 2 — capsule-vs-card) — the BOUNDED strip rung a
+       COLUMN-STACK variant of a stadium base re-binds onto. A multi-row segmented
+       track cannot wear the `9999px` pill: on a tall box the stadium clamps its
+       end-caps to a ~46px half-height balloon (UF-A2/FAM-4). ≈12px sits between
+       --radius-control (the stadium pill) and --radius-card (1rem) — a soft
+       rounded-rect, never a stadium. The vertical SegmentedTabs track reads it;
+       the shipped concentric track calc re-resolves the corner off it for free. */
+    --radius-strip:   0.75rem;
     /* BC.W-CONTROL-SMOOTH — the small-inline-control corner rung is a STADIUM, not a
        fixed small px. The prior `--radius-md` (6px) read SQUARE on a 16-24px control
        (6px on a 16px box = 0.38-of-height — a rounded-rect, not a pill); the iOS-27
@@ -67,6 +75,23 @@
     --radius-dock-card: var(--radius-3xl);
     --radius-tooltip: var(--radius-lg);
 
+    /* ── BI.W-RADIUS-GRAMMAR — the concentric-radius RELAY (Law 1). ──────────────
+       The Apple `ConcentricRectangle` grammar (iOS 26) as a plain INHERITED
+       custom-property relay: a container PUBLISHES its resolved corner as
+       `--radius-ctx` + its inner pad as `--radius-inset` on itself; a nested
+       CARD-class surface DERIVES its own corner
+         border-radius: max(var(--radius-floor), calc(var(--radius-ctx) − var(--radius-inset)))
+       so the inner corner stays concentric with the outer across the pad. The
+       2-level relay is the contract (covers 4/5 audited sites); depth-N `inherit()`
+       is Chrome-only / non-Baseline — BOOKED, never a masking fallback. These are
+       the DEFAULT (root) channel values a container overrides per-scope: the
+       identity default `--radius-inset: 0px` makes an un-nested card read
+       `--radius-ctx` (= --radius-card) unchanged, and `--radius-floor` (4px) is the
+       minimum a nested corner never rounds below. */
+    --radius-floor:   var(--radius-xs);
+    --radius-ctx:     var(--radius-card);
+    --radius-inset:   0px;
+
     /* ── AX.W56 — the corner-SHAPE axis (parallel to the corner-RADIUS ladder above).
        `corner-shape` only changes the CURVE within the `border-radius` box; the
        region is still the `--radius-*` token. These are plain @theme (the radius
@@ -93,22 +118,28 @@
 
     /* Semantic per-surface SHAPE aliases — the rounded-vs-squircle POLICY (a
        RADIUS-THRESHOLD policy: the superellipse only READS at a LARGE radius
-       ~--radius-xl/12px and up). ROUND set = card, pill (small controls + data
-       cards + stadium pills — the superellipse is imperceptible, dropping it is
-       free). SQUIRCLE set = bigdock, dialog, sheet, panel, hero (the large-radius
-       glass overlays where the iOS-26 silhouette reads — the blur halo + cartoon
-       under-shadow follow the shape). ALL ride the ONE --corner-k-squircle vocab.
-       W56b (USER-DECISION R1) extended the family off big-dock-only onto the large
-       glass overlays; @supports-gated in glass/squircle.css over the `border-radius`
-       round CONTRACT. A consumer dials any surface back to round (or opts one in) by
-       re-pointing its `--corner-shape-<surface>` alias. */
-    --corner-shape-card:    round;
-    --corner-shape-pill:    round;
+       ~--radius-xl/12px and up). The SQUIRCLE set = bigdock, dialog, sheet, panel,
+       hero (the large-radius glass overlays where the iOS-26 silhouette reads — the
+       blur halo + cartoon under-shadow follow the shape); ALL ride the ONE
+       --corner-k-squircle vocab. W56b (USER-DECISION R1) extended the family off
+       big-dock-only onto the large glass overlays; @supports-gated in
+       glass/squircle.css over the `border-radius` round CONTRACT. A consumer dials
+       any squircle surface back to round (or opts one in) by re-pointing its
+       `--corner-shape-<surface>` alias.
+       The ROUND set (card, pill — the small controls + data cards + stadium pills)
+       carries NO shape alias: the CSS `corner-shape` INITIAL VALUE is `round`, and
+       glass.css writes no `corner-shape` on .glass-card/.glass-btn/.btn-pill (the
+       CARD-REHOMED policy), so those surfaces are round BY DEFAULT — the dead
+       `--corner-shape-card`/`-pill: round` no-op knobs were SWEPT (BG.W-DEAD-SWEEP,
+       net-negative; the round policy is identical, expressed structurally not by a
+       dead token). A consumer wanting a squircle card mints its own alias and adds
+       the surface to squircle.css's @supports block. */
     --corner-shape-bigdock: superellipse(var(--corner-k-squircle));
     --corner-shape-dialog:  superellipse(var(--corner-k-squircle));
     --corner-shape-sheet:   superellipse(var(--corner-k-squircle));
     --corner-shape-panel:   superellipse(var(--corner-k-squircle));
-    --corner-shape-hero:    superellipse(var(--corner-k-squircle));
+    /* BI.W-GLASS-DEDUP — `--corner-shape-hero` RETIRED with the `.glass-hero`
+       overlay utility (FAM-9, 0-consumer clean break). */
     /* AX.W59 — the spectrum slider's track-height thumb reads as a SQUIRCLE
        (the iOS color-picker idiom). It rides the same --corner-k-squircle
        vocabulary; @supports-gated in Slider.vue over a --radius-* round

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

@@ -99,18 +99,29 @@
     --primary-foreground: var(--neutral-0);
     --destructive: hsl(0 72% 50%);
     --destructive-foreground: var(--neutral-0);
-    --ring: hsl(24 10% 10%);
+    /* BG.W-DESHADCN — the house focus-accent register. RENAMED off the shadcn
+       `--ring` token (clean break, no alias — the de-shadcn break). Every
+       `.focus-ring`/`--focus-ring-shadow` reader + the input-fold + the
+       configurator crown resolve THIS token; the theme-bridge `--color-ring`
+       (the shadcn `ring`/`outline-ring` utility surface) is DELETED. */
+    --focus-ring-color: hsl(24 10% 10%);
     --shadow: hsl(24 10% 10%);
     --shadow-color: var(--foreground);
 
+    /* BG.W-DESHADCN — the `ai` button label ink (token-first, off the raw
+       `text-amber-700` tailwind palette). Warm-amber, calibrated to read on the
+       light glass surface; the dark arm lifts it in dark-arm.css (the plain
+       per-mode pair idiom). Read as `text-(--accent-ai-ink)`. */
+    --accent-ai-ink: oklch(0.55 0.13 75);
+
     /* AQ.W2 §4 — native-control accent. `accent-color` is an inherited
        built-in <color>, so per the §2b resolve-late discipline it reads a
        dedicated UNREGISTERED token set per-mode (NOT light-dark()) and is
        re-specified inside `.dark` — otherwise the accent freezes to the
        light shade at the cascade root. Light: muted-black checkmarks /
-       sliders on warm cream. Dark arm (`.dark`) reads `--ring` (mid-tone),
-       not the near-white dark `--primary`, so a checkbox's white checkmark
-       keeps contrast headroom (accent-color.md §5). */
+       sliders on warm cream. Dark arm (`.dark`) reads `--focus-ring-color`
+       (mid-tone), not the near-white dark `--primary`, so a checkbox's white
+       checkmark keeps contrast headroom (accent-color.md §5). */
     --accent-color: var(--primary);
 
     /* Border hairline at whisper alpha — the canonical rung for

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

@@ -0,0 +1,55 @@
+/* tokens/dark-arm-glass.css
+   The .dark saturate/brightness luminosity-lift companion cohort (BA.W-DARK-MATERIAL scope 2): the dark transmissive --glass-saturate-* knobs + the composed --glass-blur-* rungs (the "dark glass glows where light passes" lift) + the BB.W-DEEP-GLASS dark --glass-blur-deep arm.
+   Carved from tokens/dark-arm.css to hold the no-god-module 500-line bound (BI.W-STYLE-REDRAIN); its own .dark block @import-ed by tokens.css IMMEDIATELY AFTER dark-arm.css. These tokens are the sole .dark writers, so the relocation is cascade-order-invariant (computed values byte-identical). */
+.dark {
+    /* 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);
+    /* BG.W-CLOSEFIX-9SITE — the dark `--glass-blur-dock` chain (`--glass-saturate-dock`
+       + the composite) RETIRED with its light-arm sibling (clean break, no alias). The
+       dark dock reads the dark `--glass-blur-resting` (its saturate + luminosity lift)
+       through the `--dock-surface-blur: var(--glass-blur-resting)` peer. */
+
+    /* 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);
+}

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. */
 }