@mkbabb/glass-ui 4.1.0 → 5.0.0

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

@@ -0,0 +1,292 @@
+/* tokens/scheme-spring.css
+   §2 EASING — Spring curves via linear() · per-spring duration clocks ·
+   goo-morph dwell-flow curves · cubic-bezier cores + aliases.
+
+   Carved from scheme-motion.css's §2 EASING block to hold the no-god-module
+   500-line bound (BD.W-CUT re-grew scheme-motion past it). @import-ed by
+   tokens.css IMMEDIATELY AFTER scheme-motion.css — adjacent same-selector
+   :root{} at the SAME cascade slot, so the spring/easing tokens resolve in the
+   same order their consumers (color-radius and the later partials) expect.
+   Custom properties resolve order-independently within :root, so the split is
+   byte-isomorphic at the cascade. */
+:root {
+    /* ═══════════════════════════════════════════════
+       §2  EASING — Spring curves via linear()
+
+       Generated from `scripts/regen-spring-tokens.mjs` — DO NOT hand-edit.
+       To tune a spring: edit the PRESETS table in the script and re-run
+       `node scripts/regen-spring-tokens.mjs`. The script invokes
+       `springLinearStops()` from `@mkbabb/keyframes.js` which solves the
+       analytic second-order damped harmonic oscillator and emits CSS
+       `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 (the LIVE values are the
+       BD.W-ANIM-IOS27-TUNE global re-calibration toward the weighty-gooey-inertial pole
+       — every overshoot ∈ [0%,10%], gentle ζ EXACTLY 1.0; the SPRING_PRESETS table in
+       springPresets.ts is the single source, these numbers mirror it):
+         smooth: (0.58s, ζ=0.80)  — inertial settle, a whisper of life, overshoot ~+1.5%
+         snappy: (0.48s, ζ=0.74)  — quick-but-weighty position morph, overshoot ~+3.2%
+         bouncy: (0.60s, ζ=0.60)  — emphatic FLOWING one-shot, overshoot ~+9.5% (≤10% band)
+         gentle: (0.82s, ζ=1.00)  — patient critically-damped (NO overshoot by definition)
+         dock:   (0.68s, ζ=0.64)  — the WEIGHTY iOS-27 gooey morph (collapse/expand + V↔H + fission), slow inertial mass, un-pointed settle ~+7.3%
+         press:  (0.20s, ζ=0.80)  — the iOS interactive tap-press, sub-200ms answer, ~+1.5%
+
+       Note on `smooth`: at ζ=0.80 the analytic solver produces a small peak
+       (~+1.5%) — a whisper of life, never a dead stop. It stays a hair BELOW
+       true critical damping (`gentle`'s ζ=1.0 register) so `smooth` reads a
+       little more alive on entrances/fades than `gentle`'s patient settle.
+
+       ── 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.
+
+       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 —
+       `--spring-smooth` — so hover + press read as one motion language (the
+       hover lift is the restrained `--scale-hover-btn` = 1.05, not the 1.08
+       `--scale-hover`). Springs read alive on TRANSFORM and ENTER (overshoot =
+       physicality); a spring on a COLOR or an EXIT reads as a wobble/hesitation.
+       `--ease-apple` is the ambient-only register (consumed solely by the Pulse
+       aura `--animate-ambient-pulse-easing` — NOT a second smooth-ease authority
+       for interactive transforms; those use `--spring-smooth`).
+       ═══════════════════════════════════════════════ */
+    --spring-smooth: linear(0, 0.00287 2.041%, 0.01102 4.082%, 0.02379 6.122%, 0.04057 8.163%, 0.06079 10.204%, 0.08395 12.245%, 0.10956 14.286%, 0.13721 16.327%, 0.16649 18.367%, 0.19705 20.408%, 0.22858 22.449%, 0.26077 24.490%, 0.29338 26.531%, 0.32617 28.571%, 0.35893 30.612%, 0.39149 32.653%, 0.42368 34.694%, 0.45536 36.735%, 0.48642 38.776%, 0.51676 40.816%, 0.54628 42.857%, 0.57492 44.898%, 0.60262 46.939%, 0.62933 48.980%, 0.65501 51.020%, 0.67965 53.061%, 0.70322 55.102%, 0.72571 57.143%, 0.74713 59.184%, 0.76748 61.224%, 0.78677 63.265%, 0.80501 65.306%, 0.82223 67.347%, 0.83844 69.388%, 0.85367 71.429%, 0.86796 73.469%, 0.88132 75.510%, 0.89379 77.551%, 0.90541 79.592%, 0.91621 81.633%, 0.92623 83.673%, 0.93549 85.714%, 0.94404 87.755%, 0.95190 89.796%, 0.95912 91.837%, 0.96574 93.878%, 0.97177 95.918%, 0.97726 97.959%, 1);
+    --spring-snappy: linear(0, 0.00652 2.041%, 0.02458 4.082%, 0.05211 6.122%, 0.08725 8.163%, 0.12834 10.204%, 0.17392 12.245%, 0.22268 14.286%, 0.27350 16.327%, 0.32540 18.367%, 0.37757 20.408%, 0.42929 22.449%, 0.47998 24.490%, 0.52916 26.531%, 0.57646 28.571%, 0.62156 30.612%, 0.66426 32.653%, 0.70440 34.694%, 0.74187 36.735%, 0.77662 38.776%, 0.80866 40.816%, 0.83800 42.857%, 0.86471 44.898%, 0.88887 46.939%, 0.91058 48.980%, 0.92996 51.020%, 0.94713 53.061%, 0.96223 55.102%, 0.97539 57.143%, 0.98677 59.184%, 0.99649 61.224%, 1.00471 63.265%, 1.01156 65.306%, 1.01716 67.347%, 1.02166 69.388%, 1.02516 71.429%, 1.02778 73.469%, 1.02964 75.510%, 1.03082 77.551%, 1.03142 79.592%, 1.03153 81.633%, 1.03122 83.673%, 1.03057 85.714%, 1.02963 87.755%, 1.02847 89.796%, 1.02713 91.837%, 1.02566 93.878%, 1.02410 95.918%, 1.02249 97.959%, 1);
+    --spring-bouncy: linear(0, 0.00706 2.041%, 0.02686 4.082%, 0.05738 6.122%, 0.09674 8.163%, 0.14321 10.204%, 0.19517 12.245%, 0.25116 14.286%, 0.30987 16.327%, 0.37010 18.367%, 0.43083 20.408%, 0.49115 22.449%, 0.55028 24.490%, 0.60757 26.531%, 0.66248 28.571%, 0.71458 30.612%, 0.76353 32.653%, 0.80908 34.694%, 0.85107 36.735%, 0.88940 38.776%, 0.92404 40.816%, 0.95502 42.857%, 0.98241 44.898%, 1.00631 46.939%, 1.02688 48.980%, 1.04428 51.020%, 1.05870 53.061%, 1.07035 55.102%, 1.07945 57.143%, 1.08621 59.184%, 1.09087 61.224%, 1.09364 63.265%, 1.09474 65.306%, 1.09439 67.347%, 1.09278 69.388%, 1.09011 71.429%, 1.08656 73.469%, 1.08230 75.510%, 1.07749 77.551%, 1.07226 79.592%, 1.06675 81.633%, 1.06106 83.673%, 1.05531 85.714%, 1.04958 87.755%, 1.04394 89.796%, 1.03846 91.837%, 1.03320 93.878%, 1.02820 95.918%, 1.02348 97.959%, 1);
+    --spring-gentle: linear(0, 0.00653 2.041%, 0.02415 4.082%, 0.05029 6.122%, 0.08283 8.163%, 0.12000 10.204%, 0.16036 12.245%, 0.20272 14.286%, 0.24614 16.327%, 0.28983 18.367%, 0.33320 20.408%, 0.37576 22.449%, 0.41716 24.490%, 0.45712 26.531%, 0.49544 28.571%, 0.53199 30.612%, 0.56669 32.653%, 0.59948 34.694%, 0.63037 36.735%, 0.65936 38.776%, 0.68650 40.816%, 0.71183 42.857%, 0.73542 44.898%, 0.75735 46.939%, 0.77768 48.980%, 0.79650 51.020%, 0.81390 53.061%, 0.82995 55.102%, 0.84474 57.143%, 0.85835 59.184%, 0.87086 61.224%, 0.88235 63.265%, 0.89288 65.306%, 0.90253 67.347%, 0.91136 69.388%, 0.91944 71.429%, 0.92682 73.469%, 0.93356 75.510%, 0.93970 77.551%, 0.94531 79.592%, 0.95041 81.633%, 0.95506 83.673%, 0.95929 85.714%, 0.96313 87.755%, 0.96663 89.796%, 0.96980 91.837%, 0.97268 93.878%, 0.97530 95.918%, 0.97767 97.959%, 1);
+    --spring-dock: linear(0, 0.00315 2.041%, 0.01207 4.082%, 0.02597 6.122%, 0.04414 8.163%, 0.06595 10.204%, 0.09081 12.245%, 0.11817 14.286%, 0.14757 16.327%, 0.17856 18.367%, 0.21076 20.408%, 0.24381 22.449%, 0.27740 24.490%, 0.31127 26.531%, 0.34517 28.571%, 0.37888 30.612%, 0.41222 32.653%, 0.44503 34.694%, 0.47717 36.735%, 0.50853 38.776%, 0.53901 40.816%, 0.56854 42.857%, 0.59705 44.898%, 0.62449 46.939%, 0.65083 48.980%, 0.67603 51.020%, 0.70010 53.061%, 0.72301 55.102%, 0.74478 57.143%, 0.76540 59.184%, 0.78490 61.224%, 0.80330 63.265%, 0.82062 65.306%, 0.83688 67.347%, 0.85213 69.388%, 0.86638 71.429%, 0.87969 73.469%, 0.89207 75.510%, 0.90358 77.551%, 0.91425 79.592%, 0.92411 81.633%, 0.93322 83.673%, 0.94160 85.714%, 0.94930 87.755%, 0.95635 89.796%, 0.96279 91.837%, 0.96865 93.878%, 0.97398 95.918%, 0.97881 97.959%, 1);
+    --spring-press: linear(0, 0.00284 2.041%, 0.01090 4.082%, 0.02354 6.122%, 0.04014 8.163%, 0.06017 10.204%, 0.08311 12.245%, 0.10850 14.286%, 0.13590 16.327%, 0.16495 18.367%, 0.19528 20.408%, 0.22657 22.449%, 0.25855 24.490%, 0.29095 26.531%, 0.32354 28.571%, 0.35613 30.612%, 0.38852 32.653%, 0.42057 34.694%, 0.45213 36.735%, 0.48309 38.776%, 0.51333 40.816%, 0.54279 42.857%, 0.57137 44.898%, 0.59903 46.939%, 0.62572 48.980%, 0.65141 51.020%, 0.67605 53.061%, 0.69965 55.102%, 0.72219 57.143%, 0.74366 59.184%, 0.76407 61.224%, 0.78343 63.265%, 0.80175 65.306%, 0.81906 67.347%, 0.83537 69.388%, 0.85070 71.429%, 0.86509 73.469%, 0.87857 75.510%, 0.89116 77.551%, 0.90290 79.592%, 0.91382 81.633%, 0.92395 83.673%, 0.93333 85.714%, 0.94200 87.755%, 0.94999 89.796%, 0.95733 91.837%, 0.96406 93.878%, 0.97020 95.918%, 0.97581 97.959%, 1);
+    --spring-transient: linear(0, 0.00427 2.041%, 0.01615 4.082%, 0.03434 6.122%, 0.05769 8.163%, 0.08520 10.204%, 0.11598 12.245%, 0.14927 14.286%, 0.18439 16.327%, 0.22076 18.367%, 0.25789 20.408%, 0.29534 22.449%, 0.33275 24.490%, 0.36982 26.531%, 0.40630 28.571%, 0.44196 30.612%, 0.47666 32.653%, 0.51024 34.694%, 0.54261 36.735%, 0.57369 38.776%, 0.60342 40.816%, 0.63176 42.857%, 0.65871 44.898%, 0.68425 46.939%, 0.70840 48.980%, 0.73117 51.020%, 0.75259 53.061%, 0.77270 55.102%, 0.79153 57.143%, 0.80913 59.184%, 0.82554 61.224%, 0.84083 63.265%, 0.85503 65.306%, 0.86820 67.347%, 0.88039 69.388%, 0.89166 71.429%, 0.90206 73.469%, 0.91163 75.510%, 0.92043 77.551%, 0.92851 79.592%, 0.93591 81.633%, 0.94268 83.673%, 0.94886 85.714%, 0.95449 87.755%, 0.95961 89.796%, 0.96427 91.837%, 0.96849 93.878%, 0.97230 95.918%, 0.97575 97.959%, 1);
+    --spring-eyeglass: linear(0, 0.00696 2.041%, 0.02640 4.082%, 0.05625 6.122%, 0.09463 8.163%, 0.13978 10.204%, 0.19012 12.245%, 0.24422 14.286%, 0.30080 16.327%, 0.35875 18.367%, 0.41708 20.408%, 0.47495 22.449%, 0.53163 24.490%, 0.58652 26.531%, 0.63915 28.571%, 0.68911 30.612%, 0.73612 32.653%, 0.77996 34.694%, 0.82048 36.735%, 0.85763 38.776%, 0.89137 40.816%, 0.92174 42.857%, 0.94882 44.898%, 0.97270 46.939%, 0.99352 48.980%, 1.01144 51.020%, 1.02663 53.061%, 1.03928 55.102%, 1.04957 57.143%, 1.05772 59.184%, 1.06392 61.224%, 1.06835 63.265%, 1.07123 65.306%, 1.07272 67.347%, 1.07301 69.388%, 1.07227 71.429%, 1.07066 73.469%, 1.06832 75.510%, 1.06538 77.551%, 1.06198 79.592%, 1.05823 81.633%, 1.05423 83.673%, 1.05007 85.714%, 1.04582 87.755%, 1.04156 89.796%, 1.03735 91.837%, 1.03324 93.878%, 1.02927 95.918%, 1.02547 97.959%, 1);
+
+    /* ── PER-SPRING DURATION CLOCK (BA.W-GLASS-CAL Unit 3 · BI.W-SPRING-PARITY ·
+       BI.W-TEMPO) ──
+       Generated from `scripts/regen-spring-tokens.mjs` — DO NOT hand-edit.
+
+       THE `-settle`/READER SPLIT (BI.W-TEMPO, M11). The raw analytic 2%-settle is
+       emitted under the INTERNAL token `--spring-<name>-settle`; the PUBLIC name
+       `--spring-<name>-duration` is a generated READER that co-scales it by the ONE
+       global `--motion-tempo` axis (property-regs.css, initial 1.0 identity):
+       `--spring-<name>-duration: calc(var(--spring-<name>-settle) *
+       var(--motion-tempo))`. So EVERY consumer (the ~30 `--spring-<name>-duration`
+       reads + the `--tab-indicator-duration` / `--dock-motion-resize` aliases)
+       inherits tempo with ZERO edits (the G4 round-trip — the public name is the
+       reader, NOT a clean-break rename). At `--motion-tempo: 1` the reader resolves
+       `settle * 1`, byte-identical to the prior flat `-duration` value (no-op-at-
+       rest). The JS spring engines read the SAME `--motion-tempo` (motionTempo.ts)
+       and scale `response *= tempo`, so CSS_t90 == JS_t90 at ANY tempo (P7, G2).
+
+       Each `--spring-<name>-settle` is the spring's OWN 2%-band settle time —
+       the TRUE NUMERIC settle (tick the `SpringProgress` step response until
+       |1−x| last exits ±2%), derived from the SAME (response, ζ) PRESETS table
+       the `--spring-*` `linear()` curves above derive from — never a hand value.
+       (It supersedes the analytic underdamped-envelope approximation
+       `-ln(0.02)/(ζ·ωₙ)`, which UNDER-estimates near-critical/critical ζ: the
+       polynomial `(1+ωₙt)e^(−ωₙt)` tail the pure exponential misses — gentle
+       ζ=1.0 analytic 0.51s vs numeric 0.76s.)
+
+       WHY the numeric settle is load-bearing (FAM-18/M1 — the tempo-parity fix):
+       the SAME settle seconds is ALSO the `maxDuration` fed to `springLinearStops`
+       for the `--spring-*` curves above, so the emitted curve and this clock share
+       ONE horizon — a CSS `transition` replaying the curve over this clock lands
+       CSS_t90 == the physical JS SpringProgress t90 (≤0.1ms, all six). Before the
+       fix the curve was sampled over `springLinearStops`'s default `4×response`
+       (~1.9s for snappy) while this clock was the ~0.4s settle — a ~4.8× mismatch
+       that front-loaded the whole trajectory into the first ~10–16% of the clock
+       (a ~50ms pop + a dead-flat tail). These clocks re-time UNDER each register to
+       its own settle WITHOUT touching the §6 register canon (which spring fits which
+       job): a `transition` pairs `--spring-<name>` with `--spring-<name>-duration`.
+       Locked by `proof:spring-tokens-synced`'s tempo-parity clause. */
+    --spring-smooth-settle: 0.35s;
+    --spring-snappy-settle: 0.44s;
+    --spring-bouncy-settle: 0.57s;
+    --spring-gentle-settle: 0.76s;
+    --spring-dock-settle: 0.19s;
+    --spring-press-settle: 0.12s;
+    --spring-transient-settle: 0.46s;
+    --spring-eyeglass-settle: 0.34s;
+    --spring-smooth-duration: calc(var(--spring-smooth-settle) * var(--motion-tempo));
+    --spring-snappy-duration: calc(var(--spring-snappy-settle) * var(--motion-tempo));
+    --spring-bouncy-duration: calc(var(--spring-bouncy-settle) * var(--motion-tempo));
+    --spring-gentle-duration: calc(var(--spring-gentle-settle) * var(--motion-tempo));
+    --spring-dock-duration: calc(var(--spring-dock-settle) * var(--motion-tempo));
+    --spring-press-duration: calc(var(--spring-press-settle) * var(--motion-tempo));
+    --spring-transient-duration: calc(var(--spring-transient-settle) * var(--motion-tempo));
+    --spring-eyeglass-duration: calc(var(--spring-eyeglass-settle) * var(--motion-tempo));
+
+    /* ── INTERACTIVE-SPATIAL TRANSITION DEFAULT (BG.W-LIQUID-WEIGHT-DEFAULT / F5.2) ──
+       Generated from `scripts/regen-spring-tokens.mjs` — DO NOT hand-edit.
+
+       The base interactive-atom recipes (`.interactive-item` / `.tap-squish` in
+       utilities/base.css + the `btn-interactive` @utility) read this on their
+       SPATIAL (scale/translate/rotate) leg, so EVERY interactive surface inherits
+       spring WEIGHT by default — weight is a property of the transition VOCABULARY,
+       not a per-site `--motion-weight` checklist (the inversion: the prior default
+       was a bare `--ease-standard` bezier with ZERO weight).
+
+       Spring-DERIVED — an alias to the canon interactive scale register (`smooth`,
+       the ONE button/interactive scale spring the §6 motion canon records). It is
+       GENERATED here so the "which spring is the interactive-spatial default" mapping
+       lives in the ONE motion-token source (drift-proof, the same exemplar pattern the
+       `--spring-*` curves ride — a hand-edit drifts, re-run the generator to restore).
+
+       The EFFECTS legs (color/opacity/box-shadow) KEEP the bezier `--ease-standard`
+       (motion-canon P1 spatial/effects split — a colour cross-fade on a spring reads
+       as a wobble); this token is SPATIAL-only. `.motion-calm` (scheme-motion.css) is
+       the EXPLICIT opt-out (→ var(--ease-standard)); the PRM carve re-aliases it the
+       same way (no overshoot under reduce — the vestibular floor). */
+    --transition-liquid-spatial: var(--spring-smooth);
+
+    /* ── 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);
+
+    /* ── GOO-MORPH SLIDE-TRANSITION FLOW CURVE (BD.W-GOO-CAROUSEL-DECK) ──
+       The per-consumer dwell-flow curve the ONE `useGooMorph` engine reads off its
+       `tokenPrefix` (`--{prefix}-flow`/`-duration`/`-max-stretch`). This is NOT a new
+       spring preset — it is a geometry-law DWELL shape: a curve that rises to ~mid by ~46%
+       of the clock, DWELLS at the midpoint (the FAT metaball NECK held open across the gap),
+       then contracts. The dwell is what makes the morph read as weighty liquid rather than
+       a fast flicker (the W-GLASS-CAL spring fence: a normalized spring `linear()`
+       front-loads — reaches ~0.5 by ~6% REGARDLESS of ζ — so the neck would collapse in
+       ~150ms then sit dead; the dwell curve spreads `--goo-t`'s 0→1 across the REAL clock).
+
+       The DECK slide-plate is the ONE surviving `useGooMorph` consumer. The CAROUSEL
+       content barbell (`--carousel-goo-*`) RETIRED at BI.W-CAROUSEL-REBUILD (the
+       559px-escape category error — the content is crisp weighty embla now, no metaball),
+       and the PAGER dot-pip worm retired its flow/duration tokens at BI.W-PAGER-WORM/-RETIRES:
+       the two-edge `useLeadTrail` spring driver OWNS the settle (release-at-arrival is
+       emergent, no timer), so only `--pager-worm-max-stretch` (the squish cap) survives —
+       beside this family, not on the `useGooMorph` clock. */
+
+    /* --deck-goo-flow: the calm presentation register — the dwell shape with NO
+       terminal overshoot (a full-viewport slide must not bounce — the vestibular floor;
+       the curve clamps at 1.0, no >1 stops). */
+    --deck-goo-flow: linear(
+        0, 0.02206 4.167%, 0.07922 8.333%, 0.15799 12.5%, 0.24486 16.667%,
+        0.32632 20.833%, 0.38889 25%, 0.41905 29.167%, 0.43667 33.333%,
+        0.4575 37.5%, 0.47833 41.667%, 0.49917 45.833%, 0.52 50%, 0.54083 54.167%,
+        0.56167 58.333%, 0.58373 62.5%, 0.64 66.667%, 0.71 70.833%,
+        0.78 75%, 0.85 79.167%, 0.91 83.333%, 0.96 87.5%,
+        0.985 91.667%, 0.997 95.833%, 1
+    );
+    --deck-goo-duration: 1.1s; /* the full-viewport register — slow + dignified. */
+    --deck-goo-max-stretch: 1.1; /* the gentlest swell — a big slide necks barely. */
+
+    /* --pager-worm-max-stretch: the dot-worm velocity-swell cap (BI.W-PAGER-WORM R10),
+       read LITERALLY by the two-edge worm's `useLiquidFlex` squish (usePagerWorm.ts). The
+       1.45 taffy value RE-REGISTERED into the LOW 1.08–1.2 band (a lively settle, never a
+       rubber-band taffy-pull): the worm narrows ≈1/1.2≈0.83× cross-axis at peak swell. The
+       worm's flow/duration clock tokens RETIRED at BI.W-PAGER-RETIRES — the `useLeadTrail`
+       spring driver owns the physics (release-at-arrival emergent, no timer). */
+    --pager-worm-max-stretch: 1.2;
+
+    /* Core cubic-bezier (exits, fallbacks, non-spring uses) */
+    --motion-ease-standard: cubic-bezier(0.4, 0, 0.2, 1);
+    --motion-ease-out: cubic-bezier(0, 0, 0.2, 1);
+    --motion-ease-in: cubic-bezier(0.4, 0, 1, 1);
+    --motion-ease-out-expo: cubic-bezier(0.16, 1, 0.3, 1);
+
+    --ease-standard: var(--motion-ease-standard);
+    --ease-out: var(--motion-ease-out);
+    --ease-in: var(--motion-ease-in);
+    --ease-out-expo: var(--motion-ease-out-expo);
+
+    /* Apple-inspired — micro-interactions, switches, dock hover */
+    --motion-ease-apple: cubic-bezier(0.25, 0.1, 0.25, 1);
+
+    --ease-apple: var(--motion-ease-apple);
+    --ease-spring: var(--spring-snappy);
+    --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);
+}
+
+/* ═══════════════════════════════════════════════
+   BG.W-LIQUID-WEIGHT-DEFAULT (F5.2) — the PRM re-alias of the interactive-spatial DEFAULT.
+
+   Under `prefers-reduced-motion: reduce` the base interactive scale legs
+   (`.interactive-item` / `.tap-squish` / the `btn-interactive` @utility) lose their spring
+   overshoot for the flat no-overshoot `--ease-standard` bezier — the vestibular floor. The
+   springs keep their OWN `respectReducedMotion` endpoint-snap; this re-alias strips the
+   overshoot CURVE from the CSS scale legs library-wide (the same belt-and-suspenders shape
+   as `--ease-cartoon-punch`'s PRM re-alias + the `.motion-calm` opt-out).
+
+   WHY IT LIVES HERE (the cascade fix — the F5.2 paint-judge FAIL): the base default
+   `:root { --transition-liquid-spatial: var(--spring-smooth) }` (above) and this PRM
+   re-alias both target `:root`, so they carry EQUAL specificity — at a MATCH (reduce
+   active) the LATER source-order declaration wins. scheme-spring.css is @import-ed LAST of
+   the token partials (tokens.css, immediately after scheme-motion.css), so a PRM re-alias
+   parked in scheme-motion.css (imported FIRST) LOSES to THIS file's base default and the
+   overshoot survives under reduce. Homing the re-alias here, AFTER the base default, makes
+   it the LAST `:root` declaration of the token — so under reduce it wins and the overshoot
+   is stripped, exactly as required. Do NOT move it back to scheme-motion.css (it would lose
+   the cascade — the no-op the paint judge caught). */
+@media (prefers-reduced-motion: reduce) {
+    :root {
+        --transition-liquid-spatial: var(--ease-standard);
+    }
+}

package/src/styles/tokens/scroll-tokens.css

@@ -14,8 +14,10 @@
 :root {
     /* 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. */
-    --scroll-progress-scroller: root;
+       the fallback path read identically — no visual seam at the `@supports` boundary.
+       BG.W-SCROLL-PROGRESS-RAIL — `--scroll-progress-scroller` is RETIRED (clean break,
+       no alias): the recipe reads a FULL-value `--scroll-progress-timeline` (default
+       `scroll(nearest block)`), never a `<dashed-ident>` fragment inside `scroll()`. */
     --scroll-reveal-rise: 6px;
     --scroll-reveal-range-end: 60%;
 
@@ -25,29 +27,34 @@
        (the cascade COMPOSES them, it never re-tunes them). All distances are
        compositor (transform) channels; the clocks are the per-spring settle clocks
        (scheme-motion.css), threaded, never re-tuned. */
-    /* .scroll-build — the route-enter page-build (the chrome -> hero -> body
-       coordinated entrance). The rise is a touch deeper than the section cascade
-       (the page ASSEMBLES — a more pronounced settle), the step is the per-beat
-       coordinated stagger between the chrome, hero, and first-section beats. */
-    --scroll-build-rise: 1.5rem;
-    --scroll-build-step: 90ms;
+    /* BG.W-ROUTE-TRANSITION — the page-build `.scroll-build` recipe is RETIRED (the
+       route entrance is now the bare keyed `<component class="route-enter">` on-mount
+       `@keyframes` in transitions.css, NOT a per-child staggered scroll-build). The
+       `--scroll-build-rise`/`--scroll-build-step` tokens are deleted with it; the ONE
+       surviving reader (the StoryHero `<h1>` entrance rise) owns its own
+       `--story-hero-rise` distance with an inline fallback default
+       (`translateY(var(--story-hero-rise, 1.5rem))` in demo/stories/story-hero.css),
+       so the library mints no src token here (the demo register's own knob). */
     /* .scroll-cascade — the orchestrated section cascade (the per-child view()
        timeline, the spring-clocked coupled build). The rise lifts the bare
        --scroll-reveal-rise 6px to a perceptible SOTA build; the range-end is the
        reveal window (a touch tighter than the bare reveal so each section lands
        crisply rather than dragging a long fade tail). The column-stagger delay is
-       the opt-in .scroll-cascade--columns grid-variant knob. */
+       the opt-in .scroll-cascade--columns grid-variant knob (BG.W-SCROLL-SHRINK-UNIFY
+       D14 — a range PERCENTAGE, NOT a time: it is ADDED to the `%` range-end and
+       scaled by the per-child `--col` index, so a `60ms` time would make the calc
+       invalid `% + ms`). */
     --scroll-cascade-rise: 1.25rem;
     --scroll-cascade-range-end: 45%;
-    --scroll-cascade-column-stagger: 60ms;
+    --scroll-cascade-column-stagger: 6%;
     /* .scroll-pin — the fixed-stage-advances-time scroll-pinned register. The stage
-       height is the Nvh temporal space the sticky stage advances its phases across;
-       the phase windows are the scroll-progress fractions the stage's internal
-       phases key off (grid-reveal 0..45%, expand 45..90%, settle 90..100% — the
-       Codrops phased-sequence shape). */
+       height is the Nvh temporal space the sticky stage advances its phases across.
+       The phase windows the stage's internal phases key off (grid-reveal 0..reveal-end,
+       expand reveal-end..expand-end, settle expand-end..100% — the Codrops phased-
+       sequence shape) live in scroll-choreography.css as the `-frac` numerators
+       (`--scroll-pin-phase-reveal-end-frac` 0.382 / `--scroll-pin-phase-expand-end-frac`
+       0.9), the form the calc()s consume. */
     --scroll-pin-stage-height: 320vh;
-    --scroll-pin-phase-reveal-end: 45%;
-    --scroll-pin-phase-expand-end: 90%;
     --scroll-pin-lift: 2.5rem;
 
     /* TOP-LAYER (animations.css §TOP-LAYER). The `@starting-style` entry/exit
@@ -59,7 +66,14 @@
        `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. */
-    --top-layer-enter-scale: 0.96;
+    /* BI.W-REGISTER-TABLE — the native top-layer enter is FOLDED onto the `enter-overlay`
+       register (the FOURTH register RETIRED — one enter grammar). The scale/blur knobs
+       SOURCE the register (so the native `.glass-top-layer` enter matches the reka Dialog
+       enter); a consumer still retunes the top-layer enter here, but the value tracks the
+       overlay register unless overridden. --top-layer-enter-blur is MINTED here (was an
+       inline 4px fallback in animations.css) so both channels source the register. */
+    --top-layer-enter-scale: var(--enter-overlay-scale);
+    --top-layer-enter-blur: var(--enter-overlay-blur);
     --top-layer-backdrop-blur: 8px;
     --top-layer-backdrop-dim: 0.5;
 
@@ -82,19 +96,19 @@
        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
+       (AU.W8.3) consume this same 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. */
+       BD.W-DOCK-CORE — the WEIGHTY iOS-27 re-tune. `--spring-dock` is now the
+       slow inertial gooey-morph register: (0.56s, ζ=0.58), an audacious overshoot
+       ~+11% then a deliberate settle over the 0.6s analytic clock — the
+       liquid-weight law (collapse/expand + V↔H + fission all share it). The prior
+       tight (0.32, 0.7) near-critical snap (~+4.6%) is retired. The runtime
+       driver's DOCK_SPRING const DERIVES from the `dock` PRESETS row via
+       `springPreset("dock")` (the no-second-authority fence — ONE table row, the
+       CSS token + the JS-driven morph + the const all flow from it). */
     --dock-resize-spring: var(--spring-dock);
 
     /* AT.W7-dock-b — dock-control press micro-feedback spring. A TRANSFORM-ONLY

package/src/styles/tokens/shadow.css

@@ -6,12 +6,17 @@
     /* ═══════════════════════════════════════════════
        §7  SHADOWS — cartoon offset is the signature
        ═══════════════════════════════════════════════ */
-    --shadow-cartoon:       3px 3px 0px 0px color-mix(in srgb, var(--foreground) 8%, transparent);
-    --shadow-cartoon-hover: 4px 4px 0px 0px color-mix(in srgb, var(--foreground) 10%, transparent);
+    /* BD.W-CARTOON-CEL-INK — the `--shadow-cartoon`/`-hover` aliases + the
+       `--shadow-modal` cartoon plane re-point onto the warm `--cartoon-ink-lead`
+       (0-blur down-LEFT, the cel family coherence — no neutral `--foreground` gray
+       smudge). `--cartoon-ink-lead` is defined below in this same :root block (custom
+       properties resolve order-independently). */
+    --shadow-cartoon:       -3px 3px 0px 0px var(--cartoon-ink-lead);
+    --shadow-cartoon-hover: -4px 4px 0px 0px var(--cartoon-ink-lead);
     --shadow-soft:          0 4px 12px rgba(0, 0, 0, 0.1);
     --shadow-elevated:      0 8px 24px rgba(0, 0, 0, 0.12);
     --shadow-modal:
-        4px 4px 0px 0px color-mix(in srgb, var(--foreground) 8%, transparent),
+        -4px 4px 0px 0px var(--cartoon-ink-lead),
         0 24px 64px color-mix(in srgb, var(--foreground) 12%, transparent);
 
     --cartoon-shadow:       var(--shadow-cartoon);
@@ -88,16 +93,53 @@
     --shadow-cartoon-color:             rgb(0 0 0 / 0.12);
     --shadow-cartoon-color-soft:        rgb(0 0 0 / 0.06);
 
-    /* Tiered cartoon shadows */
-    --shadow-cartoon-sm: -3px 2px 1px color-mix(in srgb, var(--shadow-color) 10%, transparent),
-        0 3px 1px color-mix(in srgb, var(--shadow-color) 10%, transparent),
-        -3px 3px 1px color-mix(in srgb, var(--shadow-color) 6%, transparent);
-    --shadow-cartoon-md: -4px 3px 1px color-mix(in srgb, var(--shadow-color) 12%, transparent),
-        0 4px 1px color-mix(in srgb, var(--shadow-color) 12%, transparent),
-        -4px 4px 2px color-mix(in srgb, var(--shadow-color) 8%, transparent);
-    --shadow-cartoon-lg: -6px 4px 1px color-mix(in srgb, var(--shadow-color) 12%, transparent),
-        0 6px 1px color-mix(in srgb, var(--shadow-color) 12%, transparent),
-        -6px 6px 2px color-mix(in srgb, var(--shadow-color) 8%, transparent);
+    /* ── BG.W-CARTOON-INK-GAMUT — the cartoon register's OWN warm-brown cel ink ──────
+       Decoupled from `--shadow-color` so a consumer retunes the cast without
+       disturbing every elevation box-shadow. Built by EXTRACTING the warm
+       `--foreground` hue (`oklch from`) at an IN-GAMUT warm-brown lightness+chroma:
+       `clamp(0.28, l, 0.34)` lifts the near-black `--foreground` L into the brown
+       midtone band, and `clamp(0.030, c, 0.050)` holds chroma in the range sRGB can
+       actually represent at that L. The maroon DEFECT this kills: the prior
+       `max(c, 0.11)` floor at `clamp(0.14, l, 0.18)` was OUT OF GAMUT at low L — sRGB
+       cannot hold C 0.11 at L 0.18, so the browser clamped each channel and the ink
+       collapsed to a flat maroon `rgb(49,0,0)` (B=0). Chroma-vs-darkness here is a
+       DESIGN choice, NOT a gamut law (the false "gamut-necessity"/"TECHNICOLOR-floor"
+       comment is retired). The pin resolves a warm brown (R>G>B>0) at OKLab hue ~57°
+       (light) / ~77° (dark) — both inside the [45,85]° warm register, never the maroon.
+       A cel cast is INK — the dark arm keeps ONLY its mode-correct alpha rungs + its
+       own re-derived fallback; the `:root` pin itself cascades through the dark
+       `--foreground` (the DRY-collapse, dark-arm.css). The three planes step DOWN in
+       opacity (lead 32% / mid 26% / contact 18%) — `in oklab` NOT `in srgb` (srgb
+       muddies a warm dark ink toward gray as it dilutes; oklab holds the warm hue
+       stable across the alpha ramp — the landed gray-dilution defect). */
+    --cartoon-ink: oklch(from var(--foreground) clamp(0.28, l, 0.34) clamp(0.030, c, 0.050) h);
+    --cartoon-ink-lead:    color-mix(in oklab, var(--cartoon-ink) 32%, transparent);
+    --cartoon-ink-mid:     color-mix(in oklab, var(--cartoon-ink) 26%, transparent);
+    --cartoon-ink-contact: color-mix(in oklab, var(--cartoon-ink) 18%, transparent);
+    /* `@supports not (oklch from …)` floors the ink to a named warm sRGB literal
+       (a legacy engine gets a WARM — not gray, not maroon — stamp; NO dead inline
+       literal). Re-derived from the in-gamut pin's RESOLVED sRGB at the light
+       `--foreground` (the painted L floors below the old `#4a3320` nominal):
+       `oklch(0.28 0.030 56°)` → ~rgb(52,37,26). */
+    --cartoon-ink-fallback: #34251a;
+
+    /* BD.W-CARTOON-CEL-INK — the tiered cel-ink STAMP, re-pointed to the warm
+       `--cartoon-ink` rungs at HARD 0-BLUR (lead + mid + contact all 0px — the cel
+       edge; the landed 1–2px soft blur is the gray-smudge defect), keeping the LANDED
+       down-LEFT geometry (REFINE-not-flip — the direction is coherent with the
+       upper-right `--glass-key`; cast lands lower-LEFT). φ-cadenced offsets. */
+    --shadow-cartoon-sm:
+        -2px 2px 0 var(--cartoon-ink-lead),
+        -3px 3px 0 var(--cartoon-ink-mid),
+        -4px 4px 0 var(--cartoon-ink-contact);
+    --shadow-cartoon-md:
+        -3px 3px 0 var(--cartoon-ink-lead),
+        -5px 5px 0 var(--cartoon-ink-mid),
+        -7px 7px 0 var(--cartoon-ink-contact);
+    --shadow-cartoon-lg:
+        -4px 4px 0 var(--cartoon-ink-lead),
+        -7px 7px 0 var(--cartoon-ink-mid),
+       -11px 11px 0 var(--cartoon-ink-contact);
     --cartoon-shadow-sm: var(--shadow-cartoon-sm);
     --cartoon-shadow-md: var(--shadow-cartoon-md);
     --cartoon-shadow-lg: var(--shadow-cartoon-lg);
@@ -164,3 +206,27 @@
         color-mix(in srgb, var(--blob-shadow-color) 44%, transparent);
 
 }
+
+/* BD.W-CARTOON-CEL-INK — the relative-color-syntax fallback. On a legacy engine that
+   lacks `oklch(from …)`, `--cartoon-ink` would be invalid (the whole cast drops). Floor
+   it to the named warm sRGB literal `--cartoon-ink-fallback` (NOT a dead inline literal)
+   so the cel stamp degrades to a WARM — never gray, never empty — ink. The three
+   strength rungs re-derive off the floored ink for free (they `color-mix` it). */
+@supports not (color: oklch(from white l c h)) {
+    :root {
+        --cartoon-ink: var(--cartoon-ink-fallback);
+    }
+}
+
+/* BG.W-CARTOON-INK-GAMUT — prefers-contrast / reduced-transparency floor the inked edge
+   UP (the cel cast is a legibility ASSET, not decoration; PRT is NOT a no-op — the cast
+   is translucent ink). The two byte-identical arms fold into ONE comma-joined query (the
+   DRY dup pass). The deepen rides ALPHA (32→42%), NEVER chroma — the in-gamut warm-brown
+   hue is preserved across the bracket. */
+@media (prefers-contrast: more), (prefers-reduced-transparency: reduce) {
+    :root {
+        --cartoon-ink-lead:    color-mix(in oklab, var(--cartoon-ink) 42%, transparent);
+        --cartoon-ink-mid:     color-mix(in oklab, var(--cartoon-ink) 34%, transparent);
+        --cartoon-ink-contact: color-mix(in oklab, var(--cartoon-ink) 24%, transparent);
+    }
+}