@mkbabb/glass-ui 4.2.0 → 6.0.0

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

@@ -23,8 +23,12 @@
     /* BD.W-PAPER-MORPHISM — re-calibrated to the JND floor for the CORRECTED coarse
        tooth + multiply blend (std ≥ 4.5 light, the no-squint floor): multiply on the
        cream pole is GENTLE so it needs MORE alpha. The prior 0.08 rode a blend
-       (overlay) that was mathematically incapable of moving a near-white pixel. */
-    --paper-grain-opacity: 0.22;
+       (overlay) that was mathematically incapable of moving a near-white pixel.
+       BG.W-PAPER-GRAIN-OPTIN — the universal grain plane is RETIRED (the shell field
+       is the recessive aurora; grain is now PER-SURFACE opt-in). The opt-in alpha is
+       nudged sub-JND (0.22 → 0.21) for the per-surface register — barely perceptible,
+       so opt-in cards/panels read tactile-but-calm without the full-page wash. */
+    --paper-grain-opacity: 0.21;
     /* BB.W-LIQUIDHOVER — the grain ENGAGE clock: a hover/active grain lift cross-fades
        the grain `::after` OPACITY on this thin ~120ms linear write while the
        `background-image` stays ALWAYS PRESENT (never a none→image swap — the one-frame
@@ -111,6 +115,20 @@
     --glass-key-lit-y: 1px; /* …and the TOP edge — the upper-right key */
     --glass-key-shade-x: 1px; /* the under-shadow grounds the LEFT edge */
     --glass-key-shade-y: -1px; /* …and the BOTTOM edge — opposite the key */
+    /* BI.W-SURFACE-EXTRACT / atlas GU-1 · O-E2 — the `--glass-key-direction`
+       under-shadow KEY-LIGHT LEAN. The two-stop rim (above) SELECTS which edge is lit
+       vs shade (edge-select px tokens); this is the DISTINCT cast-RATIO knob for the
+       non-inset under-shadow FILL family (the 3 tiers below), which historically cast
+       STRAIGHT DOWN (X = 0). ONE write leans the whole under-shadow register
+       library-wide (the 3 tiers + the dock-wrap vivid consumer all read it). It is a
+       RATIO (unitless), multiplied into each tier's Y magnitude to give the X:
+       -0.375 = tan 20.56° down-LEFT is the cel-coherent FILL lean atlas sets (cel cast
+       = 45° KEY, under-shadow = 20.56° FILL — one light). The LIBRARY DEFAULT is `0`
+       (straight-down) so the shipped under-shadow is byte-identical (the
+       BI.W-SURFACE-EXTRACT refactor-not-repaint π holds); atlas / a future identity
+       wave sets `-0.375` via this ONE token (presets-in-consumers). The spine rung is
+       INTENTIONALLY-OMNIDIRECTIONAL (an edge-thickness cue, not a cast) — left unleaned. */
+    --glass-key-direction: 0;
     /* BC.W-BLACK-BAR D2 + BD.W-GLASS-KEY-EDGE — the two-stop directional rim, now
        KEY-DRIVEN: the bright catch-light `--glass-rim-top` rides the lit (key-facing)
        edges, the faint warm under-shadow `--glass-rim-bottom` rides the shade edges.
@@ -202,6 +220,14 @@
                                 that sets it stays demo-private until a 2nd consumer
                                 arrives (the no-overfitting bar — the DEFAULT path is
                                 the declarative bucket, not a speculative sampler).
+                                BG.W-GLASS-SIGNAL-TRUTH (M7) — the band-driver decision
+                                RECONCILED to ONE: the declarative bucket above IS the
+                                BAND driver; the continuous `--glass-backdrop-luma` clamp
+                                (glass/ladder.css) is the DYNAMIC REFINEMENT that engages
+                                WHERE A WRITER FIRES (the dock; a wired band surface). The
+                                ladder.css "clamp retires the bucket as driver" claim was
+                                the contradictory-canon half, now removed — one recorded
+                                text, no double-ownership.
          --glass-tint-ink:      the LOW-LUMINANCE warm-ink the bright bucket re-points
                                 `--glass-tint-source` to — the warm dark `--foreground`
                                 family (NOT white; a lightener over light content is
@@ -382,7 +408,6 @@
     --glass-shadow-overlay:  var(--shadow-2xl),
         0 0 0 0.5px color-mix(in srgb, var(--shadow-color) 8%, transparent),
         var(--glass-highlight);
-    --glass-shadow:    var(--glass-shadow-quiet);
 
     /* ─────────────────────────────────────────────────────────────
        AL-W1-α augmented — SPINE 8th tier (HOUSING register)
@@ -397,11 +422,8 @@
        The 4 tokens here cover the minimum viable substrate the SLIM
        Y4/Y6/Y7 retention set ratified. The 35 rejected axes (saturate
        band, edge-light per tier, depth-shadow per tier, tier-up macro)
-       stay rejected per the conservative-creation mandate. (BB.W-DEAD-SWEEP KEEP:
-       --glass-spine-opacity/-blur — no var() consumer, pinned by InstrumentChassis.spine-variant.test.ts; Batch-6 re-anchor.)
+       stay rejected per the conservative-creation mandate.
        ───────────────────────────────────────────────────────────── */
-    --glass-spine-opacity: 0;
-    --glass-spine-blur: 0px;
     --glass-spine-border: var(--surface-tint-8);
     --glass-spine-vignette: radial-gradient(
         ellipse at 50% 0%,
@@ -427,9 +449,13 @@
        hand-rolled literal where it's load-bearing on chassis-internal
        surfaces).
        ───────────────────────────────────────────────────────────── */
-    --glass-under-shadow-quiet:   0 2px 8px -1px oklch(0 0 0 / 0.04);
-    --glass-under-shadow-default: 0 4px 16px -2px oklch(0 0 0 / 0.08);
-    --glass-under-shadow-vivid:   0 8px 32px -4px oklch(0 0 0 / 0.12);
+    /* atlas GU-1/O-E2 — the X cast leans off the ONE `--glass-key-direction` ratio
+       (default 0 → byte-identical straight-down cast; atlas sets -0.375 for the
+       cel-coherent down-left FILL lean). Y/blur/spread/α byte-unchanged. The spine
+       rung stays INTENTIONALLY-OMNIDIRECTIONAL (an edge-thickness cue, no cast). */
+    --glass-under-shadow-quiet:   calc(2px * var(--glass-key-direction)) 2px 8px -1px oklch(0 0 0 / 0.04);
+    --glass-under-shadow-default: calc(4px * var(--glass-key-direction)) 4px 16px -2px oklch(0 0 0 / 0.08);
+    --glass-under-shadow-vivid:   calc(8px * var(--glass-key-direction)) 8px 32px -4px oklch(0 0 0 / 0.12);
     --glass-under-shadow-spine:   0 1px 0 0 oklch(0 0 0 / 0.06);
 
     /* Overlay scrim rungs — substrate-aware modal/dialog backdrop tints.

package/src/styles/tokens/glass.css

@@ -71,10 +71,21 @@
        more through the plate while the glass still reads unmistakably as glass.
        The radius axis ONLY: `--glass-level` + every `saturate()`/`brightness()`
        companion below are UNTOUCHED (the W-DARK-MATERIAL dark-recipe saturate/
-       brightness companions preserved — radius-only, the gate's B3 assert). */
+       brightness companions preserved — radius-only, the gate's B3 assert).
+
+       BG.W-GLASS-BLUR-PEER — the resting rung pulls 10→8 to mint the ONE unified
+       8px glass material: the dock + the default-Card (`--glass-blur-quiet`) + the
+       menu-row (the quiet tier) all resolve the SAME `blur(8px)` RADIUS LEG (the
+       resolved-radius peer lock, proof:glass-cal). BI.W-BLUR-MUTE dials the glass
+       BUTTON cohort a HAIR below this peer via its own `--glass-blur-btn-radius`
+       primitive (see below) — the button is the muted glass CTA, dock/Card/menu-row
+       stay the unified 8px. The MORE-glass DEEP register is the hero CTA only
+       (`.glass-deep` re-points `--glass-blur-btn` → `--glass-blur-deep`). Radius-only —
+       the per-rung saturate()/brightness() companions stay (the saturate-revert is a
+       later WS1-gated paint, not this collapse). */
     --glass-blur-wash-radius:     1px;
     --glass-blur-quiet-radius:    8px;
-    --glass-blur-resting-radius:  10px;
+    --glass-blur-resting-radius:  8px;
     --glass-blur-floating-radius: 13px;
     /* AV.W7 F2 — clamped from 24px into the 8–15px budget band. A blur radius
        past ~20px is exponentially costlier (`backdrop-filter` is glass-ui's most
@@ -84,12 +95,11 @@
        a richer wash via the @media arm in light-dark.css — the cost is amortised
        by the extra device pixels. */
     --glass-blur-overlay-radius:  13px;
-    /* Dock blur radius — 9px (BA.W-GLASS-CAL, off 11), paired with the 0.42
-       opacity below: a crisp glass pill (the iOS Control Center register), not a
-       feathered wash. The dock composes `blur()` only (no saturate); the
-       `prefers-reduced-transparency` bracket at glass.css maps it to the
-       opacity-only register. */
-    --glass-blur-dock-radius:     9px;
+    /* BG.W-CLOSEFIX-9SITE — the `--glass-blur-dock` chain (radius + composite +
+       `--glass-saturate-dock` + the `--blur-dock` @theme bridge) is RETIRED (clean
+       break, no alias). The dock now paints blur via `--dock-surface-blur:
+       var(--glass-blur-resting)` (the unified 8px material, BG.W-GLASS-BLUR-PEER),
+       so its own rung token was orphaned. */
 
     /* ── Per-rung SATURATE — the CANONICAL named saturate register (BC.W-GLASS-
        LEGIBILITY-MEASURED, the speedtest-AX BC-W10 fold) ───────────────────────
@@ -115,13 +125,9 @@
     --glass-saturate-resting:  1.4;
     --glass-saturate-floating: 1.6;
     --glass-saturate-overlay:  1.6;
-    /* W-NAV-DOCK-FIX — the dock's named light-concentration saturate. The dock is a
-       calm chrome strip (the wash/quiet/resting register 1.4, NOT the floating 1.6).
-       Mirrors the dark arm's dock saturate; the single retune knob in both modes. The
-       light dock was the ONLY light surface with no saturate companion — over the flat
-       warm-cream page the un-saturated backdrop-filter pulled the cream toward neutral
-       (the flat-slab gray read). */
-    --glass-saturate-dock:     1.4;
+    /* BG.W-CLOSEFIX-9SITE — `--glass-saturate-dock` RETIRED with the `--glass-blur-dock`
+       chain (its sole reader). The dock reads `--glass-saturate-resting` through the
+       `--glass-blur-resting` peer now. */
 
     /* AX.W54 — each blur radius is scaled by the ONE `--glass-level` scalar (in
        lockstep with the opacity seam above): level=1 byte-identical; level=0 →
@@ -145,35 +151,39 @@
        substrate). wash/quiet/resting already sit at 1.05 — untouched. */
     --glass-blur-floating: blur(calc(var(--glass-blur-floating-radius) * var(--glass-level))) saturate(var(--glass-saturate-floating));
     --glass-blur-overlay:  blur(calc(var(--glass-blur-overlay-radius) * var(--glass-level))) saturate(var(--glass-saturate-overlay));
-    /* Dock blur composes blur() only — no saturate. */
-    /* W-NAV-DOCK-FIX — the dock concentrates light like every other tier (apple-glass
-       §4): the saturate lifts the warm-cream chroma THROUGH the plate, the small
-       brightness is the light-concentration the quiet rung carries. The blur RADIUS is
-       untouched (the W-GLASS-CAL dial). Compositor-only (backdrop-filter is a paint op);
-       the prefers-reduced-transparency bracket maps --glass-blur-dock: none, so the
-       saturate drops with the blur (no separate carve owed). */
-    --glass-blur-dock:
-        blur(calc(var(--glass-blur-dock-radius) * var(--glass-level)))
-        saturate(var(--glass-saturate-dock))
-        brightness(1.02);
-
-    /* AX.W52 → BC.W-GLASS-LEGIBILITY-MEASURED — the GLASS BUTTON blur, lifted to
-       the FLOATING-tier "more glass" register. The `glass`/`glass-wash` button
-       variants compose the `.glass-wash` tier (`--glass-blur-wash` = blur(1px)) — a
-       sub-perceptual diffusion authored for a small detail TILE, not a button the
-       user reads as "glass." A button is a hero control: it wants a real glass blur.
-       The AX.W52 landing sat at the quiet-tier 8px/saturate(1.05) — "quieter than
-       even the calm floating tier" (apple-ios27.md §4.2). This wave lifts it to the
-       FLOATING-tier register (apple-ios27.md §5 bake-table "button blur lift to
-       10-13 / 1.18"): the floating radius (13px, in the 10-13 band) + the named
-       `--glass-saturate-floating` knob (1.18) — a genuinely MORE-glass transmissive
-       capsule revealing the craft beneath (the apple-glass SUPERSET: apple.com's web
-       CTA is a SOLID blue capsule, zero blur — research/apple-glass.md §1.4). The
-       `brightness(1.02)` light-concentration the quiet rung carried is KEPT (no
-       colour-juice). Clean break — the old 8px/quiet value is GONE, no alias. The
-       wash TILE tier (MetricCell et al.) keeps its 1px — only the glass BUTTON
-       variants reach for this. Machine-locked by `proof:glass-legibility` L3. */
-    --glass-blur-btn:      blur(calc(var(--glass-blur-floating-radius) * var(--glass-level))) saturate(var(--glass-saturate-floating)) brightness(1.02);
+    /* BG.W-CLOSEFIX-9SITE — the composed `--glass-blur-dock` token RETIRED (orphaned by
+       BG.W-GLASS-BLUR-PEER's `--dock-surface-blur: var(--glass-blur-resting)` re-point).
+       The dock reads the unified 8px resting material; there is no dock-own blur rung. */
+
+    /* BG.W-GLASS-BLUR-PEER / BI.W-BLUR-MUTE — the GLASS BUTTON blur cohort. Every
+       `.btn-glass` (the `default`/`glass`/`outline`/`secondary`/`accent`/`ai` glass
+       register) reads `backdrop-filter: var(--glass-blur-btn)` (surfaces.css), and
+       `--glass-blur-btn` is the button's OWN composed token reading a button-cohort
+       RADIUS PRIMITIVE `--glass-blur-btn-radius` through the ONE `--glass-level` scalar
+       + the resting saturate companion — the override-the-PRIMITIVE idiom
+       (proof:doc-override-idiom): a consumer retunes the WHOLE button cohort with one
+       `:root { --glass-blur-btn-radius: … }`, NEVER a hardcoded composite `blur()`.
+
+       BI.W-BLUR-MUTE (UF-B3/B4 — "the blur could be muted ever so slightly" / "dialed
+       back globally just a bit") dials the button cohort a HAIR below the 8px resting
+       material (`--glass-blur-btn-radius: 6px` — the backdrop's structure reads a touch
+       more through the button plate). The RADIUS axis ONLY (the W-GLASS-CAL
+       anti-overreach discipline): the saturate leg is the resting 1.4 unchanged,
+       `--glass-level` untouched. The button now diverges from the
+       dock·default-Card·menu-row 8px peer by a deliberate cohort hair — NOT the
+       ONE-material break: dock/Card/menu-row stay the unified 8px, the button is the
+       muted glass CTA. The `.btn-glass.glass-deep` HERO arm (surfaces.css) still
+       re-points the WHOLE `--glass-blur-btn` onto `--glass-blur-deep`, so the
+       apple.com-nav-grade DEEP CTA (`primary-audacious`/`:liquid`/host `.glass-deep`) is
+       UNAFFECTED (it overrides the composed token, not the primitive). The wash TILE
+       tier (MetricCell et al.) keeps its 1px. Machine-locked by `proof:glass-cal` (the
+       blur-mute clause — the button resolves the muted radius via the `-radius`
+       PRIMITIVE, a hair below the peer, never a composite) + `proof:glass-legibility` L3
+       (the muted button is real content-tier glass) + `proof:button-glass` BG-IOS-1 (the
+       button-cohort tier + the saturate floor). The binding composited-ΔL certification
+       rides the #92 π batch. */
+    --glass-blur-btn-radius: 6px;
+    --glass-blur-btn:      blur(calc(var(--glass-blur-btn-radius) * var(--glass-level))) saturate(var(--glass-saturate-resting));
 
     /* Dock-specific opacity (0.42) — lighter than `resting` (0.65) so the dock
        reads as a translucent overlay rather than a panel, backdrop bleed
@@ -193,10 +203,12 @@
        the bright bucket), so the modal floats with the FLOATING-tier lift (edge/
        rim/under-shadow) while reading at the RESTING-tier transparency. The
        LIBRARY iOS-modal identity (presets-in-consumers — a consumer retunes
-       `--glass-bg-dialog` via :root). Consumed by DialogContent.vue, which re-
-       declares `--glass-bg-floating: var(--glass-bg-dialog)` on the dialog scope
-       (the self-re-point recipe, the dock precedent — NOT a raw rung override
-       that won't re-compose). */
+       `--glass-bg-dialog` via :root). BI.W-GLASS-TOKEN-PRUNE — the α-band probe
+       DECIDED this is genuinely-distinct physics (Δ plate-α 0.12 vs floating; ΔL
+       0.06–0.10 over a busy/dark page → KEEP). Consumed by DialogContent.vue, which
+       re-points the internal `--glass-bg-rung` compose slot onto `--glass-bg-dialog`
+       on the dialog scope (the ONE-DOOR read — NOT the retired `--glass-bg-floating:
+       var(--glass-bg-dialog)` double-name re-declaration). */
     --glass-opacity-dialog: 0.68;
 
     /* Sheet-specific opacity (0.74) — BE.W-SHEET-TRANSLUCENT. The iOS-27 bottom-
@@ -212,19 +224,6 @@
        Presets-in-consumers — a consumer retunes `--glass-opacity-sheet` via :root. */
     --glass-opacity-sheet: 0.74;
 
-    /* Clear-specific opacity (0.58) — BE.W-CLEAR-VARIANT. The Apple-Clear MAXIMALLY
-       translucent register — the clearest rung the library ships, BELOW the dialog
-       0.68 (the now-playing pill, the Control-Center clear tile: the album grid
-       bleeds genuinely through). It is STRUCTURALLY coupled to a MANDATORY legibility
-       scrim (the `surface="clear"` decoration carries a `::before` backdrop-dim whose
-       strength derives from the sampled `--glass-backdrop-luma`) — a scrim-less clear
-       plate is FORBIDDEN by construction (the Apple Clear contract: near-transparent →
-       the text needs a scrim floor). 0.58 sits in the Apple-Clear band (clearer than
-       the modal 0.68, still a plate not a ghost — > 0.45). The composed
-       `--glass-bg-clear` rides the SAME oklab-tint-wrapped recipe so the W55 darken +
-       the `--glass-level` escape reach it. Presets-in-consumers — retune via :root. */
-    --glass-opacity-clear: 0.58;
-
     /* Dock foreground over an animated backdrop. A dock floating over an
        aurora/animated surface (`value.js` dock-over-aurora, a slides routed
        control, bbnf) sits on a mid-luminance, shifting field where the muted
@@ -267,34 +266,52 @@
        `color-mix(in oklab, …, --glass-tint-source --glass-tint-strength)` wrapper
        the rungs reach for, ZERO-delta at `--glass-tint-strength: 0%` — so W55's
        adaptive darken can reach the dock (the G2 over-light surface) without a
-       second hand-rolled recipe. */
+       second hand-rolled recipe.
+
+       BG.W-GLASS-REGISTER-UNIFY note — this `:root`-baked oklab tint IS the
+       substitution trap the `@utility glass-fill` HOME (glass/surfaces.css, R9) kills:
+       the outer tint here resolves --glass-tint-source/-strength at `:root` (0%), so a
+       descendant `.glass-dock` that re-points the tint under the W55 bright bucket does
+       NOT re-tint through this token. The dock/shell/morph surfaces already escape it by
+       composing the element-level oklab tint AT the element (dock/shell.css,
+       dock/morph.css) — the applied `glass-fill` shape. De-tinting this `:root` token
+       onto the plain opacity footprint is the sibling-gate-coordinated atomic step
+       (proof:dialog-glass DG1 pins `--glass-bg-dialog` to the same wrapper form). */
     --glass-bg-dock:     color-mix(in oklab, color-mix(in srgb, var(--card) calc((1 - (1 - var(--glass-opacity-dock)) * var(--glass-level)) * 100%), transparent), var(--glass-tint-source) var(--glass-tint-strength));
     --glass-bg-chassis:  color-mix(in srgb, var(--card) calc((1 - (1 - var(--glass-opacity-chassis)) * var(--glass-level)) * 100%), transparent);
     /* BC.W-DIALOG-GLASS — the dialog plate bg, composed the SAME oklab-tint-wrapped
        way the dock self-re-points (so the BC.W-ADAPTIVE-RECONCILE darken reaches the
        modal over a bright backdrop without a second hand-rolled recipe). The 0.68
        opacity is the iOS-27 control-center register (see `--glass-opacity-dialog`).
-       DialogContent.vue re-declares `--glass-bg-floating: var(--glass-bg-dialog)` on
-       the dialog scope (the documented retune path — the self-re-point, NOT a raw
-       rung override) so the floating edge/rim/under-shadow LIFT survives the
-       transparency drop. */
+       BI.W-GLASS-TOKEN-PRUNE — DialogContent.vue re-points the internal `--glass-bg-
+       rung` slot onto `--glass-bg-dialog` on the dialog scope (the ONE-DOOR read —
+       NOT a `--glass-bg-floating` double-name alias) so the floating edge/rim/under-
+       shadow LIFT survives the transparency drop. */
     --glass-bg-dialog:   color-mix(in oklab, color-mix(in srgb, var(--card) calc((1 - (1 - var(--glass-opacity-dialog)) * var(--glass-level)) * 100%), transparent), var(--glass-tint-source) var(--glass-tint-strength));
     /* BE.W-SHEET-TRANSLUCENT — the bottom-sheet plate bg, composed the SAME oklab-
-       tint-wrapped way the dialog self-re-points (so the W55 darken + the dark-arm
+       tint-wrapped way `--glass-bg-dialog` is (so the W55 darken + the dark-arm
        saturate companion reach the see-through sheet without a second hand-rolled
        recipe — byte-isomorphic to `--glass-bg-dialog`, only the opacity token
-       differs). Drawer + SheetContent re-declare `--glass-bg-floating:
-       var(--glass-bg-sheet)` on their scope (the self-re-point recipe — NOT a raw
-       rung override that won't re-compose) so the floating edge/rim/under-shadow LIFT
-       survives the transparency drop. */
+       differs). BI.W-GLASS-TOKEN-PRUNE — the α-band probe DECIDED this is genuinely-
+       distinct physics (Δ plate-α 0.21 vs overlay; ΔL 0.10–0.18 over a busy/dark page
+       → KEEP). Its LIVE consumer is the Drawer descent gradient (drawer.css), where
+       the transmissive crown sinks the `--glass-bg-overlay` fill toward this see-
+       through floor across the pull. (SheetContent renders the floating tier at rest;
+       wiring the resting sheet plate onto this 0.74 register is a booked BE follow —
+       held OUT of this reconcile by the wave's 0-delta plate constraint.) */
     --glass-bg-sheet:    color-mix(in oklab, color-mix(in srgb, var(--card) calc((1 - (1 - var(--glass-opacity-sheet)) * var(--glass-level)) * 100%), transparent), var(--glass-tint-source) var(--glass-tint-strength));
-    /* BE.W-CLEAR-VARIANT — the maximally-translucent Apple-Clear plate bg, composed
-       the SAME oklab-tint-wrapped way (so the W55 darken reaches the clear plate).
-       The `surface="clear"` decoration reads this fill AND couples its MANDATORY
-       `::before` legibility scrim (the scrim dims the BACKDROP — distinct from this
-       PLATE tint; the two axes stay disjoint). Byte-isomorphic to `--glass-bg-dialog`,
-       only the (lower) clear opacity differs. */
-    --glass-bg-clear:    color-mix(in oklab, color-mix(in srgb, var(--card) calc((1 - (1 - var(--glass-opacity-clear)) * var(--glass-level)) * 100%), transparent), var(--glass-tint-source) var(--glass-tint-strength));
+
+    /* ── BI.W-SURFACE-EXTRACT — the recessed WELL rung (value.js P3 ADMIT) ──────────
+       A SEATED field register: the `--card` plate stepped a whisper DARKER toward the
+       warm `--foreground` ink so a nested control/field reads as recessed INTO the
+       surface (the input-well / meter-track / seated-chrome look) — the tone-step is
+       an oklab mix (the perceptual glass-tint family, NOT the in-srgb brand-overlay
+       fence). `--glass-well-tone` is the ONE knob, default 8%, bounded to the value.js
+       P3 [6%,10%] band (below 6% reads flat, above 10% reads like a filled plate). The
+       `.glass-well` class (glass/surface-axis.css) composes it AT the element (so a
+       per-scope `--glass-well-tone` override re-resolves — the substitution-vs-
+       inheritance discipline). */
+    --glass-well-tone: 8%;
 
     /* ── BE.W-TINTED-CHIP — the per-INSTANCE PLATE-FILL tint axis (`--glass-fill-tint`
        / `--glass-fill-strength`) ──────────────────────────────────────────────────
@@ -314,6 +331,31 @@
        component) — the fill is read on the surface, never written into a `--glass-bg-*`
        token here. The `@property` registration is below (the typed no-op floor). */
 
+    /* ── BG.W-GLASS-CONSUMER-BAND — the SHARED per-instance PLATE recipe (the fold
+       home) ───────────────────────────────────────────────────────────────────────
+       `--glass-fill-tinted` is the ONE `color-mix(in oklab, …)` per-instance data-hue
+       plate the fill-tint CONSUMERS (Badge-glass · SelectableChip · IconChip-glass via
+       `.glass-atom`/`.glass-chip`) READ instead of each re-spelling it — the DRY fold
+       of the two forked `--glass-atom-tinted`/`--glass-chip-tinted` inline re-spells
+       onto ONE plate. It reads the `--glass-fill-tint`/`--glass-fill-strength` axis
+       DIRECTLY (the data hue at the bounded strength), so a consumer's `:tone`/`:section`
+       hue reaches the plate — closing the `.glass-atom` fork that mixed a FIXED
+       `--glass-capsule-warm` cream regardless of the per-instance hue (a `destructive`/
+       `success`/`info` glass badge got NO semantic tint). It is the LATER `background-
+       image` layer over the `.glass-capsule` warm-transmissive body (the proven
+       `.paper-grid` coexistence seam — paints OVER the translucent fill, UNDER content);
+       the capsule's own warm floor carries the idle warmth so this layer is the data-hue
+       event alone. At the `@property` defaults (transparent + 0%) it is the byte-
+       identical no-op (`color-mix(in oklab, X, transparent 0%)` ≡ X). The 0-alpha stop
+       is warm `oklch(… / 0)`, NEVER bare `transparent` (the WebKit black-premultiply
+       hole, build-trap-(d)). Pairs with the SHARED rim `--glass-material-rim` the
+       capsule carries — the plate/rim pair every consumer composes. */
+    --glass-fill-tinted: color-mix(
+        in oklab,
+        var(--glass-fill-tint, oklch(0.9 0.05 75 / 0)) var(--glass-fill-strength, 0%),
+        oklch(0.9 0.05 75 / 0)
+    );
+
     /* Composed borders — foreground-tinted. BC.W-BLACK-BAR D2 — the perimeter
        hairline is RETIRED as the silhouette device. The old 11-22% warm-ink rung
        borders rode --foreground (oklab L 0.216, near-black warm ink); over a
@@ -339,6 +381,29 @@
     --glass-border-dock:     color-mix(in srgb, var(--foreground) 8%, transparent);
     --glass-border:          var(--glass-border-quiet);
 
+    /* ── The DEFINED control tier (BG.W-GLASS-DEFAULT-DEFINITION · GA-1) ───────
+       Glass is the maximal default (AX.W54), but its blur is imperceptible over a
+       FLAT page — a bare <Button>/.input-pill reads as a near-gray shape (chroma
+       0.0138, BD GOLDEN, root cause `--glass-tint-strength: 0%`). The DEFINED tier
+       gives a CONTROL a read-carrying warm rim + a warm-cream floor over ANY backdrop,
+       on the ONE --glass-level/edge machinery (NOT a fork). Both legs read the ONE
+       `@property --glass-definition` scalar (property-regs.css; 0 = transmissive,
+       1 = defined), so the scalar is genuinely load-bearing (dead-knob-proof). The
+       transmissive --glass-bg-* ladder above is BYTE-UNTOUCHED — a content surface
+       stays transmissive; `.glass-defined` (glass/defined.css) engages the floor.
+
+       --glass-floor-fill is an ALPHA-OF-`--card` PLATE leg (this file's own --glass-bg-*
+       compose idiom), NOT a chroma tint — so `in srgb` is CORRECT here (the oklab/srgb
+       fence is tint-vs-plate, and this is plate). At definition 0 the floor resolves to
+       fully transparent (the no-op floor for a content tier); at definition 1 it is the
+       ≤15% warm-cream backplate a control floats over a flat white page. */
+    --glass-floor-fill-max:  15%;
+    --glass-floor-fill:      color-mix(in srgb, var(--card) calc(var(--glass-definition) * var(--glass-floor-fill-max)), transparent);
+    /* The read-carrying warm rim rung — a LIFTED alpha of the warm hairline (14% at
+       full definition, scaled by --glass-definition), DISTINCT from the ≤5% content
+       hairline above; --foreground H≈56° so the defined rim reads WARM, never gray. */
+    --glass-border-defined:  color-mix(in srgb, var(--foreground) calc(var(--glass-definition) * 14%), transparent);
+
     /* ── The control REST register (BA.W-SURFACE-AXIS scope 7) ────────────────
        ONE shared resting surface for the FORM family — Input/Textarea/Select/
        Combobox/NumberField/TagsInput — so the whole control band is ONE material

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

@@ -63,10 +63,24 @@
 
    FALLBACK (§2c): this whole block is `@supports`-gated, so an engine
    WITHOUT `light-dark()` skips it and the retained `.dark` class block (the
-   SOLE fallback floor) drives dark exactly as at HEAD. `light-dark()` is the
+   fallback floor) drives dark exactly as at HEAD. `light-dark()` is the
    enhancement OVER the class — not a parallel alias. Baseline Newly
    Available; the fallback floor is the pre-existing class block (net-zero
    new fallback LOC).
+
+   IDIOM-REVERSAL — the CANONICAL single source for COLOR
+   (BG.W-GLASS-BASIS-CONSOLIDATE, R16 MN-1). colors → `light-dark()` only is
+   now the CANON: this block is the single source of truth for every paired
+   COLOR token. The `.dark {}` color re-declarations (dark-arm.css) are the
+   fallback-floor LOCKSTEP WITNESSES only — they MUST byte-agree with the dark
+   arg here, never a second value (two arms painting two different dark colors
+   is the bug; `proof:glass` clause DA1 reds a divergence). SHADOWS and INSETS
+   go the OTHER way: `.dark {}` plain arms ONLY, NEVER folded into
+   `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()). One mechanism per token TYPE. This SUPERSEDES
+   the plain per-mode pair idiom for COLOR tokens (the reversal is INTENTIONAL,
+   recorded here).
    ═══════════════════════════════════════════════ */
 @supports (color: light-dark(white, black)) {
     :root {
@@ -115,14 +129,16 @@
            the `.dark` fallback floor below (§2c). */
         --destructive:             light-dark(hsl(0 72% 50%), hsl(0 80% 60%));
         --destructive-foreground:  light-dark(var(--neutral-0), hsl(48 10% 90%));
-        --ring:                    light-dark(hsl(24 10% 10%), hsl(48 10% 70%));
+        /* BG.W-DESHADCN — the light-dark() arm of the renamed house focus-accent
+           register (off the shadcn `--ring`; both halves byte-identical). */
+        --focus-ring-color:        light-dark(hsl(24 10% 10%), hsl(48 10% 70%));
         --shadow:                  light-dark(hsl(24 10% 10%), hsl(0 0% 5%));
 
         /* §4 native-control accent — the per-mode arms (dark reads the
-           mid-tone ring for checkmark-glyph contrast headroom, NOT the
+           mid-tone focus accent for checkmark-glyph contrast headroom, NOT the
            near-white dark primary). Joins the light-dark() collapse; still
            re-specified as `accent-color` inside `.dark` per §2b. */
-        --accent-color:            light-dark(var(--primary), var(--ring));
+        --accent-color:            light-dark(var(--primary), var(--focus-ring-color));
 
         /* Section palette — jewel tones brightened L for dark (oklch pairs;
            AV.W16 TW2 — hue preserved, L evened) */

package/src/styles/tokens/motion-registers.css

@@ -0,0 +1,93 @@
+/* tokens/motion-registers.css
+   BI.W-REGISTER-TABLE — the NAMED motion registers over the ONE `.glass-reveal`
+   recipe (D-MOTION PASS-1 §2.1). This is the register TABLE: a semantic name →
+   a bundle `{spring, clock, scale, blur, slide}`. The ONE `.glass-reveal` recipe
+   (glass/reveal.css) binds a register by name via `data-reveal="overlay|menu|
+   tooltip|transient"` — swapping ONLY these knob vars, never the recipe body.
+
+   @import-ed by tokens.css IMMEDIATELY AFTER scheme-spring.css — it READS the
+   parity-fixed `--spring-*` / `--spring-*-duration` clocks (BI.W-SPRING-PARITY,
+   READ-ONLY here — the W-GLASS-CAL fence; this file re-times NO spring, it BINDS
+   the shipped registers to a semantic name). Custom properties resolve order-
+   independently within :root, so the placement is cascade-order-invariant.
+
+   THE KEY CORRECTION (PASS-4B): the parity fix (W-SPRING-PARITY), NOT response-
+   shortening, landed the enters IN-BAND — keep the 400ms clock, fix the curve. So
+   each register carries the FULL settle clock; the perceptual arrival is audacious
+   because the parity-fixed curve reaches ~90% by ~mid-clock, not a truncated timer.
+
+   ── The register table ──────────────────────────────────────────────────────
+   | register        | spring          | clock (settle) | scale-from | blur  | rise  |
+   |-----------------|-----------------|----------------|------------|-------|-------|
+   | enter-overlay   | snappy          | 0.44s          | 0.88       | 6px   | 0.5rem|  Dialog/Sheet/Popover — the .glass-reveal DEFAULT. Blur is the dominant overlay channel (MOTION-LADDER M4); t90 ~212ms/+3.2% (iOS 130-370ms materialize band).
+   | enter-menu      | smooth          | 0.35s (tight)  | 0.96       | 2px   | 0.5rem|  dropdown/select/combobox/command — the REFINED bounce (UF-G3) + "popover like the dropdown" homogeneity (UF-G2). t90 ~239ms/+0.2%.
+   | enter-tooltip   | ease-out-expo   | 0.2s (fastest) | 0.97       | 0     | 0     |  tooltip/hover-card — NO overshoot, fastest decelerating arrival (UF-G4 "tightened").
+   | enter-transient | transient       | 0.46s          | 0.5        | 8px   | 0     |  Toast + Notification — the gentle-class CENTER-SEED materialize bloom (MOTION-LADDER M5). NEW spring row (0.62, 0.90); t90 ~0.34s.
+
+   ── The exit register (M6 — tighten 200ms → 150/100ms) ──────────────────────
+   NAMED exit clocks on the no-overshoot `--ease-out` (P2: a closing surface must
+   never overshoot past gone). Minted as their OWN tokens, NOT a re-tune of the
+   shared `--duration-fast` (0.2s) — re-timing that would re-time everything, and
+   this closes the reveal.css comment-vs-value drift (the comment claimed ≤150ms
+   while `--duration-fast` = 0.2s). The `.glass-reveal` exit reads `--exit-overlay-
+   duration` by default; `[data-reveal="transient"]` swaps in the tighter transient
+   exit.
+
+   ── press / morph / cascade — NAMES over shipped recipes (zero paint change) ──
+   These registers are NAMED here for the doctrine (the motion canon's register
+   vocabulary), pointing at their ALREADY-SHIPPED source tokens — NO new token is
+   minted (a dead alias would trip the dead-token floor):
+     · press   → `--spring-press` (0.12s tap; useSpringPress + --glass-btn-press-t)
+     · morph   → `--spring-dock` / `--spring-dock-duration` (the dock box morph)
+     · cascade → the W-SCROLL-MOTION `.scroll-cascade` / `--scroll-cascade-*` recipe
+
+   ── PKT-2 spring-clock hole — the MARKING-PASS decision (recorded IN the table) ──
+   The value.js PKT-2 consumer surfaced a "spring-clock hole": press (0.12s tap) ↔
+   snappy (0.44s) with a ~0.3s-settle gap, framed as "mint a ~0.3s preset OR bless
+   snappy". DECISION: NEITHER new preset NOR bless-snappy. The ~0.3s-settle register
+   ALREADY EXISTS — `--spring-smooth` (0.35s, the SETTLE / enter-menu clock). A
+   press-adjacent consumer composes the existing register: the tap on `--spring-press`
+   (0.12s), the mid-settle on `--spring-smooth` (0.35s). Minting a 7th INTERACTIVE
+   preset for ONE value.js consumer fails the ≥2-consumer bar (presets-in-consumers);
+   "bless snappy" is rejected because 0.44s reads sluggish for a press-adjacent
+   interaction. (The `transient` 7th row IS minted — but for a DISTINCT need with ≥2
+   consumers: the enter-transient center-seed bloom, Toast + Notification.) */
+:root {
+    /* ── enter-overlay — the .glass-reveal DEFAULT (Dialog / Sheet / Popover) ── */
+    --enter-overlay-spring: var(--spring-snappy);
+    --enter-overlay-clock: var(--spring-snappy-duration);
+    --enter-overlay-scale: 0.88;
+    /* Blur is the dominant overlay channel (MOTION-LADDER M4) — 4px → 6px. */
+    --enter-overlay-blur: 6px;
+    --enter-overlay-slide: 0.5rem;
+
+    /* ── enter-menu — dropdown / select / combobox / command (UF-G2/UF-G3) ── */
+    --enter-menu-spring: var(--spring-smooth);
+    --enter-menu-clock: var(--spring-smooth-duration);
+    --enter-menu-scale: 0.96;
+    --enter-menu-blur: 2px;
+    --enter-menu-slide: 0.5rem;
+
+    /* ── enter-tooltip — tooltip / hover-card (UF-G4 — NO overshoot, fastest) ── */
+    --enter-tooltip-spring: var(--ease-out-expo);
+    --enter-tooltip-clock: var(--duration-fast);
+    --enter-tooltip-scale: 0.97;
+    --enter-tooltip-blur: 0px;
+    --enter-tooltip-slide: 0px;
+
+    /* ── enter-transient — Toast + Notification CENTER-SEED bloom (MOTION-LADDER M5) ── */
+    --enter-transient-spring: var(--spring-transient);
+    --enter-transient-clock: var(--spring-transient-duration);
+    /* The deep scale-from — a materialize bloom from ~half-size (not the near-no-op
+       overlay 0.88), so the surface reads as coalescing from its own seed. */
+    --enter-transient-scale: 0.5;
+    --enter-transient-blur: 8px;
+    /* Center-seed — no directional edge slide (it blooms from its own centre). */
+    --enter-transient-slide: 0px;
+
+    /* ── The NAMED exit clocks (M6 — tighten the reveal exit 200ms → 150/100ms) ── */
+    --exit-overlay-duration: 0.15s;
+    --exit-transient-duration: 0.1s;
+    /* The exit curve — the no-overshoot ease-out (P2: never overshoot past gone). */
+    --exit-curve: var(--ease-out);
+}

package/src/styles/tokens/offsets.css

@@ -92,7 +92,6 @@
 
     --max-width-input: 24rem;
     --input-min-width-sm: 5rem;
-    --min-width-input-sm: var(--input-min-width-sm);
     /* AU.W8b.4 — canonical popover width (Combobox list + anchor). Lifts the
        `w-[200px]` arbitrary-value wrap to the `w-popover` @theme utility. */
     --popover-width: 200px;