@mkbabb/glass-ui 4.1.0 → 5.0.0

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) ───────────────────────
@@ -110,11 +120,14 @@
        MATERIAL luminosity lift — the SAME named tokens, per-mode (the plain per-mode
        pair idiom). The brightness() companions stay baked (this fold mints ONLY the
        saturate knob). Machine-locked by `proof:glass-legibility` L7. */
-    --glass-saturate-wash:     1.05;
-    --glass-saturate-quiet:    1.05;
-    --glass-saturate-resting:  1.05;
-    --glass-saturate-floating: 1.18;
-    --glass-saturate-overlay:  1.2;
+    --glass-saturate-wash:     1.4;
+    --glass-saturate-quiet:    1.4;
+    --glass-saturate-resting:  1.4;
+    --glass-saturate-floating: 1.6;
+    --glass-saturate-overlay:  1.6;
+    /* 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 →
@@ -138,33 +151,49 @@
        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. */
-    --glass-blur-dock:     blur(calc(var(--glass-blur-dock-radius) * var(--glass-level)));
-
-    /* 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
        visible through it. Consumed by `.glass-dock` via `--glass-bg-dock`. The
        value holds the surface register against the tightened 11px blur so the
        dock reads as painted chrome, not a frosted ghost. */
-    --glass-opacity-dock: 0.42;
+    /* BD.W-DOCK-CORE (D3) — the dock base alpha lifts 0.42 → 0.50 (margin-insurance for
+       the warm-chromatic darken: the base composite chroma closes a notch before any tint
+       engages). Stays the lightest chrome tier (below resting 0.65), mode-invariant. */
+    --glass-opacity-dock: 0.50;
 
     /* Dialog-specific opacity (0.68) — BC.W-DIALOG-GLASS. The iOS-27 control-
        center modal register: SEE-THROUGH frosted glass that reveals the page
@@ -174,12 +203,27 @@
        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-
+       sheet register: SEE-THROUGH frosted glass whose lifted crown reveals the
+       page/album grid beneath, NOT the near-opaque overlay slab (0.95 read as "not
+       glassy"). 0.74 sits BETWEEN the dialog 0.68 (transparent enough that the
+       backdrop reads through) and the overlay 0.95 (opaque enough for AA body text
+       against a busy grid) — a sheet is content-bearing, so it sits a hair above the
+       dialog. The composed `--glass-bg-sheet` rides the SAME oklab-tint-wrapped
+       recipe `--glass-bg-dialog` speaks, so the W55 bright-bucket darken + the
+       `--glass-level` opaque escape + the dark-arm saturate companions reach the
+       sheet with ZERO new compositing seam. Drawer + Sheet self-re-point onto it.
+       Presets-in-consumers — a consumer retunes `--glass-opacity-sheet` via :root. */
+    --glass-opacity-sheet: 0.74;
+
     /* 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
@@ -222,18 +266,96 @@
        `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 `--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). 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));
+
+    /* ── 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); this `:root` token is the named rung for a direct read. */
+    --glass-well-tone: 8%;
+    --glass-bg-well:     color-mix(in oklab, var(--card), var(--foreground) var(--glass-well-tone));
+
+    /* ── BE.W-TINTED-CHIP — the per-INSTANCE PLATE-FILL tint axis (`--glass-fill-tint`
+       / `--glass-fill-strength`) ──────────────────────────────────────────────────
+       The THIRD per-instance chromatic axis (BESIDE the rim `--glass-accent` and the
+       whole-plate legibility `--glass-tint-source`): `--glass-fill-tint` tints the
+       plate BACKGROUND BODY toward a consumer DATA hue, so a glass surface reads as
+       COLORED GLASS (a green chip, a violet facet) without re-declaring the composed
+       `--glass-bg-*` token. DISTINCT-not-fork of `--glass-accent` (which tints only the
+       RIM + the `::before` specular CORE — file-line-disjoint): the fill writes the
+       plate body, the accent writes the rim; a chip may carry BOTH. The mix is `in
+       oklab` (the perceptual glass-tint family — NOT the in-srgb `--surface-tint-*`
+       brand-overlay fence, AW.W26). It rides ON TOP of the W55 legibility composite
+       (the plate still darkens-over-light for AA AND carries the data hue — additive,
+       never a replacement). At the `@property` defaults (transparent + 0%) the body is
+       byte-identical to today (`color-mix(in oklab, X, transparent 0%)` ≡ X — the no-op
+       floor). `<GlassChip :tone>` is the first-class consumer (BE.W-TINTED-CHIP
+       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
@@ -253,9 +375,36 @@
     --glass-border-resting:  color-mix(in srgb, var(--foreground) 4%, transparent);
     --glass-border-floating: color-mix(in srgb, var(--foreground) 5%, transparent);
     --glass-border-overlay:  color-mix(in srgb, var(--foreground) 5%, transparent);
-    --glass-border-dock:     color-mix(in srgb, var(--foreground) 4%, transparent);
+    /* W-NAV-DOCK-FIX — the dock is FLOATING chrome over an UNKNOWN backdrop (unlike a
+       content card on the page), so it earns a readable warm-INK hairline (the iOS-27
+       edge-rim layer). 8% warm-ink is still a whisper, never a black bar (--foreground
+       H≈56° → a WARM rim, never a gray line). */
+    --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
@@ -278,3 +427,52 @@
        under-shadow/overlay-scrim) lives in tokens/glass-fx.css (carved at BB.W-CARVE4
        — the next adjacent :root{} block in the cascade). */
 }
+
+/* ── BE.W5 foundation — the typed per-instance axes (the @property no-op floors) ──
+   Registered HERE beside the §8 glass tokens (the canonical @property idiom home is
+   tokens/property-regs.css; these foundation axes live with the §8 ladder they
+   compose so the BE Tier-0 foundation is one self-contained partial). Each mirrors the
+   `--glass-accent`/`--glass-accent-strength` registration shape: a `<color>` HUE +
+   a `<percentage>` STRENGTH, both `inherits: true` (a host sets them on any ancestor
+   to retune the sub-tree) with the NEUTRAL no-op identity (`transparent` / `0%`) so
+   an unset surface is byte-identical to today — `color-mix(in oklab, X, <hue> 0%)` ≡ X.
+   A malformed override CLAMPS to the initial-value (the typed fail-safe). */
+
+/* BE.W-AMBIENT-TINT — the backdrop hue the glass absorbs. `useGlassBackdropLuminance`
+   writes a sampled `oklch()` modal hue here (at a FIXED sub-perceptual chroma — a HUE
+   event, never the backdrop's saturation); a gray backdrop writes `transparent` (the
+   room tints nothing). The `transparent` initial-value is the neutral identity. */
+@property --glass-ambient-hue {
+    syntax: "<color>";
+    inherits: true;
+    initial-value: transparent;
+}
+
+/* The opt-in ambient bias knob — the EXISTING `--glass-tint-source` self-engage
+   re-point biases toward `--glass-ambient-hue` at this strength (bounded ≤ 8% in the
+   cascade — sub-perceptual under the W55 `--glass-tint-strength-aa` bound). `0%`
+   default is the no-op floor (the un-biased `--glass-tint-ink`); the dock wires it on. */
+@property --glass-ambient-strength {
+    syntax: "<percentage>";
+    inherits: true;
+    initial-value: 0%;
+}
+
+/* BE.W-TINTED-CHIP — the per-INSTANCE PLATE-FILL tint. A complete `<color>` data hue
+   the plate BODY mixes toward (`in oklab`, ON TOP of the W55 legibility composite —
+   DISTINCT from the rim `--glass-accent`). `transparent` is the neutral identity (the
+   no-op floor: `color-mix(in oklab, X, transparent 0%)` ≡ X). */
+@property --glass-fill-tint {
+    syntax: "<color>";
+    inherits: true;
+    initial-value: transparent;
+}
+
+/* The fill-tint bounded strength — `0%` default (an unset surface carries no fill
+   tint, byte-identical to today). A consumer (`<GlassChip :strength>`) dials it for a
+   louder colored-glass chip; the body ink stays legible (the W-ON-GLASS-FG floor). */
+@property --glass-fill-strength {
+    syntax: "<percentage>";
+    inherits: true;
+    initial-value: 0%;
+}

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 {
@@ -98,8 +112,8 @@
            BA.W-NO-GRAY L1 — the LIGHT arm DECOUPLES off the near-achromatic page onto the
            warm-cream plate hsl(36 48% 97%) (LOCKSTEP color-radius.css --card) so the light
            glass plate reads warm-not-gray; the dark arm is UNCHANGED (W-DARK-MATERIAL's). */
-        --card:                       light-dark(hsl(36 48% 97%), hsl(24 8% 16%));
-        --popover:                    light-dark(hsl(36 48% 97%), hsl(24 8% 16%));
+        --card:                       light-dark(hsl(30 85% 96%), hsl(26 22% 17%));
+        --popover:                    light-dark(hsl(30 85% 96%), hsl(26 22% 17%));
         --surface-public-data-panel:  light-dark(hsl(44 16% 96%), hsl(36 9% 18%));
 
         /* BA.W-DARK-MATERIAL scope 4 — the chromatic dark --primary (legendre-violet house
@@ -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);
+}