@n-uf/motion 26.11.1 → 26.11.3

package/dist/chunk-NFQ4LIIR.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/gestures/types.ts","../src/gestures/modifiers.ts","../src/gestures/wheel.ts","../src/gestures/recognizer.ts","../src/gestures/coalescer.ts","../src/gestures/machine.ts","../src/gestures/dwell.ts"],"sourcesContent":["/**\n * Input types: plain event objects in, one gesture stream out. Nothing here\n * touches the DOM; the host copies the fields it needs out of PointerEvent /\n * WheelEvent / Safari's GestureEvent.\n *\n * Ported from the pdfized surface's input layer, whose recogniser this is.\n * Hit testing and routing (what is under a point, who gets a gesture) stay\n * with the host.\n */\n\nimport type { Point } from \"../shapes\";\n\nexport type PointerKind = \"mouse\" | \"pen\" | \"touch\";\n\n/** Pointer modifiers, ctrl included (the drag modifier may be \"ctrl\") */\nexport interface Modifiers {\n  shift: boolean;\n  alt: boolean;\n  meta: boolean;\n  ctrl: boolean;\n}\n\nexport type ModifierKey = keyof Modifiers;\n\n/** \"mac\": the drag modifier defaults to Cmd; \"other\": Alt (the OS keeps the Win/Super key) */\nexport type Platform = \"mac\" | \"other\";\n\nexport const NO_MODIFIERS: Readonly<Modifiers> = Object.freeze({ shift: false, alt: false, meta: false, ctrl: false });\n\n/**\n * A pointer as the gesture stream reports it (screen, canvas, kind, buttons,\n * modifiers) plus the fields a recogniser needs: which pointer, which button\n * changed, when.\n */\nexport interface SurfacePointer {\n  screen: Point; // CSS px relative to the host's view\n  canvas: Point; // the host's world units, through its camera at the time of the event (RecognizerOptions.toCanvas)\n  kind: PointerKind;\n  buttons: number; // PointerEvent.buttons bit mask\n  modifiers: Modifiers;\n  pointerId: number;\n  /** PointerEvent.button: 0 primary, 1 middle, 2 secondary (a pen's barrel button), 5 eraser; -1 none changed */\n  button: number;\n  time: number; // event timeStamp, ms\n  pressure?: number;\n}\n\n// ----------------------------------------------------------------------------\n// Raw events (copied out of DOM events by the host)\n// ----------------------------------------------------------------------------\n\nexport type RawPointerType = \"pointerdown\" | \"pointermove\" | \"pointerup\" | \"pointercancel\" | \"lostpointercapture\";\n\nexport interface RawPointerEvent {\n  type: RawPointerType;\n  pointerId: number;\n  pointerType: PointerKind | string; // unknown types are treated as mouse\n  isPrimary?: boolean;\n  button: number;\n  buttons: number;\n  screen: Point; // clientX/Y minus the view's origin\n  modifiers?: Partial<Modifiers>;\n  time: number;\n  pressure?: number;\n  /**\n   * lostpointercapture only: whose capture was lost. \"content\" (an element inside the view's content, e.g.\n   * right after the host took the pointer for a modifier-drag) leaves the gesture alone; default \"surface\".\n   */\n  lostBy?: \"surface\" | \"content\";\n}\n\nexport interface RawWheelEvent {\n  type: \"wheel\";\n  deltaX: number;\n  deltaY: number;\n  /** 0 pixels, 1 lines, 2 pages */\n  deltaMode: 0 | 1 | 2;\n  screen: Point;\n  modifiers?: Partial<Modifiers>;\n  time: number;\n}\n\n/** Safari's trackpad pinch (GestureEvent): scale is relative to the gesture's start */\nexport interface RawSafariGestureEvent {\n  type: \"gesturestart\" | \"gesturechange\" | \"gestureend\";\n  scale: number;\n  screen: Point;\n  modifiers?: Partial<Modifiers>;\n  time: number;\n}\n\nexport type RawInputEvent = RawPointerEvent | RawWheelEvent | RawSafariGestureEvent;\n\n// ----------------------------------------------------------------------------\n// The gesture stream\n// ----------------------------------------------------------------------------\n\n/** What a modifier-drag would do if the pointer travels with the drag modifier held */\nexport type ModifierDrag = \"move\" | \"resize\";\n\nexport type CancelReason =\n  | \"pointercancel\" // the browser or OS took the pointer (scroll, system gesture, palm rejection)\n  | \"lostcapture\" // pointer capture lost before the pointer went up\n  | \"multitouch\" // a second finger turned the press into a pinch\n  | \"missed-up\" // its pointerup never came (the same pointer pressed again, or another went down long after)\n  | \"escape\"\n  | \"reset\" // the view lost focus, the tool changed, the host was disposed\n  | (string & {});\n\ninterface PointerGestureBase {\n  pointer: SurfacePointer;\n  /** The press that started this gesture */\n  origin: SurfacePointer;\n}\n\nexport type InputGesture =\n  /** A pointer went down (one per gesture; a second touch becomes a pinch instead) */\n  | { type: \"press\"; pointer: SurfacePointer; modifierDrag: ModifierDrag | null }\n  /** The pointer travelled past the click threshold; modifierDrag is set when the drag modifier was held then */\n  | (PointerGestureBase & { type: \"dragStart\"; modifierDrag: ModifierDrag | null })\n  /** A move after dragStart (moves inside the threshold are not reported) */\n  | (PointerGestureBase & { type: \"move\" })\n  /** Held still past the long-press delay (touch and pen by default); at most once per press */\n  | (PointerGestureBase & { type: \"longPress\" })\n  /**\n   * The pointer went up. click: it never crossed the threshold and no long press fired;\n   * clickCount counts quick clicks at the same spot (2 = double click).\n   */\n  | (PointerGestureBase & { type: \"release\"; click: boolean; clickCount: number; dragged: boolean })\n  | (PointerGestureBase & { type: \"cancel\"; reason: CancelReason; dragged: boolean })\n  /** A pointer moving with no press (mouse and pen hover): cursor and chrome hover */\n  | { type: \"hover\"; pointer: SurfacePointer }\n  /**\n   * Two fingers (touch) or a trackpad pinch. scale is the change since the last update (multiply it in);\n   * pan is the centre's screen-px change since the last update. kind is what was recognised first.\n   */\n  | {\n      type: \"pinch\";\n      phase: \"start\" | \"update\" | \"end\" | \"cancel\";\n      source: \"touch\" | \"trackpad\";\n      kind: \"pinch\" | \"pan\";\n      center: { screen: Point; canvas: Point };\n      scale: number;\n      pan: Point;\n      modifiers: Modifiers;\n      time: number;\n    }\n  /** A wheel or trackpad scroll that is not a pinch: delta in screen px (lines and pages converted) */\n  | { type: \"scroll\"; delta: Point; at: { screen: Point; canvas: Point }; modifiers: Modifiers; time: number }\n  /**\n   * Zoom by a factor around a point: Cmd/Ctrl+wheel, a trackpad pinch reported as ctrl+wheel\n   * (Chrome, Firefox, Edge). Safari's trackpad pinch comes as \"pinch\" with source \"trackpad\".\n   */\n  | { type: \"zoom\"; factor: number; at: { screen: Point; canvas: Point }; modifiers: Modifiers; time: number };\n\nexport type InputGestureType = InputGesture[\"type\"];\n","/**\n * Modifier keys: event modifiers to one shape, and the drag modifier\n * resolved per platform (Cmd on macOS, Alt elsewhere; null turns it off).\n */\n\nimport { NO_MODIFIERS, type ModifierKey, type Modifiers, type Platform, type PointerKind } from \"./types\";\n\nexport function toModifiers(m: Partial<Modifiers> | undefined): Modifiers {\n  if (!m) return { ...NO_MODIFIERS };\n  return { shift: !!m.shift, alt: !!m.alt, meta: !!m.meta, ctrl: !!m.ctrl };\n}\n\n/** The default drag modifier: \"meta\" (Cmd) on macOS, \"alt\" elsewhere */\nexport function defaultDragModifier(platform: Platform): ModifierKey {\n  return platform === \"mac\" ? \"meta\" : \"alt\";\n}\n\n/**\n * A configured drag modifier as used: undefined → the platform default, null → off.\n */\nexport function resolveDragModifier(config: ModifierKey | null | undefined, platform: Platform): ModifierKey | null {\n  if (config === null) return null;\n  return config ?? defaultDragModifier(platform);\n}\n\nexport function isHeld(modifiers: Modifiers, key: ModifierKey | null): boolean {\n  return key !== null && modifiers[key];\n}\n\n/**\n * The button a press stands for on this platform. On macOS a Ctrl+click is the secondary click (the system's own\n * rule; the browser's contextmenu follows it), so a primary mouse press with Ctrl held is button 2 there, as a\n * right-click is. Not when Ctrl is the drag modifier (Ctrl+drag then moves). A pen, a finger and the other platforms\n * keep their button.\n */\nexport function platformButton(press: { kind: PointerKind; button: number; modifiers: Modifiers }, platform: Platform, dragModifier: ModifierKey | null): number {\n  return platform === \"mac\" && press.kind === \"mouse\" && press.button === 0 && press.modifiers.ctrl && dragModifier !== \"ctrl\" ? 2 : press.button;\n}\n\n/** Platform \"Mod\": Cmd on macOS, Ctrl elsewhere (Mod+wheel zooms, Mod+click is content's multi-select) */\nexport function modHeld(modifiers: Modifiers, platform: Platform): boolean {\n  return platform === \"mac\" ? modifiers.meta : modifiers.ctrl;\n}\n","/**\n * Wheel normalisation (Figma / tldraw style): lines and pages to pixels;\n * Cmd/Ctrl+wheel and the trackpad pinch (ctrl+wheel in Chrome, Firefox, Edge)\n * zoom by 2^(−dy / sensitivity); any other wheel scrolls, Shift turns\n * vertical into horizontal.\n */\n\nimport type { Point } from \"../shapes\";\nimport type { Modifiers } from \"./types\";\n\nexport interface WheelOptions {\n  /** px per line (deltaMode 1); default 40 */\n  lineHeight: number;\n  /** px per page (deltaMode 2); default 800 */\n  pageHeight: number;\n  /** zoom factor = 2^(−deltaY / sensitivity); default 300 */\n  zoomSensitivity: number;\n}\n\nexport const WHEEL_DEFAULTS: Readonly<WheelOptions> = Object.freeze({ lineHeight: 40, pageHeight: 800, zoomSensitivity: 300 });\n\nexport function wheelDeltaPx(deltaX: number, deltaY: number, deltaMode: 0 | 1 | 2, opts: WheelOptions = WHEEL_DEFAULTS): Point {\n  const k = deltaMode === 1 ? opts.lineHeight : deltaMode === 2 ? opts.pageHeight : 1;\n  return { x: finite(deltaX) * k, y: finite(deltaY) * k };\n}\n\nexport type WheelIntent = { kind: \"zoom\"; factor: number } | { kind: \"scroll\"; delta: Point };\n\n/**\n * What a wheel event means. Ctrl or Meta held: zoom (a trackpad pinch arrives as ctrl+wheel).\n * Otherwise scroll; with Shift a vertical-only delta scrolls horizontally (mice without a\n * horizontal wheel).\n */\nexport function classifyWheel(delta: Point, modifiers: Modifiers, opts: WheelOptions = WHEEL_DEFAULTS): WheelIntent {\n  if (modifiers.ctrl || modifiers.meta) {\n    const factor = Math.pow(2, -delta.y / (opts.zoomSensitivity > 0 ? opts.zoomSensitivity : WHEEL_DEFAULTS.zoomSensitivity));\n    return { kind: \"zoom\", factor: Number.isFinite(factor) && factor > 0 ? factor : 1 };\n  }\n  if (modifiers.shift && delta.x === 0) return { kind: \"scroll\", delta: { x: delta.y, y: 0 } };\n  return { kind: \"scroll\", delta };\n}\n\n/** Wheel pan damping for a camera that pans on scroll */\nexport interface WheelPanOptions {\n  /** Multiplier on the wheel's px; default 0.65 */\n  speed: number;\n  /** Linear up to this many px per event; default 30 */\n  threshold: number;\n  /** Hard cap per event, px; default 60 */\n  max: number;\n}\n\nexport const WHEEL_PAN_DEFAULTS: Readonly<WheelPanOptions> = Object.freeze({ speed: 0.65, threshold: 30, max: 60 });\n\n/**\n * The camera pan for one wheel scroll, per axis: speed × delta, linear up to the threshold, then\n * square-root damped (threshold + √(4 × excess)) and capped, so a fast flick of a free-spinning wheel or an\n * accelerated trackpad doesn't throw the canvas away.\n */\nexport function dampWheelPan(delta: Point, opts: WheelPanOptions = WHEEL_PAN_DEFAULTS): Point {\n  const one = (d: number) => {\n    const v = finite(d) * opts.speed;\n    const abs = Math.abs(v);\n    if (abs <= opts.threshold) return v;\n    return Math.sign(v) * Math.min(opts.threshold + Math.sqrt((abs - opts.threshold) * 4), opts.max);\n  };\n  return { x: one(delta.x), y: one(delta.y) };\n}\n\nfunction finite(v: number): number {\n  return Number.isFinite(v) ? v : 0;\n}\n","/**\n * The gesture recogniser: raw pointer, wheel and Safari gesture events (plain\n * objects) in, one stream of InputGesture out. Mouse, pen and touch share one\n * path; two fingers become a pinch (5 % scale or 10 px pan decides which, read\n * once both fingers have moved, so a pan's leading finger is no pinch); a\n * press becomes a drag only past a per-kind threshold, so a modifier+click\n * (Cmd/Ctrl+click to multi-select) stays a click for the content.\n *\n * One press at a time: a second mouse or pen while one is down is ignored, and\n * a second finger cancels the one-finger press (\"multitouch\") and starts a\n * pinch. After a pinch, the fingers left on the glass start nothing until all\n * are lifted.\n *\n * No DOM, no clock: timestamps come with the events and the long-press timer\n * is injected as the timer half of a ClockPort (without timers there is no\n * long press). The stale-press drop works from event timestamps, so it needs\n * no timer.\n */\n\nimport type { ClockPort } from \"../clock/port\";\nimport type { Point } from \"../shapes\";\nimport { isHeld, platformButton, toModifiers } from \"./modifiers\";\nimport type {\n  CancelReason,\n  InputGesture,\n  ModifierDrag,\n  ModifierKey,\n  Platform,\n  PointerKind,\n  RawInputEvent,\n  RawPointerEvent,\n  RawSafariGestureEvent,\n  RawWheelEvent,\n  SurfacePointer,\n} from \"./types\";\nimport { classifyWheel, WHEEL_DEFAULTS, wheelDeltaPx, type WheelOptions } from \"./wheel\";\n\n/** The timer half of a ClockPort: any clock (createBrowserClock, createFakeClock) is one. */\nexport type RecognizerTimers = Pick<ClockPort, \"setTimer\" | \"clearTimer\">;\n\nexport interface RecognizerOptions {\n  /** Screen px (relative to the view) to canvas units, through the current camera */\n  toCanvas: (screen: Point) => Point;\n  /** For the long press: a clock; without timers no long press fires */\n  timers?: RecognizerTimers;\n  /** The drag modifier, resolved (see resolveDragModifier); null = off */\n  dragModifier?: ModifierKey | null;\n  /** \"mac\": a mouse Ctrl+press is the secondary button, as the system has it (platformButton); default \"other\" */\n  platform?: Platform;\n  /** Click vs drag: a press becomes a drag after travelling more than this many screen px */\n  thresholds?: Partial<Record<PointerKind, number>>;\n  longPress?: { ms?: number; kinds?: readonly PointerKind[] };\n  /** Two clicks within ms and px of each other count as a double click */\n  multiClick?: { ms?: number; px?: number };\n  pinch?: { scaleThreshold?: number; panThreshold?: number };\n  wheel?: Partial<WheelOptions>;\n  /** A mouse or pen press, or a resting finger outside any gesture, untouched this long when another pointer goes down, lost its pointerup; default 1000 ms */\n  staleMs?: number;\n}\n\nexport const RECOGNIZER_DEFAULTS = Object.freeze({\n  thresholds: Object.freeze({ mouse: 4, pen: 6, touch: 8 }) as Readonly<Record<PointerKind, number>>,\n  longPress: Object.freeze({ ms: 500, kinds: Object.freeze([\"touch\", \"pen\"]) as readonly PointerKind[] }),\n  multiClick: Object.freeze({ ms: 300, px: 5 }),\n  pinch: Object.freeze({ scaleThreshold: 0.05, panThreshold: 10 }),\n});\n\nexport interface Recognizer {\n  feed(event: RawInputEvent): void;\n  /** Cancel the press and the pinch in flight (Escape, a tool change, the view losing focus) */\n  cancel(reason: CancelReason): void;\n  /** cancel(\"reset\") and forget every pointer (e.g. after the window lost focus mid-touch) */\n  reset(): void;\n  /** The press in flight, if any */\n  active(): { pointerId: number; kind: PointerKind; dragging: boolean } | null;\n  pinching(): boolean;\n  /** Change the drag modifier; applies from the next press */\n  setDragModifier(key: ModifierKey | null): void;\n  dispose(): void;\n}\n\ninterface Press {\n  origin: SurfacePointer;\n  last: SurfacePointer;\n  dragging: boolean;\n  longPressed: boolean;\n  /** What a modifier-drag would do; decided at the press, confirmed (modifier still held) at dragStart */\n  candidate: ModifierDrag | null;\n  modifierDrag: ModifierDrag | null;\n  timer: number | undefined;\n}\n\ninterface Touch {\n  screen: Point;\n  time: number;\n}\n\ninterface Pinch {\n  ids: [number, number];\n  startDist: number;\n  startCenter: Point;\n  lastDist: number;\n  lastCenter: Point;\n  kind: \"pinch\" | \"pan\" | null;\n  /** While undecided: each finger's moves (position changes) since the last look at the kind */\n  reported: Map<number, number>;\n}\n\n/**\n * While two fingers are undecided, the kind is looked at once both have moved as often as each other since the last\n * look: one finger's events arrive before the other's (one or a burst), and a pan's leading finger alone changes the\n * distance like a pinch. A finger at rest sends no moves, so a finger this many moves ahead of the other is looked at\n * on its own (a pinch around an anchored thumb).\n */\nconst SOLO_MOVES = 3;\n\nfunction kindOf(pointerType: string): PointerKind {\n  return pointerType === \"touch\" || pointerType === \"pen\" ? pointerType : \"mouse\";\n}\n\nfunction dist(a: Point, b: Point): number {\n  return Math.hypot(a.x - b.x, a.y - b.y);\n}\n\nfunction mid(a: Point, b: Point): Point {\n  return { x: (a.x + b.x) / 2, y: (a.y + b.y) / 2 };\n}\n\nfunction finitePoint(p: Point): Point {\n  return { x: Number.isFinite(p.x) ? p.x : 0, y: Number.isFinite(p.y) ? p.y : 0 };\n}\n\nexport function createRecognizer(options: RecognizerOptions, emit: (gesture: InputGesture) => void): Recognizer {\n  const thresholds = { ...RECOGNIZER_DEFAULTS.thresholds, ...options.thresholds };\n  const longPressMs = options.longPress?.ms ?? RECOGNIZER_DEFAULTS.longPress.ms;\n  const longPressKinds = options.longPress?.kinds ?? RECOGNIZER_DEFAULTS.longPress.kinds;\n  const multiClick = { ...RECOGNIZER_DEFAULTS.multiClick, ...options.multiClick };\n  const pinchCfg = { ...RECOGNIZER_DEFAULTS.pinch, ...options.pinch };\n  const wheelCfg: WheelOptions = { ...WHEEL_DEFAULTS, ...options.wheel };\n  const timers = options.timers;\n  const staleMs = options.staleMs ?? 1000;\n  let dragModifier: ModifierKey | null = options.dragModifier ?? null;\n  const platform: Platform = options.platform ?? \"other\";\n\n  let press: Press | null = null;\n  let pinch: Pinch | null = null;\n  const touches = new Map<number, Touch>();\n  /** After a pinch (or a reset mid-touch), fingers still down start nothing until all are up */\n  let touchLocked = false;\n  let lastClick: { time: number; screen: Point; button: number; count: number } | null = null;\n  let safari: { last: number } | null = null;\n  let lastTime = 0;\n  let disposed = false;\n\n  const pointerOf = (e: RawPointerEvent): SurfacePointer => {\n    const screen = finitePoint(e.screen);\n    return {\n      screen,\n      canvas: options.toCanvas(screen),\n      kind: kindOf(e.pointerType),\n      buttons: e.buttons,\n      modifiers: toModifiers(e.modifiers),\n      pointerId: e.pointerId,\n      button: e.button,\n      time: e.time,\n      ...(e.pressure !== undefined ? { pressure: e.pressure } : {}),\n    };\n  };\n\n  const clearTimer = (p: Press) => {\n    if (p.timer !== undefined && timers) timers.clearTimer(p.timer);\n    p.timer = undefined;\n  };\n\n  const endPress = (): Press | null => {\n    const p = press;\n    if (p) clearTimer(p);\n    press = null;\n    return p;\n  };\n\n  const cancelPress = (reason: CancelReason, pointer?: SurfacePointer) => {\n    const p = endPress();\n    if (!p) return;\n    emit({ type: \"cancel\", pointer: pointer ?? p.last, origin: p.origin, reason, dragged: p.dragging });\n  };\n\n  const releasePress = (pointer: SurfacePointer) => {\n    const p = endPress();\n    if (!p) return;\n    const click = !p.dragging && !p.longPressed;\n    let clickCount = 0;\n    if (click) {\n      const prev = lastClick;\n      const repeat =\n        !!prev &&\n        prev.button === p.origin.button &&\n        p.origin.time - prev.time <= multiClick.ms &&\n        dist(prev.screen, p.origin.screen) <= multiClick.px;\n      clickCount = repeat ? prev!.count + 1 : 1;\n      lastClick = { time: pointer.time, screen: p.origin.screen, button: p.origin.button, count: clickCount };\n    } else {\n      lastClick = null;\n    }\n    emit({ type: \"release\", pointer, origin: p.origin, click, clickCount, dragged: p.dragging });\n  };\n\n  const pinchState = (): { center: Point; d: number } | null => {\n    if (!pinch) return null;\n    const a = touches.get(pinch.ids[0]);\n    const b = touches.get(pinch.ids[1]);\n    if (!a || !b) return null;\n    return { center: mid(a.screen, b.screen), d: Math.max(1, dist(a.screen, b.screen)) };\n  };\n\n  const pinchEvent = (\n    phase: \"start\" | \"update\" | \"end\" | \"cancel\",\n    center: Point,\n    scale: number,\n    pan: Point,\n    time: number,\n    modifiers: SurfacePointer[\"modifiers\"],\n    source: \"touch\" | \"trackpad\",\n    kind: \"pinch\" | \"pan\",\n  ): InputGesture => ({\n    type: \"pinch\",\n    phase,\n    source,\n    kind,\n    center: { screen: center, canvas: options.toCanvas(center) },\n    scale,\n    pan,\n    modifiers,\n    time,\n  });\n\n  const endPinch = (phase: \"end\" | \"cancel\", time: number, modifiers: SurfacePointer[\"modifiers\"]) => {\n    const p = pinch;\n    pinch = null;\n    touchLocked = touches.size > 0;\n    if (p && p.kind) emit(pinchEvent(phase, p.lastCenter, 1, { x: 0, y: 0 }, time, modifiers, \"touch\", p.kind));\n  };\n\n  /**\n   * A pinch finger moved (`id`), or lifts (`lifting`: the last look, whatever moved). The kind is decided on both\n   * fingers' latest positions (see SOLO_MOVES); the thresholds keep their meaning.\n   */\n  const updatePinch = (id: number, time: number, modifiers: SurfacePointer[\"modifiers\"], moved: boolean, lifting = false) => {\n    const p = pinch;\n    const now = pinchState();\n    if (!p || !now) return;\n    if (!p.kind) {\n      if (!moved && !lifting) return; // a move that changed nothing (pressure only) is no move\n      const moves = (p.reported.get(id) ?? 0) + (moved ? 1 : 0);\n      p.reported.set(id, moves);\n      const other = p.reported.get(p.ids[0] === id ? p.ids[1] : p.ids[0]) ?? 0;\n      const even = moves > 0 && moves === other;\n      if (!lifting && !even && Math.abs(moves - other) < SOLO_MOVES) return;\n      p.reported.clear();\n      const scaleChange = Math.abs(now.d / p.startDist - 1);\n      const panDist = dist(now.center, p.startCenter);\n      if (scaleChange > pinchCfg.scaleThreshold) p.kind = \"pinch\";\n      else if (panDist > pinchCfg.panThreshold) p.kind = \"pan\";\n      else return;\n      // The first event carries everything since the second finger landed, so nothing is lost.\n      const scale = p.kind === \"pinch\" ? now.d / p.startDist : 1;\n      const pan = { x: now.center.x - p.startCenter.x, y: now.center.y - p.startCenter.y };\n      p.lastDist = now.d;\n      p.lastCenter = now.center;\n      emit(pinchEvent(\"start\", now.center, scale, pan, time, modifiers, \"touch\", p.kind));\n      return;\n    }\n    const scale = p.kind === \"pinch\" ? now.d / p.lastDist : 1;\n    const pan = { x: now.center.x - p.lastCenter.x, y: now.center.y - p.lastCenter.y };\n    p.lastDist = now.d;\n    p.lastCenter = now.center;\n    if (scale === 1 && pan.x === 0 && pan.y === 0) return;\n    emit(pinchEvent(\"update\", now.center, scale, pan, time, modifiers, \"touch\", p.kind));\n  };\n\n  /**\n   * A pointerup that never came (released outside the page, a pen lifted out of range, a lost event):\n   * a press of the same pointer, or a mouse / pen press untouched for staleMs, is over. A finger that\n   * lands again under its old id, or one resting untouched for staleMs outside any press or pinch, is gone.\n   */\n  const dropMissedUps = (e: RawPointerEvent, kind: PointerKind) => {\n    const p = press;\n    if (p) {\n      const same = p.origin.pointerId === e.pointerId;\n      const mixed = kind !== \"touch\" || p.origin.kind !== \"touch\"; // two fingers make a pinch, never a stale press\n      if (same || (mixed && e.time - p.last.time > staleMs)) cancelPress(\"missed-up\");\n    }\n    if (kind !== \"touch\") return;\n    if (touches.has(e.pointerId)) {\n      if (pinch?.ids.includes(e.pointerId)) endPinch(\"cancel\", e.time, toModifiers(e.modifiers));\n      touches.delete(e.pointerId);\n    }\n    for (const [id, t] of touches) {\n      const busy = press?.origin.pointerId === id || !!pinch?.ids.includes(id);\n      if (!busy && e.time - t.time > staleMs) touches.delete(id);\n    }\n    if (touches.size === 0) touchLocked = false;\n  };\n\n  const onDown = (e: RawPointerEvent) => {\n    const down = pointerOf(e);\n    // The press's button as the platform means it (macOS: Ctrl+click is a secondary click)\n    const pointer: SurfacePointer = { ...down, button: platformButton(down, platform, dragModifier) };\n    dropMissedUps(e, pointer.kind);\n    if (pointer.kind === \"touch\") {\n      touches.set(e.pointerId, { screen: pointer.screen, time: pointer.time });\n      if (touchLocked || pinch) return; // a third finger, or fingers after a pinch\n      if (touches.size === 2) {\n        const ids = [...touches.keys()] as [number, number];\n        // The second finger: whatever the first one started is cancelled, a pinch may begin.\n        if (press && press.origin.kind === \"touch\") cancelPress(\"multitouch\");\n        else if (press) {\n          touches.delete(e.pointerId); // a mouse or pen press owns the input; ignore the finger\n          return;\n        }\n        const a = touches.get(ids[0])!;\n        const b = touches.get(ids[1])!;\n        const d = Math.max(1, dist(a.screen, b.screen));\n        const c = mid(a.screen, b.screen);\n        pinch = { ids, startDist: d, startCenter: c, lastDist: d, lastCenter: c, kind: null, reported: new Map() };\n        return;\n      }\n      if (touches.size > 2) return;\n    }\n    if (press || pinch) return; // one press at a time\n    const candidate: ModifierDrag | null = isHeld(pointer.modifiers, dragModifier)\n      ? pointer.button === 0\n        ? \"move\"\n        : pointer.button === 2\n          ? \"resize\"\n          : null\n      : null;\n    const p: Press = {\n      origin: pointer,\n      last: pointer,\n      dragging: false,\n      longPressed: false,\n      candidate,\n      modifierDrag: null,\n      timer: undefined,\n    };\n    press = p;\n    if (timers && longPressKinds.includes(pointer.kind)) {\n      p.timer = timers.setTimer(() => {\n        p.timer = undefined;\n        if (press !== p || p.dragging || disposed) return;\n        p.longPressed = true;\n        emit({ type: \"longPress\", pointer: p.last, origin: p.origin });\n      }, longPressMs);\n    }\n    emit({ type: \"press\", pointer, modifierDrag: candidate });\n  };\n\n  const onMove = (e: RawPointerEvent) => {\n    const kind = kindOf(e.pointerType);\n    if (kind === \"touch\") {\n      const t = touches.get(e.pointerId);\n      const to = finitePoint(e.screen);\n      const moved = !t || t.screen.x !== to.x || t.screen.y !== to.y;\n      if (t) {\n        t.screen = to;\n        t.time = e.time;\n      }\n      if (pinch && pinch.ids.includes(e.pointerId)) {\n        updatePinch(e.pointerId, e.time, toModifiers(e.modifiers), moved);\n        return;\n      }\n    }\n    if (press && press.origin.pointerId === e.pointerId) {\n      const pointer = pointerOf(e);\n      // A mouse or pen moving with no button down and no pointerup before it: the release was missed.\n      if (pointer.kind !== \"touch\" && e.buttons === 0) {\n        releasePress(pointer);\n        return;\n      }\n      const p = press;\n      p.last = pointer;\n      if (!p.dragging) {\n        if (dist(pointer.screen, p.origin.screen) <= thresholds[p.origin.kind]) return;\n        p.dragging = true;\n        clearTimer(p);\n        // The modifier must still be held when the drag starts: a released Cmd makes it a plain drag.\n        p.modifierDrag = p.candidate && isHeld(pointer.modifiers, dragModifier) ? p.candidate : null;\n        emit({ type: \"dragStart\", pointer, origin: p.origin, modifierDrag: p.modifierDrag });\n        return;\n      }\n      emit({ type: \"move\", pointer, origin: p.origin });\n      return;\n    }\n    if (!press && kind !== \"touch\" && e.buttons === 0) emit({ type: \"hover\", pointer: pointerOf(e) });\n  };\n\n  const onUp = (e: RawPointerEvent) => {\n    if (kindOf(e.pointerType) === \"touch\") {\n      // A finger lifting from an undecided pinch: its last position is looked at once, so a quick pinch still counts\n      const t = touches.get(e.pointerId);\n      if (t && pinch && !pinch.kind && pinch.ids.includes(e.pointerId)) {\n        const to = finitePoint(e.screen);\n        const moved = t.screen.x !== to.x || t.screen.y !== to.y;\n        t.screen = to;\n        updatePinch(e.pointerId, e.time, toModifiers(e.modifiers), moved, true);\n      }\n      touches.delete(e.pointerId);\n      if (pinch && pinch.ids.includes(e.pointerId)) {\n        endPinch(\"end\", e.time, toModifiers(e.modifiers));\n        return;\n      }\n      if (touches.size === 0) touchLocked = false;\n    }\n    if (press && press.origin.pointerId === e.pointerId) releasePress(pointerOf(e));\n  };\n\n  const onCancel = (e: RawPointerEvent, reason: CancelReason) => {\n    if (kindOf(e.pointerType) === \"touch\") {\n      const tracked = touches.delete(e.pointerId);\n      if (pinch && pinch.ids.includes(e.pointerId)) {\n        if (tracked) endPinch(\"cancel\", e.time, toModifiers(e.modifiers));\n        return;\n      }\n      if (touches.size === 0) touchLocked = false;\n    }\n    if (press && press.origin.pointerId === e.pointerId) cancelPress(reason, pointerOf(e));\n  };\n\n  const onWheel = (e: RawWheelEvent) => {\n    const modifiers = toModifiers(e.modifiers);\n    const screen = finitePoint(e.screen);\n    const at = { screen, canvas: options.toCanvas(screen) };\n    const intent = classifyWheel(wheelDeltaPx(e.deltaX, e.deltaY, e.deltaMode, wheelCfg), modifiers, wheelCfg);\n    if (intent.kind === \"zoom\") {\n      if (intent.factor !== 1) emit({ type: \"zoom\", factor: intent.factor, at, modifiers, time: e.time });\n      return;\n    }\n    if (intent.delta.x === 0 && intent.delta.y === 0) return;\n    emit({ type: \"scroll\", delta: intent.delta, at, modifiers, time: e.time });\n  };\n\n  const onSafari = (e: RawSafariGestureEvent) => {\n    // iOS Safari fires gesture events for touch pinches too; the pointer path handles those.\n    if (touches.size > 0 || pinch) return;\n    const modifiers = toModifiers(e.modifiers);\n    const screen = finitePoint(e.screen);\n    const scaleNow = Number.isFinite(e.scale) && e.scale > 0 ? e.scale : 1;\n    const none = { x: 0, y: 0 };\n    if (e.type === \"gesturestart\") {\n      safari = { last: scaleNow };\n      emit(pinchEvent(\"start\", screen, 1, none, e.time, modifiers, \"trackpad\", \"pinch\"));\n      return;\n    }\n    if (!safari) return;\n    const scale = scaleNow / safari.last;\n    safari.last = scaleNow;\n    if (e.type === \"gesturechange\") {\n      if (scale !== 1) emit(pinchEvent(\"update\", screen, scale, none, e.time, modifiers, \"trackpad\", \"pinch\"));\n      return;\n    }\n    safari = null;\n    emit(pinchEvent(\"end\", screen, scale, none, e.time, modifiers, \"trackpad\", \"pinch\"));\n  };\n\n  const cancelAll = (reason: CancelReason) => {\n    cancelPress(reason);\n    if (pinch) endPinch(\"cancel\", lastTime, toModifiers(undefined));\n    if (safari) {\n      safari = null;\n      emit(pinchEvent(\"cancel\", { x: 0, y: 0 }, 1, { x: 0, y: 0 }, lastTime, toModifiers(undefined), \"trackpad\", \"pinch\"));\n    }\n  };\n\n  return {\n    feed(event) {\n      if (disposed) return;\n      if (Number.isFinite(event.time)) lastTime = event.time;\n      switch (event.type) {\n        case \"pointerdown\":\n          return onDown(event);\n        case \"pointermove\":\n          return onMove(event);\n        case \"pointerup\":\n          return onUp(event);\n        case \"pointercancel\":\n          return onCancel(event, \"pointercancel\");\n        case \"lostpointercapture\":\n          // Also fires right after pointerup; by then the press is gone and this is a no-op. The content\n          // losing its capture (the surface just took the pointer) is not the gesture's end.\n          if (event.lostBy === \"content\") return;\n          return onCancel(event, \"lostcapture\");\n        case \"wheel\":\n          return onWheel(event);\n        case \"gesturestart\":\n        case \"gesturechange\":\n        case \"gestureend\":\n          return onSafari(event);\n      }\n    },\n    cancel: cancelAll,\n    reset() {\n      cancelAll(\"reset\");\n      touches.clear();\n      touchLocked = false;\n      lastClick = null;\n    },\n    active() {\n      return press ? { pointerId: press.origin.pointerId, kind: press.origin.kind, dragging: press.dragging } : null;\n    },\n    pinching() {\n      return !!pinch?.kind || !!safari;\n    },\n    setDragModifier(key) {\n      dragModifier = key;\n    },\n    dispose() {\n      if (press) clearTimer(press);\n      press = null;\n      pinch = null;\n      safari = null;\n      touches.clear();\n      disposed = true;\n    },\n  };\n}\n","import type { FrameSource } from \"../clock/port\";\n\n/** Options of {@link createFrameCoalescer}. */\nexport interface CoalescerOptions<T> {\n  /**\n   * How a new sample folds into the pending one. Default: keep the latest\n   * (pointer positions). Wheel deltas want a sum instead.\n   */\n  readonly merge?: (pending: T, next: T) => T;\n}\n\n/**\n * Collapses a burst of samples into at most one delivery per frame. Same\n * shape as hypr-tiling's `createFrameCoalescer` (`schedule`, `cancel`),\n * plus `flush` and `pending`.\n */\nexport interface FrameCoalescer<T> {\n  /** Record a sample and make sure a frame is requested. */\n  schedule(sample: T): void;\n  /**\n   * Deliver the pending sample now, if there is one (before a pointer-up, so\n   * the last move is seen first). Returns whether it delivered.\n   */\n  flush(): boolean;\n  /** Drop the pending sample and the requested frame. Nothing is delivered after this. */\n  cancel(): void;\n  /** Whether a sample is waiting for its frame. */\n  readonly pending: boolean;\n}\n\n/**\n * Deliver samples to `onFrame` once per frame of `frames`: the browser clock,\n * the fake clock, or a frame loop phase (`loop.frames(\"input\")`). `onFrame`\n * also gets how many samples were folded into this one.\n */\nexport function createFrameCoalescer<T>(\n  onFrame: (sample: T, count: number) => void,\n  frames: FrameSource,\n  options: CoalescerOptions<T> = {},\n): FrameCoalescer<T> {\n  const merge = options.merge;\n  let handle: number | null = null;\n  let sample: T | undefined;\n  let count = 0;\n\n  const deliver = (): void => {\n    const delivered = sample as T;\n    const folded = count;\n    sample = undefined;\n    count = 0;\n    onFrame(delivered, folded);\n  };\n\n  const onFrameDue = (): void => {\n    handle = null;\n    if (count > 0) deliver();\n  };\n\n  return {\n    schedule(next) {\n      sample = count > 0 && merge !== undefined ? merge(sample as T, next) : next;\n      count++;\n      if (handle === null) handle = frames.requestFrame(onFrameDue);\n    },\n    flush() {\n      if (handle !== null) {\n        frames.cancelFrame(handle);\n        handle = null;\n      }\n      if (count === 0) return false;\n      deliver();\n      return true;\n    },\n    cancel() {\n      if (handle !== null) {\n        frames.cancelFrame(handle);\n        handle = null;\n      }\n      sample = undefined;\n      count = 0;\n    },\n    get pending() {\n      return count > 0;\n    },\n  };\n}\n","import type { TimerSource } from \"../clock/port\";\nimport { signal } from \"../signals/signals\";\n\n/**\n * A timer event a state asks for: send `event(t)` when the clock reaches\n * `at`. Machines stay pure; this is how a long-press or a dwell turns into\n * an event without the reducer touching a timer.\n */\nexport interface Deadline<E> {\n  /** Clock time in ms. */\n  readonly at: number;\n  /** The event to send, given the clock time it fired at. */\n  readonly event: (t: number) => E;\n}\n\n/** Options of {@link createMachine}. */\nexport interface MachineOptions<S, E> {\n  /** The pure transition function. Returning the same state means \"no change\". */\n  readonly reducer: (state: S, event: E) => S;\n  readonly initial: S;\n  /** Timers come from here (and `now()` for their events). */\n  readonly clock: TimerSource;\n  /** The timer event the state needs, or `null`. Checked after every transition. */\n  readonly deadline?: (state: S) => Deadline<E> | null;\n}\n\n/** A running machine: the state, a way to send events, and change listeners. */\nexport interface Machine<S, E> {\n  /** The current state; reactive (read it in a computed or an effect). */\n  readonly state: S;\n  /** The current state, untracked. */\n  peek(): S;\n  /**\n   * Run `event` through the reducer and return the new state. An event sent\n   * from a listener waits until the current one has been handled.\n   */\n  send(event: E): S;\n  /** Called after each change of state (not for events that changed nothing). */\n  subscribe(listener: (next: S, previous: S, event: E) => void): () => void;\n  /** Clear the timer and drop listeners. Events sent after this are ignored. */\n  dispose(): void;\n}\n\n/** Run a pure machine on a clock: it arms and clears the deadline timer for you. */\nexport function createMachine<S, E>(options: MachineOptions<S, E>): Machine<S, E> {\n  const { reducer, clock, deadline } = options;\n  const state = signal(options.initial);\n  const listeners = new Set<(next: S, previous: S, event: E) => void>();\n  const inbox: E[] = [];\n  let dispatching = false;\n  let disposed = false;\n  let timer: number | null = null;\n  let timerAt: number | null = null;\n  let timerEvent: ((t: number) => E) | null = null;\n\n  const clearTimer = (): void => {\n    if (timer !== null) clock.clearTimer(timer);\n    timer = null;\n    timerAt = null;\n    timerEvent = null;\n  };\n\n  const arm = (): void => {\n    const due = deadline === undefined ? null : deadline(state.peek());\n    if (due === null) {\n      clearTimer();\n      return;\n    }\n    timerEvent = due.event;\n    if (timer !== null && timerAt === due.at) return;\n    if (timer !== null) clock.clearTimer(timer);\n    timerAt = due.at;\n    timer = clock.setTimer(() => {\n      const make = timerEvent;\n      timer = null;\n      timerAt = null;\n      timerEvent = null;\n      if (make !== null) machine.send(make(clock.now()));\n    }, Math.max(0, due.at - clock.now()));\n  };\n\n  const machine: Machine<S, E> = {\n    get state() {\n      return state.value;\n    },\n    peek: () => state.peek(),\n    send(event) {\n      if (disposed) return state.peek();\n      inbox.push(event);\n      if (dispatching) return state.peek();\n      dispatching = true;\n      try {\n        let next: E | undefined;\n        while ((next = inbox.shift()) !== undefined) {\n          const previous = state.peek();\n          const after = reducer(previous, next);\n          if (after === previous) continue;\n          state.value = after;\n          arm();\n          for (const listener of Array.from(listeners)) listener(after, previous, next);\n          if (disposed) break;\n        }\n      } finally {\n        dispatching = false;\n        inbox.length = 0;\n      }\n      return state.peek();\n    },\n    subscribe(listener) {\n      listeners.add(listener);\n      return () => {\n        listeners.delete(listener);\n      };\n    },\n    dispose() {\n      if (disposed) return;\n      disposed = true;\n      clearTimer();\n      listeners.clear();\n    },\n  };\n  arm();\n  return machine;\n}\n","import type { TimerSource } from \"../clock/port\";\nimport { createMachine, type Deadline, type Machine } from \"./machine\";\n\n/**\n * The dwell machine (spring-load): hold over the same target long enough and\n * it fires, once.\n *\n * ```text\n * idle ──hover(key)──► dwelling ──tick (t − since ≥ dwellMs)──► fired\n *   ▲        │ hover(other key) restarts `since`           │\n *   │        │ hover(null) ─► idle                         │\n *   └────────┴─────────────── reset ◄─────────────────────┘\n * ```\n *\n * `fired` holds until `reset`: neither a late tick nor a hover change can fire\n * it again or clear it while the host acts on it. Shapes come from\n * hypr-tiling's `springLoadReducer`, with its workspace tab generalised to\n * any `key` (the host passes `null` for anything that shouldn't dwell, such as\n * the active tab).\n */\n\n/** Tunables of the dwell machine. */\nexport interface DwellConfig {\n  /** How long in ms the pointer must stay over the same key. Default 500. */\n  readonly dwellMs: number;\n}\n\n/** Defaults of {@link DwellConfig}. */\nexport const DWELL_DEFAULTS: DwellConfig = { dwellMs: 500 };\n\n/** The dwell machine's state. `K` is the target key, `P` the payload carried into `fired`. */\nexport type DwellState<K = string, P = unknown> =\n  | { readonly phase: \"idle\" }\n  | { readonly phase: \"dwelling\"; readonly key: K; readonly since: number; readonly payload: P | undefined }\n  | {\n      readonly phase: \"fired\";\n      readonly key: K;\n      readonly since: number;\n      readonly firedAt: number;\n      readonly payload: P | undefined;\n    };\n\n/** Events of the dwell machine. `t` is the clock time in ms. */\nexport type DwellInput<K = string, P = unknown> =\n  | { readonly type: \"hover\"; readonly t: number; readonly key: K | null; readonly payload?: P }\n  | { readonly type: \"tick\"; readonly t: number }\n  | { readonly type: \"reset\" };\n\n/** The idle state (the same object every time). */\nexport const DWELL_IDLE: DwellState<never, never> = { phase: \"idle\" };\n\n/** The dwell machine's pure transition function. */\nexport function dwellReducer<K, P>(\n  state: DwellState<K, P>,\n  event: DwellInput<K, P>,\n  config: DwellConfig = DWELL_DEFAULTS,\n): DwellState<K, P> {\n  switch (event.type) {\n    case \"reset\":\n      return state.phase === \"idle\" ? state : DWELL_IDLE;\n    case \"hover\":\n      if (state.phase === \"fired\") return state;\n      if (event.key === null) return state.phase === \"idle\" ? state : DWELL_IDLE;\n      if (state.phase === \"dwelling\" && Object.is(state.key, event.key)) return state;\n      return { phase: \"dwelling\", key: event.key, since: event.t, payload: event.payload };\n    case \"tick\":\n      if (state.phase !== \"dwelling\" || event.t - state.since < config.dwellMs) return state;\n      return { phase: \"fired\", key: state.key, since: state.since, firedAt: event.t, payload: state.payload };\n    default:\n      return state;\n  }\n}\n\n/** When a dwelling state fires, as a timer event; `null` outside `dwelling`. */\nexport function dwellDeadline<K, P>(\n  state: DwellState<K, P>,\n  config: DwellConfig = DWELL_DEFAULTS,\n): Deadline<DwellInput<K, P>> | null {\n  if (state.phase !== \"dwelling\") return null;\n  return { at: state.since + config.dwellMs, event: (t) => ({ type: \"tick\", t }) };\n}\n\n/** Options of {@link createDwellMachine}. */\nexport interface DwellMachineOptions {\n  readonly clock: TimerSource;\n  readonly config?: Partial<DwellConfig>;\n}\n\n/** A dwell machine on a clock: the dwell timer is armed for you. */\nexport function createDwellMachine<K = string, P = unknown>(\n  options: DwellMachineOptions,\n): Machine<DwellState<K, P>, DwellInput<K, P>> {\n  const config: DwellConfig = { ...DWELL_DEFAULTS, ...options.config };\n  return createMachine<DwellState<K, P>, DwellInput<K, P>>({\n    reducer: (state, event) => dwellReducer(state, event, config),\n    initial: DWELL_IDLE,\n    clock: options.clock,\n    deadline: (state) => dwellDeadline(state, config),\n  });\n}\n"],"mappings":"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","names":["scale","pan"]}

package/dist/gestures.d.ts

@@ -246,7 +246,8 @@ declare function dampWheelPan(delta: Point, opts?: WheelPanOptions): Point;
 /**
  * The gesture recogniser: raw pointer, wheel and Safari gesture events (plain
  * objects) in, one stream of InputGesture out. Mouse, pen and touch share one
- * path; two fingers become a pinch (5 % scale or 10 px pan decides which); a
+ * path; two fingers become a pinch (5 % scale or 10 px pan decides which, read
+ * once both fingers have moved, so a pan's leading finger is no pinch); a
  * press becomes a drag only past a per-kind threshold, so a modifier+click
  * (Cmd/Ctrl+click to multi-select) stays a click for the content.
  *

package/dist/gestures.js

@@ -20,7 +20,7 @@ import {
   resolveDragModifier,
   toModifiers,
   wheelDeltaPx
-} from "./chunk-QPOUWB7H.js";
+} from "./chunk-NFQ4LIIR.js";
 import "./chunk-OOKRBVMB.js";
 export {
   DWELL_DEFAULTS,

package/dist/index.d.ts

@@ -2,6 +2,6 @@ export { C as ClockPort, F as FrameSource, T as TimerSource } from './port-CmlUc
 export { FakeClock, FakeClockOptions, createFakeClock } from './clock.js';
 export { F as FrameInfo, a as FrameLoop, b as FrameLoopOptions, c as FrameStats, d as FrameTask, P as PHASES, e as Phase, R as RepeatingTask, S as ScheduleOptions, f as createFrameLoop } from './frame-loop-C88dc9xw.js';
 export { EffectCleanup, EffectOptions, Equals, ReadonlySignal, Signal, SignalOptions, batch, computed, effect, isSignal, signal, untracked } from './signals.js';
-export { Animator, AnimatorValue, Easing, MotionOptions, MotionValue, SPRING_DEFAULTS, SetOptions, Spring, SpringConfig, SpringParams, SpringState, Tween, TweenConfig, createSpring, createTween, cubicBezier, ease, easeIn, easeInOut, easeInOutCubic, easeOut, easeOutCubic, linear, motionValue, resolveSpring, springStep, springValue, tweenValue } from './values.js';
+export { Animator, AnimatorValue, Easing, MotionOptions, MotionValue, PopIn, RevealFrame, SETTLE_DEFAULTS, SETTLE_TEMPO, SPRING_DEFAULTS, SetOptions, Settle, SettleConfig, Spring, SpringConfig, SpringParams, SpringState, Tween, TweenConfig, createSettle, createSpring, createTween, cubicBezier, ease, easeIn, easeInOut, easeInOutCubic, easeOut, easeOutCubic, linear, motionValue, popIn, resolveSpring, reveal, settleValue, springStep, springValue, tweenValue } from './values.js';
 export { CancelReason, CoalescerOptions, DWELL_DEFAULTS, DWELL_IDLE, Deadline, DwellConfig, DwellInput, DwellMachineOptions, DwellState, FrameCoalescer, InputGesture, InputGestureType, Machine, MachineOptions, ModifierDrag, ModifierKey, Modifiers, NO_MODIFIERS, Platform, PointerKind, RECOGNIZER_DEFAULTS, RawInputEvent, RawPointerEvent, RawPointerType, RawSafariGestureEvent, RawWheelEvent, Recognizer, RecognizerOptions, RecognizerTimers, SurfacePointer, WHEEL_DEFAULTS, WHEEL_PAN_DEFAULTS, WheelIntent, WheelOptions, WheelPanOptions, classifyWheel, createDwellMachine, createFrameCoalescer, createMachine, createRecognizer, dampWheelPan, defaultDragModifier, dwellDeadline, dwellReducer, isHeld, modHeld, platformButton, resolveDragModifier, toModifiers, wheelDeltaPx } from './gestures.js';
 export { A as Animatable, P as Point, R as Rect, V as Vector, W as Widen, s as shapeEquals } from './shapes-EbQlwbCu.js';

package/dist/index.js

@@ -5,7 +5,10 @@ import {
 } from "./chunk-BVPVUJ42.js";
 import "./chunk-FQNHO2VT.js";
 import {
+  SETTLE_DEFAULTS,
+  SETTLE_TEMPO,
   SPRING_DEFAULTS,
+  createSettle,
   createSpring,
   createTween,
   cubicBezier,
@@ -17,12 +20,15 @@ import {
   easeOutCubic,
   linear,
   motionValue,
+  popIn,
   resolveSpring,
+  reveal,
+  settleValue,
   shapeEquals,
   springStep,
   springValue,
   tweenValue
-} from "./chunk-LCTGXGOI.js";
+} from "./chunk-6W5KW7XQ.js";
 import {
   DWELL_DEFAULTS,
   DWELL_IDLE,
@@ -45,7 +51,7 @@ import {
   resolveDragModifier,
   toModifiers,
   wheelDeltaPx
-} from "./chunk-QPOUWB7H.js";
+} from "./chunk-NFQ4LIIR.js";
 import {
   batch,
   computed,
@@ -60,6 +66,8 @@ export {
   NO_MODIFIERS,
   PHASES,
   RECOGNIZER_DEFAULTS,
+  SETTLE_DEFAULTS,
+  SETTLE_TEMPO,
   SPRING_DEFAULTS,
   WHEEL_DEFAULTS,
   WHEEL_PAN_DEFAULTS,
@@ -72,6 +80,7 @@ export {
   createFrameLoop,
   createMachine,
   createRecognizer,
+  createSettle,
   createSpring,
   createTween,
   cubicBezier,
@@ -92,8 +101,11 @@ export {
   modHeld,
   motionValue,
   platformButton,
+  popIn,
   resolveDragModifier,
   resolveSpring,
+  reveal,
+  settleValue,
   shapeEquals,
   signal,
   springStep,

package/dist/testing.d.ts

@@ -0,0 +1,87 @@
+import { R as Rect } from './shapes-EbQlwbCu.js';
+
+/**
+ * Frame-sampled checks of the motion rules: record what was drawn on each
+ * frame (in a unit test on the fake clock, or in a browser spec reading the
+ * page each animation frame) and ask whether the motion kept the rules.
+ *
+ * Every check returns `{ ok, failures }`; a failure names the frame (its time)
+ * and the component, so a spec can print it. Pixel tolerances default to half
+ * a pixel.
+ */
+/** One drawn frame: the time in ms and the rect on screen. */
+interface RectSample {
+    readonly t: number;
+    readonly rect: Rect;
+}
+/** A drawn frame with the target the motion was heading for at that frame. */
+interface TargetSample extends RectSample {
+    readonly target: Rect;
+}
+/** A drawn frame with where a pointer-held rect should be. */
+interface HeldSample extends RectSample {
+    readonly expected: Rect;
+}
+/** A drawn frame of content's transform: the matrix's x and y scale (CSS matrix `a` and `d`). */
+interface ScaleSample {
+    readonly t: number;
+    readonly a: number;
+    readonly d: number;
+}
+/** What a check found. */
+interface CheckResult {
+    readonly ok: boolean;
+    readonly failures: readonly string[];
+}
+/** {@link checkTempo}'s result: also the measured time to 90 %. */
+interface TempoResult extends CheckResult {
+    /** Ms from the start to the first sample 90 % of the way; null if it never got there or there was no move. */
+    readonly t90: number | null;
+}
+/**
+ * No overshoot: between `from` and `to`, every component of every frame stays
+ * between its start and end value (plus `tolerance`). Run it per move; size
+ * (`width`, `height`) passing is "no wobble".
+ */
+declare function checkNoOvershoot(samples: readonly RectSample[], from: Rect, to: Rect, tolerance?: number): CheckResult;
+/**
+ * Monotonic settle: per component, the distance to `to` never grows beyond
+ * the closest it has been so far (plus `tolerance`, once: a slow drift away
+ * fails too). A bounce or a restart backwards fails it.
+ */
+declare function checkMonotonic(samples: readonly RectSample[], to: Rect, tolerance?: number): CheckResult;
+/**
+ * No jumps: no frame moves a component further than a settle at `omega`
+ * could in that frame's time, measured against the larger of the distances to
+ * the target before and after (plus `slack` px). A snap, a restart from an old
+ * place or a teleport fails it; a settle, however often retargeted, passes.
+ * Leave held frames out (a pointer may move anything any distance).
+ *
+ * Sample times must be the time the motion was stepped by (the frame loop's
+ * `delta`s summed, as `FrameInfo.delta` hands them out: 1000/60 for the first
+ * frame after idle, clamped to 64 ms), not wall-clock timestamps; and `slack`
+ * must cover the final snap, so keep it above the settle's `restDelta`.
+ */
+declare function checkNoJumps(samples: readonly TargetSample[], omega: number, slack?: number): CheckResult;
+/** Held 1:1: on every frame the drawn rect is where the pointer puts it (within `tolerance`). */
+declare function checkHeld(samples: readonly HeldSample[], tolerance?: number): CheckResult;
+/**
+ * Content never stretched: the content's transform scales x and y by the same
+ * factor (within `tolerance`). With `uniformOnly: false` (default true) it must
+ * also be 1, i.e. not scaled at all: use that for glides, the default for
+ * open and close.
+ */
+declare function checkContentScale(samples: readonly ScaleSample[], options?: {
+    uniformOnly?: boolean;
+    tolerance?: number;
+}): CheckResult;
+/**
+ * Tempo: the move from `from` to `to` is 90 % done (by its largest component)
+ * within `t90` ms, give or take `tolerance` (a fraction, default 0.25).
+ * Time counts from `startT`: when the move began (the frame its target was
+ * set, its rect still `from`). It defaults to the first sample's time, so
+ * either pass it or record that frame first.
+ */
+declare function checkTempo(samples: readonly RectSample[], from: Rect, to: Rect, t90: number, tolerance?: number, startT?: number): TempoResult;
+
+export { type CheckResult, type HeldSample, type RectSample, type ScaleSample, type TargetSample, type TempoResult, checkContentScale, checkHeld, checkMonotonic, checkNoJumps, checkNoOvershoot, checkTempo };

package/dist/testing.js

@@ -0,0 +1,93 @@
+// src/testing/checks.ts
+var KEYS = ["x", "y", "width", "height"];
+var result = (failures) => ({ ok: failures.length === 0, failures });
+var fmt = (n) => (Math.round(n * 100) / 100).toString();
+function checkNoOvershoot(samples, from, to, tolerance = 0.5) {
+  const failures = [];
+  for (const s of samples) {
+    for (const k of KEYS) {
+      const lo = Math.min(from[k], to[k]) - tolerance;
+      const hi = Math.max(from[k], to[k]) + tolerance;
+      const v = s.rect[k];
+      if (v < lo || v > hi) failures.push(`t=${fmt(s.t)} ${k}=${fmt(v)} outside [${fmt(lo + tolerance)}, ${fmt(hi - tolerance)}]`);
+    }
+  }
+  return result(failures);
+}
+function checkMonotonic(samples, to, tolerance = 0.5) {
+  const failures = [];
+  const closest = /* @__PURE__ */ new Map();
+  for (const s of samples) {
+    for (const k of KEYS) {
+      const off = Math.abs(s.rect[k] - to[k]);
+      const best = closest.get(k);
+      if (best !== void 0 && off > best + tolerance) failures.push(`t=${fmt(s.t)} ${k} moved away from its target: ${fmt(best)} \u2192 ${fmt(off)} px off`);
+      if (best === void 0 || off < best) closest.set(k, off);
+    }
+  }
+  return result(failures);
+}
+function checkNoJumps(samples, omega, slack = 1) {
+  const failures = [];
+  for (let i = 1; i < samples.length; i++) {
+    const a = samples[i - 1];
+    const b = samples[i];
+    const dt = Math.max(0, b.t - a.t) / 1e3;
+    const reach = 1 - Math.exp(-omega * dt);
+    for (const k of KEYS) {
+      const step = Math.abs(b.rect[k] - a.rect[k]);
+      const far = Math.max(Math.abs(a.rect[k] - a.target[k]), Math.abs(a.rect[k] - b.target[k]));
+      const limit = far * reach * 1.05 + slack;
+      if (step > limit) failures.push(`t=${fmt(b.t)} ${k} jumped ${fmt(step)} px in ${fmt(b.t - a.t)} ms (at most ${fmt(limit)})`);
+    }
+  }
+  return result(failures);
+}
+function checkHeld(samples, tolerance = 0.5) {
+  const failures = [];
+  for (const s of samples) {
+    for (const k of KEYS) {
+      const off = Math.abs(s.rect[k] - s.expected[k]);
+      if (off > tolerance) failures.push(`t=${fmt(s.t)} ${k} is ${fmt(off)} px from the pointer's place`);
+    }
+  }
+  return result(failures);
+}
+function checkContentScale(samples, options = {}) {
+  const tolerance = options.tolerance ?? 1e-3;
+  const uniformOnly = options.uniformOnly ?? true;
+  const failures = [];
+  for (const s of samples) {
+    if (Math.abs(s.a - s.d) > tolerance) failures.push(`t=${fmt(s.t)} content stretched: scale ${fmt(s.a)} \xD7 ${fmt(s.d)}`);
+    else if (!uniformOnly && (Math.abs(s.a - 1) > tolerance || Math.abs(s.d - 1) > tolerance)) failures.push(`t=${fmt(s.t)} content scaled by ${fmt(s.a)}`);
+  }
+  return result(failures);
+}
+function checkTempo(samples, from, to, t90, tolerance = 0.25, startT = samples[0]?.t ?? 0) {
+  let key = "x";
+  for (const k of KEYS) if (Math.abs(to[k] - from[k]) > Math.abs(to[key] - from[key])) key = k;
+  const span = to[key] - from[key];
+  if (span === 0) return { ok: true, failures: [], t90: null };
+  let measured = null;
+  for (const s of samples) {
+    if ((s.rect[key] - from[key]) / span >= 0.9) {
+      measured = s.t - startT;
+      break;
+    }
+  }
+  const failures = [];
+  if (measured === null) failures.push(`never got 90 % of the way (${key})`);
+  else if (measured < t90 * (1 - tolerance) || measured > t90 * (1 + tolerance)) {
+    failures.push(`90 % after ${fmt(measured)} ms, expected ${fmt(t90)} ms \xB1 ${Math.round(tolerance * 100)} %`);
+  }
+  return { ok: failures.length === 0, failures, t90: measured };
+}
+export {
+  checkContentScale,
+  checkHeld,
+  checkMonotonic,
+  checkNoJumps,
+  checkNoOvershoot,
+  checkTempo
+};
+//# sourceMappingURL=testing.js.map

package/dist/testing.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/testing/checks.ts"],"sourcesContent":["import type { Rect } from \"../shapes\";\n\n/**\n * Frame-sampled checks of the motion rules: record what was drawn on each\n * frame (in a unit test on the fake clock, or in a browser spec reading the\n * page each animation frame) and ask whether the motion kept the rules.\n *\n * Every check returns `{ ok, failures }`; a failure names the frame (its time)\n * and the component, so a spec can print it. Pixel tolerances default to half\n * a pixel.\n */\n\n/** One drawn frame: the time in ms and the rect on screen. */\nexport interface RectSample {\n  readonly t: number;\n  readonly rect: Rect;\n}\n\n/** A drawn frame with the target the motion was heading for at that frame. */\nexport interface TargetSample extends RectSample {\n  readonly target: Rect;\n}\n\n/** A drawn frame with where a pointer-held rect should be. */\nexport interface HeldSample extends RectSample {\n  readonly expected: Rect;\n}\n\n/** A drawn frame of content's transform: the matrix's x and y scale (CSS matrix `a` and `d`). */\nexport interface ScaleSample {\n  readonly t: number;\n  readonly a: number;\n  readonly d: number;\n}\n\n/** What a check found. */\nexport interface CheckResult {\n  readonly ok: boolean;\n  readonly failures: readonly string[];\n}\n\n/** {@link checkTempo}'s result: also the measured time to 90 %. */\nexport interface TempoResult extends CheckResult {\n  /** Ms from the start to the first sample 90 % of the way; null if it never got there or there was no move. */\n  readonly t90: number | null;\n}\n\nconst KEYS = [\"x\", \"y\", \"width\", \"height\"] as const;\ntype Key = (typeof KEYS)[number];\n\nconst result = (failures: string[]): CheckResult => ({ ok: failures.length === 0, failures });\nconst fmt = (n: number): string => (Math.round(n * 100) / 100).toString();\n\n/**\n * No overshoot: between `from` and `to`, every component of every frame stays\n * between its start and end value (plus `tolerance`). Run it per move; size\n * (`width`, `height`) passing is \"no wobble\".\n */\nexport function checkNoOvershoot(samples: readonly RectSample[], from: Rect, to: Rect, tolerance = 0.5): CheckResult {\n  const failures: string[] = [];\n  for (const s of samples) {\n    for (const k of KEYS) {\n      const lo = Math.min(from[k], to[k]) - tolerance;\n      const hi = Math.max(from[k], to[k]) + tolerance;\n      const v = s.rect[k];\n      if (v < lo || v > hi) failures.push(`t=${fmt(s.t)} ${k}=${fmt(v)} outside [${fmt(lo + tolerance)}, ${fmt(hi - tolerance)}]`);\n    }\n  }\n  return result(failures);\n}\n\n/**\n * Monotonic settle: per component, the distance to `to` never grows beyond\n * the closest it has been so far (plus `tolerance`, once: a slow drift away\n * fails too). A bounce or a restart backwards fails it.\n */\nexport function checkMonotonic(samples: readonly RectSample[], to: Rect, tolerance = 0.5): CheckResult {\n  const failures: string[] = [];\n  const closest = new Map<Key, number>();\n  for (const s of samples) {\n    for (const k of KEYS) {\n      const off = Math.abs(s.rect[k] - to[k]);\n      const best = closest.get(k);\n      if (best !== undefined && off > best + tolerance) failures.push(`t=${fmt(s.t)} ${k} moved away from its target: ${fmt(best)} → ${fmt(off)} px off`);\n      if (best === undefined || off < best) closest.set(k, off);\n    }\n  }\n  return result(failures);\n}\n\n/**\n * No jumps: no frame moves a component further than a settle at `omega`\n * could in that frame's time, measured against the larger of the distances to\n * the target before and after (plus `slack` px). A snap, a restart from an old\n * place or a teleport fails it; a settle, however often retargeted, passes.\n * Leave held frames out (a pointer may move anything any distance).\n *\n * Sample times must be the time the motion was stepped by (the frame loop's\n * `delta`s summed, as `FrameInfo.delta` hands them out: 1000/60 for the first\n * frame after idle, clamped to 64 ms), not wall-clock timestamps; and `slack`\n * must cover the final snap, so keep it above the settle's `restDelta`.\n */\nexport function checkNoJumps(samples: readonly TargetSample[], omega: number, slack = 1): CheckResult {\n  const failures: string[] = [];\n  for (let i = 1; i < samples.length; i++) {\n    const a = samples[i - 1]!;\n    const b = samples[i]!;\n    const dt = Math.max(0, b.t - a.t) / 1000;\n    const reach = 1 - Math.exp(-omega * dt);\n    for (const k of KEYS) {\n      const step = Math.abs(b.rect[k] - a.rect[k]);\n      const far = Math.max(Math.abs(a.rect[k] - a.target[k]), Math.abs(a.rect[k] - b.target[k]));\n      const limit = far * reach * 1.05 + slack;\n      if (step > limit) failures.push(`t=${fmt(b.t)} ${k} jumped ${fmt(step)} px in ${fmt(b.t - a.t)} ms (at most ${fmt(limit)})`);\n    }\n  }\n  return result(failures);\n}\n\n/** Held 1:1: on every frame the drawn rect is where the pointer puts it (within `tolerance`). */\nexport function checkHeld(samples: readonly HeldSample[], tolerance = 0.5): CheckResult {\n  const failures: string[] = [];\n  for (const s of samples) {\n    for (const k of KEYS) {\n      const off = Math.abs(s.rect[k] - s.expected[k]);\n      if (off > tolerance) failures.push(`t=${fmt(s.t)} ${k} is ${fmt(off)} px from the pointer's place`);\n    }\n  }\n  return result(failures);\n}\n\n/**\n * Content never stretched: the content's transform scales x and y by the same\n * factor (within `tolerance`). With `uniformOnly: false` (default true) it must\n * also be 1, i.e. not scaled at all: use that for glides, the default for\n * open and close.\n */\nexport function checkContentScale(samples: readonly ScaleSample[], options: { uniformOnly?: boolean; tolerance?: number } = {}): CheckResult {\n  const tolerance = options.tolerance ?? 1e-3;\n  const uniformOnly = options.uniformOnly ?? true;\n  const failures: string[] = [];\n  for (const s of samples) {\n    if (Math.abs(s.a - s.d) > tolerance) failures.push(`t=${fmt(s.t)} content stretched: scale ${fmt(s.a)} × ${fmt(s.d)}`);\n    else if (!uniformOnly && (Math.abs(s.a - 1) > tolerance || Math.abs(s.d - 1) > tolerance)) failures.push(`t=${fmt(s.t)} content scaled by ${fmt(s.a)}`);\n  }\n  return result(failures);\n}\n\n/**\n * Tempo: the move from `from` to `to` is 90 % done (by its largest component)\n * within `t90` ms, give or take `tolerance` (a fraction, default 0.25).\n * Time counts from `startT`: when the move began (the frame its target was\n * set, its rect still `from`). It defaults to the first sample's time, so\n * either pass it or record that frame first.\n */\nexport function checkTempo(\n  samples: readonly RectSample[],\n  from: Rect,\n  to: Rect,\n  t90: number,\n  tolerance = 0.25,\n  startT: number = samples[0]?.t ?? 0,\n): TempoResult {\n  let key: Key = \"x\";\n  for (const k of KEYS) if (Math.abs(to[k] - from[k]) > Math.abs(to[key] - from[key])) key = k;\n  const span = to[key] - from[key];\n  if (span === 0) return { ok: true, failures: [], t90: null };\n  let measured: number | null = null;\n  for (const s of samples) {\n    if ((s.rect[key] - from[key]) / span >= 0.9) {\n      measured = s.t - startT;\n      break;\n    }\n  }\n  const failures: string[] = [];\n  if (measured === null) failures.push(`never got 90 % of the way (${key})`);\n  else if (measured < t90 * (1 - tolerance) || measured > t90 * (1 + tolerance)) {\n    failures.push(`90 % after ${fmt(measured)} ms, expected ${fmt(t90)} ms ± ${Math.round(tolerance * 100)} %`);\n  }\n  return { ok: failures.length === 0, failures, t90: measured };\n}\n"],"mappings":";AA+CA,IAAM,OAAO,CAAC,KAAK,KAAK,SAAS,QAAQ;AAGzC,IAAM,SAAS,CAAC,cAAqC,EAAE,IAAI,SAAS,WAAW,GAAG,SAAS;AAC3F,IAAM,MAAM,CAAC,OAAuB,KAAK,MAAM,IAAI,GAAG,IAAI,KAAK,SAAS;AAOjE,SAAS,iBAAiB,SAAgC,MAAY,IAAU,YAAY,KAAkB;AACnH,QAAM,WAAqB,CAAC;AAC5B,aAAW,KAAK,SAAS;AACvB,eAAW,KAAK,MAAM;AACpB,YAAM,KAAK,KAAK,IAAI,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,IAAI;AACtC,YAAM,KAAK,KAAK,IAAI,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,IAAI;AACtC,YAAM,IAAI,EAAE,KAAK,CAAC;AAClB,UAAI,IAAI,MAAM,IAAI,GAAI,UAAS,KAAK,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,aAAa,IAAI,KAAK,SAAS,CAAC,KAAK,IAAI,KAAK,SAAS,CAAC,GAAG;AAAA,IAC7H;AAAA,EACF;AACA,SAAO,OAAO,QAAQ;AACxB;AAOO,SAAS,eAAe,SAAgC,IAAU,YAAY,KAAkB;AACrG,QAAM,WAAqB,CAAC;AAC5B,QAAM,UAAU,oBAAI,IAAiB;AACrC,aAAW,KAAK,SAAS;AACvB,eAAW,KAAK,MAAM;AACpB,YAAM,MAAM,KAAK,IAAI,EAAE,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC;AACtC,YAAM,OAAO,QAAQ,IAAI,CAAC;AAC1B,UAAI,SAAS,UAAa,MAAM,OAAO,UAAW,UAAS,KAAK,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,gCAAgC,IAAI,IAAI,CAAC,WAAM,IAAI,GAAG,CAAC,SAAS;AAClJ,UAAI,SAAS,UAAa,MAAM,KAAM,SAAQ,IAAI,GAAG,GAAG;AAAA,IAC1D;AAAA,EACF;AACA,SAAO,OAAO,QAAQ;AACxB;AAcO,SAAS,aAAa,SAAkC,OAAe,QAAQ,GAAgB;AACpG,QAAM,WAAqB,CAAC;AAC5B,WAAS,IAAI,GAAG,IAAI,QAAQ,QAAQ,KAAK;AACvC,UAAM,IAAI,QAAQ,IAAI,CAAC;AACvB,UAAM,IAAI,QAAQ,CAAC;AACnB,UAAM,KAAK,KAAK,IAAI,GAAG,EAAE,IAAI,EAAE,CAAC,IAAI;AACpC,UAAM,QAAQ,IAAI,KAAK,IAAI,CAAC,QAAQ,EAAE;AACtC,eAAW,KAAK,MAAM;AACpB,YAAM,OAAO,KAAK,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AAC3C,YAAM,MAAM,KAAK,IAAI,KAAK,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,GAAG,KAAK,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;AACzF,YAAM,QAAQ,MAAM,QAAQ,OAAO;AACnC,UAAI,OAAO,MAAO,UAAS,KAAK,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,UAAU,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,gBAAgB,IAAI,KAAK,CAAC,GAAG;AAAA,IAC7H;AAAA,EACF;AACA,SAAO,OAAO,QAAQ;AACxB;AAGO,SAAS,UAAU,SAAgC,YAAY,KAAkB;AACtF,QAAM,WAAqB,CAAC;AAC5B,aAAW,KAAK,SAAS;AACvB,eAAW,KAAK,MAAM;AACpB,YAAM,MAAM,KAAK,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;AAC9C,UAAI,MAAM,UAAW,UAAS,KAAK,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,IAAI,GAAG,CAAC,8BAA8B;AAAA,IACpG;AAAA,EACF;AACA,SAAO,OAAO,QAAQ;AACxB;AAQO,SAAS,kBAAkB,SAAiC,UAAyD,CAAC,GAAgB;AAC3I,QAAM,YAAY,QAAQ,aAAa;AACvC,QAAM,cAAc,QAAQ,eAAe;AAC3C,QAAM,WAAqB,CAAC;AAC5B,aAAW,KAAK,SAAS;AACvB,QAAI,KAAK,IAAI,EAAE,IAAI,EAAE,CAAC,IAAI,UAAW,UAAS,KAAK,KAAK,IAAI,EAAE,CAAC,CAAC,6BAA6B,IAAI,EAAE,CAAC,CAAC,SAAM,IAAI,EAAE,CAAC,CAAC,EAAE;AAAA,aAC5G,CAAC,gBAAgB,KAAK,IAAI,EAAE,IAAI,CAAC,IAAI,aAAa,KAAK,IAAI,EAAE,IAAI,CAAC,IAAI,WAAY,UAAS,KAAK,KAAK,IAAI,EAAE,CAAC,CAAC,sBAAsB,IAAI,EAAE,CAAC,CAAC,EAAE;AAAA,EACxJ;AACA,SAAO,OAAO,QAAQ;AACxB;AASO,SAAS,WACd,SACA,MACA,IACA,KACA,YAAY,MACZ,SAAiB,QAAQ,CAAC,GAAG,KAAK,GACrB;AACb,MAAI,MAAW;AACf,aAAW,KAAK,KAAM,KAAI,KAAK,IAAI,GAAG,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,KAAK,IAAI,GAAG,GAAG,IAAI,KAAK,GAAG,CAAC,EAAG,OAAM;AAC3F,QAAM,OAAO,GAAG,GAAG,IAAI,KAAK,GAAG;AAC/B,MAAI,SAAS,EAAG,QAAO,EAAE,IAAI,MAAM,UAAU,CAAC,GAAG,KAAK,KAAK;AAC3D,MAAI,WAA0B;AAC9B,aAAW,KAAK,SAAS;AACvB,SAAK,EAAE,KAAK,GAAG,IAAI,KAAK,GAAG,KAAK,QAAQ,KAAK;AAC3C,iBAAW,EAAE,IAAI;AACjB;AAAA,IACF;AAAA,EACF;AACA,QAAM,WAAqB,CAAC;AAC5B,MAAI,aAAa,KAAM,UAAS,KAAK,8BAA8B,GAAG,GAAG;AAAA,WAChE,WAAW,OAAO,IAAI,cAAc,WAAW,OAAO,IAAI,YAAY;AAC7E,aAAS,KAAK,cAAc,IAAI,QAAQ,CAAC,iBAAiB,IAAI,GAAG,CAAC,YAAS,KAAK,MAAM,YAAY,GAAG,CAAC,IAAI;AAAA,EAC5G;AACA,SAAO,EAAE,IAAI,SAAS,WAAW,GAAG,UAAU,KAAK,SAAS;AAC9D;","names":[]}

package/dist/values.d.ts

@@ -1,4 +1,4 @@
-import { A as Animatable, W as Widen } from './shapes-EbQlwbCu.js';
+import { A as Animatable, W as Widen, R as Rect } from './shapes-EbQlwbCu.js';
 import { e as Phase, a as FrameLoop } from './frame-loop-C88dc9xw.js';
 import { ReadonlySignal } from './signals.js';
 import './port-CmlUctqx.js';
@@ -133,6 +133,123 @@ interface Tween<T> extends Animator<T> {
  */
 declare function createTween<T extends Animatable>(initial: T, config?: TweenConfig): Tween<Widen<T>>;
 
+/**
+ * Tempos for {@link createSettle}, in 1/s: a settle covers 90 % of the way in
+ * ln(10)/omega seconds and is within 1 % in twice that.
+ *
+ * - `calm` 20: 90 % in 115 ms, done in 230 ms.
+ * - `default` 25: 90 % in 92 ms, done in 184 ms.
+ * - `quick` 37: 90 % in 62 ms, done in 124 ms (a fast Hyprland setup).
+ */
+declare const SETTLE_TEMPO: {
+    readonly calm: 20;
+    readonly default: 25;
+    readonly quick: 37;
+};
+/** Settings of {@link createSettle}. */
+interface SettleConfig {
+    /** The tempo in 1/s (see {@link SETTLE_TEMPO}). Higher is faster. Default 25. */
+    readonly omega?: number;
+    /** Distance from the target that counts as arrived. Default 0.1 (tuned for pixels). */
+    readonly restDelta?: number;
+}
+/**
+ * The one curve for things that move to a new place: a window's rect between
+ * layout targets, a drawer, a camera. Fast at the start, gentle at the end,
+ * and it never passes its target.
+ *
+ * It is a critically damped spring (stiffness omega², damping 2·omega) with
+ * one rule on its velocity, per component:
+ *
+ * - **Launch.** On a new target, each component gets the velocity
+ *   omega · distance toward it, from wherever it is drawn: standing still,
+ *   moving toward it, or moving away (it turns at once rather than drifting
+ *   further first). From there the spring follows `distance · e^(−omega·t)`
+ *   exactly: most of the move happens at once, the rest eases in.
+ * - **Clamp.** That speed is also the most it may have toward the target, so a
+ *   velocity set by hand (`setVelocity`, a fling) toward the target is capped
+ *   there instead of shooting past.
+ * - **Carry.** A velocity set by hand away from the target is kept, and the
+ *   value turns around; a critically damped spring turning around never
+ *   crosses the target either.
+ *
+ * So after a new target every component goes straight from where it is drawn
+ * to the target and never past it: no overshoot on position, no wobble on
+ * size, whatever the retargets. A new target starts from the drawn value,
+ * never from the old start.
+ *
+ * Holding (a pointer owns the value): call `hold(value)` on each move. The
+ * value sits exactly there, at rest; the next `setTarget` launches from it.
+ */
+interface Settle<T> extends Animator<T> {
+    /** The tempo in 1/s. */
+    readonly omega: number;
+    /** Put the value at `value`, at rest, with it as the target: a held value follows its owner 1:1. Same as `jumpTo`. */
+    hold(value: T): void;
+    /** Set the velocity (units per second); a component moving toward the target is clamped as in the launch rule. */
+    setVelocity(velocity: T): void;
+    /** Change the tempo or rest distance mid-flight; the value and velocity carry on, re-clamped. */
+    configure(config: SettleConfig): void;
+}
+/** Defaults of {@link SettleConfig}. */
+declare const SETTLE_DEFAULTS: {
+    readonly omega: 25;
+    readonly restDelta: 0.1;
+};
+/**
+ * A settle starting at rest on `initial` (a number, a vector, a point or a
+ * rect; targets and velocities must have the same shape). See {@link Settle}.
+ */
+declare function createSettle<T extends Animatable>(initial: T, config?: SettleConfig): Settle<Widen<T>>;
+
+/**
+ * How to draw a window whose rect is gliding without stretching its content.
+ *
+ * The content is laid out once at the target size and never scaled. The
+ * window's element sits at its target in the layout; to draw it at the
+ * gliding rect:
+ *
+ * - move the element by (`dx`, `dy`), so its top-left corner is the drawn rect's;
+ * - draw the frame (background, border, shadow) at `width` × `height`: the drawn size;
+ * - clip the content by `clipRight` and `clipBottom` so it fits a frame
+ *   smaller than the target (CSS: `clip-path: inset(0 clipRight clipBottom 0)`).
+ *
+ * A window that shrinks shows a band of its own background closing in at the
+ * right and bottom; one that grows reveals content already laid out at its
+ * new size. Text is never stretched. One transform and one clip per frame, no
+ * layout per frame.
+ */
+interface RevealFrame {
+    /** Move the element (laid out at the target) right by this much. */
+    readonly dx: number;
+    /** Move the element (laid out at the target) down by this much. */
+    readonly dy: number;
+    /** The frame's width: the drawn rect's. */
+    readonly width: number;
+    /** The frame's height: the drawn rect's. */
+    readonly height: number;
+    /** Clip this much off the content's right edge (0 when the frame is at least as wide as the target). */
+    readonly clipRight: number;
+    /** Clip this much off the content's bottom edge (0 when the frame is at least as tall as the target). */
+    readonly clipBottom: number;
+}
+/** The {@link RevealFrame} for content laid out at `target` and drawn at `drawn`. */
+declare function reveal(drawn: Rect, target: Rect): RevealFrame;
+/** A uniform pop-in (or pop-out, run backwards): scale about the centre and opacity. */
+interface PopIn {
+    /** Scale about the window's centre: the same on both axes, so nothing is stretched. */
+    readonly scale: number;
+    readonly opacity: number;
+}
+/**
+ * Opening and closing: the window grows from `from` of its size to full, about
+ * its centre, while fading in. `progress` runs 0 to 1 (take it from a settle
+ * on a number with `{ restDelta: 0.001 }`, since the default 0.1 is tuned for
+ * pixels and would snap the last 10 %; or from a tween); closing runs it from
+ * 1 to 0. Hyprland's default is `popin 87%`.
+ */
+declare function popIn(progress: number, from?: number): PopIn;
+
 /** Options of {@link motionValue}. */
 interface MotionOptions {
     /**
@@ -151,7 +268,7 @@ interface MotionOptions {
 }
 /** Options of {@link MotionValue.set}. */
 interface SetOptions<T> {
-    /** Start with this velocity (units per second), e.g. a gesture's release velocity. Springs only. */
+    /** Start with this velocity (units per second), e.g. a gesture's release velocity. Springs and settles (a settle caps it toward the target); tweens ignore it. */
     readonly velocity?: T;
 }
 /**
@@ -166,9 +283,9 @@ interface MotionValue<T, A extends Animator<unknown> = Animator<T>> extends Read
     readonly velocity: T;
     /** Whether it is moving (reactive). */
     readonly moving: boolean;
-    /** The spring or tween underneath. */
+    /** The spring, settle or tween underneath. Change it through this value (`jump`, not the animator's `hold`), so the signal and the loop follow. */
     readonly animator: A;
-    /** Head for `target`; a spring keeps its velocity. */
+    /** Head for `target`; a spring keeps its velocity, a settle launches from where it is drawn, a tween restarts. */
     set(target: T, options?: SetOptions<T>): void;
     /** Put the value at `value` at once, at rest. */
     jump(value: T): void;
@@ -195,7 +312,13 @@ type AnimatorValue<A> = A extends Animator<infer T> ? T : never;
 declare function motionValue<A extends Animator<unknown>>(loop: FrameLoop, animator: A, options?: MotionOptions): MotionValue<AnimatorValue<A>, A>;
 /** A spring-driven {@link MotionValue}: `createSpring` plus `motionValue`. */
 declare function springValue<T extends Animatable>(loop: FrameLoop, initial: T, options?: SpringConfig & MotionOptions): MotionValue<Widen<T>, Spring<Widen<T>>>;
+/**
+ * A settle-driven {@link MotionValue}: `createSettle` plus `motionValue`. The
+ * one curve for things moving to a new place (see {@link Settle}). To hold it
+ * to a pointer, `jump` it on each move; the next `set` launches from there.
+ */
+declare function settleValue<T extends Animatable>(loop: FrameLoop, initial: T, options?: SettleConfig & MotionOptions): MotionValue<Widen<T>, Settle<Widen<T>>>;
 /** A tween-driven {@link MotionValue}: `createTween` plus `motionValue`. */
 declare function tweenValue<T extends Animatable>(loop: FrameLoop, initial: T, options?: TweenConfig & MotionOptions): MotionValue<Widen<T>, Tween<Widen<T>>>;
 
-export { type Animator, type AnimatorValue, type Easing, type MotionOptions, type MotionValue, SPRING_DEFAULTS, type SetOptions, type Spring, type SpringConfig, type SpringParams, type SpringState, type Tween, type TweenConfig, createSpring, createTween, cubicBezier, ease, easeIn, easeInOut, easeInOutCubic, easeOut, easeOutCubic, linear, motionValue, resolveSpring, springStep, springValue, tweenValue };
+export { type Animator, type AnimatorValue, type Easing, type MotionOptions, type MotionValue, type PopIn, type RevealFrame, SETTLE_DEFAULTS, SETTLE_TEMPO, SPRING_DEFAULTS, type SetOptions, type Settle, type SettleConfig, type Spring, type SpringConfig, type SpringParams, type SpringState, type Tween, type TweenConfig, createSettle, createSpring, createTween, cubicBezier, ease, easeIn, easeInOut, easeInOutCubic, easeOut, easeOutCubic, linear, motionValue, popIn, resolveSpring, reveal, settleValue, springStep, springValue, tweenValue };