@mkbabb/glass-ui 4.1.0 → 4.2.0

package/dist/styles/segmented-tabs.css

@@ -54,21 +54,12 @@
     grid-auto-columns: 1fr;
     padding: var(--bouncy-track-trim);
     border-radius: var(--bouncy-track-radius);
-    /* BA.W-TABS — the pill track rides the glass quiet tier (the warm glass
-       material, the no-gray register) + a hairline edge. NOT a `--surface-tint`
-       gray plate (the R10-5 no-gray cut). */
-    background: var(--glass-bg-quiet);
-    -webkit-backdrop-filter: var(--glass-blur-quiet);
-
-    backdrop-filter: var(--glass-blur-quiet);
-    -webkit-backdrop-filter: var(--glass-blur-quiet);
-    /* BC.W-TABS-IOS — the track hairline re-points off the `--border` ring (which read
-       dark over the cream plate — the D2 "black bar" on the strip top edge) onto the
-       BC.W-BLACK-BAR directional rim register: a bright top catch-light + a faint warm
-       under-shadow. The track is a thin warm-glass quiet capsule with a lit top edge,
-       never a dark hairline. The pill (above) carries the SAME rim plus the lift shadow
-       so it reads FORWARD; the track carries only the rim. */
-    box-shadow: var(--glass-rim-top), var(--glass-rim-bottom);
+    /* BD.W-TAB-IOS-CAPSULE — the warm-glass quiet surface + the rim + the iOS-27
+       sunken recess now live in the SHARED `.glass-capsule-track` register (the SFC
+       composes it onto the pill track). The track is a thin warm-glass quiet capsule
+       with a lit top edge + a recessed well, never a dark hairline, never gray. The
+       indicator (`.glass-capsule`) reads FORWARD off the SAME rim + the lift shadow.
+       The underline material does NOT compose the track (paper, no surface). */
 }
 
 /* ── The vertical orientation axis (the block stack) ── */
@@ -92,37 +83,51 @@
 /* ── The shared indicator body (the PILL plate) ── */
 .segmented-indicator {
     position: absolute;
-    /* BC.W-TABS-IOS — the active pill is the iOS-27 / value.js DISTINCT LIFTED PLATE,
-       not a +30%-α same-hue brightness step. The fill reads the SHARED element-level
-       oklab-tinted floating pair (surfaces.css `:where(.btn-glass, .segmented-indicator)`)
-       — over a bright field it darkens-to-legible, over a calm field it stays
-       warm-cream/near-white (the W55 adaptive register reaching the pill, the "raised
-       near-white plate" the user pinned). The FORWARD-ness comes from the rim + lift
-       below, NOT from cranking the same-hue alpha. */
-    background: var(--glass-bg-floating-tinted);
-    -webkit-backdrop-filter: var(--glass-blur-floating);
-
-    backdrop-filter: var(--glass-blur-floating);
-    -webkit-backdrop-filter: var(--glass-blur-floating);
+    /* BD.W-TAB-IOS-CAPSULE — the active pill COMPOSES the shared `.glass-capsule`
+       (the SFC adds the class). The warm-floor fill (`--glass-bg-floating-tinted`
+       composed toward the warm-floor source, meanChroma ≥ 0.02 both modes — never
+       gray), the floating blur, the directional rim + the lift under-shadow ALL live
+       there now, ONE recipe ≥3 consumers. This block keeps only the position +
+       inset + the indicator-local stadium radius + the motion transform. */
     z-index: 0;
     inset-block: var(--bouncy-track-trim);
     border-radius: var(--bouncy-slider-radius);
-    /* BC.W-TABS-IOS — the lifted-plate composite: the BC.W-BLACK-BAR directional rim
-       (bright top catch-light `--glass-rim-top` + warm bottom under-shadow
-       `--glass-rim-bottom` — the iOS-27 top-light/bottom-shadow thickness the track does
-       NOT carry, the FORWARD-ness device, NEVER the dark D2 hairline) PLUS a real layered
-       glass under-shadow (`--glass-shadow-floating`) lifting the plate ~2-3px off the
-       quiet track. Replaces the HEAD weak `0 1px 3px rgba(0,0,0,0.08)` + the 30%-border
-       dark ring (the same-hue low-contrast plate that read "not glassy"). */
-    box-shadow:
-        var(--glass-rim-top),
-        var(--glass-rim-bottom),
-        var(--glass-shadow-floating);
-    /* The volume-preserving travel-squish: stretch along X, compress Y in
-       inverse proportion. `transform-origin: center` → a symmetric width-flex
-       as it travels (the indicator grows wider mid-travel, settles to fit). */
+    /* BD.W-TABS-LIQUID — the COMPOSED transform write: the area-inflation BLOB
+       (uniform, both axes, `--tab-blob` driven imperatively by the 2nd
+       `useLiquidFlex` channel — grow→overshoot→shrink) × the volume-preserving
+       travel-squish (`--stretch`, reciprocal). `transform-origin: center` → the blob
+       grows from center (the label stays put) and the squish stays center-pinned. */
     transform-origin: center;
-    scale: var(--stretch) calc(1 / var(--stretch));
+    scale: calc(var(--tab-blob, 1) * var(--stretch))
+        calc(var(--tab-blob, 1) / var(--stretch));
+}
+
+/* BD.W-TABS-LIQUID — the COMMIT accent-flood (T4, opt-in). A momentary full-capsule
+   wash of `--glass-accent`, driven by `--tab-flood-t` (0→1→0), that TRAILS the
+   spatial glide a beat then clears (EFFECTS-after-SPATIAL). `isolation: isolate` on
+   the host so the `plus-lighter` blend composites the flood against the capsule
+   only (not the page); the gradient is `in srgb` (additive bloom, NOT oklab). The
+   accent is a CONSUMER accent — default `--glass-accent: transparent` → byte-
+   identical rest, provable no-op. The SAME register dock-tabs adopt (dormant at
+   `--tab-flood-t: 0`). */
+.segmented-indicator {
+    isolation: isolate;
+}
+@supports (mix-blend-mode: plus-lighter) {
+    .segmented-indicator::after {
+        content: "";
+        position: absolute;
+        inset: 0;
+        border-radius: inherit;
+        pointer-events: none;
+        background: radial-gradient(
+            120% 140% at 50% 50%,
+            color-mix(in srgb, var(--glass-accent, transparent) 55%, transparent),
+            transparent 70%
+        );
+        mix-blend-mode: plus-lighter;
+        opacity: var(--tab-flood-t, 0);
+    }
 }
 
 /* Vertical: the indicator deforms on the BLOCK axis (compress X / stretch Y) and
@@ -130,15 +135,23 @@
 .segmented-tabs--vertical .segmented-indicator {
     inset-block: auto;
     inset-inline: var(--bouncy-track-trim);
-    scale: calc(1 / var(--stretch)) var(--stretch);
+    /* BD.W-TABS-LIQUID — the vertical arm mirrors the blob × squish: the block axis
+       carries the stretch, the inline axis its reciprocal, both uniformly inflated. */
+    scale: calc(var(--tab-blob, 1) / var(--stretch))
+        calc(var(--tab-blob, 1) * var(--stretch));
 }
 
 @media (prefers-reduced-motion: no-preference) {
     .segmented-indicator {
-        /* ONE composited transform pair (translate+scale) on ONE calibrated
-           clock — the glide + the squish share `--tab-indicator-duration` so they
-           cannot desync (the R10-2 multi-property-desync class collapsed). */
-        transition: scale var(--tab-indicator-duration) var(--spring-snappy);
+        /* BD.W-TABS-LIQUID — the composed `scale` (`--tab-blob × --stretch`) rides the
+           DEPENDED `--ease-cartoon-punch` curve (the booked Band-0 token, CONSUMED
+           never minted) so the 5-beat blob anticipates (the curve's pre-dip < 0),
+           overshoots past the destination footprint (peaks > 1), then settles soft.
+           The discrete imperative `--tab-blob` writes (open/release) INTERPOLATE on
+           this clock via the `@property` registration — no snap-flicker. ONE clock,
+           ONE composited transform pair — the glide (inset) + the squish + the blob
+           cannot desync. The `--tab-flood-t` accent-flood trails a beat after. */
+        transition: scale var(--tab-indicator-duration) var(--ease-cartoon-punch);
     }
 }
 
@@ -231,7 +244,13 @@
     font: inherit;
     font-size: 0.8125rem;
     color: var(--muted-foreground);
-    transition: color var(--duration-fast) ease;
+    /* BD.W-TABS-LIQUID — the glyph scale-pop (overlapping action / follow-through):
+       the label settles AFTER the capsule (the child trails the parent). The `scale`
+       channel rides the snappy spring with a 60ms delay so it OVERLAPS the capsule
+       arrival; the colour cross-fade stays on the fast bezier. */
+    transition:
+        color var(--duration-fast) ease,
+        scale var(--spring-snappy-duration) var(--spring-snappy) 60ms;
     /* AQ.W3 identity base — keep `scale:1; translate:0` so a hover/press
        transform never mints a stacking context that severs `anchor()`
        resolution (the WAAPI press writes `transform` transiently — harmless). */
@@ -251,6 +270,19 @@
     color: var(--foreground);
 }
 
+/* BD.W-TABS-LIQUID — the glyph scale-pop on the PILL selection. The live selection
+   model is `aria-pressed` (the pill is a ToggleGroup-shaped surface — verified in
+   SegmentedTabs.vue, NOT `aria-selected` which the underline paper material uses).
+   The pop magnitude DEPENDS `--motion-weight` (the booked Band-0 token, CONSUMED):
+   `calc(1 + 0.06 × --motion-weight)` → ~+3.7% at rest weight 0.618, and exactly 1
+   under PRM (`--motion-weight: 0`). The 60ms transition delay (above) settles it a
+   beat after the capsule arrives (overlapping action). The underline label does NOT
+   pop (paper ink, no inflation — the material fence). */
+.segmented-tabs:not(.segmented-tabs--underline)
+    .segmented-tab[aria-pressed="true"] {
+    scale: calc(1 + 0.06 * var(--motion-weight));
+}
+
 .segmented-tab.is-disabled {
     opacity: 0.4;
     cursor: not-allowed;
@@ -407,7 +439,9 @@
     /* Promote to its own compositor layer for the 1:1 follow (the translate write
        is compositor-only; the hint keeps the plate off the main-thread paint). */
     will-change: transform;
-    /* Sub-perceptual catch-light lift — the grabbed lozenge reads a hair brighter
-       at its specular edge (the W-GLASS-CAL specular register, disco-FREE). */
-    --glass-specular: 0.1;
+    /* BD.W-TAB-IOS-CAPSULE C7 — the grabbed-state catch-light COMPOSES the SHARED
+       specular-lift step declared ONCE in glass/glass-capsule.css (the
+       `.glass-capsule-hover:hover, .glass-drag-lift { --glass-specular }` group), NOT
+       a parallel `--glass-specular` fork. This block carries only the grabbing-distinct
+       bits (the grab cursor + the `will-change` hint). */
 }

package/dist/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/dist/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);

package/dist/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);
@@ -222,6 +238,12 @@
        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
@@ -255,7 +277,12 @@
     --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);
+    /* 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
@@ -288,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
@@ -368,8 +402,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-

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

@@ -55,9 +55,12 @@
                                           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-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
@@ -85,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

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

@@ -15,6 +15,16 @@
        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. */
+    --paper-grain-opacity: 0.22;
     /* 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 +95,39 @@
        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 */
+    /* 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 +157,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
@@ -155,6 +219,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)