@vielzeug/refine 1.8.0 → 2.0.1

package/dist/headless/option-list.d.ts

@@ -1,107 +0,0 @@
-import { type Readable } from '@vielzeug/ripple';
-import { type ListKeyAction, type ListNavigationAction } from './nav';
-import { type DialogCloseReason, type OverlayOpenReason } from './overlay';
-import { type DropdownPositionerOptions } from './positioner';
-export type BaseOptionItem = object;
-/** Placement-only options for the dropdown positioner (getFloating/getReference are injected from the option-list). */
-export type PlacementOptions = Omit<DropdownPositionerOptions, 'getFloating' | 'getReference'>;
-export type OptionListOptions<T extends BaseOptionItem> = {
-    /** Returns the element used as the outside-click boundary. */
-    getBoundary: () => HTMLElement | null;
-    /**
-     * Returns the currently focused option element for scroll-into-view.
-     * When omitted, `scrollFocusedIntoView()` is a no-op.
-     */
-    getFocusedOptionElement?: () => HTMLElement | null;
-    /**
-     * Returns a plain-text label for the item at `index`.
-     * When provided, the list control supports typeahead.
-     */
-    getItemLabel?: (item: T, index: number) => string;
-    /** Returns the current list items. */
-    getItems: () => T[];
-    /**
-     * Derives a stable `id` for the option at `index`.
-     * When provided, `aria-activedescendant` is reactively set on the trigger element
-     * to reflect the currently focused option (WAI-ARIA listbox / combobox pattern).
-     */
-    getOptionId?: (index: number) => string;
-    /** Returns the floating panel element. */
-    getPanel: () => HTMLElement | null;
-    /** Returns the reference (trigger anchor) element for positioning. */
-    getReference: () => HTMLElement | null;
-    /** Returns the trigger element. Focus is restored here on close. */
-    getTrigger?: () => HTMLElement | null;
-    /** Returns `true` when all interactions should be suppressed (e.g. the host is disabled). */
-    isDisabled?: () => boolean;
-    isItemDisabled?: (item: T, index: number) => boolean;
-    /** Override default keyboard bindings for navigation actions. */
-    keys?: Partial<Record<ListNavigationAction, string[]>>;
-    /** Whether list navigation wraps around at the first/last item. Default: `true`. */
-    loop?: boolean;
-    /** Called when the list closes. */
-    onClose?: (reason: DialogCloseReason) => void;
-    /**
-     * Called when keyboard navigation lands on an item.
-     * `event` is the originating `KeyboardEvent`, or `undefined` for programmatic navigation.
-     */
-    onNavigate?: (action: ListKeyAction, index: number, event?: KeyboardEvent) => void;
-    /** Called when the list opens. */
-    onOpen?: (reason: OverlayOpenReason) => void;
-    /**
-     * Restricts keyboard navigation direction for the option list.
-     * Defaults to `'vertical'` when omitted (up/down arrow keys).
-     */
-    orientation?: 'both' | 'horizontal' | 'vertical';
-    /** Placement and sizing options for the floating dropdown. */
-    positioning?: PlacementOptions;
-    /** Whether focus is restored to the trigger on close. Default: inferred from `restoreFocus`. */
-    restoreFocus?: boolean | (() => boolean);
-    /** `AbortSignal` from the component lifecycle. Disposes subscriptions and removes event listeners on abort. */
-    signal: AbortSignal;
-};
-export type OptionListHandle<T extends BaseOptionItem> = {
-    /** Reactive `aria-activedescendant` value. `null` when no option is focused or the list is closed. */
-    readonly ariaActiveDescendant: Readable<string | null>;
-    /** Reactive `aria-expanded` value as string (`'true'` / `'false'`). */
-    readonly ariaExpanded: Readable<string>;
-    close(reason?: DialogCloseReason): void;
-    /**
-     * Focused item index (read-only). Write via `set(index)` to update through
-     * the list control — this ensures scroll-into-view and disabled-item checks.
-     */
-    readonly focusedIndex: Readable<number>;
-    getActiveItem(): T | undefined;
-    handleKeydown(event: KeyboardEvent): boolean;
-    /** Open state (read-only). Mutate via `open()`, `close()`, or `toggle()`. */
-    readonly isOpen: Readable<boolean>;
-    /**
-     * Programmatically navigate to a named position. Always fires `onNavigate`
-     * (scroll-into-view, aria-activedescendant update).
-     * Returns the resolved index, or `-1` if no enabled item was found.
-     */
-    navigate(action: ListNavigationAction): number;
-    open(reason?: OverlayOpenReason): void;
-    scrollFocusedIntoView(): void;
-    /**
-     * Set focus to the item at `index`. Returns the resolved index.
-     * Pass a negative index to clear focus (same as `reset()`).
-     */
-    set(index: number): number;
-    /**
-     * Toggles open state.
-     * - Opens with `openReason` (default `'click'`).
-     * - Closes with `closeReason` (default `'trigger'`).
-     */
-    toggle(openReason?: OverlayOpenReason, closeReason?: DialogCloseReason): void;
-    /** Imperatively re-run dropdown positioning (e.g. after filter changes list height). */
-    updatePosition(): void;
-};
-/**
- * Shared headless primitive for dropdown option lists (select, combobox, menu).
- *
- * Owns `isOpen`, `focusedIndex`, the dropdown positioner, list navigation, and
- * overlay wiring. Composes overlay.ts + nav.ts into a single complete API.
- */
-export declare const createOptionList: <T extends BaseOptionItem>(options: OptionListOptions<T>) => OptionListHandle<T>;
-//# sourceMappingURL=option-list.d.ts.map

package/dist/headless/option-list.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"option-list.d.ts","sourceRoot":"","sources":["../../src/headless/option-list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,QAAQ,EAAU,MAAM,kBAAkB,CAAC;AAGnE,OAAO,EAAqB,KAAK,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,OAAO,CAAC;AACzF,OAAO,EAAwB,KAAK,iBAAiB,EAAE,KAAK,iBAAiB,EAAE,MAAM,WAAW,CAAC;AACjG,OAAO,EAA4B,KAAK,yBAAyB,EAAE,MAAM,cAAc,CAAC;AAIxF,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC;AAEpC,uHAAuH;AACvH,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC,yBAAyB,EAAE,aAAa,GAAG,cAAc,CAAC,CAAC;AAE/F,MAAM,MAAM,iBAAiB,CAAC,CAAC,SAAS,cAAc,IAAI;IACxD,8DAA8D;IAC9D,WAAW,EAAE,MAAM,WAAW,GAAG,IAAI,CAAC;IACtC;;;OAGG;IACH,uBAAuB,CAAC,EAAE,MAAM,WAAW,GAAG,IAAI,CAAC;IACnD;;;OAGG;IACH,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IAClD,sCAAsC;IACtC,QAAQ,EAAE,MAAM,CAAC,EAAE,CAAC;IACpB;;;;OAIG;IACH,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IACxC,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,WAAW,GAAG,IAAI,CAAC;IACnC,sEAAsE;IACtE,YAAY,EAAE,MAAM,WAAW,GAAG,IAAI,CAAC;IACvC,oEAAoE;IACpE,UAAU,CAAC,EAAE,MAAM,WAAW,GAAG,IAAI,CAAC;IACtC,6FAA6F;IAC7F,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC;IAC3B,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;IACrD,iEAAiE;IACjE,IAAI,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,oBAAoB,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;IACvD,oFAAoF;IACpF,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,mCAAmC;IACnC,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,iBAAiB,KAAK,IAAI,CAAC;IAC9C;;;OAGG;IACH,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,aAAa,KAAK,IAAI,CAAC;IACnF,kCAAkC;IAClC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,iBAAiB,KAAK,IAAI,CAAC;IAC7C;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,YAAY,GAAG,UAAU,CAAC;IACjD,8DAA8D;IAC9D,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAC/B,gGAAgG;IAChG,YAAY,CAAC,EAAE,OAAO,GAAG,CAAC,MAAM,OAAO,CAAC,CAAC;IACzC,+GAA+G;IAC/G,MAAM,EAAE,WAAW,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,cAAc,IAAI;IACvD,sGAAsG;IACtG,QAAQ,CAAC,oBAAoB,EAAE,QAAQ,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACvD,uEAAuE;IACvE,QAAQ,CAAC,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IACxC,KAAK,CAAC,MAAM,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACxC;;;OAGG;IACH,QAAQ,CAAC,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IACxC,aAAa,IAAI,CAAC,GAAG,SAAS,CAAC;IAC/B,aAAa,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC;IAC7C,6EAA6E;IAC7E,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;IACnC;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,oBAAoB,GAAG,MAAM,CAAC;IAC/C,IAAI,CAAC,MAAM,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACvC,qBAAqB,IAAI,IAAI,CAAC;IAC9B;;;OAGG;IACH,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B;;;;OAIG;IACH,MAAM,CAAC,UAAU,CAAC,EAAE,iBAAiB,EAAE,WAAW,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC9E,wFAAwF;IACxF,cAAc,IAAI,IAAI,CAAC;CACxB,CAAC;AAIF;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,GAAI,CAAC,SAAS,cAAc,EAAE,SAAS,iBAAiB,CAAC,CAAC,CAAC,KAAG,gBAAgB,CAAC,CAAC,CAkG5G,CAAC"}

package/dist/headless/option-list.js

@@ -1,66 +0,0 @@
-import { RefineConfigError as e } from "../errors.js";
-import { createListControl as t } from "./nav.js";
-import { createOverlayControl as n } from "./overlay.js";
-import { createDropdownPositioner as r } from "./positioner.js";
-import { computed as i, signal as a } from "@vielzeug/ripple";
-//#region src/headless/option-list.ts
-var o = (o) => {
-	if (typeof o.getBoundary != "function") throw new e("createOptionList: getBoundary is required");
-	if (typeof o.getPanel != "function") throw new e("createOptionList: getPanel is required");
-	if (typeof o.getReference != "function") throw new e("createOptionList: getReference is required");
-	let s = a(!1), c = i(() => String(s.value)), l = r({
-		...o.positioning,
-		getFloating: o.getPanel,
-		getReference: o.getReference
-	}), u = () => {
-		o.getFocusedOptionElement?.()?.scrollIntoView({ block: "nearest" });
-	}, d = t({
-		disabled: i(() => !s.value),
-		getItemLabel: o.getItemLabel,
-		getItems: o.getItems,
-		isItemDisabled: o.isItemDisabled,
-		keys: o.keys,
-		loop: o.loop ?? !0,
-		onNavigate: (e, t, n) => {
-			u(), t >= 0 && o.onNavigate?.(e, t, n);
-		},
-		orientation: o.orientation,
-		signal: o.signal
-	}), f = i(() => {
-		let e = d.focusedIndex.value;
-		return o.getOptionId && s.value && e >= 0 ? o.getOptionId(e) : null;
-	}), p = n({
-		getBoundary: o.getBoundary,
-		getPanel: o.getPanel,
-		getTrigger: o.getTrigger,
-		isDisabled: o.isDisabled,
-		isOpen: () => s.value,
-		onClose: o.onClose,
-		onOpen: o.onOpen,
-		positioner: l,
-		restoreFocus: o.restoreFocus,
-		setOpen: (e) => {
-			s.value = e, e || d.reset();
-		},
-		signal: o.signal
-	});
-	return {
-		ariaActiveDescendant: f,
-		ariaExpanded: c,
-		close: (e) => p.close(e),
-		focusedIndex: d.focusedIndex,
-		getActiveItem: d.getActiveItem,
-		handleKeydown: (e) => s.value ? e.key === "Escape" ? (e.preventDefault(), p.close("escape"), !0) : d.handleKeydown(e) : !1,
-		isOpen: s,
-		navigate: d.navigate,
-		open: (e) => p.open(e),
-		scrollFocusedIntoView: u,
-		set: d.set,
-		toggle: (e, t) => p.toggle(e, t),
-		updatePosition: l.update
-	};
-};
-//#endregion
-export { o as createOptionList };
-
-//# sourceMappingURL=option-list.js.map

package/dist/headless/option-list.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"option-list.js","names":[],"sources":["../../src/headless/option-list.ts"],"sourcesContent":["import { computed, type Readable, signal } from '@vielzeug/ripple';\n\nimport { RefineConfigError } from '../errors';\nimport { createListControl, type ListKeyAction, type ListNavigationAction } from './nav';\nimport { createOverlayControl, type DialogCloseReason, type OverlayOpenReason } from './overlay';\nimport { createDropdownPositioner, type DropdownPositionerOptions } from './positioner';\n\n// ── Types ─────────────────────────────────────────────────────────────────────\n\nexport type BaseOptionItem = object;\n\n/** Placement-only options for the dropdown positioner (getFloating/getReference are injected from the option-list). */\nexport type PlacementOptions = Omit<DropdownPositionerOptions, 'getFloating' | 'getReference'>;\n\nexport type OptionListOptions<T extends BaseOptionItem> = {\n  /** Returns the element used as the outside-click boundary. */\n  getBoundary: () => HTMLElement | null;\n  /**\n   * Returns the currently focused option element for scroll-into-view.\n   * When omitted, `scrollFocusedIntoView()` is a no-op.\n   */\n  getFocusedOptionElement?: () => HTMLElement | null;\n  /**\n   * Returns a plain-text label for the item at `index`.\n   * When provided, the list control supports typeahead.\n   */\n  getItemLabel?: (item: T, index: number) => string;\n  /** Returns the current list items. */\n  getItems: () => T[];\n  /**\n   * Derives a stable `id` for the option at `index`.\n   * When provided, `aria-activedescendant` is reactively set on the trigger element\n   * to reflect the currently focused option (WAI-ARIA listbox / combobox pattern).\n   */\n  getOptionId?: (index: number) => string;\n  /** Returns the floating panel element. */\n  getPanel: () => HTMLElement | null;\n  /** Returns the reference (trigger anchor) element for positioning. */\n  getReference: () => HTMLElement | null;\n  /** Returns the trigger element. Focus is restored here on close. */\n  getTrigger?: () => HTMLElement | null;\n  /** Returns `true` when all interactions should be suppressed (e.g. the host is disabled). */\n  isDisabled?: () => boolean;\n  isItemDisabled?: (item: T, index: number) => boolean;\n  /** Override default keyboard bindings for navigation actions. */\n  keys?: Partial<Record<ListNavigationAction, string[]>>;\n  /** Whether list navigation wraps around at the first/last item. Default: `true`. */\n  loop?: boolean;\n  /** Called when the list closes. */\n  onClose?: (reason: DialogCloseReason) => void;\n  /**\n   * Called when keyboard navigation lands on an item.\n   * `event` is the originating `KeyboardEvent`, or `undefined` for programmatic navigation.\n   */\n  onNavigate?: (action: ListKeyAction, index: number, event?: KeyboardEvent) => void;\n  /** Called when the list opens. */\n  onOpen?: (reason: OverlayOpenReason) => void;\n  /**\n   * Restricts keyboard navigation direction for the option list.\n   * Defaults to `'vertical'` when omitted (up/down arrow keys).\n   */\n  orientation?: 'both' | 'horizontal' | 'vertical';\n  /** Placement and sizing options for the floating dropdown. */\n  positioning?: PlacementOptions;\n  /** Whether focus is restored to the trigger on close. Default: inferred from `restoreFocus`. */\n  restoreFocus?: boolean | (() => boolean);\n  /** `AbortSignal` from the component lifecycle. Disposes subscriptions and removes event listeners on abort. */\n  signal: AbortSignal;\n};\n\nexport type OptionListHandle<T extends BaseOptionItem> = {\n  /** Reactive `aria-activedescendant` value. `null` when no option is focused or the list is closed. */\n  readonly ariaActiveDescendant: Readable<string | null>;\n  /** Reactive `aria-expanded` value as string (`'true'` / `'false'`). */\n  readonly ariaExpanded: Readable<string>;\n  close(reason?: DialogCloseReason): void;\n  /**\n   * Focused item index (read-only). Write via `set(index)` to update through\n   * the list control — this ensures scroll-into-view and disabled-item checks.\n   */\n  readonly focusedIndex: Readable<number>;\n  getActiveItem(): T | undefined;\n  handleKeydown(event: KeyboardEvent): boolean;\n  /** Open state (read-only). Mutate via `open()`, `close()`, or `toggle()`. */\n  readonly isOpen: Readable<boolean>;\n  /**\n   * Programmatically navigate to a named position. Always fires `onNavigate`\n   * (scroll-into-view, aria-activedescendant update).\n   * Returns the resolved index, or `-1` if no enabled item was found.\n   */\n  navigate(action: ListNavigationAction): number;\n  open(reason?: OverlayOpenReason): void;\n  scrollFocusedIntoView(): 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   * Toggles open state.\n   * - Opens with `openReason` (default `'click'`).\n   * - Closes with `closeReason` (default `'trigger'`).\n   */\n  toggle(openReason?: OverlayOpenReason, closeReason?: DialogCloseReason): void;\n  /** Imperatively re-run dropdown positioning (e.g. after filter changes list height). */\n  updatePosition(): void;\n};\n\n// ── Factory ───────────────────────────────────────────────────────────────────\n\n/**\n * Shared headless primitive for dropdown option lists (select, combobox, menu).\n *\n * Owns `isOpen`, `focusedIndex`, the dropdown positioner, list navigation, and\n * overlay wiring. Composes overlay.ts + nav.ts into a single complete API.\n */\nexport const createOptionList = <T extends BaseOptionItem>(options: OptionListOptions<T>): OptionListHandle<T> => {\n  if (typeof options.getBoundary !== 'function') {\n    throw new RefineConfigError('createOptionList: getBoundary is required');\n  }\n\n  if (typeof options.getPanel !== 'function') {\n    throw new RefineConfigError('createOptionList: getPanel is required');\n  }\n\n  if (typeof options.getReference !== 'function') {\n    throw new RefineConfigError('createOptionList: getReference is required');\n  }\n\n  const isOpen = signal(false);\n\n  const ariaExpanded = computed(() => String(isOpen.value));\n\n  const positioner = createDropdownPositioner({\n    ...options.positioning,\n    getFloating: options.getPanel,\n    getReference: options.getReference,\n  });\n\n  const scrollFocusedIntoView = (): void => {\n    options.getFocusedOptionElement?.()?.scrollIntoView({ block: 'nearest' });\n  };\n\n  const list = createListControl<T>({\n    disabled: computed(() => !isOpen.value),\n    getItemLabel: options.getItemLabel,\n    getItems: options.getItems,\n    isItemDisabled: options.isItemDisabled,\n    keys: options.keys,\n    loop: options.loop ?? true,\n    onNavigate: (action, index, event) => {\n      scrollFocusedIntoView();\n\n      if (index >= 0) options.onNavigate?.(action, index, event);\n    },\n    orientation: options.orientation,\n    signal: options.signal,\n  });\n\n  const ariaActiveDescendant = computed<string | null>(() => {\n    const idx = list.focusedIndex.value;\n\n    return options.getOptionId && isOpen.value && idx >= 0 ? options.getOptionId(idx) : null;\n  });\n\n  const overlay = createOverlayControl({\n    getBoundary: options.getBoundary,\n    getPanel: options.getPanel,\n    getTrigger: options.getTrigger,\n    isDisabled: options.isDisabled,\n    isOpen: () => isOpen.value,\n    onClose: options.onClose,\n    onOpen: options.onOpen,\n    positioner,\n    restoreFocus: options.restoreFocus,\n    setOpen: (next) => {\n      isOpen.value = next;\n\n      if (!next) list.reset();\n    },\n    signal: options.signal,\n  });\n\n  // Built-in Escape key handling: prevents each consumer from duplicating the\n  // close-on-escape pattern. Fires only when the list is open; returns `true`\n  // so callers know the event was handled and can stop further processing.\n  const handleKeydown = (event: KeyboardEvent): boolean => {\n    if (!isOpen.value) return false;\n\n    if (event.key === 'Escape') {\n      event.preventDefault();\n      overlay.close('escape');\n\n      return true;\n    }\n\n    return list.handleKeydown(event);\n  };\n\n  return {\n    ariaActiveDescendant,\n    ariaExpanded,\n    close: (reason) => overlay.close(reason),\n    focusedIndex: list.focusedIndex,\n    getActiveItem: list.getActiveItem,\n    handleKeydown,\n    isOpen,\n    navigate: list.navigate,\n    open: (reason) => overlay.open(reason),\n    scrollFocusedIntoView,\n    set: list.set,\n    toggle: (openReason, closeReason) => overlay.toggle(openReason, closeReason),\n    updatePosition: positioner.update,\n  };\n};\n"],"mappings":";;;;;;AAoHA,IAAa,KAA8C,MAAuD;CAChH,IAAI,OAAO,EAAQ,eAAgB,YACjC,MAAM,IAAI,EAAkB,2CAA2C;CAGzE,IAAI,OAAO,EAAQ,YAAa,YAC9B,MAAM,IAAI,EAAkB,wCAAwC;CAGtE,IAAI,OAAO,EAAQ,gBAAiB,YAClC,MAAM,IAAI,EAAkB,4CAA4C;CAG1E,IAAM,IAAS,EAAO,EAAK,GAErB,IAAe,QAAe,OAAO,EAAO,KAAK,CAAC,GAElD,IAAa,EAAyB;EAC1C,GAAG,EAAQ;EACX,aAAa,EAAQ;EACrB,cAAc,EAAQ;CACxB,CAAC,GAEK,UAAoC;EACxC,EAAQ,0BAA0B,CAAC,EAAE,eAAe,EAAE,OAAO,UAAU,CAAC;CAC1E,GAEM,IAAO,EAAqB;EAChC,UAAU,QAAe,CAAC,EAAO,KAAK;EACtC,cAAc,EAAQ;EACtB,UAAU,EAAQ;EAClB,gBAAgB,EAAQ;EACxB,MAAM,EAAQ;EACd,MAAM,EAAQ,QAAQ;EACtB,aAAa,GAAQ,GAAO,MAAU;GAGpC,AAFA,EAAsB,GAElB,KAAS,KAAG,EAAQ,aAAa,GAAQ,GAAO,CAAK;EAC3D;EACA,aAAa,EAAQ;EACrB,QAAQ,EAAQ;CAClB,CAAC,GAEK,IAAuB,QAA8B;EACzD,IAAM,IAAM,EAAK,aAAa;EAE9B,OAAO,EAAQ,eAAe,EAAO,SAAS,KAAO,IAAI,EAAQ,YAAY,CAAG,IAAI;CACtF,CAAC,GAEK,IAAU,EAAqB;EACnC,aAAa,EAAQ;EACrB,UAAU,EAAQ;EAClB,YAAY,EAAQ;EACpB,YAAY,EAAQ;EACpB,cAAc,EAAO;EACrB,SAAS,EAAQ;EACjB,QAAQ,EAAQ;EAChB;EACA,cAAc,EAAQ;EACtB,UAAU,MAAS;GAGjB,AAFA,EAAO,QAAQ,GAEV,KAAM,EAAK,MAAM;EACxB;EACA,QAAQ,EAAQ;CAClB,CAAC;CAkBD,OAAO;EACL;EACA;EACA,QAAQ,MAAW,EAAQ,MAAM,CAAM;EACvC,cAAc,EAAK;EACnB,eAAe,EAAK;EACpB,gBAnBqB,MAChB,EAAO,QAER,EAAM,QAAQ,YAChB,EAAM,eAAe,GACrB,EAAQ,MAAM,QAAQ,GAEf,MAGF,EAAK,cAAc,CAAK,IATL;EAmB1B;EACA,UAAU,EAAK;EACf,OAAO,MAAW,EAAQ,KAAK,CAAM;EACrC;EACA,KAAK,EAAK;EACV,SAAS,GAAY,MAAgB,EAAQ,OAAO,GAAY,CAAW;EAC3E,gBAAgB,EAAW;CAC7B;AACF"}

package/dist/headless/ore.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"ore.cjs","names":[],"sources":["../../src/headless/ore.ts"],"sourcesContent":["// ── Ore adapter ─────────────────────────────────────────────────────────────\n// Utilities that bridge Ore's component lifecycle with the headless\n// primitives' `AbortSignal`-based lifecycle contract.\n\n/**\n * Creates an `AbortSignal` tied to the component's Ore lifecycle.\n *\n * Call once at the top of a `setup()` function and pass the resulting signal\n * as the required `signal` option to any stateful headless primitive\n * (`createTextField`, `createCheckable`, `createOptionList`, etc.).\n *\n * When Ore disconnects the component, `onCleanup` fires, aborting the\n * signal and triggering cleanup in every primitive that received it.\n *\n * @example\n * ```ts\n * setup(props, { el }) {\n *   const signal = lifecycleSignal(onCleanup);\n *   const tf = createTextField({ ..., signal });\n * }\n * ```\n */\nexport const lifecycleSignal = (onCleanup: (fn: () => void) => void): AbortSignal => {\n  const controller = new AbortController();\n\n  onCleanup(() => controller.abort());\n\n  return controller.signal;\n};\n"],"mappings":"AAsBA,IAAa,EAAmB,GAAqD,CACnF,IAAM,EAAa,IAAI,gBAIvB,OAFA,MAAgB,EAAW,MAAM,CAAC,EAE3B,EAAW,MACpB"}

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

@@ -1 +0,0 @@
-{"version":3,"file":"ore.d.ts","sourceRoot":"","sources":["../../src/headless/ore.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,eAAe,GAAI,WAAW,CAAC,EAAE,EAAE,MAAM,IAAI,KAAK,IAAI,KAAG,WAMrE,CAAC"}

package/dist/headless/ore.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ore.js","names":[],"sources":["../../src/headless/ore.ts"],"sourcesContent":["// ── Ore adapter ─────────────────────────────────────────────────────────────\n// Utilities that bridge Ore's component lifecycle with the headless\n// primitives' `AbortSignal`-based lifecycle contract.\n\n/**\n * Creates an `AbortSignal` tied to the component's Ore lifecycle.\n *\n * Call once at the top of a `setup()` function and pass the resulting signal\n * as the required `signal` option to any stateful headless primitive\n * (`createTextField`, `createCheckable`, `createOptionList`, etc.).\n *\n * When Ore disconnects the component, `onCleanup` fires, aborting the\n * signal and triggering cleanup in every primitive that received it.\n *\n * @example\n * ```ts\n * setup(props, { el }) {\n *   const signal = lifecycleSignal(onCleanup);\n *   const tf = createTextField({ ..., signal });\n * }\n * ```\n */\nexport const lifecycleSignal = (onCleanup: (fn: () => void) => void): AbortSignal => {\n  const controller = new AbortController();\n\n  onCleanup(() => controller.abort());\n\n  return controller.signal;\n};\n"],"mappings":";AAsBA,IAAa,KAAmB,MAAqD;CACnF,IAAM,IAAa,IAAI,gBAAgB;CAIvC,OAFA,QAAgB,EAAW,MAAM,CAAC,GAE3B,EAAW;AACpB"}

package/dist/headless/overlay.cjs

@@ -1,2 +0,0 @@
-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 +0,0 @@
-{"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

@@ -1,64 +0,0 @@
-import type { OverlayPositioner } from './positioner';
-/**
- * Why an overlay was opened.
- * - `'click'`       — user clicked the trigger element
- * - `'focus'`       — focus entered the trigger (tooltip, popover)
- * - `'hover'`       — pointer entered the trigger (tooltip)
- * - `'keyboard'`    — keyboard shortcut or Enter/Space on a trigger
- * - `'programmatic'` — opened via the JS API without a user gesture
- * - `'trigger'`     — opened via the Invoker Commands API (`command="show-modal"`)
- */
-export type OverlayOpenReason = 'click' | 'focus' | 'hover' | 'keyboard' | 'programmatic' | 'trigger';
-/** Close reasons valid for modal dialogs (includes 'swipe' for drawer). */
-export type DialogCloseReason = 'escape' | 'outsideClick' | 'programmatic' | 'swipe' | 'trigger';
-/** Close reasons valid for dropdown overlays (no swipe). */
-export type DropdownCloseReason = Exclude<DialogCloseReason, 'swipe'>;
-/** Detail shape for overlay open events emitted by components. */
-export type OverlayOpenDetail = {
-    reason: OverlayOpenReason;
-};
-/** Detail shape for overlay close events emitted by components. */
-export type OverlayCloseDetail = {
-    reason: DialogCloseReason;
-};
-export type { OverlayPositioner };
-export type OverlayControlOptions = {
-    getBoundary: () => HTMLElement | null;
-    getPanel?: () => HTMLElement | null;
-    getTrigger?: () => HTMLElement | null;
-    isDisabled?: () => boolean;
-    isOpen: () => boolean;
-    onClose?: (reason: DialogCloseReason) => void;
-    onOpen?: (reason: OverlayOpenReason) => void;
-    positioner?: OverlayPositioner;
-    restoreFocus?: boolean | (() => boolean);
-    setOpen: (next: boolean, reason: OverlayOpenReason | DialogCloseReason) => void;
-    /** `AbortSignal` from the component lifecycle. `dispose()` is called automatically on abort. */
-    signal: AbortSignal;
-};
-export type OverlayControl = {
-    [Symbol.dispose](): void;
-    /**
-     * Closes the overlay.
-     * @param reason — why it's closing (default `'programmatic'`)
-     * @param restoreFocus — override per-call focus restoration (default: uses `restoreFocus` option)
-     */
-    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'`)
-     */
-    open(reason?: OverlayOpenReason): void;
-    /**
-     * Toggles open state.
-     * - Opens with `openReason` (default `'click'`).
-     * - Closes with `closeReason` (default `'trigger'`).
-     */
-    toggle(openReason?: OverlayOpenReason, closeReason?: DialogCloseReason): void;
-};
-export declare const createOverlayControl: (options: OverlayControlOptions) => OverlayControl;
-//# sourceMappingURL=overlay.d.ts.map

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

@@ -1 +0,0 @@
-{"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

@@ -1,32 +0,0 @@
-//#region src/headless/overlay.ts
-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
-	};
-};
-//#endregion
-export { e as createOverlayControl };
-
-//# sourceMappingURL=overlay.js.map

package/dist/headless/overlay.js.map

@@ -1 +0,0 @@
-{"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/paginated-list.cjs

@@ -1,2 +0,0 @@
-let e=require("@vielzeug/ripple");var t=t=>{let n=(0,e.signal)(0),r=()=>{let e=t.pageSize;return e===void 0?10:typeof e==`number`?e:e.value??10},i=(0,e.computed)(()=>Math.ceil(t.getItems().length/r())),a=(0,e.computed)(()=>i.value===0?-1:Math.min(n.value,i.value-1)),o=(0,e.computed)(()=>{let e=a.value,n=r(),i=e*n;return t.getItems().slice(i,i+n)});return{goTo:e=>{Number.isFinite(e)&&(n.value=Math.max(0,e))},hasNext:(0,e.computed)(()=>i.value>0&&a.value<i.value-1),hasPrev:(0,e.computed)(()=>a.value>0),next:()=>{i.value>0&&a.value<i.value-1&&(n.value=a.value+1)},pageCount:i,pageIndex:a,pageItems:o,prev:()=>{a.value>0&&(n.value=a.value-1)},reset:()=>{n.value=0}}};exports.createPaginatedList=t;
-//# sourceMappingURL=paginated-list.cjs.map

package/dist/headless/paginated-list.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"paginated-list.cjs","names":[],"sources":["../../src/headless/paginated-list.ts"],"sourcesContent":["import { computed, type Readable, signal } from '@vielzeug/ripple';\n\n// ── Types ─────────────────────────────────────────────────────────────────────\n\nexport type PaginatedListOptions<T> = {\n  /** All items to paginate. Can be a reactive signal accessor. */\n  getItems: () => T[];\n  /** Number of items per page. Defaults to 10. */\n  pageSize?: Readable<number> | number;\n};\n\nexport type PaginatedListHandle<T> = {\n  /** Navigate to an absolute page index (clamped). */\n  goTo(index: number): void;\n  /** Whether there is a next page. */\n  readonly hasNext: Readable<boolean>;\n  /** Whether there is a previous page. */\n  readonly hasPrev: Readable<boolean>;\n\n  /** Navigate to the next page. No-op on last page. */\n  next(): void;\n  /** Total number of pages. */\n  readonly pageCount: Readable<number>;\n  /** Current 0-based page index. */\n  readonly pageIndex: Readable<number>;\n  /** Items visible on the current page. */\n  readonly pageItems: Readable<T[]>;\n  /** Navigate to the previous page. No-op on first page. */\n  prev(): void;\n  /** Reset to the first page. */\n  reset(): void;\n};\n\n// ── Implementation ────────────────────────────────────────────────────────────\n\n/**\n * Reactive pagination state for a list of items.\n *\n * Decoupled from option rendering so it can be used with any sorted/filtered\n * item array (e.g., the `filteredOptions` signal in combobox).\n *\n * @example\n * ```ts\n * const paged = createPaginatedList({ getItems: () => allOptions.value, pageSize: 20 });\n * // render paged.pageItems.value\n * // navigation: paged.next(), paged.prev(), paged.goTo(0)\n * ```\n */\nexport const createPaginatedList = <T>(options: PaginatedListOptions<T>): PaginatedListHandle<T> => {\n  const pageIndex = signal(0);\n  const resolvedPageSize = (): number => {\n    const ps = options.pageSize;\n\n    if (ps === undefined) return 10;\n\n    return typeof ps === 'number' ? ps : (ps.value ?? 10);\n  };\n\n  const pageCount = computed(() => Math.ceil(options.getItems().length / resolvedPageSize()));\n\n  // Clamp page index when total page count shrinks (e.g. after filter change).\n  // When pageCount is 0 (empty list), safePage returns -1 to signal no valid page.\n  const safePage = computed(() => (pageCount.value === 0 ? -1 : Math.min(pageIndex.value, pageCount.value - 1)));\n\n  const pageItems = computed(() => {\n    const pg = safePage.value;\n    const size = resolvedPageSize();\n    const start = pg * size;\n\n    return options.getItems().slice(start, start + size);\n  });\n\n  const goTo = (index: number): void => {\n    // Lower-bound guard only — safePage handles the upper-bound clamp reactively\n    // so that any subsequent pageCount reduction is also handled automatically.\n    // Guard against NaN/Infinity (e.g. parseInt() failures) which Math.max propagates silently.\n    if (!Number.isFinite(index)) return;\n\n    pageIndex.value = Math.max(0, index);\n  };\n\n  const next = (): void => {\n    if (pageCount.value > 0 && safePage.value < pageCount.value - 1) pageIndex.value = safePage.value + 1;\n  };\n\n  const prev = (): void => {\n    if (safePage.value > 0) pageIndex.value = safePage.value - 1;\n  };\n\n  const reset = (): void => {\n    pageIndex.value = 0;\n  };\n\n  const hasNext = computed(() => pageCount.value > 0 && safePage.value < pageCount.value - 1);\n  const hasPrev = computed(() => safePage.value > 0);\n\n  return {\n    goTo,\n    hasNext,\n    hasPrev,\n    next,\n    pageCount,\n    pageIndex: safePage,\n    pageItems,\n    prev,\n    reset,\n  };\n};\n"],"mappings":"kCAgDA,IAAa,EAA0B,GAA6D,CAClG,IAAM,GAAA,EAAA,EAAA,OAAA,CAAmB,CAAC,EACpB,MAAiC,CACrC,IAAM,EAAK,EAAQ,SAInB,OAFI,IAAO,IAAA,GAAkB,GAEtB,OAAO,GAAO,SAAW,EAAM,EAAG,OAAS,EACpD,EAEM,GAAA,EAAA,EAAA,SAAA,KAA2B,KAAK,KAAK,EAAQ,SAAS,CAAC,CAAC,OAAS,EAAiB,CAAC,CAAC,EAIpF,GAAA,EAAA,EAAA,SAAA,KAA2B,EAAU,QAAU,EAAI,GAAK,KAAK,IAAI,EAAU,MAAO,EAAU,MAAQ,CAAC,CAAE,EAEvG,GAAA,EAAA,EAAA,SAAA,KAA2B,CAC/B,IAAM,EAAK,EAAS,MACd,EAAO,EAAiB,EACxB,EAAQ,EAAK,EAEnB,OAAO,EAAQ,SAAS,CAAC,CAAC,MAAM,EAAO,EAAQ,CAAI,CACrD,CAAC,EA0BD,MAAO,CACL,KAzBY,GAAwB,CAI/B,OAAO,SAAS,CAAK,IAE1B,EAAU,MAAQ,KAAK,IAAI,EAAG,CAAK,EACrC,EAmBE,SAAA,EAAA,EAAA,SAAA,KAL6B,EAAU,MAAQ,GAAK,EAAS,MAAQ,EAAU,MAAQ,CAKvF,EACA,SAAA,EAAA,EAAA,SAAA,KAL6B,EAAS,MAAQ,CAK9C,EACA,SAnBuB,CACnB,EAAU,MAAQ,GAAK,EAAS,MAAQ,EAAU,MAAQ,IAAG,EAAU,MAAQ,EAAS,MAAQ,EACtG,EAkBE,YACA,UAAW,EACX,YACA,SAnBuB,CACnB,EAAS,MAAQ,IAAG,EAAU,MAAQ,EAAS,MAAQ,EAC7D,EAkBE,UAhBwB,CACxB,EAAU,MAAQ,CACpB,CAeA,CACF"}

package/dist/headless/paginated-list.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"paginated-list.d.ts","sourceRoot":"","sources":["../../src/headless/paginated-list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,QAAQ,EAAU,MAAM,kBAAkB,CAAC;AAInE,MAAM,MAAM,oBAAoB,CAAC,CAAC,IAAI;IACpC,gEAAgE;IAChE,QAAQ,EAAE,MAAM,CAAC,EAAE,CAAC;IACpB,gDAAgD;IAChD,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC;CACtC,CAAC;AAEF,MAAM,MAAM,mBAAmB,CAAC,CAAC,IAAI;IACnC,oDAAoD;IACpD,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,oCAAoC;IACpC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;IACpC,wCAAwC;IACxC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;IAEpC,qDAAqD;IACrD,IAAI,IAAI,IAAI,CAAC;IACb,6BAA6B;IAC7B,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IACrC,kCAAkC;IAClC,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IACrC,yCAAyC;IACzC,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC;IAClC,0DAA0D;IAC1D,IAAI,IAAI,IAAI,CAAC;IACb,+BAA+B;IAC/B,KAAK,IAAI,IAAI,CAAC;CACf,CAAC;AAIF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,mBAAmB,GAAI,CAAC,EAAE,SAAS,oBAAoB,CAAC,CAAC,CAAC,KAAG,mBAAmB,CAAC,CAAC,CA2D9F,CAAC"}

package/dist/headless/paginated-list.js

@@ -1,34 +0,0 @@
-import { computed as e, signal as t } from "@vielzeug/ripple";
-//#region src/headless/paginated-list.ts
-var n = (n) => {
-	let r = t(0), i = () => {
-		let e = n.pageSize;
-		return e === void 0 ? 10 : typeof e == "number" ? e : e.value ?? 10;
-	}, a = e(() => Math.ceil(n.getItems().length / i())), o = e(() => a.value === 0 ? -1 : Math.min(r.value, a.value - 1)), s = e(() => {
-		let e = o.value, t = i(), r = e * t;
-		return n.getItems().slice(r, r + t);
-	});
-	return {
-		goTo: (e) => {
-			Number.isFinite(e) && (r.value = Math.max(0, e));
-		},
-		hasNext: e(() => a.value > 0 && o.value < a.value - 1),
-		hasPrev: e(() => o.value > 0),
-		next: () => {
-			a.value > 0 && o.value < a.value - 1 && (r.value = o.value + 1);
-		},
-		pageCount: a,
-		pageIndex: o,
-		pageItems: s,
-		prev: () => {
-			o.value > 0 && (r.value = o.value - 1);
-		},
-		reset: () => {
-			r.value = 0;
-		}
-	};
-};
-//#endregion
-export { n as createPaginatedList };
-
-//# sourceMappingURL=paginated-list.js.map

package/dist/headless/paginated-list.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"paginated-list.js","names":[],"sources":["../../src/headless/paginated-list.ts"],"sourcesContent":["import { computed, type Readable, signal } from '@vielzeug/ripple';\n\n// ── Types ─────────────────────────────────────────────────────────────────────\n\nexport type PaginatedListOptions<T> = {\n  /** All items to paginate. Can be a reactive signal accessor. */\n  getItems: () => T[];\n  /** Number of items per page. Defaults to 10. */\n  pageSize?: Readable<number> | number;\n};\n\nexport type PaginatedListHandle<T> = {\n  /** Navigate to an absolute page index (clamped). */\n  goTo(index: number): void;\n  /** Whether there is a next page. */\n  readonly hasNext: Readable<boolean>;\n  /** Whether there is a previous page. */\n  readonly hasPrev: Readable<boolean>;\n\n  /** Navigate to the next page. No-op on last page. */\n  next(): void;\n  /** Total number of pages. */\n  readonly pageCount: Readable<number>;\n  /** Current 0-based page index. */\n  readonly pageIndex: Readable<number>;\n  /** Items visible on the current page. */\n  readonly pageItems: Readable<T[]>;\n  /** Navigate to the previous page. No-op on first page. */\n  prev(): void;\n  /** Reset to the first page. */\n  reset(): void;\n};\n\n// ── Implementation ────────────────────────────────────────────────────────────\n\n/**\n * Reactive pagination state for a list of items.\n *\n * Decoupled from option rendering so it can be used with any sorted/filtered\n * item array (e.g., the `filteredOptions` signal in combobox).\n *\n * @example\n * ```ts\n * const paged = createPaginatedList({ getItems: () => allOptions.value, pageSize: 20 });\n * // render paged.pageItems.value\n * // navigation: paged.next(), paged.prev(), paged.goTo(0)\n * ```\n */\nexport const createPaginatedList = <T>(options: PaginatedListOptions<T>): PaginatedListHandle<T> => {\n  const pageIndex = signal(0);\n  const resolvedPageSize = (): number => {\n    const ps = options.pageSize;\n\n    if (ps === undefined) return 10;\n\n    return typeof ps === 'number' ? ps : (ps.value ?? 10);\n  };\n\n  const pageCount = computed(() => Math.ceil(options.getItems().length / resolvedPageSize()));\n\n  // Clamp page index when total page count shrinks (e.g. after filter change).\n  // When pageCount is 0 (empty list), safePage returns -1 to signal no valid page.\n  const safePage = computed(() => (pageCount.value === 0 ? -1 : Math.min(pageIndex.value, pageCount.value - 1)));\n\n  const pageItems = computed(() => {\n    const pg = safePage.value;\n    const size = resolvedPageSize();\n    const start = pg * size;\n\n    return options.getItems().slice(start, start + size);\n  });\n\n  const goTo = (index: number): void => {\n    // Lower-bound guard only — safePage handles the upper-bound clamp reactively\n    // so that any subsequent pageCount reduction is also handled automatically.\n    // Guard against NaN/Infinity (e.g. parseInt() failures) which Math.max propagates silently.\n    if (!Number.isFinite(index)) return;\n\n    pageIndex.value = Math.max(0, index);\n  };\n\n  const next = (): void => {\n    if (pageCount.value > 0 && safePage.value < pageCount.value - 1) pageIndex.value = safePage.value + 1;\n  };\n\n  const prev = (): void => {\n    if (safePage.value > 0) pageIndex.value = safePage.value - 1;\n  };\n\n  const reset = (): void => {\n    pageIndex.value = 0;\n  };\n\n  const hasNext = computed(() => pageCount.value > 0 && safePage.value < pageCount.value - 1);\n  const hasPrev = computed(() => safePage.value > 0);\n\n  return {\n    goTo,\n    hasNext,\n    hasPrev,\n    next,\n    pageCount,\n    pageIndex: safePage,\n    pageItems,\n    prev,\n    reset,\n  };\n};\n"],"mappings":";;AAgDA,IAAa,KAA0B,MAA6D;CAClG,IAAM,IAAY,EAAO,CAAC,GACpB,UAAiC;EACrC,IAAM,IAAK,EAAQ;EAInB,OAFI,MAAO,KAAA,IAAkB,KAEtB,OAAO,KAAO,WAAW,IAAM,EAAG,SAAS;CACpD,GAEM,IAAY,QAAe,KAAK,KAAK,EAAQ,SAAS,CAAC,CAAC,SAAS,EAAiB,CAAC,CAAC,GAIpF,IAAW,QAAgB,EAAU,UAAU,IAAI,KAAK,KAAK,IAAI,EAAU,OAAO,EAAU,QAAQ,CAAC,CAAE,GAEvG,IAAY,QAAe;EAC/B,IAAM,IAAK,EAAS,OACd,IAAO,EAAiB,GACxB,IAAQ,IAAK;EAEnB,OAAO,EAAQ,SAAS,CAAC,CAAC,MAAM,GAAO,IAAQ,CAAI;CACrD,CAAC;CA0BD,OAAO;EACL,OAzBY,MAAwB;GAI/B,OAAO,SAAS,CAAK,MAE1B,EAAU,QAAQ,KAAK,IAAI,GAAG,CAAK;EACrC;EAmBE,SALc,QAAe,EAAU,QAAQ,KAAK,EAAS,QAAQ,EAAU,QAAQ,CAKvF;EACA,SALc,QAAe,EAAS,QAAQ,CAK9C;EACA,YAnBuB;GACvB,AAAI,EAAU,QAAQ,KAAK,EAAS,QAAQ,EAAU,QAAQ,MAAG,EAAU,QAAQ,EAAS,QAAQ;EACtG;EAkBE;EACA,WAAW;EACX;EACA,YAnBuB;GACvB,AAAI,EAAS,QAAQ,MAAG,EAAU,QAAQ,EAAS,QAAQ;EAC7D;EAkBE,aAhBwB;GACxB,EAAU,QAAQ;EACpB;CAeA;AACF"}

package/dist/headless/parse.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"parse.cjs","names":[],"sources":["../../src/headless/parse.ts"],"sourcesContent":["// ── Trigger string parser ─────────────────────────────────────────────────────\n\n/**\n * Parses a comma-separated trigger string into a typed array, filtering against\n * a valid set and falling back to `defaults` when the input is empty or invalid.\n *\n * Used by tooltip and popover to normalise their `trigger` prop values.\n *\n * @example\n * ```ts\n * const VALID = new Set(['click', 'hover', 'focus'] as const);\n * parseStringTriggers('hover,focus', VALID, ['click']); // → ['hover', 'focus']\n * parseStringTriggers('',            VALID, ['click']); // → ['click']\n * ```\n */\nexport const parseStringTriggers = <T extends string>(\n  value: string | null | undefined,\n  valid: ReadonlySet<T>,\n  defaults: T[],\n): T[] => {\n  const parsed = String(value ?? '')\n    .split(',')\n    .map((t) => t.trim())\n    .filter((t): t is T => valid.has(t as T));\n\n  return parsed.length > 0 ? parsed : [...defaults];\n};\n"],"mappings":"AAeA,IAAa,GACX,EACA,EACA,IACQ,CACR,IAAM,EAAS,OAAO,GAAS,EAAE,CAAC,CAC/B,MAAM,GAAG,CAAC,CACV,IAAK,GAAM,EAAE,KAAK,CAAC,CAAC,CACpB,OAAQ,GAAc,EAAM,IAAI,CAAM,CAAC,EAE1C,OAAO,EAAO,OAAS,EAAI,EAAS,CAAC,GAAG,CAAQ,CAClD"}

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

@@ -1 +0,0 @@
-{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../src/headless/parse.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,mBAAmB,GAAI,CAAC,SAAS,MAAM,EAClD,OAAO,MAAM,GAAG,IAAI,GAAG,SAAS,EAChC,OAAO,WAAW,CAAC,CAAC,CAAC,EACrB,UAAU,CAAC,EAAE,KACZ,CAAC,EAOH,CAAC"}

package/dist/headless/parse.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"parse.js","names":[],"sources":["../../src/headless/parse.ts"],"sourcesContent":["// ── Trigger string parser ─────────────────────────────────────────────────────\n\n/**\n * Parses a comma-separated trigger string into a typed array, filtering against\n * a valid set and falling back to `defaults` when the input is empty or invalid.\n *\n * Used by tooltip and popover to normalise their `trigger` prop values.\n *\n * @example\n * ```ts\n * const VALID = new Set(['click', 'hover', 'focus'] as const);\n * parseStringTriggers('hover,focus', VALID, ['click']); // → ['hover', 'focus']\n * parseStringTriggers('',            VALID, ['click']); // → ['click']\n * ```\n */\nexport const parseStringTriggers = <T extends string>(\n  value: string | null | undefined,\n  valid: ReadonlySet<T>,\n  defaults: T[],\n): T[] => {\n  const parsed = String(value ?? '')\n    .split(',')\n    .map((t) => t.trim())\n    .filter((t): t is T => valid.has(t as T));\n\n  return parsed.length > 0 ? parsed : [...defaults];\n};\n"],"mappings":";AAeA,IAAa,KACX,GACA,GACA,MACQ;CACR,IAAM,IAAS,OAAO,KAAS,EAAE,CAAC,CAC/B,MAAM,GAAG,CAAC,CACV,KAAK,MAAM,EAAE,KAAK,CAAC,CAAC,CACpB,QAAQ,MAAc,EAAM,IAAI,CAAM,CAAC;CAE1C,OAAO,EAAO,SAAS,IAAI,IAAS,CAAC,GAAG,CAAQ;AAClD"}

package/dist/headless/positioner.cjs

@@ -1,2 +0,0 @@
-const e=require("./direction.cjs");let t=require("@vielzeug/orbit");var n=e=>e.endsWith(`-start`)?e.replace(`-start`,`-end`):e.endsWith(`-end`)?e.replace(`-end`,`-start`):e;function r({boundary:r,getDir:i,getFloating:a,getPlacement:o,getReference:s,matchWidth:c=!0,offsetPx:l=0,padding:u=6}){function d(){let t=o?.()??`bottom-start`;return(i?.()??e.elementDirection(s()))===`rtl`?n(t):t}function f(){let e=s(),n=a();if(!e||!n)return;let i=d(),o=(0,t.computePosition)(e,n,{boundary:r??(0,t.getClippingAncestorRect)(n),middleware:[...l?[(0,t.offset)(l)]:[],(0,t.flip)({padding:u}),(0,t.shift)({padding:u}),...c?[(0,t.size)({padding:u})]:[]],placement:i});n.style.left=`${o.x}px`,n.style.top=`${o.y}px`;let f=n.style.transition,p=n.style.transform;n.style.transition=`none`,n.style.transform=`none`;let m=n.getBoundingClientRect(),h=o.x-m.left,g=o.y-m.top;n.style.transition=f,n.style.transform=p,(h!==0||g!==0)&&(n.style.left=`${o.x+h}px`,n.style.top=`${o.y+g}px`),c&&(n.style.width=`${e.getBoundingClientRect().width}px`)}function p(){let e=s(),n=a();return!e||!n?()=>{}:(0,t.autoUpdate)(e,n,f)}return{floating:a,reference:s,startAutoUpdate:p,update:f}}exports.createDropdownPositioner=r;
-//# sourceMappingURL=positioner.cjs.map

package/dist/headless/positioner.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"positioner.cjs","names":[],"sources":["../../src/headless/positioner.ts"],"sourcesContent":["import {\n  autoUpdate,\n  computePosition,\n  flip,\n  getClippingAncestorRect,\n  offset,\n  type Placement,\n  type Rect,\n  shift,\n  size,\n} from '@vielzeug/orbit';\n\nimport { elementDirection } from './direction';\n\n// ── Overlay positioner contract ──────────────────────────────────────────────\n\nexport type OverlayPositioner = {\n  floating: () => HTMLElement | null;\n  reference: () => HTMLElement | null;\n  /** Start continuous position auto-updates. Returns a stop function. */\n  startAutoUpdate?: () => () => void;\n  update: () => void;\n};\n\n// ── Dropdown positioner ───────────────────────────────────────────────────────\n\nexport type DropdownPositionerOptions = {\n  /**\n   * Clipping boundary for flip/shift/size — the edges the dropdown must stay within.\n   * Defaults to the nearest ancestor that actually clips content (`overflow:\n   * hidden|auto|scroll|clip`, e.g. a dialog panel), auto-detected per update via\n   * `getClippingAncestorRect()`, intersected with the viewport. Without this, flip/shift only\n   * avoid the full page viewport — a dropdown can be \"in view\" by that measure while still\n   * visibly overhanging a much smaller container it's actually nested in. Pass an explicit\n   * boundary to override auto-detection.\n   */\n  boundary?: Element | Rect;\n  /**\n   * Returns the text direction used for placement mirroring. Defaults to the resolved\n   * direction of the reference element (nearest `dir=\"ltr\"|\"rtl\"` ancestor, falling back to\n   * computed style) — most callers never need to pass this explicitly.\n   */\n  getDir?: () => 'ltr' | 'rtl';\n  /** Getter for the floating (dropdown panel) element. */\n  getFloating: () => HTMLElement | null;\n  /** Getter for the current placement. Defaults to 'bottom-start' (RTL-aware: flips to 'bottom-end'). */\n  getPlacement?: () => Placement;\n  /** Getter for the reference (trigger) element. */\n  getReference: () => HTMLElement | null;\n  /** Whether to match the floating element width to the reference. Default: true */\n  matchWidth?: boolean;\n  /** Additional offset in pixels between reference and floating element. Default: 0 */\n  offsetPx?: number;\n  /** Padding (px) used by flip, shift, and size middleware. Default: 6 */\n  padding?: number;\n};\n\n/** Mirrors a start/end placement for RTL layouts. */\nconst rtlPlacement = (p: Placement): Placement => {\n  if (p.endsWith('-start')) return p.replace('-start', '-end') as Placement;\n\n  if (p.endsWith('-end')) return p.replace('-end', '-start') as Placement;\n\n  return p;\n};\n\n/**\n * Creates an Orbit-powered positioner for dropdown overlays (select, combobox, menu).\n *\n * Uses flip + shift + optional width-matching middleware. Supports continuous\n * auto-update for repositioning on scroll or resize.\n *\n * RTL-aware: start/end placements are automatically mirrored so dropdowns open on the\n * correct side, based on `getDir` (or the reference element's resolved direction when\n * `getDir` is omitted).\n */\nexport function createDropdownPositioner({\n  boundary,\n  getDir,\n  getFloating,\n  getPlacement,\n  getReference,\n  matchWidth = true,\n  offsetPx = 0,\n  padding = 6,\n}: DropdownPositionerOptions): OverlayPositioner {\n  function resolvedPlacement(): Placement {\n    const base = getPlacement?.() ?? 'bottom-start';\n    const dir = getDir?.() ?? elementDirection(getReference());\n\n    return dir === 'rtl' ? rtlPlacement(base) : base;\n  }\n\n  function updatePosition(): void {\n    const ref = getReference();\n    const floating = getFloating();\n\n    if (!ref || !floating) return;\n\n    const placement = resolvedPlacement();\n    // Defaults to `undefined` (meaning \"auto-detect\"), not the detected value itself —\n    // re-running the detection on every update (rather than once, at positioner-creation time)\n    // matters because the dialog/scroll-container an instance is rendered into can change\n    // across opens (e.g. the same `<ore-select>` reused in different dialogs), and the detected\n    // ancestor's own rect can change between opens even when it's the same element (a resized\n    // dialog).\n    const resolvedBoundary = boundary ?? getClippingAncestorRect(floating);\n\n    const result = computePosition(ref, floating, {\n      boundary: resolvedBoundary,\n      middleware: [\n        ...(offsetPx ? [offset(offsetPx)] : []),\n        flip({ padding }),\n        shift({ padding }),\n        ...(matchWidth ? [size({ padding })] : []),\n      ],\n      placement,\n    });\n\n    floating.style.left = `${result.x}px`;\n    floating.style.top = `${result.y}px`;\n\n    // `computePosition()` assumes `left`/`top` resolve relative to the viewport (correct for\n    // `position: fixed`) — true almost always, but not when some ancestor establishes a\n    // containing block for fixed descendants (a non-`none` `transform`, even a visually-identity\n    // one left over from an entrance transition that never resets to `none` at rest is a real,\n    // easy-to-hit case — a modal dialog's panel, say). Analytically detecting *that* ancestor via\n    // `getContainingBlock()` and pre-subtracting its rect turned out to be unreliable in\n    // practice: browsers don't apply the \"ancestor transform traps fixed descendants\" rule\n    // uniformly across every element nested under it in every case we tested — some floating\n    // elements in the exact same subtree needed the correction and some didn't, for reasons we\n    // couldn't fully pin down. Measuring what actually happened after writing `left`/`top`\n    // and correcting only the observed gap sidesteps that: it's a no-op when the browser already\n    // put the element where asked, and it fixes the same class of bug the moment there's a real\n    // mismatch, regardless of which specific ancestor (if any) turns out to be responsible.\n    //\n    // The measurement itself must not be fooled by the floating element's *own* transform,\n    // though: dropdowns/popovers here all use a `transform: translateY(...)` entrance transition\n    // driven by a `[data-open]` attribute + `@starting-style` — right at open, before the\n    // transition has visibly progressed, `getBoundingClientRect()` can still reflect that\n    // starting offset (a handful of px, matching `--overlay-enter-translate-y`), which this\n    // correction would otherwise misread as a permanent ancestor-driven mismatch and bake in\n    // forever. Temporarily neutralizing the floating element's own transform for the measurement\n    // (and restoring it before anything paints, so there's no visible flash) isolates the\n    // correction to ancestor-driven offsets only, which is the only thing it's meant to fix.\n    const prevTransition = floating.style.transition;\n    const prevTransform = floating.style.transform;\n\n    floating.style.transition = 'none';\n    floating.style.transform = 'none';\n\n    const actual = floating.getBoundingClientRect();\n    const deltaX = result.x - actual.left;\n    const deltaY = result.y - actual.top;\n\n    floating.style.transition = prevTransition;\n    floating.style.transform = prevTransform;\n\n    if (deltaX !== 0 || deltaY !== 0) {\n      floating.style.left = `${result.x + deltaX}px`;\n      floating.style.top = `${result.y + deltaY}px`;\n    }\n\n    if (matchWidth) {\n      floating.style.width = `${ref.getBoundingClientRect().width}px`;\n    }\n  }\n\n  function startAutoUpdate(): () => void {\n    const ref = getReference();\n    const floating = getFloating();\n\n    if (!ref || !floating) return () => {};\n\n    return autoUpdate(ref, floating, updatePosition);\n  }\n\n  return { floating: getFloating, reference: getReference, startAutoUpdate, update: updatePosition };\n}\n"],"mappings":"oEA0DA,IAAM,EAAgB,GAChB,EAAE,SAAS,QAAQ,EAAU,EAAE,QAAQ,SAAU,MAAM,EAEvD,EAAE,SAAS,MAAM,EAAU,EAAE,QAAQ,OAAQ,QAAQ,EAElD,EAaT,SAAgB,EAAyB,CACvC,WACA,SACA,cACA,eACA,eACA,aAAa,GACb,WAAW,EACX,UAAU,GACqC,CAC/C,SAAS,GAA+B,CACtC,IAAM,EAAO,IAAe,GAAK,eAGjC,OAFY,IAAS,GAAK,EAAA,iBAAiB,EAAa,CAAC,KAE1C,MAAQ,EAAa,CAAI,EAAI,CAC9C,CAEA,SAAS,GAAuB,CAC9B,IAAM,EAAM,EAAa,EACnB,EAAW,EAAY,EAE7B,GAAI,CAAC,GAAO,CAAC,EAAU,OAEvB,IAAM,EAAY,EAAkB,EAS9B,GAAA,EAAA,EAAA,gBAAA,CAAyB,EAAK,EAAU,CAC5C,SAHuB,IAAA,EAAA,EAAA,wBAAA,CAAoC,CAAQ,EAInE,WAAY,CACV,GAAI,EAAW,EAAA,EAAA,EAAA,OAAA,CAAQ,CAAQ,CAAC,EAAI,CAAC,aAChC,CAAE,SAAQ,CAAC,cACV,CAAE,SAAQ,CAAC,EACjB,GAAI,EAAa,EAAA,EAAA,EAAA,KAAA,CAAM,CAAE,SAAQ,CAAC,CAAC,EAAI,CAAC,CAC1C,EACA,WACF,CAAC,EAED,EAAS,MAAM,KAAO,GAAG,EAAO,EAAE,IAClC,EAAS,MAAM,IAAM,GAAG,EAAO,EAAE,IAyBjC,IAAM,EAAiB,EAAS,MAAM,WAChC,EAAgB,EAAS,MAAM,UAErC,EAAS,MAAM,WAAa,OAC5B,EAAS,MAAM,UAAY,OAE3B,IAAM,EAAS,EAAS,sBAAsB,EACxC,EAAS,EAAO,EAAI,EAAO,KAC3B,EAAS,EAAO,EAAI,EAAO,IAEjC,EAAS,MAAM,WAAa,EAC5B,EAAS,MAAM,UAAY,GAEvB,IAAW,GAAK,IAAW,KAC7B,EAAS,MAAM,KAAO,GAAG,EAAO,EAAI,EAAO,IAC3C,EAAS,MAAM,IAAM,GAAG,EAAO,EAAI,EAAO,KAGxC,IACF,EAAS,MAAM,MAAQ,GAAG,EAAI,sBAAsB,CAAC,CAAC,MAAM,IAEhE,CAEA,SAAS,GAA8B,CACrC,IAAM,EAAM,EAAa,EACnB,EAAW,EAAY,EAI7B,MAFI,CAAC,GAAO,CAAC,MAAuB,CAAC,GAErC,EAAA,EAAA,WAAA,CAAkB,EAAK,EAAU,CAAc,CACjD,CAEA,MAAO,CAAE,SAAU,EAAa,UAAW,EAAc,kBAAiB,OAAQ,CAAe,CACnG"}

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

@@ -1 +0,0 @@
-{"version":3,"file":"positioner.d.ts","sourceRoot":"","sources":["../../src/headless/positioner.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,SAAS,EACd,KAAK,IAAI,EAGV,MAAM,iBAAiB,CAAC;AAMzB,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,EAAE,MAAM,WAAW,GAAG,IAAI,CAAC;IACnC,SAAS,EAAE,MAAM,WAAW,GAAG,IAAI,CAAC;IACpC,uEAAuE;IACvE,eAAe,CAAC,EAAE,MAAM,MAAM,IAAI,CAAC;IACnC,MAAM,EAAE,MAAM,IAAI,CAAC;CACpB,CAAC;AAIF,MAAM,MAAM,yBAAyB,GAAG;IACtC;;;;;;;;OAQG;IACH,QAAQ,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC1B;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,KAAK,GAAG,KAAK,CAAC;IAC7B,wDAAwD;IACxD,WAAW,EAAE,MAAM,WAAW,GAAG,IAAI,CAAC;IACtC,uGAAuG;IACvG,YAAY,CAAC,EAAE,MAAM,SAAS,CAAC;IAC/B,kDAAkD;IAClD,YAAY,EAAE,MAAM,WAAW,GAAG,IAAI,CAAC;IACvC,kFAAkF;IAClF,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,qFAAqF;IACrF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wEAAwE;IACxE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAWF;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CAAC,EACvC,QAAQ,EACR,MAAM,EACN,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,UAAiB,EACjB,QAAY,EACZ,OAAW,GACZ,EAAE,yBAAyB,GAAG,iBAAiB,CA6F/C"}

package/dist/headless/positioner.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"positioner.js","names":[],"sources":["../../src/headless/positioner.ts"],"sourcesContent":["import {\n  autoUpdate,\n  computePosition,\n  flip,\n  getClippingAncestorRect,\n  offset,\n  type Placement,\n  type Rect,\n  shift,\n  size,\n} from '@vielzeug/orbit';\n\nimport { elementDirection } from './direction';\n\n// ── Overlay positioner contract ──────────────────────────────────────────────\n\nexport type OverlayPositioner = {\n  floating: () => HTMLElement | null;\n  reference: () => HTMLElement | null;\n  /** Start continuous position auto-updates. Returns a stop function. */\n  startAutoUpdate?: () => () => void;\n  update: () => void;\n};\n\n// ── Dropdown positioner ───────────────────────────────────────────────────────\n\nexport type DropdownPositionerOptions = {\n  /**\n   * Clipping boundary for flip/shift/size — the edges the dropdown must stay within.\n   * Defaults to the nearest ancestor that actually clips content (`overflow:\n   * hidden|auto|scroll|clip`, e.g. a dialog panel), auto-detected per update via\n   * `getClippingAncestorRect()`, intersected with the viewport. Without this, flip/shift only\n   * avoid the full page viewport — a dropdown can be \"in view\" by that measure while still\n   * visibly overhanging a much smaller container it's actually nested in. Pass an explicit\n   * boundary to override auto-detection.\n   */\n  boundary?: Element | Rect;\n  /**\n   * Returns the text direction used for placement mirroring. Defaults to the resolved\n   * direction of the reference element (nearest `dir=\"ltr\"|\"rtl\"` ancestor, falling back to\n   * computed style) — most callers never need to pass this explicitly.\n   */\n  getDir?: () => 'ltr' | 'rtl';\n  /** Getter for the floating (dropdown panel) element. */\n  getFloating: () => HTMLElement | null;\n  /** Getter for the current placement. Defaults to 'bottom-start' (RTL-aware: flips to 'bottom-end'). */\n  getPlacement?: () => Placement;\n  /** Getter for the reference (trigger) element. */\n  getReference: () => HTMLElement | null;\n  /** Whether to match the floating element width to the reference. Default: true */\n  matchWidth?: boolean;\n  /** Additional offset in pixels between reference and floating element. Default: 0 */\n  offsetPx?: number;\n  /** Padding (px) used by flip, shift, and size middleware. Default: 6 */\n  padding?: number;\n};\n\n/** Mirrors a start/end placement for RTL layouts. */\nconst rtlPlacement = (p: Placement): Placement => {\n  if (p.endsWith('-start')) return p.replace('-start', '-end') as Placement;\n\n  if (p.endsWith('-end')) return p.replace('-end', '-start') as Placement;\n\n  return p;\n};\n\n/**\n * Creates an Orbit-powered positioner for dropdown overlays (select, combobox, menu).\n *\n * Uses flip + shift + optional width-matching middleware. Supports continuous\n * auto-update for repositioning on scroll or resize.\n *\n * RTL-aware: start/end placements are automatically mirrored so dropdowns open on the\n * correct side, based on `getDir` (or the reference element's resolved direction when\n * `getDir` is omitted).\n */\nexport function createDropdownPositioner({\n  boundary,\n  getDir,\n  getFloating,\n  getPlacement,\n  getReference,\n  matchWidth = true,\n  offsetPx = 0,\n  padding = 6,\n}: DropdownPositionerOptions): OverlayPositioner {\n  function resolvedPlacement(): Placement {\n    const base = getPlacement?.() ?? 'bottom-start';\n    const dir = getDir?.() ?? elementDirection(getReference());\n\n    return dir === 'rtl' ? rtlPlacement(base) : base;\n  }\n\n  function updatePosition(): void {\n    const ref = getReference();\n    const floating = getFloating();\n\n    if (!ref || !floating) return;\n\n    const placement = resolvedPlacement();\n    // Defaults to `undefined` (meaning \"auto-detect\"), not the detected value itself —\n    // re-running the detection on every update (rather than once, at positioner-creation time)\n    // matters because the dialog/scroll-container an instance is rendered into can change\n    // across opens (e.g. the same `<ore-select>` reused in different dialogs), and the detected\n    // ancestor's own rect can change between opens even when it's the same element (a resized\n    // dialog).\n    const resolvedBoundary = boundary ?? getClippingAncestorRect(floating);\n\n    const result = computePosition(ref, floating, {\n      boundary: resolvedBoundary,\n      middleware: [\n        ...(offsetPx ? [offset(offsetPx)] : []),\n        flip({ padding }),\n        shift({ padding }),\n        ...(matchWidth ? [size({ padding })] : []),\n      ],\n      placement,\n    });\n\n    floating.style.left = `${result.x}px`;\n    floating.style.top = `${result.y}px`;\n\n    // `computePosition()` assumes `left`/`top` resolve relative to the viewport (correct for\n    // `position: fixed`) — true almost always, but not when some ancestor establishes a\n    // containing block for fixed descendants (a non-`none` `transform`, even a visually-identity\n    // one left over from an entrance transition that never resets to `none` at rest is a real,\n    // easy-to-hit case — a modal dialog's panel, say). Analytically detecting *that* ancestor via\n    // `getContainingBlock()` and pre-subtracting its rect turned out to be unreliable in\n    // practice: browsers don't apply the \"ancestor transform traps fixed descendants\" rule\n    // uniformly across every element nested under it in every case we tested — some floating\n    // elements in the exact same subtree needed the correction and some didn't, for reasons we\n    // couldn't fully pin down. Measuring what actually happened after writing `left`/`top`\n    // and correcting only the observed gap sidesteps that: it's a no-op when the browser already\n    // put the element where asked, and it fixes the same class of bug the moment there's a real\n    // mismatch, regardless of which specific ancestor (if any) turns out to be responsible.\n    //\n    // The measurement itself must not be fooled by the floating element's *own* transform,\n    // though: dropdowns/popovers here all use a `transform: translateY(...)` entrance transition\n    // driven by a `[data-open]` attribute + `@starting-style` — right at open, before the\n    // transition has visibly progressed, `getBoundingClientRect()` can still reflect that\n    // starting offset (a handful of px, matching `--overlay-enter-translate-y`), which this\n    // correction would otherwise misread as a permanent ancestor-driven mismatch and bake in\n    // forever. Temporarily neutralizing the floating element's own transform for the measurement\n    // (and restoring it before anything paints, so there's no visible flash) isolates the\n    // correction to ancestor-driven offsets only, which is the only thing it's meant to fix.\n    const prevTransition = floating.style.transition;\n    const prevTransform = floating.style.transform;\n\n    floating.style.transition = 'none';\n    floating.style.transform = 'none';\n\n    const actual = floating.getBoundingClientRect();\n    const deltaX = result.x - actual.left;\n    const deltaY = result.y - actual.top;\n\n    floating.style.transition = prevTransition;\n    floating.style.transform = prevTransform;\n\n    if (deltaX !== 0 || deltaY !== 0) {\n      floating.style.left = `${result.x + deltaX}px`;\n      floating.style.top = `${result.y + deltaY}px`;\n    }\n\n    if (matchWidth) {\n      floating.style.width = `${ref.getBoundingClientRect().width}px`;\n    }\n  }\n\n  function startAutoUpdate(): () => void {\n    const ref = getReference();\n    const floating = getFloating();\n\n    if (!ref || !floating) return () => {};\n\n    return autoUpdate(ref, floating, updatePosition);\n  }\n\n  return { floating: getFloating, reference: getReference, startAutoUpdate, update: updatePosition };\n}\n"],"mappings":";;;AA0DA,IAAM,KAAgB,MAChB,EAAE,SAAS,QAAQ,IAAU,EAAE,QAAQ,UAAU,MAAM,IAEvD,EAAE,SAAS,MAAM,IAAU,EAAE,QAAQ,QAAQ,QAAQ,IAElD;AAaT,SAAgB,EAAyB,EACvC,aACA,WACA,gBACA,iBACA,iBACA,gBAAa,IACb,cAAW,GACX,aAAU,KACqC;CAC/C,SAAS,IAA+B;EACtC,IAAM,IAAO,IAAe,KAAK;EAGjC,QAFY,IAAS,KAAK,EAAiB,EAAa,CAAC,OAE1C,QAAQ,EAAa,CAAI,IAAI;CAC9C;CAEA,SAAS,IAAuB;EAC9B,IAAM,IAAM,EAAa,GACnB,IAAW,EAAY;EAE7B,IAAI,CAAC,KAAO,CAAC,GAAU;EAEvB,IAAM,IAAY,EAAkB,GAS9B,IAAS,EAAgB,GAAK,GAAU;GAC5C,UAHuB,KAAY,EAAwB,CAAQ;GAInE,YAAY;IACV,GAAI,IAAW,CAAC,EAAO,CAAQ,CAAC,IAAI,CAAC;IACrC,EAAK,EAAE,WAAQ,CAAC;IAChB,EAAM,EAAE,WAAQ,CAAC;IACjB,GAAI,IAAa,CAAC,EAAK,EAAE,WAAQ,CAAC,CAAC,IAAI,CAAC;GAC1C;GACA;EACF,CAAC;EAGD,AADA,EAAS,MAAM,OAAO,GAAG,EAAO,EAAE,KAClC,EAAS,MAAM,MAAM,GAAG,EAAO,EAAE;EAyBjC,IAAM,IAAiB,EAAS,MAAM,YAChC,IAAgB,EAAS,MAAM;EAGrC,AADA,EAAS,MAAM,aAAa,QAC5B,EAAS,MAAM,YAAY;EAE3B,IAAM,IAAS,EAAS,sBAAsB,GACxC,IAAS,EAAO,IAAI,EAAO,MAC3B,IAAS,EAAO,IAAI,EAAO;EAUjC,AARA,EAAS,MAAM,aAAa,GAC5B,EAAS,MAAM,YAAY,IAEvB,MAAW,KAAK,MAAW,OAC7B,EAAS,MAAM,OAAO,GAAG,EAAO,IAAI,EAAO,KAC3C,EAAS,MAAM,MAAM,GAAG,EAAO,IAAI,EAAO,MAGxC,MACF,EAAS,MAAM,QAAQ,GAAG,EAAI,sBAAsB,CAAC,CAAC,MAAM;CAEhE;CAEA,SAAS,IAA8B;EACrC,IAAM,IAAM,EAAa,GACnB,IAAW,EAAY;EAI7B,OAFI,CAAC,KAAO,CAAC,UAAuB,CAAC,IAE9B,EAAW,GAAK,GAAU,CAAc;CACjD;CAEA,OAAO;EAAE,UAAU;EAAa,WAAW;EAAc;EAAiB,QAAQ;CAAe;AACnG"}

package/dist/headless/ref-callback.cjs

@@ -1,2 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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.map

@@ -1 +0,0 @@
-{"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.map

@@ -1 +0,0 @@
-{"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/selection-control.cjs

@@ -1,2 +0,0 @@
-let e=require("@vielzeug/ripple");var t=t=>{let n=(0,e.signal)(new Set),r=e=>n.value.has(e),i=()=>{let e=t.pageItems();return e.length?e.every(e=>n.value.has(t.getRowKey(e))):!1},a=e=>{n.value=e,t.onSelectionChange?.(e)};return{clearSelection:()=>{a(new Set)},isAllSelected:i,isSelected:r,selectAll:()=>{if(t.selectionMode()!==`multi`)return;let e=t.pageItems();if(i()){let r=new Set(n.value);for(let n of e)r.delete(t.getRowKey(n));a(r)}else{let r=new Set(n.value);for(let n of e)r.add(t.getRowKey(n));a(r)}},selectedKeys:(0,e.computed)(()=>new Set(n.value)),setSelection:e=>{a(new Set(e))},toggleRow:e=>{let r=t.selectionMode();if(r===`none`)return;let i=new Set(n.value);i.has(e)?i.delete(e):(r===`single`&&i.clear(),i.add(e)),a(i)}}};exports.createSelectionControl=t;
-//# sourceMappingURL=selection-control.cjs.map

package/dist/headless/selection-control.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"selection-control.cjs","names":[],"sources":["../../src/headless/selection-control.ts"],"sourcesContent":["import { computed, type Readable, signal } from '@vielzeug/ripple';\n\nimport type { SelectionMode } from './datagrid';\n\n// ── Selection control ─────────────────────────────────────────────────────────\n\nexport type SelectionControlOptions<T> = {\n  /** Returns a unique string key for each row item. */\n  getRowKey: (item: T) => string;\n  /** Called when selection changes. Receives the full set of selected keys. */\n  onSelectionChange?: (keys: Set<string>) => void;\n  /** Returns the current page items reactively. */\n  pageItems: () => T[];\n  /** Returns the current selection mode reactively. */\n  selectionMode: () => SelectionMode;\n};\n\nexport type SelectionControl = {\n  /** Deselect all rows. */\n  clearSelection(): void;\n  /** Whether all current-page rows are selected. */\n  isAllSelected(): boolean;\n  /** Whether a given row key is selected. */\n  isSelected(key: string): boolean;\n  /** Select (or deselect if already all selected) all rows on the current page. */\n  selectAll(): void;\n  /** Current selected row keys. Reactive signal. Returns a snapshot copy. */\n  readonly selectedKeys: Readable<ReadonlySet<string>>;\n  /** Set the selection to an explicit set of keys. */\n  setSelection(keys: Set<string>): void;\n  /** Toggle selection for a single row. */\n  toggleRow(key: string): void;\n};\n\nexport const createSelectionControl = <T>(options: SelectionControlOptions<T>): SelectionControl => {\n  const _selectedKeys = signal<Set<string>>(new Set());\n\n  const isSelected = (key: string): boolean => _selectedKeys.value.has(key);\n\n  const isAllSelected = (): boolean => {\n    const page = options.pageItems();\n\n    if (!page.length) return false;\n\n    return page.every((item) => _selectedKeys.value.has(options.getRowKey(item)));\n  };\n\n  const _commitSelection = (next: Set<string>): void => {\n    _selectedKeys.value = next;\n    options.onSelectionChange?.(next);\n  };\n\n  const toggleRow = (key: string): void => {\n    const mode = options.selectionMode();\n\n    if (mode === 'none') return;\n\n    const next = new Set(_selectedKeys.value);\n\n    if (next.has(key)) {\n      next.delete(key);\n    } else if (mode === 'single') {\n      next.clear();\n      next.add(key);\n    } else {\n      next.add(key);\n    }\n\n    _commitSelection(next);\n  };\n\n  const selectAll = (): void => {\n    if (options.selectionMode() !== 'multi') return;\n\n    const page = options.pageItems();\n\n    if (isAllSelected()) {\n      const next = new Set(_selectedKeys.value);\n\n      for (const item of page) next.delete(options.getRowKey(item));\n\n      _commitSelection(next);\n    } else {\n      const next = new Set(_selectedKeys.value);\n\n      for (const item of page) next.add(options.getRowKey(item));\n\n      _commitSelection(next);\n    }\n  };\n\n  const clearSelection = (): void => {\n    _commitSelection(new Set());\n  };\n\n  const setSelection = (keys: Set<string>): void => {\n    _commitSelection(new Set(keys));\n  };\n\n  return {\n    clearSelection,\n    isAllSelected,\n    isSelected,\n    selectAll,\n    selectedKeys: computed(() => new Set(_selectedKeys.value)),\n    setSelection,\n    toggleRow,\n  };\n};\n"],"mappings":"kCAkCA,IAAa,EAA6B,GAA0D,CAClG,IAAM,GAAA,EAAA,EAAA,OAAA,CAAoC,IAAI,GAAK,EAE7C,EAAc,GAAyB,EAAc,MAAM,IAAI,CAAG,EAElE,MAA+B,CACnC,IAAM,EAAO,EAAQ,UAAU,EAI/B,OAFK,EAAK,OAEH,EAAK,MAAO,GAAS,EAAc,MAAM,IAAI,EAAQ,UAAU,CAAI,CAAC,CAAC,EAFnD,EAG3B,EAEM,EAAoB,GAA4B,CACpD,EAAc,MAAQ,EACtB,EAAQ,oBAAoB,CAAI,CAClC,EAiDA,MAAO,CACL,mBATiC,CACjC,EAAiB,IAAI,GAAK,CAC5B,EAQE,gBACA,aACA,cAhC4B,CAC5B,GAAI,EAAQ,cAAc,IAAM,QAAS,OAEzC,IAAM,EAAO,EAAQ,UAAU,EAE/B,GAAI,EAAc,EAAG,CACnB,IAAM,EAAO,IAAI,IAAI,EAAc,KAAK,EAExC,IAAK,IAAM,KAAQ,EAAM,EAAK,OAAO,EAAQ,UAAU,CAAI,CAAC,EAE5D,EAAiB,CAAI,CACvB,KAAO,CACL,IAAM,EAAO,IAAI,IAAI,EAAc,KAAK,EAExC,IAAK,IAAM,KAAQ,EAAM,EAAK,IAAI,EAAQ,UAAU,CAAI,CAAC,EAEzD,EAAiB,CAAI,CACvB,CACF,EAeE,cAAA,EAAA,EAAA,SAAA,KAA6B,IAAI,IAAI,EAAc,KAAK,CAAC,EACzD,aAVoB,GAA4B,CAChD,EAAiB,IAAI,IAAI,CAAI,CAAC,CAChC,EASE,UAtDiB,GAAsB,CACvC,IAAM,EAAO,EAAQ,cAAc,EAEnC,GAAI,IAAS,OAAQ,OAErB,IAAM,EAAO,IAAI,IAAI,EAAc,KAAK,EAEpC,EAAK,IAAI,CAAG,EACd,EAAK,OAAO,CAAG,GACN,IAAS,UAClB,EAAK,MAAM,EAGX,EAAK,IAAI,CAAG,GAGd,EAAiB,CAAI,CACvB,CAsCA,CACF"}

package/dist/headless/selection-control.d.ts

@@ -1,30 +0,0 @@
-import { type Readable } from '@vielzeug/ripple';
-import type { SelectionMode } from './datagrid';
-export type SelectionControlOptions<T> = {
-    /** Returns a unique string key for each row item. */
-    getRowKey: (item: T) => string;
-    /** Called when selection changes. Receives the full set of selected keys. */
-    onSelectionChange?: (keys: Set<string>) => void;
-    /** Returns the current page items reactively. */
-    pageItems: () => T[];
-    /** Returns the current selection mode reactively. */
-    selectionMode: () => SelectionMode;
-};
-export type SelectionControl = {
-    /** Deselect all rows. */
-    clearSelection(): void;
-    /** Whether all current-page rows are selected. */
-    isAllSelected(): boolean;
-    /** Whether a given row key is selected. */
-    isSelected(key: string): boolean;
-    /** Select (or deselect if already all selected) all rows on the current page. */
-    selectAll(): void;
-    /** Current selected row keys. Reactive signal. Returns a snapshot copy. */
-    readonly selectedKeys: Readable<ReadonlySet<string>>;
-    /** Set the selection to an explicit set of keys. */
-    setSelection(keys: Set<string>): void;
-    /** Toggle selection for a single row. */
-    toggleRow(key: string): void;
-};
-export declare const createSelectionControl: <T>(options: SelectionControlOptions<T>) => SelectionControl;
-//# sourceMappingURL=selection-control.d.ts.map