@astryxdesign/core 0.7.7-canary.550ff21 → 0.7.7-canary.58c5b8a

package/src/motion/uikit/paging.ts

@@ -3,7 +3,8 @@
 /**
  * @file paging.ts
  * @input Nothing; data only
- * @output Exports `paging`, the measured constants of a paging UIScrollView
+ * @output Exports `paging`, the measured constants of a paging UIScrollView,
+ *   and `registerPagingTable`, which registers them with the motion registry
  * @position The paging domain of the UIKit constants table (motion/uikit). Only
  *   core reads it, so the `uikit` namespace does not re-export it
  *
@@ -12,6 +13,8 @@
  * - /packages/core/src/motion/paging.ts and paging.test.ts
  */
 
+import {registerMotionTable} from '../roles';
+
 export const paging = {
   /**
    * After the lift, one model moves the content: the settle onto the chosen
@@ -70,7 +73,8 @@ export const paging = {
   release: {
     /**
      * Released slower than `advanceSpeed`, the scroll view settles on the page
-     * nearest the content position: past half a page, the next one.
+     * nearest the content position: past half a page, the next one. The pager
+     * keeps the start page instead for a release that moves back toward it.
      * @source measured: UIKit lab, iOS 26.2 simulator, Oct 23 2026. In releases
      *   at rest from page 1, content at 48.5 % of the page stays, and 57.5 %
      *   goes to the next page. On a second 402 pt pager, 45 % stays and 55 %
@@ -121,9 +125,9 @@ export const paging = {
    */
   catchStopMs: 85,
   /**
-   * A horizontal pager's pan begins only for a drag within atan(1 ÷ this) of
-   * horizontal (26.6° for 2). A steeper drag goes to the vertical scroll around
-   * it. Between 26.6° and 45°, neither moves.
+   * In a sheet, a horizontal pager's pan begins only for a drag within atan(1 ÷
+   * this) of horizontal (26.6° for 2). A steeper drag goes to the sheet.
+   * Between 26.6° and 45°, neither moves.
    * @source measured: UIKit lab, iOS 26.2 simulator, Oct 23 2026. A scroll
    *   view's directional lock holds the major axis up to 25° and frees it from
    *   30°. An inline calendar pager in a sheet pages at 20° from horizontal. At
@@ -131,23 +135,36 @@ export const paging = {
    *   the sheet.
    */
   panAxisRatio: 2,
+  /**
+   * Inside a vertical scroll view, exactly one of the pager and the scroll view
+   * takes a drag, decided once by its dominant axis. The pager takes it when
+   * |dx| ≥ this × |dy|, 45° and the tie included. The scroll view takes any
+   * other drag.
+   * @source measured: UIKit lab, iOS 26.2 simulator, Oct 24 2026. A 402 × 300
+   *   paging view sits in a full-screen vertical scroll view, with 150 pt drags
+   *   at 0–90°. The pager takes 0–45°, and the page takes 50–90°. At 35°, the
+   *   outer view stays at 0 through 86 pt of vertical travel. The choice
+   *   happens at 10–15 pt of travel.
+   */
+  nestedPanAxisRatio: 1,
   animatedScroll: {
     /**
-     * `setContentOffset(_:animated:)` duration. It is the same for one page and
-     * for five, as for a page control's tap.
+     * `setContentOffset(_:animated:)` duration in milliseconds. It is the same
+     * for one page and for five, as for a page control's tap.
      * @source measured: UIKit lab, iOS 26.2 simulator, Oct 23 2026.
      *   `_contentOffsetAnimationDuration` reads 0.3, and five animated moves of
      *   1 to 5 pages each last 0.30 s.
      */
-    duration: 0.3,
+    durationMs: 300,
     /**
      * Its curve is a sinusoidal ease-in-out: x = from + (to − from) · (1 − cos
-     * πu) ÷ 2, for u = t ÷ duration.
+     * πu) ÷ 2, for u = t ÷ duration. This cubic bézier matches it to 0.02 % of
+     * the distance (0.09 pt over a 402 pt page).
      * @source measured: UIKit lab, iOS 26.2 simulator, Oct 23 2026. The five
      *   moves fit the sinusoid to 0.14–0.51 pt RMS, and a 2010 pt move fits to
      *   0.20 pt. The curve easeInEaseOut (0.42, 0, 0.58, 1) misses by 7.7 pt.
      */
-    curve: 'sineInOut',
+    curve: [0.364212, 0, 0.635788, 1],
   },
   /**
    * Past the first or last page, the content follows the finger through the
@@ -160,3 +177,17 @@ export const paging = {
    */
   rubberBandDimension: 'pageWidth',
 } as const;
+
+/**
+ * Registers this table with the motion registry (motion/roles.ts). The pager
+ * then reads `setContentOffset(_:animated:)`'s duration and curve through
+ * `resolveMotion`, as it reads every touch motion. The table lists no role,
+ * because no motion role names any of its values, so each plays as measured.
+ * Nothing registers on import, and a second call does nothing.
+ */
+export function registerPagingTable(): void {
+  registerMotionTable('paging', paging, {
+    // Who gets the touch, not how anything moves.
+    exclude: ['catchStopMs'],
+  });
+}

package/src/motion/uikit/progressBar.ts

@@ -4,11 +4,11 @@
  * @file progressBar.ts
  * @input Nothing: data only
  * @output Exports `progressBar` (UIProgressView's fill: the whole-track
- *   duration and curve, its minimum length and its empty alpha) and
- *   `registerProgressBarTable`
+ *   duration and curve, its minimum length and its empty alpha; and the
+ *   reduced-motion pulse) and `registerProgressBarTable`
  * @position ProgressBar's rows of the UIKit constants table (motion/uikit).
  *   Lengths are in pt (CSS px), durations in ms, alphas in 0..1. Tests check
- *   each leaf's `@source`.
+ *   each leaf's `@source`, and each GUESS's `@measure`.
  *
  * SYNC: When modified, update
  * /packages/core/src/ProgressBar/ProgressBarTouch.ts and
@@ -18,10 +18,11 @@
 import {registerMotionTable} from '../roles';
 
 /**
- * UIProgressView's values, for ProgressBar. Two values are motion roles in the
- * generated motion role table: the whole-track duration,
- * `progress.fillTrackMs`, and its curve, `progress.curves.fill`. Every other
- * value is an internal constant.
+ * UIProgressView's values, for ProgressBar. Three values are motion roles in
+ * the generated motion role table: the whole-track duration,
+ * `progress.fillTrackMs`, its curve, `progress.curves.fill`, and the
+ * reduced-motion pulse, `progress.reducedMotionPulseMs`. Every other value is
+ * an internal constant.
  */
 export const progressBar = {
   /**
@@ -43,6 +44,24 @@ export const progressBar = {
      */
     fill: [0, 0, 1, 1],
   },
+  /**
+   * Under reduced motion the indeterminate fill stops travelling and pulses
+   * its opacity in place. Each way takes this long, on the `timing.curves.move`
+   * curve. A busy loop, so tempo does not scale it.
+   * @source GUESS — An owner value, not a UIKit number. iOS Safari pulses its
+   *   indeterminate bar for 1 s between 0.30 and 0.60 opacity. ProgressBar
+   *   pulses slower, at a floor that keeps the bar visible.
+   * @measure M-PB1
+   */
+  reducedMotionPulseMs: 2000,
+  /**
+   * That pulse's lowest opacity. It is the lowest at which every tone that
+   * reaches 3:1 against the track at full opacity still does. That holds in
+   * the light and dark default themes.
+   * @source GUESS — An owner value, not a UIKit number.
+   * @measure M-PB1
+   */
+  reducedMotionPulseFloor: 0.84,
   progressView: {
     /**
      * The track's height in the `.default` style; the fill is as tall.
@@ -71,12 +90,13 @@ export const progressBar = {
 } as const;
 
 /**
- * Registers the table's two roles, for the generated motion role table and its
- * test, which call it. Nothing at runtime reads the registry: `resolveMotion`
- * returns the table value. Idempotent, and nothing runs on import.
+ * Registers the table's three roles, for the generated motion role table and
+ * its test, which call it. Nothing at runtime reads the registry:
+ * `resolveMotion` returns the table value. Idempotent, and nothing runs on
+ * import.
  */
 export function registerProgressBarTable(): void {
   registerMotionTable('progress', progressBar, {
-    roles: ['fillTrackMs', 'curves.fill'],
+    roles: ['fillTrackMs', 'curves.fill', 'reducedMotionPulseMs'],
   });
 }

package/src/motion/uikit/segmented.ts

@@ -0,0 +1,74 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/**
+ * @file segmented.ts
+ * @input Nothing; data only
+ * @output Exports `segmentedControl`, UISegmentedControl's selection slide
+ *   spring and its drag overshoot; and `registerSegmentedTable`, which
+ *   registers the spring as an internal motion role
+ * @position The segmented-control domain of the UIKit constants table
+ *   (motion/uikit); read by SegmentedControl's touch presentation
+ *
+ * SYNC: When modified, update:
+ * - /packages/core/src/SegmentedControl/useSegmentedSelectionMotion.ts
+ * - /packages/core/src/motion/README.md (domain list)
+ */
+
+import {registerMotionTable} from '../roles';
+
+/**
+ * UIKit's own UISegmentedControl, measured with three text segments in a
+ * 300 × 31 pt control. A tap and a programmatic change follow the same
+ * spring. Every leaf carries a `@source`, and uikit.test.ts checks it.
+ *
+ * Some UIKit motion is left out on purpose. UIKit cross-fades the two titles
+ * that change, over 0.2 s. Astryx switches them at once, because a
+ * cross-fade needs a second copy of each title. Under Reduce Motion, UIKit's
+ * lens fades in at the new segment and scales from 0.88. Astryx allows no
+ * scaling there, so the animator's Reduce Motion cross-fade replaces it.
+ * UIKit's lens also lifts and stretches under a finger. A theme role owns
+ * the lift, and the stretch is not modeled. The lens chases a dragging
+ * finger on the shared `springs.fingerTracking` role, which matches the
+ * values UIKit reports for this control.
+ */
+export const segmentedControl = {
+  /**
+   * The selection indicator's slide from the old segment to the new one,
+   * after a tap or a programmatic change. Its response is 0.40 s and its
+   * damping ratio 0.85. That gives about 1.25 pt of overshoot on a 200 pt
+   * move, settled by about 0.6 s. The width follows the same spring when the
+   * segments differ in width.
+   * @source measured: UIKit lab (injected host app), iOS 26.2 simulator,
+   *   iPhone 17 Pro, UIViewSpringAnimationBehavior read on the lens position
+   *   for a tap and a programmatic set (dampingRatio 0.85, response 0.40,
+   *   tracking off), Oct 23 2026
+   * @source measured: UIKit lab (injected host app), iOS 26.2 simulator,
+   *   iPhone 17 Pro, per-frame log of the lens's presentation position and
+   *   velocity (method C) for a tap, a programmatic set and an animated set,
+   *   least-squares spring fit (response 0.395 / 0.405 / 0.400 s, damping
+   *   ratio 0.855 / 0.845 / 0.850, rms at most 0.65 pt over 200 pt),
+   *   Oct 23 2026
+   */
+  selectionSpring: {response: 0.4, dampingRatio: 0.85},
+  /**
+   * How far past the first or last segment's center the lens follows a
+   * dragging finger, in pt. Beyond that, the lens stays put while the finger
+   * goes on.
+   * @source measured: UIKit lab (injected host app), iOS 26.2 simulator,
+   *   iPhone 17 Pro, a drag 60 pt past the last segment: the lens stops about
+   *   11 pt past its center (312 vs 301), Oct 23 2026
+   */
+  dragOvershoot: 11,
+} as const;
+
+/**
+ * Registers this table with the motion registry (motion/roles.ts). The
+ * slide's spring becomes an internal motion role. The drag overshoot is not
+ * motion, so it stays an internal constant. Nothing registers on import, and
+ * a second call does nothing.
+ */
+export function registerSegmentedTable(): void {
+  registerMotionTable('segmented', segmentedControl, {
+    roles: ['selectionSpring'],
+  });
+}

package/src/motion/uikit/springs.ts

@@ -15,11 +15,11 @@
  * that will confirm or replace them (MEASUREMENTS.md lists them all).
  * uikit.test.ts enforces both.
  *
- * Most springs are measured on iOS 26.2 or documented by Apple; two are still
- * GUESSES (`segmentedThumb`, `banner`) and two come from WebKit
- * (`switchThumbMove`, `switchThumbStretch`). A guess starts from the
- * nearest sourced spring and names it, so a component built on the table
- * gets the right value the moment its measurement lands, without changing.
+ * Most springs are measured on iOS 26.2 or documented by Apple; one is still
+ * a GUESS (`banner`). `switchThumbMove` is the switch's measured travel,
+ * which uikit/switch.ts reads. A guess starts from the nearest sourced
+ * spring and names it. A component built on the table gets the measured
+ * value the moment it lands, without changing.
  *
  * Press highlight in/out are fades, not springs: see timing.ts.
  *
@@ -388,44 +388,16 @@ export const MENU_REDUCED_MOTION_SPRING = {
 // ---------------------------------------------------------------------
 
 /**
- * UISwitch thumb travelling between off and on.
- * @source webkit Source/WebCore/rendering/cocoa/RenderThemeCocoa.mm
- *   `thumbMoveSpring = SpringSolver(1.0, 438.649…, 31.4159…)`, "Values
- *   chosen for consistency with UIKit" (= response 0.30 s, ratio 0.75);
- *   its settling duration is WebKit's iOS switch duration 0.48801 s
- *   (RenderThemeIOS.h). These are WebKit's iOS 18 values: UIKit's own
- *   switch frames differ, and a switch reads its measured table instead.
- * @measure M-SW02
+ * UISwitch thumb travelling between off and on, measured: the switch table's
+ * `travel` reads this row, so the value has one home.
+ * @source measured: UIKit lab (injected host app), iOS 26.2 simulator,
+ *   iPhone 17 Pro, the lens's position behavior read on a tap (damping 1,
+ *   response 0.3); the lens center after a 50 ms tap and after a 1 s hold
+ *   fits one spring at 0.31 / 1 (rms 0.11 pt), Oct 23 2026
  */
 export const SWITCH_THUMB_MOVE_SPRING = {
   response: 0.3,
-  dampingRatio: 0.75,
-} as const;
-
-/**
- * UISwitch thumb stretching while pressed and relaxing on release.
- * @source webkit Source/WebCore/rendering/cocoa/RenderThemeCocoa.mm
- *   `thumbPressSpring = SpringSolver(1.0, 322.272…, 31.2364…)`, "Values
- *   chosen for consistency with UIKit" (= response 0.35 s, ratio 0.87);
- *   settles in WebKit's held duration 0.50740 s (RenderThemeIOS.h). As
- *   for `switchThumbMove`, UIKit's own frames differ.
- * @measure M-SW03
- */
-export const SWITCH_THUMB_STRETCH_SPRING = {
-  response: 0.35,
-  dampingRatio: 0.87,
-} as const;
-
-/**
- * UISegmentedControl selection thumb sliding to a new segment.
- * @source GUESS — WebKit's UIKit-matched switch thumb spring, the nearest
- *   sourced control thumb
- * @measure M-SG02
- * @measure M-SG03
- */
-export const SEGMENTED_THUMB_SPRING = {
-  response: 0.3,
-  dampingRatio: 0.75,
+  dampingRatio: 1,
 } as const;
 
 // ---------------------------------------------------------------------
@@ -517,8 +489,6 @@ export const springs = {
   contextMenuMorph: CONTEXT_MENU_MORPH_SPRING,
   menuReducedMotion: MENU_REDUCED_MOTION_SPRING,
   switchThumbMove: SWITCH_THUMB_MOVE_SPRING,
-  switchThumbStretch: SWITCH_THUMB_STRETCH_SPRING,
-  segmentedThumb: SEGMENTED_THUMB_SPRING,
   keyboard: KEYBOARD_SPRING,
   banner: BANNER_SPRING,
   sliderRelease: SLIDER_RELEASE_SPRING,

package/src/motion/uikit/switch.ts

@@ -0,0 +1,174 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/**
+ * @file switch.ts
+ * @input The springs table's measured switch travel (springs.ts)
+ * @output Exports `switchControl`: UISwitch's geometry, the springs of its
+ *   Liquid Glass thumb and of its track color, the drag's rubber band and
+ *   flip distance, and the release timing
+ * @position The switch domain of the UIKit constants table (motion/uikit)
+ *
+ * The values are UISwitch's on iOS 26.2, read in a UIKit host app on the
+ * simulator. Lengths are in pt (CSS px). uikit.test.ts checks each `@source`.
+ *
+ * SYNC: When modified, update /packages/core/src/motion/MEASUREMENTS.md.
+ */
+
+import {registerMotionTable} from '../roles';
+import {SWITCH_THUMB_MOVE_SPRING} from './springs';
+
+/**
+ * UISwitch on iOS 26.2. Under a finger its white thumb lifts into a clear
+ * glass lens, and a drag moves it with a rubber band. The track colour slides
+ * on a spring of its own. UISwitch plays no haptic.
+ */
+export const switchControl = {
+  /**
+   * The control's size (width × height): the track.
+   * @source measured: UIKit lab (injected host app), iOS 26.2 simulator,
+   *   iPhone 17 Pro, `UISwitch` frame 63 × 28 (intrinsic 61 × 28), track view
+   *   63 × 28 with corner radius 14, Oct 23 2026
+   */
+  trackSize: [63, 28],
+  /**
+   * The thumb at rest (width × height), inset equally from the track's top,
+   * bottom and nearer end; it never changes size between off and on.
+   * @source measured: UIKit lab (injected host app), iOS 26.2 simulator,
+   *   iPhone 17 Pro, `_UILiquidLensView` frame 37 × 24 at x 2 (off) and
+   *   x 24 (on) inside the 63 × 28 track, Oct 23 2026
+   */
+  thumbSize: [37, 24],
+  /**
+   * The thumb lifted under a finger (width × height). The lens grows about
+   * its own center, past the track, and holds this size while the finger
+   * stays down.
+   * @source measured: UIKit lab (injected host app), iOS 26.2 simulator,
+   *   iPhone 17 Pro, lens bounds settled at 58 × 38.33 during a 1 s hold
+   *   (center unmoved), Oct 23 2026
+   */
+  liftedThumbSize: [58, 38.333],
+  /**
+   * The lift: the thumb growing to `liftedThumbSize` while its white fill
+   * fades out and the clear glass fades in (one spring drives all three).
+   * Starts with the touch outside a scroll view, after its content delay
+   * inside one. UISwitch keeps it under Reduce Motion; core's Switch does not
+   * lift then.
+   * @source measured: UIKit lab (injected host app), iOS 26.2 simulator,
+   *   iPhone 17 Pro, per-frame lens bounds during a 1 s hold fitted with one
+   *   spring for width and height (rms 0.29 pt; the fill's and the glass's
+   *   opacity overshoot by the same 13 %; the lens's settings read on a tap
+   *   say damping 0.625, response 0.27, whose 8 % overshoot is short of the
+   *   frames' 12 %), Oct 23 2026
+   */
+  lift: {response: 0.23, dampingRatio: 0.55},
+  /**
+   * The settle after the finger lifts: the lens shrinking back to
+   * `thumbSize` while the white fill returns over the glass.
+   * @source measured: UIKit lab (injected host app), iOS 26.2 simulator,
+   *   iPhone 17 Pro, the lens's spring settings read on a tap (damping 0.7,
+   *   response 0.5); per-frame lens bounds after the lift of a 1 s hold fit
+   *   one spring at 0.49 / 0.70 (rms 0.065 pt; the opacities undershoot by
+   *   the same 4.5 %), Oct 23 2026
+   */
+  settle: {response: 0.5, dampingRatio: 0.7},
+  /**
+   * The settle never starts sooner than this after the lift began, so a
+   * quick tap still shows the lifted lens, in ms.
+   * @source measured: UIKit lab (injected host app), iOS 26.2 simulator,
+   *   iPhone 17 Pro, a 50 ms tap: the lift→settle hand-off fitted at 235 ms
+   *   after the lift began (rms 0.33 pt), Oct 23 2026
+   * @measure M-SW07
+   */
+  minimumLiftMs: 235,
+  /**
+   * The thumb travelling to the committed end after a release or a
+   * programmatic change. It starts from the thumb's own velocity.
+   * @source measured: UIKit lab (injected host app), iOS 26.2 simulator,
+   *   iPhone 17 Pro, the lens's position behavior read on a tap (damping 1,
+   *   response 0.3); the lens center after a 50 ms tap and after a 1 s hold
+   *   fits one spring at 0.31 / 1 (rms 0.11 pt), Oct 23 2026; the springs
+   *   table's `SWITCH_THUMB_MOVE_SPRING` holds the one value
+   */
+  travel: SWITCH_THUMB_MOVE_SPRING,
+  /**
+   * During a drag the thumb chases the finger: each move retargets this
+   * spring at the finger's position, rubber-banded past either end.
+   * @source measured: UIKit lab (injected host app), iOS 26.2 simulator,
+   *   iPhone 17 Pro, a 4 s drag off → on → past both ends: the lens center
+   *   simulated as this spring chasing the rubber-banded finger fits every
+   *   frame (rms 0.21 pt), Oct 23 2026
+   */
+  tracking: {response: 0.36, dampingRatio: 1},
+  /**
+   * The drag's rubber band past either end: UIScrollView's
+   * `(1 − 1 ÷ (x·c ÷ d + 1))·d`. The coefficient c and the dimension d are in
+   * pt for the 28 pt control. Scale d with the track height.
+   * @source measured: UIKit lab (injected host app), iOS 26.2 simulator,
+   *   iPhone 17 Pro, the same drag fit: c 0.55, d 11.75–12 pt, the
+   *   translation measured from where the finger landed, Oct 23 2026
+   */
+  rubberBand: {coefficient: 0.55, dimension: 12},
+  /**
+   * A drag flips the switch by the finger, not the thumb. Once the finger is
+   * this far from where it landed, toward the other end, the switch shows
+   * the other side. The distance is the track width minus the thumb width
+   * (63 − 37 pt). Back past where it landed, the starting side shows again.
+   * Flips happen on touch events only, so a fast swipe flips on the lift.
+   * @source measured: UIKit lab (injected host app), iOS 26.2 simulator,
+   *   iPhone 17 Pro, `UISwitchModernVisualElement` ivars per frame and the
+   *   "SwitchWellPosition" springs during 1 pt-step drags: the same 26 pt for
+   *   presses at x 8, 20.5 and 45, with and without a 400 ms hold, mirrored
+   *   on an on switch; flipping back at the press point, Oct 23 2026
+   */
+  flipDistance: 26,
+  /**
+   * The track color turning on: the well image sliding in on a critically
+   * damped spring, starting when the switch flips (the lift of a tap).
+   * @source measured: UIKit lab (injected host app), iOS 26.2 simulator,
+   *   iPhone 17 Pro, `CASpringAnimation` "SwitchWellPosition" read: mass 1,
+   *   stiffness 85.377, damping 18.480 (response 0.68 s), Oct 23 2026
+   */
+  wellOn: {mass: 1, stiffness: 85.37720070146501, damping: 18.47995678582231},
+  /**
+   * The track color turning off: the same well sliding back, faster.
+   * @source measured: UIKit lab (injected host app), iOS 26.2 simulator,
+   *   iPhone 17 Pro, `CASpringAnimation` "SwitchWellPosition" read: mass 1,
+   *   stiffness 246.740, damping 31.416 (response 0.40 s), Oct 23 2026
+   */
+  wellOff: {mass: 1, stiffness: 246.74011002723395, damping: 31.41592653589793},
+  /**
+   * The lifted lens's drop shadow: y offset and radius in pt, then black
+   * alpha; none at rest.
+   * @source measured: UIKit lab (injected host app), iOS 26.2 simulator,
+   *   iPhone 17 Pro, the lens layer's presented `shadowOffset` (0, 7),
+   *   `shadowRadius` 3, `shadowOpacity` 0.12 once lifted, 0 at rest,
+   *   Oct 23 2026
+   */
+  liftedShadow: [7, 3, 0.12],
+  /**
+   * UISwitch plays no haptic on a tap, a hold or a drag.
+   * @source measured: UIKit lab (injected host app), iOS 26.2 simulator,
+   *   iPhone 17 Pro, every `UIFeedbackGenerator` entry point hooked: no call
+   *   on tap, hold, drag or flip, Oct 23 2026
+   */
+  haptic: 'none',
+} as const;
+
+/**
+ * Registers the switch table's motion roles as internal roles. Nothing
+ * registers on import: Switch's touch presentation calls it once before its
+ * first animation, and a second call does nothing.
+ */
+export function registerSwitchTable(): void {
+  registerMotionTable('switchControl', switchControl, {
+    roles: [
+      'lift',
+      'settle',
+      'travel',
+      'tracking',
+      'wellOn',
+      'wellOff',
+      'minimumLiftMs',
+    ],
+  });
+}

package/src/privateAttributes/pressGroupItem.stylex.ts

@@ -0,0 +1,23 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+/**
+ * @file privateAttributes/pressGroupItem.stylex.ts
+ * @input Nothing: the private press-group-item attribute
+ * @output pressGroupItemProps, which marks an action a group's tracker
+ *   follows, and isTrackedByGroup, which reads the mark
+ * @position Owner module of the private press-group-item attribute: the only
+ *   file that writes its name. AlertDialog marks its actions, and the press
+ *   controller (utils/pressFeedback.ts) leaves their press to the group's
+ *   tracker. No package entry exports it.
+ */
+
+const PRESS_GROUP_ITEM = 'data-astryx-press-group-item';
+
+/** Spread on each action that a group's tracker follows. */
+export const pressGroupItemProps: Readonly<Record<string, string>> = {
+  [PRESS_GROUP_ITEM]: '',
+};
+
+/** Whether a group's tracker paints the press on `element` or an ancestor. */
+export function isTrackedByGroup(element: Element): boolean {
+  return element.closest(`[${PRESS_GROUP_ITEM}]`) != null;
+}

package/src/privateAttributes/pressHoldsDrag.stylex.ts

@@ -0,0 +1,28 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+/**
+ * @file privateAttributes/pressHoldsDrag.stylex.ts
+ * @input Whether a pressable's own drag moves under the finger
+ * @output pressHoldsDragProps, which marks such a pressable, and
+ *   holdsPressThroughDrag, which reads the mark
+ * @position Owner module of the private press-holds-drag attribute: the only
+ *   file that writes its name. Switch marks its row; the press controller
+ *   (utils/pressFeedback.ts) keeps the press painted through that row's
+ *   drag. No package entry exports it.
+ */
+
+const PRESS_HOLDS_DRAG = 'data-astryx-press-holds-drag';
+
+/**
+ * Spread on a pressable whose own drag the finger moves, such as a Switch's
+ * thumb. The drag is not a scroll, so the press stays painted.
+ */
+export function pressHoldsDragProps(
+  holdsDrag: boolean,
+): Readonly<Record<string, string>> {
+  return holdsDrag ? {[PRESS_HOLDS_DRAG]: ''} : {};
+}
+
+/** Whether the press on `element` stays painted through its drag. */
+export function holdsPressThroughDrag(element: Element): boolean {
+  return element.hasAttribute(PRESS_HOLDS_DRAG);
+}

package/src/privateAttributes/segmentTitle.stylex.ts

@@ -0,0 +1,22 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/**
+ * @file privateAttributes/segmentTitle.stylex.ts
+ * @input Nothing
+ * @output segmentTitleProps, which marks a SegmentedControl segment's title,
+ *   and titleOfSegment, which finds that title in a segment
+ * @position Owner module of the private segment-title attribute: the only
+ *   file that writes its name. No package entry exports it.
+ */
+
+const SEGMENT_TITLE = 'data-astryx-segment-title';
+
+/** Spread on a segment's title: marks it for the touch layer. */
+export const segmentTitleProps: Readonly<Record<string, string>> = {
+  [SEGMENT_TITLE]: '',
+};
+
+/** The title inside `segment`, or null when the label is hidden. */
+export function titleOfSegment(segment: Element): HTMLElement | null {
+  return segment.querySelector<HTMLElement>(`[${SEGMENT_TITLE}]`);
+}