feat(core): a CSS part times itself from its spring's settle at the theme's knobs

.changeset/build-stylex-cross-file-consts.md

@@ -0,0 +1,7 @@
+---
+'@astryxdesign/build': patch
+---
+
+[fix] `astryxStylex` resolves `defineConsts` values read from another file. With the `{stylexOptions}` form (the one Storybook uses), a file that read only constants from a `.stylex.ts` module lost that import once StyleX compiled it, so the constants never reached the CSS: a constant used as a media-query key failed the build ("Invalid empty selector") and one used as a value shipped as a custom property nothing declares. In either form, a constant defined on the other side of the layer split, or in an Astryx package (compiled with the library class-name prefix) and read from an app file (compiled with its own), stayed unresolved.
+
+@vjeux

.changeset/gesture-arena-moving-cancel.md

@@ -0,0 +1,7 @@
+---
+'@astryxdesign/core': patch
+---
+
+[chore] Internal: a gesture that cancels itself on a finger's move (a long press dragged past its tolerance) keeps that finger claimed until it lifts, so the page never takes the drag over midway; a resting finger is still given back when its gesture is cancelled. Not exported from the package entry point.
+
+@vjeux

.changeset/gesture-browser-negotiation.md

@@ -0,0 +1,7 @@
+---
+'@astryxdesign/core': patch
+---
+
+[chore] Internal: touch-action derivation, the native scroll probe and haptics for the gesture system. Not exported from the package entry point.
+
+@vjeux

.changeset/gesture-host.md

@@ -0,0 +1,7 @@
+---
+'@astryxdesign/core': patch
+---
+
+[chore] Internal: the gesture system's DOM host (claims, click suppression, the browser's takeover, the pointer behind a contact). Not exported from the package entry point.
+
+@vjeux

.changeset/gesture-pan.md

@@ -2,6 +2,6 @@
 '@astryxdesign/core': patch
 ---
 
-[chore] Internal: the pan gesture recognizer, with UIKit's measured hysteresis and velocity filter. Not exported from the package entry point; no component uses it yet.
+[chore] Internal: the pan gesture recognizer, with UIKit's measured hysteresis and velocity filter. Not exported from the package entry point.
 
 @vjeux

.changeset/gesture-press-tracking.md

@@ -0,0 +1,7 @@
+---
+'@astryxdesign/core': patch
+---
+
+[chore] Internal: UIControl press tracking with control and cell profiles and the gesture hooks, with every press painter writing `data-astryx-press` through one internal writer in `utils/pressFeedback.ts`. Not exported from the package entry point.
+
+@vjeux

.changeset/gesture-readme.md

@@ -0,0 +1,7 @@
+---
+'@astryxdesign/core': patch
+---
+
+[chore] Internal: the gesture system's README for component authors, with its browser proof in Chromium and WebKit.
+
+@vjeux

.changeset/gesture-recognizer-core.md

@@ -2,6 +2,6 @@
 '@astryxdesign/core': patch
 ---
 
-[chore] Internal: the gesture recognizer core for touch presentations: UIKit's recognizer state machine and the arena that settles which recognizer owns a touch. Not exported from the package entry point; no component uses it yet.
+[chore] Internal: the gesture recognizer core for touch presentations: UIKit's recognizer state machine and the arena that settles which recognizer owns a touch. Not exported from the package entry point.
 
 @vjeux

.changeset/gesture-swipe-pinch-rotation-edge-hover.md

@@ -0,0 +1,7 @@
+---
+'@astryxdesign/core': patch
+---
+
+[chore] Internal: swipe, pinch, rotation, screen-edge pan and hover gesture recognizers. Not exported from the package entry point.
+
+@vjeux

.changeset/gesture-tap-long-press.md

@@ -2,6 +2,6 @@
 '@astryxdesign/core': patch
 ---
 
-[chore] Internal: tap and long-press gesture recognizers with UIKit's measured thresholds. Not exported from the package entry point; no component uses them yet.
+[chore] Internal: tap and long-press gesture recognizers with UIKit's measured thresholds. Not exported from the package entry point.
 
 @vjeux

.changeset/reduced-motion-record.md

@@ -0,0 +1,7 @@
+---
+'@astryxdesign/core': patch
+---
+
+[chore] Internal: Reduce Motion for the touch presentations follows design:reduced-motion beyond the animator too. `reducedMotionFade()` gives code beside the animator the animator's own fade (an opacity-only 200 ms cross-fade on a coarse pointer or after a touch release, at once on any other pointer), `animator.reducedMotion()` reports which form a change takes for feedback that plays no fade of its own, and `reducedMotion.stylex.ts` holds the fade's constants for StyleX transitions. The fade's length is not a theme motion role. Not exported from the package entry point.
+
+@vjeux

.changeset/theme-motion-knobs.md

@@ -0,0 +1,8 @@
+---
+'@astryxdesign/core': patch
+'@astryxdesign/cli': patch
+---
+
+[feat] A theme's `motion` takes three knobs beside the duration scale: `tempo` (0.75–1.5) scales every motion duration, the touch springs' included, `character` (`'crisp'`, `'standard'` or `'expressive'`) sets the new `--ease-entrance` and `--ease-move` tokens and how lively a spring is, and `reducedMotion: 'always'` reduces motion for everyone; so far the theme's motion-keyed adaptation rules, the press release fade and the animator, with its layout glide and Reduce Motion fade, follow it, not yet components' other Reduce Motion styles. A theme without them renders exactly as before; a duration scale and explicit tokens win over the knobs, Spinner's and Skeleton's loops keep their timing under every tempo, and the press release fade follows tempo up to the 200 ms Reduce Motion cap, under the person's setting or the theme's `'always'`. The motion, token and theme-authoring docs and the theme template describe the knobs.
+
+@vjeux

.changeset/uikit-constants-table.md

@@ -2,6 +2,6 @@
 '@astryxdesign/core': patch
 ---
 
-[chore] Internal: the UIKit constants table for touch presentations (springs, scroll physics, timing curves and navigation values), each value with its source and a checked list of the simulator measurements still owed. Not exported from the package entry point; no component reads it yet.
+[chore] Internal: the UIKit constants table for touch presentations (springs, scroll physics, timing curves and navigation values), each value with its source and a checked list of the simulator measurements still owed. Not exported from the package entry point.
 
 @vjeux

.changeset/uikit-motion-animator-pseudo-element.md

@@ -0,0 +1,7 @@
+---
+'@astryxdesign/core': patch
+---
+
+[chore] Internal: the touch presentations' animator drives a pseudo-element such as a dialog's ::backdrop: a static filling animation holds its value after a curve ends and after `set`, a custom property on its host promotes it, and a Reduce Motion dip borrows and hands back the pseudo-element's own opacity. Not exported from the package entry point.
+
+@vjeux

.changeset/uikit-motion-animator.md

@@ -2,6 +2,6 @@
 '@astryxdesign/core': patch
 ---
 
-[chore] Internal: a compositor animator for touch presentations. It plays UIKit's springs, and scroll coasts (built by a separate coast module, so a surface that never coasts does not carry them; `decay` plays momentum, and sends a spring back from past an edge through the Reduce Motion policy: a cross-fade on a coarse pointer or after a touch release, at once elsewhere) as Web Animations on translate, rotate, scale and opacity, so they keep running while JavaScript is busy, and reads values and velocities back from the curves for interruption, retargeting and Reduce Motion cross-fades. Not exported from the package entry point; no component uses it yet.
+[chore] Internal: a compositor animator for touch presentations. It plays UIKit's springs, and scroll coasts (built by a separate coast module, so a surface that never coasts does not carry them; `decay` plays momentum, and sends a spring back from past an edge through the Reduce Motion policy: a cross-fade on a coarse pointer or after a touch release, at once elsewhere) as Web Animations on translate, rotate, scale and opacity, so they keep running while JavaScript is busy, and reads values and velocities back from the curves for interruption, retargeting and Reduce Motion cross-fades. Not exported from the package entry point.
 
 @vjeux

.changeset/uikit-motion-math.md

@@ -2,6 +2,6 @@
 '@astryxdesign/core': patch
 ---
 
-[chore] Internal: the spring, decay, rubber-band and projection math of UIKit for touch presentations, as pure functions checked against an independent integration and against values read from UIKit. Not exported from the package entry point; no component uses it yet.
+[chore] Internal: the spring, decay, rubber-band and projection math of UIKit for touch presentations, as pure functions checked against an independent integration and against values read from UIKit. Not exported from the package entry point.
 
 @vjeux

.changeset/uikit-motion-use-animator.md

@@ -0,0 +1,7 @@
+---
+'@astryxdesign/core': patch
+---
+
+[chore] Internal: useAnimator, a React wrapper around the touch presentations' animator that never re-renders per frame, and browser proofs on the interaction harness that the animator's motion keeps running through a blocked main thread in Chromium and WebKit. Not exported from the package entry point.
+
+@vjeux

docs/architecture/theme-authoring-contract.md

@@ -18,6 +18,8 @@ applies_to:
     packages/core/src/theme/expandTypeScale.ts,
     packages/core/src/theme/expandRadiusScale.ts,
     packages/core/src/theme/expandMotionScale.ts,
+    packages/core/src/theme/themeMotion.ts,
+    packages/core/src/theme/motionKnobs.ts,
     packages/core/src/theme/mergeComponents.ts,
     packages/core/src/theme/onMediaTokens.ts,
     packages/core/src/theme/localTokens.ts,
@@ -33,6 +35,7 @@ verified_by:
     packages/core/src/theme/expandTypeScale.test.ts,
     packages/core/src/theme/expandRadiusScale.test.ts,
     packages/core/src/theme/expandMotionScale.test.ts,
+    packages/core/src/theme/themeMotion.test.ts,
     packages/core/src/theme/onMediaTokens.test.ts,
     scripts/check-theme-template.test.mjs,
   ]
@@ -52,6 +55,7 @@ deciding_specs:
     spec:AST-087/DEC-7,
     spec:AST-087/DEC-9,
     spec:AST-087/DEC-10,
+    spec:AST-108/DEC-1,
   ]
 ---
 
@@ -192,6 +196,20 @@ it, typed as that theme's listed names.
 - **INV14 — The variant list is theme-level.** `iconVariants` lists the variant
   names the whole theme supports. It is never per icon and never combined with
   another theme's list.
+- **INV15 — Motion is three knobs beside the duration scale.** `motion` takes
+  `tempo` (clamped to 0.75–1.5), `character` (`crisp`, `standard`,
+  `expressive`), and `reducedMotion` (`system`, `always`) beside the duration
+  scale. `tempo` scales every duration token and `character` sets
+  `--ease-entrance` and `--ease-move`; with tempo 1 and `standard` the tokens
+  are the defaults. A duration scale's durations win over `tempo`, and
+  explicit tokens win over both. An extending theme inherits motion field by
+  field: a duration-scale field or knob the child leaves unset keeps its
+  base's value. Each duration's
+  value before `tempo` is kept for busy-indicator loops, which never follow
+  `tempo`. `reducedMotion: 'always'` marks the theme's root, and what keys
+  reduced motion on `prefers-reduced-motion` keys it on that mark as well
+  (`spec:AST-108` FR6). An adaptation rule may set `tempo` and `character`,
+  never `reducedMotion`.
 
 This record does not own:
 
@@ -249,6 +267,10 @@ public surface belongs to
 
 ## Owning code
 
+- An internal, pure `resolveThemeMotion(theme)` returns a theme's motion
+  knobs, durations, and easings for server code; it touches no DOM and has no
+  import-time side effects (`spec:AST-108` FR6). The animator reads the knobs
+  from the custom properties the theme writes (`motion/themeKnobs.ts`).
 - `packages/core/src/theme/defineTheme.ts` owns the public input, normalized IR,
   orchestration, and extension behavior.
 - `themeAdaptations.ts` owns the fixed breakpoint/condition vocabulary,
@@ -257,6 +279,9 @@ public surface belongs to
   adopts their tokens.
 - `expandColorScale.ts`, `expandTypeScale.ts`, `expandRadiusScale.ts`, and
   `expandMotionScale.ts` own their derived token/component values.
+- `motionKnobs.ts` owns the motion knobs' types, defaults and clamping;
+  `themeMotion.ts` owns the tokens, pre-tempo durations and knob properties
+  they generate, and `resolveThemeMotion`, the pure read server code uses.
 - `mergeComponents.ts` owns the shared deep-merge rule.
 - `onMediaTokens.ts` owns normalization of inverted-surface overrides.
 - `localTokens.ts` owns opt-in enrollment, valid CSS custom-property names, exact
@@ -275,7 +300,9 @@ behavior. AST-012 decisions 1–4 establish the fixed width map, named closed co
 ordered rule cascade, and source/built adaptation metadata parity. AST-017 decision 1
 owns released compatibility classification and migration. AST-087 decisions 2, 7, 9,
 and 10 establish function icon entries, node-valued public reads, the theme-level
-`iconVariants` list, and the static public view of `componentIcons`.
+`iconVariants` list, and the static public view of `componentIcons`. AST-108
+decision 1 establishes the three motion knobs and keeps per-role motion values
+internal.
 
 ## Known conformance and verification gaps
 
@@ -285,11 +312,18 @@ classify local references. Until the implementation lands, INV8's prefix-indepen
 clauses are current authority but not enforcement. Existing explicit enrollment,
 owner, lineage, collision, cycle, and legacy-unenrolled behavior remains shipped.
 
-The motion resolver is accepted but unshipped: an internal, pure
-`resolveThemeMotion(theme)` returns a theme's motion knobs, durations, easings,
-and role tables for the animator and for server code, touching no DOM and with
-no import-time side effects (`spec:AST-108` FR6). Until it lands, FR6's
-resolution is current authority but not enforcement.
+`resolveThemeMotion`'s role tables are accepted but unshipped (`spec:AST-108`
+FR6): the animator's springs follow the knobs through the custom properties a
+theme or adaptation rule writes (`motion/themeKnobs.ts`), but server code has
+no role values yet. Until they land, that part of FR6 is current authority but
+not enforcement.
+
+The reach of `reducedMotion: 'always'` is accepted but partly unshipped
+(`spec:AST-108` FR6, INV15). Motion-keyed adaptation rules, the press release
+fade, the animator, its layout glide (`motion/animatedLayout.ts`) and
+`reducedMotionFade()` key reduced motion on the mark; components' other Reduce
+Motion styles and other script readers of `prefers-reduced-motion` do not yet. Until they do, that part of INV15 and FR6 is current authority but not
+enforcement.
 
 ## Verification
 
@@ -304,5 +338,6 @@ resolution is current authority but not enforcement.
 | INV11                    | `DefineThemeInput`/output diff plus runtime/build fixtures                                              | Validation-only data enters the normalized theme, or productive input loses construction validation                       |
 | INV12                    | Core theme export diff, constructed-value evidence, and current-consumer callsite                       | A theme `define*` helper only checks input and returns that exact input unchanged                                         |
 | INV13, INV14             | `defineTheme.test.ts` type and normalization tests for function entries, slot functions, and the list   | A public read returns a function, a child merges variant lists, or an entry sees another theme's names                    |
+| INV15                    | `themeMotion.test.ts` over tempo bounds, characters, a duration scale, explicit tokens, and extension   | A token off its knob, a knob beating a scale or explicit token, a lost inherited knob, or a loop following `tempo`        |
 | Theme/Core compatibility | Maintained theme source/build against the minimum Core in its currently supported peer/dependency range | A theme update silently requires newer in-range Core or bypasses the `spec:AST-017` path                                  |
 | Authoring projection     | `scripts/check-theme-template.test.mjs`                                                                 | A supported authoring concept is missing or misstated in the template                                                     |