@mkbabb/glass-ui 4.0.0 → 4.1.0

package/src/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
@@ -67,6 +71,40 @@
         0 0 8px color-mix(in srgb, var(--ring) 15%, transparent);
     --focus-ring: var(--focus-ring-shadow);
 
+    /* BB.W-INVALID-RING — the destructive twin of --focus-ring-shadow. The
+       aria-invalid ring is ONE register: every form control (Input/Textarea/
+       NumberField via `.input-pill`, SelectTrigger, ComboboxInput, TagsInput)
+       reads `box-shadow: var(--invalid-ring)` instead of re-spelling the recipe
+       inline. ONE geometry (the SAME `--focus-ring-width`), ONE tint knob
+       (`--invalid-ring-tint`, the documented retint axis), resolving
+       `var(--destructive)` so a dark `--destructive` re-anchor flows through. A
+       consumer retints every invalid ring library-wide from a single
+       `:root { --invalid-ring-tint: … }` override — the token-first axis
+       `--focus-ring-shadow` already grants the focus ring. */
+    --invalid-ring-tint: 35%;
+    --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
        ═══════════════════════════════════════════════ */
@@ -80,6 +118,65 @@
     --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");
 
+    /* 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: var(--grid-pitch);
+    --paper-grid-line: color-mix(
+        in srgb,
+        var(--foreground) calc(var(--paper-grid-opacity) * 100%),
+        transparent
+    );
+    --paper-grid-line-major: color-mix(
+        in srgb,
+        var(--foreground) calc(var(--paper-grid-opacity) * 160%),
+        transparent
+    );
+    --paper-grid-texture:
+        linear-gradient(to right, var(--paper-grid-line-major) 1px, transparent 1px),
+        linear-gradient(to bottom, var(--paper-grid-line-major) 1px, transparent 1px),
+        linear-gradient(to right, var(--paper-grid-line) 1px, transparent 1px),
+        linear-gradient(to bottom, var(--paper-grid-line) 1px, transparent 1px);
+
     /* ═══════════════════════════════════════════════
        §13 GOLD (accent family kept for consumers using it)
        ═══════════════════════════════════════════════ */
@@ -130,6 +227,38 @@
     --color-silver-dark: var(--silver-dark);
     --color-silver-deep: var(--silver-deep);
 
+    /* ═══════════════════════════════════════════════
+       §13c BRONZE (the THIRD brand-metal — BB.W-METAL-SHIMMER)
+       ═══════════════════════════════════════════════ */
+    /* The warm-brown patina quad — the third member of the gold·silver·bronze
+       brand-metal TRIAD (the medal triad, the gilt/aged "third place" figure, the
+       record-badge register). Gold (warm-yellow ~84°) + silver (cool-steel ~255°)
+       are the two poles; bronze is the warm-amber-brown ~54° register between them.
+       The cascade EXACTLY mirrors gold's and silver's (scale-paper raw → bridges
+       `--color-bronze*` alias → both dark arms); `-deep` is mode-invariant.
+
+       BA.W-NO-GRAY brand-metal EXCEPTION — bronze is the THIRD metal on the SAME
+       sanction silver carries (the ONE cool-neutral exception). Bronze is a WARM
+       metal identity with chroma ABOVE the warm floor: each rung resolves OKLab
+       C 0.072-0.112 (far above the STRONG_FLOOR 0.020) at hue ~49-60°, so it reads
+       as polished bronze MATERIAL, never a desaturated brown CAST (the W-NO-GRAY
+       "warm-not-tinted" bar). It is NOT a neutral — a low-chroma bronze would BE a
+       neutral and break the brand-metal read; the chroma is the metal. The hue sits
+       between gold and red-orange so it distinguishes from a dark gold at the rim. */
+    --bronze: oklch(0.620 0.092 54.0);
+    --bronze-light: oklch(0.760 0.112 60.0);
+    --bronze-dark: oklch(0.500 0.082 50.0);
+    /* The mode-INVARIANT deep bronze plate (mirrors `--gold-deep`/`--silver-deep`'s
+       contract — a fixed dark bronze so a white label clears ≥4.5:1 in BOTH modes;
+       it does NOT flip with `--foreground`). 8.36:1 white in light / 4.79:1 in dark
+       on the dark-arm-lifted rungs. The would-be saturated CTA twin of the metal. */
+    --bronze-deep: oklch(0.430 0.072 50.0);
+
+    --color-bronze: var(--bronze);
+    --color-bronze-light: var(--bronze-light);
+    --color-bronze-dark: var(--bronze-dark);
+    --color-bronze-deep: var(--bronze-deep);
+
     /* ═══════════════════════════════════════════════
        §14 RAINBOW PALETTE — oklch (AV.W16 TW2; mode-independent, no .dark
        mirror; hue preserved from the prior hsl() cadence)
@@ -267,6 +396,32 @@
     --metric-row-label-clamp-cqi: 5cqi;
     --metric-row-label-clamp-max: 2.75rem;
 
+    /* BB.W-CONTROL-TOKENS — the two CONSUMER-reach knobs (the no-`:deep`
+       precept, Design Axis 2). MetricRow internals a consumer must reach are
+       exposed as tokens, never an internal a `:deep()` overrides.
+
+       • `--metric-row-label-align` — the label `text-align`. Default `left`
+         (byte-identical to the prior render). A cert-grid consumer building a
+         labelled ledger sets `right` at `:root`/a parent/per-row for a
+         right-aligned fixed seam — cascades into `.metric-row__label` with no
+         `:deep()`.
+       • `--metric-row-icon-color` — the leading-glyph ink (the MetricCell
+         `iconColor`→IconChip precedent, mirrored as a token since MetricRow
+         ships a raw `<component :is>`). The per-row `phaseColor` prop seeds it
+         inline so today's consumers paint unchanged; un-set, the component
+         fallback (`inherit`) keeps the icon on the inherited cascade. A consumer
+         wanting a DISTINCT icon ink from the phase tint overrides it directly.
+
+       Both carry their byte-identical defaults — `left` (the prior render) /
+       `inherit` (the prior un-tinted glyph). Declaring them here keeps the
+       `--metric-row-*` family discoverable in one home; the component-level
+       `var(…, fallback)` read preserves the same default if the token is ever
+       un-declared (the defense-in-depth back-compat floor). A per-row
+       `phaseColor` prop still wins over the `:root` `--metric-row-icon-color`
+       (inline cascades higher), so today's phase-tinted icons are unchanged. */
+    --metric-row-label-align: left;
+    --metric-row-icon-color: inherit;
+
     /* ═══════════════════════════════════════════════
        §2.D INSTRUMENT-CLUSTER COMPOSITION RHYTHM
 
@@ -317,93 +472,10 @@
     --table-head-h: calc(3rem * var(--table-density));
     --table-head-px: calc(1rem * var(--table-density));
 
-    /* ═══════════════════════════════════════════════
-       §20 PLATFORM MOTION (AQ.W5)
-
-       The native-platform motion substrate axes. Three families, each read
-       by a `@supports`-gated CSS recipe in `scroll-driven.css`,
-       `animations.css` (§TOP-LAYER), and `view-transition.css` — every visual
-       knob a token so a consumer retunes without editing library source.
-
-       SCROLL-DRIVEN (scroll-driven.css). Values mirror the JS-fallback
-       composable defaults (`useScrollProgress` / `useStaggerReveal`) so the
-       native CSS path and the fallback path read identically — no visual seam
-       at the `@supports` boundary.
-
-       TOP-LAYER (animations.css §TOP-LAYER). The `@starting-style` entry/exit
-       grammar for native `<dialog>` / `[popover]` glass surfaces. The backdrop dim
-       uses the house alpha-derivative `color-mix(in srgb, var(--background) Npct,
-       transparent)` (AZ.W-ADAPTIVE-AUTO A5-1). It is NOT the `hsl(var(--background)
-       / α)` channel form: `--background` is a COMPLETE `hsl()` color
-       (`= hsl(48 12% 98%)`), so `hsl(var(--background) / α)` double-wraps to
-       `hsl(hsl(…) / α)` — invalid, never paints (the modal dim was silently dead).
-       The genuine channel form would require `--background` declared as a bare
-       `H S% L%` triple, which it never is — hence the alpha-derivative mix.
-
-       VIEW-TRANSITION (view-transition.css). The shared `.gl-list-item` group
-       recipe + the `--vt-*` axes the `useViewTransition` substrate consumers
-       (dock layer swap, muster J's verdict re-rank) tune their swap against.
-       ═══════════════════════════════════════════════ */
-    --scroll-progress-scroller: root;
-    --scroll-reveal-rise: 6px;
-    --scroll-reveal-range-end: 60%;
-
-    --top-layer-enter-scale: 0.96;
-    --top-layer-backdrop-blur: 8px;
-    --top-layer-backdrop-dim: 0.5;
-
-    --vt-duration: var(--duration-normal);
-    /* AX.W05 — ONE iOS-spring vocabulary: every spring-flavored transition reads
-       a governed `--spring-*` register. The legacy apple-spring cubic-bezier
-       (+27.5% overshoot) was a SECOND authority beside the regen `--spring-*`
-       cohort; it is EXCISED. Its emphatic-overshoot register maps to the playful
-       `--spring-bouncy` (the closest `linear()` overshoot stop-set), so the VT
-       default + the cards/top-layer transitions share one spring primitive
-       (CPU + GPU sample the same curve). No cubic-bezier fallback seed survives —
-       the `linear()` spring degrades to `ease` where `linear()` is unsupported. */
-    --vt-ease: var(--spring-bouncy);
-    --vt-rise: 8px;
-
-    /* AT.W6-dock-c / AU.W8 — the dock layer-swap morph timing, minted ONCE so
-       both engine paths are timing-IDENTICAL: the FLIP fallback (via
-       `--dock-motion-resize`), the native View-Transition group (its
-       `animation-timing-function`), AND the runtime SpringProgress driver
-       (AU.W8.3) consume this same `(0.32, 0.7)` source curve. Retires the AQ.W6
-       fork where the VT path ran `--vt-ease` (apple-spring, +27.5% overshoot)
-       while the FLIP ran the snappy spring. `--vt-ease` still defaults the
-       other VT recipes (`.gl-list-item`).
-
-       AU.W8 — RETARGET snappy → dock. `--spring-snappy` (ζ=0.65, +6.8%) read as
-       mechanical: a stiff plateau at ~48% with too little overshoot to feel
-       alive ("not iOS-smooth"). AW.W2 then retuned the dock spring to the
-       iOS-control register: `--spring-dock` ((0.32, 0.7), ~+4.6%) settles snappy
-       with a restrained overshoot — the felt iOS dock morph, off the prior
-       playful +18.5% register. The runtime driver's DOCK_SPRING const MIRRORS the
-       (0.32, 0.7) PRESETS row, so the CSS token and the JS-driven morph are
-       bit-identical. */
-    --dock-resize-spring: var(--spring-dock);
-
-    /* AT.W7-dock-b — dock-control press micro-feedback spring. A TRANSFORM-ONLY
-       spring (`scale`/`rotate`) the dock controls apply to their hover/press
-       activation so the squish reads with a touch of spring-back rather than a
-       flat ease. STRICTLY transform-scoped: it must never touch the surface-tier
-       `[data-held]` fades (background/border/box-shadow), which stay on
-       `--duration-fast var(--ease-standard)`. The duration pairs with
-       `--duration-fast`; consumers retune the whole feel via this one token.
-
-       AY.W-DOCK2 (D6) — the register is `--spring-smooth`, the §6 easing-doctrine
-       transform-press register (tokens.css §2: transform hover/press/active →
-       `--spring-smooth`/`--spring-snappy`, NEVER `--spring-bouncy`; a press must
-       settle, never overshoot into a visible bounce). The prior `--spring-bouncy`
-       ROOT default was off-doctrine, shadowed for the four named controls by a
-       per-surface re-point in dock-controls.css — the exact per-surface fork the
-       doctrine kills. The re-point is now a DEAD byte-identical redeclaration and is
-       DELETED; the ROOT token IS the doctrine register, so any other consumer of
-       `--dock-press-spring` inherits the correct smooth register.
-
-       BA.W-GLASS-CAL Unit 3 — the duration leg re-times off the generic
-       `--duration-fast` (0.2s) onto `--spring-smooth-duration` (0.36s, the
-       smooth spring's OWN 2%-band envelope settle), so the press transform plays
-       at its physical settle rather than a generic clock. */
-    --dock-press-spring: var(--spring-smooth-duration) var(--spring-smooth);
+    /* §20 PLATFORM MOTION (AQ.W5) — the scroll-driven/choreography + TOP-LAYER +
+       VIEW-TRANSITION + dock-spring motion knobs — carved WHOLE to
+       tokens/scroll-tokens.css at BB.W-CARVE4 (a contiguous tail carve at the §19/§20
+       seam; §20 is the file's last section, so the partial @import-s IMMEDIATELY
+       AFTER this one — the dist is byte-isomorphic). The paper/control/display/metal/
+       timeline/metric/table families above stay. */
 }

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

@@ -51,9 +51,19 @@
     --type-leading-body: 1.5;
     --type-leading-prose: 1.618;
     --type-leading-heading: 1.2;
-    --type-leading-display: 1.1;
+    /* BB.W-DISPLAY-TRACKING — the display leading is tightened to the Apple
+       84/80 ≈ 1.05 signature (was 1.1). The DISPLAY ladder ONLY reads this rung;
+       --type-leading-heading (1.2) carries the heading/title register. */
+    --type-leading-display: 1.05;
 
     --type-tracking-tight: -0.025em;
+    /* BB.W-DISPLAY-TRACKING — the DISPLAY-ONLY proportional negative tracking
+       rung (the Apple −1.5%-of-size signature: 80px → −1.2px = −0.015em). It is
+       em-relative, so the single value is a constant −1.5% across the whole
+       clamp() ladder (φ² → φ^(11/2)). MINTED as its OWN rung so the display
+       calibration NEVER bleeds into the shared --type-tracking-tight (the
+       heading/title/configurator register's tracking, kept at -0.025em). */
+    --type-tracking-display: -0.015em;
     --type-tracking-snug: -0.01em;
     --type-tracking-normal: 0;
     --type-tracking-wide: 0.025em;
@@ -64,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;
@@ -72,17 +96,24 @@
     --duration-xxl: 1.5s;
     --duration-shimmer-fast: 3s;
     --duration-shimmer: 5s;
+    /* BB.W-METAL-SHIMMER — the brand-metal family's OWN slow dignified one-pass
+       clock (slower than the 5s generic shimmer). The metal sweep (gold·silver·
+       bronze, text-clip + border/mask) reads as a calm slow patina catch, not a
+       fast band-pass — the §6 calm register. (`--duration-seal` was never landed;
+       this is net-new, NOT a retirement re-point.) */
+    --duration-metal: 6s;
     /* BA.W-GLASS-CAL (H2a) — `--duration-sparkle` (600ms) DELETED with the disco
        recipe retirement: the sparkle-sweep keyframe + its sole `btn-audacious`
        consumer are gone. */
 
     /* AH.W5-e (FA-8 §4d) — motion-duration + staged-reveal canon.
 
-       Six duration tokens + three delay tokens promoted from raw literals
-       at speedtest's celebratory-reveal SFCs (SpeedtestResults, ThankYou,
-       ResultStack, CompleteBadge). Unified under the `--motion-*`
-       namespace (parallel to `--motion-ease-*`) so all motion tokens
-       cluster at one canon — duration + easing arm together. */
+       Duration + delay tokens promoted from raw literals at speedtest's
+       celebratory-reveal SFCs (SpeedtestResults, ThankYou, ResultStack).
+       Unified under the `--motion-*` namespace (parallel to `--motion-ease-*`)
+       so all motion tokens cluster at one canon — duration + easing arm
+       together. (BB.W-DEAD-SWEEP retired the never-shipped CompleteBadge
+       staged-reveal cluster — no consumer existed.) */
 
     /* Staged-entrance pairing — opacity + transform Vue <Transition> arms
        in the celebratory headline + result-row reveals. Partners with
@@ -99,17 +130,6 @@
        glyphs cleanly. Load-bearing — zeroing either collapses the shimmer to
        an imperceptible blow-through. */
 
-    /* CompleteBadge staged-reveal cluster — the disc / ring / check curve
-       fires at three asymmetric durations + delays per the A4-AF staged-
-       variety design intent. Promoting the magic numbers makes the
-       staged-variety visible at the canon. */
-    --motion-duration-badge-disc: 420ms;
-    --motion-duration-badge-ring: 560ms;
-    --motion-duration-badge-check: 380ms;
-    --motion-delay-badge-disc: 80ms;
-    --motion-delay-badge-ring: 220ms;
-    --motion-delay-badge-check: 460ms;
-
     /* Staggered-reveal increment canon — three perceptually-distinct tiers for
        per-row/per-cell/per-bar cascades:
          • tight (40ms) — dense row cascades, sub-perceptual gap
@@ -135,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
@@ -153,21 +175,53 @@
        ── EASING DOCTRINE (AX.W52 §6 — which easing fits which job) ──
        ONE recorded rule so the animation easing stops forking live. This
        FORMALIZES the already-correct `transitions.css` idiom (enter=spring,
-       exit=bezier) as the house rule every recipe reaches for:
-
-         | Transition kind                                  | Easing                              |
-         |--------------------------------------------------|-------------------------------------|
-         | Surface props (bg, border, color, box-shadow,    | `--ease-standard` (bezier — a       |
-         |   opacity)                                       |   colour cross-fade reads as a      |
-         |                                                  |   wobble on a spring)               |
-         | Transform — hover/press/active (scale, translate,| `--spring-smooth` (the ONE button/  |
-         |   rotate)                                         |   interactive scale register) or    |
-         |                                                  |   `--spring-snappy` (crisp press)   |
-         | Enter (mount, popover open, dialog in)           | `--spring-bouncy` / `--spring-snappy`|
-         | Exit (unmount, close)                            | `--ease-out` / `--ease-standard`    |
-         |                                                  |   (bezier, NO overshoot — an exit   |
-         |                                                  |   must never overshoot past gone)   |
-         | Position-tracked (specular pointer follow)       | `--ease-standard`                   |
+       exit=bezier) as the house rule every recipe reaches for.
+
+       BB.W-MOTION-CANON — the table embodies ONE principle (Material 3's
+       spatial-vs-effects split, codified in `docs/precepts/motion-canon.md`
+       as P1): a SPATIAL channel (the box MOVES/RESHAPES — position, SIZE,
+       rotation, corners) rides a `--spring-<name>` (overshoot = physicality);
+       an EFFECTS channel (the surface RE-TINTS — color, opacity, box-shadow)
+       rides a bezier `--ease-*` (a colour cross-fade reads as a wobble on a
+       spring). Each row below is tagged [SPATIAL] (spring) or [EFFECTS]
+       (bezier) so the rule is legible, not implicit. The canon doc is the
+       canonical home; this table is the SOURCE it re-states:
+
+         | Transition kind                                  | Tier      | Easing                   |
+         |--------------------------------------------------|-----------|--------------------------|
+         | Surface props (bg, border, color, box-shadow,    | [EFFECTS] | `--ease-standard` (bezier|
+         |   opacity)                                       |           |   — a colour cross-fade  |
+         |                                                  |           |   reads as a wobble on a |
+         |                                                  |           |   spring)                |
+         | Transform — hover/press/active (scale, translate,| [SPATIAL] | `--spring-smooth` (the   |
+         |   rotate)                                         |           |   ONE button/interactive |
+         |                                                  |           |   scale register) or     |
+         |                                                  |           |   `--spring-snappy`      |
+         | Size / morph (dock V↔H, indicator size-          | [SPATIAL] | `--spring-dock` /        |
+         |   correction, reveal source-rect bloom)          |           |   `--spring-snappy`,     |
+         |                                                  |           |   expressed as a         |
+         |                                                  |           |   COMPOSITOR transform   |
+         |                                                  |           |   (P5) — NEVER an        |
+         |                                                  |           |   animated width/height  |
+         | Enter (mount, popover open, dialog in, reveal)   | [SPATIAL] | `--spring-bouncy` /      |
+         |                                                  |           |   `--spring-snappy`      |
+         | Bold decelerating arrival (the SOTA arrival —    | [SPATIAL] | `--ease-out-expo`        |
+         |   reveal draw-on, big-distance settle)           |           |   (cubic-bezier(.16,1,   |
+         |                                                  |           |   .3,1); the house expo) |
+         | Exit (unmount, close)                            | [EFFECTS] | `--ease-out` /           |
+         |                                                  |           |   `--ease-standard`      |
+         |                                                  |           |   (bezier, NO overshoot —|
+         |                                                  |           |   an exit must never     |
+         |                                                  |           |   overshoot past gone)   |
+         | Position-tracked (specular pointer follow)       | [EFFECTS] | `--ease-standard`        |
+
+       The SOTA arrival ease is the EXISTING `--ease-out-expo` (alias →
+       `--motion-ease-out-expo` = `cubic-bezier(0.16, 1, 0.3, 1)`, the house
+       expo with the value.js `easeOutExpo` JS twin in the MOTION_CURVES table)
+       — NOT a net-new token. The motion canon NAMES it as the arrival register;
+       it is not re-minted (a duplicate alias would fail proof:animation-
+       coherence's EASING-TABLE-BOUND arm — the curve already has its canonical
+       + alias row in `curves.ts`).
 
        The BUTTON family (`.btn-pill` / `.tap-squish` / `.glass-btn` /
        `btn-interactive`) UNIFIES its `scale` transform leg onto ONE register —
@@ -180,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.
@@ -203,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);
@@ -226,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