feat(core): an experimental List reorder subpath for rows that are not ListItems

.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. A constant defined on the library side of the layer split and read on the product side stayed unresolved in either form. A production build now also warns, naming the variable and the rule that reads it, when its stylesheet reads a StyleX-generated custom property that nothing declares; set `undefinedVariables: 'error'` to fail the build instead.
+
+@vjeux

.changeset/gesture-browser-negotiation.md

@@ -0,0 +1,7 @@
+---
+'@astryxdesign/core': patch
+---
+
+[chore] Touch-action derivation, the native scroll probe and haptics for the gesture system. Not exported from the package root; touch presentations reach them through the experimental subpaths (see their entry). No component uses them yet.
+
+@vjeux

.changeset/gesture-hook-fixes.md

@@ -0,0 +1,7 @@
+---
+'@astryxdesign/core': patch
+---
+
+[experimental] Gesture hooks follow their element: `useGestureRecognizer` and `usePressTracker` attach to a node rendered after mount or swapped behind the same ref, and call the consumer back neither from cleanup nor after unmount. `usePressTracker` takes `isBraking` (by default the host's) and applies a changed `trackingExpansion`, `highlightDelay`, `cancelTravel` or `quickTapFlash` from the next touch. The recognizer's arena plumbing (`arena`, `pending`, touch delivery, `applyState`, `resetToPossible` and the failure and simultaneity checks) is now `protected`. `attachTapHaptic` gives focus straight back from its hidden switch and adds none to a label that already labels another control.
+
+@vjeux

.changeset/gesture-host-fixes.md

@@ -0,0 +1,7 @@
+---
+'@astryxdesign/core': patch
+---
+
+[experimental] Gesture host fixes: a scroll the page makes under a still finger (scrollIntoView, a pinned transcript, scroll anchoring) no longer cancels the press or swallows its click; recognizers that never claim (`claimsTouches` false) get no blocking `touchmove` listener, and a finger's target listener is passive unless a recognizer on that touch can claim; a claimed pen holds only its own stylus touches; an element's own `touch-action` is never widened; content slotted into a shadow-tree scroller scrolls with it; the delegated press stays idle while the document press controller holds the same attribute.
+
+@vjeux

.changeset/gesture-host-owner.md

@@ -0,0 +1,7 @@
+---
+'@astryxdesign/core': patch
+---
+
+[experimental] The gesture host becomes the one document-level touch owner: `holdPageScroll(decide)` keeps a scroll lock's page still, `watchFingerScrolls` / `isFingerScroll` tell a finger's scroll from the program's, `fingersDown()` counts the fingers on the screen, and `addTouchGate(gate)` holds touches away from a presenting layer. A second finger landing anywhere gives a one-finger pan up so the browser can pinch, a press tracker created with `keepsTouch: true` (opt-in, for continuous-tracking controls) keeps its touch from the browser's pan once its press is delivered, and the host reads the writing direction through `isRtlElement`.
+
+@vjeux

.changeset/gesture-host.md

@@ -0,0 +1,7 @@
+---
+'@astryxdesign/core': patch
+---
+
+[chore] The gesture system's DOM host (claims, click suppression, the browser's takeover, the pointer behind a contact). Not exported from the package root; touch presentations reach it through the experimental subpaths (see their entry). No component uses it yet.
+
+@vjeux

.changeset/gesture-pan.md

@@ -0,0 +1,7 @@
+---
+'@astryxdesign/core': patch
+---
+
+[chore] The pan gesture recognizer, with UIKit's measured hysteresis and velocity filter. Not exported from the package root; touch presentations reach it through the experimental subpaths (see their entry). No component uses it yet.
+
+@vjeux

.changeset/gesture-press-tracking.md

@@ -0,0 +1,7 @@
+---
+'@astryxdesign/core': patch
+---
+
+[chore] UIControl press tracking with control and cell profiles, the shared press paint, delegated press tracking and the gesture hooks. Not exported from the package root; touch presentations reach them through the experimental subpaths (see their entry). No component uses them yet.
+
+@vjeux

.changeset/gesture-readme.md

@@ -0,0 +1,7 @@
+---
+'@astryxdesign/core': patch
+---
+
+[chore] 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] 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 root; touch presentations reach it through the experimental subpaths (see their entry). No component uses it yet.
+
+@vjeux

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

@@ -0,0 +1,7 @@
+---
+'@astryxdesign/core': patch
+---
+
+[chore] Swipe, pinch, rotation, screen-edge pan and hover gesture recognizers. Not exported from the package root; touch presentations reach them through the experimental subpaths (see their entry). No component uses them yet.
+
+@vjeux

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

@@ -0,0 +1,7 @@
+---
+'@astryxdesign/core': patch
+---
+
+[chore] Tap and long-press gesture recognizers with UIKit's measured thresholds. Not exported from the package root; touch presentations reach them through the experimental subpaths (see their entry). No component uses them yet.
+
+@vjeux

.changeset/gesture-watcher.md

@@ -0,0 +1,7 @@
+---
+'@astryxdesign/core': patch
+---
+
+[experimental] New recognizer option `claimsTouches: false` makes a watcher: it never claims a touch, so it gets only passive listeners and never delays a scroll, it runs alongside every other recognizer, and it follows a touch the browser takes for a scroll to the lift.
+
+@vjeux

.changeset/list-dividers-hide-on-press.md

@@ -0,0 +1,7 @@
+---
+'@astryxdesign/core': patch
+---
+
+[feat] In a `List` with `hasDividers`, a touch press hides the dividers on either side of the pressed row, so the pressed row reads as one unbroken highlight; both come back the moment the finger lifts, while the highlight fades. This applies under any finger (a coarse primary pointer); with a mouse the dividers stay drawn.
+
+@vjeux

.changeset/list-has-animated-changes.md

@@ -0,0 +1,7 @@
+---
+'@astryxdesign/core': patch
+---
+
+[feat] `List` gains `hasAnimatedChanges`. Under a finger (a coarse primary pointer, iOS and Android alike), when rows are inserted, removed or reordered, the rows that stay slide to their new places and new rows fade in once the rows sliding past have cleared them, on the spring an iOS table uses. A row that crosses rows moving the other way (a reorder) rides above them with the surface color behind it, as an iOS table's opaque cell does. A removed row collapses in place (a swiped one with its action showing) while the rows below slide up into its gap, as a deleted iOS table cell does. Page content below the list moves with its rows; `followingContent="stays"` keeps it still. With reduced motion on, nothing travels: rows cross-fade into place. Off by default; with a mouse nothing moves.
+
+@vjeux

.changeset/list-on-reorder.md

@@ -0,0 +1,7 @@
+---
+'@astryxdesign/core': patch
+---
+
+[feat] `List` takes `onReorder(fromIndex, toIndex)`: each row gets a reorder handle at its end, and `ListItem`'s new `isReorderDisabled` keeps a row in place. On a touch screen a finger held still on a handle picks up its row the way an iOS table's reorder control does (a flick on it still scrolls): the row follows the finger, the rows it passes slide out of its way, the page scrolls near the edges, and on release the row settles into its new place on UIKit's springs. A mouse drags a handle at once, and rows take their places without motion. From the keyboard, a handle's arrow keys, Home and End move its row, Space picks it up and Escape puts it back; every move is announced once it lands.
+
+@vjeux

.changeset/list-reorder-experimental.md

@@ -0,0 +1,7 @@
+---
+'@astryxdesign/core': patch
+---
+
+[experimental] `@astryxdesign/core/List/experimental` exports core `List`'s reorder session for lists whose rows are not `ListItem`s, outside the stable compatibility promise (it may change or be removed in a patch release): `useListReorder`, `ListReorderContext`, `ListReorderHandle` and `LIST_REORDER_FIXED_ROW_ATTRIBUTE`. Nothing is added to the package root or to the `List` subpath.
+
+@vjeux

.changeset/list-reorder-moves.md

@@ -0,0 +1,7 @@
+---
+'@astryxdesign/core': patch
+---
+
+[feat] A reorderable `List`'s handle, activated without a drag (a tap, a click, a screen reader's double tap), opens its row's moves: Move up, Move down, Move to top and Move to bottom, each offered only when it moves the row, so a row can be reordered with a single pointer and no drag. `ListItem`'s new `reorderLabel` names the handle of a row whose label is not plain text.
+
+@vjeux

.changeset/list-row-press-compositor.md

@@ -0,0 +1,7 @@
+---
+'@astryxdesign/core': patch
+---
+
+[fix] A list row's touch press release keeps fading while the page runs script. `ListItem`, `Item` and `TreeList` rows used to stay fully pressed after the finger lifted until the main thread was free, and every frame of the fade repainted the row; the release now runs on the compositor, with the same color, clock and curve as before. Under a finger, an interactive row's press paints on its `::before`: StyleX merges a row's own `::before` from `xstyle` with it property by property, so that decoration keeps the layer's `opacity: 0` and is hidden at rest (a `className` rule overrides only the properties it sets); put row decoration on `::after` or a child element. With a mouse or trackpad the row is unchanged: no layer and no new stacking context.
+
+@vjeux

.changeset/list-selection-hold.md

@@ -0,0 +1,8 @@
+---
+'@astryxdesign/core': patch
+'@astryxdesign/cli': patch
+---
+
+[feat] Under a finger, a list row tapped to push can stay selected while the pushed screen covers it, then deselect as the screen pops, as a UIKit table row does; with a mouse the hold is null and the press releases at the lift as before. `holdSelection(event.target)` from `@astryxdesign/core/utils` holds the `ListItem`, `Item` or `TreeList` row under an activation and returns a handle a navigation drives: `animate(1)` runs UIKit's in-transition deselect, `setProgress` follows an interactive pop, `end(false)` selects the row again after a cancelled pop, and `focus()` returns focus to the row, with a keyboard focus ring only when the user last used a keyboard. The deselect runs on the compositor. A divided list keeps the dividers around the held row hidden. The deselect's clock and curve are motion roles a theme can retune (`list.deselect.navigationPopMs`, `list.deselect.navigationPopCurve`, carried by `--motion-list-deselect-navigation-pop-ms` and `--motion-list-deselect-navigation-pop-curve`), and `astryx docs motion` lists them.
+
+@vjeux

.changeset/list-touch-row-heights.md

@@ -0,0 +1,7 @@
+---
+'@astryxdesign/core': patch
+---
+
+[feat] Under a finger (a coarse primary pointer, iOS and Android alike), `List` rows are as tall as iOS table rows: at least 52px, 62px with a description, and at least 44px in `density="compact"`, which used to put rows as short as 33px under a finger. Lists with markers (bullets, numbers, Markdown lists) are running text and keep their rows. Lists driven by a mouse or a trackpad are unchanged. A theme that sets `min-height` on `list-item` keeps its own value.
+
+@vjeux

.changeset/reduced-motion-record.md

@@ -0,0 +1,7 @@
+---
+'@astryxdesign/core': patch
+---
+
+[fix] The experimental touch animator follows design:reduced-motion. Under Reduce Motion every `animate` and `play` (travel or opacity, on a spring or any curve) becomes an opacity-only cross-fade of 200 ms on a coarse primary pointer, or for a call marked `touchRelease`, and completes at once on any other pointer; nothing moves, scales or springs, and travel lands with a plain style write while the element is transparent, never as an animated transform. `timing.reducedMotionCrossFadeMs` is now 200 ms and is no longer a theme role. The `reducedMotion` and `crossfade` call options are removed; `crossfadeAs` stays. `animator.reducedMotion()` reports the mode for feedback with no fade of its own, `reducedMotionFade()` gives the same fade to code beside the animator, and `reducedMotion.stylex.ts` holds its constants for StyleX transitions.
+
+@vjeux

.changeset/reorder-values.md

@@ -0,0 +1,7 @@
+---
+'@astryxdesign/core': patch
+---
+
+[chore] Internal: a table's reorder values in the UIKit constants table (the reorder control's claim, the slides, the drop's settle, the edge autoscroll steps, measured on iOS 26.2) and the reorder model that applies them. Not exported from the package entry point; no component uses them yet.
+
+@vjeux

.changeset/touch-experimental-subpaths.md

@@ -0,0 +1,7 @@
+---
+'@astryxdesign/core': patch
+---
+
+[experimental] Two experimental subpaths for building touch presentations, outside the stable compatibility promise (they may change or be removed in a patch release). `@astryxdesign/core/motion/experimental` exports the compositor animator (`createAnimator`, `useAnimator`), UIKit's spring, rubber-band and cubic-bézier math, `resolveMotion` (a motion role's value under the element's theme), and the UIKit constants table as the read-only `uikit` namespace. `@astryxdesign/core/gestures/experimental` exports UIKit-style gesture recognizers (tap, long press, pan, screen-edge pan, swipe, pinch, rotation, hover), `useGestureRecognizer`, `usePressTracker`, `useTouchPresentation`, `readTouchPresentation`, `playHaptic` and `attachTapHaptic`, with the `GestureArena` and `VelocityStrategy` types their options reach. Nothing is added to the package root or to any other subpath.
+
+@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. No shipped component reads the roles yet. `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-presentation.md

@@ -0,0 +1,7 @@
+---
+'@astryxdesign/core': patch
+---
+
+[feat] `presentation="adaptive"` on DropdownMenu, ContextMenu, MoreMenu, Selector and MultiSelector, and a DropdownMenu's default sub-menu drill-in, now use the theme's compact definition with a coarse primary pointer: a viewport narrower than the theme's `md` point (768px by default) or shorter than 500px. This is a behavior change. The old default was a bottom sheet at 768px wide and below on a coarse pointer. Now a coarse-pointer screen exactly 768px wide keeps the anchored popover, and a phone in landscape (wider than 768px but shorter than 500px) gets the bottom sheet and the drilled-in sub-menu. To pin a component's presentation regardless of the rule, pass `presentation="popover"` or `presentation="bottom-sheet"`. Mouse and keyboard users on desktop see no change, because every case requires a coarse pointer.
+
+@vjeux

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

@@ -0,0 +1,7 @@
+---
+'@astryxdesign/core': patch
+---
+
+[experimental] The gesture host takes the same selection lock: for a press-tracked control's contact, and for a recognizer created with the new `preventsTextSelection` option (`@astryxdesign/core/gestures/experimental`) when it would take the touch. It also covers a non-text input under the finger inside such an element (WebKit's own style makes every input selectable), and restores selection when the contact ends. Other pans leave their content selectable.
+
+@vjeux

.changeset/touch-selection-lock.md

@@ -0,0 +1,7 @@
+---
+'@astryxdesign/core': patch
+---
+
+[fix] Under a finger or pen, holding a control or a cell that shows the touch press (the press feedback surfaces) no longer starts text selection or the iOS callout, as on UIKit controls. Selection and the callout come back when the finger lifts. Text fields keep their selection, and a mouse keeps desktop selection.
+
+@vjeux

.changeset/tree-list-expand-motion.md

@@ -0,0 +1,8 @@
+---
+'@astryxdesign/core': patch
+'@astryxdesign/cli': patch
+---
+
+[feat] Under a finger (a coarse primary pointer, iOS and Android alike), a `TreeList` row's children slide out from under it as it expands, with the rows below moving down alongside and the chevron turning, and slide back under it as it collapses, as in an iOS outline list. They used to appear and vanish in a single frame. The motion runs on the compositor and keeps going while the page runs script; with reduced motion on, it cross-fades instead of moving. Trees driven by a mouse are unchanged. The outline spring, and the spring of a list's row updates, are motion roles a theme can retune (`list.update.outlineSpring`, `list.update.tableSpring`, carried by `--motion-list-update-outline-spring` and `--motion-list-update-table-spring`), and `astryx docs motion` lists them.
+
+@vjeux

.changeset/tree-list-following-content.md

@@ -0,0 +1,7 @@
+---
+'@astryxdesign/core': patch
+---
+
+[feat] Under a finger, page content below a `TreeList` moves with a row's expand and collapse, on the same spring as the rows, instead of jumping. `followingContent="stays"` keeps it still for apps that manage that area themselves.
+
+@vjeux

.changeset/uikit-constants-table.md

@@ -0,0 +1,7 @@
+---
+'@astryxdesign/core': patch
+---
+
+[chore] 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.
+
+@vjeux

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

@@ -0,0 +1,7 @@
+---
+'@astryxdesign/core': patch
+---
+
+[chore] 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 root; touch presentations reach it through the experimental subpaths (see their entry).
+
+@vjeux

.changeset/uikit-motion-animator.md

@@ -0,0 +1,7 @@
+---
+'@astryxdesign/core': patch
+---
+
+[chore] A compositor animator for touch presentations. It plays UIKit's springs, scroll coasts 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 root; touch presentations reach it through the experimental subpaths (see their entry). No component uses it yet.
+
+@vjeux

.changeset/uikit-motion-math.md

@@ -0,0 +1,7 @@
+---
+'@astryxdesign/core': patch
+---
+
+[chore] 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 root; touch presentations reach it through the experimental subpaths (see their entry). No component uses it yet.
+
+@vjeux

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

@@ -0,0 +1,7 @@
+---
+'@astryxdesign/core': patch
+---
+
+[chore] 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 root; touch presentations reach it through the experimental subpaths (see their entry).
+
+@vjeux