feat(DateInput, TimeInput, DateTimeInput): the sheets' wheels draw as one picker under a finger

.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-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; no component uses them yet.
+
+@vjeux

.changeset/gesture-hook-fixes.md

@@ -0,0 +1,7 @@
+---
+'@astryxdesign/core': patch
+---
+
+[chore] Internal: the gesture hooks call nothing back after unmount; `usePressTracker` brakes with the host by default and applies option changes from the next touch; the recognizer's arena plumbing is `protected`; `attachTapHaptic` gives focus straight back. Not exported from the package entry point; no component uses it yet.
+
+@vjeux

.changeset/gesture-host-fixes.md

@@ -0,0 +1,7 @@
+---
+'@astryxdesign/core': patch
+---
+
+[chore] Internal: gesture host fixes from review. A page scroll under a still finger keeps the press and its click; watchers and touches nothing can claim get passive listeners only; a claimed pen holds only its own stylus touches; an element's own `touch-action` is never widened; slotted content scrolls with its shadow-tree scroller. Not exported from the package entry point; no component uses it yet.
+
+@vjeux

.changeset/gesture-host-owner.md

@@ -0,0 +1,7 @@
+---
+'@astryxdesign/core': patch
+---
+
+[chore] Internal: the gesture host becomes the one document-level touch owner: the finger count, touch gates, and a kept press for continuous-tracking controls. A scroll lock's page hold and the finger-scroll watch keep their own listeners and ask the host only about the touches it owns. A second finger fails a one-finger pan that has not claimed, so the page can pinch. Where the primary pointer is fine, the host attaches nothing and registers no listener, following the pointer when it changes; a recognizer that reads each event's pointer itself opts out with `perEventPointer`, and a press tracker with it gets press feedback only. Internal, used by the touch components; 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; no component uses it yet.
+
+@vjeux

.changeset/gesture-pan.md

@@ -0,0 +1,7 @@
+---
+'@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.
+
+@vjeux

.changeset/gesture-press-tracking.md

@@ -0,0 +1,7 @@
+---
+'@astryxdesign/core': patch
+---
+
+[chore] Internal: UIControl press tracking with control and cell profiles, the shared press paint, delegated press tracking and the gesture hooks. Not exported from the package entry point; no component uses them yet.
+
+@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

@@ -0,0 +1,7 @@
+---
+'@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.
+
+@vjeux

.changeset/gesture-recognizer-fixes.md

@@ -0,0 +1,7 @@
+---
+'@astryxdesign/core': patch
+---
+
+[chore] Internal: gesture recognizer and arena fixes from review; the early claim is opt-in, and a numeric `claimDistance` applies to any direction; one velocity tracker for every gesture (`spec:AST-100`: UIKit's measured blend, a scrolling surface's release through the pan's `scrollVelocity()`, and FR2's release rules). Not exported from the package entry point; no component uses it yet.
+
+@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; no component uses them yet.
+
+@vjeux

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

@@ -0,0 +1,7 @@
+---
+'@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.
+
+@vjeux

.changeset/gesture-watcher.md

@@ -0,0 +1,7 @@
+---
+'@astryxdesign/core': patch
+---
+
+[chore] Internal: a recognizer created with `claimsTouches: false` is a watcher: passive listeners only, simultaneous with every recognizer, and it follows a touch the browser takes for a scroll to the lift. Not exported from the package entry point; no component uses it yet.
+
+@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/touch-motion-theme-roles.md

@@ -0,0 +1,8 @@
+---
+'@astryxdesign/core': patch
+'@astryxdesign/cli': patch
+---
+
+[feat] Themes can retune touch motion roles. `defineTheme({motion})` takes `springs`, `durations` and `curves` keyed by motion role, the table path of a measured touch motion value (`springs.sheetPresent`, `navigation.transitionMs`), at the root or in an adaptation rule, and writes one `--motion-*` variable per role it sets. A role the theme leaves out keeps its measured default, an unknown role id is refused, and the duration scale (`fast`, `medium`, `ratio`) is optional when a theme sets only roles. `astryx docs motion` lists every motion role with its CSS variable and default, and the theme authoring guide and template describe the new fields.
+
+@vjeux

.changeset/touch-selection-lock-gestures.md

@@ -0,0 +1,7 @@
+---
+'@astryxdesign/core': patch
+---
+
+[chore] Internal: the gesture host takes the press feedback's selection lock for a press-tracked control's contact and for a recognizer created with `preventsTextSelection`, a non-text input under the finger included, and restores selection when the contact ends. Not exported from the package entry point; no component uses it yet.
+
+@vjeux

.changeset/touch-selection-lock.md

@@ -0,0 +1,7 @@
+---
+'@astryxdesign/core': patch
+---
+
+[fix] Under a finger or pen, holding a control whose hold does something (a slider's thumb, a switch's or a segmented control's drag) no longer starts text selection or the iOS callout; they come back when the finger lifts. A control or row whose hold does nothing keeps the browser's long-press selection. Text fields keep their selection, a link keeps its native menu and preview, and where the primary pointer is fine (a mouse, a trackpad, a touchscreen laptop, a desktop pen tablet) every contact keeps desktop selection. There, the press controller also registers no touch listener.
+
+@vjeux

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

@@ -0,0 +1,7 @@
+---
+'@astryxdesign/core': patch
+---
+
+[chore] Internal: the touch presentations' animator plays any closed-form curve (such as a spring chasing a moving target), drives a pseudo-element such as a dialog's ::backdrop, follows design:reduced-motion (under Reduce Motion, an opacity-only cross-fade of 200 ms on a coarse pointer or after a touch release and an immediate change on any other pointer, with no option or theme value that keeps travel or lengthens the fade; an entrance or exit role orients a slide that changes no opacity), and starts a call from rest when the browser commits it, as Core Animation does. Not exported from the package entry point.
+
+@vjeux

.changeset/uikit-motion-animator.md

@@ -0,0 +1,7 @@
+---
+'@astryxdesign/core': patch
+---
+
+[chore] Internal: a compositor animator for touch presentations. It plays UIKit's springs, scroll coasts (built by a separate coast module, so a surface that never coasts does not carry them) and any closed-form curve 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.
+
+@vjeux

.changeset/uikit-motion-math.md

@@ -0,0 +1,7 @@
+---
+'@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.
+
+@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

.changeset/use-finger-scroll.md

@@ -0,0 +1,7 @@
+---
+'@astryxdesign/core': patch
+---
+
+[chore] Internal: `useFingerScroll(scroller)` tells a finger's scroll from the program's, and the gestures README gains a guide to migrating a raw-touch drag onto the recognizers. Internal to the touch components: not exported from the package entry point or the gestures barrel.
+
+@vjeux

.changeset/wheel-group-inputs.md

@@ -0,0 +1,7 @@
+---
+'@astryxdesign/core': patch
+---
+
+[feat] Under a finger, on every touch device, the wheels in the TimeInput, DateTimeInput and DateInput bottom sheets now draw as one picker, as UIPickerView does. One selection band spans every column, and each column's dimmed rows lean toward the picker's centre instead of their own. With a mouse the sheets are unchanged.
+
+@vjeux

.changeset/wheel-nearest-valid.md

@@ -0,0 +1,7 @@
+---
+'@astryxdesign/core': patch
+---
+
+[fix] A picker wheel that stops on a value outside the bounds now settles on the nearest value inside them. Before, it bounced back to the value it started from. This applies to the wheels in the TimeInput, DateTimeInput and DateInput bottom sheets. For example, with `min="09:00"`, dragging the hour wheel from 10 to 7 settles on 9, as the iOS time picker does. A stop on a value inside the bounds is unchanged. Opening a sheet on a value outside the bounds commits nothing. Under reduced motion, the wheel's own scrolls (this travel, and the step from an arrow key or a click on a row) no longer glide: on a touch screen, or after a touch drag, they cross-fade, the rows landing while they are faded out; otherwise they land at once.
+
+@vjeux

.changeset/wheel-uikit-picker-values.md

@@ -0,0 +1,8 @@
+---
+'@astryxdesign/core': patch
+'@astryxdesign/cli': patch
+---
+
+[feat] A theme can retune how long a picker wheel takes to turn a tapped row onto its band: `picker.tapSpin.durationMs` is a new motion role (0.3 s, UIPickerView's), listed in the motion roles table of `astryx docs motion`. With it, UIPickerView's values measured on iOS 26.2 join the UIKit constants table. They cover the wheel's geometry (row pitch, cylinder radius, perspective, the selection band, the band row's magnification), the coast's stop speed and velocity floor, the snap at rest, the tap spin and the selection tick. The pure math a wheel moves and draws with comes with them. It projects the row a release rests on as UIScrollView sums its deceleration, coasts with the rate re-solved to stop on that row, snaps, bounces at an end on the bounce spring a theme resolved, rubber-bands, spins to a tapped row, and turns each row onto the cylinder. It is checked against UIKit's recorded frames. A player bakes a wheel's motion into per-row Web Animations that run on the compositor, and lands a wheel without travel for reduced motion (an opacity-only cross-fade). Not exported from the package entry point.
+
+@vjeux

.changeset/wheel-uikit-picker.md

@@ -0,0 +1,7 @@
+---
+'@astryxdesign/core': patch
+---
+
+[feat] Under a finger, on every touch device, the picker wheels in the TimeInput, DateTimeInput and DateInput bottom sheets now look and move like UIPickerView. The rows sit on a cylinder seen in perspective, and the row in the capsule band is magnified. A flick coasts at UIKit's deceleration onto the row UIKit's projection picks. A finger landing on a moving wheel stops it. A tap on a row turns it onto the band. Past the first or last row, a drag rubber-bands and the wheel bounces back. As on iOS, the value commits when the wheel comes to rest, and the coast keeps running while the page's main thread is busy. Arrow keys and clicks on a row still commit at once. Under reduced motion, a fling, a tap, a key or a programmatic turn cross-fades onto its row instead of turning; the drag itself still follows the finger. A theme can retune the tap spin's duration (`picker.tapSpin.durationMs`) and curve (`timing.curves.move`) and the bounce at an end (`scroll.bounce`). With a mouse the wheels are unchanged.
+
+@vjeux

.github/scripts/ci-interaction.test.mjs

@@ -233,7 +233,7 @@ describe('interaction proof routing', () => {
     }
   });
 
-  it('keeps the harness, components, Storybook and its own setup in scope', () => {
+  it('keeps the harness, components, themes, Storybook and its own setup in scope', () => {
     const pattern = new RegExp(
       decide().run.match(/bash "\$helper" "\$BASE_SHA" '([^']+)'/)[1],
     );
@@ -242,6 +242,8 @@ describe('interaction proof routing', () => {
       'internal/a11y-spec/src/storybook.ts',
       'playwright.interaction.config.ts',
       'packages/core/src/BottomSheet/BottomSheet.tsx',
+      // Themes set the motion durations components animate with.
+      'packages/themes/neutral/src/neutralTheme.ts',
       'apps/storybook/.storybook/preview.tsx',
       '.github/workflows/ci.yml',
       'package.json',
@@ -253,6 +255,7 @@ describe('interaction proof routing', () => {
       'docs/specs/AST-030/spec.md',
       'apps/docsite/src/app/page.tsx',
       'packages/core/package.json',
+      'packages/themes/neutral/package.json',
       '.github/scripts/native-swift.sh',
     ]) {
       expect(pattern.test(untouched), untouched).toBe(false);

.github/workflows/ci.yml

@@ -1766,7 +1766,7 @@ jobs:
             && git fetch --quiet --no-tags --depth=1 origin "$BASE_SHA" \
             && git show "$BASE_SHA:.github/scripts/pr-scope-touches.sh" > "$helper"; then
             scope=0
-            bash "$helper" "$BASE_SHA" '^(internal/interaction-harness/|internal/a11y-spec/|playwright\.interaction\.config\.ts$|packages/[^/]+/src/|apps/storybook/|\.github/workflows/ci\.yml$|package\.json$|pnpm-lock\.yaml$)' || scope=$?
+            bash "$helper" "$BASE_SHA" '^(internal/interaction-harness/|internal/a11y-spec/|playwright\.interaction\.config\.ts$|packages/[^/]+/src/|packages/themes/[^/]+/src/|apps/storybook/|\.github/workflows/ci\.yml$|package\.json$|pnpm-lock\.yaml$)' || scope=$?
           fi
           if [ "$scope" = 1 ]; then
             echo 'No harness, component, Storybook or proof-setup change; skipping the interaction proofs.'

apps/docsite/next.config.mjs

@@ -9,9 +9,14 @@
  * @position Next.js configuration for the existing Vercel docsite deployment.
  */
 
-import {existsSync, readFileSync, readdirSync} from 'node:fs';
+import {existsSync, readFileSync, readdirSync, realpathSync} from 'node:fs';
+import {createRequire} from 'node:module';
 import {resolve} from 'node:path';
 
+const coreInternalModules = createRequire(import.meta.url)(
+  '../../scripts/core-internal-modules.cjs',
+);
+
 const playgroundCookieCompatibility = readFileSync(
   resolve(
     import.meta.dirname,
@@ -156,6 +161,28 @@ const nextConfig = {
         {'@astryxdesign/cli/api': 'module @astryxdesign/cli/api'},
       ];
     }
+    // Lab's build imports core's internal motion and gesture modules by their
+    // module paths, which core's "exports" do not list. Resolve each to the
+    // file core's own built components import, so a page keeps one gesture
+    // host and one animator per element.
+    const coreDir = realpathSync(
+      resolve(import.meta.dirname, 'node_modules/@astryxdesign/core'),
+    );
+    config.plugins.push(
+      new webpack.NormalModuleReplacementPlugin(
+        coreInternalModules.CORE_INTERNAL_SPECIFIER,
+        resource => {
+          const file = coreInternalModules.resolveCoreInternal(
+            resource.request,
+            {coreDir},
+          );
+          if (file != null) {
+            resource.request = file;
+          }
+        },
+      ),
+    );
+
     // Webpack's CSS @import resolver doesn't follow package.json "exports".
     // Map each theme's /theme.css subpath to the actual dist file.
     const themesDir = resolve(import.meta.dirname, '../../packages/themes');

apps/sandbox/vite.config.mts

@@ -15,6 +15,7 @@ import path from 'node:path';
 import {fileURLToPath} from 'node:url';
 import {createRequire} from 'node:module';
 import stylexResolution from '../../scripts/stylex-module-resolution.cjs';
+import coreInternalModules from '../../scripts/core-internal-modules.cjs';
 import {categories} from './src/app/sandboxPages';
 import {
   discoverRoutes,
@@ -33,6 +34,29 @@ let routes = discoverRoutes(
   categories.map(category => category.slug),
 );
 
+/**
+ * Lab's build imports core's internal motion and gesture modules by their
+ * module paths, which core's `exports` do not list. Resolve each to the file
+ * core's own built components import (its source under ASTRYX_SOURCE), so the
+ * page keeps one gesture host and one animator per element.
+ */
+function coreInternalModulePaths(): Plugin {
+  const coreDir = fs.realpathSync(
+    path.join(appDir, 'node_modules/@astryxdesign/core'),
+  );
+  const source = process.env.ASTRYX_SOURCE === '1';
+  return {
+    name: 'sandbox-core-internal-modules',
+    enforce: 'pre',
+    resolveId(specifier) {
+      return coreInternalModules.resolveCoreInternal(specifier, {
+        coreDir,
+        source,
+      });
+    },
+  };
+}
+
 function staticRoutes(): Plugin {
   const id = '\0virtual:sandbox-routes';
   let failed = false;
@@ -212,6 +236,7 @@ export default defineConfig({
         ],
       },
     }),
+    coreInternalModulePaths(),
     staticRoutes(),
   ],
   resolve: {

apps/storybook/stories/TimeInput.stories.tsx

@@ -224,6 +224,27 @@ export const WithMinMax: Story = {
   },
 };
 
+/**
+ * The bottom-sheet wheels with bounds: hours outside 9 AM - 5 PM stay on the
+ * wheel, greyed out, and a wheel that stops on one goes on to the nearest
+ * hour inside the bounds.
+ */
+export const BottomSheetWithMinMax: Story = {
+  render: args => {
+    const [value, setValue] = useState<ISOTimeString | undefined>(
+      '10:00' as ISOTimeString,
+    );
+    return <TimeInput {...args} value={value} onChange={setValue} />;
+  },
+  args: {
+    label: 'Appointment time',
+    presentation: 'bottom-sheet',
+    min: '09:00' as ISOTimeString,
+    max: '17:00' as ISOTimeString,
+    description: 'Business hours: 9 AM - 5 PM',
+  },
+};
+
 export const WithIncrement: Story = {
   render: args => {
     const [value, setValue] = useState<ISOTimeString | undefined>(