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

package/dist/motion/uikit/switch.js

@@ -0,0 +1,186 @@
+// 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.js";
+import { SWITCH_THUMB_MOVE_SPRING } from "./springs.js";
+
+/**
+ * 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'
+};
+
+/**
+ * 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() {
+  registerMotionTable('switchControl', switchControl, {
+    roles: ['lift', 'settle', 'travel', 'tracking', 'wellOn', 'wellOff', 'minimumLiftMs']
+  });
+}

package/dist/privateAttributes/pressHoldsDrag.stylex.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @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.
+ */
+/**
+ * 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 declare function pressHoldsDragProps(holdsDrag: boolean): Readonly<Record<string, string>>;
+/** Whether the press on `element` stays painted through its drag. */
+export declare function holdsPressThroughDrag(element: Element): boolean;
+//# sourceMappingURL=pressHoldsDrag.stylex.d.ts.map

package/dist/privateAttributes/pressHoldsDrag.stylex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pressHoldsDrag.stylex.d.ts","sourceRoot":"","sources":["../../src/privateAttributes/pressHoldsDrag.stylex.ts"],"names":[],"mappings":"AACA;;;;;;;;;GASG;AAIH;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,OAAO,GACjB,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAElC;AAED,qEAAqE;AACrE,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAE/D"}

package/dist/privateAttributes/pressHoldsDrag.stylex.js

@@ -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) {
+  return holdsDrag ? {
+    [PRESS_HOLDS_DRAG]: ''
+  } : {};
+}
+
+/** Whether the press on `element` stays painted through its drag. */
+export function holdsPressThroughDrag(element) {
+  return element.hasAttribute(PRESS_HOLDS_DRAG);
+}

package/dist/utils/pressFeedback.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pressFeedback.d.ts","sourceRoot":"","sources":["../../src/utils/pressFeedback.ts"],"names":[],"mappings":"AAgDA;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,0BAA0B,CAAC;AAE3D;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,sBAAsB,CAAC;AAErD,qDAAqD;AACrD,eAAO,MAAM,cAAc,EAAE;IAAC,QAAQ,CAAC,CAAC,mBAAmB,CAAC,EAAE,EAAE,CAAA;CAE/D,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,OAAO,CAAC;AAwnB5C;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,IAAI,CA0BjD"}
+{"version":3,"file":"pressFeedback.d.ts","sourceRoot":"","sources":["../../src/utils/pressFeedback.ts"],"names":[],"mappings":"AAiDA;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,0BAA0B,CAAC;AAE3D;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,sBAAsB,CAAC;AAErD,qDAAqD;AACrD,eAAO,MAAM,cAAc,EAAE;IAAC,QAAQ,CAAC,CAAC,mBAAmB,CAAC,EAAE,EAAE,CAAA;CAE/D,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,OAAO,CAAC;AA4nB5C;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,IAAI,CA0BjD"}

package/dist/utils/pressFeedback.js

@@ -37,6 +37,7 @@ import { idlePressGesture, PRESS_FADE_MS, PRESS_FLASH_MS, PRESS_ONSET_MS, PRESS_
 import { isCoarsePointer, watchCoarsePointer } from "./coarsePointer.js";
 import { subscribeInput } from "./inputStream.js";
 import { TOUCH_QUERY } from "./touchPresentation.js";
+import { holdsPressThroughDrag } from "../privateAttributes/pressHoldsDrag.stylex.js";
 
 /**
  * The marker the controller finds with `closest()`. Every Astryx component
@@ -399,6 +400,10 @@ function onPointerMove(event) {
   if (live == null || live.pointerId != null && event.pointerId !== live.pointerId) {
     return;
   }
+  // The finger drags the surface's own control: its travel keeps the press.
+  if (holdsPressThroughDrag(live.element)) {
+    return;
+  }
   apply(finger, pressGestureStep(live.gesture, {
     kind: 'move',
     x: event.clientX,

package/dist/utils/selectionLock.d.ts

@@ -10,4 +10,47 @@ export declare function locksSelectionFor(pointerType: string): boolean;
  * any holder holds. Idempotent release.
  */
 export declare function lockSelection(elements: Iterable<Element>, target: EventTarget | null): () => void;
+/** How a drag's selection hold ends: at a lift, or at a cancel. */
+export interface DragSelectionReleaseOptions {
+    /**
+     * The press was cancelled (a pointercancel, a blur, a detach), so no
+     * mouseup or click follows: the hold ends at once. Called again after a
+     * lift, it ends the hold's last task at once too.
+     */
+    isCancel?: boolean;
+}
+/**
+ * Refuse a new selection while a mouse or pen drag that a recognizer claimed
+ * runs, until the returned function runs. `kept` is the page's selection
+ * when the press began, and it stays. Anything that replaces it while the
+ * drag runs is put back to it. That includes the press's own collapse and a
+ * selection the drag started before its claim. So the drag takes no new
+ * selection and never clears an existing one. `elements` refuse a
+ * selection with inline styles, on every engine. The document refuses one
+ * too, because WebKit extends a drag's selection over text outside the
+ * elements without another `selectstart`. So a `selectstart` anywhere is
+ * refused, and the selection is put back. A `selectstart` does not leave its
+ * shadow tree. So the document refuses only one that starts outside every
+ * shadow tree, and a claiming element inside one refuses its own. The
+ * press's own `mouseup` and `click` come after its `pointerup` in the same
+ * task, and WebKit settles the drag's selection there. So the document's
+ * hold ends a task after a lift. A cancel ends it at once, because nothing
+ * follows a cancel. `onReleased` runs once the document's hold has ended.
+ * The page listeners exist only during a press. Idempotent.
+ */
+export declare function lockDragSelection(elements: Iterable<Element>, view: Window | null | undefined, kept: ReadonlyArray<AbstractRange>, onReleased?: () => void): (options?: DragSelectionReleaseOptions) => void;
+/**
+ * The page's selection now, its ranges copied; none for a collapsed or empty
+ * one. A drag's hold keeps what this read when the press began.
+ */
+export declare function selectionRangesOf(view: Window | null | undefined): ReadonlyArray<AbstractRange>;
+/**
+ * Whether a press at (`x`, `y`) lands on text a drag would select. That is a
+ * text field, or a character of non-empty text whose element allows a
+ * selection. A native button's label, slotted or not, is not selectable text,
+ * because the engine starts no selection from a drag inside a button. A point
+ * beside text, which a caret query snaps to the nearest character, lands on
+ * none. Where the engine has no caret query, nothing is selectable text.
+ */
+export declare function startsOnSelectableText(doc: Document, x: number, y: number, target: EventTarget | null): boolean;
 //# sourceMappingURL=selectionLock.d.ts.map

package/dist/utils/selectionLock.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"selectionLock.d.ts","sourceRoot":"","sources":["../../src/utils/selectionLock.ts"],"names":[],"mappings":"AAkDA;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAE9D;AAWD;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,QAAQ,CAAC,OAAO,CAAC,EAC3B,MAAM,EAAE,WAAW,GAAG,IAAI,GACzB,MAAM,IAAI,CAyEZ"}
+{"version":3,"file":"selectionLock.d.ts","sourceRoot":"","sources":["../../src/utils/selectionLock.ts"],"names":[],"mappings":"AAoDA;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAE9D;AAWD;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,QAAQ,CAAC,OAAO,CAAC,EAC3B,MAAM,EAAE,WAAW,GAAG,IAAI,GACzB,MAAM,IAAI,CA4BZ;AAED,mEAAmE;AACnE,MAAM,WAAW,2BAA2B;IAC1C;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,QAAQ,CAAC,OAAO,CAAC,EAC3B,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAC/B,IAAI,EAAE,aAAa,CAAC,aAAa,CAAC,EAClC,UAAU,CAAC,EAAE,MAAM,IAAI,GACtB,CAAC,OAAO,CAAC,EAAE,2BAA2B,KAAK,IAAI,CA+EjD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC9B,aAAa,CAAC,aAAa,CAAC,CAiB9B;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,QAAQ,EACb,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,MAAM,EAAE,WAAW,GAAG,IAAI,GACzB,OAAO,CA+CT"}