@mkbabb/glass-ui 4.1.0 → 5.0.0

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

@@ -1,5 +1,10 @@
 /* tokens/scheme-motion.css
-   §-1 color-scheme · §0 font · §1 duration · §2 easing (spring linear()) · §2.A ambient-motion · §2.B/§2.C · §3 z-index.
+   §-1 color-scheme · §0 font · §1 duration · §2.W/§2.X motion-weight + cartoon-punch ·
+   §2.A ambient-motion · §2.B/§2.C · §3 z-index.
+   The §2 EASING block (spring linear() curves + per-spring duration clocks +
+   goo-flow curves + cubic-bezier cores/aliases) is carved into the adjacent
+   scheme-spring.css to hold the no-god-module 500-line bound; it @imports
+   IMMEDIATELY AFTER this file (same :root cascade slot).
    Carved from the tokens.css cascade root; @import-ed by tokens.css in
    cascade order. Same :root cascade context as its siblings. */
 :root {
@@ -144,163 +149,71 @@
     --motion-stagger-default: 80ms;
     --motion-stagger-relaxed: 120ms;
 
+    /* Per-GLYPH stagger increment (BG.W-SECTION-TYPEWRITER-FADEUP). The DENSER
+       cadence for a per-CHARACTER cascade (a word/heading typing itself in) —
+       tighter than the per-ROW `--motion-stagger-*` tiers because dozens of
+       glyphs ride it and a row-scale gap would drag the tail past the eye. The
+       single source the `.char-stagger` recipe (typography/utilities.css) AND
+       the demo's `.story-section__heading` per-glyph reveal (story-hero.css)
+       both read — DRY, retune the whole per-glyph rhythm from ONE `:root`
+       override. Was a hardcoded `30ms` literal at both sites. */
+    --char-stagger-step: 30ms;
+
     /* ═══════════════════════════════════════════════
-       §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 (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.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
-       sub-perceptual. I keep ζ=0.86 rather than promoting to ζ=1.0
-       because true critical damping is `gentle`'s register, and
-       `smooth` wants a slightly faster visual settle than `gentle`'s
-       patient curve. The 0.5% peak does not read as overshoot to the
-       eye but does narrowly distinguish `smooth` from `gentle`.
-
-       ── 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.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.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.
-       Each `--spring-<name>-duration` is the spring's OWN 2%-band envelope-settle
-       time `t_s = -ln(0.02) / (ζ·ωₙ)` (ωₙ = 2π/response), derived from the SAME
-       (response, ζ) PRESETS table the `--spring-*` `linear()` curves above
-       derive from — never a hand value.
-
-       WHY: the `--spring-<name>` curve is NORMALIZED to 0..1 and discards the
-       spring's settle time. Pairing it with a generic `--duration-*` clock
-       (0.2/0.3/0.45s) re-timed EVERY spring to the same wall clock — snappy
-       (response 0.35s) and smooth (0.5s) both ran 300ms, so the crisp snappy
-       register dragged a dead sub-pixel tail (the R10-2 read: within-1px at
-       ~109ms but the transition ran 300ms). 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 the
-       matching `--spring-<name>-duration`. */
-    --spring-smooth-duration: 0.36s;
-    --spring-snappy-duration: 0.34s;
-    --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);
-    --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);
+       §2.W BD.W-MOTION-WEIGHT — the GOVERNING motion scalar (rest decl)
+
+       The universal driver-motion governor (the @property reg lives in
+       property-regs.css §18 beside --ui-scale). 0 = still, 1 = full cel. Rest
+       1/φ ≈ 0.618: present, alive, never manic (§L4/§L6). DRIVER-scoped: a surface
+       the finger/route moved INHERITS this; an OBSERVER surface (auto-carousel
+       content, list reorder under scroll) pins it to 0 LOCALLY. It co-scales squash
+       depth, overshoot share, anticipation pull-back, and cartoon-shadow travel
+       together so they read as ONE proportioned deformation.
+
+       The SQUISH CAP is derived SITE-LOCALLY at the consuming element (the JS
+       getters in useDockOrientationMorph / useTabIndicator / useTabDragMorph /
+       useLiquidPress read `--motion-weight` off their OWN element and return
+       `1 + (cap_token − 1)·(weight + (1−weight)·flexVel)/0.618`), NEVER a `:root`
+       calc token — an unregistered `:root` cap calc over var(--motion-weight) is
+       substituted at :root (0.618) and inherits the FROZEN text, so a child's
+       scoped weight→0 would never re-evaluate it (the spike's load-bearing
+       correction). The cap reads the EXISTING `--*-max-stretch` token directly with
+       a (weight/0.618) factor — zero new `--*-stretch-k` coefficient cohort. */
+    --motion-weight: 0.618;
+
+    /* ═══════════════════════════════════════════════
+       §2.X BD.W-CARTOON-PUNCH — the third pole, a RAW shaped linear()
+
+       A single damped spring is monotone-from-one-side — it CANNOT dip below origin
+       then overshoot past it. iOS-27's loudest moments want ANTICIPATION (pull back
+       before launch) AND EXAGGERATION (punch past the spring fence). So it ships as
+       a hand-shaped linear() raw token: dip ~−4% BELOW origin (anticipation — a
+       thing no damped spring can do), cross 1.0, punch to ~1.22 (deliberately past
+       the ≤12% spring overshoot fence — which is WHY it is a register, not a
+       spring), settle. Exactly ONE sign change before the peak + a monotone settle
+       after (the shape-sanity fence).
+
+       NOT generated by regen-spring-tokens.mjs (which emits only (response,ζ)
+       springs from springPresets.ts), NOT a SPRING_PRESETS row, NOT a MOTION_CURVES
+       entry (MotionCurveKind is the closed spring|bezier union; a shaped linear()
+       with a negative leg is neither). A raw --ease-* property — zero engine
+       extension, zero TS change. Drives TRANSFORM/opacity ONLY (compositor-safe,
+       both engines — Baseline 17.2+, plain linear(), no -webkit prefix). The surface
+       composing it carries `--motion-weight: 1` in the SAME recipe (the loud-register
+       coupling — so the punch is never accidentally muted to ~+13.6% by inheriting
+       the rest 0.618). PRM zeroes the weight → the amplitude collapses (the springs
+       keep their own respectReducedMotion endpoint-snap). */
+    --ease-cartoon-punch: linear(
+        0, -0.012, -0.038 12%, -0.018 18%,
+        0.18 34%, 0.62 46%, 0.98 56%,
+        1.14 64%, 1.22 70%,
+        1.16 78%, 1.06 86%, 1.012 92%, 1
+    );
+
+    /* §2.Y BG.W-VIZ-REVEAL-BLOOM — the procedural-viz entrance-bloom clock (the ONE
+       consumer-retune knob for the one-shot `@keyframes substrate-reveal-bloom` in
+       viz-reveal.css; rides `--ease-cartoon-punch` for the ~+13% brightness overshoot). */
+    --substrate-reveal-duration: 1100ms;
 
     /* ═══════════════════════════════════════════════
        §2.A AMBIENT MOTION — Pulse aura tokens
@@ -426,3 +339,84 @@
     --z-debug: 99999;
 
 }
+
+/* ═══════════════════════════════════════════════
+   BD.W-MOTION-WEIGHT — the driver / observer carve (design.md §L4, gate C8)
+
+   The governing weight rests at the 1/φ centroid. LOUD DRIVERS — the dock morph
+   stage, an earned celebration — pin it to 1 so even a SLOW user-driven morph
+   rides the full squish/overshoot register (iOS reserves the weighty bounce for
+   what the user drives). CALM OBSERVERS — a programmatic reorder, an auto-advancing
+   carousel — pin it to 0: auto-motion that springs reads cheap. A single
+   element-scoped assignment, the same seam the PRM carve uses, inheriting down. */
+.liquid-stage {
+    --motion-weight: 1;
+}
+:where([data-reorder], [data-autoplay]) {
+    --motion-weight: 0;
+}
+
+/* ═══════════════════════════════════════════════
+   BI.W-TEMPO — the loud-scope tempo re-pin (the deliberate-weight carve, M11).
+
+   `--motion-tempo` (property-regs.css, initial 1.0 identity) is the global motion
+   TIME knob — a consumer sets `:root { --motion-tempo: 0.85 }` (the "options for
+   longer" clause of UF-G1) and every utility-UI spring clock + JS response tightens
+   in lockstep. The loud iOS-27 surfaces — the DOCK morph, the DRAWER sheet, the DECK
+   slide (composing `.liquid-stage`) — re-pin `--motion-tempo: 1` on their OWN scope
+   so the deliberately-landed BD.W-ANIM-IOS27-TUNE weight HOLDS where it was tuned,
+   while the ambient utility chrome follows the consumer's global scale (the SAME
+   `.liquid-stage { --motion-weight: 1 }` loud-driver carve pattern, for the TIME
+   axis). `:where()` keeps the specificity at 0 so a consumer's explicit per-instance
+   override still wins. At the 1.0 identity default this is a byte-no-op; it engages
+   ONLY when a consumer scales tempo globally.
+
+   ⟂ `--motion-weight` (magnitude) ⟂ `--ui-scale` (geometry) — the three scalars stay
+   disjoint (the NAMING FENCE). */
+:where(.glass-dock, .glass-drawer, .liquid-stage) {
+    --motion-tempo: 1;
+}
+
+/* ═══════════════════════════════════════════════
+   BG.W-LIQUID-WEIGHT-DEFAULT (F5.2) — the calm opt-out
+
+   The DEFAULT interactive-transition SPATIAL register is now spring-derived
+   (`--transition-liquid-spatial` = the `smooth` spring, generated in scheme-spring.css),
+   so every interactive surface inherits weight on its scale/translate/rotate legs by
+   default — weight is a property of the transition VOCABULARY, not a per-site
+   `--motion-weight` checklist. A surface that wants the flat no-weight register opts
+   OUT explicitly via `.motion-calm` (the `<Card>` calm register, a data-dense table,
+   any consumer scope). The swap is scoped to the SPATIAL token; the EFFECTS legs keep
+   their `--ease-standard` bezier either way (the motion-canon P1 split). */
+.motion-calm {
+    --transition-liquid-spatial: var(--ease-standard);
+}
+
+/* ═══════════════════════════════════════════════
+   BD.W-MOTION-WEIGHT / BD.W-CARTOON-PUNCH — the PRM carve
+
+   ONE assignment zeroes ALL of the goo that rides on top of the springs. Because
+   every squish/punch/shadow-travel reads through `--motion-weight` (the site-local
+   cap collapses to `1 + (cap−1)·0 == 1.0`, the inert-cast travel/spread collapse to
+   their rest, the §2c velocity boost is gated by the same weight), this single line
+   zeroes the squash, the overshoot share, the anticipation pull, the cartoon-shadow
+   travel, AND the velocity boost together. The springs keep their own
+   `respectReducedMotion` endpoint-snap in SpringProgress; the weight zeroes only the
+   GOO. The fade survives. `--ease-cartoon-punch` re-aliases to the non-overshooting
+   standard ease (belt-and-suspenders — the weight=0 already kills the punch
+   amplitude on a weight-scaled surface; the alias also removes the curve shape for
+   any consumer driving a non-amplitude leg). */
+@media (prefers-reduced-motion: reduce) {
+    :root {
+        --motion-weight: 0;
+        --ease-cartoon-punch: var(--ease-standard);
+        /* BG.W-LIQUID-WEIGHT-DEFAULT (F5.2) — the interactive-spatial DEFAULT loses its
+           overshoot under reduce (the vestibular floor). The re-alias is homed in
+           scheme-spring.css BESIDE its base `--transition-liquid-spatial: var(--spring-*)`
+           default (NOT here): both target `:root` at equal specificity, and scheme-spring.css
+           is @import-ed LAST of the token partials, so a re-alias parked in THIS earlier-
+           imported partial LOSES the source-order cascade to scheme-spring's base default and
+           the overshoot survives under reduce (the F5.2 paint-judge FAIL). The winning home is
+           the last-imported partial, after the base default — see scheme-spring.css. */
+    }
+}