@mkbabb/glass-ui 4.2.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) ───────────────────────
@@ -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,53 @@
        `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); 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`) ──────────────────────────────────────────────────
@@ -314,6 +332,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 +382,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/property-regs-specular.css

@@ -0,0 +1,160 @@
+/* tokens/property-regs-specular.css
+   §11b the pointer-anchored moving-specular :root/.dark magnitude cohort + the interaction/scroll DRIVE @property registrations (glass-btn-press-t, the completion-seal draws, the native scroll-ramp / chrome-collapse customs).
+   Carved from property-regs.css to hold the no-god-module 500-line bound (BI.W-STYLE-REDRAIN); @import-ed by tokens.css IMMEDIATELY AFTER property-regs.css. Same :root cascade context as its sibling — the @property registrations are order-invariant and the specular-intensity :root/.dark cohort is the sole writer, so the relocation is byte-isomorphic. */
+/* ── The specular-intensity magnitude cohort (AX.W09) ──────────────────────
+   The catch-light alpha multiplier at each interaction state, as a SINGLE
+   overridable token cohort (was three buried literals across glass.css —
+   `0.35` rest floor / `0.6` hover / `0.85` active — and the `.dark` arm's
+   `0.22`). `glass.css`'s `.glass-material::before` rest/hover/active rules READ
+   these, so the subtle-vs-extreme magnitude is a knob a consumer (or the dark
+   arm) retunes ON THE CASCADE — never a re-buried literal. Override on `:root`
+   to retune library-wide; the cartoon-shadow override contract is the precedent.
+
+   Re-baselined AGAIN at AX.W52 D19 — with the central screen-disc replaced by a
+   BOUNDED plus-lighter edge gleam (glass.css), the gleam is a whisper at every
+   rung, so the cohort drops further (the W09 0.22/0.32 ceiling still lifted the
+   whole-tile disc on hover):
+     • rest   0    — static, unwired surfaces are CLEAN; the gleam wakes only on
+                     hover/active or on a pointer-wired surface. Aligns the painted
+                     rest with the @property `--specular-intensity { initial-value:
+                     0 }` dormancy.
+     • hover  0.10 — a whisper edge gleam, not a bloom.
+     • active 0.16 — the press whisper. */
+:root {
+    --glass-specular-intensity-rest: 0;
+    --glass-specular-intensity-hover: 0.1;
+    --glass-specular-intensity-active: 0.16;
+    /* BB.W-BUTTON-GLASS (d) — the BUTTON-SCOPED hover gleam bump. The lit glass
+       button should read a notch brighter at the grazing edge than the global
+       hover whisper (0.10). `.btn-glass` re-points its own
+       `--glass-specular-intensity-hover` to this knob (surfaces.css), so ONLY the
+       button lifts — the global cohort above is UNTOUCHED. A consumer retints the
+       button gleam from this ONE override. */
+    --glass-specular-btn-hover: 0.14;
+}
+
+/* Over the deep canvas `plus-lighter` still lifts, so the dark arm runs a touch
+   softer on the interaction rungs (rest already 0). */
+.dark {
+    --glass-specular-intensity-hover: 0.08;
+    --glass-specular-intensity-active: 0.12;
+    /* The button bump rides a touch softer in dark too (the dark hover is 0.08;
+       the button reads ~0.11, still a notch above the global whisper). */
+    --glass-specular-btn-hover: 0.11;
+}
+
+/* BB.W-BUTTON-GLASS (b)/(e) — the press DRIVE scalar. ONE typed 0..1 custom
+   property Button.vue writes off the `useSpringPress` spring (0 released → 1
+   pressed, with the ~5% overshoot the spring carries). It is the SINGLE drive the
+   press SQUISH (the `useLiquidFlex` reciprocal X/Y deform), the coupled specular/
+   brightness lift, and the optional `.glass-refract` lens-swell all read — the "one
+   drive, the glass deforms under press" read. Registered typed so a `transition`/
+   downstream `calc()` interpolates the VALUE (number), not the text. `inherits:
+   true` so the host-written value reaches the `.glass-material::before` pseudo +
+   the coupled rules. `initial-value: 0` so an unwired/SSR button is the static
+   rest frame (the no-JS CSS `.tap-squish` scale floor still presses). */
+@property --glass-btn-press-t {
+    syntax: "<number>";
+    inherits: true;
+    initial-value: 0;
+}
+
+/* BC.W-AX-COMPLETION-SEAL — the 4 motion drives of the hero-scale earned-GOLD
+   completion seal (completion-seal.css consumes them). Registered typed so the
+   one-shot draw INTERPOLATES (a bare unregistered var() snaps; the §18 typed-property
+   idiom lets the engine animate the stroke-reveal / settle / glint). The seal is the
+   visual seal of the W-PHASE-PALETTE completion event — its ink reads the earned-gold
+   register; its glint composes the W-AX-METAL-GLOW catch-light. One-shot, PRM-gated,
+   compositor-only.
+
+   • --seal-draw (<percentage>) — the stroke-reveal extent (the stroke-dashoffset wipe
+     drive: 0% undrawn → 100% fully drawn). `inherits: false` (each seal owns its own
+     draw, the per-surface ownership of the specular/border-progress cohort — a sealed
+     parent must not push its draw onto a child seal). `initial-value: 100%` is the
+     SAFE fully-drawn resting seal: on a non-supporting engine (no @property) the seal
+     paints fully drawn, NEVER a blank — the editorial draw-on degrades to the finished
+     mark, never to nothing.
+
+   • --seal-scale (<number>) — the settle scale (the draw-on lands with a small spring
+     overshoot on the seal's own --spring-snappy/--spring-bouncy clock — the SPATIAL
+     leg, W-MOTION-CANON P2 enter-bouncy). `inherits: false` (per-seal). `initial-value:
+     1` is the resting settled scale.
+
+   • --seal-glint (<number>) — the gold catch-light intensity (the one-pass glint that
+     fires once on settle, reading --metal-glow-opacity from W-AX-METAL-GLOW — a glint,
+     not a loop). `inherits: false` (per-seal). `initial-value: 0` so an unwired seal is
+     un-glinting at rest (the calm floor; the glint wakes only on the draw).
+
+   • --seal-ink (<color>) — the seal stroke color. `inherits: true` (the cascading-scalar
+     idiom — a consumer scope re-inks the seal in lockstep with the completion register).
+     The @property `initial-value` MUST be a CONCRETE var-free <color> (the typed-property
+     rule: a registration fallback cannot be a var()), so it is the LITERAL light-gold
+     `oklch(0.751 0.147 84.2)` (scale-paper.css's `--gold` value) — the engine fallback
+     when no cascaded value exists. The RUNTIME cascade default is the TOKEN form the
+     recipe sets: `--seal-ink: var(--phase-complete-color, var(--color-gold))` — the
+     EARNED-gold completion register (Q2: gold is earned at completion, NEVER the running
+     phase spectrum). */
+@property --seal-draw {
+    syntax: "<percentage>";
+    inherits: false;
+    initial-value: 100%;
+}
+
+@property --seal-scale {
+    syntax: "<number>";
+    inherits: false;
+    initial-value: 1;
+}
+
+@property --seal-glint {
+    syntax: "<number>";
+    inherits: false;
+    initial-value: 0;
+}
+
+@property --seal-ink {
+    syntax: "<color>";
+    inherits: true;
+    initial-value: oklch(0.751 0.147 84.2);
+}
+
+/* BC.W-SCROLL-TRIGGER — the native scroll-ramp custom. The continuous 0..1 scroll
+   progress the `useScrollTrigger` reader exposes rides this registered custom on a
+   `supportsScrollTimeline()` engine: a `.scroll-progress`-style recipe writes it via
+   `animation-timeline: scroll(self)` so a consumer's CSS ramp (the BC.W-SCROLL-CHROME
+   shrink/opacity) reads `--scroll-t` with ZERO JS (the dual-path single-writer — the JS
+   `progress` ref attaches NOTHING on a supporting engine). `inherits: true` (the
+   cascading-scalar idiom — a scroll-driven ancestor exposes the ramp to descendant
+   chrome, the `--ui-scale`/`--glass-level` pattern), distinct from the per-element
+   non-inheriting specular/progress cohort. `initial-value: 0` is the safe resting ramp
+   (the unregistered fallback paints it; on a non-supporting engine the JS reader writes
+   `progress.value` and the consumer reads the ref, not this custom). The typed
+   `<number>` lets the engine interpolate the ramp rather than the textual rep (a bare
+   unregistered var() snaps — the `--border-progress-fill`/`--dock-morph-t` precedent). */
+@property --scroll-t {
+    syntax: "<number>";
+    inherits: true;
+    initial-value: 0;
+}
+
+/* BC.W-SCROLL-CHROME — the floating-chrome COLLAPSE fraction. `--chrome-collapse-t`
+   is the 0..1 collapse scalar `useScrollChrome` ramps off the scroll reader's
+   direction + range (0 = fully expanded, 1 = fully collapsed). The `.scroll-chrome`
+   recipe (scroll-chrome.css) reads it for the COMPOSITOR shrink/quiet ramp:
+   `transform: scale()/translateY()` (the SPATIAL leg), `opacity` (bounded above a
+   never-invisible floor — the NN/g pale-fade trap forbidden), and the shadow LIFT as
+   content scrolls under (Apple "as text scrolls underneath, shadows become more
+   prominent"). It NEVER drives the resting `backdrop-filter` blur (the
+   W-DOCK-SHRINK-BLUR fence — the shrunken bar is crisp glass, not a blurry mess).
+   Registered typed so a bare `var()` INTERPOLATES the ramp rather than snapping (the
+   `--scroll-t`/`--dock-morph-t` precedent); `inherits: true` (the cascading-scalar
+   idiom — a scroll-driven ancestor exposes the collapse to descendant chrome, the
+   `--scroll-t`/`--glass-level` pattern, distinct from the per-element non-inheriting
+   specular cohort). `initial-value: 0` is the PERSISTENT rest (the iOS-27 default — a
+   bare chrome does NOT collapse; the unregistered fallback paints it too, so the
+   recipe is byte-identical to the expanded chrome when unwired). */
+@property --chrome-collapse-t {
+    syntax: "<number>";
+    inherits: true;
+    initial-value: 0;
+}