@vielzeug/refine 1.1.1

package/dist/headless/keyboard.js

@@ -0,0 +1,29 @@
+//#region src/headless/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;
+	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
+		})
+	};
+};
+//#endregion
+export { t as createInteraction, e as dispatchKeyboardAction };
+
+//# sourceMappingURL=keyboard.js.map

package/dist/headless/keyboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyboard.js","names":[],"sources":["../../src/headless/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,MACR,EAAW,IAAU,MAEzB,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/headless/light-dom.cjs

@@ -0,0 +1,2 @@
+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;exports.getChoiceLabel=t,exports.getLightChildrenByTag=e;
+//# sourceMappingURL=light-dom.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"light-dom.cjs","names":[],"sources":["../../src/headless/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/headless/light-dom.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Returns all light-DOM descendants matching `tag` inside `host`.
+ * Uses `getElementsByTagName` on the host's light DOM \u2014 not Shadow DOM slot assignment.
+ */
+export declare const getLightChildrenByTag: (host: HTMLElement, tag: string) => HTMLElement[];
+/**
+ * Returns the `textContent` of the item whose `value` attribute matches `value`,
+ * falling back to `value` itself when no match is found.
+ * Used by choice-field components to derive labels for emitted change events.
+ */
+export declare const getChoiceLabel: (items: HTMLElement[], value: string) => string;
+//# sourceMappingURL=light-dom.d.ts.map

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

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

@@ -0,0 +1,6 @@
+//#region src/headless/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 };
+
+//# sourceMappingURL=light-dom.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"light-dom.js","names":[],"sources":["../../src/headless/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/headless/nav.cjs

@@ -0,0 +1,2 @@
+const e=require("./keyboard.cjs"),t=require("./typeahead.cjs");let n=require("@vielzeug/ripple");var r=(e,t,n)=>{for(let r=t;r<e.length;r++)if(n(e[r],r))return r;return-1},i=(e,t,n)=>{for(let r=t;r>=0;r--)if(n(e[r],r))return r;return-1},a={both:{first:[`Home`],last:[`End`],next:[`ArrowDown`,`ArrowRight`],prev:[`ArrowUp`,`ArrowLeft`]},horizontal:{first:[`Home`],last:[`End`],next:[`ArrowRight`],prev:[`ArrowLeft`]},vertical:{first:[`Home`],last:[`End`],next:[`ArrowDown`],prev:[`ArrowUp`]}},o=e=>typeof e==`object`&&!!e&&`disabled`in e,s=s=>{let c=(0,n.signal)(-1),l=(e,t)=>s.isItemDisabled?.(e,t)??(o(e)?e.disabled:!1),u=(e,t,n)=>(e>=0&&(c.value=e,s.onNavigate?.(t,e,n)),e),d=(e,t,n)=>n===`forward`?r(e,t,(e,t)=>!l(e,t)):i(e,t,(e,t)=>!l(e,t)),f=e=>{if(e<0)return g(),-1;let t=s.getItems();if(!t.length)return-1;let n=Math.min(e,t.length-1);return l(t[n],n)?-1:(c.value=n,n)},p=(e,t)=>{let n=s.getItems(),r=c.value;if(!n.length)return-1;let i=r<0?e===`forward`?0:n.length-1:e===`forward`?r+1:r-1,a=d(n,i,e),o=e===`forward`?`next`:`prev`;if(a>=0)return u(a,o,t);if(s.loop){let r=e===`forward`?0:n.length-1,i=d(n,r,e);if(i>=0)return u(i,o,t)}return r},m=e=>{let t=s.getItems();if(!t.length)return-1;if(e===`first`){let e=d(t,0,`forward`);return u(e,`first`)}if(e===`last`){let e=d(t,t.length-1,`backward`);return u(e,`last`)}return p(e===`next`?`forward`:`backward`)},h=()=>{let e=s.getItems(),t=c.value;return t>=0&&t<e.length?e[t]:void 0},g=()=>{c.value=-1},_=()=>!!s.disabled?.value,v=()=>typeof s.orientation==`function`?s.orientation():s.orientation??`vertical`,y=()=>{let e=s.keys,t=a[v()],n={first:e?.first??t.first,last:e?.last??t.last,next:e?.next??t.next,prev:e?.prev??t.prev},r={};for(let e of[`next`,`prev`,`first`,`last`])for(let t of n[e])r[t]=t=>{if(e===`first`||e===`last`){let n=s.getItems();if(!n.length)return;let r=e===`first`?d(n,0,`forward`):d(n,n.length-1,`backward`);u(r,e,t)}else p(e===`next`?`forward`:`backward`,t)};return r},b=s.getItemLabel?t.createTypeahead({getIndex:()=>c.value,getItemLabel:s.getItemLabel,getItems:s.getItems,isItemDisabled:(e,t)=>l(e,t),onNavigate:(e,t)=>{_()||(c.value=e,s.onNavigate?.(`typeahead`,e,t))}}):null,x=typeof s.orientation==`function`?null:y(),S=t=>{let n=x??y();return e.dispatchKeyboardAction(t,{disabled:s.disabled,keymap:n})?!0:b?.handleKeydown(t)??!1},C=()=>{b?.reset()};return s.signal&&s.signal.addEventListener(`abort`,C,{once:!0}),{focusedIndex:c,getActiveItem:h,handleKeydown:S,navigate:m,reset:g,set:f,[Symbol.dispose]:C}};exports.createListControl=s;
+//# sourceMappingURL=nav.cjs.map

package/dist/headless/nav.cjs.map

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

package/dist/headless/nav.d.ts

@@ -0,0 +1,66 @@
+import { type Readable } from '@vielzeug/ripple';
+/**
+ * Arrow-key and Home/End navigation actions. Separate from `ListKeyAction` so
+ * keymap declarations never need `Exclude<ListKeyAction, 'typeahead'>`.
+ */
+export type ListNavigationAction = 'first' | 'last' | 'next' | 'prev';
+/**
+ * All possible navigation action names, including `'typeahead'` (character-key
+ * search). Used in `onNavigate` callbacks where both nav and typeahead are valid.
+ */
+export type ListKeyAction = ListNavigationAction | 'typeahead';
+export type ListNavigationOptions<T> = {
+    disabled?: Readable<boolean | undefined>;
+    /**
+     * Returns a plain-text label for an item used by typeahead search.
+     * When provided, pressing a printable character key jumps to the first enabled
+     * item whose label starts with the accumulated type buffer (500 ms reset window).
+     * Omit for contexts where the host element is a text input (e.g. combobox).
+     */
+    getItemLabel?: (item: T, index: number) => string;
+    getItems: () => T[];
+    isItemDisabled?: (item: T, index: number) => boolean;
+    /** Override default key bindings for navigation actions. */
+    keys?: Partial<Record<ListNavigationAction, string[]>>;
+    loop?: boolean;
+    /**
+     * Called when navigation lands on a new index.
+     * `event` is the originating `KeyboardEvent`, or `undefined` for programmatic navigation.
+     * Use to sync side-effects such as focusing a DOM element.
+     */
+    onNavigate?: (action: ListKeyAction, index: number, event?: KeyboardEvent) => void;
+    /**
+     * Axis the list navigates along. Controls which arrow keys are treated as
+     * `next`/`prev` when no explicit `keys` override is provided.
+     * Pass a getter function for dynamic/reactive orientation (e.g. driven by a prop signal).
+     *
+     * - `'vertical'` (default): ↑↓ arrows
+     * - `'horizontal'`: ←→ arrows
+     * - `'both'`: all four arrow keys
+     */
+    orientation?: 'both' | 'horizontal' | 'vertical' | (() => 'both' | 'horizontal' | 'vertical');
+    /** `AbortSignal` from the component lifecycle. Disposes typeahead timer on abort. */
+    signal?: AbortSignal;
+};
+export type ListControl<T> = {
+    [Symbol.dispose](): void;
+    /** Current focused index. `-1` when nothing is focused. */
+    readonly focusedIndex: Readable<number>;
+    getActiveItem(): T | undefined;
+    handleKeydown(event: KeyboardEvent): boolean;
+    /**
+     * Programmatically navigate to a named position.
+     * Always fires `onNavigate` — consistent with keyboard navigation.
+     * Returns the resolved index, or `-1` if no enabled item was found.
+     */
+    navigate(action: ListNavigationAction): number;
+    /** Reset focused index to `-1`. */
+    reset(): void;
+    /**
+     * Set focus to the item at `index`. Returns the resolved index.
+     * Pass a negative index to clear focus (same as `reset()`).
+     */
+    set(index: number): number;
+};
+export declare const createListControl: <T>(options: ListNavigationOptions<T>) => ListControl<T>;
+//# sourceMappingURL=nav.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"nav.d.ts","sourceRoot":"","sources":["../../src/headless/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;AAc/D,MAAM,MAAM,qBAAqB,CAAC,CAAC,IAAI;IACrC,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,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,CA4LrF,CAAC"}

package/dist/headless/nav.js

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

package/dist/headless/nav.js.map

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

package/dist/headless/numbers.cjs

@@ -0,0 +1,2 @@
+var e=e=>{let t=Number(e);return Number.isFinite(t)?t:void 0},t=(t,n)=>e(t)??n,n=(e,n)=>Math.abs(t(e,n))||n;exports.toFiniteNumber=e,exports.toFiniteNumberOr=t,exports.toPositiveStep=n;
+//# sourceMappingURL=numbers.cjs.map

package/dist/headless/numbers.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"numbers.cjs","names":[],"sources":["../../src/headless/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/headless/numbers.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Coerces `value` via `Number()` and returns it when finite, `undefined` otherwise.
+ *
+ * Caveat: `null` and `''` both coerce to `0` in JavaScript (`Number(null) === 0`,
+ * `Number('') === 0`) and are therefore returned as the finite number `0`, not
+ * `undefined` — this function does not treat "absent" values specially. Only
+ * genuinely non-numeric input (`undefined`, `NaN`, non-numeric strings) yields
+ * `undefined`. Callers that mean "no bound set" should pass `undefined`
+ * explicitly rather than `null` or `''`.
+ */
+export declare const toFiniteNumber: (value: unknown) => number | undefined;
+export declare const toFiniteNumberOr: (value: unknown, fallback: number) => number;
+export declare const toPositiveStep: (value: unknown, fallback: number) => number;
+//# sourceMappingURL=numbers.d.ts.map

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

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

@@ -0,0 +1,9 @@
+//#region src/headless/numbers.ts
+var e = (e) => {
+	let t = Number(e);
+	return Number.isFinite(t) ? t : void 0;
+}, t = (t, n) => e(t) ?? n, n = (e, n) => Math.abs(t(e, n)) || n;
+//#endregion
+export { e as toFiniteNumber, t as toFiniteNumberOr, n as toPositiveStep };
+
+//# sourceMappingURL=numbers.js.map

package/dist/headless/numbers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"numbers.js","names":[],"sources":["../../src/headless/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/headless/option-list.cjs

@@ -0,0 +1,2 @@
+const e=require("../errors.cjs"),t=require("./nav.cjs"),n=require("./overlay.cjs"),r=require("./positioner.cjs");let i=require("@vielzeug/ripple");var a=a=>{if(typeof a.getBoundary!=`function`)throw new e.RefineConfigError(`createOptionList: getBoundary is required`);if(typeof a.getPanel!=`function`)throw new e.RefineConfigError(`createOptionList: getPanel is required`);if(typeof a.getReference!=`function`)throw new e.RefineConfigError(`createOptionList: getReference is required`);let o=(0,i.signal)(!1),s=(0,i.computed)(()=>String(o.value)),c=r.createDropdownPositioner({...a.positioning,getFloating:a.getPanel,getReference:a.getReference}),l=()=>{a.getFocusedOptionElement?.()?.scrollIntoView({block:`nearest`})},u=t.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)=>{l(),t>=0&&a.onNavigate?.(e,t,n)},orientation:a.orientation,signal:a.signal}),d=(0,i.computed)(()=>{let e=u.focusedIndex.value;return a.getOptionId&&o.value&&e>=0?a.getOptionId(e):null}),f=n.createOverlayControl({getBoundary:a.getBoundary,getPanel:a.getPanel,getTrigger:a.getTrigger,isDisabled:a.isDisabled,isOpen:()=>o.value,onClose:a.onClose,onOpen:a.onOpen,positioner:c,restoreFocus:a.restoreFocus,setOpen:e=>{o.value=e,e||u.reset()},signal:a.signal});return{ariaActiveDescendant:d,ariaExpanded:s,close:e=>f.close(e),focusedIndex:u.focusedIndex,getActiveItem:u.getActiveItem,handleKeydown:e=>o.value?e.key===`Escape`?(e.preventDefault(),f.close(`escape`),!0):u.handleKeydown(e):!1,isOpen:o,navigate:u.navigate,open:e=>f.open(e),scrollFocusedIntoView:l,set:u.set,toggle:(e,t)=>f.toggle(e,t),updatePosition:c.update}};exports.createOptionList=a;
+//# sourceMappingURL=option-list.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"option-list.cjs","names":[],"sources":["../../src/headless/option-list.ts"],"sourcesContent":["import { computed, type Readable, signal } from '@vielzeug/ripple';\n\nimport { RefineConfigError } from '../errors';\nimport { createListControl, type ListKeyAction, type ListNavigationAction } from './nav';\nimport { createOverlayControl, type DialogCloseReason, type OverlayOpenReason } from './overlay';\nimport { createDropdownPositioner, type DropdownPositionerOptions } from './positioner';\n\n// ── Types ─────────────────────────────────────────────────────────────────────\n\nexport type BaseOptionItem = object;\n\n/** Placement-only options for the dropdown positioner (getFloating/getReference are injected from the option-list). */\nexport type PlacementOptions = Omit<DropdownPositionerOptions, 'getFloating' | 'getReference'>;\n\nexport type OptionListOptions<T extends BaseOptionItem> = {\n  /** Returns the element used as the outside-click boundary. */\n  getBoundary: () => HTMLElement | null;\n  /**\n   * Returns the currently focused option element for scroll-into-view.\n   * When omitted, `scrollFocusedIntoView()` is a no-op.\n   */\n  getFocusedOptionElement?: () => HTMLElement | null;\n  /**\n   * Returns a plain-text label for the item at `index`.\n   * When provided, the list control supports typeahead.\n   */\n  getItemLabel?: (item: T, index: number) => string;\n  /** Returns the current list items. */\n  getItems: () => T[];\n  /**\n   * Derives a stable `id` for the option at `index`.\n   * When provided, `aria-activedescendant` is reactively set on the trigger element\n   * to reflect the currently focused option (WAI-ARIA listbox / combobox pattern).\n   */\n  getOptionId?: (index: number) => string;\n  /** Returns the floating panel element. */\n  getPanel: () => HTMLElement | null;\n  /** Returns the reference (trigger anchor) element for positioning. */\n  getReference: () => HTMLElement | null;\n  /** Returns the trigger element. Focus is restored here on close. */\n  getTrigger?: () => HTMLElement | null;\n  /** Returns `true` when all interactions should be suppressed (e.g. the host is disabled). */\n  isDisabled?: () => boolean;\n  isItemDisabled?: (item: T, index: number) => boolean;\n  /** Override default keyboard bindings for navigation actions. */\n  keys?: Partial<Record<ListNavigationAction, string[]>>;\n  /** Whether list navigation wraps around at the first/last item. Default: `true`. */\n  loop?: boolean;\n  /** Called when the list closes. */\n  onClose?: (reason: DialogCloseReason) => void;\n  /**\n   * Called when keyboard navigation lands on an item.\n   * `event` is the originating `KeyboardEvent`, or `undefined` for programmatic navigation.\n   */\n  onNavigate?: (action: ListKeyAction, index: number, event?: KeyboardEvent) => void;\n  /** Called when the list opens. */\n  onOpen?: (reason: OverlayOpenReason) => void;\n  /**\n   * Restricts keyboard navigation direction for the option list.\n   * Defaults to `'vertical'` when omitted (up/down arrow keys).\n   */\n  orientation?: 'both' | 'horizontal' | 'vertical';\n  /** Placement and sizing options for the floating dropdown. */\n  positioning?: PlacementOptions;\n  /** Whether focus is restored to the trigger on close. Default: inferred from `restoreFocus`. */\n  restoreFocus?: boolean | (() => boolean);\n  /** `AbortSignal` from the component lifecycle. Disposes subscriptions and removes event listeners on abort. */\n  signal: AbortSignal;\n};\n\nexport type OptionListHandle<T extends BaseOptionItem> = {\n  /** Reactive `aria-activedescendant` value. `null` when no option is focused or the list is closed. */\n  readonly ariaActiveDescendant: Readable<string | null>;\n  /** Reactive `aria-expanded` value as string (`'true'` / `'false'`). */\n  readonly ariaExpanded: Readable<string>;\n  close(reason?: DialogCloseReason): void;\n  /**\n   * Focused item index (read-only). Write via `set(index)` to update through\n   * the list control — this ensures scroll-into-view and disabled-item checks.\n   */\n  readonly focusedIndex: Readable<number>;\n  getActiveItem(): T | undefined;\n  handleKeydown(event: KeyboardEvent): boolean;\n  /** Open state (read-only). Mutate via `open()`, `close()`, or `toggle()`. */\n  readonly isOpen: Readable<boolean>;\n  /**\n   * Programmatically navigate to a named position. Always fires `onNavigate`\n   * (scroll-into-view, aria-activedescendant update).\n   * Returns the resolved index, or `-1` if no enabled item was found.\n   */\n  navigate(action: ListNavigationAction): number;\n  open(reason?: OverlayOpenReason): void;\n  scrollFocusedIntoView(): void;\n  /**\n   * Set focus to the item at `index`. Returns the resolved index.\n   * Pass a negative index to clear focus (same as `reset()`).\n   */\n  set(index: number): number;\n  /**\n   * Toggles open state.\n   * - Opens with `openReason` (default `'click'`).\n   * - Closes with `closeReason` (default `'trigger'`).\n   */\n  toggle(openReason?: OverlayOpenReason, closeReason?: DialogCloseReason): void;\n  /** Imperatively re-run dropdown positioning (e.g. after filter changes list height). */\n  updatePosition(): void;\n};\n\n// ── Factory ───────────────────────────────────────────────────────────────────\n\n/**\n * Shared headless primitive for dropdown option lists (select, combobox, menu).\n *\n * Owns `isOpen`, `focusedIndex`, the dropdown positioner, list navigation, and\n * overlay wiring. Composes overlay.ts + nav.ts into a single complete API.\n */\nexport const createOptionList = <T extends BaseOptionItem>(options: OptionListOptions<T>): OptionListHandle<T> => {\n  if (typeof options.getBoundary !== 'function') {\n    throw new RefineConfigError('createOptionList: getBoundary is required');\n  }\n\n  if (typeof options.getPanel !== 'function') {\n    throw new RefineConfigError('createOptionList: getPanel is required');\n  }\n\n  if (typeof options.getReference !== 'function') {\n    throw new RefineConfigError('createOptionList: getReference is required');\n  }\n\n  const isOpen = signal(false);\n\n  const ariaExpanded = computed(() => String(isOpen.value));\n\n  const positioner = createDropdownPositioner({\n    ...options.positioning,\n    getFloating: options.getPanel,\n    getReference: options.getReference,\n  });\n\n  const scrollFocusedIntoView = (): void => {\n    options.getFocusedOptionElement?.()?.scrollIntoView({ block: 'nearest' });\n  };\n\n  const list = createListControl<T>({\n    disabled: computed(() => !isOpen.value),\n    getItemLabel: options.getItemLabel,\n    getItems: options.getItems,\n    isItemDisabled: options.isItemDisabled,\n    keys: options.keys,\n    loop: options.loop ?? true,\n    onNavigate: (action, index, event) => {\n      scrollFocusedIntoView();\n\n      if (index >= 0) options.onNavigate?.(action, index, event);\n    },\n    orientation: options.orientation,\n    signal: options.signal,\n  });\n\n  const ariaActiveDescendant = computed<string | null>(() => {\n    const idx = list.focusedIndex.value;\n\n    return options.getOptionId && isOpen.value && idx >= 0 ? options.getOptionId(idx) : null;\n  });\n\n  const overlay = createOverlayControl({\n    getBoundary: options.getBoundary,\n    getPanel: options.getPanel,\n    getTrigger: options.getTrigger,\n    isDisabled: options.isDisabled,\n    isOpen: () => isOpen.value,\n    onClose: options.onClose,\n    onOpen: options.onOpen,\n    positioner,\n    restoreFocus: options.restoreFocus,\n    setOpen: (next) => {\n      isOpen.value = next;\n\n      if (!next) list.reset();\n    },\n    signal: options.signal,\n  });\n\n  // Built-in Escape key handling: prevents each consumer from duplicating the\n  // close-on-escape pattern. Fires only when the list is open; returns `true`\n  // so callers know the event was handled and can stop further processing.\n  const handleKeydown = (event: KeyboardEvent): boolean => {\n    if (!isOpen.value) return false;\n\n    if (event.key === 'Escape') {\n      event.preventDefault();\n      overlay.close('escape');\n\n      return true;\n    }\n\n    return list.handleKeydown(event);\n  };\n\n  return {\n    ariaActiveDescendant,\n    ariaExpanded,\n    close: (reason) => overlay.close(reason),\n    focusedIndex: list.focusedIndex,\n    getActiveItem: list.getActiveItem,\n    handleKeydown,\n    isOpen,\n    navigate: list.navigate,\n    open: (reason) => overlay.open(reason),\n    scrollFocusedIntoView,\n    set: list.set,\n    toggle: (openReason, closeReason) => overlay.toggle(openReason, closeReason),\n    updatePosition: positioner.update,\n  };\n};\n"],"mappings":"mJAoHA,IAAa,EAA8C,GAAuD,CAChH,GAAI,OAAO,EAAQ,aAAgB,WACjC,MAAM,IAAI,EAAA,kBAAkB,2CAA2C,EAGzE,GAAI,OAAO,EAAQ,UAAa,WAC9B,MAAM,IAAI,EAAA,kBAAkB,wCAAwC,EAGtE,GAAI,OAAO,EAAQ,cAAiB,WAClC,MAAM,IAAI,EAAA,kBAAkB,4CAA4C,EAG1E,IAAM,GAAA,EAAA,EAAA,OAAA,CAAgB,EAAK,EAErB,GAAA,EAAA,EAAA,SAAA,KAA8B,OAAO,EAAO,KAAK,CAAC,EAElD,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,EAAA,EAAA,SAAA,KAAyB,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,EAAA,EAAA,SAAA,KAAqD,CACzD,IAAM,EAAM,EAAK,aAAa,MAE9B,OAAO,EAAQ,aAAe,EAAO,OAAS,GAAO,EAAI,EAAQ,YAAY,CAAG,EAAI,IACtF,CAAC,EAEK,EAAU,EAAA,qBAAqB,CACnC,YAAa,EAAQ,YACrB,SAAU,EAAQ,SAClB,WAAY,EAAQ,WACpB,WAAY,EAAQ,WACpB,WAAc,EAAO,MACrB,QAAS,EAAQ,QACjB,OAAQ,EAAQ,OAChB,aACA,aAAc,EAAQ,aACtB,QAAU,GAAS,CACjB,EAAO,MAAQ,EAEV,GAAM,EAAK,MAAM,CACxB,EACA,OAAQ,EAAQ,MAClB,CAAC,EAkBD,MAAO,CACL,uBACA,eACA,MAAQ,GAAW,EAAQ,MAAM,CAAM,EACvC,aAAc,EAAK,aACnB,cAAe,EAAK,cACpB,cAnBqB,GAChB,EAAO,MAER,EAAM,MAAQ,UAChB,EAAM,eAAe,EACrB,EAAQ,MAAM,QAAQ,EAEf,IAGF,EAAK,cAAc,CAAK,EATL,GAmB1B,SACA,SAAU,EAAK,SACf,KAAO,GAAW,EAAQ,KAAK,CAAM,EACrC,wBACA,IAAK,EAAK,IACV,QAAS,EAAY,IAAgB,EAAQ,OAAO,EAAY,CAAW,EAC3E,eAAgB,EAAW,MAC7B,CACF"}

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

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

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

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

package/dist/headless/option-list.js

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