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

package/dist/motion/uikit/slider.d.ts

@@ -0,0 +1,97 @@
+/**
+ * UISlider's touch values: hit target, tracking, release coast, lift, drop
+ * and the end-of-track haptic.
+ */
+export declare 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
+     */
+    readonly 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
+     */
+    readonly 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
+     */
+    readonly releaseSpring: {
+        readonly response: 0.4;
+        readonly dampingRatio: 1;
+    };
+    /**
+     * 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
+     */
+    readonly 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
+     */
+    readonly 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
+     */
+    readonly 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
+     */
+    readonly liftSpring: {
+        readonly response: 0.215;
+        readonly 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
+     */
+    readonly dropSpring: {
+        readonly response: 0.5;
+        readonly 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
+     */
+    readonly endHaptic: "impactMedium";
+};
+//# sourceMappingURL=slider.d.ts.map

package/dist/motion/uikit/slider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slider.d.ts","sourceRoot":"","sources":["../../../src/motion/uikit/slider.ts"],"names":[],"mappings":"AAkBA;;;GAGG;AACH,eAAO,MAAM,MAAM;IACjB;;;;;;;;;OASG;;IAEH;;;;;;;;;OASG;;IAEH;;;;;;;;OAQG;;;;;IAEH;;;;;;OAMG;;IAEH;;;;;;;OAOG;;IAEH;;;;;OAKG;;IAEH;;;;;OAKG;;;;;IAEH;;;;;;;OAOG;;;;;IAEH;;;;;;;OAOG;;CAEK,CAAC"}

package/dist/motion/uikit/slider.js

@@ -0,0 +1,111 @@
+// 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.js";
+
+/**
+ * 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'
+};

package/dist/motion/uikit/springs.d.ts

@@ -338,36 +338,24 @@ export declare const MENU_REDUCED_MOTION_SPRING: {
     readonly dampingRatio: 1;
 };
 /**
- * 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 declare const SWITCH_THUMB_MOVE_SPRING: {
     readonly response: 0.3;
-    readonly dampingRatio: 0.75;
-};
-/**
- * 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 declare const SWITCH_THUMB_STRETCH_SPRING: {
-    readonly response: 0.35;
-    readonly dampingRatio: 0.87;
+    readonly dampingRatio: 1;
 };
 /**
  * UISegmentedControl selection thumb sliding to a new segment.
- * @source GUESS — WebKit's UIKit-matched switch thumb spring, the nearest
- *   sourced control thumb
+ * @source GUESS — WebKit's UIKit-matched switch thumb spring
+ *   (RenderThemeCocoa.mm `thumbMoveSpring`: response 0.30 s, ratio 0.75),
+ *   kept only until UISegmentedControl's measured spring replaces it;
+ *   UISwitch's measured travel (`SWITCH_THUMB_MOVE_SPRING`)
+ *   belongs to another control
  * @measure M-SG02
  * @measure M-SG03
  */
@@ -399,6 +387,39 @@ export declare const BANNER_SPRING: {
     readonly stiffness: 1000;
     readonly damping: 500;
 };
+/**
+ * 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 declare const SLIDER_RELEASE_SPRING: {
+    readonly response: 0.4;
+    readonly dampingRatio: 1;
+};
+/**
+ * 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 declare const SLIDER_LIFT_SPRING: {
+    readonly response: 0.215;
+    readonly dampingRatio: 0.6;
+};
+/**
+ * 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 declare const SLIDER_DROP_SPRING: {
+    readonly response: 0.5;
+    readonly dampingRatio: 0.7;
+};
 /**
  * Every spring above, by row name: the table the existing readers use. A
  * component imports only the rows it plays (`architecture:component-style-authoring`
@@ -530,11 +551,7 @@ export declare const springs: {
     };
     readonly switchThumbMove: {
         readonly response: 0.3;
-        readonly dampingRatio: 0.75;
-    };
-    readonly switchThumbStretch: {
-        readonly response: 0.35;
-        readonly dampingRatio: 0.87;
+        readonly dampingRatio: 1;
     };
     readonly segmentedThumb: {
         readonly response: 0.3;
@@ -550,9 +567,21 @@ export declare const springs: {
         readonly stiffness: 1000;
         readonly damping: 500;
     };
+    readonly sliderRelease: {
+        readonly response: 0.4;
+        readonly dampingRatio: 1;
+    };
+    readonly sliderLift: {
+        readonly response: 0.215;
+        readonly dampingRatio: 0.6;
+    };
+    readonly sliderDrop: {
+        readonly response: 0.5;
+        readonly dampingRatio: 0.7;
+    };
 };
 /**
- * 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/uikit/springs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"springs.d.ts","sourceRoot":"","sources":["../../../src/motion/uikit/springs.ts"],"names":[],"mappings":"AAmCA;;;;GAIG;AACH,eAAO,MAAM,aAAa;;;CAAsC,CAAC;AAEjE;;;GAGG;AACH,eAAO,MAAM,mBAAmB;;;CAAyC,CAAC;AAE1E;;;GAGG;AACH,eAAO,MAAM,eAAe;;;CAAwC,CAAC;AAErE;;;GAGG;AACH,eAAO,MAAM,sBAAsB;;;CAGzB,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,mBAAmB;;;CAA6C,CAAC;AAE9E;;;GAGG;AACH,eAAO,MAAM,oBAAoB;;;CAGvB,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,mBAAmB;;;CAAsC,CAAC;AAEvE;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,kBAAkB;;;;CAIrB,CAAC;AAMX;;;;;;;;;GASG;AACH,eAAO,MAAM,sBAAsB;;;CAA4C,CAAC;AAEhF;;;;GAIG;AACH,eAAO,MAAM,qBAAqB;;;CAA4C,CAAC;AAE/E;;;;;;GAMG;AACH,eAAO,MAAM,wCAAwC;;;CAG3C,CAAC;AAEX;;;;;GAKG;AACH,eAAO,MAAM,8BAA8B;;;CAGjC,CAAC;AAMX;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB;;;;CAIvB,CAAC;AAEX;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB;;;;CAIvB,CAAC;AAEX;;;;;;;;GAQG;AACH,eAAO,MAAM,mBAAmB;;;CAGtB,CAAC;AAEX;;;;;;;GAOG;AACH,eAAO,MAAM,yBAAyB;;;CAG5B,CAAC;AAEX;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B;;;CAG7B,CAAC;AAMX;;;;;;;;;;GAUG;AACH,eAAO,MAAM,oBAAoB;;;;CAIvB,CAAC;AAEX;;;;GAIG;AACH,eAAO,MAAM,oBAAoB;;;;CAIvB,CAAC;AAEX;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B;;;;CAI9B,CAAC;AAEX;;;;GAIG;AACH,eAAO,MAAM,2BAA2B;;;;CAI9B,CAAC;AAEX;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB;;;CAA+C,CAAC;AAE7E;;;;GAIG;AACH,eAAO,MAAM,iBAAiB;;;CAAgD,CAAC;AAE/E;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,oBAAoB;;;CAGvB,CAAC;AAEX;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,oBAAoB;;;CAA4C,CAAC;AAE9E;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB;;;CAG3B,CAAC;AAEX;;;;GAIG;AACH,eAAO,MAAM,2BAA2B;;;CAG9B,CAAC;AAEX;;;;;;;;;GASG;AACH,eAAO,MAAM,yBAAyB;;;CAG5B,CAAC;AAEX;;;;;;;;;GASG;AACH,eAAO,MAAM,0BAA0B;;;CAG7B,CAAC;AAMX;;;;;;;;;GASG;AACH,eAAO,MAAM,wBAAwB;;;CAG3B,CAAC;AAEX;;;;;;;;GAQG;AACH,eAAO,MAAM,2BAA2B;;;CAG9B,CAAC;AAEX;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB;;;CAGzB,CAAC;AAMX;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe;;;;CAIlB,CAAC;AAEX;;;;;GAKG;AACH,eAAO,MAAM,aAAa;;;;CAAoD,CAAC;AAE/E;;;;GAIG;AACH,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmCV,CAAC;AAwBX;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAI3C"}
+{"version":3,"file":"springs.d.ts","sourceRoot":"","sources":["../../../src/motion/uikit/springs.ts"],"names":[],"mappings":"AAmCA;;;;GAIG;AACH,eAAO,MAAM,aAAa;;;CAAsC,CAAC;AAEjE;;;GAGG;AACH,eAAO,MAAM,mBAAmB;;;CAAyC,CAAC;AAE1E;;;GAGG;AACH,eAAO,MAAM,eAAe;;;CAAwC,CAAC;AAErE;;;GAGG;AACH,eAAO,MAAM,sBAAsB;;;CAGzB,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,mBAAmB;;;CAA6C,CAAC;AAE9E;;;GAGG;AACH,eAAO,MAAM,oBAAoB;;;CAGvB,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,mBAAmB;;;CAAsC,CAAC;AAEvE;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,kBAAkB;;;;CAIrB,CAAC;AAMX;;;;;;;;;GASG;AACH,eAAO,MAAM,sBAAsB;;;CAA4C,CAAC;AAEhF;;;;GAIG;AACH,eAAO,MAAM,qBAAqB;;;CAA4C,CAAC;AAE/E;;;;;;GAMG;AACH,eAAO,MAAM,wCAAwC;;;CAG3C,CAAC;AAEX;;;;;GAKG;AACH,eAAO,MAAM,8BAA8B;;;CAGjC,CAAC;AAMX;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB;;;;CAIvB,CAAC;AAEX;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB;;;;CAIvB,CAAC;AAEX;;;;;;;;GAQG;AACH,eAAO,MAAM,mBAAmB;;;CAGtB,CAAC;AAEX;;;;;;;GAOG;AACH,eAAO,MAAM,yBAAyB;;;CAG5B,CAAC;AAEX;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B;;;CAG7B,CAAC;AAMX;;;;;;;;;;GAUG;AACH,eAAO,MAAM,oBAAoB;;;;CAIvB,CAAC;AAEX;;;;GAIG;AACH,eAAO,MAAM,oBAAoB;;;;CAIvB,CAAC;AAEX;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B;;;;CAI9B,CAAC;AAEX;;;;GAIG;AACH,eAAO,MAAM,2BAA2B;;;;CAI9B,CAAC;AAEX;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB;;;CAA+C,CAAC;AAE7E;;;;GAIG;AACH,eAAO,MAAM,iBAAiB;;;CAAgD,CAAC;AAE/E;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,oBAAoB;;;CAGvB,CAAC;AAEX;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,oBAAoB;;;CAA4C,CAAC;AAE9E;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB;;;CAG3B,CAAC;AAEX;;;;GAIG;AACH,eAAO,MAAM,2BAA2B;;;CAG9B,CAAC;AAEX;;;;;;;;;GASG;AACH,eAAO,MAAM,yBAAyB;;;CAG5B,CAAC;AAEX;;;;;;;;;GASG;AACH,eAAO,MAAM,0BAA0B;;;CAG7B,CAAC;AAMX;;;;;;;GAOG;AACH,eAAO,MAAM,wBAAwB;;;CAG3B,CAAC;AAEX;;;;;;;;;GASG;AACH,eAAO,MAAM,sBAAsB;;;CAGzB,CAAC;AAMX;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe;;;;CAIlB,CAAC;AAEX;;;;;GAKG;AACH,eAAO,MAAM,aAAa;;;;CAAoD,CAAC;AAE/E;;;;;;;;GAQG;AACH,eAAO,MAAM,qBAAqB;;;CAA4C,CAAC;AAE/E;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB;;;CAAgD,CAAC;AAEhF;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB;;;CAA8C,CAAC;AAE9E;;;;GAIG;AACH,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqCV,CAAC;AA6BX;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAI3C"}

package/dist/motion/uikit/springs.js

@@ -16,10 +16,10 @@
  * 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.
+ * GUESSES (`segmentedThumb`, `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.
  *
@@ -418,38 +418,25 @@ 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
-};
-
-/**
- * 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
+  dampingRatio: 1
 };
 
 /**
  * UISegmentedControl selection thumb sliding to a new segment.
- * @source GUESS — WebKit's UIKit-matched switch thumb spring, the nearest
- *   sourced control thumb
+ * @source GUESS — WebKit's UIKit-matched switch thumb spring
+ *   (RenderThemeCocoa.mm `thumbMoveSpring`: response 0.30 s, ratio 0.75),
+ *   kept only until UISegmentedControl's measured spring replaces it;
+ *   UISwitch's measured travel (`SWITCH_THUMB_MOVE_SPRING`)
+ *   belongs to another control
  * @measure M-SG02
  * @measure M-SG03
  */
@@ -488,6 +475,42 @@ export const BANNER_SPRING = {
   damping: 500
 };
 
+/**
+ * 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
+};
+
+/**
+ * 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
+};
+
+/**
+ * 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
+};
+
 /**
  * Every spring above, by row name: the table the existing readers use. A
  * component imports only the rows it plays (`architecture:component-style-authoring`
@@ -524,14 +547,18 @@ 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
+  banner: BANNER_SPRING,
+  sliderRelease: SLIDER_RELEASE_SPRING,
+  sliderLift: SLIDER_LIFT_SPRING,
+  sliderDrop: SLIDER_DROP_SPRING
 };
 
 /**
- * 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 = {
@@ -549,11 +576,14 @@ const SPRING_ROLES = {
   subMenuBack: SUB_MENU_BACK_SPRING,
   contextMenuLift: CONTEXT_MENU_LIFT_SPRING,
   contextMenuDismiss: CONTEXT_MENU_DISMISS_SPRING,
-  contextMenuMorph: CONTEXT_MENU_MORPH_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/uikit/switch.d.ts

@@ -0,0 +1,166 @@
+/**
+ * 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 declare 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
+     */
+    readonly trackSize: readonly [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
+     */
+    readonly thumbSize: readonly [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
+     */
+    readonly liftedThumbSize: readonly [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
+     */
+    readonly lift: {
+        readonly response: 0.23;
+        readonly 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
+     */
+    readonly settle: {
+        readonly response: 0.5;
+        readonly 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
+     */
+    readonly 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
+     */
+    readonly travel: {
+        readonly response: 0.3;
+        readonly dampingRatio: 1;
+    };
+    /**
+     * 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
+     */
+    readonly tracking: {
+        readonly response: 0.36;
+        readonly 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
+     */
+    readonly rubberBand: {
+        readonly coefficient: 0.55;
+        readonly 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
+     */
+    readonly 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
+     */
+    readonly wellOn: {
+        readonly mass: 1;
+        readonly stiffness: 85.37720070146501;
+        readonly 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
+     */
+    readonly wellOff: {
+        readonly mass: 1;
+        readonly stiffness: 246.74011002723395;
+        readonly 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
+     */
+    readonly liftedShadow: readonly [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
+     */
+    readonly haptic: "none";
+};
+/**
+ * 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 declare function registerSwitchTable(): void;
+//# sourceMappingURL=switch.d.ts.map

package/dist/motion/uikit/switch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"switch.d.ts","sourceRoot":"","sources":["../../../src/motion/uikit/switch.ts"],"names":[],"mappings":"AAmBA;;;;GAIG;AACH,eAAO,MAAM,aAAa;IACxB;;;;;OAKG;;IAEH;;;;;;OAMG;;IAEH;;;;;;;OAOG;;IAEH;;;;;;;;;;;;OAYG;;;;;IAEH;;;;;;;;OAQG;;;;;IAEH;;;;;;;OAOG;;IAEH;;;;;;;;OAQG;;;;;IAEH;;;;;;;OAOG;;;;;IAEH;;;;;;;OAOG;;;;;IAEH;;;;;;;;;;;OAWG;;IAEH;;;;;;OAMG;;;;;;IAEH;;;;;OAKG;;;;;;IAEH;;;;;;;OAOG;;IAEH;;;;;OAKG;;CAEK,CAAC;AAEX;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAY1C"}