@mkbabb/glass-ui 4.0.1 → 4.1.0

package/dist/styles/tokens/glass.css

@@ -91,12 +91,38 @@
        opacity-only register. */
     --glass-blur-dock-radius:     9px;
 
+    /* ── Per-rung SATURATE — the CANONICAL named saturate register (BC.W-GLASS-
+       LEGIBILITY-MEASURED, the speedtest-AX BC-W10 fold) ───────────────────────
+       The saturate term is the LOAD-BEARING glass knob (research/apple-glass.md §4:
+       the apple.com nav rides `saturate(1.8)` — the highest term, blur moderate).
+       Each `--glass-saturate-{tier}` is the library's canonical saturation for that
+       rung — a NAMED, `:root`-overridable input the composed `--glass-blur-{tier}`
+       reads THROUGH, the SAME substitution-vs-redeclaration discipline as the
+       `--glass-opacity-{tier}` alpha register above. A `:root { --glass-saturate-
+       quiet: … }` override re-resolves the rung's saturation with ZERO recipe edit
+       (the speedtest "dark cards" chronic + the apple-glass saturate-as-load-bearing
+       lever). The values here ARE the W52-D19 bake (wash/quiet/resting 1.05,
+       floating 1.18, overlay 1.2) become the token defaults — so the composed blur
+       is BYTE-IDENTICAL to the old baked literal (proof:glass-cal / proof:card-tier-
+       alpha stay GREEN by construction). The deep-tier `--glass-saturate-deep` 1.8
+       ceiling (glass-deep.css) is the upper bound; no rung saturate exceeds it. The
+       dark arm (tokens/dark-arm.css) re-declares this register with the W-DARK-
+       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;
+
     /* 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 →
        blur(0) (the clean solid floor with the opacity); level>1 → more diffusion.
-       The per-rung `saturate()`/`brightness()` companions are UNTOUCHED (the level
+       The per-rung `saturate()` companion reads the named `--glass-saturate-{tier}`
+       knob (BC.W-GLASS-LEGIBILITY-MEASURED); `brightness()` stays baked (the level
        scales the RADIUS, not the saturation — W52's calm light-concentration). */
-    --glass-blur-wash:     blur(calc(var(--glass-blur-wash-radius) * var(--glass-level))) saturate(1.05);
+    --glass-blur-wash:     blur(calc(var(--glass-blur-wash-radius) * var(--glass-level))) saturate(var(--glass-saturate-wash));
     /* AV.W15 M1 — the `quiet` rung gained `saturate(1.05) brightness(1.02)`
        so the lower ladder reads with the same saturation life as `resting`+
        (Apple: Liquid Glass concentrates light, it does not desaturate). The
@@ -104,27 +130,34 @@
        between bare `wash` and `resting` without over-brightening the rung.
        The `prefers-reduced-transparency: reduce` bracket at glass.css maps
        `--glass-blur-quiet: none`, so this whole chain drops with the blur. */
-    --glass-blur-quiet:    blur(calc(var(--glass-blur-quiet-radius) * var(--glass-level))) saturate(1.05) brightness(1.02);
-    --glass-blur-resting:  blur(calc(var(--glass-blur-resting-radius) * var(--glass-level))) saturate(1.05);
+    --glass-blur-quiet:    blur(calc(var(--glass-blur-quiet-radius) * var(--glass-level))) saturate(var(--glass-saturate-quiet)) brightness(1.02);
+    --glass-blur-resting:  blur(calc(var(--glass-blur-resting-radius) * var(--glass-level))) saturate(var(--glass-saturate-resting));
     /* AX.W52 D19 — the floating/overlay backdrop saturate tamed from 1.4/1.5 to a
        gentle ~1.18/1.2 (real liquid glass concentrates light ~1.1–1.2×; the prior
        1.4–1.5× over-juiced the bleed-through into a garish smear over a colored
        substrate). wash/quiet/resting already sit at 1.05 — untouched. */
-    --glass-blur-floating: blur(calc(var(--glass-blur-floating-radius) * var(--glass-level))) saturate(1.18);
-    --glass-blur-overlay:  blur(calc(var(--glass-blur-overlay-radius) * var(--glass-level))) saturate(1.2);
+    --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 — the GLASS BUTTON blur. 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. `--glass-blur-btn` lifts the variant onto the `quiet`-tier
-       radius (10px — a genuine liquid-glass diffusion) with the same gentle
-       `saturate(1.05) brightness(1.02)` light-concentration the quiet rung
-       carries (NOT a colour-juice). The wash TILE tier (MetricCell et al.) keeps
-       its 1px — only the glass BUTTON variants reach for this. */
-    --glass-blur-btn:      blur(calc(var(--glass-blur-quiet-radius) * var(--glass-level))) saturate(1.05) 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);
 
     /* Dock-specific opacity (0.42) — lighter than `resting` (0.65) so the dock
        reads as a translucent overlay rather than a panel, backdrop bleed
@@ -133,6 +166,20 @@
        dock reads as painted chrome, not a frosted ghost. */
     --glass-opacity-dock: 0.42;
 
+    /* Dialog-specific opacity (0.68) — BC.W-DIALOG-GLASS. The iOS-27 control-
+       center modal register: SEE-THROUGH frosted glass that reveals the page
+       beneath, NOT the floating-tier near-opaque slab (0.80 read as "NOT glassy
+       at all"). 0.68 sits between `resting` (0.65 — transparent enough to read
+       through) and `floating` (0.80 — opaque enough for AA legibility against
+       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-opacity-dialog: 0.68;
+
     /* 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
@@ -178,22 +225,35 @@
        second hand-rolled recipe. */
     --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. */
+    --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));
 
-    /* Composed borders — foreground-tinted. BA.W-NO-GRAY L3 — the warm RIM
-       re-anchor (G9). The rim IS warm (it rides --foreground, hsl-24 warm ink),
-       but at 8-12% α over a near-white plate it was a near-invisible hairline —
-       the plate had no carved silhouette, reading as a borderless gray rectangle
-       (the user's "no gray ... for cards"). The α lifts a few points per rung so
-       the warm hairline CARVES the silhouette (the WWDC25 "rim that defines the
-       silhouette" device, on the warm-ink register). Still bounded low — the rim
-       is a whisper that defines the edge, never a hard rule. The source stays
-       --foreground (the warm-ink tint, NOT a new color); only the presence lifts. */
-    --glass-border-wash:     color-mix(in srgb, var(--foreground) 11%, transparent);
-    --glass-border-quiet:    color-mix(in srgb, var(--foreground) 13%, transparent);
-    --glass-border-resting:  color-mix(in srgb, var(--foreground) 16%, transparent);
-    --glass-border-floating: color-mix(in srgb, var(--foreground) 19%, transparent);
-    --glass-border-overlay:  color-mix(in srgb, var(--foreground) 22%, transparent);
-    --glass-border-dock:     color-mix(in srgb, var(--foreground) 14%, transparent);
+    /* 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
+       near-white cream plate the full-perimeter hairline read as the user's "wtf
+       is this black bar" — worst on the TOP edge where the bright white catch-light
+       ring sat just inside a dark border (a bright rim and a dark line at war on the
+       SAME edge). The silhouette is now carved by the directional rim
+       (--glass-rim-top catch-light + --glass-rim-bottom under-shadow, glass-fx.css),
+       NOT by this perimeter ink. So each rung drops to ≤5% α — the warm hue stays
+       --foreground (the warm-not-tinted identity, BA.W-NO-GRAY), only the PRESENCE
+       falls below the read-threshold so the hairline can never read as a bar. The
+       +1% on the two heaviest rungs (floating/overlay) holds a faint tier-presence
+       ordering without crossing the threshold (apple-ios27.md §5 "top ≤4%" target). */
+    --glass-border-wash:     color-mix(in srgb, var(--foreground) 4%, transparent);
+    --glass-border-quiet:    color-mix(in srgb, var(--foreground) 4%, transparent);
+    --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);
     --glass-border:          var(--glass-border-quiet);
 
     /* ── The control REST register (BA.W-SURFACE-AXIS scope 7) ────────────────

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

@@ -131,7 +131,7 @@
         --section-color-2:   light-dark(oklch(0.484 0.163 265.5), oklch(0.718 0.107 268.4));
         --section-color-3:   light-dark(oklch(0.542 0.089 222.8), oklch(0.767 0.091 219.9));
         --section-color-4:   light-dark(oklch(0.551 0.088 171.1), oklch(0.776 0.105 172.6));
-        --section-color-5:   light-dark(oklch(0.623 0.124 69.6),  oklch(0.813 0.109 78.2));
+        --section-color-5:   light-dark(oklch(0.530 0.124 69.6),  oklch(0.813 0.109 78.2));
         --section-color-6:   light-dark(oklch(0.579 0.201 30.4),  oklch(0.693 0.151 28.1));
         --section-color-7:   light-dark(oklch(0.532 0.180 317.5), oklch(0.739 0.134 318.1));
         --section-color-8:   light-dark(oklch(0.520 0.176 8.4),   oklch(0.709 0.142 2.3));

package/dist/styles/tokens/offsets.css

@@ -108,6 +108,33 @@
        it claimed to back never read it — PopoverContent paints `p-4` directly), so
        it was an orphan declaration the golden-padding cut prunes. */
     --panel-padding:       0.375rem;
+
+    /* BC.W-OVERLAY-UNIFORM — the token-BACKING of the raw floating-overlay
+       literals (the token-beats-prop seam). Each defaults to the byte-identical
+       HEAD magnitude so a bare overlay is pixel-unchanged; a consumer retunes
+       EVERY overlay's min-width / max-block / tooltip type / select chevron from
+       ONE `:root` override (the uniformity payoff). These are token-backings of
+       EXISTING raw literals (`min-w-32` / `max-h-[60vh]` / tooltip `text-sm` /
+       chevron `opacity-50`) — NOT a new compositing register (the `surface` axis
+       + the φ `--overlay-pad-*` ladder are THREADED, not re-minted). */
+    /* `min-w-32` = 32 × 0.25rem = 8rem — the dropdown/select/context-menu min-width. */
+    --overlay-min-width: 8rem;
+    /* The collision-bounded max-block ceiling the dropdown (`max-h-[60vh]`) +
+       command list (`max-h-[300px]`) read. Defaults to 60vh — the viewport-
+       relative ceiling so a long menu scrolls inside the overlay rather than
+       running off-screen. (The Select precompiled `[data-slot="select-content"]`
+       max-height in select.css is the BA.W-EMISSION consumer-reach floor — KEPT,
+       not threaded here; see the census on-the-line row.) */
+    --overlay-max-block: 60vh;
+    /* The tooltip type rung — the golden quiet caption register (√φ ladder), the
+       token-backing of the bare `text-sm` on TooltipContent (the overlay share of
+       class 3). Defaults to `--type-caption` so the compact tooltip chip reads the
+       house caption scale; a consumer retunes the tooltip type from `:root`. */
+    --tooltip-text: var(--type-caption);
+    /* The Select trigger chevron opacity — the token-backing of the bare
+       `opacity-50` so a consumer retunes the affordance prominence from `:root`. */
+    --select-chevron-opacity: 0.5;
+
     --chart-height-compact: 15rem;
     --chart-height-default: 22.5rem;
     --chart-height-large: 25rem;

package/dist/styles/tokens/property-regs.css

@@ -171,6 +171,19 @@
     initial-value: 0%;
 }
 
+/* BC.W-GLASS-GLOW-FIX (Atlas A-8) — the Pulse aura breath SCALE. The `ambient-pulse`
+   keyframe runs on `.pulse-aura` and writes this property; the `.pulse-aura::before`
+   child (the radial paint) reads it via `transform: scale(var(--pulse-aura-breath-
+   scale))`. Typed `<number>` so the keyframe INTERPOLATES it per-frame (a bare
+   unregistered var would snap min↔max). INHERITS so the pseudo-element picks it up
+   from its originating `.pulse-aura` (the aura has no content descendants — it is
+   `aria-hidden` + empty — so the inherit only reaches the `::before` halo). */
+@property --pulse-aura-breath-scale {
+    syntax: "<number>";
+    inherits: true;
+    initial-value: 1;
+}
+
 /* AX.W54 — the GLASS-FIRST single knob. `--glass-level` is the ONE clarity
    scalar threaded through BOTH glass ladders at their single sites (the
    `--glass-bg-*` opacity recipe + the `--glass-blur-*` radii). It is a typed,
@@ -194,6 +207,26 @@
     initial-value: 1;
 }
 
+/* BC.W-ADAPTIVE-RECONCILE — the OBSERVER's measured backdrop relative-luminance, now
+   LOAD-BEARING. `useGlassBackdropLuminance` WRITES `--glass-backdrop-luma` (0..1) on
+   the glass target; the content/overlay/dock `:where()` rules READ it on the RHS of the
+   `--glass-tint-strength` clamp (glass/ladder.css, dock/morph.css) — the continuous
+   driver that lifts the calm 4% floor toward the ≤24% AA ceiling as the measured
+   backdrop brightens past the knee (the iOS-27 dynamic-range shift; apple-ios27.md §1.5).
+   Registered as a typed INHERITING `<number>` (the `--glass-level`/`--progress-crescendo`
+   precedent) so a bare `var()` INTERPOLATES smoothly between sample frames instead of
+   snapping (a per-sample re-paint would flicker the plate). `inherits: true` so the
+   observer's write on the target reaches every descendant glass surface that reads the
+   clamp. `initial-value: 0` is the calm-dark rest: with luma 0 the clamp's luma-ramp is
+   `max(0, …) = 0`, so an unwired surface resolves EXACTLY the floor (the zero-delta calm
+   identity GLASS-IDENTITY pins). This replaces the empty `--glass-backdrop-luma: ;`
+   placeholder declaration (the dead-knob's write-only stub) — the loop now READS. */
+@property --glass-backdrop-luma {
+    syntax: "<number>";
+    inherits: true;
+    initial-value: 0;
+}
+
 /* BB.W-DEEP-GLASS — the OPT-IN deep-glass DEPTH scalar. `--glass-depth` is the
    `--glass-level` TWIN for the deep tier: a typed INHERITING <number> so a host
    sets it on any ancestor to retune the deep tier's depth (the cascading-scalar
@@ -287,3 +320,103 @@
     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;
+}

package/dist/styles/tokens/scale-paper.css

@@ -44,13 +44,17 @@
        (segmented/pill slider OR the underline rule) STRETCHES along its travel
        axis as it glides between tabs, then settles to fit — the Material 3
        ELASTIC / Apple Liquid-Glass "controls insist on animating themselves"
-       register, kept RESTRAINED. The deform is volume-preserving (stretch X,
-       compress Y in lockstep: `scale: var(--stretch) calc(1 / var(--stretch))`)
-       so it reads as an elastic warp, never a size pump. The cap holds the peak
-       LOW (1.08 ≈ +8%) — iOS 26.2 dialed motion DOWN; a high-frequency control
-       wants a whisper of squish, not a bounce. A consumer dials the elasticity
-       (or to 1 for none) without touching source. */
-    --tab-indicator-max-stretch: 1.08;
+       register. The deform is volume-preserving (stretch X, compress Y in lockstep:
+       `scale: var(--stretch) calc(1 / var(--stretch))`) so it reads as an elastic
+       warp, never a size pump. A consumer dials the elasticity (or to 1 for none)
+       without touching source.
+       BC.W-LIQUID-TAB — lifted 1.08 → 1.15 (in lockstep with the no-token floor
+       DEFAULT_INDICATOR_MAX_STRETCH, the SOLE cap source — constant + token never
+       fork). The click travel-squish AND the liquid-tab pull-morph read this ONE
+       cap; the lift makes a FAST pull visibly swell the pill so the gel-squish READS
+       as liquid (glass-dock-codebase.md §3.4) — still capped LOW (≤1.2, the
+       anti-taffy-pull bar; the pill swells, never taffy-pulls). */
+    --tab-indicator-max-stretch: 1.15;
     /* BA.W-TABS — the indicator's OWN travel clock, re-pointed off the generic
        `--duration-normal` (0.3s, which dragged a ~190ms sub-pixel undershoot tail
        past the ~100ms 90%-travel point — the R10-2 "too slow" read) onto the
@@ -81,6 +85,26 @@
     --invalid-ring: 0 0 0 var(--focus-ring-width)
         color-mix(in srgb, var(--destructive) var(--invalid-ring-tint), transparent);
 
+    /* BC.W-RADIO-FIX — the selection-control STATE register (the `--focus-ring-shadow`
+       / `--invalid-ring` precedent: one named register, read everywhere — never a
+       per-control magic literal). The checks family (Checkbox + RadioGroupItem) reads
+       these TWO tokens so a re-tint is ONE edit, library-wide.
+
+       • `--control-ring` — the UNCHECKED outline. Post-BC.W-BLACK-BAR the general glass
+         rim is ≤4% warm-ink (`--glass-border-resting`), which reads as a near-invisible
+         hairline on a 16px circle — too faint to tell a rest radio from its siblings. So
+         the selection atoms are the NAMED exception (recorded in BC.W-BLACK-BAR's fences):
+         a slightly-stronger ~12% warm-ink outline that reads as a DEFINED circle at 16px
+         without re-introducing the dark `--primary` hairline. Warm-ink-derived (no gray,
+         BA.W-NO-GRAY).
+       • `--control-checked-bg` — the SELECTED glass-tinted fill. The recipe is minted
+         ONCE here (the anti-paste bite: a second inline `color-mix(... --primary 88% ...)`
+         literal on a checks atom reds — the recipe IS the token). Mirrors the
+         glass-`--primary` over the floating tier the Checkbox already speaks, so the ring
+         goes outline → filled glass disc (a real material step), warm-not-saturated. */
+    --control-ring: color-mix(in srgb, var(--foreground) 12%, transparent);
+    --control-checked-bg: color-mix(in srgb, var(--primary) 88%, var(--glass-bg-floating));
+
     /* ═══════════════════════════════════════════════
        §12 PAPER TEXTURES
        ═══════════════════════════════════════════════ */
@@ -94,29 +118,49 @@
     --paper-clean-texture: url("data:image/svg+xml,%3Csvg width='200' height='200' viewBox='0 0 200 200' xmlns='http://www.w3.org/2000/svg'%3E%3Cfilter id='n'%3E%3CfeTurbulence type='fractalNoise' baseFrequency='0.65' numOctaves='4' stitchTiles='stitch'/%3E%3CfeColorMatrix type='saturate' values='0'/%3E%3C/filter%3E%3Crect width='100%25' height='100%25' filter='url(%23n)' opacity='0.04'/%3E%3C/svg%3E");
     --paper-aged-texture: url("data:image/svg+xml,%3Csvg width='200' height='200' viewBox='0 0 200 200' xmlns='http://www.w3.org/2000/svg'%3E%3Cfilter id='n'%3E%3CfeTurbulence type='fractalNoise' baseFrequency='0.5' numOctaves='5' stitchTiles='stitch'/%3E%3CfeColorMatrix type='saturate' values='0'/%3E%3C/filter%3E%3Crect width='100%25' height='100%25' filter='url(%23n)' opacity='0.06'/%3E%3C/svg%3E");
 
-    /* BB.W-PAPER-GRID-TEXTURE — the GEOMETRIC half of the paper-cascade, the
-       peer of the organic turbulence above. Where `--paper-*-texture` are
-       feTurbulence grain fields, this is a two-frequency engineering-paper
-       grid: a 32px MINOR cell + a 128px MAJOR rule (the 4×-major blueprint
-       vocabulary the demo `.story-bg-grid` speaks, re-expressed as a library
-       token so a document-register card can opt its INTERIOR ground into the
-       line-field, not only the page margin). Unlike the organic SVG textures
-       (a baked-at-parse `opacity` URI), the grid is a STATIC `background-image`
-       gradient-STACK — a one-time compositor-cached paint, NEVER a per-frame
-       repaint. The line INK reads a `color-mix(… var(--foreground) N%, …)` so
-       it composes against the warm ink identity and re-tints with `--foreground`
-       in lockstep — never a hardcoded `hsl()` (the no-gray / token-first
-       floor). The ambient through-card strength is the ONE knob
-       `--paper-grid-opacity` (~0.08, the ask's "felt THROUGH the card ~0.08"):
-       the MINOR line ink scales off it directly and the MAJOR rule rides
-       `* 1.6` (the demo's 7%→12% engineering-paper weight step), so a consumer
-       retunes the whole grid from the single strength knob. (The strength lives
-       in the ink alpha, not a layer `opacity`, because the utility paints the
-       grid on the card's HOST `background-image` to avoid the two-pseudo-budget
-       contention with the grain `::after` / specular `::before` — see
-       cards.css.) */
+    /* BC.W-GRID-SIMPLE — the ONE engineering-graph-paper rhythm source. The
+       keyframes.js `EditorShell` magnitudes, re-expressed as `--grid-*` tokens:
+       a fine 1rem cell + a bolder 5rem major rule (the 5× engineering-graph
+       rhythm), each line a hairline-crisp single device-pixel. The pitch is
+       REM-RELATIVE — 1rem (16px at the default root) and 5rem (80px) divide
+       cleanly at DPR 1/2/3, so every line lands on a whole device-pixel column/
+       row (the anti-blur rule; the prior 28px/32px integer pitch landed on
+       sub-pixel boundaries at fractional-DPR zoom and the anti-aliaser softened
+       the 1px lines). The fine 3% is the user's "less busy substrate" — DELIBERATELY
+       BELOW the 10% legibility floor — and the major 11% is held STRICTLY ABOVE it
+       (the kf weight step). The line INK is a `color-mix(… var(--foreground) N%, …)`
+       so it re-tints with the theme by construction (warm-ink on light, lifting
+       off near-black on dark) — NO parallel `--grid-*-dark` family (the
+       `--foreground` flip re-resolves the mix; the cards.css dark-arm precedent).
+       A consumer dials it LARGER (`--grid-pitch: 1.25rem` / `--grid-major: 6.25rem`)
+       or quieter (the `--grid-line`/`--grid-line-major` strength knobs) at `:root`
+       — the token-first axis. This is the SINGLE rhythm source: the demo full-bleed
+       page grid (`.grid-bg`, story-hero.css) AND the library card-interior register
+       (`.paper-grid`, cards.css) both read it (the two-parallel-28px/32px-systems
+       fix). The LIQUID full-bleed sibling (`<PaperGrid>`, BC.W-VIZ-PAPERGRID)
+       re-uses the SAME rhythm — one pitch, two registers (static page-bg vs liquid). */
+    --grid-pitch: 1rem;
+    --grid-major: 5rem;
+    --grid-line: color-mix(in srgb, var(--foreground) 3%, transparent);
+    --grid-line-major: color-mix(in srgb, var(--foreground) 11%, transparent);
+
+    /* The library card-interior GEOMETRIC register (`.paper-grid`, cards.css) —
+       the document-register card's INTERIOR ground, felt THROUGH the glass tint.
+       It UNIFIES its pitch onto the shared `--grid-pitch` (the prior 32px literal
+       retired — ONE rhythm source) and keeps its OWN ambient through-card strength
+       register: the `--paper-grid-opacity` single knob (~0.08, the ask's "felt
+       THROUGH the card ~0.08"). DISTINCT from the page-bg 3%/11% tier above — a
+       card interior reads quieter than a full-bleed page wash — but the PITCH is
+       shared. The ink stays a `color-mix(… var(--foreground) N%, …)` (re-tints with
+       --foreground in lockstep, never a hardcoded literal — the no-gray floor); the
+       MAJOR rule rides `* 1.6` (the 0.08→0.128 weight step). The strength lives in
+       the ink alpha, not a layer `opacity`, because `.paper-grid` paints the grid on
+       the card's HOST `background-image` to avoid two-pseudo-budget contention with
+       the grain `::after` / specular `::before` (see cards.css). A STATIC raster —
+       gradient-stack `background-image`, one compositor-cached paint, never a
+       per-frame repaint. */
     --paper-grid-opacity: 0.08;
-    --paper-grid-texture-size: 32px;
+    --paper-grid-texture-size: var(--grid-pitch);
     --paper-grid-line: color-mix(
         in srgb,
         var(--foreground) calc(var(--paper-grid-opacity) * 100%),

package/dist/styles/tokens/scheme-motion.css

@@ -74,6 +74,20 @@
        §1  DURATION
        ═══════════════════════════════════════════════ */
     --duration-instant: 0.1s;
+    /* BC.W-CONTROL-SMOOTH — the named control-press SURFACE clock (the W-GLASS-CAL
+       per-register-clock discipline). An interactive control the user actively pokes
+       (hover-in, press, toggle) wants the iOS quick ~100-120ms surface beat, NOT the
+       0.2s calm card-crossfade beat — at 0.2s the colour/border/shadow easing drags
+       VISIBLY behind the pointer (the §F "super laggy" read). 0.12s brackets the iOS
+       100-120ms quick-control register (apple-ios27.md). `transition-control` (btn.css)
+       reads THIS so the whole control family re-times from one `:root` override, and
+       the surface beat now tracks the press-squish window (the press is `tap-squish`/
+       `useSpringPress`'s coupled transform leg on the spring's own clock — P3 fade-
+       coupled-to-transform). The bezier `--ease-standard` STAYS for the surface legs
+       (a colour cross-fade on a spring wobbles, §6 binding); only the DURATION shortens.
+       The CALM card register keeps `--duration-fast`/`--duration-normal` — a `<Card>` is
+       not an interactive control. */
+    --duration-control: 0.12s;
     --duration-fast: 0.2s;
     --duration-normal: 0.3s;
     --duration-slow: 0.45s;
@@ -141,12 +155,14 @@
        `linear()` stops; this is the single source of truth tying each
        (response, ζ) pair to its serialized curve.
 
-       iOS-canonical (response, dampingFraction) per AL-X4 §3:
+       iOS-canonical (response, dampingFraction) per AL-X4 §3 (BC.W-SPRING-EASE
+       eased `snappy`+`bouncy` to fill their clocks + minted the `press` register):
          smooth: (0.50s, ζ=0.86)  — gentle settle, sub-perceptual overshoot ~0.5%
-         snappy: (0.35s, ζ=0.65)  — quick crisp, overshoot ~+6.8%
-         bouncy: (0.50s, ζ=0.45)  — emphatic overshoot ~+20.5%
+         snappy: (0.42s, ζ=0.78)  — quick crisp, eased to fill its clock, overshoot ~+2.0%
+         bouncy: (0.50s, ζ=0.55)  — emphatic, overshoot ~+12.6% (the Apple 12-18% band)
          gentle: (0.70s, ζ=1.00)  — patient critically-damped
          dock:   (0.32s, ζ=0.70)  — dock expand/collapse morph, overshoot ~+4.6%
+         press:  (0.15s, ζ=0.86)  — the iOS interactive tap-press, sub-100ms answer, ~+0.5%
 
        Note on `smooth`: at ζ=0.86 the analytic solver produces a peak
        of 1.00498 (+0.5%) at the 24% slot — mathematically present but
@@ -218,10 +234,11 @@
        for interactive transforms; those use `--spring-smooth`).
        ═══════════════════════════════════════════════ */
     --spring-smooth: linear(0, 0.09804 2.041%, 0.29288 4.082%, 0.49447 6.122%, 0.66436 8.163%, 0.79208 10.204%, 0.88050 12.245%, 0.93754 14.286%, 0.97182 16.327%, 0.99083 18.367%, 1.00027 20.408%, 1.00413 22.449%, 1.00502 24.490%, 1.00453 26.531%, 1.00355 28.571%, 1.00254 30.612%, 1.00169 32.653%, 1.00105 34.694%, 1.00060 36.735%, 1.00031 38.776%, 1.00014 40.816%, 1.00005 42.857%, 1.00000 44.898%, 1.00000 46.939%, 1.00000 48.980%, 1.00000 51.020%, 1.00000 53.061%, 1.00000 55.102%, 1.00000 57.143%, 1.00000 59.184%, 1.00000 61.224%, 1.00000 63.265%, 1.00000 65.306%, 1.00000 67.347%, 1.00000 69.388%, 1.00000 71.429%, 1.00000 73.469%, 1.00000 75.510%, 1.00000 77.551%, 1.00000 79.592%, 1.00000 81.633%, 1.00000 83.673%, 1.00000 85.714%, 1.00000 87.755%, 1.00000 89.796%, 1.00000 91.837%, 1.00000 93.878%, 1.00000 95.918%, 1.00000 97.959%, 1);
-    --spring-snappy: linear(0, 0.10438 2.041%, 0.32622 4.082%, 0.56668 6.122%, 0.77153 8.163%, 0.91961 10.204%, 1.01073 12.245%, 1.05549 14.286%, 1.06804 16.327%, 1.06171 18.367%, 1.04686 20.408%, 1.03044 22.449%, 1.01629 24.490%, 1.00596 26.531%, 0.99954 28.571%, 0.99633 30.612%, 0.99537 32.653%, 0.99575 34.694%, 0.99674 36.735%, 0.99786 38.776%, 0.99884 40.816%, 0.99956 42.857%, 1.00001 44.898%, 1.00024 46.939%, 1.00000 48.980%, 1.00000 51.020%, 1.00000 53.061%, 1.00000 55.102%, 1.00000 57.143%, 1.00000 59.184%, 1.00000 61.224%, 1.00000 63.265%, 1.00000 65.306%, 1.00000 67.347%, 1.00000 69.388%, 1.00000 71.429%, 1.00000 73.469%, 1.00000 75.510%, 1.00000 77.551%, 1.00000 79.592%, 1.00000 81.633%, 1.00000 83.673%, 1.00000 85.714%, 1.00000 87.755%, 1.00000 89.796%, 1.00000 91.837%, 1.00000 93.878%, 1.00000 95.918%, 1.00000 97.959%, 1);
-    --spring-bouncy: linear(0, 0.11105 2.041%, 0.36430 4.082%, 0.65496 6.122%, 0.90929 8.163%, 1.08828 10.204%, 1.18289 12.245%, 1.20482 14.286%, 1.17641 16.327%, 1.12214 18.367%, 1.06276 20.408%, 1.01239 22.449%, 0.97809 24.490%, 0.96099 26.531%, 0.95826 28.571%, 0.96514 30.612%, 0.97666 32.653%, 0.98873 34.694%, 0.99867 36.735%, 1.00520 38.776%, 1.00825 40.816%, 1.00847 42.857%, 1.00686 44.898%, 1.00443 46.939%, 1.00199 48.980%, 1.00004 51.020%, 0.99880 53.061%, 0.99827 55.102%, 0.99829 57.143%, 0.99866 59.184%, 0.99916 61.224%, 0.99966 63.265%, 1.00004 65.306%, 1.00027 67.347%, 1.00000 69.388%, 1.00000 71.429%, 1.00000 73.469%, 1.00000 75.510%, 1.00000 77.551%, 1.00000 79.592%, 1.00000 81.633%, 1.00000 83.673%, 1.00000 85.714%, 1.00000 87.755%, 1.00000 89.796%, 1.00000 91.837%, 1.00000 93.878%, 1.00000 95.918%, 1.00000 97.959%, 1);
+    --spring-snappy: linear(0, 0.10038 2.041%, 0.30488 4.082%, 0.51991 6.122%, 0.70158 8.163%, 0.83608 10.204%, 0.92554 12.245%, 0.97893 14.286%, 1.00665 16.327%, 1.01792 18.367%, 1.01981 20.408%, 1.01715 22.449%, 1.01292 24.490%, 1.00873 26.531%, 1.00530 28.571%, 1.00282 30.612%, 1.00120 32.653%, 1.00027 34.694%, 0.99980 36.735%, 0.99962 38.776%, 0.99961 40.816%, 0.99967 42.857%, 0.99976 44.898%, 0.99984 46.939%, 0.99991 48.980%, 0.99995 51.020%, 1.00000 53.061%, 1.00000 55.102%, 1.00000 57.143%, 1.00000 59.184%, 1.00000 61.224%, 1.00000 63.265%, 1.00000 65.306%, 1.00000 67.347%, 1.00000 69.388%, 1.00000 71.429%, 1.00000 73.469%, 1.00000 75.510%, 1.00000 77.551%, 1.00000 79.592%, 1.00000 81.633%, 1.00000 83.673%, 1.00000 85.714%, 1.00000 87.755%, 1.00000 89.796%, 1.00000 91.837%, 1.00000 93.878%, 1.00000 95.918%, 1.00000 97.959%, 1);
+    --spring-bouncy: linear(0, 0.10764 2.041%, 0.34440 4.082%, 0.60803 6.122%, 0.83510 8.163%, 0.99669 10.204%, 1.08926 12.245%, 1.12435 14.286%, 1.11986 16.327%, 1.09372 18.367%, 1.06042 20.408%, 1.02959 22.449%, 1.00623 24.490%, 0.99172 26.531%, 0.98510 28.571%, 0.98426 30.612%, 0.98688 32.653%, 0.99095 34.694%, 0.99505 36.735%, 0.99835 38.776%, 1.00055 40.816%, 1.00170 42.857%, 1.00202 44.898%, 1.00180 46.939%, 1.00132 48.980%, 1.00079 51.020%, 1.00033 53.061%, 1.00001 55.102%, 0.99982 57.143%, 1.00000 59.184%, 1.00000 61.224%, 1.00000 63.265%, 1.00000 65.306%, 1.00000 67.347%, 1.00000 69.388%, 1.00000 71.429%, 1.00000 73.469%, 1.00000 75.510%, 1.00000 77.551%, 1.00000 79.592%, 1.00000 81.633%, 1.00000 83.673%, 1.00000 85.714%, 1.00000 87.755%, 1.00000 89.796%, 1.00000 91.837%, 1.00000 93.878%, 1.00000 95.918%, 1.00000 97.959%, 1);
     --spring-gentle: linear(0, 0.09415 2.041%, 0.27374 4.082%, 0.45506 6.122%, 0.60779 8.163%, 0.72570 10.204%, 0.81213 12.245%, 0.87336 14.286%, 0.91570 16.327%, 0.94445 18.367%, 0.96371 20.408%, 0.97645 22.449%, 0.98481 24.490%, 0.99025 26.531%, 0.99377 28.571%, 0.99604 30.612%, 0.99749 32.653%, 0.99841 34.694%, 0.99900 36.735%, 0.99937 38.776%, 0.99961 40.816%, 0.99975 42.857%, 0.99985 44.898%, 1.00000 46.939%, 1.00000 48.980%, 1.00000 51.020%, 1.00000 53.061%, 1.00000 55.102%, 1.00000 57.143%, 1.00000 59.184%, 1.00000 61.224%, 1.00000 63.265%, 1.00000 65.306%, 1.00000 67.347%, 1.00000 69.388%, 1.00000 71.429%, 1.00000 73.469%, 1.00000 75.510%, 1.00000 77.551%, 1.00000 79.592%, 1.00000 81.633%, 1.00000 83.673%, 1.00000 85.714%, 1.00000 87.755%, 1.00000 89.796%, 1.00000 91.837%, 1.00000 93.878%, 1.00000 95.918%, 1.00000 97.959%, 1);
     --spring-dock: linear(0, 0.10282 2.041%, 0.31773 4.082%, 0.54783 6.122%, 0.74309 8.163%, 0.88550 10.204%, 0.97598 12.245%, 1.02452 14.286%, 1.04368 16.327%, 1.04501 18.367%, 1.03739 20.408%, 1.02681 22.449%, 1.01672 24.490%, 1.00873 26.531%, 1.00323 28.571%, 0.99996 30.612%, 0.99837 32.653%, 0.99789 34.694%, 0.99805 36.735%, 0.99848 38.776%, 0.99897 40.816%, 0.99940 42.857%, 0.99972 44.898%, 0.99993 46.939%, 1.00004 48.980%, 1.00000 51.020%, 1.00000 53.061%, 1.00000 55.102%, 1.00000 57.143%, 1.00000 59.184%, 1.00000 61.224%, 1.00000 63.265%, 1.00000 65.306%, 1.00000 67.347%, 1.00000 69.388%, 1.00000 71.429%, 1.00000 73.469%, 1.00000 75.510%, 1.00000 77.551%, 1.00000 79.592%, 1.00000 81.633%, 1.00000 83.673%, 1.00000 85.714%, 1.00000 87.755%, 1.00000 89.796%, 1.00000 91.837%, 1.00000 93.878%, 1.00000 95.918%, 1.00000 97.959%, 1);
+    --spring-press: linear(0, 0.09804 2.041%, 0.29288 4.082%, 0.49447 6.122%, 0.66436 8.163%, 0.79208 10.204%, 0.88050 12.245%, 0.93754 14.286%, 0.97182 16.327%, 0.99083 18.367%, 1.00027 20.408%, 1.00413 22.449%, 1.00502 24.490%, 1.00453 26.531%, 1.00355 28.571%, 1.00254 30.612%, 1.00169 32.653%, 1.00105 34.694%, 1.00060 36.735%, 1.00031 38.776%, 1.00014 40.816%, 1.00005 42.857%, 1.00000 44.898%, 1.00000 46.939%, 1.00000 48.980%, 1.00000 51.020%, 1.00000 53.061%, 1.00000 55.102%, 1.00000 57.143%, 1.00000 59.184%, 1.00000 61.224%, 1.00000 63.265%, 1.00000 65.306%, 1.00000 67.347%, 1.00000 69.388%, 1.00000 71.429%, 1.00000 73.469%, 1.00000 75.510%, 1.00000 77.551%, 1.00000 79.592%, 1.00000 81.633%, 1.00000 83.673%, 1.00000 85.714%, 1.00000 87.755%, 1.00000 89.796%, 1.00000 91.837%, 1.00000 93.878%, 1.00000 95.918%, 1.00000 97.959%, 1);
 
     /* ── PER-SPRING DURATION CLOCK (BA.W-GLASS-CAL Unit 3) ──
        Generated from `scripts/regen-spring-tokens.mjs` — DO NOT hand-edit.
@@ -241,9 +258,20 @@
        matching `--spring-<name>-duration`. */
     --spring-smooth-duration: 0.36s;
     --spring-snappy-duration: 0.34s;
-    --spring-bouncy-duration: 0.69s;
+    --spring-bouncy-duration: 0.57s;
     --spring-gentle-duration: 0.44s;
     --spring-dock-duration: 0.28s;
+    --spring-press-duration: 0.11s;
+
+    /* ── DECK SLIDE-TRANSITION CURVE (BC.W-DECK) ──
+       The full-viewport keyboard-paged deck's slide transition rides the SAME
+       `--spring-smooth` register the deck's `DECK_SPRING` samples (the calm-settle
+       `.smooth` family; the (response, ζ) pair lives in deck/constants.ts) — an
+       ALIAS, NOT a new spring family (the donor's own fence + the W-GLASS-CAL spring
+       fence). `--spring-deck: var(--spring-smooth)` so a deck slide reads as a calm
+       settle, not a bounce; the JS half (`installDeckSpring`) consumes keyframes.js
+       `springTimingFunction(DECK_SPRING)` for the count-up easing. */
+    --spring-deck: var(--spring-smooth);
 
     /* Core cubic-bezier (exits, fallbacks, non-spring uses) */
     --motion-ease-standard: cubic-bezier(0.4, 0, 0.2, 1);
@@ -264,6 +292,16 @@
     --ease-decelerate: var(--ease-out);
     --ease-accelerate: var(--ease-in);
 
+    /* BC.W-MOTION-PRESETS — the brand "convergence-reveal" / partial-sum settle.
+       The Fourier partial sum converges ONTO its target with a decaying Gibbs
+       ripple — a monotone critically-damped approach, NO sustained overshoot past
+       terminal. That curve IS `gentle` (ζ=1.0, overshoot 0), so this is the ALIAS
+       reuse: `--ease-convergence` resolves to `--spring-gentle` (no new
+       SPRING_PRESETS row, no second curve). The settle clock is the per-spring
+       `--spring-gentle-duration`. The N-term build-up is the `useStagger`
+       orchestration ON this curve (a documented recipe, not a new primitive). */
+    --ease-convergence: var(--spring-gentle);
+
     /* ═══════════════════════════════════════════════
        §2.A AMBIENT MOTION — Pulse aura tokens