@vielzeug/refine 1.7.0 → 2.0.0

package/dist/core/focus.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"focus.cjs","names":[],"sources":["../../src/core/focus.ts"],"sourcesContent":["// ── Types ─────────────────────────────────────────────────────────────────────\n\nexport type FocusManagerOptions = {\n  /**\n   * Returns the CSS selector for the element that should receive focus on open.\n   *\n   * **Security note:** this value is passed directly to `querySelector`. It must\n   * come from trusted developer-controlled configuration, never from raw user input.\n   */\n  getInitialFocusSelector: () => string | undefined;\n  /**\n   * Returns whether focus should be restored to the previously focused element\n   * on close. `undefined` or `true` means restore; `false` means skip.\n   */\n  getReturnFocus: () => boolean | undefined;\n  /** Host element used for `querySelector` when resolving the initial focus target. */\n  host: HTMLElement;\n  /**\n   * `AbortSignal` from the component lifecycle. Cancels a pending `applyInitialFocus()`\n   * animation frame automatically on abort — prevents a stray `.focus()` call landing on an\n   * element that's been disconnected in the meantime (e.g. the dialog closes and unmounts\n   * before the deferred focus frame runs).\n   */\n  signal?: AbortSignal;\n};\n\nexport type FocusManager = {\n  /** Move focus to the element matching `getInitialFocusSelector` (deferred one frame). */\n  applyInitialFocus: () => void;\n  /** Cancel a pending `applyInitialFocus` rAF, if any. */\n  cancelInitialFocus: () => void;\n  /** Capture the currently focused element so it can be restored later. */\n  captureReturnFocus: () => void;\n  /** Restore focus to the element captured by `captureReturnFocus`. */\n  restoreFocus: () => void;\n};\n\n// ── Factory ───────────────────────────────────────────────────────────────────\n\n/**\n * Encapsulates the three-step focus lifecycle used by dialogs and drawers:\n * 1. Capture the element that triggered the open.\n * 2. Move focus inside the overlay (optionally to a specific element).\n * 3. Restore focus when the overlay closes.\n */\nexport function createFocusManager(options: FocusManagerOptions): FocusManager {\n  let returnFocusEl: HTMLElement | null = null;\n  let rafHandle: ReturnType<typeof requestAnimationFrame> | null = null;\n\n  const cancelInitialFocus = (): void => {\n    if (rafHandle !== null) {\n      cancelAnimationFrame(rafHandle);\n      rafHandle = null;\n    }\n  };\n\n  options.signal?.addEventListener('abort', cancelInitialFocus, { once: true });\n\n  return {\n    applyInitialFocus() {\n      cancelInitialFocus();\n\n      const selector = options.getInitialFocusSelector();\n\n      if (selector) {\n        // Query the shadow root first (all refine components render into Shadow DOM),\n        // falling back to the host's light-DOM tree for non-Shadow contexts.\n        const root = options.host.shadowRoot ?? options.host;\n\n        let target: HTMLElement | null = null;\n\n        try {\n          target = root.querySelector<HTMLElement>(selector);\n        } catch {\n          // Malformed selector (SyntaxError) — skip initial focus rather than throw.\n          return;\n        }\n\n        if (target) {\n          rafHandle = requestAnimationFrame(() => {\n            rafHandle = null;\n            target.focus();\n          });\n        }\n      }\n    },\n\n    cancelInitialFocus,\n\n    captureReturnFocus() {\n      returnFocusEl = document.activeElement as HTMLElement;\n    },\n\n    restoreFocus() {\n      if (options.getReturnFocus() !== false && returnFocusEl) {\n        returnFocusEl.focus();\n        returnFocusEl = null;\n      }\n    },\n  };\n}\n"],"mappings":"AA6CA,SAAgB,EAAmB,EAA4C,CAC7E,IAAI,EAAoC,KACpC,EAA6D,KAE3D,MAAiC,CACjC,IAAc,OAChB,qBAAqB,CAAS,EAC9B,EAAY,KAEhB,EAIA,OAFA,EAAQ,QAAQ,iBAAiB,QAAS,EAAoB,CAAE,KAAM,EAAK,CAAC,EAErE,CACL,mBAAoB,CAClB,EAAmB,EAEnB,IAAM,EAAW,EAAQ,wBAAwB,EAEjD,GAAI,EAAU,CAGZ,IAAM,EAAO,EAAQ,KAAK,YAAc,EAAQ,KAE5C,EAA6B,KAEjC,GAAI,CACF,EAAS,EAAK,cAA2B,CAAQ,CACnD,MAAQ,CAEN,MACF,CAEI,IACF,EAAY,0BAA4B,CACtC,EAAY,KACZ,EAAO,MAAM,CACf,CAAC,EAEL,CACF,EAEA,qBAEA,oBAAqB,CACnB,EAAgB,SAAS,aAC3B,EAEA,cAAe,CACT,EAAQ,eAAe,IAAM,IAAS,IACxC,EAAc,MAAM,EACpB,EAAgB,KAEpB,CACF,CACF"}

package/dist/core/focus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"focus.d.ts","sourceRoot":"","sources":["../../src/core/focus.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,mBAAmB,GAAG;IAChC;;;;;OAKG;IACH,uBAAuB,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IAClD;;;OAGG;IACH,cAAc,EAAE,MAAM,OAAO,GAAG,SAAS,CAAC;IAC1C,qFAAqF;IACrF,IAAI,EAAE,WAAW,CAAC;IAClB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,yFAAyF;IACzF,iBAAiB,EAAE,MAAM,IAAI,CAAC;IAC9B,wDAAwD;IACxD,kBAAkB,EAAE,MAAM,IAAI,CAAC;IAC/B,yEAAyE;IACzE,kBAAkB,EAAE,MAAM,IAAI,CAAC;IAC/B,qEAAqE;IACrE,YAAY,EAAE,MAAM,IAAI,CAAC;CAC1B,CAAC;AAIF;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,GAAG,YAAY,CAuD7E"}

package/dist/{headless → core}/focus.js

@@ -1,4 +1,4 @@
-//#region src/headless/focus.ts
+//#region src/core/focus.ts
 function e(e) {
 	let t = null, n = null, r = () => {
 		n !== null && (cancelAnimationFrame(n), n = null);

package/dist/core/focus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"focus.js","names":[],"sources":["../../src/core/focus.ts"],"sourcesContent":["// ── Types ─────────────────────────────────────────────────────────────────────\n\nexport type FocusManagerOptions = {\n  /**\n   * Returns the CSS selector for the element that should receive focus on open.\n   *\n   * **Security note:** this value is passed directly to `querySelector`. It must\n   * come from trusted developer-controlled configuration, never from raw user input.\n   */\n  getInitialFocusSelector: () => string | undefined;\n  /**\n   * Returns whether focus should be restored to the previously focused element\n   * on close. `undefined` or `true` means restore; `false` means skip.\n   */\n  getReturnFocus: () => boolean | undefined;\n  /** Host element used for `querySelector` when resolving the initial focus target. */\n  host: HTMLElement;\n  /**\n   * `AbortSignal` from the component lifecycle. Cancels a pending `applyInitialFocus()`\n   * animation frame automatically on abort — prevents a stray `.focus()` call landing on an\n   * element that's been disconnected in the meantime (e.g. the dialog closes and unmounts\n   * before the deferred focus frame runs).\n   */\n  signal?: AbortSignal;\n};\n\nexport type FocusManager = {\n  /** Move focus to the element matching `getInitialFocusSelector` (deferred one frame). */\n  applyInitialFocus: () => void;\n  /** Cancel a pending `applyInitialFocus` rAF, if any. */\n  cancelInitialFocus: () => void;\n  /** Capture the currently focused element so it can be restored later. */\n  captureReturnFocus: () => void;\n  /** Restore focus to the element captured by `captureReturnFocus`. */\n  restoreFocus: () => void;\n};\n\n// ── Factory ───────────────────────────────────────────────────────────────────\n\n/**\n * Encapsulates the three-step focus lifecycle used by dialogs and drawers:\n * 1. Capture the element that triggered the open.\n * 2. Move focus inside the overlay (optionally to a specific element).\n * 3. Restore focus when the overlay closes.\n */\nexport function createFocusManager(options: FocusManagerOptions): FocusManager {\n  let returnFocusEl: HTMLElement | null = null;\n  let rafHandle: ReturnType<typeof requestAnimationFrame> | null = null;\n\n  const cancelInitialFocus = (): void => {\n    if (rafHandle !== null) {\n      cancelAnimationFrame(rafHandle);\n      rafHandle = null;\n    }\n  };\n\n  options.signal?.addEventListener('abort', cancelInitialFocus, { once: true });\n\n  return {\n    applyInitialFocus() {\n      cancelInitialFocus();\n\n      const selector = options.getInitialFocusSelector();\n\n      if (selector) {\n        // Query the shadow root first (all refine components render into Shadow DOM),\n        // falling back to the host's light-DOM tree for non-Shadow contexts.\n        const root = options.host.shadowRoot ?? options.host;\n\n        let target: HTMLElement | null = null;\n\n        try {\n          target = root.querySelector<HTMLElement>(selector);\n        } catch {\n          // Malformed selector (SyntaxError) — skip initial focus rather than throw.\n          return;\n        }\n\n        if (target) {\n          rafHandle = requestAnimationFrame(() => {\n            rafHandle = null;\n            target.focus();\n          });\n        }\n      }\n    },\n\n    cancelInitialFocus,\n\n    captureReturnFocus() {\n      returnFocusEl = document.activeElement as HTMLElement;\n    },\n\n    restoreFocus() {\n      if (options.getReturnFocus() !== false && returnFocusEl) {\n        returnFocusEl.focus();\n        returnFocusEl = null;\n      }\n    },\n  };\n}\n"],"mappings":";AA6CA,SAAgB,EAAmB,GAA4C;CAC7E,IAAI,IAAoC,MACpC,IAA6D,MAE3D,UAAiC;EACrC,AAAI,MAAc,SAChB,qBAAqB,CAAS,GAC9B,IAAY;CAEhB;CAIA,OAFA,EAAQ,QAAQ,iBAAiB,SAAS,GAAoB,EAAE,MAAM,GAAK,CAAC,GAErE;EACL,oBAAoB;GAClB,EAAmB;GAEnB,IAAM,IAAW,EAAQ,wBAAwB;GAEjD,IAAI,GAAU;IAGZ,IAAM,IAAO,EAAQ,KAAK,cAAc,EAAQ,MAE5C,IAA6B;IAEjC,IAAI;KACF,IAAS,EAAK,cAA2B,CAAQ;IACnD,QAAQ;KAEN;IACF;IAEA,AAAI,MACF,IAAY,4BAA4B;KAEtC,AADA,IAAY,MACZ,EAAO,MAAM;IACf,CAAC;GAEL;EACF;EAEA;EAEA,qBAAqB;GACnB,IAAgB,SAAS;EAC3B;EAEA,eAAe;GACb,AAAI,EAAQ,eAAe,MAAM,MAAS,MACxC,EAAc,MAAM,GACpB,IAAgB;EAEpB;CACF;AACF"}

package/dist/{headless → core}/index.d.ts

@@ -1,3 +1,9 @@
+/**
+ * Private implementation barrel for Refine components.
+ *
+ * This module is deliberately omitted from the package export map: its helpers
+ * encode component-specific Ore and Ripple behavior, not a stable public API.
+ */
 export { lifecycleSignal } from './ore';
 export { createAutoResize, type AutoResizeControl, type AutoResizeOptions } from './auto-resize';
 export { bindRefCallback, type RefCallback } from './ref-callback';
@@ -7,8 +13,7 @@ export { createTextField, type TextFieldDetach, type TextFieldHandle, type TextF
 export { createChoiceField, type ChoiceChangeDetail, type ChoiceFieldHandle, type ChoiceFieldOptions, } from './choice-field';
 export { createCheckable, type CheckableChangePayload, type CheckableHandle, type CheckableOptions } from './checkable';
 export { createComposerControl, type ComposerControl, type ComposerControlOptions, type SendShortcut, } from './composer';
-export { type DialogCloseReason, type DropdownCloseReason, type OverlayCloseDetail, type OverlayControl, type OverlayOpenDetail, type OverlayOpenReason, } from './overlay';
-export { createOptionList, type BaseOptionItem, type OptionListHandle, type OptionListOptions, type PlacementOptions, } from './option-list';
+export { type DialogCloseReason, type DropdownCloseReason, type OverlayCloseDetail, type OverlayOpenChangeDetail, type OverlayOpenDetail, type OverlayOpenReason, } from './overlay';
 export { createPaginatedList, type PaginatedListHandle, type PaginatedListOptions } from './paginated-list';
 export { type ListKeyAction, type ListNavigationAction } from './nav';
 export { createSpinnerControl, type SpinnerControl, type SpinnerControlOptions } from './spinner';
@@ -18,13 +23,9 @@ export { announce, type AnnouncePoliteness, type AnnounceOptions } from './annou
 export { createDatePickerControl, formatDisplayDate, parseIso, toIsoString, type DateCell, type DatePickerControl, type DatePickerControlOptions, type DatePickerView, type MonthCell, type YearCell, } from './date-picker';
 export { getChoiceLabel, getLightChildrenByTag } from './light-dom';
 export { toFiniteNumber, toFiniteNumberOr, toPositiveStep } from './numbers';
-export { createDataGridControl, type DataGridColumn, type DataGridControl, type DataGridControlOptions, type SelectionMode, type SortDirection, type SortState, } from './datagrid';
 export { createDropdownPositioner, type DropdownPositionerOptions, type OverlayPositioner } from './positioner';
 export { createInteraction, dispatchKeyboardAction, type Interaction, type InteractionOptions, type KeyboardDispatchOptions, type PressTrigger, } from './keyboard';
 export { createListControl, type ListControl, type ListNavigationOptions } from './nav';
-export { createOverlayControl, type OverlayControlOptions } from './overlay';
-export { createSelectionControl, type SelectionControl, type SelectionControlOptions } from './selection-control';
-export { createSortControl, type SortControl, type SortControlOptions } from './sort-control';
 export { createTypeahead, type Typeahead, type TypeaheadOptions } from './typeahead';
 export { elementDirection } from './direction';
 export { parseStringTriggers } from './parse';

package/dist/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,OAAO,CAAC;AAGxC,OAAO,EAAE,gBAAgB,EAAE,KAAK,iBAAiB,EAAE,KAAK,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAGjG,OAAO,EAAE,eAAe,EAAE,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAGnE,OAAO,EAAE,iBAAiB,EAAE,KAAK,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAGnF,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,EAClB,sBAAsB,EACtB,WAAW,EACX,gBAAgB,EAChB,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC1B,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,GACvB,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,eAAe,EAAE,KAAK,eAAe,EAAE,KAAK,eAAe,EAAE,KAAK,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAGlH,OAAO,EACL,iBAAiB,EACjB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,GACxB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,eAAe,EAAE,KAAK,sBAAsB,EAAE,KAAK,eAAe,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAGxH,OAAO,EACL,qBAAqB,EACrB,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAC3B,KAAK,YAAY,GAClB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC5B,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,GACvB,MAAM,WAAW,CAAC;AAGnB,OAAO,EAAE,mBAAmB,EAAE,KAAK,mBAAmB,EAAE,KAAK,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAG5G,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,OAAO,CAAC;AAGtE,OAAO,EAAE,oBAAoB,EAAE,KAAK,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAGlG,OAAO,EAAE,mBAAmB,EAAE,KAAK,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAG9F,OAAO,EACL,kBAAkB,EAClB,KAAK,SAAS,EACd,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,GACzB,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,QAAQ,EAAE,KAAK,kBAAkB,EAAE,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAGtF,OAAO,EACL,uBAAuB,EACvB,iBAAiB,EACjB,QAAQ,EACR,WAAW,EACX,KAAK,QAAQ,EACb,KAAK,iBAAiB,EACtB,KAAK,wBAAwB,EAC7B,KAAK,cAAc,EACnB,KAAK,SAAS,EACd,KAAK,QAAQ,GACd,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAGpE,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAI7E,OAAO,EAAE,wBAAwB,EAAE,KAAK,yBAAyB,EAAE,KAAK,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAChH,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC5B,KAAK,YAAY,GAClB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,iBAAiB,EAAE,KAAK,WAAW,EAAE,KAAK,qBAAqB,EAAE,MAAM,OAAO,CAAC;AACxF,OAAO,EAAE,eAAe,EAAE,KAAK,SAAS,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACrF,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC"}

package/dist/{headless → core}/keyboard.cjs

@@ -1,2 +1,2 @@
-var e=(e,t)=>{if(t.disabled?.value)return!1;let n=Object.hasOwn(t.keymap,e.key)?t.keymap[e.key]:void 0;if(!n)return!1;let r=t.preventDefault??`before`;r===`before`&&e.preventDefault();let i=n(e)!==!1;return r===`after`&&i&&e.preventDefault(),i},t=t=>{let n=()=>!!t.disabled?.value,r=t.keys??[`Enter`,` `],i=Object.fromEntries(r.map(e=>[e,e=>t.onPress?.(e,`keyboard`)]));return{handleBlur:e=>{n()||t.onBlur?.(e)},handleClick:e=>n()?!1:(t.onPress?.(e,`pointer`),!0),handleFocus:e=>{n()||t.onFocus?.(e)},handleKeydown:n=>e(n,{disabled:t.disabled,keymap:i})}};exports.createInteraction=t,exports.dispatchKeyboardAction=e;
+var e=(e,t)=>{if(t.disabled?.value)return!1;let n=Object.hasOwn(t.keymap,e.key)?t.keymap[e.key]:void 0;if(!n)return!1;let r=t.preventDefault??`before`;r===`before`&&e.preventDefault();let i=n(e)!==!1;return r===`after`&&i&&e.preventDefault(),i},t=t=>{let n=()=>!!t.disabled?.value,r=t.keys??[`Enter`,` `],i=Object.fromEntries(r.map(e=>[e,e=>t.onPress?.(e,`keyboard`)]));return{handleBlur:e=>{n()||t.onBlur?.(e)},handleClick:e=>!n()&&(t.onPress?.(e,`pointer`),!0),handleFocus:e=>{n()||t.onFocus?.(e)},handleKeydown:n=>e(n,{disabled:t.disabled,keymap:i})}};exports.createInteraction=t,exports.dispatchKeyboardAction=e;
 //# sourceMappingURL=keyboard.cjs.map

package/dist/core/keyboard.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyboard.cjs","names":[],"sources":["../../src/core/keyboard.ts"],"sourcesContent":["import type { Readable } from '@vielzeug/ripple';\n\n// ── Keyboard dispatch ─────────────────────────────────────────────────────────\n\nexport type KeyboardDispatchOptions = {\n  disabled?: Readable<boolean | undefined>;\n  keymap: Record<string, (event: KeyboardEvent) => boolean | void>;\n  preventDefault?: 'after' | 'before' | false;\n};\n\nexport const dispatchKeyboardAction = (event: KeyboardEvent, options: KeyboardDispatchOptions): boolean => {\n  if (options.disabled?.value) return false;\n\n  // `event.key` is attacker-influenceable on a synthetic KeyboardEvent (e.g. `new\n  // KeyboardEvent('keydown', { key: '__proto__' })`). Guard with `Object.hasOwn` so a\n  // crafted key name can never resolve to an inherited `Object.prototype` member\n  // (`__proto__`, `constructor`, `toString`, …) instead of `undefined`.\n  const action = Object.hasOwn(options.keymap, event.key) ? options.keymap[event.key] : undefined;\n\n  if (!action) return false;\n\n  const preventDefaultMode = options.preventDefault ?? 'before';\n\n  if (preventDefaultMode === 'before') event.preventDefault();\n\n  const handled = action(event) !== false;\n\n  if (preventDefaultMode === 'after' && handled) event.preventDefault();\n\n  return handled;\n};\n\n// ── Press control / Interaction ───────────────────────────────────────────────\n\nexport type PressTrigger = 'keyboard' | 'pointer';\n\n/**\n * Options for `createInteraction` — a unified press + focus/blur interaction\n * handler for accessible interactive elements.\n */\nexport type InteractionOptions = {\n  /** `true` when the element is disabled. All handlers become no-ops. */\n  disabled?: Readable<boolean | undefined>;\n  /** Keys that trigger a press. Defaults to `['Enter', ' ']`. */\n  keys?: string[];\n  /** Called when the element loses focus. */\n  onBlur?: (event: FocusEvent) => void;\n  /** Called when the element receives focus. */\n  onFocus?: (event: FocusEvent) => void;\n  /** Called when the element is pressed via keyboard or pointer. */\n  onPress?: (event: KeyboardEvent | MouseEvent, trigger: PressTrigger) => void;\n};\n\nexport type Interaction = {\n  handleBlur: (event: FocusEvent) => void;\n  handleClick: (event: MouseEvent) => boolean;\n  handleFocus: (event: FocusEvent) => void;\n  handleKeydown: (event: KeyboardEvent) => boolean;\n};\n\n/**\n * Creates a set of event handlers for an interactive element that responds to\n * keyboard and pointer presses, and optionally focus/blur events.\n *\n * @example\n * ```ts\n * const interaction = createInteraction({\n *   disabled: props.disabled,\n *   onPress: (event, trigger) => toggle(event),\n *   onFocus: (event) => setFocused(true),\n *   onBlur: (event) => setFocused(false),\n * });\n *\n * // In template:\n * // @click=\"${interaction.handleClick}\"\n * // @keydown=\"${interaction.handleKeydown}\"\n * // @focus=\"${interaction.handleFocus}\"\n * // @blur=\"${interaction.handleBlur}\"\n * ```\n */\nexport const createInteraction = (options: InteractionOptions): Interaction => {\n  const isDisabled = (): boolean => Boolean(options.disabled?.value);\n  const keyboardKeys = options.keys ?? ['Enter', ' '];\n  const keymap = Object.fromEntries(\n    keyboardKeys.map((key) => [key, (keyboardEvent: KeyboardEvent) => options.onPress?.(keyboardEvent, 'keyboard')]),\n  );\n\n  return {\n    handleBlur: (event: FocusEvent): void => {\n      if (!isDisabled()) options.onBlur?.(event);\n    },\n    handleClick: (event: MouseEvent): boolean => {\n      if (isDisabled()) return false;\n\n      options.onPress?.(event, 'pointer');\n\n      return true;\n    },\n    handleFocus: (event: FocusEvent): void => {\n      if (!isDisabled()) options.onFocus?.(event);\n    },\n    handleKeydown: (event: KeyboardEvent): boolean =>\n      dispatchKeyboardAction(event, { disabled: options.disabled, keymap }),\n  };\n};\n"],"mappings":"AAUA,IAAa,GAA0B,EAAsB,IAA8C,CACzG,GAAI,EAAQ,UAAU,MAAO,MAAO,GAMpC,IAAM,EAAS,OAAO,OAAO,EAAQ,OAAQ,EAAM,GAAG,EAAI,EAAQ,OAAO,EAAM,KAAO,IAAA,GAEtF,GAAI,CAAC,EAAQ,MAAO,GAEpB,IAAM,EAAqB,EAAQ,gBAAkB,SAEjD,IAAuB,UAAU,EAAM,eAAe,EAE1D,IAAM,EAAU,EAAO,CAAK,IAAM,GAIlC,OAFI,IAAuB,SAAW,GAAS,EAAM,eAAe,EAE7D,CACT,EAkDa,EAAqB,GAA6C,CAC7E,IAAM,MAA4B,EAAQ,EAAQ,UAAU,MACtD,EAAe,EAAQ,MAAQ,CAAC,QAAS,GAAG,EAC5C,EAAS,OAAO,YACpB,EAAa,IAAK,GAAQ,CAAC,EAAM,GAAiC,EAAQ,UAAU,EAAe,UAAU,CAAC,CAAC,CACjH,EAEA,MAAO,CACL,WAAa,GAA4B,CAClC,EAAW,GAAG,EAAQ,SAAS,CAAK,CAC3C,EACA,YAAc,GACZ,CAAI,EAAW,IAEf,EAAQ,UAAU,EAAO,SAAS,EAE3B,IAET,YAAc,GAA4B,CACnC,EAAW,GAAG,EAAQ,UAAU,CAAK,CAC5C,EACA,cAAgB,GACd,EAAuB,EAAO,CAAE,SAAU,EAAQ,SAAU,QAAO,CAAC,CACxE,CACF"}

package/dist/core/keyboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyboard.d.ts","sourceRoot":"","sources":["../../src/core/keyboard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAIjD,MAAM,MAAM,uBAAuB,GAAG;IACpC,QAAQ,CAAC,EAAE,QAAQ,CAAC,OAAO,GAAG,SAAS,CAAC,CAAC;IACzC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,OAAO,GAAG,IAAI,CAAC,CAAC;IACjE,cAAc,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;CAC7C,CAAC;AAEF,eAAO,MAAM,sBAAsB,GAAI,OAAO,aAAa,EAAE,SAAS,uBAAuB,KAAG,OAoB/F,CAAC;AAIF,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,SAAS,CAAC;AAElD;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,uEAAuE;IACvE,QAAQ,CAAC,EAAE,QAAQ,CAAC,OAAO,GAAG,SAAS,CAAC,CAAC;IACzC,+DAA+D;IAC/D,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,2CAA2C;IAC3C,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;IACrC,8CAA8C;IAC9C,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;IACtC,kEAAkE;IAClE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,GAAG,UAAU,EAAE,OAAO,EAAE,YAAY,KAAK,IAAI,CAAC;CAC9E,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,UAAU,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;IACxC,WAAW,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,OAAO,CAAC;IAC5C,WAAW,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;IACzC,aAAa,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,OAAO,CAAC;CAClD,CAAC;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,iBAAiB,GAAI,SAAS,kBAAkB,KAAG,WAwB/D,CAAC"}

package/dist/{headless → core}/keyboard.js

@@ -1,4 +1,4 @@
-//#region src/headless/keyboard.ts
+//#region src/core/keyboard.ts
 var e = (e, t) => {
 	if (t.disabled?.value) return !1;
 	let n = Object.hasOwn(t.keymap, e.key) ? t.keymap[e.key] : void 0;
@@ -13,7 +13,7 @@ var e = (e, t) => {
 		handleBlur: (e) => {
 			n() || t.onBlur?.(e);
 		},
-		handleClick: (e) => n() ? !1 : (t.onPress?.(e, "pointer"), !0),
+		handleClick: (e) => !n() && (t.onPress?.(e, "pointer"), !0),
 		handleFocus: (e) => {
 			n() || t.onFocus?.(e);
 		},

package/dist/core/keyboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyboard.js","names":[],"sources":["../../src/core/keyboard.ts"],"sourcesContent":["import type { Readable } from '@vielzeug/ripple';\n\n// ── Keyboard dispatch ─────────────────────────────────────────────────────────\n\nexport type KeyboardDispatchOptions = {\n  disabled?: Readable<boolean | undefined>;\n  keymap: Record<string, (event: KeyboardEvent) => boolean | void>;\n  preventDefault?: 'after' | 'before' | false;\n};\n\nexport const dispatchKeyboardAction = (event: KeyboardEvent, options: KeyboardDispatchOptions): boolean => {\n  if (options.disabled?.value) return false;\n\n  // `event.key` is attacker-influenceable on a synthetic KeyboardEvent (e.g. `new\n  // KeyboardEvent('keydown', { key: '__proto__' })`). Guard with `Object.hasOwn` so a\n  // crafted key name can never resolve to an inherited `Object.prototype` member\n  // (`__proto__`, `constructor`, `toString`, …) instead of `undefined`.\n  const action = Object.hasOwn(options.keymap, event.key) ? options.keymap[event.key] : undefined;\n\n  if (!action) return false;\n\n  const preventDefaultMode = options.preventDefault ?? 'before';\n\n  if (preventDefaultMode === 'before') event.preventDefault();\n\n  const handled = action(event) !== false;\n\n  if (preventDefaultMode === 'after' && handled) event.preventDefault();\n\n  return handled;\n};\n\n// ── Press control / Interaction ───────────────────────────────────────────────\n\nexport type PressTrigger = 'keyboard' | 'pointer';\n\n/**\n * Options for `createInteraction` — a unified press + focus/blur interaction\n * handler for accessible interactive elements.\n */\nexport type InteractionOptions = {\n  /** `true` when the element is disabled. All handlers become no-ops. */\n  disabled?: Readable<boolean | undefined>;\n  /** Keys that trigger a press. Defaults to `['Enter', ' ']`. */\n  keys?: string[];\n  /** Called when the element loses focus. */\n  onBlur?: (event: FocusEvent) => void;\n  /** Called when the element receives focus. */\n  onFocus?: (event: FocusEvent) => void;\n  /** Called when the element is pressed via keyboard or pointer. */\n  onPress?: (event: KeyboardEvent | MouseEvent, trigger: PressTrigger) => void;\n};\n\nexport type Interaction = {\n  handleBlur: (event: FocusEvent) => void;\n  handleClick: (event: MouseEvent) => boolean;\n  handleFocus: (event: FocusEvent) => void;\n  handleKeydown: (event: KeyboardEvent) => boolean;\n};\n\n/**\n * Creates a set of event handlers for an interactive element that responds to\n * keyboard and pointer presses, and optionally focus/blur events.\n *\n * @example\n * ```ts\n * const interaction = createInteraction({\n *   disabled: props.disabled,\n *   onPress: (event, trigger) => toggle(event),\n *   onFocus: (event) => setFocused(true),\n *   onBlur: (event) => setFocused(false),\n * });\n *\n * // In template:\n * // @click=\"${interaction.handleClick}\"\n * // @keydown=\"${interaction.handleKeydown}\"\n * // @focus=\"${interaction.handleFocus}\"\n * // @blur=\"${interaction.handleBlur}\"\n * ```\n */\nexport const createInteraction = (options: InteractionOptions): Interaction => {\n  const isDisabled = (): boolean => Boolean(options.disabled?.value);\n  const keyboardKeys = options.keys ?? ['Enter', ' '];\n  const keymap = Object.fromEntries(\n    keyboardKeys.map((key) => [key, (keyboardEvent: KeyboardEvent) => options.onPress?.(keyboardEvent, 'keyboard')]),\n  );\n\n  return {\n    handleBlur: (event: FocusEvent): void => {\n      if (!isDisabled()) options.onBlur?.(event);\n    },\n    handleClick: (event: MouseEvent): boolean => {\n      if (isDisabled()) return false;\n\n      options.onPress?.(event, 'pointer');\n\n      return true;\n    },\n    handleFocus: (event: FocusEvent): void => {\n      if (!isDisabled()) options.onFocus?.(event);\n    },\n    handleKeydown: (event: KeyboardEvent): boolean =>\n      dispatchKeyboardAction(event, { disabled: options.disabled, keymap }),\n  };\n};\n"],"mappings":";AAUA,IAAa,KAA0B,GAAsB,MAA8C;CACzG,IAAI,EAAQ,UAAU,OAAO,OAAO;CAMpC,IAAM,IAAS,OAAO,OAAO,EAAQ,QAAQ,EAAM,GAAG,IAAI,EAAQ,OAAO,EAAM,OAAO,KAAA;CAEtF,IAAI,CAAC,GAAQ,OAAO;CAEpB,IAAM,IAAqB,EAAQ,kBAAkB;CAErD,AAAI,MAAuB,YAAU,EAAM,eAAe;CAE1D,IAAM,IAAU,EAAO,CAAK,MAAM;CAIlC,OAFI,MAAuB,WAAW,KAAS,EAAM,eAAe,GAE7D;AACT,GAkDa,KAAqB,MAA6C;CAC7E,IAAM,UAA4B,EAAQ,EAAQ,UAAU,OACtD,IAAe,EAAQ,QAAQ,CAAC,SAAS,GAAG,GAC5C,IAAS,OAAO,YACpB,EAAa,KAAK,MAAQ,CAAC,IAAM,MAAiC,EAAQ,UAAU,GAAe,UAAU,CAAC,CAAC,CACjH;CAEA,OAAO;EACL,aAAa,MAA4B;GACvC,AAAK,EAAW,KAAG,EAAQ,SAAS,CAAK;EAC3C;EACA,cAAc,MACZ,CAAI,EAAW,MAEf,EAAQ,UAAU,GAAO,SAAS,GAE3B;EAET,cAAc,MAA4B;GACxC,AAAK,EAAW,KAAG,EAAQ,UAAU,CAAK;EAC5C;EACA,gBAAgB,MACd,EAAuB,GAAO;GAAE,UAAU,EAAQ;GAAU;EAAO,CAAC;CACxE;AACF"}

package/dist/core/light-dom.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"light-dom.cjs","names":[],"sources":["../../src/core/light-dom.ts"],"sourcesContent":["// ── Slot / light-DOM query helpers ────────────────────────────────────────────\n// Utilities for querying slotted light-DOM children and resolving labels from\n// option elements. Used by group components (checkbox-group, radio-group) and\n// choice-field components (select, combobox).\n\n/**\n * Returns all light-DOM descendants matching `tag` inside `host`.\n * Uses `getElementsByTagName` on the host's light DOM \\u2014 not Shadow DOM slot assignment.\n */\nexport const getLightChildrenByTag = (host: HTMLElement, tag: string): HTMLElement[] =>\n  Array.from(host.getElementsByTagName(tag)) as HTMLElement[];\n\n/**\n * Returns the `textContent` of the item whose `value` attribute matches `value`,\n * falling back to `value` itself when no match is found.\n * Used by choice-field components to derive labels for emitted change events.\n */\nexport const getChoiceLabel = (items: HTMLElement[], value: string): string => {\n  const item = items.find((el) => (el.getAttribute('value') ?? '') === value);\n\n  return item?.textContent?.replace(/\\s+/g, ' ').trim() || value;\n};\n"],"mappings":"AASA,IAAa,GAAyB,EAAmB,IACvD,MAAM,KAAK,EAAK,qBAAqB,CAAG,CAAC,EAO9B,GAAkB,EAAsB,IACtC,EAAM,KAAM,IAAQ,EAAG,aAAa,OAAO,GAAK,MAAQ,CAE9D,CAAA,EAAM,aAAa,QAAQ,OAAQ,GAAG,CAAC,CAAC,KAAK,GAAK"}

package/dist/core/light-dom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"light-dom.d.ts","sourceRoot":"","sources":["../../src/core/light-dom.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,eAAO,MAAM,qBAAqB,GAAI,MAAM,WAAW,EAAE,KAAK,MAAM,KAAG,WAAW,EACrB,CAAC;AAE9D;;;;GAIG;AACH,eAAO,MAAM,cAAc,GAAI,OAAO,WAAW,EAAE,EAAE,OAAO,MAAM,KAAG,MAIpE,CAAC"}

package/dist/{headless → core}/light-dom.js

@@ -1,4 +1,4 @@
-//#region src/headless/light-dom.ts
+//#region src/core/light-dom.ts
 var e = (e, t) => Array.from(e.getElementsByTagName(t)), t = (e, t) => e.find((e) => (e.getAttribute("value") ?? "") === t)?.textContent?.replace(/\s+/g, " ").trim() || t;
 //#endregion
 export { t as getChoiceLabel, e as getLightChildrenByTag };

package/dist/core/light-dom.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"light-dom.js","names":[],"sources":["../../src/core/light-dom.ts"],"sourcesContent":["// ── Slot / light-DOM query helpers ────────────────────────────────────────────\n// Utilities for querying slotted light-DOM children and resolving labels from\n// option elements. Used by group components (checkbox-group, radio-group) and\n// choice-field components (select, combobox).\n\n/**\n * Returns all light-DOM descendants matching `tag` inside `host`.\n * Uses `getElementsByTagName` on the host's light DOM \\u2014 not Shadow DOM slot assignment.\n */\nexport const getLightChildrenByTag = (host: HTMLElement, tag: string): HTMLElement[] =>\n  Array.from(host.getElementsByTagName(tag)) as HTMLElement[];\n\n/**\n * Returns the `textContent` of the item whose `value` attribute matches `value`,\n * falling back to `value` itself when no match is found.\n * Used by choice-field components to derive labels for emitted change events.\n */\nexport const getChoiceLabel = (items: HTMLElement[], value: string): string => {\n  const item = items.find((el) => (el.getAttribute('value') ?? '') === value);\n\n  return item?.textContent?.replace(/\\s+/g, ' ').trim() || value;\n};\n"],"mappings":";AASA,IAAa,KAAyB,GAAmB,MACvD,MAAM,KAAK,EAAK,qBAAqB,CAAG,CAAC,GAO9B,KAAkB,GAAsB,MACtC,EAAM,MAAM,OAAQ,EAAG,aAAa,OAAO,KAAK,QAAQ,CAE9D,CAAA,EAAM,aAAa,QAAQ,QAAQ,GAAG,CAAC,CAAC,KAAK,KAAK"}

package/dist/core/nav.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"nav.cjs","names":[],"sources":["../../src/core/nav.ts"],"sourcesContent":["import { type Readable, signal } from '@vielzeug/ripple';\n\nimport { dispatchKeyboardAction } from './keyboard';\nimport { createTypeahead } from './typeahead';\n\n// ── Private array search helpers ────────────────────────────────────────────\nconst findForward = <T>(items: T[], start: number, predicate: (item: T, index: number) => boolean): number => {\n  for (let idx = start; idx < items.length; idx++) {\n    if (predicate(items[idx], idx)) return idx;\n  }\n\n  return -1;\n};\n\nconst findBackward = <T>(items: T[], start: number, predicate: (item: T, index: number) => boolean): number => {\n  for (let idx = start; idx >= 0; idx--) {\n    if (predicate(items[idx], idx)) return idx;\n  }\n\n  return -1;\n};\n\n// ── Types ─────────────────────────────────────────────────────────────────────\n\n/**\n * Arrow-key and Home/End navigation actions. Separate from `ListKeyAction` so\n * keymap declarations never need `Exclude<ListKeyAction, 'typeahead'>`.\n */\nexport type ListNavigationAction = 'first' | 'last' | 'next' | 'prev';\n\n/**\n * All possible navigation action names, including `'typeahead'` (character-key\n * search). Used in `onNavigate` callbacks where both nav and typeahead are valid.\n */\nexport type ListKeyAction = ListNavigationAction | 'typeahead';\n\n/**\n * Orientation-aware default key bindings for list navigation.\n * - `'vertical'` (default): Up/Down arrows, Home/End\n * - `'horizontal'`: Left/Right arrows, Home/End\n * - `'both'`: all four arrow keys + Home/End\n */\nconst DEFAULT_KEYS: Record<'both' | 'horizontal' | 'vertical', Record<ListNavigationAction, string[]>> = {\n  both: { first: ['Home'], last: ['End'], next: ['ArrowDown', 'ArrowRight'], prev: ['ArrowUp', 'ArrowLeft'] },\n  horizontal: { first: ['Home'], last: ['End'], next: ['ArrowRight'], prev: ['ArrowLeft'] },\n  vertical: { first: ['Home'], last: ['End'], next: ['ArrowDown'], prev: ['ArrowUp'] },\n};\n\n/**\n * RTL mirror of `DEFAULT_KEYS`'s horizontal component (per WAI-ARIA APG — tabs/radiogroup\n * flip Left/Right in `dir=\"rtl\"` so \"next\" always advances in reading order, not screen-space\n * direction). Only the Left/Right bindings differ; Home/End and the vertical arrows are\n * direction-independent and stay identical to `DEFAULT_KEYS`.\n */\nconst DEFAULT_KEYS_RTL: Record<'both' | 'horizontal' | 'vertical', Record<ListNavigationAction, string[]>> = {\n  both: { first: ['Home'], last: ['End'], next: ['ArrowDown', 'ArrowLeft'], prev: ['ArrowUp', 'ArrowRight'] },\n  horizontal: { first: ['Home'], last: ['End'], next: ['ArrowLeft'], prev: ['ArrowRight'] },\n  vertical: DEFAULT_KEYS.vertical,\n};\n\nexport type ListNavigationOptions<T> = {\n  /**\n   * Text direction, used to mirror the default Left/Right arrow-key bindings for\n   * `'horizontal'`/`'both'` orientation (WAI-ARIA APG: `dir=\"rtl\"` flips which arrow key\n   * means \"next\" vs \"prev\"). Pass a getter for dynamic/reactive direction (e.g. derived from\n   * `elementDirection(getHost())`, since a `dir` ancestor attribute can change at runtime).\n   * Has no effect when an explicit `keys` override is provided. Defaults to `'ltr'`.\n   */\n  direction?: 'ltr' | 'rtl' | (() => 'ltr' | 'rtl');\n  disabled?: Readable<boolean | undefined>;\n  /**\n   * Returns a plain-text label for an item used by typeahead search.\n   * When provided, pressing a printable character key jumps to the first enabled\n   * item whose label starts with the accumulated type buffer (500 ms reset window).\n   * Omit for contexts where the host element is a text input (e.g. combobox).\n   */\n  getItemLabel?: (item: T, index: number) => string;\n  getItems: () => T[];\n  isItemDisabled?: (item: T, index: number) => boolean;\n  /** Override default key bindings for navigation actions. */\n  keys?: Partial<Record<ListNavigationAction, string[]>>;\n  loop?: boolean;\n  /**\n   * Called when navigation lands on a new index.\n   * `event` is the originating `KeyboardEvent`, or `undefined` for programmatic navigation.\n   * Use to sync side-effects such as focusing a DOM element.\n   */\n  onNavigate?: (action: ListKeyAction, index: number, event?: KeyboardEvent) => void;\n  /**\n   * Axis the list navigates along. Controls which arrow keys are treated as\n   * `next`/`prev` when no explicit `keys` override is provided.\n   * Pass a getter function for dynamic/reactive orientation (e.g. driven by a prop signal).\n   *\n   * - `'vertical'` (default): ↑↓ arrows\n   * - `'horizontal'`: ←→ arrows\n   * - `'both'`: all four arrow keys\n   */\n  orientation?: 'both' | 'horizontal' | 'vertical' | (() => 'both' | 'horizontal' | 'vertical');\n  /** `AbortSignal` from the component lifecycle. Disposes typeahead timer on abort. */\n  signal?: AbortSignal;\n};\n\nexport type ListControl<T> = {\n  [Symbol.dispose](): void;\n  /** Disposes the internal typeahead timer. Alias for `dispose()`. Conforms to the monorepo disposal convention. */\n  dispose(): void;\n  /** `true` after `dispose()` has been called. */\n  readonly disposed: boolean;\n  /** Current focused index. `-1` when nothing is focused. */\n  readonly focusedIndex: Readable<number>;\n  getActiveItem(): T | undefined;\n  handleKeydown(event: KeyboardEvent): boolean;\n  /**\n   * Programmatically navigate to a named position.\n   * Always fires `onNavigate` — consistent with keyboard navigation.\n   * Returns the resolved index, or `-1` if no enabled item was found.\n   */\n  navigate(action: ListNavigationAction): number;\n  /** Reset focused index to `-1`. */\n  reset(): void;\n  /**\n   * Set focus to the item at `index`. Returns the resolved index.\n   * Pass a negative index to clear focus (same as `reset()`).\n   */\n  set(index: number): number;\n};\n\nconst hasDisabledProp = (item: unknown): item is { disabled: boolean } =>\n  typeof item === 'object' && item !== null && 'disabled' in item;\n\nexport const createListControl = <T>(options: ListNavigationOptions<T>): ListControl<T> => {\n  const _index = signal(-1);\n\n  const isItemDisabled = (item: T, index: number): boolean =>\n    options.isItemDisabled?.(item, index) ?? (hasDisabledProp(item) ? item.disabled : false);\n\n  const commitIndex = (idx: number, action: ListKeyAction, event?: KeyboardEvent): number => {\n    if (idx >= 0) {\n      _index.value = idx;\n      options.onNavigate?.(action, idx, event);\n    }\n\n    return idx;\n  };\n\n  const findEnabledIndex = (items: T[], start: number, direction: 'forward' | 'backward'): number => {\n    if (direction === 'forward') return findForward(items, start, (item, i) => !isItemDisabled(item, i));\n\n    return findBackward(items, start, (item, i) => !isItemDisabled(item, i));\n  };\n\n  const set = (index: number): number => {\n    if (index < 0) {\n      reset();\n\n      return -1;\n    }\n\n    const items = options.getItems();\n\n    if (!items.length) return -1;\n\n    const clamped = Math.min(index, items.length - 1);\n\n    if (isItemDisabled(items[clamped], clamped)) return -1;\n\n    _index.value = clamped;\n\n    return clamped;\n  };\n\n  const move = (direction: 'forward' | 'backward', event?: KeyboardEvent): number => {\n    const items = options.getItems();\n    const current = _index.value;\n\n    if (!items.length) return -1;\n\n    const start: number =\n      current < 0\n        ? direction === 'forward'\n          ? 0\n          : items.length - 1\n        : direction === 'forward'\n          ? current + 1\n          : current - 1;\n    const idx = findEnabledIndex(items, start, direction);\n    const action: ListNavigationAction = direction === 'forward' ? 'next' : 'prev';\n\n    if (idx >= 0) return commitIndex(idx, action, event);\n\n    if (options.loop) {\n      const wrapStart = direction === 'forward' ? 0 : items.length - 1;\n      const wrapped = findEnabledIndex(items, wrapStart, direction);\n\n      if (wrapped >= 0) return commitIndex(wrapped, action, event);\n    }\n\n    return current;\n  };\n\n  const navigate = (action: ListNavigationAction): number => {\n    const items = options.getItems();\n\n    if (!items.length) return -1;\n\n    if (action === 'first') {\n      const idx = findEnabledIndex(items, 0, 'forward');\n\n      return commitIndex(idx, 'first');\n    }\n\n    if (action === 'last') {\n      const idx = findEnabledIndex(items, items.length - 1, 'backward');\n\n      return commitIndex(idx, 'last');\n    }\n\n    return move(action === 'next' ? 'forward' : 'backward');\n  };\n\n  const getActiveItem = (): T | undefined => {\n    const items = options.getItems();\n    const index = _index.value;\n\n    return index >= 0 && index < items.length ? items[index] : undefined;\n  };\n\n  const reset = (): void => {\n    _index.value = -1;\n  };\n\n  // ── Keyboard handling ──────────────────────────────────────────────────────\n\n  const isKeyDisabled = (): boolean => Boolean(options.disabled?.value);\n\n  const resolveOrientation = (): 'both' | 'horizontal' | 'vertical' =>\n    typeof options.orientation === 'function' ? options.orientation() : (options.orientation ?? 'vertical');\n\n  const resolveDirection = (): 'ltr' | 'rtl' =>\n    typeof options.direction === 'function' ? options.direction() : (options.direction ?? 'ltr');\n\n  const buildKeymap = (): Record<string, (keyboardEvent: KeyboardEvent) => void> => {\n    const keys = options.keys;\n    const keyTable = resolveDirection() === 'rtl' ? DEFAULT_KEYS_RTL : DEFAULT_KEYS;\n    const orientationDefaults = keyTable[resolveOrientation()];\n    const resolved = {\n      first: keys?.first ?? orientationDefaults.first,\n      last: keys?.last ?? orientationDefaults.last,\n      next: keys?.next ?? orientationDefaults.next,\n      prev: keys?.prev ?? orientationDefaults.prev,\n    };\n    const km: Record<string, (keyboardEvent: KeyboardEvent) => void> = {};\n\n    for (const action of ['next', 'prev', 'first', 'last'] as const) {\n      for (const key of resolved[action]) {\n        km[key] = (keyboardEvent: KeyboardEvent) => {\n          if (action === 'first' || action === 'last') {\n            const items = options.getItems();\n\n            if (!items.length) return;\n\n            const idx =\n              action === 'first'\n                ? findEnabledIndex(items, 0, 'forward')\n                : findEnabledIndex(items, items.length - 1, 'backward');\n\n            commitIndex(idx, action, keyboardEvent);\n          } else {\n            move(action === 'next' ? 'forward' : 'backward', keyboardEvent);\n          }\n        };\n      }\n    }\n\n    return km;\n  };\n\n  // ── Typeahead ──────────────────────────────────────────────────────────────\n\n  const typeahead = options.getItemLabel\n    ? createTypeahead({\n        getIndex: () => _index.value,\n        getItemLabel: options.getItemLabel,\n        getItems: options.getItems,\n        isItemDisabled: (item, index) => isItemDisabled(item, index),\n        onNavigate: (index, event) => {\n          if (!isKeyDisabled()) {\n            _index.value = index;\n            options.onNavigate?.('typeahead', index, event);\n          }\n        },\n      })\n    : null;\n\n  // Keymap depends on both orientation and direction — if either is dynamic, rebuild on every\n  // keydown instead of caching once.\n  const isDynamicKeymap = typeof options.orientation === 'function' || typeof options.direction === 'function';\n  const _staticKeymap: Record<string, (e: KeyboardEvent) => void> | null = isDynamicKeymap ? null : buildKeymap();\n\n  const handleKeydown = (event: KeyboardEvent): boolean => {\n    const km = _staticKeymap ?? buildKeymap();\n\n    if (dispatchKeyboardAction(event, { disabled: options.disabled, keymap: km })) return true;\n\n    return typeahead?.handleKeydown(event) ?? false;\n  };\n\n  let disposed = false;\n\n  const dispose = (): void => {\n    if (disposed) return;\n\n    disposed = true;\n    typeahead?.reset();\n  };\n\n  if (options.signal) {\n    options.signal.addEventListener('abort', dispose, { once: true });\n  }\n\n  return {\n    dispose,\n    get disposed() {\n      return disposed;\n    },\n    focusedIndex: _index,\n    getActiveItem,\n    handleKeydown,\n    navigate,\n    reset,\n    set,\n    [Symbol.dispose]: dispose,\n  };\n};\n"],"mappings":"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"}

package/dist/core/nav.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nav.d.ts","sourceRoot":"","sources":["../../src/core/nav.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAU,MAAM,kBAAkB,CAAC;AAwBzD;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAEtE;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,oBAAoB,GAAG,WAAW,CAAC;AA0B/D,MAAM,MAAM,qBAAqB,CAAC,CAAC,IAAI;IACrC;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,CAAC,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC;IAClD,QAAQ,CAAC,EAAE,QAAQ,CAAC,OAAO,GAAG,SAAS,CAAC,CAAC;IACzC;;;;;OAKG;IACH,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IAClD,QAAQ,EAAE,MAAM,CAAC,EAAE,CAAC;IACpB,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;IACrD,4DAA4D;IAC5D,IAAI,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,oBAAoB,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;IACvD,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;;;OAIG;IACH,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,aAAa,KAAK,IAAI,CAAC;IACnF;;;;;;;;OAQG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,YAAY,GAAG,UAAU,GAAG,CAAC,MAAM,MAAM,GAAG,YAAY,GAAG,UAAU,CAAC,CAAC;IAC9F,qFAAqF;IACrF,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI;IAC3B,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC;IACzB,kHAAkH;IAClH,OAAO,IAAI,IAAI,CAAC;IAChB,gDAAgD;IAChD,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,2DAA2D;IAC3D,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;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,oBAAoB,GAAG,MAAM,CAAC;IAC/C,mCAAmC;IACnC,KAAK,IAAI,IAAI,CAAC;IACd;;;OAGG;IACH,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;CAC5B,CAAC;AAKF,eAAO,MAAM,iBAAiB,GAAI,CAAC,EAAE,SAAS,qBAAqB,CAAC,CAAC,CAAC,KAAG,WAAW,CAAC,CAAC,CA2MrF,CAAC"}

package/dist/{headless → core}/nav.js

@@ -1,7 +1,7 @@
 import { dispatchKeyboardAction as e } from "./keyboard.js";
 import { createTypeahead as t } from "./typeahead.js";
 import { signal as n } from "@vielzeug/ripple";
-//#region src/headless/nav.ts
+//#region src/core/nav.ts
 var r = (e, t, n) => {
 	for (let r = t; r < e.length; r++) if (n(e[r], r)) return r;
 	return -1;

package/dist/core/nav.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nav.js","names":[],"sources":["../../src/core/nav.ts"],"sourcesContent":["import { type Readable, signal } from '@vielzeug/ripple';\n\nimport { dispatchKeyboardAction } from './keyboard';\nimport { createTypeahead } from './typeahead';\n\n// ── Private array search helpers ────────────────────────────────────────────\nconst findForward = <T>(items: T[], start: number, predicate: (item: T, index: number) => boolean): number => {\n  for (let idx = start; idx < items.length; idx++) {\n    if (predicate(items[idx], idx)) return idx;\n  }\n\n  return -1;\n};\n\nconst findBackward = <T>(items: T[], start: number, predicate: (item: T, index: number) => boolean): number => {\n  for (let idx = start; idx >= 0; idx--) {\n    if (predicate(items[idx], idx)) return idx;\n  }\n\n  return -1;\n};\n\n// ── Types ─────────────────────────────────────────────────────────────────────\n\n/**\n * Arrow-key and Home/End navigation actions. Separate from `ListKeyAction` so\n * keymap declarations never need `Exclude<ListKeyAction, 'typeahead'>`.\n */\nexport type ListNavigationAction = 'first' | 'last' | 'next' | 'prev';\n\n/**\n * All possible navigation action names, including `'typeahead'` (character-key\n * search). Used in `onNavigate` callbacks where both nav and typeahead are valid.\n */\nexport type ListKeyAction = ListNavigationAction | 'typeahead';\n\n/**\n * Orientation-aware default key bindings for list navigation.\n * - `'vertical'` (default): Up/Down arrows, Home/End\n * - `'horizontal'`: Left/Right arrows, Home/End\n * - `'both'`: all four arrow keys + Home/End\n */\nconst DEFAULT_KEYS: Record<'both' | 'horizontal' | 'vertical', Record<ListNavigationAction, string[]>> = {\n  both: { first: ['Home'], last: ['End'], next: ['ArrowDown', 'ArrowRight'], prev: ['ArrowUp', 'ArrowLeft'] },\n  horizontal: { first: ['Home'], last: ['End'], next: ['ArrowRight'], prev: ['ArrowLeft'] },\n  vertical: { first: ['Home'], last: ['End'], next: ['ArrowDown'], prev: ['ArrowUp'] },\n};\n\n/**\n * RTL mirror of `DEFAULT_KEYS`'s horizontal component (per WAI-ARIA APG — tabs/radiogroup\n * flip Left/Right in `dir=\"rtl\"` so \"next\" always advances in reading order, not screen-space\n * direction). Only the Left/Right bindings differ; Home/End and the vertical arrows are\n * direction-independent and stay identical to `DEFAULT_KEYS`.\n */\nconst DEFAULT_KEYS_RTL: Record<'both' | 'horizontal' | 'vertical', Record<ListNavigationAction, string[]>> = {\n  both: { first: ['Home'], last: ['End'], next: ['ArrowDown', 'ArrowLeft'], prev: ['ArrowUp', 'ArrowRight'] },\n  horizontal: { first: ['Home'], last: ['End'], next: ['ArrowLeft'], prev: ['ArrowRight'] },\n  vertical: DEFAULT_KEYS.vertical,\n};\n\nexport type ListNavigationOptions<T> = {\n  /**\n   * Text direction, used to mirror the default Left/Right arrow-key bindings for\n   * `'horizontal'`/`'both'` orientation (WAI-ARIA APG: `dir=\"rtl\"` flips which arrow key\n   * means \"next\" vs \"prev\"). Pass a getter for dynamic/reactive direction (e.g. derived from\n   * `elementDirection(getHost())`, since a `dir` ancestor attribute can change at runtime).\n   * Has no effect when an explicit `keys` override is provided. Defaults to `'ltr'`.\n   */\n  direction?: 'ltr' | 'rtl' | (() => 'ltr' | 'rtl');\n  disabled?: Readable<boolean | undefined>;\n  /**\n   * Returns a plain-text label for an item used by typeahead search.\n   * When provided, pressing a printable character key jumps to the first enabled\n   * item whose label starts with the accumulated type buffer (500 ms reset window).\n   * Omit for contexts where the host element is a text input (e.g. combobox).\n   */\n  getItemLabel?: (item: T, index: number) => string;\n  getItems: () => T[];\n  isItemDisabled?: (item: T, index: number) => boolean;\n  /** Override default key bindings for navigation actions. */\n  keys?: Partial<Record<ListNavigationAction, string[]>>;\n  loop?: boolean;\n  /**\n   * Called when navigation lands on a new index.\n   * `event` is the originating `KeyboardEvent`, or `undefined` for programmatic navigation.\n   * Use to sync side-effects such as focusing a DOM element.\n   */\n  onNavigate?: (action: ListKeyAction, index: number, event?: KeyboardEvent) => void;\n  /**\n   * Axis the list navigates along. Controls which arrow keys are treated as\n   * `next`/`prev` when no explicit `keys` override is provided.\n   * Pass a getter function for dynamic/reactive orientation (e.g. driven by a prop signal).\n   *\n   * - `'vertical'` (default): ↑↓ arrows\n   * - `'horizontal'`: ←→ arrows\n   * - `'both'`: all four arrow keys\n   */\n  orientation?: 'both' | 'horizontal' | 'vertical' | (() => 'both' | 'horizontal' | 'vertical');\n  /** `AbortSignal` from the component lifecycle. Disposes typeahead timer on abort. */\n  signal?: AbortSignal;\n};\n\nexport type ListControl<T> = {\n  [Symbol.dispose](): void;\n  /** Disposes the internal typeahead timer. Alias for `dispose()`. Conforms to the monorepo disposal convention. */\n  dispose(): void;\n  /** `true` after `dispose()` has been called. */\n  readonly disposed: boolean;\n  /** Current focused index. `-1` when nothing is focused. */\n  readonly focusedIndex: Readable<number>;\n  getActiveItem(): T | undefined;\n  handleKeydown(event: KeyboardEvent): boolean;\n  /**\n   * Programmatically navigate to a named position.\n   * Always fires `onNavigate` — consistent with keyboard navigation.\n   * Returns the resolved index, or `-1` if no enabled item was found.\n   */\n  navigate(action: ListNavigationAction): number;\n  /** Reset focused index to `-1`. */\n  reset(): void;\n  /**\n   * Set focus to the item at `index`. Returns the resolved index.\n   * Pass a negative index to clear focus (same as `reset()`).\n   */\n  set(index: number): number;\n};\n\nconst hasDisabledProp = (item: unknown): item is { disabled: boolean } =>\n  typeof item === 'object' && item !== null && 'disabled' in item;\n\nexport const createListControl = <T>(options: ListNavigationOptions<T>): ListControl<T> => {\n  const _index = signal(-1);\n\n  const isItemDisabled = (item: T, index: number): boolean =>\n    options.isItemDisabled?.(item, index) ?? (hasDisabledProp(item) ? item.disabled : false);\n\n  const commitIndex = (idx: number, action: ListKeyAction, event?: KeyboardEvent): number => {\n    if (idx >= 0) {\n      _index.value = idx;\n      options.onNavigate?.(action, idx, event);\n    }\n\n    return idx;\n  };\n\n  const findEnabledIndex = (items: T[], start: number, direction: 'forward' | 'backward'): number => {\n    if (direction === 'forward') return findForward(items, start, (item, i) => !isItemDisabled(item, i));\n\n    return findBackward(items, start, (item, i) => !isItemDisabled(item, i));\n  };\n\n  const set = (index: number): number => {\n    if (index < 0) {\n      reset();\n\n      return -1;\n    }\n\n    const items = options.getItems();\n\n    if (!items.length) return -1;\n\n    const clamped = Math.min(index, items.length - 1);\n\n    if (isItemDisabled(items[clamped], clamped)) return -1;\n\n    _index.value = clamped;\n\n    return clamped;\n  };\n\n  const move = (direction: 'forward' | 'backward', event?: KeyboardEvent): number => {\n    const items = options.getItems();\n    const current = _index.value;\n\n    if (!items.length) return -1;\n\n    const start: number =\n      current < 0\n        ? direction === 'forward'\n          ? 0\n          : items.length - 1\n        : direction === 'forward'\n          ? current + 1\n          : current - 1;\n    const idx = findEnabledIndex(items, start, direction);\n    const action: ListNavigationAction = direction === 'forward' ? 'next' : 'prev';\n\n    if (idx >= 0) return commitIndex(idx, action, event);\n\n    if (options.loop) {\n      const wrapStart = direction === 'forward' ? 0 : items.length - 1;\n      const wrapped = findEnabledIndex(items, wrapStart, direction);\n\n      if (wrapped >= 0) return commitIndex(wrapped, action, event);\n    }\n\n    return current;\n  };\n\n  const navigate = (action: ListNavigationAction): number => {\n    const items = options.getItems();\n\n    if (!items.length) return -1;\n\n    if (action === 'first') {\n      const idx = findEnabledIndex(items, 0, 'forward');\n\n      return commitIndex(idx, 'first');\n    }\n\n    if (action === 'last') {\n      const idx = findEnabledIndex(items, items.length - 1, 'backward');\n\n      return commitIndex(idx, 'last');\n    }\n\n    return move(action === 'next' ? 'forward' : 'backward');\n  };\n\n  const getActiveItem = (): T | undefined => {\n    const items = options.getItems();\n    const index = _index.value;\n\n    return index >= 0 && index < items.length ? items[index] : undefined;\n  };\n\n  const reset = (): void => {\n    _index.value = -1;\n  };\n\n  // ── Keyboard handling ──────────────────────────────────────────────────────\n\n  const isKeyDisabled = (): boolean => Boolean(options.disabled?.value);\n\n  const resolveOrientation = (): 'both' | 'horizontal' | 'vertical' =>\n    typeof options.orientation === 'function' ? options.orientation() : (options.orientation ?? 'vertical');\n\n  const resolveDirection = (): 'ltr' | 'rtl' =>\n    typeof options.direction === 'function' ? options.direction() : (options.direction ?? 'ltr');\n\n  const buildKeymap = (): Record<string, (keyboardEvent: KeyboardEvent) => void> => {\n    const keys = options.keys;\n    const keyTable = resolveDirection() === 'rtl' ? DEFAULT_KEYS_RTL : DEFAULT_KEYS;\n    const orientationDefaults = keyTable[resolveOrientation()];\n    const resolved = {\n      first: keys?.first ?? orientationDefaults.first,\n      last: keys?.last ?? orientationDefaults.last,\n      next: keys?.next ?? orientationDefaults.next,\n      prev: keys?.prev ?? orientationDefaults.prev,\n    };\n    const km: Record<string, (keyboardEvent: KeyboardEvent) => void> = {};\n\n    for (const action of ['next', 'prev', 'first', 'last'] as const) {\n      for (const key of resolved[action]) {\n        km[key] = (keyboardEvent: KeyboardEvent) => {\n          if (action === 'first' || action === 'last') {\n            const items = options.getItems();\n\n            if (!items.length) return;\n\n            const idx =\n              action === 'first'\n                ? findEnabledIndex(items, 0, 'forward')\n                : findEnabledIndex(items, items.length - 1, 'backward');\n\n            commitIndex(idx, action, keyboardEvent);\n          } else {\n            move(action === 'next' ? 'forward' : 'backward', keyboardEvent);\n          }\n        };\n      }\n    }\n\n    return km;\n  };\n\n  // ── Typeahead ──────────────────────────────────────────────────────────────\n\n  const typeahead = options.getItemLabel\n    ? createTypeahead({\n        getIndex: () => _index.value,\n        getItemLabel: options.getItemLabel,\n        getItems: options.getItems,\n        isItemDisabled: (item, index) => isItemDisabled(item, index),\n        onNavigate: (index, event) => {\n          if (!isKeyDisabled()) {\n            _index.value = index;\n            options.onNavigate?.('typeahead', index, event);\n          }\n        },\n      })\n    : null;\n\n  // Keymap depends on both orientation and direction — if either is dynamic, rebuild on every\n  // keydown instead of caching once.\n  const isDynamicKeymap = typeof options.orientation === 'function' || typeof options.direction === 'function';\n  const _staticKeymap: Record<string, (e: KeyboardEvent) => void> | null = isDynamicKeymap ? null : buildKeymap();\n\n  const handleKeydown = (event: KeyboardEvent): boolean => {\n    const km = _staticKeymap ?? buildKeymap();\n\n    if (dispatchKeyboardAction(event, { disabled: options.disabled, keymap: km })) return true;\n\n    return typeahead?.handleKeydown(event) ?? false;\n  };\n\n  let disposed = false;\n\n  const dispose = (): void => {\n    if (disposed) return;\n\n    disposed = true;\n    typeahead?.reset();\n  };\n\n  if (options.signal) {\n    options.signal.addEventListener('abort', dispose, { once: true });\n  }\n\n  return {\n    dispose,\n    get disposed() {\n      return disposed;\n    },\n    focusedIndex: _index,\n    getActiveItem,\n    handleKeydown,\n    navigate,\n    reset,\n    set,\n    [Symbol.dispose]: dispose,\n  };\n};\n"],"mappings":"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"}

package/dist/core/numbers.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"numbers.cjs","names":[],"sources":["../../src/core/numbers.ts"],"sourcesContent":["// ── Number helpers ────────────────────────────────────────────────────────────\n\n/**\n * Coerces `value` via `Number()` and returns it when finite, `undefined` otherwise.\n *\n * Caveat: `null` and `''` both coerce to `0` in JavaScript (`Number(null) === 0`,\n * `Number('') === 0`) and are therefore returned as the finite number `0`, not\n * `undefined` — this function does not treat \"absent\" values specially. Only\n * genuinely non-numeric input (`undefined`, `NaN`, non-numeric strings) yields\n * `undefined`. Callers that mean \"no bound set\" should pass `undefined`\n * explicitly rather than `null` or `''`.\n */\nexport const toFiniteNumber = (value: unknown): number | undefined => {\n  const parsed = Number(value);\n\n  return Number.isFinite(parsed) ? parsed : undefined;\n};\n\nexport const toFiniteNumberOr = (value: unknown, fallback: number): number => {\n  return toFiniteNumber(value) ?? fallback;\n};\n\nexport const toPositiveStep = (value: unknown, fallback: number): number => {\n  return Math.abs(toFiniteNumberOr(value, fallback)) || fallback;\n};\n"],"mappings":"AAYA,IAAa,EAAkB,GAAuC,CACpE,IAAM,EAAS,OAAO,CAAK,EAE3B,OAAO,OAAO,SAAS,CAAM,EAAI,EAAS,IAAA,EAC5C,EAEa,GAAoB,EAAgB,IACxC,EAAe,CAAK,GAAK,EAGrB,GAAkB,EAAgB,IACtC,KAAK,IAAI,EAAiB,EAAO,CAAQ,CAAC,GAAK"}

package/dist/core/numbers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"numbers.d.ts","sourceRoot":"","sources":["../../src/core/numbers.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,eAAO,MAAM,cAAc,GAAI,OAAO,OAAO,KAAG,MAAM,GAAG,SAIxD,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,OAAO,OAAO,EAAE,UAAU,MAAM,KAAG,MAEnE,CAAC;AAEF,eAAO,MAAM,cAAc,GAAI,OAAO,OAAO,EAAE,UAAU,MAAM,KAAG,MAEjE,CAAC"}

package/dist/{headless → core}/numbers.js

@@ -1,4 +1,4 @@
-//#region src/headless/numbers.ts
+//#region src/core/numbers.ts
 var e = (e) => {
 	let t = Number(e);
 	return Number.isFinite(t) ? t : void 0;

package/dist/core/numbers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"numbers.js","names":[],"sources":["../../src/core/numbers.ts"],"sourcesContent":["// ── Number helpers ────────────────────────────────────────────────────────────\n\n/**\n * Coerces `value` via `Number()` and returns it when finite, `undefined` otherwise.\n *\n * Caveat: `null` and `''` both coerce to `0` in JavaScript (`Number(null) === 0`,\n * `Number('') === 0`) and are therefore returned as the finite number `0`, not\n * `undefined` — this function does not treat \"absent\" values specially. Only\n * genuinely non-numeric input (`undefined`, `NaN`, non-numeric strings) yields\n * `undefined`. Callers that mean \"no bound set\" should pass `undefined`\n * explicitly rather than `null` or `''`.\n */\nexport const toFiniteNumber = (value: unknown): number | undefined => {\n  const parsed = Number(value);\n\n  return Number.isFinite(parsed) ? parsed : undefined;\n};\n\nexport const toFiniteNumberOr = (value: unknown, fallback: number): number => {\n  return toFiniteNumber(value) ?? fallback;\n};\n\nexport const toPositiveStep = (value: unknown, fallback: number): number => {\n  return Math.abs(toFiniteNumberOr(value, fallback)) || fallback;\n};\n"],"mappings":";AAYA,IAAa,KAAkB,MAAuC;CACpE,IAAM,IAAS,OAAO,CAAK;CAE3B,OAAO,OAAO,SAAS,CAAM,IAAI,IAAS,KAAA;AAC5C,GAEa,KAAoB,GAAgB,MACxC,EAAe,CAAK,KAAK,GAGrB,KAAkB,GAAgB,MACtC,KAAK,IAAI,EAAiB,GAAO,CAAQ,CAAC,KAAK"}

package/dist/core/option-list.cjs

@@ -0,0 +1,2 @@
+const e=require("../errors.cjs"),t=require("./positioner.cjs"),n=require("./nav.cjs"),r=require("./overlay.cjs");let i=require("@vielzeug/ripple");var a=a=>{if(typeof a.getBoundary!=`function`)throw new e.RefineConfigError(`createListboxDropdown: getBoundary is required`);if(typeof a.getPanel!=`function`)throw new e.RefineConfigError(`createListboxDropdown: getPanel is required`);if(typeof a.getReference!=`function`)throw new e.RefineConfigError(`createListboxDropdown: getReference is required`);let o=(0,i.signal)(!1),s=(0,i.computed)(()=>String(o.value)),c=null,l=t.createDropdownPositioner({...a.positioning,getFloating:a.getPanel,getReference:a.getReference}),u=()=>{a.getFocusedOptionElement?.()?.scrollIntoView({block:`nearest`})},d=n.createListControl({disabled:(0,i.computed)(()=>!o.value),getItemLabel:a.getItemLabel,getItems:a.getItems,isItemDisabled:a.isItemDisabled,keys:a.keys,loop:a.loop??!0,onNavigate:(e,t,n)=>{u(),t>=0&&a.onNavigate?.(e,t,n)},orientation:a.orientation,signal:a.signal}),f=(0,i.computed)(()=>{let e=d.focusedIndex.value;return a.getOptionId&&o.value&&e>=0?a.getOptionId(e):null}),p=()=>typeof a.restoreFocus==`function`?a.restoreFocus():a.restoreFocus??!0,m=(e=`programmatic`,t=!0)=>{o.value&&(o.value=!1,d.reset(),c?.(),c=null,t&&p()&&a.getTrigger&&r.restoreFocus(a.getTrigger),a.onClose?.(e))},h=(e=`programmatic`)=>{a.isDisabled?.()||o.value||(o.value=!0,l.update(),c=l.startAutoUpdate?.()??null,a.onOpen?.(e))};return r.createOutsidePointerDismissal({getTargets:()=>[a.getBoundary(),a.getPanel()],isActive:()=>o.value,onDismiss:()=>m(`outsideClick`),signal:a.signal}),a.signal.addEventListener(`abort`,()=>{o.value&&(o.value=!1,d.reset(),c?.(),c=null)},{once:!0}),{ariaActiveDescendant:f,ariaExpanded:s,close:m,focusedIndex:d.focusedIndex,getActiveItem:d.getActiveItem,handleKeydown:e=>o.value?e.key===`Escape`?(e.preventDefault(),m(`escape`),!0):d.handleKeydown(e):!1,isOpen:o,navigate:d.navigate,open:h,scrollFocusedIntoView:u,set:d.set,toggle:(e=`click`,t=`trigger`)=>{o.value?m(t):h(e)},updatePosition:l.update}};exports.createListboxDropdown=a;
+//# sourceMappingURL=option-list.cjs.map

package/dist/core/option-list.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"option-list.cjs","names":[],"sources":["../../src/core/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 {\n  createOutsidePointerDismissal,\n  restoreFocus,\n  type DropdownCloseReason,\n  type OverlayOpenReason,\n} from './overlay';\nimport { createDropdownPositioner, type DropdownPositionerOptions } from './positioner';\n\nexport type ListboxItem = object;\n\n/** Placement-only options for the listbox dropdown positioner. */\nexport type ListboxDropdownPlacementOptions = Omit<DropdownPositionerOptions, 'getFloating' | 'getReference'>;\n\nexport type ListboxDropdownOptions<T extends ListboxItem> = {\n  getBoundary: () => HTMLElement | null;\n  getFocusedOptionElement?: () => HTMLElement | null;\n  getItemLabel?: (item: T, index: number) => string;\n  getItems: () => T[];\n  getOptionId?: (index: number) => string;\n  getPanel: () => HTMLElement | null;\n  getReference: () => HTMLElement | null;\n  getTrigger?: () => HTMLElement | null;\n  isDisabled?: () => boolean;\n  isItemDisabled?: (item: T, index: number) => boolean;\n  keys?: Partial<Record<ListNavigationAction, string[]>>;\n  loop?: boolean;\n  onClose?: (reason: DropdownCloseReason) => void;\n  onNavigate?: (action: ListKeyAction, index: number, event?: KeyboardEvent) => void;\n  onOpen?: (reason: OverlayOpenReason) => void;\n  orientation?: 'both' | 'horizontal' | 'vertical';\n  positioning?: ListboxDropdownPlacementOptions;\n  restoreFocus?: boolean | (() => boolean);\n  signal: AbortSignal;\n};\n\nexport type ListboxDropdown<T extends ListboxItem> = {\n  readonly ariaActiveDescendant: Readable<string | null>;\n  readonly ariaExpanded: Readable<string>;\n  close(reason?: DropdownCloseReason): void;\n  readonly focusedIndex: Readable<number>;\n  getActiveItem(): T | undefined;\n  handleKeydown(event: KeyboardEvent): boolean;\n  readonly isOpen: Readable<boolean>;\n  navigate(action: ListNavigationAction): number;\n  open(reason?: OverlayOpenReason): void;\n  scrollFocusedIntoView(): void;\n  set(index: number): number;\n  toggle(openReason?: OverlayOpenReason, closeReason?: DropdownCloseReason): void;\n  updatePosition(): void;\n};\n\n/**\n * Internal listbox dropdown behavior for select and combobox. It owns only\n * listbox interactions; menu and other overlay families keep their own logic.\n */\nexport const createListboxDropdown = <T extends ListboxItem>(\n  options: ListboxDropdownOptions<T>,\n): ListboxDropdown<T> => {\n  if (typeof options.getBoundary !== 'function') {\n    throw new RefineConfigError('createListboxDropdown: getBoundary is required');\n  }\n\n  if (typeof options.getPanel !== 'function') {\n    throw new RefineConfigError('createListboxDropdown: getPanel is required');\n  }\n\n  if (typeof options.getReference !== 'function') {\n    throw new RefineConfigError('createListboxDropdown: getReference is required');\n  }\n\n  const isOpen = signal(false);\n  const ariaExpanded = computed(() => String(isOpen.value));\n  let stopPositioning: (() => void) | null = null;\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 index = list.focusedIndex.value;\n\n    return options.getOptionId && isOpen.value && index >= 0 ? options.getOptionId(index) : null;\n  });\n\n  const shouldRestoreFocus = (): boolean => {\n    return typeof options.restoreFocus === 'function' ? options.restoreFocus() : (options.restoreFocus ?? true);\n  };\n\n  const close = (reason: DropdownCloseReason = 'programmatic', shouldRestore = true): void => {\n    if (!isOpen.value) return;\n\n    isOpen.value = false;\n    list.reset();\n    stopPositioning?.();\n    stopPositioning = null;\n\n    if (shouldRestore && shouldRestoreFocus() && options.getTrigger) restoreFocus(options.getTrigger);\n\n    options.onClose?.(reason);\n  };\n\n  const open = (reason: OverlayOpenReason = 'programmatic'): void => {\n    if (options.isDisabled?.() || isOpen.value) return;\n\n    isOpen.value = true;\n    positioner.update();\n    stopPositioning = positioner.startAutoUpdate?.() ?? null;\n    options.onOpen?.(reason);\n  };\n\n  const toggle = (openReason: OverlayOpenReason = 'click', closeReason: DropdownCloseReason = 'trigger'): void => {\n    if (isOpen.value) close(closeReason);\n    else open(openReason);\n  };\n\n  createOutsidePointerDismissal({\n    getTargets: () => [options.getBoundary(), options.getPanel()],\n    isActive: () => isOpen.value,\n    onDismiss: () => close('outsideClick'),\n    signal: options.signal,\n  });\n\n  options.signal.addEventListener(\n    'abort',\n    () => {\n      if (!isOpen.value) return;\n\n      isOpen.value = false;\n      list.reset();\n      stopPositioning?.();\n      stopPositioning = null;\n    },\n    { once: true },\n  );\n\n  const handleKeydown = (event: KeyboardEvent): boolean => {\n    if (!isOpen.value) return false;\n\n    if (event.key === 'Escape') {\n      event.preventDefault();\n      close('escape');\n\n      return true;\n    }\n\n    return list.handleKeydown(event);\n  };\n\n  return {\n    ariaActiveDescendant,\n    ariaExpanded,\n    close,\n    focusedIndex: list.focusedIndex,\n    getActiveItem: list.getActiveItem,\n    handleKeydown,\n    isOpen,\n    navigate: list.navigate,\n    open,\n    scrollFocusedIntoView,\n    set: list.set,\n    toggle,\n    updatePosition: positioner.update,\n  };\n};\n"],"mappings":"mJA2DA,IAAa,EACX,GACuB,CACvB,GAAI,OAAO,EAAQ,aAAgB,WACjC,MAAM,IAAI,EAAA,kBAAkB,gDAAgD,EAG9E,GAAI,OAAO,EAAQ,UAAa,WAC9B,MAAM,IAAI,EAAA,kBAAkB,6CAA6C,EAG3E,GAAI,OAAO,EAAQ,cAAiB,WAClC,MAAM,IAAI,EAAA,kBAAkB,iDAAiD,EAG/E,IAAM,GAAA,EAAS,EAAA,OAAA,CAAO,EAAK,EACrB,GAAA,EAAe,EAAA,SAAA,KAAe,OAAO,EAAO,KAAK,CAAC,EACpD,EAAuC,KAErC,EAAa,EAAA,yBAAyB,CAC1C,GAAG,EAAQ,YACX,YAAa,EAAQ,SACrB,aAAc,EAAQ,YACxB,CAAC,EAEK,MAAoC,CACxC,EAAQ,0BAA0B,CAAC,EAAE,eAAe,CAAE,MAAO,SAAU,CAAC,CAC1E,EAEM,EAAO,EAAA,kBAAqB,CAChC,UAAA,EAAU,EAAA,SAAA,KAAe,CAAC,EAAO,KAAK,EACtC,aAAc,EAAQ,aACtB,SAAU,EAAQ,SAClB,eAAgB,EAAQ,eACxB,KAAM,EAAQ,KACd,KAAM,EAAQ,MAAQ,GACtB,YAAa,EAAQ,EAAO,IAAU,CACpC,EAAsB,EAElB,GAAS,GAAG,EAAQ,aAAa,EAAQ,EAAO,CAAK,CAC3D,EACA,YAAa,EAAQ,YACrB,OAAQ,EAAQ,MAClB,CAAC,EAEK,GAAA,EAAuB,EAAA,SAAA,KAA8B,CACzD,IAAM,EAAQ,EAAK,aAAa,MAEhC,OAAO,EAAQ,aAAe,EAAO,OAAS,GAAS,EAAI,EAAQ,YAAY,CAAK,EAAI,IAC1F,CAAC,EAEK,MACG,OAAO,EAAQ,cAAiB,WAAa,EAAQ,aAAa,EAAK,EAAQ,cAAgB,GAGlG,GAAS,EAA8B,eAAgB,EAAgB,KAAe,CACrF,EAAO,QAEZ,EAAO,MAAQ,GACf,EAAK,MAAM,EACX,IAAkB,EAClB,EAAkB,KAEd,GAAiB,EAAmB,GAAK,EAAQ,YAAY,EAAA,aAAa,EAAQ,UAAU,EAEhG,EAAQ,UAAU,CAAM,EAC1B,EAEM,GAAQ,EAA4B,iBAAyB,CAC7D,EAAQ,aAAa,GAAK,EAAO,QAErC,EAAO,MAAQ,GACf,EAAW,OAAO,EAClB,EAAkB,EAAW,kBAAkB,GAAK,KACpD,EAAQ,SAAS,CAAM,EACzB,EAwCA,OAjCA,EAAA,8BAA8B,CAC5B,eAAkB,CAAC,EAAQ,YAAY,EAAG,EAAQ,SAAS,CAAC,EAC5D,aAAgB,EAAO,MACvB,cAAiB,EAAM,cAAc,EACrC,OAAQ,EAAQ,MAClB,CAAC,EAED,EAAQ,OAAO,iBACb,YACM,CACC,EAAO,QAEZ,EAAO,MAAQ,GACf,EAAK,MAAM,EACX,IAAkB,EAClB,EAAkB,KACpB,EACA,CAAE,KAAM,EAAK,CACf,EAeO,CACL,uBACA,eACA,QACA,aAAc,EAAK,aACnB,cAAe,EAAK,cACpB,cAnBqB,GAChB,EAAO,MAER,EAAM,MAAQ,UAChB,EAAM,eAAe,EACrB,EAAM,QAAQ,EAEP,IAGF,EAAK,cAAc,CAAK,EATL,GAmB1B,SACA,SAAU,EAAK,SACf,OACA,wBACA,IAAK,EAAK,IACV,QAlDc,EAAgC,QAAS,EAAmC,YAAoB,CAC1G,EAAO,MAAO,EAAM,CAAW,EAC9B,EAAK,CAAU,CACtB,EAgDE,eAAgB,EAAW,MAC7B,CACF"}

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

@@ -0,0 +1,49 @@
+import { type Readable } from '@vielzeug/ripple';
+import { type ListKeyAction, type ListNavigationAction } from './nav';
+import { type DropdownCloseReason, type OverlayOpenReason } from './overlay';
+import { type DropdownPositionerOptions } from './positioner';
+export type ListboxItem = object;
+/** Placement-only options for the listbox dropdown positioner. */
+export type ListboxDropdownPlacementOptions = Omit<DropdownPositionerOptions, 'getFloating' | 'getReference'>;
+export type ListboxDropdownOptions<T extends ListboxItem> = {
+    getBoundary: () => HTMLElement | null;
+    getFocusedOptionElement?: () => HTMLElement | null;
+    getItemLabel?: (item: T, index: number) => string;
+    getItems: () => T[];
+    getOptionId?: (index: number) => string;
+    getPanel: () => HTMLElement | null;
+    getReference: () => HTMLElement | null;
+    getTrigger?: () => HTMLElement | null;
+    isDisabled?: () => boolean;
+    isItemDisabled?: (item: T, index: number) => boolean;
+    keys?: Partial<Record<ListNavigationAction, string[]>>;
+    loop?: boolean;
+    onClose?: (reason: DropdownCloseReason) => void;
+    onNavigate?: (action: ListKeyAction, index: number, event?: KeyboardEvent) => void;
+    onOpen?: (reason: OverlayOpenReason) => void;
+    orientation?: 'both' | 'horizontal' | 'vertical';
+    positioning?: ListboxDropdownPlacementOptions;
+    restoreFocus?: boolean | (() => boolean);
+    signal: AbortSignal;
+};
+export type ListboxDropdown<T extends ListboxItem> = {
+    readonly ariaActiveDescendant: Readable<string | null>;
+    readonly ariaExpanded: Readable<string>;
+    close(reason?: DropdownCloseReason): void;
+    readonly focusedIndex: Readable<number>;
+    getActiveItem(): T | undefined;
+    handleKeydown(event: KeyboardEvent): boolean;
+    readonly isOpen: Readable<boolean>;
+    navigate(action: ListNavigationAction): number;
+    open(reason?: OverlayOpenReason): void;
+    scrollFocusedIntoView(): void;
+    set(index: number): number;
+    toggle(openReason?: OverlayOpenReason, closeReason?: DropdownCloseReason): void;
+    updatePosition(): void;
+};
+/**
+ * Internal listbox dropdown behavior for select and combobox. It owns only
+ * listbox interactions; menu and other overlay families keep their own logic.
+ */
+export declare const createListboxDropdown: <T extends ListboxItem>(options: ListboxDropdownOptions<T>) => ListboxDropdown<T>;
+//# sourceMappingURL=option-list.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"option-list.d.ts","sourceRoot":"","sources":["../../src/core/option-list.ts"],"names":[],"mappings":"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"}

package/dist/core/option-list.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"option-list.js","names":[],"sources":["../../src/core/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 {\n  createOutsidePointerDismissal,\n  restoreFocus,\n  type DropdownCloseReason,\n  type OverlayOpenReason,\n} from './overlay';\nimport { createDropdownPositioner, type DropdownPositionerOptions } from './positioner';\n\nexport type ListboxItem = object;\n\n/** Placement-only options for the listbox dropdown positioner. */\nexport type ListboxDropdownPlacementOptions = Omit<DropdownPositionerOptions, 'getFloating' | 'getReference'>;\n\nexport type ListboxDropdownOptions<T extends ListboxItem> = {\n  getBoundary: () => HTMLElement | null;\n  getFocusedOptionElement?: () => HTMLElement | null;\n  getItemLabel?: (item: T, index: number) => string;\n  getItems: () => T[];\n  getOptionId?: (index: number) => string;\n  getPanel: () => HTMLElement | null;\n  getReference: () => HTMLElement | null;\n  getTrigger?: () => HTMLElement | null;\n  isDisabled?: () => boolean;\n  isItemDisabled?: (item: T, index: number) => boolean;\n  keys?: Partial<Record<ListNavigationAction, string[]>>;\n  loop?: boolean;\n  onClose?: (reason: DropdownCloseReason) => void;\n  onNavigate?: (action: ListKeyAction, index: number, event?: KeyboardEvent) => void;\n  onOpen?: (reason: OverlayOpenReason) => void;\n  orientation?: 'both' | 'horizontal' | 'vertical';\n  positioning?: ListboxDropdownPlacementOptions;\n  restoreFocus?: boolean | (() => boolean);\n  signal: AbortSignal;\n};\n\nexport type ListboxDropdown<T extends ListboxItem> = {\n  readonly ariaActiveDescendant: Readable<string | null>;\n  readonly ariaExpanded: Readable<string>;\n  close(reason?: DropdownCloseReason): void;\n  readonly focusedIndex: Readable<number>;\n  getActiveItem(): T | undefined;\n  handleKeydown(event: KeyboardEvent): boolean;\n  readonly isOpen: Readable<boolean>;\n  navigate(action: ListNavigationAction): number;\n  open(reason?: OverlayOpenReason): void;\n  scrollFocusedIntoView(): void;\n  set(index: number): number;\n  toggle(openReason?: OverlayOpenReason, closeReason?: DropdownCloseReason): void;\n  updatePosition(): void;\n};\n\n/**\n * Internal listbox dropdown behavior for select and combobox. It owns only\n * listbox interactions; menu and other overlay families keep their own logic.\n */\nexport const createListboxDropdown = <T extends ListboxItem>(\n  options: ListboxDropdownOptions<T>,\n): ListboxDropdown<T> => {\n  if (typeof options.getBoundary !== 'function') {\n    throw new RefineConfigError('createListboxDropdown: getBoundary is required');\n  }\n\n  if (typeof options.getPanel !== 'function') {\n    throw new RefineConfigError('createListboxDropdown: getPanel is required');\n  }\n\n  if (typeof options.getReference !== 'function') {\n    throw new RefineConfigError('createListboxDropdown: getReference is required');\n  }\n\n  const isOpen = signal(false);\n  const ariaExpanded = computed(() => String(isOpen.value));\n  let stopPositioning: (() => void) | null = null;\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 index = list.focusedIndex.value;\n\n    return options.getOptionId && isOpen.value && index >= 0 ? options.getOptionId(index) : null;\n  });\n\n  const shouldRestoreFocus = (): boolean => {\n    return typeof options.restoreFocus === 'function' ? options.restoreFocus() : (options.restoreFocus ?? true);\n  };\n\n  const close = (reason: DropdownCloseReason = 'programmatic', shouldRestore = true): void => {\n    if (!isOpen.value) return;\n\n    isOpen.value = false;\n    list.reset();\n    stopPositioning?.();\n    stopPositioning = null;\n\n    if (shouldRestore && shouldRestoreFocus() && options.getTrigger) restoreFocus(options.getTrigger);\n\n    options.onClose?.(reason);\n  };\n\n  const open = (reason: OverlayOpenReason = 'programmatic'): void => {\n    if (options.isDisabled?.() || isOpen.value) return;\n\n    isOpen.value = true;\n    positioner.update();\n    stopPositioning = positioner.startAutoUpdate?.() ?? null;\n    options.onOpen?.(reason);\n  };\n\n  const toggle = (openReason: OverlayOpenReason = 'click', closeReason: DropdownCloseReason = 'trigger'): void => {\n    if (isOpen.value) close(closeReason);\n    else open(openReason);\n  };\n\n  createOutsidePointerDismissal({\n    getTargets: () => [options.getBoundary(), options.getPanel()],\n    isActive: () => isOpen.value,\n    onDismiss: () => close('outsideClick'),\n    signal: options.signal,\n  });\n\n  options.signal.addEventListener(\n    'abort',\n    () => {\n      if (!isOpen.value) return;\n\n      isOpen.value = false;\n      list.reset();\n      stopPositioning?.();\n      stopPositioning = null;\n    },\n    { once: true },\n  );\n\n  const handleKeydown = (event: KeyboardEvent): boolean => {\n    if (!isOpen.value) return false;\n\n    if (event.key === 'Escape') {\n      event.preventDefault();\n      close('escape');\n\n      return true;\n    }\n\n    return list.handleKeydown(event);\n  };\n\n  return {\n    ariaActiveDescendant,\n    ariaExpanded,\n    close,\n    focusedIndex: list.focusedIndex,\n    getActiveItem: list.getActiveItem,\n    handleKeydown,\n    isOpen,\n    navigate: list.navigate,\n    open,\n    scrollFocusedIntoView,\n    set: list.set,\n    toggle,\n    updatePosition: positioner.update,\n  };\n};\n"],"mappings":";;;;;;AA2DA,IAAa,KACX,MACuB;CACvB,IAAI,OAAO,EAAQ,eAAgB,YACjC,MAAM,IAAI,EAAkB,gDAAgD;CAG9E,IAAI,OAAO,EAAQ,YAAa,YAC9B,MAAM,IAAI,EAAkB,6CAA6C;CAG3E,IAAI,OAAO,EAAQ,gBAAiB,YAClC,MAAM,IAAI,EAAkB,iDAAiD;CAG/E,IAAM,IAAS,EAAO,EAAK,GACrB,IAAe,QAAe,OAAO,EAAO,KAAK,CAAC,GACpD,IAAuC,MAErC,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,IAAQ,EAAK,aAAa;EAEhC,OAAO,EAAQ,eAAe,EAAO,SAAS,KAAS,IAAI,EAAQ,YAAY,CAAK,IAAI;CAC1F,CAAC,GAEK,UACG,OAAO,EAAQ,gBAAiB,aAAa,EAAQ,aAAa,IAAK,EAAQ,gBAAgB,IAGlG,KAAS,IAA8B,gBAAgB,IAAgB,OAAe;EACrF,EAAO,UAEZ,EAAO,QAAQ,IACf,EAAK,MAAM,GACX,IAAkB,GAClB,IAAkB,MAEd,KAAiB,EAAmB,KAAK,EAAQ,cAAY,EAAa,EAAQ,UAAU,GAEhG,EAAQ,UAAU,CAAM;CAC1B,GAEM,KAAQ,IAA4B,mBAAyB;EAC7D,EAAQ,aAAa,KAAK,EAAO,UAErC,EAAO,QAAQ,IACf,EAAW,OAAO,GAClB,IAAkB,EAAW,kBAAkB,KAAK,MACpD,EAAQ,SAAS,CAAM;CACzB;CAwCA,OAjCA,EAA8B;EAC5B,kBAAkB,CAAC,EAAQ,YAAY,GAAG,EAAQ,SAAS,CAAC;EAC5D,gBAAgB,EAAO;EACvB,iBAAiB,EAAM,cAAc;EACrC,QAAQ,EAAQ;CAClB,CAAC,GAED,EAAQ,OAAO,iBACb,eACM;EACC,EAAO,UAEZ,EAAO,QAAQ,IACf,EAAK,MAAM,GACX,IAAkB,GAClB,IAAkB;CACpB,GACA,EAAE,MAAM,GAAK,CACf,GAeO;EACL;EACA;EACA;EACA,cAAc,EAAK;EACnB,eAAe,EAAK;EACpB,gBAnBqB,MAChB,EAAO,QAER,EAAM,QAAQ,YAChB,EAAM,eAAe,GACrB,EAAM,QAAQ,GAEP,MAGF,EAAK,cAAc,CAAK,IATL;EAmB1B;EACA,UAAU,EAAK;EACf;EACA;EACA,KAAK,EAAK;EACV,SAlDc,IAAgC,SAAS,IAAmC,cAAoB;GAC9G,AAAI,EAAO,QAAO,EAAM,CAAW,IAC9B,EAAK,CAAU;EACtB;EAgDE,gBAAgB,EAAW;CAC7B;AACF"}

package/dist/core/ore.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ore.cjs","names":[],"sources":["../../src/core/ore.ts"],"sourcesContent":["// ── Ore adapter ─────────────────────────────────────────────────────────────\n// Utilities that bridge Ore's component lifecycle with Refine's core\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 core primitive\n * (`createTextField`, `createCheckable`, `createListboxDropdown`, 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 → core}/ore.d.ts

@@ -2,8 +2,8 @@
  * 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.).
+ * as the required `signal` option to any stateful core primitive
+ * (`createTextField`, `createCheckable`, `createListboxDropdown`, etc.).
  *
  * When Ore disconnects the component, `onCleanup` fires, aborting the
  * signal and triggering cleanup in every primitive that received it.

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

@@ -0,0 +1 @@
+{"version":3,"file":"ore.d.ts","sourceRoot":"","sources":["../../src/core/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 → core}/ore.js

@@ -1,4 +1,4 @@
-//#region src/headless/ore.ts
+//#region src/core/ore.ts
 var e = (e) => {
 	let t = new AbortController();
 	return e(() => t.abort()), t.signal;

package/dist/core/ore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ore.js","names":[],"sources":["../../src/core/ore.ts"],"sourcesContent":["// ── Ore adapter ─────────────────────────────────────────────────────────────\n// Utilities that bridge Ore's component lifecycle with Refine's core\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 core primitive\n * (`createTextField`, `createCheckable`, `createListboxDropdown`, 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/core/overlay.cjs

@@ -0,0 +1,2 @@
+var e=e=>{let t=t=>{if(!e.isActive())return;let n=t.composedPath(),r=n[0]instanceof Node?n[0]:t.target instanceof Node?t.target:null;e.getTargets().some(e=>e!=null&&(n.includes(e)||!!(r&&e.contains(r))))||e.onDismiss()},n=()=>{document.removeEventListener(`pointerdown`,t,{capture:!0})};return document.addEventListener(`pointerdown`,t,{capture:!0}),e.signal.addEventListener(`abort`,n,{once:!0}),n},t=e=>{e()?.focus()};exports.createOutsidePointerDismissal=e,exports.restoreFocus=t;
+//# sourceMappingURL=overlay.cjs.map

package/dist/core/overlay.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlay.cjs","names":[],"sources":["../../src/core/overlay.ts"],"sourcesContent":["/**\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/** Detail shape for state changes emitted by overlay components. */\nexport type OverlayOpenChangeDetail = {\n  open: boolean;\n  reason: DialogCloseReason | OverlayOpenReason;\n};\n\nexport type OutsidePointerDismissalOptions = {\n  getTargets: () => Array<Element | null | undefined>;\n  isActive: () => boolean;\n  onDismiss: () => void;\n  signal: AbortSignal;\n};\n\n/**\n * Dismisses an active floating surface when a pointer begins outside all of its\n * supplied boundary elements. Components retain ownership of their open state.\n */\nexport const createOutsidePointerDismissal = (options: OutsidePointerDismissalOptions): (() => void) => {\n  const onPointerDown = (event: PointerEvent): void => {\n    if (!options.isActive()) return;\n\n    const path = event.composedPath();\n    const target = path[0] instanceof Node ? path[0] : event.target instanceof Node ? event.target : null;\n    const inside = options.getTargets().some((element) => {\n      return (\n        element !== null &&\n        element !== undefined &&\n        (path.includes(element) || Boolean(target && element.contains(target)))\n      );\n    });\n\n    if (!inside) options.onDismiss();\n  };\n\n  const dispose = (): void => {\n    document.removeEventListener('pointerdown', onPointerDown, { capture: true });\n  };\n\n  document.addEventListener('pointerdown', onPointerDown, { capture: true });\n  options.signal.addEventListener('abort', dispose, { once: true });\n\n  return dispose;\n};\n\n/** Restores focus to a trigger when the owning overlay chooses to do so. */\nexport const restoreFocus = (getTrigger: () => HTMLElement | null | undefined): void => {\n  getTrigger()?.focus();\n};\n"],"mappings":"AAqCA,IAAa,EAAiC,GAA0D,CACtG,IAAM,EAAiB,GAA8B,CACnD,GAAI,CAAC,EAAQ,SAAS,EAAG,OAEzB,IAAM,EAAO,EAAM,aAAa,EAC1B,EAAS,EAAK,aAAc,KAAO,EAAK,GAAK,EAAM,kBAAkB,KAAO,EAAM,OAAS,KAClF,EAAQ,WAAW,CAAC,CAAC,KAAM,GAEtC,GAAY,OAEX,EAAK,SAAS,CAAO,GAAK,GAAQ,GAAU,EAAQ,SAAS,CAAM,GAInE,GAAQ,EAAQ,UAAU,CACjC,EAEM,MAAsB,CAC1B,SAAS,oBAAoB,cAAe,EAAe,CAAE,QAAS,EAAK,CAAC,CAC9E,EAKA,OAHA,SAAS,iBAAiB,cAAe,EAAe,CAAE,QAAS,EAAK,CAAC,EACzE,EAAQ,OAAO,iBAAiB,QAAS,EAAS,CAAE,KAAM,EAAK,CAAC,EAEzD,CACT,EAGa,EAAgB,GAA2D,CACtF,EAAW,CAAC,EAAE,MAAM,CACtB"}

package/dist/core/overlay.d.ts

@@ -0,0 +1,41 @@
+/**
+ * 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;
+};
+/** Detail shape for state changes emitted by overlay components. */
+export type OverlayOpenChangeDetail = {
+    open: boolean;
+    reason: DialogCloseReason | OverlayOpenReason;
+};
+export type OutsidePointerDismissalOptions = {
+    getTargets: () => Array<Element | null | undefined>;
+    isActive: () => boolean;
+    onDismiss: () => void;
+    signal: AbortSignal;
+};
+/**
+ * Dismisses an active floating surface when a pointer begins outside all of its
+ * supplied boundary elements. Components retain ownership of their open state.
+ */
+export declare const createOutsidePointerDismissal: (options: OutsidePointerDismissalOptions) => (() => void);
+/** Restores focus to a trigger when the owning overlay chooses to do so. */
+export declare const restoreFocus: (getTrigger: () => HTMLElement | null | undefined) => void;
+//# sourceMappingURL=overlay.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"overlay.d.ts","sourceRoot":"","sources":["../../src/core/overlay.ts"],"names":[],"mappings":"AAAA;;;;;;;;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;AAC/D,oEAAoE;AACpE,MAAM,MAAM,uBAAuB,GAAG;IACpC,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,iBAAiB,GAAG,iBAAiB,CAAC;CAC/C,CAAC;AAEF,MAAM,MAAM,8BAA8B,GAAG;IAC3C,UAAU,EAAE,MAAM,KAAK,CAAC,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;IACpD,QAAQ,EAAE,MAAM,OAAO,CAAC;IACxB,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,MAAM,EAAE,WAAW,CAAC;CACrB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,6BAA6B,GAAI,SAAS,8BAA8B,KAAG,CAAC,MAAM,IAAI,CAyBlG,CAAC;AAEF,4EAA4E;AAC5E,eAAO,MAAM,YAAY,GAAI,YAAY,MAAM,WAAW,GAAG,IAAI,GAAG,SAAS,KAAG,IAE/E,CAAC"}

package/dist/core/overlay.js

@@ -0,0 +1,17 @@
+//#region src/core/overlay.ts
+var e = (e) => {
+	let t = (t) => {
+		if (!e.isActive()) return;
+		let n = t.composedPath(), r = n[0] instanceof Node ? n[0] : t.target instanceof Node ? t.target : null;
+		e.getTargets().some((e) => e != null && (n.includes(e) || !!(r && e.contains(r)))) || e.onDismiss();
+	}, n = () => {
+		document.removeEventListener("pointerdown", t, { capture: !0 });
+	};
+	return document.addEventListener("pointerdown", t, { capture: !0 }), e.signal.addEventListener("abort", n, { once: !0 }), n;
+}, t = (e) => {
+	e()?.focus();
+};
+//#endregion
+export { e as createOutsidePointerDismissal, t as restoreFocus };
+
+//# sourceMappingURL=overlay.js.map