refactor(DropdownMenu): the finger a trigger hands to the menu runs on the shared action-group tracker

.changeset/action-group-tracker-core.md

@@ -0,0 +1,7 @@
+---
+'@astryxdesign/core': patch
+---
+
+[internal] AlertDialog's touch tracking runs on the shared action-group tracker, the one any gesture recognizer can drive (a menu tracking the finger that opened it from its trigger, a segmented control, a page control). AlertDialog's behavior is unchanged.
+
+@vjeux

.changeset/action-group-tracker.md

@@ -0,0 +1,7 @@
+---
+'@astryxdesign/core': patch
+---
+
+[internal] One tracker for a held finger across a group of targets (an alert's or an action sheet's actions, a menu's rows, a segmented control's segments, a page control's dots): it reads the targets' rects once, resolves the finger against them (or by the owner's rule), paints or reports the highlight, and runs the target through its own click at the lift. Nothing a consumer sees changes.
+
+@vjeux

.changeset/alertdialog-touch-action-tracking.md

@@ -0,0 +1,7 @@
+---
+'@astryxdesign/core': patch
+---
+
+[fix] AlertDialog: on a touch screen, under a finger or a pen, the two actions are tracked as one group, the way iOS tracks an alert's actions. A finger that lands on one action and slides to the other now runs the action it lifts on. Before, iOS Safari ran the action the finger first touched (Delete, when the finger slid to Cancel), and other browsers ran nothing and left the alert open. The touched action highlights as soon as it is touched instead of 150 ms later, the highlight follows the finger between the actions, and lifting off both still runs nothing. A mouse, the keyboard and assistive technology keep each button's own click, and text stays selectable with a mouse. To keep the previous behavior under a finger, pass the new `presentation="dialog"`, which keeps the dialog a mouse gets on every device; the default is `presentation="adaptive"`.
+
+@vjeux

.changeset/alertdialog-touch-motion.md

@@ -0,0 +1,7 @@
+---
+'@astryxdesign/core': patch
+---
+
+[feat] AlertDialog: under a finger the alert appears and leaves the way an iOS alert does. It scales down into place from 1.2 while it and the dimming fade in, and it fades out with the dimming when it closes, on the alert's measured spring; the animation keeps running when the page is busy. While it appears a touch does nothing (keys and assistive technology still act), and while it leaves nothing reaches it: a touch, a click, a key or an assistive-technology activation does nothing. With reduced motion it only cross-fades. With a mouse nothing changes, and `presentation="dialog"` keeps the previous motion and width under a finger too.
+
+@vjeux

.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/dropdownmenu-touch-selection.md

@@ -0,0 +1,7 @@
+---
+'@astryxdesign/core': patch
+---
+
+[feature] Under a finger, on every touch device, DropdownMenu tracks a finger that lands in its open menu as the list of an iOS menu does: the row under a resting finger lights at once in a menu that fits and, in a menu that scrolls, after UIKit's content-touch delay (150 ms), a tap picks at the lift, and a quick drag scrolls a menu that scrolls and slides the highlight in one that fits. A mouse, and `presentation="popover"`, keep the pointer model. It runs on the gesture system and the shared action-group tracker; `useMenuPress` itself is unchanged.
+
+@vjeux

.changeset/dropdownmenu-uimenu-placement.md

@@ -0,0 +1,7 @@
+---
+'@astryxdesign/core': patch
+---
+
+[feature] On a compact touch screen (a phone, iOS or Android), the popover DropdownMenu and MoreMenu sit where UIMenu does: over their trigger, centered on it and top-aligned with it, or bottom-aligned when the trigger is in the lower half of the viewport, 8 px from the viewport's sides (or the safe area), and no taller than the room left, so they stay on screen and scroll. The finger that opened the menu rests on its first row and picks only once it moves, as on iOS. Larger screens, a mouse, and `presentation="popover"` keep the menu below its trigger.
+
+@vjeux

.changeset/dropdownmenu-uimenu-touch.md

@@ -0,0 +1,7 @@
+---
+'@astryxdesign/core': patch
+---
+
+[feature] Under a finger, on every touch device, DropdownMenu and MoreMenu grow out of their trigger on UIKit's open spring and collapse back into it on the close spring, as UIMenu does. Both run on the compositor and can be interrupted either way. Under Reduce Motion the menu fades in place (the animator's policy). A pan that starts outside the open menu dismisses it as the page scrolls, and focus that was in the menu returns to the trigger. Under a mouse, or with `presentation="popover"`, the menu keeps the layer's entrance and the theme's motion.
+
+@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; DropdownMenu's press hook uses them.
+
+@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.
+
+@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; 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

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

.changeset/layer-exit-copy.md

@@ -0,0 +1,7 @@
+---
+'@astryxdesign/core': patch
+---
+
+[chore] Internal: the layer runtime gains one exit copy for touch presentations that animate a popover out: a static, inert copy of the closing popover, shown only in the top layer where the popover was drawn, for the close to play on. DropdownMenu's touch close plays on it.
+
+@vjeux

.changeset/menu-handoff-shared-tracker.md

@@ -0,0 +1,7 @@
+---
+'@astryxdesign/core': patch
+---
+
+[internal] Under DropdownMenu's touch modes, the finger that opened the menu resolves the menu's rows through the shared action-group tracker, as a finger that lands in the menu already does: rects read once instead of a hit test per move. Nothing a consumer sees changes.
+
+@vjeux

.changeset/menu-press-uimenu.md

@@ -0,0 +1,7 @@
+---
+'@astryxdesign/core': patch
+---
+
+[feature] Under a finger, a DropdownMenu or MoreMenu trigger now opens its menu as the finger presses, instead of after a 500 ms hold (`spec:AST-094` FR29). Inside a scroll view it opens once the 150 ms content-touch delay has passed with no scroll, so a scroll that starts on it still scrolls. The finger that opened the menu picks a row only after it has moved 10 px, so a menu that appears under a resting finger never picks the row beneath it. To keep the previous behavior, a tap that opens at the lift, a 500 ms hold and the settle rule, pass `presentation="popover"`. A mouse is unchanged.
+
+@vjeux

.changeset/presentation-resolver.md

@@ -0,0 +1,7 @@
+---
+'@astryxdesign/core': patch
+---
+
+[chore] An internal `usePresentation` / `readPresentation` resolves a component's `presentation` prop into the surface to render and whether its touch input modes apply, keeping an omitted value distinct from an explicit `'popover'` so a caller's choice always wins over a touch default. DropdownMenu (and MoreMenu, through it) reads it for its touch presentation.
+
+@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

@@ -2,6 +2,6 @@
 '@astryxdesign/core': patch
 ---
 
-[chore] Internal: the touch motion tables register their springs, durations and curves as internal motion roles, each read once when a motion starts, so every component keeps its measured value. Nothing public changes: themes do not set motion roles, and no shipped component reads the roles yet.
+[chore] Internal: the touch motion tables register their springs, durations and curves as internal motion roles, each read once when a motion starts, so every component keeps its measured value. Nothing public changes: themes do not set motion roles. DropdownMenu's touch grow and collapse read `springs.menuOpen` and `springs.menuClose`.
 
 @vjeux

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

@@ -0,0 +1,7 @@
+---
+'@astryxdesign/core': patch
+---
+
+[chore] Internal: under a finger or pen on a coarse primary pointer, the gesture host turns text selection and the touch callout off for one held contact only on elements whose hold does something (`spec:AST-094` FR41, DEC-9). A long press with a hold brings that lock by default (one at 0 ms, a touch-down detector, brings none, and `selectionLock: null` opts out), and another recognizer opts in with the internal `selectionLock` option (a slider's thumb, a switch's drag); the host calls the locks and never imports one. Everything else keeps the browser's long-press selection. Not exported from the package entry point.
+
+@vjeux

.changeset/touch-selection-lock.md

@@ -0,0 +1,7 @@
+---
+'@astryxdesign/core': patch
+---
+
+[fix] Where the primary pointer is fine (a mouse, a trackpad, a touchscreen laptop, a desktop pen tablet), the press feedback controller no longer registers a touch listener: it reads the primary pointer at the first finger or pen press and keeps its `touchcancel` listener only while that pointer is coarse.
+
+@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; DropdownMenu's touch presentation reads it.
 
 @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) through `play`, with the same presentation values, velocities, stop and shared clock as a spring, and the Reduce Motion policy. 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-reduced-motion.md

@@ -0,0 +1,7 @@
+---
+'@astryxdesign/core': patch
+---
+
+[chore] Internal: the touch presentations' animator 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), decided by its own planner module, 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

@@ -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 a release's momentum, and under Reduce Motion cross-fades a spring back from past an edge) 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, 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; DropdownMenu's touch presentation uses it.
 
 @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

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/docsite/src/__tests__/data-extraction.test.ts

@@ -1428,7 +1428,10 @@ describe('DropdownMenu adaptive-presentation example', () => {
     );
 
     expect(presentation?.type).toBe("'popover' | 'bottom-sheet' | 'adaptive'");
-    expect(presentation?.default).toBe("'popover'");
+    // Unset by default: the menu is anchored, with the touch modes under a
+    // finger (spec:AST-094 FR29); 'popover' pins the pointer behavior.
+    expect(presentation?.default).toBeUndefined();
+    expect(presentation?.description).toContain("Pass 'popover'");
 
     const defaults = dropdownMenu?.playground?.defaults as
       Record<string, unknown> | undefined;

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: {