@astryxdesign/core 0.7.6 → 0.7.7-canary.0d1ddcd

package/src/motion/uikit/slider.ts

@@ -0,0 +1,105 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/**
+ * @file slider.ts
+ * @input Nothing: data only
+ * @output Exports `slider`: UISlider's hit target, tracking rule, release
+ *   coast, lift, drop and end haptic, measured on the iOS 26.2 simulator
+ * @position The slider domain of the UIKit constants table (motion/uikit).
+ *   Lengths are in pt (CSS px). Tests check each leaf's `@source`.
+ *
+ * SYNC: When modified, update:
+ * - /packages/core/src/Slider/sliderTouchController.ts
+ * - /packages/core/src/Slider/Slider.tsx
+ * - /packages/core/src/motion/uikit/slider.test.ts
+ */
+
+import {SLIDER_RELEASE_SPRING} from './springs';
+
+/**
+ * UISlider's touch values: hit target, tracking, release coast, lift, drop
+ * and the end-of-track haptic.
+ */
+export const slider = {
+  /**
+   * The thumb's touch target, a square in pt centered on the thumb. It is
+   * the 37 × 24 pt thumb grown by its hit edge insets: 12 pt above and
+   * below, 5.5 pt left and right. UIKit hit-tests inside the control's frame
+   * first, so the lab's 40 pt frame clipped it to 48 × 40.
+   * @source measured: UIKit lab, iOS 26.2 simulator, iPhone 17 Pro.
+   *   `_thumbHitEdgeInsets` reads {−12, −5.5, −12, −5.5}. Touch-downs on a
+   *   4 pt grid take the thumb from −24 to +20 pt in x. A track tap away
+   *   from the thumb moves nothing. Oct 23 2026
+   */
+  thumbHitTarget: 48,
+  /**
+   * Value range per track length of finger travel. The value moves by
+   * (max − min) × translation ÷ the track's full length. The translation
+   * counts from the pan's threshold: the touch-down point plus 10 pt along
+   * the track. 1 means one full range per track length.
+   * @source measured: UIKit lab, iOS 26.2 simulator, iPhone 17 Pro. In
+   *   drags at 120 to 2000 pt/s, each event's value is v0 plus the
+   *   translation past 10 pt ÷ 300. Past the max end, the value leaves 1
+   *   only once the finger comes back past where it reached 1. Oct 23 2026
+   */
+  trackingGain: 1,
+  /**
+   * The coast after the lift. The thumb and the value spring from where the
+   * finger left them to the projected target, with the release velocity.
+   * Critically damped, it never overshoots a target ahead of it.
+   * @source measured: UIKit lab, iOS 26.2 simulator, iPhone 17 Pro. The
+   *   `UIViewSpringAnimationBehavior` at the lift reads response 0.4 and
+   *   damping ratio 1. Four releases fit it per frame, at rms 0.11 pt or
+   *   less. Oct 23 2026
+   */
+  releaseSpring: SLIDER_RELEASE_SPRING,
+  /**
+   * The deceleration rate of the coast's momentum projection, per ms
+   * (WWDC18's `project`). It is not UIScrollView's normal rate (0.998), so
+   * pass it to the projection explicitly.
+   * @source measured: UIKit lab, iOS 26.2 simulator, iPhone 17 Pro. The
+   *   release behavior's projection deceleration reads 0.996. Oct 23 2026
+   */
+  releaseProjectionRate: 0.996,
+  /**
+   * How much of the projection the coast travels. The target is the lift
+   * value plus this share of the projected distance. A finger lifted outside
+   * the control's tracking bounds coasts back to the lift value instead.
+   * @source measured: UIKit lab, iOS 26.2 simulator, iPhone 17 Pro. The
+   *   release behavior's target smoothing reads 0.4. A 126.9 pt/s release
+   *   travels 12.56 pt, against 12.64 predicted. Oct 23 2026
+   */
+  releaseProjectionShare: 0.4,
+  /**
+   * The thumb's growth under a finger, uniform about its center (37 × 24 to
+   * 57.35 × 37.2 pt).
+   * @source measured: UIKit lab, iOS 26.2 simulator, iPhone 17 Pro. The lens
+   *   frame settled during an 800 ms hold. Oct 23 2026
+   */
+  liftScale: 1.55,
+  /**
+   * The lift: the thumb grows to `liftScale` when the finger lands.
+   * @source measured: UIKit lab, iOS 26.2 simulator, iPhone 17 Pro. The lens
+   *   width per frame in an 800 ms hold fits one spring at rms 0.31 pt.
+   *   Oct 23 2026
+   */
+  liftSpring: {response: 0.215, dampingRatio: 0.6},
+  /**
+   * The drop: the thumb shrinks back to its rest size when the finger lifts,
+   * while the coast runs.
+   * @source measured: UIKit lab, iOS 26.2 simulator, iPhone 17 Pro. The
+   *   lens's spring at the lift of an 800 ms hold reads response 0.5 s and
+   *   damping ratio 0.7. The width per frame fits it at rms 0.10 pt.
+   *   Oct 23 2026
+   */
+  dropSpring: {response: 0.5, dampingRatio: 0.7},
+  /**
+   * The feedback each time the value reaches an end, once per entry. It
+   * re-arms when the value leaves the end, in the drag and the coast. UIKit
+   * plays "Micro Tap Medium", and the web stand-in is the closest kind.
+   * @source measured: UIKit lab, iOS 26.2 simulator, iPhone 17 Pro. The
+   *   haptics log of drags into both ends shows the fluid slider generator's
+   *   "Micro Tap Medium" once per entry. Oct 23 2026
+   */
+  endHaptic: 'impactMedium',
+} as const;

package/src/motion/uikit/springs.ts

@@ -454,6 +454,33 @@ export const KEYBOARD_SPRING = {
  */
 export const BANNER_SPRING = {mass: 3, stiffness: 1000, damping: 500} as const;
 
+/**
+ * UISlider's release: after a finger lifts, the thumb settles on this spring
+ * toward 0.4 of the release's momentum projection. It is critically damped,
+ * so it never overshoots a target ahead of it.
+ * @source measured: UIKit lab, iOS 26.2 simulator, iPhone 17 Pro. The
+ *   `UIViewSpringAnimationBehavior` at the lift reads response 0.4 and
+ *   damping ratio 1. Four releases fit it per frame (the UIKit slider
+ *   table). Oct 23 2026
+ */
+export const SLIDER_RELEASE_SPRING = {response: 0.4, dampingRatio: 1} as const;
+
+/**
+ * UISlider's lift: a finger's touch-down scales the thumb up on this spring.
+ * @source measured: UIKit lab, iOS 26.2 simulator, iPhone 17 Pro. The
+ *   thumb's scale per frame after touch-down (the UIKit slider table).
+ *   Oct 23 2026
+ */
+export const SLIDER_LIFT_SPRING = {response: 0.215, dampingRatio: 0.6} as const;
+
+/**
+ * UISlider's drop: the lift's end scales the thumb back down on this spring.
+ * @source measured: UIKit lab, iOS 26.2 simulator, iPhone 17 Pro. The
+ *   thumb's scale per frame after the lift (the UIKit slider table).
+ *   Oct 23 2026
+ */
+export const SLIDER_DROP_SPRING = {response: 0.5, dampingRatio: 0.7} as const;
+
 /**
  * Every spring above, by row name: the table the existing readers use. A
  * component imports only the rows it plays (`architecture:component-style-authoring`
@@ -494,10 +521,15 @@ export const springs = {
   segmentedThumb: SEGMENTED_THUMB_SPRING,
   keyboard: KEYBOARD_SPRING,
   banner: BANNER_SPRING,
+  sliderRelease: SLIDER_RELEASE_SPRING,
+  sliderLift: SLIDER_LIFT_SPRING,
+  sliderDrop: SLIDER_DROP_SPRING,
 } as const;
 
 /**
- * The springs spec:AST-094 FR4 names: the only ones that are motion roles.
+ * The only springs that are motion roles. The touch presentations' record
+ * names some, and a component's own record names others, such as Slider's
+ * three. The generated motion role table lists each with its record.
  * The registry takes these rows alone, so registering ships no other spring.
  */
 const SPRING_ROLES = {
@@ -516,10 +548,13 @@ const SPRING_ROLES = {
   contextMenuLift: CONTEXT_MENU_LIFT_SPRING,
   contextMenuDismiss: CONTEXT_MENU_DISMISS_SPRING,
   contextMenuMorph: CONTEXT_MENU_MORPH_SPRING,
+  sliderRelease: SLIDER_RELEASE_SPRING,
+  sliderLift: SLIDER_LIFT_SPRING,
+  sliderDrop: SLIDER_DROP_SPRING,
 };
 
 /**
- * Registers the springs spec:AST-094 FR4 names as internal motion roles
+ * Registers the role springs (`SPRING_ROLES`) as internal motion roles
  * (motion/roles.ts), by their row names (`springs.settle`). Every other
  * spring, UIKit's menu spring under Reduce Motion and the keyboard's
  * included, is not a role. Nothing registers on import: the touch code that

package/dist/motion/selectPage.d.ts

@@ -1,26 +0,0 @@
-/**
- * @file selectPage.ts
- * @input A release (position, velocity), the page size and count, the
- *   current page
- * @output Exports `selectPage`: the page a paging release settles on
- * @position UIScrollView paging (`isPagingEnabled`) on the release policy
- *   (resolveSnapPoint.ts). Pure: no DOM, no React
- *
- * SYNC: When modified, update selectPage.test.ts.
- */
-import type { SnapSelection } from './projection.js';
-/**
- * UIScrollView paging (`isPagingEnabled`): the page a release settles on, at
- * most one page from `currentPage`, chosen by projecting the release with
- * the paging projection rate (uikit/scroll.ts; a GUESS until measured).
- * Pages are `pageSize` apart starting at 0.
- */
-export declare function selectPage({ position, velocity, pageSize, pageCount, currentPage, rate, }: {
-    position: number;
-    velocity: number;
-    pageSize: number;
-    pageCount: number;
-    currentPage: number;
-    rate?: number;
-}): SnapSelection;
-//# sourceMappingURL=selectPage.d.ts.map

package/dist/motion/selectPage.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"selectPage.d.ts","sourceRoot":"","sources":["../../src/motion/selectPage.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,cAAc,CAAC;AAIhD;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,EACzB,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,WAAW,EACX,IAAmC,GACpC,EAAE;IACD,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,aAAa,CAiBhB"}

package/dist/motion/selectPage.js

@@ -1,55 +0,0 @@
-// Copyright (c) Meta Platforms, Inc. and affiliates.
-
-/**
- * @file selectPage.ts
- * @input A release (position, velocity), the page size and count, the
- *   current page
- * @output Exports `selectPage`: the page a paging release settles on
- * @position UIScrollView paging (`isPagingEnabled`) on the release policy
- *   (resolveSnapPoint.ts). Pure: no DOM, no React
- *
- * SYNC: When modified, update selectPage.test.ts.
- */
-
-import { resolveSnapPoint } from "./resolveSnapPoint.js";
-import { scroll } from "./uikit/scroll.js";
-
-/**
- * UIScrollView paging (`isPagingEnabled`): the page a release settles on, at
- * most one page from `currentPage`, chosen by projecting the release with
- * the paging projection rate (uikit/scroll.ts; a GUESS until measured).
- * Pages are `pageSize` apart starting at 0.
- */
-export function selectPage({
-  position,
-  velocity,
-  pageSize,
-  pageCount,
-  currentPage,
-  rate = scroll.paging.projectionRate
-}) {
-  const points = Array.from({
-    length: Math.max(1, pageCount)
-  }, (_, i) => i * pageSize);
-  // The release policy (resolveSnapPoint.ts), with the paging rate as the
-  // seconds of velocity it projects, no flick and one page per release.
-  const {
-    index,
-    projected
-  } = resolveSnapPoint({
-    points,
-    position,
-    velocity,
-    flickThreshold: Infinity,
-    projection: {
-      seconds: rate / (1 - rate) / 1000
-    },
-    fromIndex: currentPage,
-    maxSteps: 1
-  });
-  return {
-    index,
-    value: points[index],
-    projected
-  };
-}

package/src/motion/selectPage.ts

@@ -1,55 +0,0 @@
-// Copyright (c) Meta Platforms, Inc. and affiliates.
-
-/**
- * @file selectPage.ts
- * @input A release (position, velocity), the page size and count, the
- *   current page
- * @output Exports `selectPage`: the page a paging release settles on
- * @position UIScrollView paging (`isPagingEnabled`) on the release policy
- *   (resolveSnapPoint.ts). Pure: no DOM, no React
- *
- * SYNC: When modified, update selectPage.test.ts.
- */
-
-import type {SnapSelection} from './projection';
-import {resolveSnapPoint} from './resolveSnapPoint';
-import {scroll} from './uikit/scroll';
-
-/**
- * UIScrollView paging (`isPagingEnabled`): the page a release settles on, at
- * most one page from `currentPage`, chosen by projecting the release with
- * the paging projection rate (uikit/scroll.ts; a GUESS until measured).
- * Pages are `pageSize` apart starting at 0.
- */
-export function selectPage({
-  position,
-  velocity,
-  pageSize,
-  pageCount,
-  currentPage,
-  rate = scroll.paging.projectionRate,
-}: {
-  position: number;
-  velocity: number;
-  pageSize: number;
-  pageCount: number;
-  currentPage: number;
-  rate?: number;
-}): SnapSelection {
-  const points = Array.from(
-    {length: Math.max(1, pageCount)},
-    (_, i) => i * pageSize,
-  );
-  // The release policy (resolveSnapPoint.ts), with the paging rate as the
-  // seconds of velocity it projects, no flick and one page per release.
-  const {index, projected} = resolveSnapPoint({
-    points,
-    position,
-    velocity,
-    flickThreshold: Infinity,
-    projection: {seconds: rate / (1 - rate) / 1000},
-    fromIndex: currentPage,
-    maxSteps: 1,
-  });
-  return {index, value: points[index], projected};
-}