@vielzeug/refine 1.1.1

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

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

@@ -0,0 +1,2 @@
+var e=e=>{let t=new AbortController;return e(()=>t.abort()),t.signal};exports.lifecycleSignal=e;
+//# sourceMappingURL=ore.cjs.map

package/dist/headless/ore.cjs.map

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

@@ -0,0 +1,20 @@
+/**
+ * Creates an `AbortSignal` tied to the component's Ore lifecycle.
+ *
+ * Call once at the top of a `setup()` function and pass the resulting signal
+ * as the required `signal` option to any stateful headless primitive
+ * (`createTextField`, `createCheckable`, `createOptionList`, etc.).
+ *
+ * When Ore disconnects the component, `onCleanup` fires, aborting the
+ * signal and triggering cleanup in every primitive that received it.
+ *
+ * @example
+ * ```ts
+ * setup(props, { el }) {
+ *   const signal = lifecycleSignal(onCleanup);
+ *   const tf = createTextField({ ..., signal });
+ * }
+ * ```
+ */
+export declare const lifecycleSignal: (onCleanup: (fn: () => void) => void) => AbortSignal;
+//# sourceMappingURL=ore.d.ts.map

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

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

@@ -0,0 +1,9 @@
+//#region src/headless/ore.ts
+var e = (e) => {
+	let t = new AbortController();
+	return e(() => t.abort()), t.signal;
+};
+//#endregion
+export { e as lifecycleSignal };
+
+//# sourceMappingURL=ore.js.map

package/dist/headless/ore.js.map

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

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

package/dist/headless/overlay.cjs.map

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

package/dist/headless/overlay.d.ts

@@ -0,0 +1,62 @@
+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;
+    /**
+     * 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

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

package/dist/headless/overlay.js

@@ -0,0 +1,29 @@
+//#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 = () => {
+		e.isOpen() && o("programmatic", !1, !0), i(!1), t &&= (t(), null);
+	};
+	return e.signal.addEventListener("abort", c, { once: !0 }), {
+		close: o,
+		dispose: c,
+		open: a,
+		[Symbol.dispose]: c,
+		toggle: s
+	};
+};
+//#endregion
+export { e as createOverlayControl };
+
+//# sourceMappingURL=overlay.js.map

package/dist/headless/overlay.js.map

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

package/dist/headless/paginated-list.cjs

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

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

@@ -0,0 +1,42 @@
+import { type Readable } from '@vielzeug/ripple';
+export type PaginatedListOptions<T> = {
+    /** All items to paginate. Can be a reactive signal accessor. */
+    getItems: () => T[];
+    /** Number of items per page. Defaults to 10. */
+    pageSize?: Readable<number> | number;
+};
+export type PaginatedListHandle<T> = {
+    /** Navigate to an absolute page index (clamped). */
+    goTo(index: number): void;
+    /** Whether there is a next page. */
+    readonly hasNext: Readable<boolean>;
+    /** Whether there is a previous page. */
+    readonly hasPrev: Readable<boolean>;
+    /** Navigate to the next page. No-op on last page. */
+    next(): void;
+    /** Total number of pages. */
+    readonly pageCount: Readable<number>;
+    /** Current 0-based page index. */
+    readonly pageIndex: Readable<number>;
+    /** Items visible on the current page. */
+    readonly pageItems: Readable<T[]>;
+    /** Navigate to the previous page. No-op on first page. */
+    prev(): void;
+    /** Reset to the first page. */
+    reset(): void;
+};
+/**
+ * Reactive pagination state for a list of items.
+ *
+ * Decoupled from option rendering so it can be used with any sorted/filtered
+ * item array (e.g., the `filteredOptions` signal in combobox).
+ *
+ * @example
+ * ```ts
+ * const paged = createPaginatedList({ getItems: () => allOptions.value, pageSize: 20 });
+ * // render paged.pageItems.value
+ * // navigation: paged.next(), paged.prev(), paged.goTo(0)
+ * ```
+ */
+export declare const createPaginatedList: <T>(options: PaginatedListOptions<T>) => PaginatedListHandle<T>;
+//# sourceMappingURL=paginated-list.d.ts.map

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

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

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

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

@@ -0,0 +1,2 @@
+var e=(e,t,n)=>{let r=String(e??``).split(`,`).map(e=>e.trim()).filter(e=>t.has(e));return r.length>0?r:[...n]};exports.parseStringTriggers=e;
+//# sourceMappingURL=parse.cjs.map

package/dist/headless/parse.cjs.map

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

@@ -0,0 +1,15 @@
+/**
+ * Parses a comma-separated trigger string into a typed array, filtering against
+ * a valid set and falling back to `defaults` when the input is empty or invalid.
+ *
+ * Used by tooltip and popover to normalise their `trigger` prop values.
+ *
+ * @example
+ * ```ts
+ * const VALID = new Set(['click', 'hover', 'focus'] as const);
+ * parseStringTriggers('hover,focus', VALID, ['click']); // → ['hover', 'focus']
+ * parseStringTriggers('',            VALID, ['click']); // → ['click']
+ * ```
+ */
+export declare const parseStringTriggers: <T extends string>(value: string | null | undefined, valid: ReadonlySet<T>, defaults: T[]) => T[];
+//# sourceMappingURL=parse.d.ts.map

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

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

@@ -0,0 +1,9 @@
+//#region src/headless/parse.ts
+var e = (e, t, n) => {
+	let r = String(e ?? "").split(",").map((e) => e.trim()).filter((e) => t.has(e));
+	return r.length > 0 ? r : [...n];
+};
+//#endregion
+export { e as parseStringTriggers };
+
+//# sourceMappingURL=parse.js.map

package/dist/headless/parse.js.map

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

@@ -0,0 +1,2 @@
+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({getDir:r,getFloating:i,getPlacement:a,getReference:o,matchWidth:s=!0,offsetPx:c=0,padding:l=6}){function u(){let t=a?.()??`bottom-start`;return(r?.()??e.elementDirection(o()))===`rtl`?n(t):t}function d(){let e=o(),n=i();if(!e||!n)return;let r=u(),a=(0,t.computePosition)(e,n,{middleware:[...c?[(0,t.offset)(c)]:[],(0,t.flip)({padding:l}),(0,t.shift)({padding:l}),...s?[(0,t.size)({padding:l})]:[]],placement:r});n.style.left=`${a.x}px`,n.style.top=`${a.y}px`,s&&(n.style.width=`${e.getBoundingClientRect().width}px`)}function f(){let e=o(),n=i();return!e||!n?()=>{}:(0,t.autoUpdate)(e,n,d)}return{floating:i,reference:o,startAutoUpdate:f,update:d}}exports.createDropdownPositioner=r;
+//# sourceMappingURL=positioner.cjs.map

package/dist/headless/positioner.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"positioner.cjs","names":[],"sources":["../../src/headless/positioner.ts"],"sourcesContent":["import { autoUpdate, computePosition, flip, offset, type Placement, shift, size } 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   * 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  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\n    const result = computePosition(ref, floating, {\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    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":"oEAsCA,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,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,EAE9B,GAAA,EAAA,EAAA,gBAAA,CAAyB,EAAK,EAAU,CAC5C,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,IAE7B,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

@@ -0,0 +1,40 @@
+import { type Placement } from '@vielzeug/orbit';
+export type OverlayPositioner = {
+    floating: () => HTMLElement | null;
+    reference: () => HTMLElement | null;
+    /** Start continuous position auto-updates. Returns a stop function. */
+    startAutoUpdate?: () => () => void;
+    update: () => void;
+};
+export type DropdownPositionerOptions = {
+    /**
+     * Returns the text direction used for placement mirroring. Defaults to the resolved
+     * direction of the reference element (nearest `dir="ltr"|"rtl"` ancestor, falling back to
+     * computed style) — most callers never need to pass this explicitly.
+     */
+    getDir?: () => 'ltr' | 'rtl';
+    /** Getter for the floating (dropdown panel) element. */
+    getFloating: () => HTMLElement | null;
+    /** Getter for the current placement. Defaults to 'bottom-start' (RTL-aware: flips to 'bottom-end'). */
+    getPlacement?: () => Placement;
+    /** Getter for the reference (trigger) element. */
+    getReference: () => HTMLElement | null;
+    /** Whether to match the floating element width to the reference. Default: true */
+    matchWidth?: boolean;
+    /** Additional offset in pixels between reference and floating element. Default: 0 */
+    offsetPx?: number;
+    /** Padding (px) used by flip, shift, and size middleware. Default: 6 */
+    padding?: number;
+};
+/**
+ * Creates an Orbit-powered positioner for dropdown overlays (select, combobox, menu).
+ *
+ * Uses flip + shift + optional width-matching middleware. Supports continuous
+ * auto-update for repositioning on scroll or resize.
+ *
+ * RTL-aware: start/end placements are automatically mirrored so dropdowns open on the
+ * correct side, based on `getDir` (or the reference element's resolved direction when
+ * `getDir` is omitted).
+ */
+export declare function createDropdownPositioner({ getDir, getFloating, getPlacement, getReference, matchWidth, offsetPx, padding, }: DropdownPositionerOptions): OverlayPositioner;
+//# sourceMappingURL=positioner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"positioner.d.ts","sourceRoot":"","sources":["../../src/headless/positioner.ts"],"names":[],"mappings":"AAAA,OAAO,EAA6C,KAAK,SAAS,EAAe,MAAM,iBAAiB,CAAC;AAMzG,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;;;;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,MAAM,EACN,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,UAAiB,EACjB,QAAY,EACZ,OAAW,GACZ,EAAE,yBAAyB,GAAG,iBAAiB,CA4C/C"}

package/dist/headless/positioner.js

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

package/dist/headless/positioner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"positioner.js","names":[],"sources":["../../src/headless/positioner.ts"],"sourcesContent":["import { autoUpdate, computePosition, flip, offset, type Placement, shift, size } 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   * 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  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\n    const result = computePosition(ref, floating, {\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    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":";;;AAsCA,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,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,GAE9B,IAAS,EAAgB,GAAK,GAAU;GAC5C,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;EAKD,AAHA,EAAS,MAAM,OAAO,GAAG,EAAO,EAAE,KAClC,EAAS,MAAM,MAAM,GAAG,EAAO,EAAE,KAE7B,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/selection-control.cjs

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"selection-control.d.ts","sourceRoot":"","sources":["../../src/headless/selection-control.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,QAAQ,EAAU,MAAM,kBAAkB,CAAC;AAEnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAIhD,MAAM,MAAM,uBAAuB,CAAC,CAAC,IAAI;IACvC,qDAAqD;IACrD,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,CAAC;IAC/B,6EAA6E;IAC7E,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC;IAChD,iDAAiD;IACjD,SAAS,EAAE,MAAM,CAAC,EAAE,CAAC;IACrB,qDAAqD;IACrD,aAAa,EAAE,MAAM,aAAa,CAAC;CACpC,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,yBAAyB;IACzB,cAAc,IAAI,IAAI,CAAC;IACvB,kDAAkD;IAClD,aAAa,IAAI,OAAO,CAAC;IACzB,2CAA2C;IAC3C,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACjC,iFAAiF;IACjF,SAAS,IAAI,IAAI,CAAC;IAClB,2EAA2E;IAC3E,QAAQ,CAAC,YAAY,EAAE,QAAQ,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC;IACrD,oDAAoD;IACpD,YAAY,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IACtC,yCAAyC;IACzC,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B,CAAC;AAEF,eAAO,MAAM,sBAAsB,GAAI,CAAC,EAAE,SAAS,uBAAuB,CAAC,CAAC,CAAC,KAAG,gBA0E/E,CAAC"}

package/dist/headless/selection-control.js

@@ -0,0 +1,44 @@
+import { computed as e, signal as t } from "@vielzeug/ripple";
+//#region src/headless/selection-control.ts
+var n = (n) => {
+	let r = t(/* @__PURE__ */ new Set()), i = (e) => r.value.has(e), a = () => {
+		let e = n.pageItems();
+		return e.length ? e.every((e) => r.value.has(n.getRowKey(e))) : !1;
+	}, o = (e) => {
+		r.value = e, n.onSelectionChange?.(e);
+	};
+	return {
+		clearSelection: () => {
+			o(/* @__PURE__ */ new Set());
+		},
+		isAllSelected: a,
+		isSelected: i,
+		selectAll: () => {
+			if (n.selectionMode() !== "multi") return;
+			let e = n.pageItems();
+			if (a()) {
+				let t = new Set(r.value);
+				for (let r of e) t.delete(n.getRowKey(r));
+				o(t);
+			} else {
+				let t = new Set(r.value);
+				for (let r of e) t.add(n.getRowKey(r));
+				o(t);
+			}
+		},
+		selectedKeys: e(() => new Set(r.value)),
+		setSelection: (e) => {
+			o(new Set(e));
+		},
+		toggleRow: (e) => {
+			let t = n.selectionMode();
+			if (t === "none") return;
+			let i = new Set(r.value);
+			i.has(e) ? i.delete(e) : (t === "single" && i.clear(), i.add(e)), o(i);
+		}
+	};
+};
+//#endregion
+export { n as createSelectionControl };
+
+//# sourceMappingURL=selection-control.js.map