@mkbabb/glass-ui 4.0.1 → 4.2.0

package/src/styles/select.css

@@ -48,3 +48,154 @@
        precompiled contract). */
     overflow-y: auto;
 }
+
+/* ════════════════════════════════════════════════════════════════════════
+   BD.W-SELECT-WELL (P4 select-forms) — the welling WARM-GLASS listbox + the
+   keyed warm control EDGE. The Select is the REFERENCE consumer of the shared
+   field + capsule + accent + reveal union — every leg COMPOSES a shipped/sibling
+   register, ZERO new component, ZERO fork.
+
+   The three legs that live HERE (the consumer side):
+     · .glass-control-edge — the keyed two-stop warm rim every form control reads
+       so it has a DEFINED edge over the field (fixes the trigger box-shadow:none
+       cream-on-cream melt). Composes the SHIPPED `--glass-rim-top`/`--glass-rim-
+       bottom` keyed pair (the `--glass-key` upper-right cel key) — NOT a select-
+       private border, NOT a re-minted rim.
+     · the menu plate WARM FLOOR + α-drop — the menu reads the SHIPPED warm-capsule
+       floor (`--glass-capsule-warm` at `--glass-capsule-warm-floor`, the proven
+       meanChroma ≥ 0.02 source) so it is warm-cream even over a flat page, AND the
+       plate α drops so the warmed source + the portal field TRANSMIT.
+     · the portal warm FIELD — a clipped menu-local layer carrying the route's
+       `--field-h` (re-emitted on the portal root) so the menu transmits its route
+       identity even where the page field is faint behind the body plate.
+   ════════════════════════════════════════════════════════════════════════ */
+@layer components {
+    /* ── .glass-control-edge — the keyed warm control rim (the cream-on-cream fix) ──
+       The form controls read `.control-surface` / `.input-pill` (control-surfaces.css)
+       which carry a border + fill but `box-shadow: none` — so over a warm cream field
+       the trigger's 1.5px border melts and the control reads as a flat cream smudge.
+       This register adds the SHIPPED keyed two-stop directional rim (the bright top/
+       right catch-light + the faint warm bottom/left under-shadow, `--glass-key` upper-
+       right) so the control reads as a lifted glass plate with a defined warm edge over
+       the field. ONE register, ≥8 consumers (Select trigger + Input/Textarea/NumberField
+       pill + Checkbox/Radio + Switch track + Combobox anchor) — the DRY bar cleared by
+       construction. Composed (not re-declared): the rim is the SAME `--glass-rim-top`/
+       `--glass-rim-bottom` pair `.glass-capsule` reads, so `--glass-key` re-points BOTH
+       the capsule and the control edge from ONE handle (cel coherence). */
+    .glass-control-edge {
+        box-shadow:
+            var(--glass-rim-top),
+            var(--glass-rim-bottom);
+    }
+    /* Compose the keyed edge UNDER any control-owned ring/shadow: a control with its
+       OWN box-shadow (the Switch thumb, the focus ring on the pill) layers its shadow
+       FIRST, then the rim — the rim is the resting silhouette, the ring is the focus
+       overlay (the pill's `:focus-visible` box-shadow wins by source order + its own
+       rule). The rim travels with the control on the SHARED bezier (the pill/control-
+       surface already transition box-shadow on `--ease-standard`). */
+
+    /* ── The menu plate WARM FLOOR + α-drop (the un-gray amplifier) ──
+       The floating recipe (`.glass-floating`, ladder.css) composes
+       `color-mix(--glass-bg-floating, --glass-tint-source --glass-tint-strength)`,
+       and `--glass-tint-strength` floors at 0% at calm rest — so the menu plate is
+       near-gray-flat. RE-POINT the menu fill to compose the SHIPPED warm-capsule floor
+       (`--glass-capsule-warm` at `--glass-capsule-warm-floor`, the proven meanChroma
+       ≥ 0.02 source — the SAME token the tab capsule reads, DRY) ON TOP of the floating
+       tint, AND drop the plate α so the warmed source + the portal field TRANSMIT and
+       give real L-variance (the menu is warm GLASS, never an opaque cream slab). The
+       six-layer rim/blur/shadow composite is UNTOUCHED — only the FILL admit changes. */
+    [data-slot="select-content"],
+    [data-slot="combobox-list"] {
+        /* The α-drop seam: a consumer can re-solidify via `--select-plate-alpha: 1`.
+           Default 0.90 (light) drops the ~0.80α floating base to ~0.72 effective (the
+           amendment's transmit target) so the warmed source + the portal field show
+           through while the plate keeps body. The dark arm keeps more body (see .dark
+           below). The combobox list is the SAME overlay-family warm-glass plate
+           (DRY — one warm-floor register for both portalled pickers). */
+        --select-plate-alpha: 0.90;
+        background: color-mix(
+            in oklab,
+            color-mix(
+                in oklab,
+                var(--glass-bg-floating-tinted, var(--glass-bg-floating)),
+                var(--glass-capsule-warm) var(--glass-capsule-warm-floor)
+            ),
+            transparent calc((1 - var(--select-plate-alpha)) * 100%)
+        );
+        /* the cartoon weight — the SHIPPED `--shadow-cartoon-lg` warm cel stamp UNDER
+           the floating elevation so the panel reads as a physical card lifted off the
+           page. Composed onto the floating box-shadow stack via the plate's own rule
+           (the floating tier's `--glass-material-rim` + shadows stay; this ADDS the
+           cartoon under-stamp). Static, PRM-immune. */
+        box-shadow:
+            var(--glass-material-rim),
+            var(--glass-under-shadow-vivid),
+            var(--glass-shadow-floating),
+            var(--shadow-cartoon-lg);
+    }
+    .dark [data-slot="select-content"],
+    .dark [data-slot="combobox-list"] {
+        /* dark glass needs more body — the warm field reads as a glow band, not a wash
+           lost in near-black; keep the fill nearly solid so the dark menu has presence.
+           PLAIN per-mode arm (not a light-dark() fragment — the inset-shadow trap, and
+           the box-shadow above carries no inset leg but the discipline holds). */
+        --select-plate-alpha: 0.94;
+    }
+
+    /* ── .glass-field-portal — the portal-local warm field (route identity) ──
+       The menu portals to <body>, OUTSIDE the route's field, so its `backdrop-filter`
+       has nothing warm to transmit. A clipped menu-local layer BEHIND the plate (z -1,
+       NO backdrop-filter on it — glass-cannot-sample-glass avoided by construction)
+       paints a 3-stop warm spine keyed to the route's `--field-h` (re-emitted on the
+       portal root via `data-field-palette` → `--field-h`). `inset: 0` (clipped INSIDE
+       — the blur bends it THROUGH the plate as real L-variance, NOT an `inset:-20%`
+       halo leaking around the box). Defaults to `--field-h: 48` (forms terracotta)
+       when the route does not re-emit, so a bare Select still reads warm. */
+    .glass-field-portal {
+        position: relative;
+    }
+    .glass-field-portal::before {
+        content: "";
+        position: absolute;
+        inset: 0;
+        z-index: -1;
+        pointer-events: none;
+        border-radius: inherit;
+        background:
+            radial-gradient(70% 60% at 24% 22%,
+                oklch(0.92 0.08 var(--field-h, 48) / 0.55), transparent 72%),
+            radial-gradient(64% 58% at 82% 80%,
+                oklch(0.88 0.07 calc(var(--field-h, 48) + 18) / 0.50), transparent 70%),
+            radial-gradient(60% 62% at 60% 40%,
+                oklch(0.90 0.06 calc(var(--field-h, 48) - 14) / 0.48), transparent 74%);
+    }
+    /* DARK arm (PLAIN per-mode, not :global()/light-dark()) — the dark field stops lift
+       to a real glow band (oklch L ~0.22–0.30, higher chroma) so the field-thesis is met
+       in dark, not a wash lost in near-black. */
+    .dark .glass-field-portal::before {
+        background:
+            radial-gradient(70% 60% at 24% 22%,
+                oklch(0.30 0.10 var(--field-h, 48) / 0.55), transparent 72%),
+            radial-gradient(64% 58% at 82% 80%,
+                oklch(0.26 0.09 calc(var(--field-h, 48) + 18) / 0.50), transparent 70%),
+            radial-gradient(60% 62% at 60% 40%,
+                oklch(0.28 0.08 calc(var(--field-h, 48) - 14) / 0.48), transparent 74%);
+    }
+    /* honest-degraded arm — engines without oklch() get an hsl warm spine, never gray. */
+    @supports not (color: oklch(0.9 0.08 48)) {
+        .glass-field-portal::before {
+            background: radial-gradient(70% 60% at 24% 22%,
+                hsl(var(--field-h, 48) 60% 88% / 0.5), transparent 72%);
+        }
+        .dark .glass-field-portal::before {
+            background: radial-gradient(70% 60% at 24% 22%,
+                hsl(var(--field-h, 48) 45% 26% / 0.55), transparent 72%);
+        }
+    }
+}
+
+/* ── PRM is colour-static here — the field + floor + edge + cartoon shadow are PAINT,
+   not motion, so they REMAIN under `prefers-reduced-motion: reduce` (un-gray and
+   selection-legibility need no motion). The reveal/pour/chevron motion legs are
+   carved in their own home recipes (reveal.css / menu.css) — this consumer file
+   introduces no motion to gate. */

package/src/styles/theme/bridges.css

@@ -315,6 +315,14 @@
     --shadow-cartoon-md: var(--cartoon-shadow-md);
     --shadow-cartoon-lg: var(--cartoon-shadow-lg);
 
+    /* BC.W-CONTROL-SMOOTH — the warm focus-ring box-shadow bridged to the
+       `shadow-focus-ring` utility (AW.W26 --focus-ring-shadow register). The
+       `.focus-ring` utility auto-arms on :focus-visible; this bridge lets a
+       surface compose the SAME warm ring on a NON-:focus-visible state (the
+       TagsInputItem reka roving-tabindex `data-[state=active]` selection) via the
+       @theme utility, not a `shadow-[var(--focus-ring-shadow)]` arbitrary wrap. */
+    --shadow-focus-ring: var(--focus-ring-shadow);
+
     /* ═══════════════════════════════════════════════
        Blur → blur-* and backdrop-blur-* utilities
        ═══════════════════════════════════════════════ */
@@ -332,6 +340,15 @@
     --ease-spring-snappy: var(--spring-snappy);
     --ease-spring-bouncy: var(--spring-bouncy);
     --ease-spring-gentle: var(--spring-gentle);
+    /* BC.W-SPRING-EASE — the minted iOS interactive press register's @theme alias
+       (the documented public register the consumers reach by name; the JS path
+       reads it via useSpringPress + --glass-btn-press-t). */
+    --ease-spring-press: var(--spring-press);
+    /* BC.W-DECK — the deck slide-transition spring's @theme alias (the documented
+       public register a consumer's slide `transition-timing-function` reaches by
+       name: `ease-spring-deck`). --spring-deck aliases --spring-smooth; the headless
+       library mints the register, the deck consumer reads it (presets-in-consumers). */
+    --ease-spring-deck: var(--spring-deck);
 
     --ease-standard: var(--motion-ease-standard);
     --ease-out: var(--motion-ease-out);
@@ -352,6 +369,11 @@
     --transition-duration-panel: var(--duration-panel);
     --transition-duration-xl: var(--duration-xl);
     --transition-duration-xxl: var(--duration-xxl);
+    /* BC.W-CONTROL-SMOOTH — the named iOS control-press surface beat (0.12s, the
+       calm bg/color/box-shadow cross-fade clock the `.control-surface`/Toggle
+       family rides). Bridged to the `duration-control` utility so a control
+       composes the named clock, not a `duration-[var(--duration-control)]` wrap. */
+    --transition-duration-control: var(--duration-control);
     /* BA.W-GLASS-CAL — `--transition-duration-sparkle` bridge DELETED with the
        `--duration-sparkle` token (the disco retirement); no `duration-sparkle`
        utility consumer. */

package/src/styles/theme/radius.css

@@ -42,9 +42,26 @@
        on Checkbox + base Tabs onto a softer, named radius. One geometry language
        across the form family — token + class only, no new primitive. */
     --radius-field:   var(--radius-2xl);
-    --radius-control: var(--radius-md);
+    /* BC.W-CONTROL-SMOOTH — the small-inline-control corner rung is a STADIUM, not a
+       fixed small px. The prior `--radius-md` (6px) read SQUARE on a 16-24px control
+       (6px on a 16px box = 0.38-of-height — a rounded-rect, not a pill); the iOS-27
+       small-control silhouette is a near-stadium pill where the radius SCALES with the
+       control (clamped to half-height by `--radius-pill`'s 9999px geometry, so a 16px
+       control reads an 8px-radius pill — soft at every size). This retires the raw
+       `rounded-sm` (4px) on Checkbox + base Tabs AND the small-control square class in
+       ONE rung. The `card` toggle TILE keeps `--radius-card` (the large glass surface
+       keeps its 1rem squircle — only the small inline controls re-round). The corner-
+       SHAPE squircle axis reads at LARGE radius only (ROUND set = card+pill for small),
+       so the small pills stay ROUND (no regression). */
+    --radius-control: var(--radius-pill);
     --radius-badge:   var(--radius-pill);
     --radius-dock:    var(--radius-pill);
+    /* BC.W-TABS-IOS — the iOS-27 segmented-control stadium register. The pill is a
+       stadium by construction (--radius-pill clamps to half-height on a short box →
+       a true end-cap), so the tab strip stops being a squared rounded-rect. The
+       value.js DESIGN.md idiom: the role-bearing pill token, NOT a hand-rolled
+       `rounded-full`. A consumer retunes the tab geometry via `:root { --radius-tab }`. */
+    --radius-tab:     var(--radius-pill);
     /* AW.W3b — the big-dock card shell's default (comfortable-density) radius.
        The density-scaled --dock-card-radius (dock.css) resolves through this. */
     --radius-dock-card: var(--radius-3xl);

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

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

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

@@ -71,8 +71,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
@@ -164,12 +164,28 @@
     --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);
+    /* 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);
+    --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;
+
+    --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);
@@ -214,7 +230,20 @@
     --glass-opacity-floating: 0.88;
     --glass-opacity-overlay:  0.96;
     --glass-opacity-chassis:  0.36;
+    /* BC.W-DIALOG-GLASS — the dialog dark register lifts ~0.08 over the light arm
+       (0.68 → 0.76) for read-weight over the deep canvas, mirroring the dark opacity
+       ladder (it sits between dark `resting` 0.72 and `floating` 0.88 — see-through
+       but legible over the deep page). The SAME named token as the light arm, per-
+       mode; the composed `--glass-bg-dialog` (glass.css :root) re-resolves from it
+       automatically per mode. */
+    --glass-opacity-dialog:   0.76;
     --glass-grain-opacity: 0.045;
+    /* 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
@@ -225,13 +254,35 @@
        aurora/page behind reads with chroma + a glow. The blur() RADIUS is the
        light-arm primitive UNTOUCHED (W-GLASS-CAL owns the radius dial-back) — only the
        saturate/brightness COMPANIONS lift here. The lower rungs lift more (they're
-       thinner, the backdrop carries the read); the heavy overlay lifts least. */
-    --glass-blur-wash:     blur(calc(var(--glass-blur-wash-radius) * var(--glass-level))) saturate(1.35) brightness(1.18);
-    --glass-blur-quiet:    blur(calc(var(--glass-blur-quiet-radius) * var(--glass-level))) saturate(1.35) brightness(1.16);
-    --glass-blur-resting:  blur(calc(var(--glass-blur-resting-radius) * var(--glass-level))) saturate(1.30) brightness(1.14);
-    --glass-blur-floating: blur(calc(var(--glass-blur-floating-radius) * var(--glass-level))) saturate(1.28) brightness(1.10);
-    --glass-blur-overlay:  blur(calc(var(--glass-blur-overlay-radius) * var(--glass-level))) saturate(1.22) brightness(1.06);
-    --glass-blur-dock:     blur(calc(var(--glass-blur-dock-radius) * var(--glass-level))) saturate(1.30) brightness(1.12);
+       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
@@ -264,6 +315,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
@@ -338,6 +396,30 @@
        resolves to the `-dark` alpha on the deeper canvas. */
     --glass-edge-light: var(--glass-edge-light-dark);
 
+    /* BC.W-BLACK-BAR D2 — the DIRECTIONAL rim dark arm (plain per-mode pair, NEVER
+       light-dark() round an inset — MEMORY: the inset-shadow trap). The top
+       catch-light lifts to 0.40 (the dark plate's fill barely separates from the deep
+       page, so the rim is the PRIMARY silhouette device — dark glass glows where light
+       passes; mirrors the --glass-edge-light-dark 0.18→0.22 lift). The bottom warm
+       under-shadow holds at 6% — the shadow grounds the plate in BOTH modes. */
+    /* 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-
        source` auto-flips with `--card` (no override needed — the default already

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

@@ -18,7 +18,7 @@
  * dark companions).
  *
  * ── The Apple-range derivation (DELTA cross-ref) ───────────────────────────
- * Apple home nav:       saturate(1.8) blur(20px)  (the canonical measure)
+ * 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,
@@ -29,14 +29,42 @@
  * and the warm-cream light-concentration ceiling (AX.W52 D19 — a saturate that
  * over-juices a colored substrate reads as a garish smear) keeps it just-rich.
  * The deepest BLUR carries the "more glass" read; the saturate stays restrained.
+ *
+ * ── The deep-tier BUDGET CALL (BC.W-GLASS-LEGIBILITY-MEASURED L4) ───────────
+ * The deep blur radius is the most expensive idiom glass-ui ships (`backdrop-
+ * filter` cost is super-linear in the radius past ~16px). The wave's call:
+ * STAY at the budget-clearing 16px and BOOK the 18-20px push (toward the live-
+ * measured apple.com nav `blur(20px)` ceiling, research/apple-glass.md §1.1)
+ * behind a recorded `profile:budget` clearance — the full 20px is the BOOKED
+ * successor (apple-ios27.md §1.4 "the full 20px booked"), NOT a silent over-
+ * spend. `--glass-saturate-deep-ceiling` BAKES the apple.com nav saturate 1.8 as
+ * the deep-tier CEILING (the load-bearing term — research/apple-glass.md §4
+ * "saturate 1.5 shipped, bake 1.8 as the deep ceiling"); the shipped
+ * `--glass-saturate-deep` 1.5 sits at the low end (≤ ceiling), warm-aurora-safe.
+ * `proof:glass-legibility` L4 reads BOTH: the 16px-stay is honest IFF the budget
+ * booking is recorded here, and the shipped deep saturate never crosses the 1.8
+ * ceiling. When a `profile:budget` run clears the 18-20px push, the radius
+ * lifts toward 20px on the SAME LERP (the booked successor lands, no recipe edit).
  */
 :root {
     /* The Apple-range deep ENDPOINTS — the radius + saturate the deep tier reaches
        at full depth (`--glass-depth: 1`). The calm `floating` rung (13px / 1.18)
        is the depth-0 floor; the deep recipe LERPs between the two on `--glass-depth`
        so the axis is a genuine driver, not a literal. */
-    --glass-blur-deep-radius:    16px; /* in [14,20], STRICTLY > calm floating 13px */
-    --glass-saturate-deep:       1.5;  /* >= 1.5 (toward Apple 1.8), > calm floating 1.18 */
+    --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.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
@@ -60,7 +88,8 @@
        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)
+            var(--glass-saturate-floating)
+            + (var(--glass-saturate-deep) - var(--glass-saturate-floating)) * var(--glass-depth)
         );
 
     /* The composed deep backdrop-filter — the SEPARATE deep family. The calm