@vielzeug/refine 1.5.4 → 1.7.0

package/dist/headless/nav.js

@@ -27,42 +27,56 @@ var r = (e, t, n) => {
 		next: ["ArrowDown"],
 		prev: ["ArrowUp"]
 	}
-}, o = (e) => typeof e == "object" && !!e && "disabled" in e, s = (s) => {
-	let c = n(-1), l = (e, t) => s.isItemDisabled?.(e, t) ?? (o(e) ? e.disabled : !1), u = (e, t, n) => (e >= 0 && (c.value = e, s.onNavigate?.(t, e, n)), e), d = (e, t, n) => n === "forward" ? r(e, t, (e, t) => !l(e, t)) : i(e, t, (e, t) => !l(e, t)), f = (e) => {
-		if (e < 0) return g(), -1;
-		let t = s.getItems();
+}, o = {
+	both: {
+		first: ["Home"],
+		last: ["End"],
+		next: ["ArrowDown", "ArrowLeft"],
+		prev: ["ArrowUp", "ArrowRight"]
+	},
+	horizontal: {
+		first: ["Home"],
+		last: ["End"],
+		next: ["ArrowLeft"],
+		prev: ["ArrowRight"]
+	},
+	vertical: a.vertical
+}, s = (e) => typeof e == "object" && !!e && "disabled" in e, c = (c) => {
+	let l = n(-1), u = (e, t) => c.isItemDisabled?.(e, t) ?? (s(e) ? e.disabled : !1), d = (e, t, n) => (e >= 0 && (l.value = e, c.onNavigate?.(t, e, n)), e), f = (e, t, n) => n === "forward" ? r(e, t, (e, t) => !u(e, t)) : i(e, t, (e, t) => !u(e, t)), p = (e) => {
+		if (e < 0) return _(), -1;
+		let t = c.getItems();
 		if (!t.length) return -1;
 		let n = Math.min(e, t.length - 1);
-		return l(t[n], n) ? -1 : (c.value = n, n);
-	}, p = (e, t) => {
-		let n = s.getItems(), r = c.value;
+		return u(t[n], n) ? -1 : (l.value = n, n);
+	}, m = (e, t) => {
+		let n = c.getItems(), r = l.value;
 		if (!n.length) return -1;
-		let i = r < 0 ? e === "forward" ? 0 : n.length - 1 : e === "forward" ? r + 1 : r - 1, a = d(n, i, e), o = e === "forward" ? "next" : "prev";
-		if (a >= 0) return u(a, o, t);
-		if (s.loop) {
-			let r = e === "forward" ? 0 : n.length - 1, i = d(n, r, e);
-			if (i >= 0) return u(i, o, t);
+		let i = r < 0 ? e === "forward" ? 0 : n.length - 1 : e === "forward" ? r + 1 : r - 1, a = f(n, i, e), o = e === "forward" ? "next" : "prev";
+		if (a >= 0) return d(a, o, t);
+		if (c.loop) {
+			let r = e === "forward" ? 0 : n.length - 1, i = f(n, r, e);
+			if (i >= 0) return d(i, o, t);
 		}
 		return r;
-	}, m = (e) => {
-		let t = s.getItems();
+	}, h = (e) => {
+		let t = c.getItems();
 		if (!t.length) return -1;
 		if (e === "first") {
-			let e = d(t, 0, "forward");
-			return u(e, "first");
+			let e = f(t, 0, "forward");
+			return d(e, "first");
 		}
 		if (e === "last") {
-			let e = d(t, t.length - 1, "backward");
-			return u(e, "last");
+			let e = f(t, t.length - 1, "backward");
+			return d(e, "last");
 		}
-		return p(e === "next" ? "forward" : "backward");
-	}, h = () => {
-		let e = s.getItems(), t = c.value;
-		return t >= 0 && t < e.length ? e[t] : void 0;
+		return m(e === "next" ? "forward" : "backward");
 	}, g = () => {
-		c.value = -1;
-	}, _ = () => !!s.disabled?.value, v = () => typeof s.orientation == "function" ? s.orientation() : s.orientation ?? "vertical", y = () => {
-		let e = s.keys, t = a[v()], n = {
+		let e = c.getItems(), t = l.value;
+		return t >= 0 && t < e.length ? e[t] : void 0;
+	}, _ = () => {
+		l.value = -1;
+	}, v = () => !!c.disabled?.value, y = () => typeof c.orientation == "function" ? c.orientation() : c.orientation ?? "vertical", b = () => typeof c.direction == "function" ? c.direction() : c.direction ?? "ltr", x = () => {
+		let e = c.keys, t = (b() === "rtl" ? o : a)[y()], n = {
 			first: e?.first ?? t.first,
 			last: e?.last ?? t.last,
 			next: e?.next ?? t.next,
@@ -75,41 +89,45 @@ var r = (e, t, n) => {
 			"last"
 		]) for (let t of n[e]) r[t] = (t) => {
 			if (e === "first" || e === "last") {
-				let n = s.getItems();
+				let n = c.getItems();
 				if (!n.length) return;
-				let r = e === "first" ? d(n, 0, "forward") : d(n, n.length - 1, "backward");
-				u(r, e, t);
-			} else p(e === "next" ? "forward" : "backward", t);
+				let r = e === "first" ? f(n, 0, "forward") : f(n, n.length - 1, "backward");
+				d(r, e, t);
+			} else m(e === "next" ? "forward" : "backward", t);
 		};
 		return r;
-	}, b = s.getItemLabel ? t({
-		getIndex: () => c.value,
-		getItemLabel: s.getItemLabel,
-		getItems: s.getItems,
-		isItemDisabled: (e, t) => l(e, t),
+	}, S = c.getItemLabel ? t({
+		getIndex: () => l.value,
+		getItemLabel: c.getItemLabel,
+		getItems: c.getItems,
+		isItemDisabled: (e, t) => u(e, t),
 		onNavigate: (e, t) => {
-			_() || (c.value = e, s.onNavigate?.("typeahead", e, t));
+			v() || (l.value = e, c.onNavigate?.("typeahead", e, t));
 		}
-	}) : null, x = typeof s.orientation == "function" ? null : y(), S = (t) => {
-		let n = x ?? y();
+	}) : null, C = typeof c.orientation == "function" || typeof c.direction == "function" ? null : x(), w = (t) => {
+		let n = C ?? x();
 		return e(t, {
-			disabled: s.disabled,
+			disabled: c.disabled,
 			keymap: n
-		}) ? !0 : b?.handleKeydown(t) ?? !1;
-	}, C = () => {
-		b?.reset();
+		}) ? !0 : S?.handleKeydown(t) ?? !1;
+	}, T = !1, E = () => {
+		T || (T = !0, S?.reset());
 	};
-	return s.signal && s.signal.addEventListener("abort", C, { once: !0 }), {
-		focusedIndex: c,
-		getActiveItem: h,
-		handleKeydown: S,
-		navigate: m,
-		reset: g,
-		set: f,
-		[Symbol.dispose]: C
+	return c.signal && c.signal.addEventListener("abort", E, { once: !0 }), {
+		dispose: E,
+		get disposed() {
+			return T;
+		},
+		focusedIndex: l,
+		getActiveItem: g,
+		handleKeydown: w,
+		navigate: h,
+		reset: _,
+		set: p,
+		[Symbol.dispose]: E
 	};
 };
 //#endregion
-export { s as createListControl };
+export { c as createListControl };
 
 //# sourceMappingURL=nav.js.map

package/dist/headless/nav.js.map

@@ -1 +1 @@
-{"version":3,"file":"nav.js","names":[],"sources":["../../src/headless/nav.ts"],"sourcesContent":["import { type Readable, signal } from '@vielzeug/ripple';\n\nimport { dispatchKeyboardAction } from './keyboard';\nimport { createTypeahead } from './typeahead';\n\n// ── Private array search helpers ────────────────────────────────────────────\nconst findForward = <T>(items: T[], start: number, predicate: (item: T, index: number) => boolean): number => {\n  for (let idx = start; idx < items.length; idx++) {\n    if (predicate(items[idx], idx)) return idx;\n  }\n\n  return -1;\n};\n\nconst findBackward = <T>(items: T[], start: number, predicate: (item: T, index: number) => boolean): number => {\n  for (let idx = start; idx >= 0; idx--) {\n    if (predicate(items[idx], idx)) return idx;\n  }\n\n  return -1;\n};\n\n// ── Types ─────────────────────────────────────────────────────────────────────\n\n/**\n * Arrow-key and Home/End navigation actions. Separate from `ListKeyAction` so\n * keymap declarations never need `Exclude<ListKeyAction, 'typeahead'>`.\n */\nexport type ListNavigationAction = 'first' | 'last' | 'next' | 'prev';\n\n/**\n * All possible navigation action names, including `'typeahead'` (character-key\n * search). Used in `onNavigate` callbacks where both nav and typeahead are valid.\n */\nexport type ListKeyAction = ListNavigationAction | 'typeahead';\n\n/**\n * Orientation-aware default key bindings for list navigation.\n * - `'vertical'` (default): Up/Down arrows, Home/End\n * - `'horizontal'`: Left/Right arrows, Home/End\n * - `'both'`: all four arrow keys + Home/End\n */\nconst DEFAULT_KEYS: Record<'both' | 'horizontal' | 'vertical', Record<ListNavigationAction, string[]>> = {\n  both: { first: ['Home'], last: ['End'], next: ['ArrowDown', 'ArrowRight'], prev: ['ArrowUp', 'ArrowLeft'] },\n  horizontal: { first: ['Home'], last: ['End'], next: ['ArrowRight'], prev: ['ArrowLeft'] },\n  vertical: { first: ['Home'], last: ['End'], next: ['ArrowDown'], prev: ['ArrowUp'] },\n};\n\nexport type ListNavigationOptions<T> = {\n  disabled?: Readable<boolean | undefined>;\n  /**\n   * Returns a plain-text label for an item used by typeahead search.\n   * When provided, pressing a printable character key jumps to the first enabled\n   * item whose label starts with the accumulated type buffer (500 ms reset window).\n   * Omit for contexts where the host element is a text input (e.g. combobox).\n   */\n  getItemLabel?: (item: T, index: number) => string;\n  getItems: () => T[];\n  isItemDisabled?: (item: T, index: number) => boolean;\n  /** Override default key bindings for navigation actions. */\n  keys?: Partial<Record<ListNavigationAction, string[]>>;\n  loop?: boolean;\n  /**\n   * Called when navigation lands on a new index.\n   * `event` is the originating `KeyboardEvent`, or `undefined` for programmatic navigation.\n   * Use to sync side-effects such as focusing a DOM element.\n   */\n  onNavigate?: (action: ListKeyAction, index: number, event?: KeyboardEvent) => void;\n  /**\n   * Axis the list navigates along. Controls which arrow keys are treated as\n   * `next`/`prev` when no explicit `keys` override is provided.\n   * Pass a getter function for dynamic/reactive orientation (e.g. driven by a prop signal).\n   *\n   * - `'vertical'` (default): ↑↓ arrows\n   * - `'horizontal'`: ←→ arrows\n   * - `'both'`: all four arrow keys\n   */\n  orientation?: 'both' | 'horizontal' | 'vertical' | (() => 'both' | 'horizontal' | 'vertical');\n  /** `AbortSignal` from the component lifecycle. Disposes typeahead timer on abort. */\n  signal?: AbortSignal;\n};\n\nexport type ListControl<T> = {\n  [Symbol.dispose](): void;\n  /** Current focused index. `-1` when nothing is focused. */\n  readonly focusedIndex: Readable<number>;\n  getActiveItem(): T | undefined;\n  handleKeydown(event: KeyboardEvent): boolean;\n  /**\n   * Programmatically navigate to a named position.\n   * Always fires `onNavigate` — consistent with keyboard navigation.\n   * Returns the resolved index, or `-1` if no enabled item was found.\n   */\n  navigate(action: ListNavigationAction): number;\n  /** Reset focused index to `-1`. */\n  reset(): void;\n  /**\n   * Set focus to the item at `index`. Returns the resolved index.\n   * Pass a negative index to clear focus (same as `reset()`).\n   */\n  set(index: number): number;\n};\n\nconst hasDisabledProp = (item: unknown): item is { disabled: boolean } =>\n  typeof item === 'object' && item !== null && 'disabled' in item;\n\nexport const createListControl = <T>(options: ListNavigationOptions<T>): ListControl<T> => {\n  const _index = signal(-1);\n\n  const isItemDisabled = (item: T, index: number): boolean =>\n    options.isItemDisabled?.(item, index) ?? (hasDisabledProp(item) ? item.disabled : false);\n\n  const commitIndex = (idx: number, action: ListKeyAction, event?: KeyboardEvent): number => {\n    if (idx >= 0) {\n      _index.value = idx;\n      options.onNavigate?.(action, idx, event);\n    }\n\n    return idx;\n  };\n\n  const findEnabledIndex = (items: T[], start: number, direction: 'forward' | 'backward'): number => {\n    if (direction === 'forward') return findForward(items, start, (item, i) => !isItemDisabled(item, i));\n\n    return findBackward(items, start, (item, i) => !isItemDisabled(item, i));\n  };\n\n  const set = (index: number): number => {\n    if (index < 0) {\n      reset();\n\n      return -1;\n    }\n\n    const items = options.getItems();\n\n    if (!items.length) return -1;\n\n    const clamped = Math.min(index, items.length - 1);\n\n    if (isItemDisabled(items[clamped], clamped)) return -1;\n\n    _index.value = clamped;\n\n    return clamped;\n  };\n\n  const move = (direction: 'forward' | 'backward', event?: KeyboardEvent): number => {\n    const items = options.getItems();\n    const current = _index.value;\n\n    if (!items.length) return -1;\n\n    const start: number =\n      current < 0\n        ? direction === 'forward'\n          ? 0\n          : items.length - 1\n        : direction === 'forward'\n          ? current + 1\n          : current - 1;\n    const idx = findEnabledIndex(items, start, direction);\n    const action: ListNavigationAction = direction === 'forward' ? 'next' : 'prev';\n\n    if (idx >= 0) return commitIndex(idx, action, event);\n\n    if (options.loop) {\n      const wrapStart = direction === 'forward' ? 0 : items.length - 1;\n      const wrapped = findEnabledIndex(items, wrapStart, direction);\n\n      if (wrapped >= 0) return commitIndex(wrapped, action, event);\n    }\n\n    return current;\n  };\n\n  const navigate = (action: ListNavigationAction): number => {\n    const items = options.getItems();\n\n    if (!items.length) return -1;\n\n    if (action === 'first') {\n      const idx = findEnabledIndex(items, 0, 'forward');\n\n      return commitIndex(idx, 'first');\n    }\n\n    if (action === 'last') {\n      const idx = findEnabledIndex(items, items.length - 1, 'backward');\n\n      return commitIndex(idx, 'last');\n    }\n\n    return move(action === 'next' ? 'forward' : 'backward');\n  };\n\n  const getActiveItem = (): T | undefined => {\n    const items = options.getItems();\n    const index = _index.value;\n\n    return index >= 0 && index < items.length ? items[index] : undefined;\n  };\n\n  const reset = (): void => {\n    _index.value = -1;\n  };\n\n  // ── Keyboard handling ──────────────────────────────────────────────────────\n\n  const isKeyDisabled = (): boolean => Boolean(options.disabled?.value);\n\n  const resolveOrientation = (): 'both' | 'horizontal' | 'vertical' =>\n    typeof options.orientation === 'function' ? options.orientation() : (options.orientation ?? 'vertical');\n\n  const buildKeymap = (): Record<string, (keyboardEvent: KeyboardEvent) => void> => {\n    const keys = options.keys;\n    const orientationDefaults = DEFAULT_KEYS[resolveOrientation()];\n    const resolved = {\n      first: keys?.first ?? orientationDefaults.first,\n      last: keys?.last ?? orientationDefaults.last,\n      next: keys?.next ?? orientationDefaults.next,\n      prev: keys?.prev ?? orientationDefaults.prev,\n    };\n    const km: Record<string, (keyboardEvent: KeyboardEvent) => void> = {};\n\n    for (const action of ['next', 'prev', 'first', 'last'] as const) {\n      for (const key of resolved[action]) {\n        km[key] = (keyboardEvent: KeyboardEvent) => {\n          if (action === 'first' || action === 'last') {\n            const items = options.getItems();\n\n            if (!items.length) return;\n\n            const idx =\n              action === 'first'\n                ? findEnabledIndex(items, 0, 'forward')\n                : findEnabledIndex(items, items.length - 1, 'backward');\n\n            commitIndex(idx, action, keyboardEvent);\n          } else {\n            move(action === 'next' ? 'forward' : 'backward', keyboardEvent);\n          }\n        };\n      }\n    }\n\n    return km;\n  };\n\n  // ── Typeahead ──────────────────────────────────────────────────────────────\n\n  const typeahead = options.getItemLabel\n    ? createTypeahead({\n        getIndex: () => _index.value,\n        getItemLabel: options.getItemLabel,\n        getItems: options.getItems,\n        isItemDisabled: (item, index) => isItemDisabled(item, index),\n        onNavigate: (index, event) => {\n          if (!isKeyDisabled()) {\n            _index.value = index;\n            options.onNavigate?.('typeahead', index, event);\n          }\n        },\n      })\n    : null;\n\n  const _staticKeymap: Record<string, (e: KeyboardEvent) => void> | null =\n    typeof options.orientation === 'function' ? null : buildKeymap();\n\n  const handleKeydown = (event: KeyboardEvent): boolean => {\n    const km = _staticKeymap ?? buildKeymap();\n\n    if (dispatchKeyboardAction(event, { disabled: options.disabled, keymap: km })) return true;\n\n    return typeahead?.handleKeydown(event) ?? false;\n  };\n\n  const dispose = (): void => {\n    typeahead?.reset();\n  };\n\n  if (options.signal) {\n    options.signal.addEventListener('abort', dispose, { once: true });\n  }\n\n  return {\n    focusedIndex: _index,\n    getActiveItem,\n    handleKeydown,\n    navigate,\n    reset,\n    set,\n    [Symbol.dispose]: dispose,\n  };\n};\n"],"mappings":"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"}
+{"version":3,"file":"nav.js","names":[],"sources":["../../src/headless/nav.ts"],"sourcesContent":["import { type Readable, signal } from '@vielzeug/ripple';\n\nimport { dispatchKeyboardAction } from './keyboard';\nimport { createTypeahead } from './typeahead';\n\n// ── Private array search helpers ────────────────────────────────────────────\nconst findForward = <T>(items: T[], start: number, predicate: (item: T, index: number) => boolean): number => {\n  for (let idx = start; idx < items.length; idx++) {\n    if (predicate(items[idx], idx)) return idx;\n  }\n\n  return -1;\n};\n\nconst findBackward = <T>(items: T[], start: number, predicate: (item: T, index: number) => boolean): number => {\n  for (let idx = start; idx >= 0; idx--) {\n    if (predicate(items[idx], idx)) return idx;\n  }\n\n  return -1;\n};\n\n// ── Types ─────────────────────────────────────────────────────────────────────\n\n/**\n * Arrow-key and Home/End navigation actions. Separate from `ListKeyAction` so\n * keymap declarations never need `Exclude<ListKeyAction, 'typeahead'>`.\n */\nexport type ListNavigationAction = 'first' | 'last' | 'next' | 'prev';\n\n/**\n * All possible navigation action names, including `'typeahead'` (character-key\n * search). Used in `onNavigate` callbacks where both nav and typeahead are valid.\n */\nexport type ListKeyAction = ListNavigationAction | 'typeahead';\n\n/**\n * Orientation-aware default key bindings for list navigation.\n * - `'vertical'` (default): Up/Down arrows, Home/End\n * - `'horizontal'`: Left/Right arrows, Home/End\n * - `'both'`: all four arrow keys + Home/End\n */\nconst DEFAULT_KEYS: Record<'both' | 'horizontal' | 'vertical', Record<ListNavigationAction, string[]>> = {\n  both: { first: ['Home'], last: ['End'], next: ['ArrowDown', 'ArrowRight'], prev: ['ArrowUp', 'ArrowLeft'] },\n  horizontal: { first: ['Home'], last: ['End'], next: ['ArrowRight'], prev: ['ArrowLeft'] },\n  vertical: { first: ['Home'], last: ['End'], next: ['ArrowDown'], prev: ['ArrowUp'] },\n};\n\n/**\n * RTL mirror of `DEFAULT_KEYS`'s horizontal component (per WAI-ARIA APG — tabs/radiogroup\n * flip Left/Right in `dir=\"rtl\"` so \"next\" always advances in reading order, not screen-space\n * direction). Only the Left/Right bindings differ; Home/End and the vertical arrows are\n * direction-independent and stay identical to `DEFAULT_KEYS`.\n */\nconst DEFAULT_KEYS_RTL: Record<'both' | 'horizontal' | 'vertical', Record<ListNavigationAction, string[]>> = {\n  both: { first: ['Home'], last: ['End'], next: ['ArrowDown', 'ArrowLeft'], prev: ['ArrowUp', 'ArrowRight'] },\n  horizontal: { first: ['Home'], last: ['End'], next: ['ArrowLeft'], prev: ['ArrowRight'] },\n  vertical: DEFAULT_KEYS.vertical,\n};\n\nexport type ListNavigationOptions<T> = {\n  /**\n   * Text direction, used to mirror the default Left/Right arrow-key bindings for\n   * `'horizontal'`/`'both'` orientation (WAI-ARIA APG: `dir=\"rtl\"` flips which arrow key\n   * means \"next\" vs \"prev\"). Pass a getter for dynamic/reactive direction (e.g. derived from\n   * `elementDirection(getHost())`, since a `dir` ancestor attribute can change at runtime).\n   * Has no effect when an explicit `keys` override is provided. Defaults to `'ltr'`.\n   */\n  direction?: 'ltr' | 'rtl' | (() => 'ltr' | 'rtl');\n  disabled?: Readable<boolean | undefined>;\n  /**\n   * Returns a plain-text label for an item used by typeahead search.\n   * When provided, pressing a printable character key jumps to the first enabled\n   * item whose label starts with the accumulated type buffer (500 ms reset window).\n   * Omit for contexts where the host element is a text input (e.g. combobox).\n   */\n  getItemLabel?: (item: T, index: number) => string;\n  getItems: () => T[];\n  isItemDisabled?: (item: T, index: number) => boolean;\n  /** Override default key bindings for navigation actions. */\n  keys?: Partial<Record<ListNavigationAction, string[]>>;\n  loop?: boolean;\n  /**\n   * Called when navigation lands on a new index.\n   * `event` is the originating `KeyboardEvent`, or `undefined` for programmatic navigation.\n   * Use to sync side-effects such as focusing a DOM element.\n   */\n  onNavigate?: (action: ListKeyAction, index: number, event?: KeyboardEvent) => void;\n  /**\n   * Axis the list navigates along. Controls which arrow keys are treated as\n   * `next`/`prev` when no explicit `keys` override is provided.\n   * Pass a getter function for dynamic/reactive orientation (e.g. driven by a prop signal).\n   *\n   * - `'vertical'` (default): ↑↓ arrows\n   * - `'horizontal'`: ←→ arrows\n   * - `'both'`: all four arrow keys\n   */\n  orientation?: 'both' | 'horizontal' | 'vertical' | (() => 'both' | 'horizontal' | 'vertical');\n  /** `AbortSignal` from the component lifecycle. Disposes typeahead timer on abort. */\n  signal?: AbortSignal;\n};\n\nexport type ListControl<T> = {\n  [Symbol.dispose](): void;\n  /** Disposes the internal typeahead timer. Alias for `dispose()`. Conforms to the monorepo disposal convention. */\n  dispose(): void;\n  /** `true` after `dispose()` has been called. */\n  readonly disposed: boolean;\n  /** Current focused index. `-1` when nothing is focused. */\n  readonly focusedIndex: Readable<number>;\n  getActiveItem(): T | undefined;\n  handleKeydown(event: KeyboardEvent): boolean;\n  /**\n   * Programmatically navigate to a named position.\n   * Always fires `onNavigate` — consistent with keyboard navigation.\n   * Returns the resolved index, or `-1` if no enabled item was found.\n   */\n  navigate(action: ListNavigationAction): number;\n  /** Reset focused index to `-1`. */\n  reset(): void;\n  /**\n   * Set focus to the item at `index`. Returns the resolved index.\n   * Pass a negative index to clear focus (same as `reset()`).\n   */\n  set(index: number): number;\n};\n\nconst hasDisabledProp = (item: unknown): item is { disabled: boolean } =>\n  typeof item === 'object' && item !== null && 'disabled' in item;\n\nexport const createListControl = <T>(options: ListNavigationOptions<T>): ListControl<T> => {\n  const _index = signal(-1);\n\n  const isItemDisabled = (item: T, index: number): boolean =>\n    options.isItemDisabled?.(item, index) ?? (hasDisabledProp(item) ? item.disabled : false);\n\n  const commitIndex = (idx: number, action: ListKeyAction, event?: KeyboardEvent): number => {\n    if (idx >= 0) {\n      _index.value = idx;\n      options.onNavigate?.(action, idx, event);\n    }\n\n    return idx;\n  };\n\n  const findEnabledIndex = (items: T[], start: number, direction: 'forward' | 'backward'): number => {\n    if (direction === 'forward') return findForward(items, start, (item, i) => !isItemDisabled(item, i));\n\n    return findBackward(items, start, (item, i) => !isItemDisabled(item, i));\n  };\n\n  const set = (index: number): number => {\n    if (index < 0) {\n      reset();\n\n      return -1;\n    }\n\n    const items = options.getItems();\n\n    if (!items.length) return -1;\n\n    const clamped = Math.min(index, items.length - 1);\n\n    if (isItemDisabled(items[clamped], clamped)) return -1;\n\n    _index.value = clamped;\n\n    return clamped;\n  };\n\n  const move = (direction: 'forward' | 'backward', event?: KeyboardEvent): number => {\n    const items = options.getItems();\n    const current = _index.value;\n\n    if (!items.length) return -1;\n\n    const start: number =\n      current < 0\n        ? direction === 'forward'\n          ? 0\n          : items.length - 1\n        : direction === 'forward'\n          ? current + 1\n          : current - 1;\n    const idx = findEnabledIndex(items, start, direction);\n    const action: ListNavigationAction = direction === 'forward' ? 'next' : 'prev';\n\n    if (idx >= 0) return commitIndex(idx, action, event);\n\n    if (options.loop) {\n      const wrapStart = direction === 'forward' ? 0 : items.length - 1;\n      const wrapped = findEnabledIndex(items, wrapStart, direction);\n\n      if (wrapped >= 0) return commitIndex(wrapped, action, event);\n    }\n\n    return current;\n  };\n\n  const navigate = (action: ListNavigationAction): number => {\n    const items = options.getItems();\n\n    if (!items.length) return -1;\n\n    if (action === 'first') {\n      const idx = findEnabledIndex(items, 0, 'forward');\n\n      return commitIndex(idx, 'first');\n    }\n\n    if (action === 'last') {\n      const idx = findEnabledIndex(items, items.length - 1, 'backward');\n\n      return commitIndex(idx, 'last');\n    }\n\n    return move(action === 'next' ? 'forward' : 'backward');\n  };\n\n  const getActiveItem = (): T | undefined => {\n    const items = options.getItems();\n    const index = _index.value;\n\n    return index >= 0 && index < items.length ? items[index] : undefined;\n  };\n\n  const reset = (): void => {\n    _index.value = -1;\n  };\n\n  // ── Keyboard handling ──────────────────────────────────────────────────────\n\n  const isKeyDisabled = (): boolean => Boolean(options.disabled?.value);\n\n  const resolveOrientation = (): 'both' | 'horizontal' | 'vertical' =>\n    typeof options.orientation === 'function' ? options.orientation() : (options.orientation ?? 'vertical');\n\n  const resolveDirection = (): 'ltr' | 'rtl' =>\n    typeof options.direction === 'function' ? options.direction() : (options.direction ?? 'ltr');\n\n  const buildKeymap = (): Record<string, (keyboardEvent: KeyboardEvent) => void> => {\n    const keys = options.keys;\n    const keyTable = resolveDirection() === 'rtl' ? DEFAULT_KEYS_RTL : DEFAULT_KEYS;\n    const orientationDefaults = keyTable[resolveOrientation()];\n    const resolved = {\n      first: keys?.first ?? orientationDefaults.first,\n      last: keys?.last ?? orientationDefaults.last,\n      next: keys?.next ?? orientationDefaults.next,\n      prev: keys?.prev ?? orientationDefaults.prev,\n    };\n    const km: Record<string, (keyboardEvent: KeyboardEvent) => void> = {};\n\n    for (const action of ['next', 'prev', 'first', 'last'] as const) {\n      for (const key of resolved[action]) {\n        km[key] = (keyboardEvent: KeyboardEvent) => {\n          if (action === 'first' || action === 'last') {\n            const items = options.getItems();\n\n            if (!items.length) return;\n\n            const idx =\n              action === 'first'\n                ? findEnabledIndex(items, 0, 'forward')\n                : findEnabledIndex(items, items.length - 1, 'backward');\n\n            commitIndex(idx, action, keyboardEvent);\n          } else {\n            move(action === 'next' ? 'forward' : 'backward', keyboardEvent);\n          }\n        };\n      }\n    }\n\n    return km;\n  };\n\n  // ── Typeahead ──────────────────────────────────────────────────────────────\n\n  const typeahead = options.getItemLabel\n    ? createTypeahead({\n        getIndex: () => _index.value,\n        getItemLabel: options.getItemLabel,\n        getItems: options.getItems,\n        isItemDisabled: (item, index) => isItemDisabled(item, index),\n        onNavigate: (index, event) => {\n          if (!isKeyDisabled()) {\n            _index.value = index;\n            options.onNavigate?.('typeahead', index, event);\n          }\n        },\n      })\n    : null;\n\n  // Keymap depends on both orientation and direction — if either is dynamic, rebuild on every\n  // keydown instead of caching once.\n  const isDynamicKeymap = typeof options.orientation === 'function' || typeof options.direction === 'function';\n  const _staticKeymap: Record<string, (e: KeyboardEvent) => void> | null = isDynamicKeymap ? null : buildKeymap();\n\n  const handleKeydown = (event: KeyboardEvent): boolean => {\n    const km = _staticKeymap ?? buildKeymap();\n\n    if (dispatchKeyboardAction(event, { disabled: options.disabled, keymap: km })) return true;\n\n    return typeahead?.handleKeydown(event) ?? false;\n  };\n\n  let disposed = false;\n\n  const dispose = (): void => {\n    if (disposed) return;\n\n    disposed = true;\n    typeahead?.reset();\n  };\n\n  if (options.signal) {\n    options.signal.addEventListener('abort', dispose, { once: true });\n  }\n\n  return {\n    dispose,\n    get disposed() {\n      return disposed;\n    },\n    focusedIndex: _index,\n    getActiveItem,\n    handleKeydown,\n    navigate,\n    reset,\n    set,\n    [Symbol.dispose]: dispose,\n  };\n};\n"],"mappings":";;;;AAMA,IAAM,KAAkB,GAAY,GAAe,MAA2D;CAC5G,KAAK,IAAI,IAAM,GAAO,IAAM,EAAM,QAAQ,KACxC,IAAI,EAAU,EAAM,IAAM,CAAG,GAAG,OAAO;CAGzC,OAAO;AACT,GAEM,KAAmB,GAAY,GAAe,MAA2D;CAC7G,KAAK,IAAI,IAAM,GAAO,KAAO,GAAG,KAC9B,IAAI,EAAU,EAAM,IAAM,CAAG,GAAG,OAAO;CAGzC,OAAO;AACT,GAsBM,IAAmG;CACvG,MAAM;EAAE,OAAO,CAAC,MAAM;EAAG,MAAM,CAAC,KAAK;EAAG,MAAM,CAAC,aAAa,YAAY;EAAG,MAAM,CAAC,WAAW,WAAW;CAAE;CAC1G,YAAY;EAAE,OAAO,CAAC,MAAM;EAAG,MAAM,CAAC,KAAK;EAAG,MAAM,CAAC,YAAY;EAAG,MAAM,CAAC,WAAW;CAAE;CACxF,UAAU;EAAE,OAAO,CAAC,MAAM;EAAG,MAAM,CAAC,KAAK;EAAG,MAAM,CAAC,WAAW;EAAG,MAAM,CAAC,SAAS;CAAE;AACrF,GAQM,IAAuG;CAC3G,MAAM;EAAE,OAAO,CAAC,MAAM;EAAG,MAAM,CAAC,KAAK;EAAG,MAAM,CAAC,aAAa,WAAW;EAAG,MAAM,CAAC,WAAW,YAAY;CAAE;CAC1G,YAAY;EAAE,OAAO,CAAC,MAAM;EAAG,MAAM,CAAC,KAAK;EAAG,MAAM,CAAC,WAAW;EAAG,MAAM,CAAC,YAAY;CAAE;CACxF,UAAU,EAAa;AACzB,GAqEM,KAAmB,MACvB,OAAO,KAAS,cAAY,KAAiB,cAAc,GAEhD,KAAwB,MAAsD;CACzF,IAAM,IAAS,EAAO,EAAE,GAElB,KAAkB,GAAS,MAC/B,EAAQ,iBAAiB,GAAM,CAAK,MAAM,EAAgB,CAAI,IAAI,EAAK,WAAW,KAE9E,KAAe,GAAa,GAAuB,OACnD,KAAO,MACT,EAAO,QAAQ,GACf,EAAQ,aAAa,GAAQ,GAAK,CAAK,IAGlC,IAGH,KAAoB,GAAY,GAAe,MAC/C,MAAc,YAAkB,EAAY,GAAO,IAAQ,GAAM,MAAM,CAAC,EAAe,GAAM,CAAC,CAAC,IAE5F,EAAa,GAAO,IAAQ,GAAM,MAAM,CAAC,EAAe,GAAM,CAAC,CAAC,GAGnE,KAAO,MAA0B;EACrC,IAAI,IAAQ,GAGV,OAFA,EAAM,GAEC;EAGT,IAAM,IAAQ,EAAQ,SAAS;EAE/B,IAAI,CAAC,EAAM,QAAQ,OAAO;EAE1B,IAAM,IAAU,KAAK,IAAI,GAAO,EAAM,SAAS,CAAC;EAMhD,OAJI,EAAe,EAAM,IAAU,CAAO,IAAU,MAEpD,EAAO,QAAQ,GAER;CACT,GAEM,KAAQ,GAAmC,MAAkC;EACjF,IAAM,IAAQ,EAAQ,SAAS,GACzB,IAAU,EAAO;EAEvB,IAAI,CAAC,EAAM,QAAQ,OAAO;EAE1B,IAAM,IACJ,IAAU,IACN,MAAc,YACZ,IACA,EAAM,SAAS,IACjB,MAAc,YACZ,IAAU,IACV,IAAU,GACZ,IAAM,EAAiB,GAAO,GAAO,CAAS,GAC9C,IAA+B,MAAc,YAAY,SAAS;EAExE,IAAI,KAAO,GAAG,OAAO,EAAY,GAAK,GAAQ,CAAK;EAEnD,IAAI,EAAQ,MAAM;GAChB,IAAM,IAAY,MAAc,YAAY,IAAI,EAAM,SAAS,GACzD,IAAU,EAAiB,GAAO,GAAW,CAAS;GAE5D,IAAI,KAAW,GAAG,OAAO,EAAY,GAAS,GAAQ,CAAK;EAC7D;EAEA,OAAO;CACT,GAEM,KAAY,MAAyC;EACzD,IAAM,IAAQ,EAAQ,SAAS;EAE/B,IAAI,CAAC,EAAM,QAAQ,OAAO;EAE1B,IAAI,MAAW,SAAS;GACtB,IAAM,IAAM,EAAiB,GAAO,GAAG,SAAS;GAEhD,OAAO,EAAY,GAAK,OAAO;EACjC;EAEA,IAAI,MAAW,QAAQ;GACrB,IAAM,IAAM,EAAiB,GAAO,EAAM,SAAS,GAAG,UAAU;GAEhE,OAAO,EAAY,GAAK,MAAM;EAChC;EAEA,OAAO,EAAK,MAAW,SAAS,YAAY,UAAU;CACxD,GAEM,UAAqC;EACzC,IAAM,IAAQ,EAAQ,SAAS,GACzB,IAAQ,EAAO;EAErB,OAAO,KAAS,KAAK,IAAQ,EAAM,SAAS,EAAM,KAAS,KAAA;CAC7D,GAEM,UAAoB;EACxB,EAAO,QAAQ;CACjB,GAIM,UAA+B,EAAQ,EAAQ,UAAU,OAEzD,UACJ,OAAO,EAAQ,eAAgB,aAAa,EAAQ,YAAY,IAAK,EAAQ,eAAe,YAExF,UACJ,OAAO,EAAQ,aAAc,aAAa,EAAQ,UAAU,IAAK,EAAQ,aAAa,OAElF,UAA4E;EAChF,IAAM,IAAO,EAAQ,MAEf,KADW,EAAiB,MAAM,QAAQ,IAAmB,EAAA,CAC9B,EAAmB,IAClD,IAAW;GACf,OAAO,GAAM,SAAS,EAAoB;GAC1C,MAAM,GAAM,QAAQ,EAAoB;GACxC,MAAM,GAAM,QAAQ,EAAoB;GACxC,MAAM,GAAM,QAAQ,EAAoB;EAC1C,GACM,IAA6D,CAAC;EAEpE,KAAK,IAAM,KAAU;GAAC;GAAQ;GAAQ;GAAS;EAAM,GACnD,KAAK,IAAM,KAAO,EAAS,IACzB,EAAG,MAAQ,MAAiC;GAC1C,IAAI,MAAW,WAAW,MAAW,QAAQ;IAC3C,IAAM,IAAQ,EAAQ,SAAS;IAE/B,IAAI,CAAC,EAAM,QAAQ;IAEnB,IAAM,IACJ,MAAW,UACP,EAAiB,GAAO,GAAG,SAAS,IACpC,EAAiB,GAAO,EAAM,SAAS,GAAG,UAAU;IAE1D,EAAY,GAAK,GAAQ,CAAa;GACxC,OACE,EAAK,MAAW,SAAS,YAAY,YAAY,CAAa;EAElE;EAIJ,OAAO;CACT,GAIM,IAAY,EAAQ,eACtB,EAAgB;EACd,gBAAgB,EAAO;EACvB,cAAc,EAAQ;EACtB,UAAU,EAAQ;EAClB,iBAAiB,GAAM,MAAU,EAAe,GAAM,CAAK;EAC3D,aAAa,GAAO,MAAU;GAC5B,AAAK,EAAc,MACjB,EAAO,QAAQ,GACf,EAAQ,aAAa,aAAa,GAAO,CAAK;EAElD;CACF,CAAC,IACD,MAKE,IADkB,OAAO,EAAQ,eAAgB,cAAc,OAAO,EAAQ,aAAc,aACP,OAAO,EAAY,GAExG,KAAiB,MAAkC;EACvD,IAAM,IAAK,KAAiB,EAAY;EAIxC,OAFI,EAAuB,GAAO;GAAE,UAAU,EAAQ;GAAU,QAAQ;EAAG,CAAC,IAAU,KAE/E,GAAW,cAAc,CAAK,KAAK;CAC5C,GAEI,IAAW,IAET,UAAsB;EACtB,MAEJ,IAAW,IACX,GAAW,MAAM;CACnB;CAMA,OAJI,EAAQ,UACV,EAAQ,OAAO,iBAAiB,SAAS,GAAS,EAAE,MAAM,GAAK,CAAC,GAG3D;EACL;EACA,IAAI,WAAW;GACb,OAAO;EACT;EACA,cAAc;EACd;EACA;EACA;EACA;EACA;GACC,OAAO,UAAU;CACpB;AACF"}

package/dist/headless/overlay.cjs

@@ -1,2 +1,2 @@
-var e=e=>{let t=null,n=()=>typeof e.restoreFocus==`function`?e.restoreFocus():e.restoreFocus??!0,r=t=>{if(!e.isOpen())return;let n=t.composedPath?.()??[],r=e.getBoundary(),i=e.getPanel?.()??null,a=n[0]??t.target,s=a instanceof Node?a:null,c=n.some(e=>e===r||e===i),l=s?(r?.contains(s)??!1)||(i?.contains(s)??!1):!1;!c&&!l&&o(`outsideClick`)},i=e=>{e?document.addEventListener(`pointerdown`,r,{capture:!0}):document.removeEventListener(`pointerdown`,r,{capture:!0})},a=(n=`programmatic`)=>{e.isDisabled?.()||e.isOpen()||(e.setOpen(!0,n),i(!0),e.positioner&&(e.positioner.update(),t=e.positioner.startAutoUpdate?.()??null),e.onOpen?.(n))},o=(r=`programmatic`,a,o=!1)=>{e.isOpen()&&(e.setOpen(!1,r),i(!1),t&&=(t(),null),(a??n())&&e.getTrigger?.()?.focus(),o||e.onClose?.(r))},s=(t=`click`,n=`trigger`)=>{e.isOpen()?o(n):a(t)},c=()=>{e.isOpen()&&o(`programmatic`,!1,!0),i(!1),t&&=(t(),null)};return e.signal.addEventListener(`abort`,c,{once:!0}),{close:o,dispose:c,open:a,[Symbol.dispose]:c,toggle:s}};exports.createOverlayControl=e;
+var e=e=>{let t=null,n=()=>typeof e.restoreFocus==`function`?e.restoreFocus():e.restoreFocus??!0,r=t=>{if(!e.isOpen())return;let n=t.composedPath?.()??[],r=e.getBoundary(),i=e.getPanel?.()??null,a=n[0]??t.target,s=a instanceof Node?a:null,c=n.some(e=>e===r||e===i),l=s?(r?.contains(s)??!1)||(i?.contains(s)??!1):!1;!c&&!l&&o(`outsideClick`)},i=e=>{e?document.addEventListener(`pointerdown`,r,{capture:!0}):document.removeEventListener(`pointerdown`,r,{capture:!0})},a=(n=`programmatic`)=>{e.isDisabled?.()||e.isOpen()||(e.setOpen(!0,n),i(!0),e.positioner&&(e.positioner.update(),t=e.positioner.startAutoUpdate?.()??null),e.onOpen?.(n))},o=(r=`programmatic`,a,o=!1)=>{e.isOpen()&&(e.setOpen(!1,r),i(!1),t&&=(t(),null),(a??n())&&e.getTrigger?.()?.focus(),o||e.onClose?.(r))},s=(t=`click`,n=`trigger`)=>{e.isOpen()?o(n):a(t)},c=!1,l=()=>{c||(c=!0,e.isOpen()&&o(`programmatic`,!1,!0),i(!1),t&&=(t(),null))};return e.signal.addEventListener(`abort`,l,{once:!0}),{close:o,dispose:l,get disposed(){return c},open:a,[Symbol.dispose]:l,toggle:s}};exports.createOverlayControl=e;
 //# sourceMappingURL=overlay.cjs.map

package/dist/headless/overlay.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"overlay.cjs","names":[],"sources":["../../src/headless/overlay.ts"],"sourcesContent":["import type { OverlayPositioner } from './positioner';\n\n// ── Types ─────────────────────────────────────────────────────────────────────\n\n/**\n * Why an overlay was opened.\n * - `'click'`       — user clicked the trigger element\n * - `'focus'`       — focus entered the trigger (tooltip, popover)\n * - `'hover'`       — pointer entered the trigger (tooltip)\n * - `'keyboard'`    — keyboard shortcut or Enter/Space on a trigger\n * - `'programmatic'` — opened via the JS API without a user gesture\n * - `'trigger'`     — opened via the Invoker Commands API (`command=\"show-modal\"`)\n */\nexport type OverlayOpenReason = 'click' | 'focus' | 'hover' | 'keyboard' | 'programmatic' | 'trigger';\n\n/** Close reasons valid for modal dialogs (includes 'swipe' for drawer). */\nexport type DialogCloseReason = 'escape' | 'outsideClick' | 'programmatic' | 'swipe' | 'trigger';\n/** Close reasons valid for dropdown overlays (no swipe). */\nexport type DropdownCloseReason = Exclude<DialogCloseReason, 'swipe'>;\n\n/** Detail shape for overlay open events emitted by components. */\nexport type OverlayOpenDetail = { reason: OverlayOpenReason };\n/** Detail shape for overlay close events emitted by components. */\nexport type OverlayCloseDetail = { reason: DialogCloseReason };\n\nexport type { OverlayPositioner };\n\nexport type OverlayControlOptions = {\n  getBoundary: () => HTMLElement | null;\n  getPanel?: () => HTMLElement | null;\n  getTrigger?: () => HTMLElement | null;\n  isDisabled?: () => boolean;\n  isOpen: () => boolean;\n  onClose?: (reason: DialogCloseReason) => void;\n  onOpen?: (reason: OverlayOpenReason) => void;\n  positioner?: OverlayPositioner;\n  restoreFocus?: boolean | (() => boolean);\n  setOpen: (next: boolean, reason: OverlayOpenReason | DialogCloseReason) => void;\n  /** `AbortSignal` from the component lifecycle. `dispose()` is called automatically on abort. */\n  signal: AbortSignal;\n};\n\nexport type OverlayControl = {\n  [Symbol.dispose](): void;\n  /**\n   * Closes the overlay.\n   * @param reason — why it's closing (default `'programmatic'`)\n   * @param restoreFocus — override per-call focus restoration (default: uses `restoreFocus` option)\n   */\n  close(reason?: DialogCloseReason, restoreFocus?: boolean): void;\n  /** Tears down the overlay: closes silently and removes all event listeners. */\n  dispose(): void;\n  /**\n   * Opens the overlay.\n   * @param reason — why it's opening (default `'programmatic'`)\n   */\n  open(reason?: OverlayOpenReason): void;\n  /**\n   * Toggles open state.\n   * - Opens with `openReason` (default `'click'`).\n   * - Closes with `closeReason` (default `'trigger'`).\n   */\n  toggle(openReason?: OverlayOpenReason, closeReason?: DialogCloseReason): void;\n};\n\n// ── Factory ───────────────────────────────────────────────────────────────────\nexport const createOverlayControl = (options: OverlayControlOptions): OverlayControl => {\n  let positionerCleanup: (() => void) | null = null;\n\n  const shouldRestoreFocus = (): boolean => {\n    if (typeof options.restoreFocus === 'function') return options.restoreFocus();\n\n    return options.restoreFocus ?? true;\n  };\n\n  // Per-instance outside-pointer listener registered directly on document.\n  // Uses 'pointerdown' instead of 'click' so that tapping empty/non-interactive\n  // areas on iOS Safari (which does not synthesize 'click' for those targets)\n  // still dismisses the overlay.\n  // No shared multiplexer needed — max ~3 overlays can be open concurrently.\n  const clickListener = (event: Event): void => {\n    if (!options.isOpen()) return;\n\n    const path = (event as Event & { composedPath?: () => EventTarget[] }).composedPath?.() ?? [];\n    const boundary = options.getBoundary();\n    const panel = options.getPanel?.() ?? null;\n    const target = (path[0] ?? event.target) as EventTarget | null;\n    const nodeTarget = target instanceof Node ? target : null;\n    const insideByPath = path.some((entry) => entry === boundary || entry === panel);\n    const insideByContainment = nodeTarget\n      ? (boundary?.contains(nodeTarget) ?? false) || (panel?.contains(nodeTarget) ?? false)\n      : false;\n\n    if (!insideByPath && !insideByContainment) close('outsideClick');\n  };\n\n  const registerClickListener = (active: boolean): void => {\n    if (active) {\n      document.addEventListener('pointerdown', clickListener, { capture: true });\n    } else {\n      document.removeEventListener('pointerdown', clickListener, { capture: true });\n    }\n  };\n\n  const open = (reason: OverlayOpenReason = 'programmatic'): void => {\n    if (options.isDisabled?.() || options.isOpen()) return;\n\n    options.setOpen(true, reason);\n    registerClickListener(true);\n\n    if (options.positioner) {\n      options.positioner.update();\n      positionerCleanup = options.positioner.startAutoUpdate?.() ?? null;\n    }\n\n    options.onOpen?.(reason);\n  };\n\n  const close = (reason: DialogCloseReason = 'programmatic', restoreFocus?: boolean, silent = false): void => {\n    if (!options.isOpen()) return;\n\n    options.setOpen(false, reason);\n    registerClickListener(false);\n\n    if (positionerCleanup) {\n      positionerCleanup();\n      positionerCleanup = null;\n    }\n\n    const restore = restoreFocus ?? shouldRestoreFocus();\n\n    if (restore) options.getTrigger?.()?.focus();\n\n    if (!silent) options.onClose?.(reason);\n  };\n\n  const toggle = (openReason: OverlayOpenReason = 'click', closeReason: DialogCloseReason = 'trigger'): void => {\n    if (options.isOpen()) {\n      close(closeReason);\n    } else {\n      open(openReason);\n    }\n  };\n\n  const dispose = (): void => {\n    // Close silently — teardown should not fire onClose callbacks.\n    if (options.isOpen()) close('programmatic', false, true);\n\n    registerClickListener(false);\n\n    if (positionerCleanup) {\n      positionerCleanup();\n      positionerCleanup = null;\n    }\n  };\n\n  options.signal.addEventListener('abort', dispose, { once: true });\n\n  return { close, dispose, open, [Symbol.dispose]: dispose, toggle };\n};\n"],"mappings":"AAkEA,IAAa,EAAwB,GAAmD,CACtF,IAAI,EAAyC,KAEvC,MACA,OAAO,EAAQ,cAAiB,WAAmB,EAAQ,aAAa,EAErE,EAAQ,cAAgB,GAQ3B,EAAiB,GAAuB,CAC5C,GAAI,CAAC,EAAQ,OAAO,EAAG,OAEvB,IAAM,EAAQ,EAAyD,eAAe,GAAK,CAAC,EACtF,EAAW,EAAQ,YAAY,EAC/B,EAAQ,EAAQ,WAAW,GAAK,KAChC,EAAU,EAAK,IAAM,EAAM,OAC3B,EAAa,aAAkB,KAAO,EAAS,KAC/C,EAAe,EAAK,KAAM,GAAU,IAAU,GAAY,IAAU,CAAK,EACzE,EAAsB,GACvB,GAAU,SAAS,CAAU,GAAK,MAAW,GAAO,SAAS,CAAU,GAAK,IAC7E,GAEA,CAAC,GAAgB,CAAC,GAAqB,EAAM,cAAc,CACjE,EAEM,EAAyB,GAA0B,CACnD,EACF,SAAS,iBAAiB,cAAe,EAAe,CAAE,QAAS,EAAK,CAAC,EAEzE,SAAS,oBAAoB,cAAe,EAAe,CAAE,QAAS,EAAK,CAAC,CAEhF,EAEM,GAAQ,EAA4B,iBAAyB,CAC7D,EAAQ,aAAa,GAAK,EAAQ,OAAO,IAE7C,EAAQ,QAAQ,GAAM,CAAM,EAC5B,EAAsB,EAAI,EAEtB,EAAQ,aACV,EAAQ,WAAW,OAAO,EAC1B,EAAoB,EAAQ,WAAW,kBAAkB,GAAK,MAGhE,EAAQ,SAAS,CAAM,EACzB,EAEM,GAAS,EAA4B,eAAgB,EAAwB,EAAS,KAAgB,CACrG,EAAQ,OAAO,IAEpB,EAAQ,QAAQ,GAAO,CAAM,EAC7B,EAAsB,EAAK,EAE3B,AAEE,KADA,EAAkB,EACE,OAGN,GAAgB,EAAmB,IAEtC,EAAQ,aAAa,CAAC,EAAE,MAAM,EAEtC,GAAQ,EAAQ,UAAU,CAAM,EACvC,EAEM,GAAU,EAAgC,QAAS,EAAiC,YAAoB,CACxG,EAAQ,OAAO,EACjB,EAAM,CAAW,EAEjB,EAAK,CAAU,CAEnB,EAEM,MAAsB,CAEtB,EAAQ,OAAO,GAAG,EAAM,eAAgB,GAAO,EAAI,EAEvD,EAAsB,EAAK,EAE3B,AAEE,KADA,EAAkB,EACE,KAExB,EAIA,OAFA,EAAQ,OAAO,iBAAiB,QAAS,EAAS,CAAE,KAAM,EAAK,CAAC,EAEzD,CAAE,QAAO,UAAS,QAAO,OAAO,SAAU,EAAS,QAAO,CACnE"}
+{"version":3,"file":"overlay.cjs","names":[],"sources":["../../src/headless/overlay.ts"],"sourcesContent":["import type { OverlayPositioner } from './positioner';\n\n// ── Types ─────────────────────────────────────────────────────────────────────\n\n/**\n * Why an overlay was opened.\n * - `'click'`       — user clicked the trigger element\n * - `'focus'`       — focus entered the trigger (tooltip, popover)\n * - `'hover'`       — pointer entered the trigger (tooltip)\n * - `'keyboard'`    — keyboard shortcut or Enter/Space on a trigger\n * - `'programmatic'` — opened via the JS API without a user gesture\n * - `'trigger'`     — opened via the Invoker Commands API (`command=\"show-modal\"`)\n */\nexport type OverlayOpenReason = 'click' | 'focus' | 'hover' | 'keyboard' | 'programmatic' | 'trigger';\n\n/** Close reasons valid for modal dialogs (includes 'swipe' for drawer). */\nexport type DialogCloseReason = 'escape' | 'outsideClick' | 'programmatic' | 'swipe' | 'trigger';\n/** Close reasons valid for dropdown overlays (no swipe). */\nexport type DropdownCloseReason = Exclude<DialogCloseReason, 'swipe'>;\n\n/** Detail shape for overlay open events emitted by components. */\nexport type OverlayOpenDetail = { reason: OverlayOpenReason };\n/** Detail shape for overlay close events emitted by components. */\nexport type OverlayCloseDetail = { reason: DialogCloseReason };\n\nexport type { OverlayPositioner };\n\nexport type OverlayControlOptions = {\n  getBoundary: () => HTMLElement | null;\n  getPanel?: () => HTMLElement | null;\n  getTrigger?: () => HTMLElement | null;\n  isDisabled?: () => boolean;\n  isOpen: () => boolean;\n  onClose?: (reason: DialogCloseReason) => void;\n  onOpen?: (reason: OverlayOpenReason) => void;\n  positioner?: OverlayPositioner;\n  restoreFocus?: boolean | (() => boolean);\n  setOpen: (next: boolean, reason: OverlayOpenReason | DialogCloseReason) => void;\n  /** `AbortSignal` from the component lifecycle. `dispose()` is called automatically on abort. */\n  signal: AbortSignal;\n};\n\nexport type OverlayControl = {\n  [Symbol.dispose](): void;\n  /**\n   * Closes the overlay.\n   * @param reason — why it's closing (default `'programmatic'`)\n   * @param restoreFocus — override per-call focus restoration (default: uses `restoreFocus` option)\n   */\n  close(reason?: DialogCloseReason, restoreFocus?: boolean): void;\n  /** Tears down the overlay: closes silently and removes all event listeners. */\n  dispose(): void;\n  /** `true` after `dispose()` has been called. */\n  readonly disposed: boolean;\n  /**\n   * Opens the overlay.\n   * @param reason — why it's opening (default `'programmatic'`)\n   */\n  open(reason?: OverlayOpenReason): void;\n  /**\n   * Toggles open state.\n   * - Opens with `openReason` (default `'click'`).\n   * - Closes with `closeReason` (default `'trigger'`).\n   */\n  toggle(openReason?: OverlayOpenReason, closeReason?: DialogCloseReason): void;\n};\n\n// ── Factory ───────────────────────────────────────────────────────────────────\nexport const createOverlayControl = (options: OverlayControlOptions): OverlayControl => {\n  let positionerCleanup: (() => void) | null = null;\n\n  const shouldRestoreFocus = (): boolean => {\n    if (typeof options.restoreFocus === 'function') return options.restoreFocus();\n\n    return options.restoreFocus ?? true;\n  };\n\n  // Per-instance outside-pointer listener registered directly on document.\n  // Uses 'pointerdown' instead of 'click' so that tapping empty/non-interactive\n  // areas on iOS Safari (which does not synthesize 'click' for those targets)\n  // still dismisses the overlay.\n  // No shared multiplexer needed — max ~3 overlays can be open concurrently.\n  const clickListener = (event: Event): void => {\n    if (!options.isOpen()) return;\n\n    const path = (event as Event & { composedPath?: () => EventTarget[] }).composedPath?.() ?? [];\n    const boundary = options.getBoundary();\n    const panel = options.getPanel?.() ?? null;\n    const target = (path[0] ?? event.target) as EventTarget | null;\n    const nodeTarget = target instanceof Node ? target : null;\n    const insideByPath = path.some((entry) => entry === boundary || entry === panel);\n    const insideByContainment = nodeTarget\n      ? (boundary?.contains(nodeTarget) ?? false) || (panel?.contains(nodeTarget) ?? false)\n      : false;\n\n    if (!insideByPath && !insideByContainment) close('outsideClick');\n  };\n\n  const registerClickListener = (active: boolean): void => {\n    if (active) {\n      document.addEventListener('pointerdown', clickListener, { capture: true });\n    } else {\n      document.removeEventListener('pointerdown', clickListener, { capture: true });\n    }\n  };\n\n  const open = (reason: OverlayOpenReason = 'programmatic'): void => {\n    if (options.isDisabled?.() || options.isOpen()) return;\n\n    options.setOpen(true, reason);\n    registerClickListener(true);\n\n    if (options.positioner) {\n      options.positioner.update();\n      positionerCleanup = options.positioner.startAutoUpdate?.() ?? null;\n    }\n\n    options.onOpen?.(reason);\n  };\n\n  const close = (reason: DialogCloseReason = 'programmatic', restoreFocus?: boolean, silent = false): void => {\n    if (!options.isOpen()) return;\n\n    options.setOpen(false, reason);\n    registerClickListener(false);\n\n    if (positionerCleanup) {\n      positionerCleanup();\n      positionerCleanup = null;\n    }\n\n    const restore = restoreFocus ?? shouldRestoreFocus();\n\n    if (restore) options.getTrigger?.()?.focus();\n\n    if (!silent) options.onClose?.(reason);\n  };\n\n  const toggle = (openReason: OverlayOpenReason = 'click', closeReason: DialogCloseReason = 'trigger'): void => {\n    if (options.isOpen()) {\n      close(closeReason);\n    } else {\n      open(openReason);\n    }\n  };\n\n  let disposed = false;\n\n  const dispose = (): void => {\n    if (disposed) return;\n\n    disposed = true;\n\n    // Close silently — teardown should not fire onClose callbacks.\n    if (options.isOpen()) close('programmatic', false, true);\n\n    registerClickListener(false);\n\n    if (positionerCleanup) {\n      positionerCleanup();\n      positionerCleanup = null;\n    }\n  };\n\n  options.signal.addEventListener('abort', dispose, { once: true });\n\n  return {\n    close,\n    dispose,\n    get disposed() {\n      return disposed;\n    },\n    open,\n    [Symbol.dispose]: dispose,\n    toggle,\n  };\n};\n"],"mappings":"AAoEA,IAAa,EAAwB,GAAmD,CACtF,IAAI,EAAyC,KAEvC,MACA,OAAO,EAAQ,cAAiB,WAAmB,EAAQ,aAAa,EAErE,EAAQ,cAAgB,GAQ3B,EAAiB,GAAuB,CAC5C,GAAI,CAAC,EAAQ,OAAO,EAAG,OAEvB,IAAM,EAAQ,EAAyD,eAAe,GAAK,CAAC,EACtF,EAAW,EAAQ,YAAY,EAC/B,EAAQ,EAAQ,WAAW,GAAK,KAChC,EAAU,EAAK,IAAM,EAAM,OAC3B,EAAa,aAAkB,KAAO,EAAS,KAC/C,EAAe,EAAK,KAAM,GAAU,IAAU,GAAY,IAAU,CAAK,EACzE,EAAsB,GACvB,GAAU,SAAS,CAAU,GAAK,MAAW,GAAO,SAAS,CAAU,GAAK,IAC7E,GAEA,CAAC,GAAgB,CAAC,GAAqB,EAAM,cAAc,CACjE,EAEM,EAAyB,GAA0B,CACnD,EACF,SAAS,iBAAiB,cAAe,EAAe,CAAE,QAAS,EAAK,CAAC,EAEzE,SAAS,oBAAoB,cAAe,EAAe,CAAE,QAAS,EAAK,CAAC,CAEhF,EAEM,GAAQ,EAA4B,iBAAyB,CAC7D,EAAQ,aAAa,GAAK,EAAQ,OAAO,IAE7C,EAAQ,QAAQ,GAAM,CAAM,EAC5B,EAAsB,EAAI,EAEtB,EAAQ,aACV,EAAQ,WAAW,OAAO,EAC1B,EAAoB,EAAQ,WAAW,kBAAkB,GAAK,MAGhE,EAAQ,SAAS,CAAM,EACzB,EAEM,GAAS,EAA4B,eAAgB,EAAwB,EAAS,KAAgB,CACrG,EAAQ,OAAO,IAEpB,EAAQ,QAAQ,GAAO,CAAM,EAC7B,EAAsB,EAAK,EAE3B,AAEE,KADA,EAAkB,EACE,OAGN,GAAgB,EAAmB,IAEtC,EAAQ,aAAa,CAAC,EAAE,MAAM,EAEtC,GAAQ,EAAQ,UAAU,CAAM,EACvC,EAEM,GAAU,EAAgC,QAAS,EAAiC,YAAoB,CACxG,EAAQ,OAAO,EACjB,EAAM,CAAW,EAEjB,EAAK,CAAU,CAEnB,EAEI,EAAW,GAET,MAAsB,CACtB,IAEJ,EAAW,GAGP,EAAQ,OAAO,GAAG,EAAM,eAAgB,GAAO,EAAI,EAEvD,EAAsB,EAAK,EAE3B,AAEE,KADA,EAAkB,EACE,MAExB,EAIA,OAFA,EAAQ,OAAO,iBAAiB,QAAS,EAAS,CAAE,KAAM,EAAK,CAAC,EAEzD,CACL,QACA,UACA,IAAI,UAAW,CACb,OAAO,CACT,EACA,QACC,OAAO,SAAU,EAClB,QACF,CACF"}

package/dist/headless/overlay.d.ts

@@ -46,6 +46,8 @@ export type OverlayControl = {
     close(reason?: DialogCloseReason, restoreFocus?: boolean): void;
     /** Tears down the overlay: closes silently and removes all event listeners. */
     dispose(): void;
+    /** `true` after `dispose()` has been called. */
+    readonly disposed: boolean;
     /**
      * Opens the overlay.
      * @param reason — why it's opening (default `'programmatic'`)

package/dist/headless/overlay.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"overlay.d.ts","sourceRoot":"","sources":["../../src/headless/overlay.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAItD;;;;;;;;GAQG;AACH,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,UAAU,GAAG,cAAc,GAAG,SAAS,CAAC;AAEtG,2EAA2E;AAC3E,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,cAAc,GAAG,cAAc,GAAG,OAAO,GAAG,SAAS,CAAC;AACjG,4DAA4D;AAC5D,MAAM,MAAM,mBAAmB,GAAG,OAAO,CAAC,iBAAiB,EAAE,OAAO,CAAC,CAAC;AAEtE,kEAAkE;AAClE,MAAM,MAAM,iBAAiB,GAAG;IAAE,MAAM,EAAE,iBAAiB,CAAA;CAAE,CAAC;AAC9D,mEAAmE;AACnE,MAAM,MAAM,kBAAkB,GAAG;IAAE,MAAM,EAAE,iBAAiB,CAAA;CAAE,CAAC;AAE/D,YAAY,EAAE,iBAAiB,EAAE,CAAC;AAElC,MAAM,MAAM,qBAAqB,GAAG;IAClC,WAAW,EAAE,MAAM,WAAW,GAAG,IAAI,CAAC;IACtC,QAAQ,CAAC,EAAE,MAAM,WAAW,GAAG,IAAI,CAAC;IACpC,UAAU,CAAC,EAAE,MAAM,WAAW,GAAG,IAAI,CAAC;IACtC,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC;IAC3B,MAAM,EAAE,MAAM,OAAO,CAAC;IACtB,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,iBAAiB,KAAK,IAAI,CAAC;IAC9C,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,iBAAiB,KAAK,IAAI,CAAC;IAC7C,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B,YAAY,CAAC,EAAE,OAAO,GAAG,CAAC,MAAM,OAAO,CAAC,CAAC;IACzC,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,iBAAiB,GAAG,iBAAiB,KAAK,IAAI,CAAC;IAChF,gGAAgG;IAChG,MAAM,EAAE,WAAW,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC;IACzB;;;;OAIG;IACH,KAAK,CAAC,MAAM,CAAC,EAAE,iBAAiB,EAAE,YAAY,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAChE,+EAA+E;IAC/E,OAAO,IAAI,IAAI,CAAC;IAChB;;;OAGG;IACH,IAAI,CAAC,MAAM,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACvC;;;;OAIG;IACH,MAAM,CAAC,UAAU,CAAC,EAAE,iBAAiB,EAAE,WAAW,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAC;CAC/E,CAAC;AAGF,eAAO,MAAM,oBAAoB,GAAI,SAAS,qBAAqB,KAAG,cA6FrE,CAAC"}
+{"version":3,"file":"overlay.d.ts","sourceRoot":"","sources":["../../src/headless/overlay.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAItD;;;;;;;;GAQG;AACH,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,UAAU,GAAG,cAAc,GAAG,SAAS,CAAC;AAEtG,2EAA2E;AAC3E,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,cAAc,GAAG,cAAc,GAAG,OAAO,GAAG,SAAS,CAAC;AACjG,4DAA4D;AAC5D,MAAM,MAAM,mBAAmB,GAAG,OAAO,CAAC,iBAAiB,EAAE,OAAO,CAAC,CAAC;AAEtE,kEAAkE;AAClE,MAAM,MAAM,iBAAiB,GAAG;IAAE,MAAM,EAAE,iBAAiB,CAAA;CAAE,CAAC;AAC9D,mEAAmE;AACnE,MAAM,MAAM,kBAAkB,GAAG;IAAE,MAAM,EAAE,iBAAiB,CAAA;CAAE,CAAC;AAE/D,YAAY,EAAE,iBAAiB,EAAE,CAAC;AAElC,MAAM,MAAM,qBAAqB,GAAG;IAClC,WAAW,EAAE,MAAM,WAAW,GAAG,IAAI,CAAC;IACtC,QAAQ,CAAC,EAAE,MAAM,WAAW,GAAG,IAAI,CAAC;IACpC,UAAU,CAAC,EAAE,MAAM,WAAW,GAAG,IAAI,CAAC;IACtC,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC;IAC3B,MAAM,EAAE,MAAM,OAAO,CAAC;IACtB,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,iBAAiB,KAAK,IAAI,CAAC;IAC9C,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,iBAAiB,KAAK,IAAI,CAAC;IAC7C,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B,YAAY,CAAC,EAAE,OAAO,GAAG,CAAC,MAAM,OAAO,CAAC,CAAC;IACzC,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,iBAAiB,GAAG,iBAAiB,KAAK,IAAI,CAAC;IAChF,gGAAgG;IAChG,MAAM,EAAE,WAAW,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC;IACzB;;;;OAIG;IACH,KAAK,CAAC,MAAM,CAAC,EAAE,iBAAiB,EAAE,YAAY,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAChE,+EAA+E;IAC/E,OAAO,IAAI,IAAI,CAAC;IAChB,gDAAgD;IAChD,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B;;;OAGG;IACH,IAAI,CAAC,MAAM,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACvC;;;;OAIG;IACH,MAAM,CAAC,UAAU,CAAC,EAAE,iBAAiB,EAAE,WAAW,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAC;CAC/E,CAAC;AAGF,eAAO,MAAM,oBAAoB,GAAI,SAAS,qBAAqB,KAAG,cA4GrE,CAAC"}

package/dist/headless/overlay.js

@@ -12,14 +12,17 @@ var e = (e) => {
 		e.isOpen() && (e.setOpen(!1, r), i(!1), t &&= (t(), null), (a ?? n()) && e.getTrigger?.()?.focus(), o || e.onClose?.(r));
 	}, s = (t = "click", n = "trigger") => {
 		e.isOpen() ? o(n) : a(t);
-	}, c = () => {
-		e.isOpen() && o("programmatic", !1, !0), i(!1), t &&= (t(), null);
+	}, c = !1, l = () => {
+		c || (c = !0, e.isOpen() && o("programmatic", !1, !0), i(!1), t &&= (t(), null));
 	};
-	return e.signal.addEventListener("abort", c, { once: !0 }), {
+	return e.signal.addEventListener("abort", l, { once: !0 }), {
 		close: o,
-		dispose: c,
+		dispose: l,
+		get disposed() {
+			return c;
+		},
 		open: a,
-		[Symbol.dispose]: c,
+		[Symbol.dispose]: l,
 		toggle: s
 	};
 };

package/dist/headless/overlay.js.map

@@ -1 +1 @@
-{"version":3,"file":"overlay.js","names":[],"sources":["../../src/headless/overlay.ts"],"sourcesContent":["import type { OverlayPositioner } from './positioner';\n\n// ── Types ─────────────────────────────────────────────────────────────────────\n\n/**\n * Why an overlay was opened.\n * - `'click'`       — user clicked the trigger element\n * - `'focus'`       — focus entered the trigger (tooltip, popover)\n * - `'hover'`       — pointer entered the trigger (tooltip)\n * - `'keyboard'`    — keyboard shortcut or Enter/Space on a trigger\n * - `'programmatic'` — opened via the JS API without a user gesture\n * - `'trigger'`     — opened via the Invoker Commands API (`command=\"show-modal\"`)\n */\nexport type OverlayOpenReason = 'click' | 'focus' | 'hover' | 'keyboard' | 'programmatic' | 'trigger';\n\n/** Close reasons valid for modal dialogs (includes 'swipe' for drawer). */\nexport type DialogCloseReason = 'escape' | 'outsideClick' | 'programmatic' | 'swipe' | 'trigger';\n/** Close reasons valid for dropdown overlays (no swipe). */\nexport type DropdownCloseReason = Exclude<DialogCloseReason, 'swipe'>;\n\n/** Detail shape for overlay open events emitted by components. */\nexport type OverlayOpenDetail = { reason: OverlayOpenReason };\n/** Detail shape for overlay close events emitted by components. */\nexport type OverlayCloseDetail = { reason: DialogCloseReason };\n\nexport type { OverlayPositioner };\n\nexport type OverlayControlOptions = {\n  getBoundary: () => HTMLElement | null;\n  getPanel?: () => HTMLElement | null;\n  getTrigger?: () => HTMLElement | null;\n  isDisabled?: () => boolean;\n  isOpen: () => boolean;\n  onClose?: (reason: DialogCloseReason) => void;\n  onOpen?: (reason: OverlayOpenReason) => void;\n  positioner?: OverlayPositioner;\n  restoreFocus?: boolean | (() => boolean);\n  setOpen: (next: boolean, reason: OverlayOpenReason | DialogCloseReason) => void;\n  /** `AbortSignal` from the component lifecycle. `dispose()` is called automatically on abort. */\n  signal: AbortSignal;\n};\n\nexport type OverlayControl = {\n  [Symbol.dispose](): void;\n  /**\n   * Closes the overlay.\n   * @param reason — why it's closing (default `'programmatic'`)\n   * @param restoreFocus — override per-call focus restoration (default: uses `restoreFocus` option)\n   */\n  close(reason?: DialogCloseReason, restoreFocus?: boolean): void;\n  /** Tears down the overlay: closes silently and removes all event listeners. */\n  dispose(): void;\n  /**\n   * Opens the overlay.\n   * @param reason — why it's opening (default `'programmatic'`)\n   */\n  open(reason?: OverlayOpenReason): void;\n  /**\n   * Toggles open state.\n   * - Opens with `openReason` (default `'click'`).\n   * - Closes with `closeReason` (default `'trigger'`).\n   */\n  toggle(openReason?: OverlayOpenReason, closeReason?: DialogCloseReason): void;\n};\n\n// ── Factory ───────────────────────────────────────────────────────────────────\nexport const createOverlayControl = (options: OverlayControlOptions): OverlayControl => {\n  let positionerCleanup: (() => void) | null = null;\n\n  const shouldRestoreFocus = (): boolean => {\n    if (typeof options.restoreFocus === 'function') return options.restoreFocus();\n\n    return options.restoreFocus ?? true;\n  };\n\n  // Per-instance outside-pointer listener registered directly on document.\n  // Uses 'pointerdown' instead of 'click' so that tapping empty/non-interactive\n  // areas on iOS Safari (which does not synthesize 'click' for those targets)\n  // still dismisses the overlay.\n  // No shared multiplexer needed — max ~3 overlays can be open concurrently.\n  const clickListener = (event: Event): void => {\n    if (!options.isOpen()) return;\n\n    const path = (event as Event & { composedPath?: () => EventTarget[] }).composedPath?.() ?? [];\n    const boundary = options.getBoundary();\n    const panel = options.getPanel?.() ?? null;\n    const target = (path[0] ?? event.target) as EventTarget | null;\n    const nodeTarget = target instanceof Node ? target : null;\n    const insideByPath = path.some((entry) => entry === boundary || entry === panel);\n    const insideByContainment = nodeTarget\n      ? (boundary?.contains(nodeTarget) ?? false) || (panel?.contains(nodeTarget) ?? false)\n      : false;\n\n    if (!insideByPath && !insideByContainment) close('outsideClick');\n  };\n\n  const registerClickListener = (active: boolean): void => {\n    if (active) {\n      document.addEventListener('pointerdown', clickListener, { capture: true });\n    } else {\n      document.removeEventListener('pointerdown', clickListener, { capture: true });\n    }\n  };\n\n  const open = (reason: OverlayOpenReason = 'programmatic'): void => {\n    if (options.isDisabled?.() || options.isOpen()) return;\n\n    options.setOpen(true, reason);\n    registerClickListener(true);\n\n    if (options.positioner) {\n      options.positioner.update();\n      positionerCleanup = options.positioner.startAutoUpdate?.() ?? null;\n    }\n\n    options.onOpen?.(reason);\n  };\n\n  const close = (reason: DialogCloseReason = 'programmatic', restoreFocus?: boolean, silent = false): void => {\n    if (!options.isOpen()) return;\n\n    options.setOpen(false, reason);\n    registerClickListener(false);\n\n    if (positionerCleanup) {\n      positionerCleanup();\n      positionerCleanup = null;\n    }\n\n    const restore = restoreFocus ?? shouldRestoreFocus();\n\n    if (restore) options.getTrigger?.()?.focus();\n\n    if (!silent) options.onClose?.(reason);\n  };\n\n  const toggle = (openReason: OverlayOpenReason = 'click', closeReason: DialogCloseReason = 'trigger'): void => {\n    if (options.isOpen()) {\n      close(closeReason);\n    } else {\n      open(openReason);\n    }\n  };\n\n  const dispose = (): void => {\n    // Close silently — teardown should not fire onClose callbacks.\n    if (options.isOpen()) close('programmatic', false, true);\n\n    registerClickListener(false);\n\n    if (positionerCleanup) {\n      positionerCleanup();\n      positionerCleanup = null;\n    }\n  };\n\n  options.signal.addEventListener('abort', dispose, { once: true });\n\n  return { close, dispose, open, [Symbol.dispose]: dispose, toggle };\n};\n"],"mappings":";AAkEA,IAAa,KAAwB,MAAmD;CACtF,IAAI,IAAyC,MAEvC,UACA,OAAO,EAAQ,gBAAiB,aAAmB,EAAQ,aAAa,IAErE,EAAQ,gBAAgB,IAQ3B,KAAiB,MAAuB;EAC5C,IAAI,CAAC,EAAQ,OAAO,GAAG;EAEvB,IAAM,IAAQ,EAAyD,eAAe,KAAK,CAAC,GACtF,IAAW,EAAQ,YAAY,GAC/B,IAAQ,EAAQ,WAAW,KAAK,MAChC,IAAU,EAAK,MAAM,EAAM,QAC3B,IAAa,aAAkB,OAAO,IAAS,MAC/C,IAAe,EAAK,MAAM,MAAU,MAAU,KAAY,MAAU,CAAK,GACzE,IAAsB,KACvB,GAAU,SAAS,CAAU,KAAK,QAAW,GAAO,SAAS,CAAU,KAAK,MAC7E;EAEJ,AAAI,CAAC,KAAgB,CAAC,KAAqB,EAAM,cAAc;CACjE,GAEM,KAAyB,MAA0B;EACvD,AAAI,IACF,SAAS,iBAAiB,eAAe,GAAe,EAAE,SAAS,GAAK,CAAC,IAEzE,SAAS,oBAAoB,eAAe,GAAe,EAAE,SAAS,GAAK,CAAC;CAEhF,GAEM,KAAQ,IAA4B,mBAAyB;EAC7D,EAAQ,aAAa,KAAK,EAAQ,OAAO,MAE7C,EAAQ,QAAQ,IAAM,CAAM,GAC5B,EAAsB,EAAI,GAEtB,EAAQ,eACV,EAAQ,WAAW,OAAO,GAC1B,IAAoB,EAAQ,WAAW,kBAAkB,KAAK,OAGhE,EAAQ,SAAS,CAAM;CACzB,GAEM,KAAS,IAA4B,gBAAgB,GAAwB,IAAS,OAAgB;EACrG,EAAQ,OAAO,MAEpB,EAAQ,QAAQ,IAAO,CAAM,GAC7B,EAAsB,EAAK,GAE3B,AAEE,OADA,EAAkB,GACE,QAGN,KAAgB,EAAmB,MAEtC,EAAQ,aAAa,CAAC,EAAE,MAAM,GAEtC,KAAQ,EAAQ,UAAU,CAAM;CACvC,GAEM,KAAU,IAAgC,SAAS,IAAiC,cAAoB;EAC5G,AAAI,EAAQ,OAAO,IACjB,EAAM,CAAW,IAEjB,EAAK,CAAU;CAEnB,GAEM,UAAsB;EAM1B,AAJI,EAAQ,OAAO,KAAG,EAAM,gBAAgB,IAAO,EAAI,GAEvD,EAAsB,EAAK,GAE3B,AAEE,OADA,EAAkB,GACE;CAExB;CAIA,OAFA,EAAQ,OAAO,iBAAiB,SAAS,GAAS,EAAE,MAAM,GAAK,CAAC,GAEzD;EAAE;EAAO;EAAS;GAAO,OAAO,UAAU;EAAS;CAAO;AACnE"}
+{"version":3,"file":"overlay.js","names":[],"sources":["../../src/headless/overlay.ts"],"sourcesContent":["import type { OverlayPositioner } from './positioner';\n\n// ── Types ─────────────────────────────────────────────────────────────────────\n\n/**\n * Why an overlay was opened.\n * - `'click'`       — user clicked the trigger element\n * - `'focus'`       — focus entered the trigger (tooltip, popover)\n * - `'hover'`       — pointer entered the trigger (tooltip)\n * - `'keyboard'`    — keyboard shortcut or Enter/Space on a trigger\n * - `'programmatic'` — opened via the JS API without a user gesture\n * - `'trigger'`     — opened via the Invoker Commands API (`command=\"show-modal\"`)\n */\nexport type OverlayOpenReason = 'click' | 'focus' | 'hover' | 'keyboard' | 'programmatic' | 'trigger';\n\n/** Close reasons valid for modal dialogs (includes 'swipe' for drawer). */\nexport type DialogCloseReason = 'escape' | 'outsideClick' | 'programmatic' | 'swipe' | 'trigger';\n/** Close reasons valid for dropdown overlays (no swipe). */\nexport type DropdownCloseReason = Exclude<DialogCloseReason, 'swipe'>;\n\n/** Detail shape for overlay open events emitted by components. */\nexport type OverlayOpenDetail = { reason: OverlayOpenReason };\n/** Detail shape for overlay close events emitted by components. */\nexport type OverlayCloseDetail = { reason: DialogCloseReason };\n\nexport type { OverlayPositioner };\n\nexport type OverlayControlOptions = {\n  getBoundary: () => HTMLElement | null;\n  getPanel?: () => HTMLElement | null;\n  getTrigger?: () => HTMLElement | null;\n  isDisabled?: () => boolean;\n  isOpen: () => boolean;\n  onClose?: (reason: DialogCloseReason) => void;\n  onOpen?: (reason: OverlayOpenReason) => void;\n  positioner?: OverlayPositioner;\n  restoreFocus?: boolean | (() => boolean);\n  setOpen: (next: boolean, reason: OverlayOpenReason | DialogCloseReason) => void;\n  /** `AbortSignal` from the component lifecycle. `dispose()` is called automatically on abort. */\n  signal: AbortSignal;\n};\n\nexport type OverlayControl = {\n  [Symbol.dispose](): void;\n  /**\n   * Closes the overlay.\n   * @param reason — why it's closing (default `'programmatic'`)\n   * @param restoreFocus — override per-call focus restoration (default: uses `restoreFocus` option)\n   */\n  close(reason?: DialogCloseReason, restoreFocus?: boolean): void;\n  /** Tears down the overlay: closes silently and removes all event listeners. */\n  dispose(): void;\n  /** `true` after `dispose()` has been called. */\n  readonly disposed: boolean;\n  /**\n   * Opens the overlay.\n   * @param reason — why it's opening (default `'programmatic'`)\n   */\n  open(reason?: OverlayOpenReason): void;\n  /**\n   * Toggles open state.\n   * - Opens with `openReason` (default `'click'`).\n   * - Closes with `closeReason` (default `'trigger'`).\n   */\n  toggle(openReason?: OverlayOpenReason, closeReason?: DialogCloseReason): void;\n};\n\n// ── Factory ───────────────────────────────────────────────────────────────────\nexport const createOverlayControl = (options: OverlayControlOptions): OverlayControl => {\n  let positionerCleanup: (() => void) | null = null;\n\n  const shouldRestoreFocus = (): boolean => {\n    if (typeof options.restoreFocus === 'function') return options.restoreFocus();\n\n    return options.restoreFocus ?? true;\n  };\n\n  // Per-instance outside-pointer listener registered directly on document.\n  // Uses 'pointerdown' instead of 'click' so that tapping empty/non-interactive\n  // areas on iOS Safari (which does not synthesize 'click' for those targets)\n  // still dismisses the overlay.\n  // No shared multiplexer needed — max ~3 overlays can be open concurrently.\n  const clickListener = (event: Event): void => {\n    if (!options.isOpen()) return;\n\n    const path = (event as Event & { composedPath?: () => EventTarget[] }).composedPath?.() ?? [];\n    const boundary = options.getBoundary();\n    const panel = options.getPanel?.() ?? null;\n    const target = (path[0] ?? event.target) as EventTarget | null;\n    const nodeTarget = target instanceof Node ? target : null;\n    const insideByPath = path.some((entry) => entry === boundary || entry === panel);\n    const insideByContainment = nodeTarget\n      ? (boundary?.contains(nodeTarget) ?? false) || (panel?.contains(nodeTarget) ?? false)\n      : false;\n\n    if (!insideByPath && !insideByContainment) close('outsideClick');\n  };\n\n  const registerClickListener = (active: boolean): void => {\n    if (active) {\n      document.addEventListener('pointerdown', clickListener, { capture: true });\n    } else {\n      document.removeEventListener('pointerdown', clickListener, { capture: true });\n    }\n  };\n\n  const open = (reason: OverlayOpenReason = 'programmatic'): void => {\n    if (options.isDisabled?.() || options.isOpen()) return;\n\n    options.setOpen(true, reason);\n    registerClickListener(true);\n\n    if (options.positioner) {\n      options.positioner.update();\n      positionerCleanup = options.positioner.startAutoUpdate?.() ?? null;\n    }\n\n    options.onOpen?.(reason);\n  };\n\n  const close = (reason: DialogCloseReason = 'programmatic', restoreFocus?: boolean, silent = false): void => {\n    if (!options.isOpen()) return;\n\n    options.setOpen(false, reason);\n    registerClickListener(false);\n\n    if (positionerCleanup) {\n      positionerCleanup();\n      positionerCleanup = null;\n    }\n\n    const restore = restoreFocus ?? shouldRestoreFocus();\n\n    if (restore) options.getTrigger?.()?.focus();\n\n    if (!silent) options.onClose?.(reason);\n  };\n\n  const toggle = (openReason: OverlayOpenReason = 'click', closeReason: DialogCloseReason = 'trigger'): void => {\n    if (options.isOpen()) {\n      close(closeReason);\n    } else {\n      open(openReason);\n    }\n  };\n\n  let disposed = false;\n\n  const dispose = (): void => {\n    if (disposed) return;\n\n    disposed = true;\n\n    // Close silently — teardown should not fire onClose callbacks.\n    if (options.isOpen()) close('programmatic', false, true);\n\n    registerClickListener(false);\n\n    if (positionerCleanup) {\n      positionerCleanup();\n      positionerCleanup = null;\n    }\n  };\n\n  options.signal.addEventListener('abort', dispose, { once: true });\n\n  return {\n    close,\n    dispose,\n    get disposed() {\n      return disposed;\n    },\n    open,\n    [Symbol.dispose]: dispose,\n    toggle,\n  };\n};\n"],"mappings":";AAoEA,IAAa,KAAwB,MAAmD;CACtF,IAAI,IAAyC,MAEvC,UACA,OAAO,EAAQ,gBAAiB,aAAmB,EAAQ,aAAa,IAErE,EAAQ,gBAAgB,IAQ3B,KAAiB,MAAuB;EAC5C,IAAI,CAAC,EAAQ,OAAO,GAAG;EAEvB,IAAM,IAAQ,EAAyD,eAAe,KAAK,CAAC,GACtF,IAAW,EAAQ,YAAY,GAC/B,IAAQ,EAAQ,WAAW,KAAK,MAChC,IAAU,EAAK,MAAM,EAAM,QAC3B,IAAa,aAAkB,OAAO,IAAS,MAC/C,IAAe,EAAK,MAAM,MAAU,MAAU,KAAY,MAAU,CAAK,GACzE,IAAsB,KACvB,GAAU,SAAS,CAAU,KAAK,QAAW,GAAO,SAAS,CAAU,KAAK,MAC7E;EAEJ,AAAI,CAAC,KAAgB,CAAC,KAAqB,EAAM,cAAc;CACjE,GAEM,KAAyB,MAA0B;EACvD,AAAI,IACF,SAAS,iBAAiB,eAAe,GAAe,EAAE,SAAS,GAAK,CAAC,IAEzE,SAAS,oBAAoB,eAAe,GAAe,EAAE,SAAS,GAAK,CAAC;CAEhF,GAEM,KAAQ,IAA4B,mBAAyB;EAC7D,EAAQ,aAAa,KAAK,EAAQ,OAAO,MAE7C,EAAQ,QAAQ,IAAM,CAAM,GAC5B,EAAsB,EAAI,GAEtB,EAAQ,eACV,EAAQ,WAAW,OAAO,GAC1B,IAAoB,EAAQ,WAAW,kBAAkB,KAAK,OAGhE,EAAQ,SAAS,CAAM;CACzB,GAEM,KAAS,IAA4B,gBAAgB,GAAwB,IAAS,OAAgB;EACrG,EAAQ,OAAO,MAEpB,EAAQ,QAAQ,IAAO,CAAM,GAC7B,EAAsB,EAAK,GAE3B,AAEE,OADA,EAAkB,GACE,QAGN,KAAgB,EAAmB,MAEtC,EAAQ,aAAa,CAAC,EAAE,MAAM,GAEtC,KAAQ,EAAQ,UAAU,CAAM;CACvC,GAEM,KAAU,IAAgC,SAAS,IAAiC,cAAoB;EAC5G,AAAI,EAAQ,OAAO,IACjB,EAAM,CAAW,IAEjB,EAAK,CAAU;CAEnB,GAEI,IAAW,IAET,UAAsB;EACtB,MAEJ,IAAW,IAGP,EAAQ,OAAO,KAAG,EAAM,gBAAgB,IAAO,EAAI,GAEvD,EAAsB,EAAK,GAE3B,AAEE,OADA,EAAkB,GACE;CAExB;CAIA,OAFA,EAAQ,OAAO,iBAAiB,SAAS,GAAS,EAAE,MAAM,GAAK,CAAC,GAEzD;EACL;EACA;EACA,IAAI,WAAW;GACb,OAAO;EACT;EACA;GACC,OAAO,UAAU;EAClB;CACF;AACF"}

package/dist/headless/ref-callback.cjs

@@ -0,0 +1,2 @@
+let e=require("@vielzeug/ripple");var t=(t,n)=>{t.value?.(n);let r=(0,e.watch)(t,e=>e?.(n));return()=>{r.dispose(),t.value?.(null)}};exports.bindRefCallback=t;
+//# sourceMappingURL=ref-callback.cjs.map

package/dist/headless/ref-callback.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ref-callback.cjs","names":[],"sources":["../../src/headless/ref-callback.ts"],"sourcesContent":["import type { Readable } from '@vielzeug/ripple';\n\nimport { watch } from '@vielzeug/ripple';\n\n/** Shape every `ref` prop in this package uses — a JS-only escape hatch to the live element. */\nexport type RefCallback<T> = ((el: T | null) => void) | null | undefined;\n\n/**\n * Forwards a mounted element to a JS-only `ref` callback prop, and keeps forwarding to a\n * *new* callback if the prop is set again after mount (e.g. a parent sets it via a ref\n * callback after render, rather than at initial mount). Every text-entry-style component\n * with a `ref` escape-hatch prop (`ore-input`, `ore-textarea`, `ore-message-composer`,\n * `ore-file-input`) wires this identically — call it once from inside `onElement()`, alongside\n * whatever else that element needs wired.\n *\n * @example\n * ```ts\n * onElement(fieldRef, (el) => {\n *   const unwireField = tf.wire(el);\n *   const unwireRef = bindRefCallback(props.ref, el);\n *\n *   return () => {\n *     unwireField();\n *     unwireRef();\n *   };\n * });\n * ```\n */\nexport const bindRefCallback = <T extends Element>(ref: Readable<RefCallback<T>>, el: T): (() => void) => {\n  // Immediate fire for when the prop is already set on mount.\n  ref.value?.(el);\n\n  const sub = watch(ref, (cb) => cb?.(el));\n\n  return () => {\n    sub.dispose();\n    ref.value?.(null);\n  };\n};\n"],"mappings":"kCA4BA,IAAa,GAAsC,EAA+B,IAAwB,CAExG,EAAI,QAAQ,CAAE,EAEd,IAAM,GAAA,EAAA,EAAA,MAAA,CAAY,EAAM,GAAO,IAAK,CAAE,CAAC,EAEvC,UAAa,CACX,EAAI,QAAQ,EACZ,EAAI,QAAQ,IAAI,CAClB,CACF"}

package/dist/headless/ref-callback.d.ts

@@ -0,0 +1,26 @@
+import type { Readable } from '@vielzeug/ripple';
+/** Shape every `ref` prop in this package uses — a JS-only escape hatch to the live element. */
+export type RefCallback<T> = ((el: T | null) => void) | null | undefined;
+/**
+ * Forwards a mounted element to a JS-only `ref` callback prop, and keeps forwarding to a
+ * *new* callback if the prop is set again after mount (e.g. a parent sets it via a ref
+ * callback after render, rather than at initial mount). Every text-entry-style component
+ * with a `ref` escape-hatch prop (`ore-input`, `ore-textarea`, `ore-message-composer`,
+ * `ore-file-input`) wires this identically — call it once from inside `onElement()`, alongside
+ * whatever else that element needs wired.
+ *
+ * @example
+ * ```ts
+ * onElement(fieldRef, (el) => {
+ *   const unwireField = tf.wire(el);
+ *   const unwireRef = bindRefCallback(props.ref, el);
+ *
+ *   return () => {
+ *     unwireField();
+ *     unwireRef();
+ *   };
+ * });
+ * ```
+ */
+export declare const bindRefCallback: <T extends Element>(ref: Readable<RefCallback<T>>, el: T) => (() => void);
+//# sourceMappingURL=ref-callback.d.ts.map

package/dist/headless/ref-callback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ref-callback.d.ts","sourceRoot":"","sources":["../../src/headless/ref-callback.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAIjD,gGAAgG;AAChG,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,KAAK,IAAI,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;AAEzE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,eAAe,GAAI,CAAC,SAAS,OAAO,EAAE,KAAK,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,KAAG,CAAC,MAAM,IAAI,CAUpG,CAAC"}

package/dist/headless/ref-callback.js

@@ -0,0 +1,13 @@
+import { watch as e } from "@vielzeug/ripple";
+//#region src/headless/ref-callback.ts
+var t = (t, n) => {
+	t.value?.(n);
+	let r = e(t, (e) => e?.(n));
+	return () => {
+		r.dispose(), t.value?.(null);
+	};
+};
+//#endregion
+export { t as bindRefCallback };
+
+//# sourceMappingURL=ref-callback.js.map

package/dist/headless/ref-callback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ref-callback.js","names":[],"sources":["../../src/headless/ref-callback.ts"],"sourcesContent":["import type { Readable } from '@vielzeug/ripple';\n\nimport { watch } from '@vielzeug/ripple';\n\n/** Shape every `ref` prop in this package uses — a JS-only escape hatch to the live element. */\nexport type RefCallback<T> = ((el: T | null) => void) | null | undefined;\n\n/**\n * Forwards a mounted element to a JS-only `ref` callback prop, and keeps forwarding to a\n * *new* callback if the prop is set again after mount (e.g. a parent sets it via a ref\n * callback after render, rather than at initial mount). Every text-entry-style component\n * with a `ref` escape-hatch prop (`ore-input`, `ore-textarea`, `ore-message-composer`,\n * `ore-file-input`) wires this identically — call it once from inside `onElement()`, alongside\n * whatever else that element needs wired.\n *\n * @example\n * ```ts\n * onElement(fieldRef, (el) => {\n *   const unwireField = tf.wire(el);\n *   const unwireRef = bindRefCallback(props.ref, el);\n *\n *   return () => {\n *     unwireField();\n *     unwireRef();\n *   };\n * });\n * ```\n */\nexport const bindRefCallback = <T extends Element>(ref: Readable<RefCallback<T>>, el: T): (() => void) => {\n  // Immediate fire for when the prop is already set on mount.\n  ref.value?.(el);\n\n  const sub = watch(ref, (cb) => cb?.(el));\n\n  return () => {\n    sub.dispose();\n    ref.value?.(null);\n  };\n};\n"],"mappings":";;AA4BA,IAAa,KAAsC,GAA+B,MAAwB;CAExG,EAAI,QAAQ,CAAE;CAEd,IAAM,IAAM,EAAM,IAAM,MAAO,IAAK,CAAE,CAAC;CAEvC,aAAa;EAEX,AADA,EAAI,QAAQ,GACZ,EAAI,QAAQ,IAAI;CAClB;AACF"}

package/dist/headless/swipe.cjs

@@ -1,2 +1,2 @@
-var e=e=>e.axis?.()??`x`,t=e=>{let t=e.threshold?.()??48;return Number.isFinite(t)&&t>0?t:1},n=(e,t)=>t===`x`?e.clientX:e.clientY,r=e=>e.currentTarget instanceof HTMLElement?e.currentTarget:e.target instanceof HTMLElement?e.target:null,i=i=>{let a=null,o=()=>!!i.disabled?.value,s=()=>{a=null},c=e=>a?.pointerId===e.pointerId,l=e=>{if(!a)return null;let t=n(e,a.axis),r=t-a.start;return{axis:a.axis,current:t,distance:r,event:e,pointerId:a.pointerId,progress:Math.min(Math.abs(r)/a.threshold,1),start:a.start,threshold:a.threshold}};return{dispose:s,handlePointerCancel:e=>{if(!a||!c(e))return!1;let t=l(e);return s(),t&&i.onCancel?.(t),!0},handlePointerDown:s=>{if(a||o())return!1;let c=e(i);a={axis:c,pointerId:s.pointerId,start:n(s,c),threshold:t(i)},(typeof i.captureTarget==`function`?i.captureTarget(s):r(s))?.setPointerCapture?.(s.pointerId);let u=l(s);return u&&i.onStart?.(u),!0},handlePointerMove:e=>{if(!a||!c(e))return!1;let t=l(e);return t?(i.onMove?.(t),i.shouldCommit?.(t)??Math.abs(t.distance)>=t.threshold?(s(),i.onCommit?.(t),!0):!0):!1},handlePointerUp:e=>{if(!a||!c(e))return!1;let t=l(e);return s(),t&&i.onRelease?.(t),!0},isActive:()=>a!=null,[Symbol.dispose]:s}};exports.createSwipeControl=i;
+var e=e=>e.axis?.()??`x`,t=e=>{let t=e.threshold?.()??48;return Number.isFinite(t)&&t>0?t:1},n=(e,t)=>t===`x`?e.clientX:e.clientY,r=e=>e.currentTarget instanceof HTMLElement?e.currentTarget:e.target instanceof HTMLElement?e.target:null,i=i=>{let a=null,o=!1,s=()=>!!i.disabled?.value,c=()=>{a=null},l=()=>{o=!0,c()},u=e=>a?.pointerId===e.pointerId,d=e=>{if(!a)return null;let t=n(e,a.axis),r=t-a.start;return{axis:a.axis,current:t,distance:r,event:e,pointerId:a.pointerId,progress:Math.min(Math.abs(r)/a.threshold,1),start:a.start,threshold:a.threshold}};return{dispose:l,get disposed(){return o},handlePointerCancel:e=>{if(!a||!u(e))return!1;let t=d(e);return c(),t&&i.onCancel?.(t),!0},handlePointerDown:c=>{if(o||a||s())return!1;let l=e(i);a={axis:l,pointerId:c.pointerId,start:n(c,l),threshold:t(i)},(typeof i.captureTarget==`function`?i.captureTarget(c):r(c))?.setPointerCapture?.(c.pointerId);let u=d(c);return u&&i.onStart?.(u),!0},handlePointerMove:e=>{if(!a||!u(e))return!1;let t=d(e);return t?(i.onMove?.(t),i.shouldCommit?.(t)??Math.abs(t.distance)>=t.threshold?(c(),i.onCommit?.(t),!0):!0):!1},handlePointerUp:e=>{if(!a||!u(e))return!1;let t=d(e);return c(),t&&i.onRelease?.(t),!0},isActive:()=>a!=null,[Symbol.dispose]:l}};exports.createSwipeControl=i;
 //# sourceMappingURL=swipe.cjs.map

package/dist/headless/swipe.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"swipe.cjs","names":[],"sources":["../../src/headless/swipe.ts"],"sourcesContent":["import type { Readable } from '@vielzeug/ripple';\n\nexport type SwipeAxis = 'x' | 'y';\n\nexport type SwipeControlDetail = {\n  axis: SwipeAxis;\n  current: number;\n  distance: number;\n  event: PointerEvent;\n  pointerId: number;\n  progress: number;\n  start: number;\n  threshold: number;\n};\n\nexport type SwipeControlOptions = {\n  axis?: () => SwipeAxis;\n  captureTarget?: (event: PointerEvent) => HTMLElement | null;\n  disabled?: Readable<boolean | undefined>;\n  /** Called when the platform interrupts an in-flight swipe (`pointercancel`). */\n  onCancel?: (detail: SwipeControlDetail) => void;\n  onCommit?: (detail: SwipeControlDetail) => void;\n  onMove?: (detail: SwipeControlDetail) => void;\n  /** Called when the pointer is released (`pointerup`) without crossing the commit threshold. */\n  onRelease?: (detail: SwipeControlDetail) => void;\n  onStart?: (detail: SwipeControlDetail) => void;\n  shouldCommit?: (detail: SwipeControlDetail) => boolean;\n  threshold?: () => number;\n};\n\nexport type SwipeControl = {\n  [Symbol.dispose](): void;\n  /** Cancel any in-flight swipe and clean up internal state. */\n  dispose: () => void;\n  handlePointerCancel: (event: PointerEvent) => boolean;\n  handlePointerDown: (event: PointerEvent) => boolean;\n  handlePointerMove: (event: PointerEvent) => boolean;\n  handlePointerUp: (event: PointerEvent) => boolean;\n  isActive: () => boolean;\n};\n\ntype ActiveSwipe = {\n  axis: SwipeAxis;\n  pointerId: number;\n  start: number;\n  threshold: number;\n};\n\nconst resolveAxis = (options: SwipeControlOptions): SwipeAxis => options.axis?.() ?? 'x';\n\nconst resolveThreshold = (options: SwipeControlOptions): number => {\n  const threshold = options.threshold?.() ?? 48;\n\n  return Number.isFinite(threshold) && threshold > 0 ? threshold : 1;\n};\n\nconst getCoordinate = (event: PointerEvent, axis: SwipeAxis): number => {\n  return axis === 'x' ? event.clientX : event.clientY;\n};\n\nconst defaultCaptureTarget = (event: PointerEvent): HTMLElement | null => {\n  if (event.currentTarget instanceof HTMLElement) return event.currentTarget;\n\n  if (event.target instanceof HTMLElement) return event.target;\n\n  return null;\n};\n\nexport const createSwipeControl = (options: SwipeControlOptions): SwipeControl => {\n  let active: ActiveSwipe | null = null;\n\n  const isDisabled = (): boolean => Boolean(options.disabled?.value);\n\n  const reset = (): void => {\n    active = null;\n  };\n\n  const matchesPointer = (event: PointerEvent): boolean => {\n    return active?.pointerId === event.pointerId;\n  };\n\n  const createDetail = (event: PointerEvent): SwipeControlDetail | null => {\n    if (!active) return null;\n\n    const current = getCoordinate(event, active.axis);\n    const distance = current - active.start;\n\n    return {\n      axis: active.axis,\n      current,\n      distance,\n      event,\n      pointerId: active.pointerId,\n      progress: Math.min(Math.abs(distance) / active.threshold, 1),\n      start: active.start,\n      threshold: active.threshold,\n    };\n  };\n\n  const handlePointerDown = (event: PointerEvent): boolean => {\n    if (active || isDisabled()) return false;\n\n    const axis = resolveAxis(options);\n\n    active = {\n      axis,\n      pointerId: event.pointerId,\n      start: getCoordinate(event, axis),\n      threshold: resolveThreshold(options),\n    };\n\n    const captureTarget =\n      typeof options.captureTarget === 'function' ? options.captureTarget(event) : defaultCaptureTarget(event);\n\n    captureTarget?.setPointerCapture?.(event.pointerId);\n\n    const detail = createDetail(event);\n\n    if (detail) options.onStart?.(detail);\n\n    return true;\n  };\n\n  const handlePointerMove = (event: PointerEvent): boolean => {\n    if (!active || !matchesPointer(event)) return false;\n\n    const detail = createDetail(event);\n\n    if (!detail) return false;\n\n    options.onMove?.(detail);\n\n    const shouldCommit = options.shouldCommit?.(detail) ?? Math.abs(detail.distance) >= detail.threshold;\n\n    if (!shouldCommit) return true;\n\n    reset();\n    options.onCommit?.(detail);\n\n    return true;\n  };\n\n  const handlePointerUp = (event: PointerEvent): boolean => {\n    if (!active || !matchesPointer(event)) return false;\n\n    const detail = createDetail(event);\n\n    reset();\n\n    if (detail) options.onRelease?.(detail);\n\n    return true;\n  };\n\n  const handlePointerCancel = (event: PointerEvent): boolean => {\n    if (!active || !matchesPointer(event)) return false;\n\n    const detail = createDetail(event);\n\n    reset();\n\n    if (detail) options.onCancel?.(detail);\n\n    return true;\n  };\n\n  return {\n    dispose: reset,\n    handlePointerCancel,\n    handlePointerDown,\n    handlePointerMove,\n    handlePointerUp,\n    isActive: () => active != null,\n    [Symbol.dispose]: reset,\n  };\n};\n"],"mappings":"AAgDA,IAAM,EAAe,GAA4C,EAAQ,OAAO,GAAK,IAE/E,EAAoB,GAAyC,CACjE,IAAM,EAAY,EAAQ,YAAY,GAAK,GAE3C,OAAO,OAAO,SAAS,CAAS,GAAK,EAAY,EAAI,EAAY,CACnE,EAEM,GAAiB,EAAqB,IACnC,IAAS,IAAM,EAAM,QAAU,EAAM,QAGxC,EAAwB,GACxB,EAAM,yBAAyB,YAAoB,EAAM,cAEzD,EAAM,kBAAkB,YAAoB,EAAM,OAE/C,KAGI,EAAsB,GAA+C,CAChF,IAAI,EAA6B,KAE3B,MAA4B,EAAQ,EAAQ,UAAU,MAEtD,MAAoB,CACxB,EAAS,IACX,EAEM,EAAkB,GACf,GAAQ,YAAc,EAAM,UAG/B,EAAgB,GAAmD,CACvE,GAAI,CAAC,EAAQ,OAAO,KAEpB,IAAM,EAAU,EAAc,EAAO,EAAO,IAAI,EAC1C,EAAW,EAAU,EAAO,MAElC,MAAO,CACL,KAAM,EAAO,KACb,UACA,WACA,QACA,UAAW,EAAO,UAClB,SAAU,KAAK,IAAI,KAAK,IAAI,CAAQ,EAAI,EAAO,UAAW,CAAC,EAC3D,MAAO,EAAO,MACd,UAAW,EAAO,SACpB,CACF,EAqEA,MAAO,CACL,QAAS,EACT,oBAd2B,GAAiC,CAC5D,GAAI,CAAC,GAAU,CAAC,EAAe,CAAK,EAAG,MAAO,GAE9C,IAAM,EAAS,EAAa,CAAK,EAMjC,OAJA,EAAM,EAEF,GAAQ,EAAQ,WAAW,CAAM,EAE9B,EACT,EAKE,kBAtEyB,GAAiC,CAC1D,GAAI,GAAU,EAAW,EAAG,MAAO,GAEnC,IAAM,EAAO,EAAY,CAAO,EAEhC,EAAS,CACP,OACA,UAAW,EAAM,UACjB,MAAO,EAAc,EAAO,CAAI,EAChC,UAAW,EAAiB,CAAO,CACrC,GAGE,OAAO,EAAQ,eAAkB,WAAa,EAAQ,cAAc,CAAK,EAAI,EAAqB,CAAK,EAAA,EAE1F,oBAAoB,EAAM,SAAS,EAElD,IAAM,EAAS,EAAa,CAAK,EAIjC,OAFI,GAAQ,EAAQ,UAAU,CAAM,EAE7B,EACT,EAiDE,kBA/CyB,GAAiC,CAC1D,GAAI,CAAC,GAAU,CAAC,EAAe,CAAK,EAAG,MAAO,GAE9C,IAAM,EAAS,EAAa,CAAK,EAajC,OAXK,GAEL,EAAQ,SAAS,CAAM,EAEF,EAAQ,eAAe,CAAM,GAAK,KAAK,IAAI,EAAO,QAAQ,GAAK,EAAO,WAI3F,EAAM,EACN,EAAQ,WAAW,CAAM,EAElB,IALmB,IANN,EAYtB,EA+BE,gBA7BuB,GAAiC,CACxD,GAAI,CAAC,GAAU,CAAC,EAAe,CAAK,EAAG,MAAO,GAE9C,IAAM,EAAS,EAAa,CAAK,EAMjC,OAJA,EAAM,EAEF,GAAQ,EAAQ,YAAY,CAAM,EAE/B,EACT,EAoBE,aAAgB,GAAU,MACzB,OAAO,SAAU,CACpB,CACF"}
+{"version":3,"file":"swipe.cjs","names":[],"sources":["../../src/headless/swipe.ts"],"sourcesContent":["import type { Readable } from '@vielzeug/ripple';\n\nexport type SwipeAxis = 'x' | 'y';\n\nexport type SwipeControlDetail = {\n  axis: SwipeAxis;\n  current: number;\n  distance: number;\n  event: PointerEvent;\n  pointerId: number;\n  progress: number;\n  start: number;\n  threshold: number;\n};\n\nexport type SwipeControlOptions = {\n  axis?: () => SwipeAxis;\n  captureTarget?: (event: PointerEvent) => HTMLElement | null;\n  disabled?: Readable<boolean | undefined>;\n  /** Called when the platform interrupts an in-flight swipe (`pointercancel`). */\n  onCancel?: (detail: SwipeControlDetail) => void;\n  onCommit?: (detail: SwipeControlDetail) => void;\n  onMove?: (detail: SwipeControlDetail) => void;\n  /** Called when the pointer is released (`pointerup`) without crossing the commit threshold. */\n  onRelease?: (detail: SwipeControlDetail) => void;\n  onStart?: (detail: SwipeControlDetail) => void;\n  shouldCommit?: (detail: SwipeControlDetail) => boolean;\n  threshold?: () => number;\n};\n\nexport type SwipeControl = {\n  [Symbol.dispose](): void;\n  /** Cancel any in-flight swipe and clean up internal state. */\n  dispose: () => void;\n  /** `true` after `dispose()` has been called. */\n  readonly disposed: boolean;\n  handlePointerCancel: (event: PointerEvent) => boolean;\n  handlePointerDown: (event: PointerEvent) => boolean;\n  handlePointerMove: (event: PointerEvent) => boolean;\n  handlePointerUp: (event: PointerEvent) => boolean;\n  isActive: () => boolean;\n};\n\ntype ActiveSwipe = {\n  axis: SwipeAxis;\n  pointerId: number;\n  start: number;\n  threshold: number;\n};\n\nconst resolveAxis = (options: SwipeControlOptions): SwipeAxis => options.axis?.() ?? 'x';\n\nconst resolveThreshold = (options: SwipeControlOptions): number => {\n  const threshold = options.threshold?.() ?? 48;\n\n  return Number.isFinite(threshold) && threshold > 0 ? threshold : 1;\n};\n\nconst getCoordinate = (event: PointerEvent, axis: SwipeAxis): number => {\n  return axis === 'x' ? event.clientX : event.clientY;\n};\n\nconst defaultCaptureTarget = (event: PointerEvent): HTMLElement | null => {\n  if (event.currentTarget instanceof HTMLElement) return event.currentTarget;\n\n  if (event.target instanceof HTMLElement) return event.target;\n\n  return null;\n};\n\nexport const createSwipeControl = (options: SwipeControlOptions): SwipeControl => {\n  let active: ActiveSwipe | null = null;\n  let disposed = false;\n\n  const isDisabled = (): boolean => Boolean(options.disabled?.value);\n\n  const reset = (): void => {\n    active = null;\n  };\n\n  const dispose = (): void => {\n    disposed = true;\n    reset();\n  };\n\n  const matchesPointer = (event: PointerEvent): boolean => {\n    return active?.pointerId === event.pointerId;\n  };\n\n  const createDetail = (event: PointerEvent): SwipeControlDetail | null => {\n    if (!active) return null;\n\n    const current = getCoordinate(event, active.axis);\n    const distance = current - active.start;\n\n    return {\n      axis: active.axis,\n      current,\n      distance,\n      event,\n      pointerId: active.pointerId,\n      progress: Math.min(Math.abs(distance) / active.threshold, 1),\n      start: active.start,\n      threshold: active.threshold,\n    };\n  };\n\n  const handlePointerDown = (event: PointerEvent): boolean => {\n    if (disposed || active || isDisabled()) return false;\n\n    const axis = resolveAxis(options);\n\n    active = {\n      axis,\n      pointerId: event.pointerId,\n      start: getCoordinate(event, axis),\n      threshold: resolveThreshold(options),\n    };\n\n    const captureTarget =\n      typeof options.captureTarget === 'function' ? options.captureTarget(event) : defaultCaptureTarget(event);\n\n    captureTarget?.setPointerCapture?.(event.pointerId);\n\n    const detail = createDetail(event);\n\n    if (detail) options.onStart?.(detail);\n\n    return true;\n  };\n\n  const handlePointerMove = (event: PointerEvent): boolean => {\n    if (!active || !matchesPointer(event)) return false;\n\n    const detail = createDetail(event);\n\n    if (!detail) return false;\n\n    options.onMove?.(detail);\n\n    const shouldCommit = options.shouldCommit?.(detail) ?? Math.abs(detail.distance) >= detail.threshold;\n\n    if (!shouldCommit) return true;\n\n    reset();\n    options.onCommit?.(detail);\n\n    return true;\n  };\n\n  const handlePointerUp = (event: PointerEvent): boolean => {\n    if (!active || !matchesPointer(event)) return false;\n\n    const detail = createDetail(event);\n\n    reset();\n\n    if (detail) options.onRelease?.(detail);\n\n    return true;\n  };\n\n  const handlePointerCancel = (event: PointerEvent): boolean => {\n    if (!active || !matchesPointer(event)) return false;\n\n    const detail = createDetail(event);\n\n    reset();\n\n    if (detail) options.onCancel?.(detail);\n\n    return true;\n  };\n\n  return {\n    dispose,\n    get disposed() {\n      return disposed;\n    },\n    handlePointerCancel,\n    handlePointerDown,\n    handlePointerMove,\n    handlePointerUp,\n    isActive: () => active != null,\n    [Symbol.dispose]: dispose,\n  };\n};\n"],"mappings":"AAkDA,IAAM,EAAe,GAA4C,EAAQ,OAAO,GAAK,IAE/E,EAAoB,GAAyC,CACjE,IAAM,EAAY,EAAQ,YAAY,GAAK,GAE3C,OAAO,OAAO,SAAS,CAAS,GAAK,EAAY,EAAI,EAAY,CACnE,EAEM,GAAiB,EAAqB,IACnC,IAAS,IAAM,EAAM,QAAU,EAAM,QAGxC,EAAwB,GACxB,EAAM,yBAAyB,YAAoB,EAAM,cAEzD,EAAM,kBAAkB,YAAoB,EAAM,OAE/C,KAGI,EAAsB,GAA+C,CAChF,IAAI,EAA6B,KAC7B,EAAW,GAET,MAA4B,EAAQ,EAAQ,UAAU,MAEtD,MAAoB,CACxB,EAAS,IACX,EAEM,MAAsB,CAC1B,EAAW,GACX,EAAM,CACR,EAEM,EAAkB,GACf,GAAQ,YAAc,EAAM,UAG/B,EAAgB,GAAmD,CACvE,GAAI,CAAC,EAAQ,OAAO,KAEpB,IAAM,EAAU,EAAc,EAAO,EAAO,IAAI,EAC1C,EAAW,EAAU,EAAO,MAElC,MAAO,CACL,KAAM,EAAO,KACb,UACA,WACA,QACA,UAAW,EAAO,UAClB,SAAU,KAAK,IAAI,KAAK,IAAI,CAAQ,EAAI,EAAO,UAAW,CAAC,EAC3D,MAAO,EAAO,MACd,UAAW,EAAO,SACpB,CACF,EAqEA,MAAO,CACL,UACA,IAAI,UAAW,CACb,OAAO,CACT,EACA,oBAjB2B,GAAiC,CAC5D,GAAI,CAAC,GAAU,CAAC,EAAe,CAAK,EAAG,MAAO,GAE9C,IAAM,EAAS,EAAa,CAAK,EAMjC,OAJA,EAAM,EAEF,GAAQ,EAAQ,WAAW,CAAM,EAE9B,EACT,EAQE,kBAzEyB,GAAiC,CAC1D,GAAI,GAAY,GAAU,EAAW,EAAG,MAAO,GAE/C,IAAM,EAAO,EAAY,CAAO,EAEhC,EAAS,CACP,OACA,UAAW,EAAM,UACjB,MAAO,EAAc,EAAO,CAAI,EAChC,UAAW,EAAiB,CAAO,CACrC,GAGE,OAAO,EAAQ,eAAkB,WAAa,EAAQ,cAAc,CAAK,EAAI,EAAqB,CAAK,EAAA,EAE1F,oBAAoB,EAAM,SAAS,EAElD,IAAM,EAAS,EAAa,CAAK,EAIjC,OAFI,GAAQ,EAAQ,UAAU,CAAM,EAE7B,EACT,EAoDE,kBAlDyB,GAAiC,CAC1D,GAAI,CAAC,GAAU,CAAC,EAAe,CAAK,EAAG,MAAO,GAE9C,IAAM,EAAS,EAAa,CAAK,EAajC,OAXK,GAEL,EAAQ,SAAS,CAAM,EAEF,EAAQ,eAAe,CAAM,GAAK,KAAK,IAAI,EAAO,QAAQ,GAAK,EAAO,WAI3F,EAAM,EACN,EAAQ,WAAW,CAAM,EAElB,IALmB,IANN,EAYtB,EAkCE,gBAhCuB,GAAiC,CACxD,GAAI,CAAC,GAAU,CAAC,EAAe,CAAK,EAAG,MAAO,GAE9C,IAAM,EAAS,EAAa,CAAK,EAMjC,OAJA,EAAM,EAEF,GAAQ,EAAQ,YAAY,CAAM,EAE/B,EACT,EAuBE,aAAgB,GAAU,MACzB,OAAO,SAAU,CACpB,CACF"}

package/dist/headless/swipe.d.ts

@@ -28,6 +28,8 @@ export type SwipeControl = {
     [Symbol.dispose](): void;
     /** Cancel any in-flight swipe and clean up internal state. */
     dispose: () => void;
+    /** `true` after `dispose()` has been called. */
+    readonly disposed: boolean;
     handlePointerCancel: (event: PointerEvent) => boolean;
     handlePointerDown: (event: PointerEvent) => boolean;
     handlePointerMove: (event: PointerEvent) => boolean;

package/dist/headless/swipe.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"swipe.d.ts","sourceRoot":"","sources":["../../src/headless/swipe.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEjD,MAAM,MAAM,SAAS,GAAG,GAAG,GAAG,GAAG,CAAC;AAElC,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,YAAY,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,CAAC,EAAE,MAAM,SAAS,CAAC;IACvB,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,WAAW,GAAG,IAAI,CAAC;IAC5D,QAAQ,CAAC,EAAE,QAAQ,CAAC,OAAO,GAAG,SAAS,CAAC,CAAC;IACzC,gFAAgF;IAChF,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,IAAI,CAAC;IAChD,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,IAAI,CAAC;IAChD,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,IAAI,CAAC;IAC9C,+FAA+F;IAC/F,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,IAAI,CAAC;IACjD,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,IAAI,CAAC;IAC/C,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,OAAO,CAAC;IACvD,SAAS,CAAC,EAAE,MAAM,MAAM,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC;IACzB,8DAA8D;IAC9D,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,mBAAmB,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,OAAO,CAAC;IACtD,iBAAiB,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,OAAO,CAAC;IACpD,iBAAiB,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,OAAO,CAAC;IACpD,eAAe,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,OAAO,CAAC;IAClD,QAAQ,EAAE,MAAM,OAAO,CAAC;CACzB,CAAC;AA6BF,eAAO,MAAM,kBAAkB,GAAI,SAAS,mBAAmB,KAAG,YA2GjE,CAAC"}
+{"version":3,"file":"swipe.d.ts","sourceRoot":"","sources":["../../src/headless/swipe.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEjD,MAAM,MAAM,SAAS,GAAG,GAAG,GAAG,GAAG,CAAC;AAElC,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,YAAY,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,CAAC,EAAE,MAAM,SAAS,CAAC;IACvB,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,WAAW,GAAG,IAAI,CAAC;IAC5D,QAAQ,CAAC,EAAE,QAAQ,CAAC,OAAO,GAAG,SAAS,CAAC,CAAC;IACzC,gFAAgF;IAChF,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,IAAI,CAAC;IAChD,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,IAAI,CAAC;IAChD,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,IAAI,CAAC;IAC9C,+FAA+F;IAC/F,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,IAAI,CAAC;IACjD,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,IAAI,CAAC;IAC/C,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,OAAO,CAAC;IACvD,SAAS,CAAC,EAAE,MAAM,MAAM,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC;IACzB,8DAA8D;IAC9D,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,gDAAgD;IAChD,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,mBAAmB,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,OAAO,CAAC;IACtD,iBAAiB,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,OAAO,CAAC;IACpD,iBAAiB,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,OAAO,CAAC;IACpD,eAAe,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,OAAO,CAAC;IAClD,QAAQ,EAAE,MAAM,OAAO,CAAC;CACzB,CAAC;AA6BF,eAAO,MAAM,kBAAkB,GAAI,SAAS,mBAAmB,KAAG,YAoHjE,CAAC"}

package/dist/headless/swipe.js

@@ -3,9 +3,11 @@ var e = (e) => e.axis?.() ?? "x", t = (e) => {
 	let t = e.threshold?.() ?? 48;
 	return Number.isFinite(t) && t > 0 ? t : 1;
 }, n = (e, t) => t === "x" ? e.clientX : e.clientY, r = (e) => e.currentTarget instanceof HTMLElement ? e.currentTarget : e.target instanceof HTMLElement ? e.target : null, i = (i) => {
-	let a = null, o = () => !!i.disabled?.value, s = () => {
+	let a = null, o = !1, s = () => !!i.disabled?.value, c = () => {
 		a = null;
-	}, c = (e) => a?.pointerId === e.pointerId, l = (e) => {
+	}, l = () => {
+		o = !0, c();
+	}, u = (e) => a?.pointerId === e.pointerId, d = (e) => {
 		if (!a) return null;
 		let t = n(e, a.axis), r = t - a.start;
 		return {
@@ -20,36 +22,39 @@ var e = (e) => e.axis?.() ?? "x", t = (e) => {
 		};
 	};
 	return {
-		dispose: s,
+		dispose: l,
+		get disposed() {
+			return o;
+		},
 		handlePointerCancel: (e) => {
-			if (!a || !c(e)) return !1;
-			let t = l(e);
-			return s(), t && i.onCancel?.(t), !0;
+			if (!a || !u(e)) return !1;
+			let t = d(e);
+			return c(), t && i.onCancel?.(t), !0;
 		},
-		handlePointerDown: (s) => {
-			if (a || o()) return !1;
-			let c = e(i);
+		handlePointerDown: (c) => {
+			if (o || a || s()) return !1;
+			let l = e(i);
 			a = {
-				axis: c,
-				pointerId: s.pointerId,
-				start: n(s, c),
+				axis: l,
+				pointerId: c.pointerId,
+				start: n(c, l),
 				threshold: t(i)
-			}, (typeof i.captureTarget == "function" ? i.captureTarget(s) : r(s))?.setPointerCapture?.(s.pointerId);
-			let u = l(s);
+			}, (typeof i.captureTarget == "function" ? i.captureTarget(c) : r(c))?.setPointerCapture?.(c.pointerId);
+			let u = d(c);
 			return u && i.onStart?.(u), !0;
 		},
 		handlePointerMove: (e) => {
-			if (!a || !c(e)) return !1;
-			let t = l(e);
-			return t ? (i.onMove?.(t), i.shouldCommit?.(t) ?? Math.abs(t.distance) >= t.threshold ? (s(), i.onCommit?.(t), !0) : !0) : !1;
+			if (!a || !u(e)) return !1;
+			let t = d(e);
+			return t ? (i.onMove?.(t), i.shouldCommit?.(t) ?? Math.abs(t.distance) >= t.threshold ? (c(), i.onCommit?.(t), !0) : !0) : !1;
 		},
 		handlePointerUp: (e) => {
-			if (!a || !c(e)) return !1;
-			let t = l(e);
-			return s(), t && i.onRelease?.(t), !0;
+			if (!a || !u(e)) return !1;
+			let t = d(e);
+			return c(), t && i.onRelease?.(t), !0;
 		},
 		isActive: () => a != null,
-		[Symbol.dispose]: s
+		[Symbol.dispose]: l
 	};
 };
 //#endregion