@vielzeug/craftit 2.1.0 → 3.0.3

package/dist/controls/list-control.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"list-control.cjs","names":[],"sources":["../../src/controls/list-control.ts"],"sourcesContent":["import { findBackward, findForward } from './internal/validation-utils';\n\nexport type ListNavigationOptions<T> = {\n  getIndex: () => number;\n  getItems: () => T[];\n  isItemDisabled?: (item: T, index: number) => boolean;\n  loop?: boolean;\n  setIndex: (index: number) => void;\n};\n\nexport type ListControlResult = {\n  index: number;\n  moved: boolean;\n};\n\nexport type ListControl<T> = {\n  first(): ListControlResult;\n  getActiveItem(): T | undefined;\n  last(): ListControlResult;\n  next(): ListControlResult;\n  prev(): ListControlResult;\n  reset(): void;\n};\n\nexport const createListControl = <T>(options: ListNavigationOptions<T>): ListControl<T> => {\n  const isDisabled = (item: T, index: number): boolean =>\n    options.isItemDisabled?.(item, index) ?? (item as any).disabled;\n\n  const result = (idx: number, current: number): ListControlResult => {\n    return {\n      index: Math.max(idx, -1),\n      moved: idx >= 0 && idx !== current,\n    };\n  };\n\n  const commitIndex = (idx: number, current: number): ListControlResult => {\n    if (idx >= 0) options.setIndex(idx);\n\n    return result(idx, current);\n  };\n\n  const findEnabledIndex = (items: T[], start: number, direction: 'forward' | 'backward'): number => {\n    if (direction === 'forward') return findForward(items, start, (item, i) => !isDisabled(item, i));\n\n    return findBackward(items, start, (item, i) => !isDisabled(item, i));\n  };\n\n  const first = (): ListControlResult => {\n    const items = options.getItems();\n    const current = options.getIndex();\n\n    if (!items.length) return result(-1, current);\n\n    return commitIndex(findEnabledIndex(items, 0, 'forward'), current);\n  };\n\n  const last = (): ListControlResult => {\n    const items = options.getItems();\n    const current = options.getIndex();\n\n    if (!items.length) return result(-1, current);\n\n    return commitIndex(findEnabledIndex(items, items.length - 1, 'backward'), current);\n  };\n\n  const move = (direction: 'forward' | 'backward'): ListControlResult => {\n    const items = options.getItems();\n    const current = options.getIndex();\n\n    if (!items.length) return result(-1, current);\n\n    const start = direction === 'forward' ? Math.max(0, current + 1) : current - 1;\n    const idx = findEnabledIndex(items, start, direction);\n\n    if (idx >= 0) return commitIndex(idx, current);\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, current);\n    }\n\n    return result(current, current);\n  };\n\n  const next = (): ListControlResult => move('forward');\n\n  const prev = (): ListControlResult => move('backward');\n\n  const getActiveItem = (): T | undefined => {\n    const items = options.getItems();\n    const index = options.getIndex();\n\n    return index >= 0 && index < items.length ? items[index] : undefined;\n  };\n\n  const reset = (): void => {\n    options.setIndex(-1);\n  };\n\n  return {\n    first,\n    getActiveItem,\n    last,\n    next,\n    prev,\n    reset,\n  };\n};\n"],"mappings":"mDAwBA,IAAa,EAAwB,GAAsD,CACzF,IAAM,GAAc,EAAS,IAC3B,EAAQ,iBAAiB,EAAM,EAAM,EAAK,EAAa,SAEnD,GAAU,EAAa,KACpB,CACL,MAAO,KAAK,IAAI,EAAK,GAAG,CACxB,MAAO,GAAO,GAAK,IAAQ,EAC5B,EAGG,GAAe,EAAa,KAC5B,GAAO,GAAG,EAAQ,SAAS,EAAI,CAE5B,EAAO,EAAK,EAAQ,EAGvB,GAAoB,EAAY,EAAe,IAC/C,IAAc,UAAkB,EAAA,YAAY,EAAO,GAAQ,EAAM,IAAM,CAAC,EAAW,EAAM,EAAE,CAAC,CAEzF,EAAA,aAAa,EAAO,GAAQ,EAAM,IAAM,CAAC,EAAW,EAAM,EAAE,CAAC,CAGhE,MAAiC,CACrC,IAAM,EAAQ,EAAQ,UAAU,CAC1B,EAAU,EAAQ,UAAU,CAIlC,OAFK,EAAM,OAEJ,EAAY,EAAiB,EAAO,EAAG,UAAU,CAAE,EAAQ,CAFxC,EAAO,GAAI,EAAQ,EAKzC,MAAgC,CACpC,IAAM,EAAQ,EAAQ,UAAU,CAC1B,EAAU,EAAQ,UAAU,CAIlC,OAFK,EAAM,OAEJ,EAAY,EAAiB,EAAO,EAAM,OAAS,EAAG,WAAW,CAAE,EAAQ,CAFxD,EAAO,GAAI,EAAQ,EAKzC,EAAQ,GAAyD,CACrE,IAAM,EAAQ,EAAQ,UAAU,CAC1B,EAAU,EAAQ,UAAU,CAElC,GAAI,CAAC,EAAM,OAAQ,OAAO,EAAO,GAAI,EAAQ,CAG7C,IAAM,EAAM,EAAiB,EADf,IAAc,UAAY,KAAK,IAAI,EAAG,EAAU,EAAE,CAAG,EAAU,EAClC,EAAU,CAErD,GAAI,GAAO,EAAG,OAAO,EAAY,EAAK,EAAQ,CAE9C,GAAI,EAAQ,KAAM,CAEhB,IAAM,EAAU,EAAiB,EADf,IAAc,UAAY,EAAI,EAAM,OAAS,EACZ,EAAU,CAE7D,GAAI,GAAW,EAAG,OAAO,EAAY,EAAS,EAAQ,CAGxD,OAAO,EAAO,EAAS,EAAQ,EAkBjC,MAAO,CACL,QACA,kBAbyC,CACzC,IAAM,EAAQ,EAAQ,UAAU,CAC1B,EAAQ,EAAQ,UAAU,CAEhC,OAAO,GAAS,GAAK,EAAQ,EAAM,OAAS,EAAM,GAAS,IAAA,IAU3D,OACA,SAnBoC,EAAK,UAAU,CAoBnD,SAlBoC,EAAK,WAAW,CAmBpD,UAVwB,CACxB,EAAQ,SAAS,GAAG,EAUrB"}
+{"version":3,"file":"list-control.cjs","names":[],"sources":["../../src/controls/list-control.ts"],"sourcesContent":["import { dispatchKeyboardAction } from './internal/keyboard-utils';\nimport { findBackward, findForward } from './internal/validation-utils';\n\nexport type ListKeyAction = 'first' | 'last' | 'next' | 'prev';\n\nconst DEFAULT_KEYS: Record<ListKeyAction, string[]> = {\n  first: ['Home'],\n  last: ['End'],\n  next: ['ArrowDown'],\n  prev: ['ArrowUp'],\n};\n\nexport type ListNavigationOptions<T> = {\n  disabled?: () => boolean;\n  getIndex: () => number;\n  getItems: () => T[];\n  isItemDisabled?: (item: T, index: number) => boolean;\n  keys?: Partial<Record<ListKeyAction, string[]>> | (() => Partial<Record<ListKeyAction, string[]>>);\n  loop?: boolean;\n  onNavigate?: (action: ListKeyAction, index: number, event: KeyboardEvent) => void;\n  setIndex: (index: number) => void;\n};\n\nexport type ListControl<T> = {\n  first(): number;\n  getActiveItem(): T | undefined;\n  handleKeydown(event: KeyboardEvent): boolean;\n  last(): number;\n  next(): number;\n  prev(): number;\n  reset(): void;\n  set(index: number): number;\n};\n\nexport const createListControl = <T>(options: ListNavigationOptions<T>): ListControl<T> => {\n  const isDisabled = (item: T, index: number): boolean =>\n    options.isItemDisabled?.(item, index) ?? (item as any).disabled;\n\n  const commitIndex = (idx: number): number => {\n    if (idx >= 0) options.setIndex(idx);\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) => !isDisabled(item, i));\n\n    return findBackward(items, start, (item, i) => !isDisabled(item, i));\n  };\n\n  const first = (): number => {\n    const items = options.getItems();\n\n    if (!items.length) return -1;\n\n    const idx = findEnabledIndex(items, 0, 'forward');\n\n    if (idx < 0) return -1;\n\n    return commitIndex(idx);\n  };\n\n  const last = (): number => {\n    const items = options.getItems();\n\n    if (!items.length) return -1;\n\n    const idx = findEnabledIndex(items, items.length - 1, 'backward');\n\n    if (idx < 0) return -1;\n\n    return commitIndex(idx);\n  };\n\n  const set = (index: number): number => {\n    const items = options.getItems();\n\n    if (!items.length) return -1;\n\n    const clamped = Math.min(Math.max(index, 0), items.length - 1);\n\n    if (isDisabled(items[clamped], clamped)) {\n      return options.getIndex();\n    }\n\n    return commitIndex(clamped);\n  };\n\n  const move = (direction: 'forward' | 'backward'): number => {\n    const items = options.getItems();\n    const current = options.getIndex();\n\n    if (!items.length) return -1;\n\n    const start =\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\n    if (idx >= 0) return commitIndex(idx);\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);\n    }\n\n    return current;\n  };\n\n  const next = (): number => move('forward');\n\n  const prev = (): number => move('backward');\n\n  const getActiveItem = (): T | undefined => {\n    const items = options.getItems();\n    const index = options.getIndex();\n\n    return index >= 0 && index < items.length ? items[index] : undefined;\n  };\n\n  const reset = (): void => {\n    options.setIndex(-1);\n  };\n\n  // ── Keyboard handling ──────────────────────────────────────────────────────\n\n  const isKeyDisabled = (): boolean => Boolean(options.disabled?.());\n\n  const resolveKeys = (): Record<ListKeyAction, string[]> => {\n    const keys = typeof options.keys === 'function' ? options.keys() : options.keys;\n\n    return {\n      first: keys?.first ?? DEFAULT_KEYS.first,\n      last: keys?.last ?? DEFAULT_KEYS.last,\n      next: keys?.next ?? DEFAULT_KEYS.next,\n      prev: keys?.prev ?? DEFAULT_KEYS.prev,\n    };\n  };\n\n  let cachedKeymap: Record<string, (keyboardEvent: KeyboardEvent) => void> | null = null;\n  let cachedKeysRef: Partial<Record<ListKeyAction, string[]>> | undefined;\n\n  const buildKeymap = (): Record<string, (keyboardEvent: KeyboardEvent) => void> => {\n    const keys = resolveKeys();\n    const keymap: Record<string, (keyboardEvent: KeyboardEvent) => void> = {};\n\n    for (const action of ['next', 'prev', 'first', 'last'] as const) {\n      for (const key of keys[action]) {\n        keymap[key] = (keyboardEvent: KeyboardEvent) => {\n          const index = { first, last, next, prev }[action]();\n\n          options.onNavigate?.(action, index, keyboardEvent);\n        };\n      }\n    }\n\n    return keymap;\n  };\n\n  const getKeymap = (): Record<string, (keyboardEvent: KeyboardEvent) => void> => {\n    if (typeof options.keys === 'function') {\n      const currentKeys = options.keys();\n\n      if (currentKeys !== cachedKeysRef) {\n        cachedKeysRef = currentKeys;\n        cachedKeymap = buildKeymap();\n      }\n    } else if (!cachedKeymap) {\n      cachedKeymap = buildKeymap();\n    }\n\n    return cachedKeymap!;\n  };\n\n  const handleKeydown = (event: KeyboardEvent): boolean =>\n    dispatchKeyboardAction(event, { disabled: isKeyDisabled, keymap: getKeymap() });\n\n  return {\n    first,\n    getActiveItem,\n    handleKeydown,\n    last,\n    next,\n    prev,\n    reset,\n    set,\n  };\n};\n"],"mappings":"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"}

package/dist/controls/list-control.d.ts

@@ -1,21 +1,23 @@
+export type ListKeyAction = 'first' | 'last' | 'next' | 'prev';
 export type ListNavigationOptions<T> = {
+    disabled?: () => boolean;
     getIndex: () => number;
     getItems: () => T[];
     isItemDisabled?: (item: T, index: number) => boolean;
+    keys?: Partial<Record<ListKeyAction, string[]>> | (() => Partial<Record<ListKeyAction, string[]>>);
     loop?: boolean;
+    onNavigate?: (action: ListKeyAction, index: number, event: KeyboardEvent) => void;
     setIndex: (index: number) => void;
 };
-export type ListControlResult = {
-    index: number;
-    moved: boolean;
-};
 export type ListControl<T> = {
-    first(): ListControlResult;
+    first(): number;
     getActiveItem(): T | undefined;
-    last(): ListControlResult;
-    next(): ListControlResult;
-    prev(): ListControlResult;
+    handleKeydown(event: KeyboardEvent): boolean;
+    last(): number;
+    next(): number;
+    prev(): number;
     reset(): void;
+    set(index: number): number;
 };
 export declare const createListControl: <T>(options: ListNavigationOptions<T>) => ListControl<T>;
 //# sourceMappingURL=list-control.d.ts.map

package/dist/controls/list-control.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list-control.d.ts","sourceRoot":"","sources":["../../src/controls/list-control.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,qBAAqB,CAAC,CAAC,IAAI;IACrC,QAAQ,EAAE,MAAM,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC,EAAE,CAAC;IACpB,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;IACrD,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI;IAC3B,KAAK,IAAI,iBAAiB,CAAC;IAC3B,aAAa,IAAI,CAAC,GAAG,SAAS,CAAC;IAC/B,IAAI,IAAI,iBAAiB,CAAC;IAC1B,IAAI,IAAI,iBAAiB,CAAC;IAC1B,IAAI,IAAI,iBAAiB,CAAC;IAC1B,KAAK,IAAI,IAAI,CAAC;CACf,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAI,CAAC,EAAE,SAAS,qBAAqB,CAAC,CAAC,CAAC,KAAG,WAAW,CAAC,CAAC,CAqFrF,CAAC"}
+{"version":3,"file":"list-control.d.ts","sourceRoot":"","sources":["../../src/controls/list-control.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAS/D,MAAM,MAAM,qBAAqB,CAAC,CAAC,IAAI;IACrC,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC;IACzB,QAAQ,EAAE,MAAM,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC,EAAE,CAAC;IACpB,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;IACrD,IAAI,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC;IACnG,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;IAClF,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI;IAC3B,KAAK,IAAI,MAAM,CAAC;IAChB,aAAa,IAAI,CAAC,GAAG,SAAS,CAAC;IAC/B,aAAa,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC;IAC7C,IAAI,IAAI,MAAM,CAAC;IACf,IAAI,IAAI,MAAM,CAAC;IACf,IAAI,IAAI,MAAM,CAAC;IACf,KAAK,IAAI,IAAI,CAAC;IACd,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;CAC5B,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAI,CAAC,EAAE,SAAS,qBAAqB,CAAC,CAAC,CAAC,KAAG,WAAW,CAAC,CAAC,CAgKrF,CAAC"}

package/dist/controls/list-control.js

@@ -1,2 +1,2 @@
-import{findBackward as e,findForward as t}from"./internal/validation-utils.js";var n=n=>{let r=(e,t)=>n.isItemDisabled?.(e,t)??e.disabled,i=(e,t)=>({index:Math.max(e,-1),moved:e>=0&&e!==t}),a=(e,t)=>(e>=0&&n.setIndex(e),i(e,t)),o=(n,i,a)=>a===`forward`?t(n,i,(e,t)=>!r(e,t)):e(n,i,(e,t)=>!r(e,t)),s=()=>{let e=n.getItems(),t=n.getIndex();return e.length?a(o(e,0,`forward`),t):i(-1,t)},c=()=>{let e=n.getItems(),t=n.getIndex();return e.length?a(o(e,e.length-1,`backward`),t):i(-1,t)},l=e=>{let t=n.getItems(),r=n.getIndex();if(!t.length)return i(-1,r);let s=o(t,e===`forward`?Math.max(0,r+1):r-1,e);if(s>=0)return a(s,r);if(n.loop){let n=o(t,e===`forward`?0:t.length-1,e);if(n>=0)return a(n,r)}return i(r,r)};return{first:s,getActiveItem:()=>{let e=n.getItems(),t=n.getIndex();return t>=0&&t<e.length?e[t]:void 0},last:c,next:()=>l(`forward`),prev:()=>l(`backward`),reset:()=>{n.setIndex(-1)}}};export{n as createListControl};
+import{dispatchKeyboardAction as e}from"./internal/keyboard-utils.js";import{findBackward as t,findForward as n}from"./internal/validation-utils.js";var r={first:[`Home`],last:[`End`],next:[`ArrowDown`],prev:[`ArrowUp`]},i=i=>{let a=(e,t)=>i.isItemDisabled?.(e,t)??e.disabled,o=e=>(e>=0&&i.setIndex(e),e),s=(e,r,i)=>i===`forward`?n(e,r,(e,t)=>!a(e,t)):t(e,r,(e,t)=>!a(e,t)),c=()=>{let e=i.getItems();if(!e.length)return-1;let t=s(e,0,`forward`);return t<0?-1:o(t)},l=()=>{let e=i.getItems();if(!e.length)return-1;let t=s(e,e.length-1,`backward`);return t<0?-1:o(t)},u=e=>{let t=i.getItems();if(!t.length)return-1;let n=Math.min(Math.max(e,0),t.length-1);return a(t[n],n)?i.getIndex():o(n)},d=e=>{let t=i.getItems(),n=i.getIndex();if(!t.length)return-1;let r=s(t,n<0?e===`forward`?0:t.length-1:e===`forward`?n+1:n-1,e);if(r>=0)return o(r);if(i.loop){let n=s(t,e===`forward`?0:t.length-1,e);if(n>=0)return o(n)}return n},f=()=>d(`forward`),p=()=>d(`backward`),m=()=>{let e=i.getItems(),t=i.getIndex();return t>=0&&t<e.length?e[t]:void 0},h=()=>{i.setIndex(-1)},g=()=>!!i.disabled?.(),_=()=>{let e=typeof i.keys==`function`?i.keys():i.keys;return{first:e?.first??r.first,last:e?.last??r.last,next:e?.next??r.next,prev:e?.prev??r.prev}},v=null,y,b=()=>{let e=_(),t={};for(let n of[`next`,`prev`,`first`,`last`])for(let r of e[n])t[r]=e=>{let t={first:c,last:l,next:f,prev:p}[n]();i.onNavigate?.(n,t,e)};return t},x=()=>{if(typeof i.keys==`function`){let e=i.keys();e!==y&&(y=e,v=b())}else v||=b();return v};return{first:c,getActiveItem:m,handleKeydown:t=>e(t,{disabled:g,keymap:x()}),last:l,next:f,prev:p,reset:h,set:u}};export{i as createListControl};
 //# sourceMappingURL=list-control.js.map

package/dist/controls/list-control.js.map

@@ -1 +1 @@
-{"version":3,"file":"list-control.js","names":[],"sources":["../../src/controls/list-control.ts"],"sourcesContent":["import { findBackward, findForward } from './internal/validation-utils';\n\nexport type ListNavigationOptions<T> = {\n  getIndex: () => number;\n  getItems: () => T[];\n  isItemDisabled?: (item: T, index: number) => boolean;\n  loop?: boolean;\n  setIndex: (index: number) => void;\n};\n\nexport type ListControlResult = {\n  index: number;\n  moved: boolean;\n};\n\nexport type ListControl<T> = {\n  first(): ListControlResult;\n  getActiveItem(): T | undefined;\n  last(): ListControlResult;\n  next(): ListControlResult;\n  prev(): ListControlResult;\n  reset(): void;\n};\n\nexport const createListControl = <T>(options: ListNavigationOptions<T>): ListControl<T> => {\n  const isDisabled = (item: T, index: number): boolean =>\n    options.isItemDisabled?.(item, index) ?? (item as any).disabled;\n\n  const result = (idx: number, current: number): ListControlResult => {\n    return {\n      index: Math.max(idx, -1),\n      moved: idx >= 0 && idx !== current,\n    };\n  };\n\n  const commitIndex = (idx: number, current: number): ListControlResult => {\n    if (idx >= 0) options.setIndex(idx);\n\n    return result(idx, current);\n  };\n\n  const findEnabledIndex = (items: T[], start: number, direction: 'forward' | 'backward'): number => {\n    if (direction === 'forward') return findForward(items, start, (item, i) => !isDisabled(item, i));\n\n    return findBackward(items, start, (item, i) => !isDisabled(item, i));\n  };\n\n  const first = (): ListControlResult => {\n    const items = options.getItems();\n    const current = options.getIndex();\n\n    if (!items.length) return result(-1, current);\n\n    return commitIndex(findEnabledIndex(items, 0, 'forward'), current);\n  };\n\n  const last = (): ListControlResult => {\n    const items = options.getItems();\n    const current = options.getIndex();\n\n    if (!items.length) return result(-1, current);\n\n    return commitIndex(findEnabledIndex(items, items.length - 1, 'backward'), current);\n  };\n\n  const move = (direction: 'forward' | 'backward'): ListControlResult => {\n    const items = options.getItems();\n    const current = options.getIndex();\n\n    if (!items.length) return result(-1, current);\n\n    const start = direction === 'forward' ? Math.max(0, current + 1) : current - 1;\n    const idx = findEnabledIndex(items, start, direction);\n\n    if (idx >= 0) return commitIndex(idx, current);\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, current);\n    }\n\n    return result(current, current);\n  };\n\n  const next = (): ListControlResult => move('forward');\n\n  const prev = (): ListControlResult => move('backward');\n\n  const getActiveItem = (): T | undefined => {\n    const items = options.getItems();\n    const index = options.getIndex();\n\n    return index >= 0 && index < items.length ? items[index] : undefined;\n  };\n\n  const reset = (): void => {\n    options.setIndex(-1);\n  };\n\n  return {\n    first,\n    getActiveItem,\n    last,\n    next,\n    prev,\n    reset,\n  };\n};\n"],"mappings":"+EAwBA,IAAa,EAAwB,GAAsD,CACzF,IAAM,GAAc,EAAS,IAC3B,EAAQ,iBAAiB,EAAM,EAAM,EAAK,EAAa,SAEnD,GAAU,EAAa,KACpB,CACL,MAAO,KAAK,IAAI,EAAK,GAAG,CACxB,MAAO,GAAO,GAAK,IAAQ,EAC5B,EAGG,GAAe,EAAa,KAC5B,GAAO,GAAG,EAAQ,SAAS,EAAI,CAE5B,EAAO,EAAK,EAAQ,EAGvB,GAAoB,EAAY,EAAe,IAC/C,IAAc,UAAkB,EAAY,EAAO,GAAQ,EAAM,IAAM,CAAC,EAAW,EAAM,EAAE,CAAC,CAEzF,EAAa,EAAO,GAAQ,EAAM,IAAM,CAAC,EAAW,EAAM,EAAE,CAAC,CAGhE,MAAiC,CACrC,IAAM,EAAQ,EAAQ,UAAU,CAC1B,EAAU,EAAQ,UAAU,CAIlC,OAFK,EAAM,OAEJ,EAAY,EAAiB,EAAO,EAAG,UAAU,CAAE,EAAQ,CAFxC,EAAO,GAAI,EAAQ,EAKzC,MAAgC,CACpC,IAAM,EAAQ,EAAQ,UAAU,CAC1B,EAAU,EAAQ,UAAU,CAIlC,OAFK,EAAM,OAEJ,EAAY,EAAiB,EAAO,EAAM,OAAS,EAAG,WAAW,CAAE,EAAQ,CAFxD,EAAO,GAAI,EAAQ,EAKzC,EAAQ,GAAyD,CACrE,IAAM,EAAQ,EAAQ,UAAU,CAC1B,EAAU,EAAQ,UAAU,CAElC,GAAI,CAAC,EAAM,OAAQ,OAAO,EAAO,GAAI,EAAQ,CAG7C,IAAM,EAAM,EAAiB,EADf,IAAc,UAAY,KAAK,IAAI,EAAG,EAAU,EAAE,CAAG,EAAU,EAClC,EAAU,CAErD,GAAI,GAAO,EAAG,OAAO,EAAY,EAAK,EAAQ,CAE9C,GAAI,EAAQ,KAAM,CAEhB,IAAM,EAAU,EAAiB,EADf,IAAc,UAAY,EAAI,EAAM,OAAS,EACZ,EAAU,CAE7D,GAAI,GAAW,EAAG,OAAO,EAAY,EAAS,EAAQ,CAGxD,OAAO,EAAO,EAAS,EAAQ,EAkBjC,MAAO,CACL,QACA,kBAbyC,CACzC,IAAM,EAAQ,EAAQ,UAAU,CAC1B,EAAQ,EAAQ,UAAU,CAEhC,OAAO,GAAS,GAAK,EAAQ,EAAM,OAAS,EAAM,GAAS,IAAA,IAU3D,OACA,SAnBoC,EAAK,UAAU,CAoBnD,SAlBoC,EAAK,WAAW,CAmBpD,UAVwB,CACxB,EAAQ,SAAS,GAAG,EAUrB"}
+{"version":3,"file":"list-control.js","names":[],"sources":["../../src/controls/list-control.ts"],"sourcesContent":["import { dispatchKeyboardAction } from './internal/keyboard-utils';\nimport { findBackward, findForward } from './internal/validation-utils';\n\nexport type ListKeyAction = 'first' | 'last' | 'next' | 'prev';\n\nconst DEFAULT_KEYS: Record<ListKeyAction, string[]> = {\n  first: ['Home'],\n  last: ['End'],\n  next: ['ArrowDown'],\n  prev: ['ArrowUp'],\n};\n\nexport type ListNavigationOptions<T> = {\n  disabled?: () => boolean;\n  getIndex: () => number;\n  getItems: () => T[];\n  isItemDisabled?: (item: T, index: number) => boolean;\n  keys?: Partial<Record<ListKeyAction, string[]>> | (() => Partial<Record<ListKeyAction, string[]>>);\n  loop?: boolean;\n  onNavigate?: (action: ListKeyAction, index: number, event: KeyboardEvent) => void;\n  setIndex: (index: number) => void;\n};\n\nexport type ListControl<T> = {\n  first(): number;\n  getActiveItem(): T | undefined;\n  handleKeydown(event: KeyboardEvent): boolean;\n  last(): number;\n  next(): number;\n  prev(): number;\n  reset(): void;\n  set(index: number): number;\n};\n\nexport const createListControl = <T>(options: ListNavigationOptions<T>): ListControl<T> => {\n  const isDisabled = (item: T, index: number): boolean =>\n    options.isItemDisabled?.(item, index) ?? (item as any).disabled;\n\n  const commitIndex = (idx: number): number => {\n    if (idx >= 0) options.setIndex(idx);\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) => !isDisabled(item, i));\n\n    return findBackward(items, start, (item, i) => !isDisabled(item, i));\n  };\n\n  const first = (): number => {\n    const items = options.getItems();\n\n    if (!items.length) return -1;\n\n    const idx = findEnabledIndex(items, 0, 'forward');\n\n    if (idx < 0) return -1;\n\n    return commitIndex(idx);\n  };\n\n  const last = (): number => {\n    const items = options.getItems();\n\n    if (!items.length) return -1;\n\n    const idx = findEnabledIndex(items, items.length - 1, 'backward');\n\n    if (idx < 0) return -1;\n\n    return commitIndex(idx);\n  };\n\n  const set = (index: number): number => {\n    const items = options.getItems();\n\n    if (!items.length) return -1;\n\n    const clamped = Math.min(Math.max(index, 0), items.length - 1);\n\n    if (isDisabled(items[clamped], clamped)) {\n      return options.getIndex();\n    }\n\n    return commitIndex(clamped);\n  };\n\n  const move = (direction: 'forward' | 'backward'): number => {\n    const items = options.getItems();\n    const current = options.getIndex();\n\n    if (!items.length) return -1;\n\n    const start =\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\n    if (idx >= 0) return commitIndex(idx);\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);\n    }\n\n    return current;\n  };\n\n  const next = (): number => move('forward');\n\n  const prev = (): number => move('backward');\n\n  const getActiveItem = (): T | undefined => {\n    const items = options.getItems();\n    const index = options.getIndex();\n\n    return index >= 0 && index < items.length ? items[index] : undefined;\n  };\n\n  const reset = (): void => {\n    options.setIndex(-1);\n  };\n\n  // ── Keyboard handling ──────────────────────────────────────────────────────\n\n  const isKeyDisabled = (): boolean => Boolean(options.disabled?.());\n\n  const resolveKeys = (): Record<ListKeyAction, string[]> => {\n    const keys = typeof options.keys === 'function' ? options.keys() : options.keys;\n\n    return {\n      first: keys?.first ?? DEFAULT_KEYS.first,\n      last: keys?.last ?? DEFAULT_KEYS.last,\n      next: keys?.next ?? DEFAULT_KEYS.next,\n      prev: keys?.prev ?? DEFAULT_KEYS.prev,\n    };\n  };\n\n  let cachedKeymap: Record<string, (keyboardEvent: KeyboardEvent) => void> | null = null;\n  let cachedKeysRef: Partial<Record<ListKeyAction, string[]>> | undefined;\n\n  const buildKeymap = (): Record<string, (keyboardEvent: KeyboardEvent) => void> => {\n    const keys = resolveKeys();\n    const keymap: Record<string, (keyboardEvent: KeyboardEvent) => void> = {};\n\n    for (const action of ['next', 'prev', 'first', 'last'] as const) {\n      for (const key of keys[action]) {\n        keymap[key] = (keyboardEvent: KeyboardEvent) => {\n          const index = { first, last, next, prev }[action]();\n\n          options.onNavigate?.(action, index, keyboardEvent);\n        };\n      }\n    }\n\n    return keymap;\n  };\n\n  const getKeymap = (): Record<string, (keyboardEvent: KeyboardEvent) => void> => {\n    if (typeof options.keys === 'function') {\n      const currentKeys = options.keys();\n\n      if (currentKeys !== cachedKeysRef) {\n        cachedKeysRef = currentKeys;\n        cachedKeymap = buildKeymap();\n      }\n    } else if (!cachedKeymap) {\n      cachedKeymap = buildKeymap();\n    }\n\n    return cachedKeymap!;\n  };\n\n  const handleKeydown = (event: KeyboardEvent): boolean =>\n    dispatchKeyboardAction(event, { disabled: isKeyDisabled, keymap: getKeymap() });\n\n  return {\n    first,\n    getActiveItem,\n    handleKeydown,\n    last,\n    next,\n    prev,\n    reset,\n    set,\n  };\n};\n"],"mappings":"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"}

package/dist/controls/overlay-control.cjs

@@ -1,2 +1,2 @@
-const e=require(`../runtime-lifecycle.cjs`),t=require(`./internal/control-state.cjs`);let n=require(`@vielzeug/stateit`),r=require(`@vielzeug/floatit`);var i=i=>{let a=t.createControlState(i);e.effect(()=>{if(!i.isOpen.value||!i.positioner)return;let e=i.positioner.reference(),t=i.positioner.floating();if(!e||!t){i.positioner.update();return}(0,n.onCleanup)((0,r.autoUpdate)(e,t,()=>i.positioner?.update()))});let o=()=>typeof i.restoreFocus==`function`?i.restoreFocus():i.restoreFocus??!0,s=(e=`programmatic`)=>{a.disabled.value||i.isOpen.value||(i.setOpen(!0,e),requestAnimationFrame(()=>i.positioner?.update()),i.onOpen?.(e))},c=(e=`programmatic`,t)=>{i.isOpen.value&&(i.setOpen(!1,e),(t??o())&&i.elements.trigger?.focus(),i.onClose?.(e))},l=()=>{if(i.isOpen.value){c(`trigger`);return}s(`trigger`)},u=(e,t)=>e?e.contains(t):!1;return{bindOutsideClick:(e=document,t=!0)=>{let n=e=>{if(!i.isOpen.value)return;let t=e.composedPath()[0];t&&(u(i.elements.boundary,t)||u(i.elements.panel,t)||c(`outside-click`))};return e.addEventListener(`click`,n,{capture:t}),()=>e.removeEventListener(`click`,n,{capture:t})},close:c,open:s,toggle:l}};exports.createOverlayControl=i;
+let e=require(`@vielzeug/floatit`);var t=new Set,n=null,r=e=>e instanceof Error&&e.message.includes(`[stateit] Cannot read disposed computed signal`),i=()=>{if(n)return;let e=e=>{for(let n of[...t])try{n(e)}catch(e){if(r(e)){t.delete(n);continue}throw e}a()};document.addEventListener(`click`,e,{capture:!0}),n=()=>{document.removeEventListener(`click`,e,{capture:!0}),n=null}},a=()=>{t.size===0&&n&&n()},o=n=>{let o=null,s=null,c=()=>typeof n.restoreFocus==`function`?n.restoreFocus():n.restoreFocus??!0,l=(e,o)=>{try{n.setOpen(e,o)}catch(e){if(r(e)&&s){t.delete(s),a();return}throw e}e&&s?(t.add(s),i()):!e&&s&&(t.delete(s),a())},u=(t={})=>{let r=t.reason??`programmatic`;if(!(n.isDisabled?.()||n.isOpen())){if(l(!0,{reason:r}),n.positioner){let t=n.positioner.reference(),r=n.positioner.floating();t&&r&&(o=(0,e.autoUpdate)(t,r,()=>n.positioner?.update())),n.positioner.update()}n.onOpen?.(r)}},d=(e={})=>{let t=e.reason??`programmatic`;n.isOpen()&&(l(!1,{reason:t}),o&&=(o(),null),(e.restoreFocus??c())&&n.getTriggerElement?.()?.focus(),n.onClose?.(t))};return s=e=>{if(!n.isOpen())return;let t=e.composedPath?.()??[],r=n.getBoundaryElement(),i=n.getPanelElement?.()??null,a=t[0]??e.target,o=a instanceof Node?a:null,s=t.some(e=>e===r||e===i),c=o?(r?.contains(o)??!1)||(i?.contains(o)??!1):!1;s||c||d({reason:`outside-click`})},{close:d,open:u,toggle:()=>{if(n.isOpen()){d({reason:`trigger`});return}u({reason:`trigger`})}}};exports.createOverlayControl=o;
 //# sourceMappingURL=overlay-control.cjs.map

package/dist/controls/overlay-control.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"overlay-control.cjs","names":[],"sources":["../../src/controls/overlay-control.ts"],"sourcesContent":["import { autoUpdate } from '@vielzeug/floatit';\nimport { onCleanup as onSignalCleanup, type ReadonlySignal } from '@vielzeug/stateit';\n\nimport { effect } from '../runtime-lifecycle';\nimport { createControlState, type ControlContextOptions } from './internal/control-state';\n\nexport type OverlayOpenReason = 'programmatic' | 'trigger';\nexport type OverlayCloseReason = 'escape' | 'outside-click' | 'programmatic' | 'trigger';\nexport type OverlayCloseDetail = { reason: OverlayCloseReason };\nexport type OverlayOpenDetail = { reason: OverlayOpenReason };\n\ntype OverlayPositioner = {\n  floating: () => HTMLElement | null;\n  reference: () => HTMLElement | null;\n  update: () => void;\n};\n\nexport type OverlayControlOptions = ControlContextOptions & {\n  elements: {\n    boundary: HTMLElement;\n    panel?: HTMLElement | null;\n    trigger?: HTMLElement | null;\n  };\n  isOpen: ReadonlySignal<boolean>;\n  onClose?: (reason: OverlayCloseReason) => void;\n  onOpen?: (reason: OverlayOpenReason) => void;\n  positioner?: OverlayPositioner;\n  restoreFocus?: boolean | (() => boolean);\n  setOpen: (next: boolean, reason: OverlayOpenReason | OverlayCloseReason) => void;\n};\n\nexport type OverlayControl = {\n  bindOutsideClick(target?: Document | HTMLElement, capture?: boolean): () => void;\n  close(reason?: OverlayCloseReason, restoreFocus?: boolean): void;\n  open(reason?: OverlayOpenReason): void;\n  toggle(): void;\n};\n\nexport const createOverlayControl = (options: OverlayControlOptions): OverlayControl => {\n  const controlState = createControlState(options);\n\n  // Effect handles positioning lifecycle automatically\n  effect(() => {\n    if (!options.isOpen.value || !options.positioner) return;\n\n    const reference = options.positioner.reference();\n    const floating = options.positioner.floating();\n\n    if (!reference || !floating) {\n      options.positioner.update();\n\n      return;\n    }\n\n    const cleanup = autoUpdate(reference, floating, () => options.positioner?.update());\n\n    onSignalCleanup(cleanup); // Auto-cleanup on effect re-run/end\n  });\n\n  const shouldRestoreFocus = (): boolean => {\n    if (typeof options.restoreFocus === 'function') return options.restoreFocus();\n\n    return options.restoreFocus ?? true;\n  };\n\n  const open = (reason: OverlayOpenReason = 'programmatic'): void => {\n    if (controlState.disabled.value || options.isOpen.value) return;\n\n    options.setOpen(true, reason);\n    requestAnimationFrame(() => options.positioner?.update());\n    options.onOpen?.(reason);\n  };\n\n  const close = (reason: OverlayCloseReason = 'programmatic', restoreFocus?: boolean): void => {\n    if (!options.isOpen.value) return;\n\n    options.setOpen(false, reason);\n\n    const restore = restoreFocus ?? shouldRestoreFocus();\n\n    if (restore) options.elements.trigger?.focus();\n\n    options.onClose?.(reason);\n  };\n\n  const toggle = (): void => {\n    if (options.isOpen.value) {\n      close('trigger');\n\n      return;\n    }\n\n    open('trigger');\n  };\n\n  const isInside = (element: HTMLElement | null | undefined, target: Node): boolean => {\n    return element ? element.contains(target) : false;\n  };\n\n  const bindOutsideClick = (target: Document | HTMLElement = document, capture = true): (() => void) => {\n    const handler = (event: Event) => {\n      if (!options.isOpen.value) return;\n\n      const el = event.composedPath()[0] as Node | null;\n\n      if (!el) return;\n\n      const inside = isInside(options.elements.boundary, el) || isInside(options.elements.panel, el);\n\n      if (!inside) close('outside-click');\n    };\n\n    target.addEventListener('click', handler, { capture });\n\n    return () => target.removeEventListener('click', handler, { capture });\n  };\n\n  return {\n    bindOutsideClick,\n    close,\n    open,\n    toggle,\n  };\n};\n"],"mappings":"wJAsCA,IAAa,EAAwB,GAAmD,CACtF,IAAM,EAAe,EAAA,mBAAmB,EAAQ,CAGhD,EAAA,WAAa,CACX,GAAI,CAAC,EAAQ,OAAO,OAAS,CAAC,EAAQ,WAAY,OAElD,IAAM,EAAY,EAAQ,WAAW,WAAW,CAC1C,EAAW,EAAQ,WAAW,UAAU,CAE9C,GAAI,CAAC,GAAa,CAAC,EAAU,CAC3B,EAAQ,WAAW,QAAQ,CAE3B,QAKF,EAAA,EAAA,YAAA,EAAA,EAAA,YAF2B,EAAW,MAAgB,EAAQ,YAAY,QAAQ,CAAC,CAE3D,EACxB,CAEF,IAAM,MACA,OAAO,EAAQ,cAAiB,WAAmB,EAAQ,cAAc,CAEtE,EAAQ,cAAgB,GAG3B,GAAQ,EAA4B,iBAAyB,CAC7D,EAAa,SAAS,OAAS,EAAQ,OAAO,QAElD,EAAQ,QAAQ,GAAM,EAAO,CAC7B,0BAA4B,EAAQ,YAAY,QAAQ,CAAC,CACzD,EAAQ,SAAS,EAAO,GAGpB,GAAS,EAA6B,eAAgB,IAAiC,CACtF,EAAQ,OAAO,QAEpB,EAAQ,QAAQ,GAAO,EAAO,EAEd,GAAgB,GAAoB,GAEvC,EAAQ,SAAS,SAAS,OAAO,CAE9C,EAAQ,UAAU,EAAO,GAGrB,MAAqB,CACzB,GAAI,EAAQ,OAAO,MAAO,CACxB,EAAM,UAAU,CAEhB,OAGF,EAAK,UAAU,EAGX,GAAY,EAAyC,IAClD,EAAU,EAAQ,SAAS,EAAO,CAAG,GAqB9C,MAAO,CACL,kBAnBwB,EAAiC,SAAU,EAAU,KAAuB,CACpG,IAAM,EAAW,GAAiB,CAChC,GAAI,CAAC,EAAQ,OAAO,MAAO,OAE3B,IAAM,EAAK,EAAM,cAAc,CAAC,GAE3B,IAEU,EAAS,EAAQ,SAAS,SAAU,EAAG,EAAI,EAAS,EAAQ,SAAS,MAAO,EAAG,EAEjF,EAAM,gBAAgB,GAKrC,OAFA,EAAO,iBAAiB,QAAS,EAAS,CAAE,UAAS,CAAC,KAEzC,EAAO,oBAAoB,QAAS,EAAS,CAAE,UAAS,CAAC,EAKtE,QACA,OACA,SACD"}
+{"version":3,"file":"overlay-control.cjs","names":[],"sources":["../../src/controls/overlay-control.ts"],"sourcesContent":["import { autoUpdate } from '@vielzeug/floatit';\n\nexport type OverlayOpenReason = 'programmatic' | 'trigger';\nexport type OverlayCloseReason = 'escape' | 'outside-click' | 'programmatic' | 'swipe' | 'trigger';\nexport type OverlayCloseDetail = { reason: OverlayCloseReason };\nexport type OverlayOpenDetail = { reason: OverlayOpenReason };\n\ntype OverlayPositioner = {\n  floating: () => HTMLElement | null;\n  reference: () => HTMLElement | null;\n  update: () => void;\n};\n\nexport type OverlayControlOptions = {\n  getBoundaryElement: () => HTMLElement | null;\n  getPanelElement?: () => HTMLElement | null;\n  getTriggerElement?: () => HTMLElement | null;\n  isDisabled?: () => boolean;\n  isOpen: () => boolean;\n  onClose?: (reason: OverlayCloseReason) => void;\n  onOpen?: (reason: OverlayOpenReason) => void;\n  positioner?: OverlayPositioner;\n  restoreFocus?: boolean | (() => boolean);\n  setOpen: (next: boolean, context: { reason: OverlayOpenReason | OverlayCloseReason }) => void;\n};\n\nexport type OverlayControl = {\n  close(opts?: { reason?: OverlayCloseReason; restoreFocus?: boolean }): void;\n  open(opts?: { reason?: OverlayOpenReason }): void;\n  toggle(): void;\n};\n\n// Module-level document click listener management for outside-click dismissal\nconst activeOverlayListeners = new Set<(event: Event) => void>();\nlet documentClickUnsubscribe: (() => void) | null = null;\n\nconst isDisposedComputedSignalError = (error: unknown): boolean =>\n  error instanceof Error && error.message.includes('[stateit] Cannot read disposed computed signal');\n\nconst ensureDocumentClickListener = (): void => {\n  if (documentClickUnsubscribe) return; // Already attached\n\n  const handler = (event: Event) => {\n    for (const listener of [...activeOverlayListeners]) {\n      try {\n        listener(event);\n      } catch (error) {\n        if (isDisposedComputedSignalError(error)) {\n          activeOverlayListeners.delete(listener);\n\n          continue;\n        }\n\n        throw error;\n      }\n    }\n\n    removeDocumentClickListener();\n  };\n\n  document.addEventListener('click', handler, { capture: true });\n  documentClickUnsubscribe = () => {\n    document.removeEventListener('click', handler, { capture: true });\n    documentClickUnsubscribe = null;\n  };\n};\n\nconst removeDocumentClickListener = (): void => {\n  if (activeOverlayListeners.size === 0 && documentClickUnsubscribe) {\n    documentClickUnsubscribe();\n  }\n};\n\nexport const createOverlayControl = (options: OverlayControlOptions): OverlayControl => {\n  let positionerCleanup: (() => void) | null = null;\n  let clickListener: ((event: Event) => void) | null = null;\n\n  const shouldRestoreFocus = (): boolean => {\n    if (typeof options.restoreFocus === 'function') return options.restoreFocus();\n\n    return options.restoreFocus ?? true;\n  };\n\n  // Local wrapper — handles click-listener registration without mutating options.\n  const commitOpen = (next: boolean, context: { reason: OverlayOpenReason | OverlayCloseReason }): void => {\n    try {\n      options.setOpen(next, context);\n    } catch (error) {\n      if (isDisposedComputedSignalError(error) && clickListener) {\n        activeOverlayListeners.delete(clickListener);\n        removeDocumentClickListener();\n\n        return;\n      }\n\n      throw error;\n    }\n\n    if (next && clickListener) {\n      activeOverlayListeners.add(clickListener);\n      ensureDocumentClickListener();\n    } else if (!next && clickListener) {\n      activeOverlayListeners.delete(clickListener);\n      removeDocumentClickListener();\n    }\n  };\n\n  const open = (opts: { reason?: OverlayOpenReason } = {}): void => {\n    const reason = opts.reason ?? 'programmatic';\n\n    if (options.isDisabled?.() || options.isOpen()) return;\n\n    commitOpen(true, { reason });\n\n    if (options.positioner) {\n      const reference = options.positioner.reference();\n      const floating = options.positioner.floating();\n\n      if (reference && floating) {\n        positionerCleanup = autoUpdate(reference, floating, () => options.positioner?.update());\n      }\n\n      options.positioner.update();\n    }\n\n    options.onOpen?.(reason);\n  };\n\n  const close = (opts: { reason?: OverlayCloseReason; restoreFocus?: boolean } = {}): void => {\n    const reason = opts.reason ?? 'programmatic';\n\n    if (!options.isOpen()) return;\n\n    commitOpen(false, { reason });\n\n    if (positionerCleanup) {\n      positionerCleanup();\n      positionerCleanup = null;\n    }\n\n    const restore = opts.restoreFocus ?? shouldRestoreFocus();\n\n    if (restore) options.getTriggerElement?.()?.focus();\n\n    options.onClose?.(reason);\n  };\n\n  const toggle = (): void => {\n    if (options.isOpen()) {\n      close({ reason: 'trigger' });\n\n      return;\n    }\n\n    open({ reason: 'trigger' });\n  };\n\n  clickListener = (event: Event) => {\n    if (!options.isOpen()) return;\n\n    const path = (event as Event & { composedPath?: () => EventTarget[] }).composedPath?.() ?? [];\n    const boundary = options.getBoundaryElement();\n    const panel = options.getPanelElement?.() ?? null;\n    const target = (path[0] ?? event.target) as EventTarget | null;\n    const nodeTarget = target instanceof Node ? target : null;\n\n    const insideByPath = path.some((entry) => entry === boundary || entry === panel);\n    const insideByContainment = nodeTarget\n      ? (boundary?.contains(nodeTarget) ?? false) || (panel?.contains(nodeTarget) ?? false)\n      : false;\n    const inside = insideByPath || insideByContainment;\n\n    if (!inside) close({ reason: 'outside-click' });\n  };\n\n  return {\n    close,\n    open,\n    toggle,\n  };\n};\n"],"mappings":"mCAiCA,IAAM,EAAyB,IAAI,IAC/B,EAAgD,KAE9C,EAAiC,GACrC,aAAiB,OAAS,EAAM,QAAQ,SAAS,gDAAgD,EAE7F,MAA0C,CAC9C,GAAI,EAA0B,OAE9B,IAAM,EAAW,GAAiB,CAChC,IAAK,IAAM,IAAY,CAAC,GAAG,CAAsB,EAC/C,GAAI,CACF,EAAS,CAAK,CAChB,OAAS,EAAO,CACd,GAAI,EAA8B,CAAK,EAAG,CACxC,EAAuB,OAAO,CAAQ,EAEtC,QACF,CAEA,MAAM,CACR,CAGF,EAA4B,CAC9B,EAEA,SAAS,iBAAiB,QAAS,EAAS,CAAE,QAAS,EAAK,CAAC,EAC7D,MAAiC,CAC/B,SAAS,oBAAoB,QAAS,EAAS,CAAE,QAAS,EAAK,CAAC,EAChE,EAA2B,IAC7B,CACF,EAEM,MAA0C,CAC1C,EAAuB,OAAS,GAAK,GACvC,EAAyB,CAE7B,EAEa,EAAwB,GAAmD,CACtF,IAAI,EAAyC,KACzC,EAAiD,KAE/C,MACA,OAAO,EAAQ,cAAiB,WAAmB,EAAQ,aAAa,EAErE,EAAQ,cAAgB,GAI3B,GAAc,EAAe,IAAsE,CACvG,GAAI,CACF,EAAQ,QAAQ,EAAM,CAAO,CAC/B,OAAS,EAAO,CACd,GAAI,EAA8B,CAAK,GAAK,EAAe,CACzD,EAAuB,OAAO,CAAa,EAC3C,EAA4B,EAE5B,MACF,CAEA,MAAM,CACR,CAEI,GAAQ,GACV,EAAuB,IAAI,CAAa,EACxC,EAA4B,GACnB,CAAC,GAAQ,IAClB,EAAuB,OAAO,CAAa,EAC3C,EAA4B,EAEhC,EAEM,GAAQ,EAAuC,CAAC,IAAY,CAChE,IAAM,EAAS,EAAK,QAAU,eAE1B,OAAQ,aAAa,GAAK,EAAQ,OAAO,GAI7C,IAFA,EAAW,GAAM,CAAE,QAAO,CAAC,EAEvB,EAAQ,WAAY,CACtB,IAAM,EAAY,EAAQ,WAAW,UAAU,EACzC,EAAW,EAAQ,WAAW,SAAS,EAEzC,GAAa,IACf,GAAA,EAAA,EAAA,YAA+B,EAAW,MAAgB,EAAQ,YAAY,OAAO,CAAC,GAGxF,EAAQ,WAAW,OAAO,CAC5B,CAEA,EAAQ,SAAS,CAAM,CAFvB,CAGF,EAEM,GAAS,EAAgE,CAAC,IAAY,CAC1F,IAAM,EAAS,EAAK,QAAU,eAEzB,EAAQ,OAAO,IAEpB,EAAW,GAAO,CAAE,QAAO,CAAC,EAE5B,AAEE,KADA,EAAkB,EACE,OAGN,EAAK,cAAgB,EAAmB,IAE3C,EAAQ,oBAAoB,GAAG,MAAM,EAElD,EAAQ,UAAU,CAAM,EAC1B,EA8BA,MAlBA,GAAiB,GAAiB,CAChC,GAAI,CAAC,EAAQ,OAAO,EAAG,OAEvB,IAAM,EAAQ,EAAyD,eAAe,GAAK,CAAC,EACtF,EAAW,EAAQ,mBAAmB,EACtC,EAAQ,EAAQ,kBAAkB,GAAK,KACvC,EAAU,EAAK,IAAM,EAAM,OAC3B,EAAa,aAAkB,KAAO,EAAS,KAE/C,EAAe,EAAK,KAAM,GAAU,IAAU,GAAY,IAAU,CAAK,EACzE,EAAsB,GACvB,GAAU,SAAS,CAAU,GAAK,MAAW,GAAO,SAAS,CAAU,GAAK,IAC7E,GACW,GAAgB,GAElB,EAAM,CAAE,OAAQ,eAAgB,CAAC,CAChD,EAEO,CACL,QACA,OACA,WA/ByB,CACzB,GAAI,EAAQ,OAAO,EAAG,CACpB,EAAM,CAAE,OAAQ,SAAU,CAAC,EAE3B,MACF,CAEA,EAAK,CAAE,OAAQ,SAAU,CAAC,CAC5B,CAwBA,CACF"}

package/dist/controls/overlay-control.d.ts

@@ -1,7 +1,5 @@
-import { type ReadonlySignal } from '@vielzeug/stateit';
-import { type ControlContextOptions } from './internal/control-state';
 export type OverlayOpenReason = 'programmatic' | 'trigger';
-export type OverlayCloseReason = 'escape' | 'outside-click' | 'programmatic' | 'trigger';
+export type OverlayCloseReason = 'escape' | 'outside-click' | 'programmatic' | 'swipe' | 'trigger';
 export type OverlayCloseDetail = {
     reason: OverlayCloseReason;
 };
@@ -13,23 +11,28 @@ type OverlayPositioner = {
     reference: () => HTMLElement | null;
     update: () => void;
 };
-export type OverlayControlOptions = ControlContextOptions & {
-    elements: {
-        boundary: HTMLElement;
-        panel?: HTMLElement | null;
-        trigger?: HTMLElement | null;
-    };
-    isOpen: ReadonlySignal<boolean>;
+export type OverlayControlOptions = {
+    getBoundaryElement: () => HTMLElement | null;
+    getPanelElement?: () => HTMLElement | null;
+    getTriggerElement?: () => HTMLElement | null;
+    isDisabled?: () => boolean;
+    isOpen: () => boolean;
     onClose?: (reason: OverlayCloseReason) => void;
     onOpen?: (reason: OverlayOpenReason) => void;
     positioner?: OverlayPositioner;
     restoreFocus?: boolean | (() => boolean);
-    setOpen: (next: boolean, reason: OverlayOpenReason | OverlayCloseReason) => void;
+    setOpen: (next: boolean, context: {
+        reason: OverlayOpenReason | OverlayCloseReason;
+    }) => void;
 };
 export type OverlayControl = {
-    bindOutsideClick(target?: Document | HTMLElement, capture?: boolean): () => void;
-    close(reason?: OverlayCloseReason, restoreFocus?: boolean): void;
-    open(reason?: OverlayOpenReason): void;
+    close(opts?: {
+        reason?: OverlayCloseReason;
+        restoreFocus?: boolean;
+    }): void;
+    open(opts?: {
+        reason?: OverlayOpenReason;
+    }): void;
     toggle(): void;
 };
 export declare const createOverlayControl: (options: OverlayControlOptions) => OverlayControl;

package/dist/controls/overlay-control.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"overlay-control.d.ts","sourceRoot":"","sources":["../../src/controls/overlay-control.ts"],"names":[],"mappings":"AACA,OAAO,EAAgC,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGtF,OAAO,EAAsB,KAAK,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAE1F,MAAM,MAAM,iBAAiB,GAAG,cAAc,GAAG,SAAS,CAAC;AAC3D,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG,eAAe,GAAG,cAAc,GAAG,SAAS,CAAC;AACzF,MAAM,MAAM,kBAAkB,GAAG;IAAE,MAAM,EAAE,kBAAkB,CAAA;CAAE,CAAC;AAChE,MAAM,MAAM,iBAAiB,GAAG;IAAE,MAAM,EAAE,iBAAiB,CAAA;CAAE,CAAC;AAE9D,KAAK,iBAAiB,GAAG;IACvB,QAAQ,EAAE,MAAM,WAAW,GAAG,IAAI,CAAC;IACnC,SAAS,EAAE,MAAM,WAAW,GAAG,IAAI,CAAC;IACpC,MAAM,EAAE,MAAM,IAAI,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG,qBAAqB,GAAG;IAC1D,QAAQ,EAAE;QACR,QAAQ,EAAE,WAAW,CAAC;QACtB,KAAK,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;QAC3B,OAAO,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;KAC9B,CAAC;IACF,MAAM,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC;IAChC,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,IAAI,CAAC;IAC/C,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,iBAAiB,KAAK,IAAI,CAAC;IAC7C,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B,YAAY,CAAC,EAAE,OAAO,GAAG,CAAC,MAAM,OAAO,CAAC,CAAC;IACzC,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,iBAAiB,GAAG,kBAAkB,KAAK,IAAI,CAAC;CAClF,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,gBAAgB,CAAC,MAAM,CAAC,EAAE,QAAQ,GAAG,WAAW,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,MAAM,IAAI,CAAC;IACjF,KAAK,CAAC,MAAM,CAAC,EAAE,kBAAkB,EAAE,YAAY,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACjE,IAAI,CAAC,MAAM,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACvC,MAAM,IAAI,IAAI,CAAC;CAChB,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAAI,SAAS,qBAAqB,KAAG,cAqFrE,CAAC"}
+{"version":3,"file":"overlay-control.d.ts","sourceRoot":"","sources":["../../src/controls/overlay-control.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,iBAAiB,GAAG,cAAc,GAAG,SAAS,CAAC;AAC3D,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG,eAAe,GAAG,cAAc,GAAG,OAAO,GAAG,SAAS,CAAC;AACnG,MAAM,MAAM,kBAAkB,GAAG;IAAE,MAAM,EAAE,kBAAkB,CAAA;CAAE,CAAC;AAChE,MAAM,MAAM,iBAAiB,GAAG;IAAE,MAAM,EAAE,iBAAiB,CAAA;CAAE,CAAC;AAE9D,KAAK,iBAAiB,GAAG;IACvB,QAAQ,EAAE,MAAM,WAAW,GAAG,IAAI,CAAC;IACnC,SAAS,EAAE,MAAM,WAAW,GAAG,IAAI,CAAC;IACpC,MAAM,EAAE,MAAM,IAAI,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,kBAAkB,EAAE,MAAM,WAAW,GAAG,IAAI,CAAC;IAC7C,eAAe,CAAC,EAAE,MAAM,WAAW,GAAG,IAAI,CAAC;IAC3C,iBAAiB,CAAC,EAAE,MAAM,WAAW,GAAG,IAAI,CAAC;IAC7C,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC;IAC3B,MAAM,EAAE,MAAM,OAAO,CAAC;IACtB,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,IAAI,CAAC;IAC/C,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,iBAAiB,KAAK,IAAI,CAAC;IAC7C,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B,YAAY,CAAC,EAAE,OAAO,GAAG,CAAC,MAAM,OAAO,CAAC,CAAC;IACzC,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE;QAAE,MAAM,EAAE,iBAAiB,GAAG,kBAAkB,CAAA;KAAE,KAAK,IAAI,CAAC;CAC/F,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,KAAK,CAAC,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,kBAAkB,CAAC;QAAC,YAAY,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IAC5E,IAAI,CAAC,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,iBAAiB,CAAA;KAAE,GAAG,IAAI,CAAC;IAClD,MAAM,IAAI,IAAI,CAAC;CAChB,CAAC;AA2CF,eAAO,MAAM,oBAAoB,GAAI,SAAS,qBAAqB,KAAG,cA2GrE,CAAC"}

package/dist/controls/overlay-control.js

@@ -1,2 +1,2 @@
-import{effect as e}from"../runtime-lifecycle.js";import{createControlState as t}from"./internal/control-state.js";import{onCleanup as n}from"@vielzeug/stateit";import{autoUpdate as r}from"@vielzeug/floatit";var i=i=>{let a=t(i);e(()=>{if(!i.isOpen.value||!i.positioner)return;let e=i.positioner.reference(),t=i.positioner.floating();if(!e||!t){i.positioner.update();return}n(r(e,t,()=>i.positioner?.update()))});let o=()=>typeof i.restoreFocus==`function`?i.restoreFocus():i.restoreFocus??!0,s=(e=`programmatic`)=>{a.disabled.value||i.isOpen.value||(i.setOpen(!0,e),requestAnimationFrame(()=>i.positioner?.update()),i.onOpen?.(e))},c=(e=`programmatic`,t)=>{i.isOpen.value&&(i.setOpen(!1,e),(t??o())&&i.elements.trigger?.focus(),i.onClose?.(e))},l=()=>{if(i.isOpen.value){c(`trigger`);return}s(`trigger`)},u=(e,t)=>e?e.contains(t):!1;return{bindOutsideClick:(e=document,t=!0)=>{let n=e=>{if(!i.isOpen.value)return;let t=e.composedPath()[0];t&&(u(i.elements.boundary,t)||u(i.elements.panel,t)||c(`outside-click`))};return e.addEventListener(`click`,n,{capture:t}),()=>e.removeEventListener(`click`,n,{capture:t})},close:c,open:s,toggle:l}};export{i as createOverlayControl};
+import{autoUpdate as e}from"@vielzeug/floatit";var t=new Set,n=null,r=e=>e instanceof Error&&e.message.includes(`[stateit] Cannot read disposed computed signal`),i=()=>{if(n)return;let e=e=>{for(let n of[...t])try{n(e)}catch(e){if(r(e)){t.delete(n);continue}throw e}a()};document.addEventListener(`click`,e,{capture:!0}),n=()=>{document.removeEventListener(`click`,e,{capture:!0}),n=null}},a=()=>{t.size===0&&n&&n()},o=n=>{let o=null,s=null,c=()=>typeof n.restoreFocus==`function`?n.restoreFocus():n.restoreFocus??!0,l=(e,o)=>{try{n.setOpen(e,o)}catch(e){if(r(e)&&s){t.delete(s),a();return}throw e}e&&s?(t.add(s),i()):!e&&s&&(t.delete(s),a())},u=(t={})=>{let r=t.reason??`programmatic`;if(!(n.isDisabled?.()||n.isOpen())){if(l(!0,{reason:r}),n.positioner){let t=n.positioner.reference(),r=n.positioner.floating();t&&r&&(o=e(t,r,()=>n.positioner?.update())),n.positioner.update()}n.onOpen?.(r)}},d=(e={})=>{let t=e.reason??`programmatic`;n.isOpen()&&(l(!1,{reason:t}),o&&=(o(),null),(e.restoreFocus??c())&&n.getTriggerElement?.()?.focus(),n.onClose?.(t))};return s=e=>{if(!n.isOpen())return;let t=e.composedPath?.()??[],r=n.getBoundaryElement(),i=n.getPanelElement?.()??null,a=t[0]??e.target,o=a instanceof Node?a:null,s=t.some(e=>e===r||e===i),c=o?(r?.contains(o)??!1)||(i?.contains(o)??!1):!1;s||c||d({reason:`outside-click`})},{close:d,open:u,toggle:()=>{if(n.isOpen()){d({reason:`trigger`});return}u({reason:`trigger`})}}};export{o as createOverlayControl};
 //# sourceMappingURL=overlay-control.js.map

package/dist/controls/overlay-control.js.map

@@ -1 +1 @@
-{"version":3,"file":"overlay-control.js","names":[],"sources":["../../src/controls/overlay-control.ts"],"sourcesContent":["import { autoUpdate } from '@vielzeug/floatit';\nimport { onCleanup as onSignalCleanup, type ReadonlySignal } from '@vielzeug/stateit';\n\nimport { effect } from '../runtime-lifecycle';\nimport { createControlState, type ControlContextOptions } from './internal/control-state';\n\nexport type OverlayOpenReason = 'programmatic' | 'trigger';\nexport type OverlayCloseReason = 'escape' | 'outside-click' | 'programmatic' | 'trigger';\nexport type OverlayCloseDetail = { reason: OverlayCloseReason };\nexport type OverlayOpenDetail = { reason: OverlayOpenReason };\n\ntype OverlayPositioner = {\n  floating: () => HTMLElement | null;\n  reference: () => HTMLElement | null;\n  update: () => void;\n};\n\nexport type OverlayControlOptions = ControlContextOptions & {\n  elements: {\n    boundary: HTMLElement;\n    panel?: HTMLElement | null;\n    trigger?: HTMLElement | null;\n  };\n  isOpen: ReadonlySignal<boolean>;\n  onClose?: (reason: OverlayCloseReason) => void;\n  onOpen?: (reason: OverlayOpenReason) => void;\n  positioner?: OverlayPositioner;\n  restoreFocus?: boolean | (() => boolean);\n  setOpen: (next: boolean, reason: OverlayOpenReason | OverlayCloseReason) => void;\n};\n\nexport type OverlayControl = {\n  bindOutsideClick(target?: Document | HTMLElement, capture?: boolean): () => void;\n  close(reason?: OverlayCloseReason, restoreFocus?: boolean): void;\n  open(reason?: OverlayOpenReason): void;\n  toggle(): void;\n};\n\nexport const createOverlayControl = (options: OverlayControlOptions): OverlayControl => {\n  const controlState = createControlState(options);\n\n  // Effect handles positioning lifecycle automatically\n  effect(() => {\n    if (!options.isOpen.value || !options.positioner) return;\n\n    const reference = options.positioner.reference();\n    const floating = options.positioner.floating();\n\n    if (!reference || !floating) {\n      options.positioner.update();\n\n      return;\n    }\n\n    const cleanup = autoUpdate(reference, floating, () => options.positioner?.update());\n\n    onSignalCleanup(cleanup); // Auto-cleanup on effect re-run/end\n  });\n\n  const shouldRestoreFocus = (): boolean => {\n    if (typeof options.restoreFocus === 'function') return options.restoreFocus();\n\n    return options.restoreFocus ?? true;\n  };\n\n  const open = (reason: OverlayOpenReason = 'programmatic'): void => {\n    if (controlState.disabled.value || options.isOpen.value) return;\n\n    options.setOpen(true, reason);\n    requestAnimationFrame(() => options.positioner?.update());\n    options.onOpen?.(reason);\n  };\n\n  const close = (reason: OverlayCloseReason = 'programmatic', restoreFocus?: boolean): void => {\n    if (!options.isOpen.value) return;\n\n    options.setOpen(false, reason);\n\n    const restore = restoreFocus ?? shouldRestoreFocus();\n\n    if (restore) options.elements.trigger?.focus();\n\n    options.onClose?.(reason);\n  };\n\n  const toggle = (): void => {\n    if (options.isOpen.value) {\n      close('trigger');\n\n      return;\n    }\n\n    open('trigger');\n  };\n\n  const isInside = (element: HTMLElement | null | undefined, target: Node): boolean => {\n    return element ? element.contains(target) : false;\n  };\n\n  const bindOutsideClick = (target: Document | HTMLElement = document, capture = true): (() => void) => {\n    const handler = (event: Event) => {\n      if (!options.isOpen.value) return;\n\n      const el = event.composedPath()[0] as Node | null;\n\n      if (!el) return;\n\n      const inside = isInside(options.elements.boundary, el) || isInside(options.elements.panel, el);\n\n      if (!inside) close('outside-click');\n    };\n\n    target.addEventListener('click', handler, { capture });\n\n    return () => target.removeEventListener('click', handler, { capture });\n  };\n\n  return {\n    bindOutsideClick,\n    close,\n    open,\n    toggle,\n  };\n};\n"],"mappings":"+MAsCA,IAAa,EAAwB,GAAmD,CACtF,IAAM,EAAe,EAAmB,EAAQ,CAGhD,MAAa,CACX,GAAI,CAAC,EAAQ,OAAO,OAAS,CAAC,EAAQ,WAAY,OAElD,IAAM,EAAY,EAAQ,WAAW,WAAW,CAC1C,EAAW,EAAQ,WAAW,UAAU,CAE9C,GAAI,CAAC,GAAa,CAAC,EAAU,CAC3B,EAAQ,WAAW,QAAQ,CAE3B,OAKF,EAFgB,EAAW,EAAW,MAAgB,EAAQ,YAAY,QAAQ,CAAC,CAE3D,EACxB,CAEF,IAAM,MACA,OAAO,EAAQ,cAAiB,WAAmB,EAAQ,cAAc,CAEtE,EAAQ,cAAgB,GAG3B,GAAQ,EAA4B,iBAAyB,CAC7D,EAAa,SAAS,OAAS,EAAQ,OAAO,QAElD,EAAQ,QAAQ,GAAM,EAAO,CAC7B,0BAA4B,EAAQ,YAAY,QAAQ,CAAC,CACzD,EAAQ,SAAS,EAAO,GAGpB,GAAS,EAA6B,eAAgB,IAAiC,CACtF,EAAQ,OAAO,QAEpB,EAAQ,QAAQ,GAAO,EAAO,EAEd,GAAgB,GAAoB,GAEvC,EAAQ,SAAS,SAAS,OAAO,CAE9C,EAAQ,UAAU,EAAO,GAGrB,MAAqB,CACzB,GAAI,EAAQ,OAAO,MAAO,CACxB,EAAM,UAAU,CAEhB,OAGF,EAAK,UAAU,EAGX,GAAY,EAAyC,IAClD,EAAU,EAAQ,SAAS,EAAO,CAAG,GAqB9C,MAAO,CACL,kBAnBwB,EAAiC,SAAU,EAAU,KAAuB,CACpG,IAAM,EAAW,GAAiB,CAChC,GAAI,CAAC,EAAQ,OAAO,MAAO,OAE3B,IAAM,EAAK,EAAM,cAAc,CAAC,GAE3B,IAEU,EAAS,EAAQ,SAAS,SAAU,EAAG,EAAI,EAAS,EAAQ,SAAS,MAAO,EAAG,EAEjF,EAAM,gBAAgB,GAKrC,OAFA,EAAO,iBAAiB,QAAS,EAAS,CAAE,UAAS,CAAC,KAEzC,EAAO,oBAAoB,QAAS,EAAS,CAAE,UAAS,CAAC,EAKtE,QACA,OACA,SACD"}
+{"version":3,"file":"overlay-control.js","names":[],"sources":["../../src/controls/overlay-control.ts"],"sourcesContent":["import { autoUpdate } from '@vielzeug/floatit';\n\nexport type OverlayOpenReason = 'programmatic' | 'trigger';\nexport type OverlayCloseReason = 'escape' | 'outside-click' | 'programmatic' | 'swipe' | 'trigger';\nexport type OverlayCloseDetail = { reason: OverlayCloseReason };\nexport type OverlayOpenDetail = { reason: OverlayOpenReason };\n\ntype OverlayPositioner = {\n  floating: () => HTMLElement | null;\n  reference: () => HTMLElement | null;\n  update: () => void;\n};\n\nexport type OverlayControlOptions = {\n  getBoundaryElement: () => HTMLElement | null;\n  getPanelElement?: () => HTMLElement | null;\n  getTriggerElement?: () => HTMLElement | null;\n  isDisabled?: () => boolean;\n  isOpen: () => boolean;\n  onClose?: (reason: OverlayCloseReason) => void;\n  onOpen?: (reason: OverlayOpenReason) => void;\n  positioner?: OverlayPositioner;\n  restoreFocus?: boolean | (() => boolean);\n  setOpen: (next: boolean, context: { reason: OverlayOpenReason | OverlayCloseReason }) => void;\n};\n\nexport type OverlayControl = {\n  close(opts?: { reason?: OverlayCloseReason; restoreFocus?: boolean }): void;\n  open(opts?: { reason?: OverlayOpenReason }): void;\n  toggle(): void;\n};\n\n// Module-level document click listener management for outside-click dismissal\nconst activeOverlayListeners = new Set<(event: Event) => void>();\nlet documentClickUnsubscribe: (() => void) | null = null;\n\nconst isDisposedComputedSignalError = (error: unknown): boolean =>\n  error instanceof Error && error.message.includes('[stateit] Cannot read disposed computed signal');\n\nconst ensureDocumentClickListener = (): void => {\n  if (documentClickUnsubscribe) return; // Already attached\n\n  const handler = (event: Event) => {\n    for (const listener of [...activeOverlayListeners]) {\n      try {\n        listener(event);\n      } catch (error) {\n        if (isDisposedComputedSignalError(error)) {\n          activeOverlayListeners.delete(listener);\n\n          continue;\n        }\n\n        throw error;\n      }\n    }\n\n    removeDocumentClickListener();\n  };\n\n  document.addEventListener('click', handler, { capture: true });\n  documentClickUnsubscribe = () => {\n    document.removeEventListener('click', handler, { capture: true });\n    documentClickUnsubscribe = null;\n  };\n};\n\nconst removeDocumentClickListener = (): void => {\n  if (activeOverlayListeners.size === 0 && documentClickUnsubscribe) {\n    documentClickUnsubscribe();\n  }\n};\n\nexport const createOverlayControl = (options: OverlayControlOptions): OverlayControl => {\n  let positionerCleanup: (() => void) | null = null;\n  let clickListener: ((event: Event) => void) | null = null;\n\n  const shouldRestoreFocus = (): boolean => {\n    if (typeof options.restoreFocus === 'function') return options.restoreFocus();\n\n    return options.restoreFocus ?? true;\n  };\n\n  // Local wrapper — handles click-listener registration without mutating options.\n  const commitOpen = (next: boolean, context: { reason: OverlayOpenReason | OverlayCloseReason }): void => {\n    try {\n      options.setOpen(next, context);\n    } catch (error) {\n      if (isDisposedComputedSignalError(error) && clickListener) {\n        activeOverlayListeners.delete(clickListener);\n        removeDocumentClickListener();\n\n        return;\n      }\n\n      throw error;\n    }\n\n    if (next && clickListener) {\n      activeOverlayListeners.add(clickListener);\n      ensureDocumentClickListener();\n    } else if (!next && clickListener) {\n      activeOverlayListeners.delete(clickListener);\n      removeDocumentClickListener();\n    }\n  };\n\n  const open = (opts: { reason?: OverlayOpenReason } = {}): void => {\n    const reason = opts.reason ?? 'programmatic';\n\n    if (options.isDisabled?.() || options.isOpen()) return;\n\n    commitOpen(true, { reason });\n\n    if (options.positioner) {\n      const reference = options.positioner.reference();\n      const floating = options.positioner.floating();\n\n      if (reference && floating) {\n        positionerCleanup = autoUpdate(reference, floating, () => options.positioner?.update());\n      }\n\n      options.positioner.update();\n    }\n\n    options.onOpen?.(reason);\n  };\n\n  const close = (opts: { reason?: OverlayCloseReason; restoreFocus?: boolean } = {}): void => {\n    const reason = opts.reason ?? 'programmatic';\n\n    if (!options.isOpen()) return;\n\n    commitOpen(false, { reason });\n\n    if (positionerCleanup) {\n      positionerCleanup();\n      positionerCleanup = null;\n    }\n\n    const restore = opts.restoreFocus ?? shouldRestoreFocus();\n\n    if (restore) options.getTriggerElement?.()?.focus();\n\n    options.onClose?.(reason);\n  };\n\n  const toggle = (): void => {\n    if (options.isOpen()) {\n      close({ reason: 'trigger' });\n\n      return;\n    }\n\n    open({ reason: 'trigger' });\n  };\n\n  clickListener = (event: Event) => {\n    if (!options.isOpen()) return;\n\n    const path = (event as Event & { composedPath?: () => EventTarget[] }).composedPath?.() ?? [];\n    const boundary = options.getBoundaryElement();\n    const panel = options.getPanelElement?.() ?? null;\n    const target = (path[0] ?? event.target) as EventTarget | null;\n    const nodeTarget = target instanceof Node ? target : null;\n\n    const insideByPath = path.some((entry) => entry === boundary || entry === panel);\n    const insideByContainment = nodeTarget\n      ? (boundary?.contains(nodeTarget) ?? false) || (panel?.contains(nodeTarget) ?? false)\n      : false;\n    const inside = insideByPath || insideByContainment;\n\n    if (!inside) close({ reason: 'outside-click' });\n  };\n\n  return {\n    close,\n    open,\n    toggle,\n  };\n};\n"],"mappings":"+CAiCA,IAAM,EAAyB,IAAI,IAC/B,EAAgD,KAE9C,EAAiC,GACrC,aAAiB,OAAS,EAAM,QAAQ,SAAS,gDAAgD,EAE7F,MAA0C,CAC9C,GAAI,EAA0B,OAE9B,IAAM,EAAW,GAAiB,CAChC,IAAK,IAAM,IAAY,CAAC,GAAG,CAAsB,EAC/C,GAAI,CACF,EAAS,CAAK,CAChB,OAAS,EAAO,CACd,GAAI,EAA8B,CAAK,EAAG,CACxC,EAAuB,OAAO,CAAQ,EAEtC,QACF,CAEA,MAAM,CACR,CAGF,EAA4B,CAC9B,EAEA,SAAS,iBAAiB,QAAS,EAAS,CAAE,QAAS,EAAK,CAAC,EAC7D,MAAiC,CAC/B,SAAS,oBAAoB,QAAS,EAAS,CAAE,QAAS,EAAK,CAAC,EAChE,EAA2B,IAC7B,CACF,EAEM,MAA0C,CAC1C,EAAuB,OAAS,GAAK,GACvC,EAAyB,CAE7B,EAEa,EAAwB,GAAmD,CACtF,IAAI,EAAyC,KACzC,EAAiD,KAE/C,MACA,OAAO,EAAQ,cAAiB,WAAmB,EAAQ,aAAa,EAErE,EAAQ,cAAgB,GAI3B,GAAc,EAAe,IAAsE,CACvG,GAAI,CACF,EAAQ,QAAQ,EAAM,CAAO,CAC/B,OAAS,EAAO,CACd,GAAI,EAA8B,CAAK,GAAK,EAAe,CACzD,EAAuB,OAAO,CAAa,EAC3C,EAA4B,EAE5B,MACF,CAEA,MAAM,CACR,CAEI,GAAQ,GACV,EAAuB,IAAI,CAAa,EACxC,EAA4B,GACnB,CAAC,GAAQ,IAClB,EAAuB,OAAO,CAAa,EAC3C,EAA4B,EAEhC,EAEM,GAAQ,EAAuC,CAAC,IAAY,CAChE,IAAM,EAAS,EAAK,QAAU,eAE1B,OAAQ,aAAa,GAAK,EAAQ,OAAO,GAI7C,IAFA,EAAW,GAAM,CAAE,QAAO,CAAC,EAEvB,EAAQ,WAAY,CACtB,IAAM,EAAY,EAAQ,WAAW,UAAU,EACzC,EAAW,EAAQ,WAAW,SAAS,EAEzC,GAAa,IACf,EAAoB,EAAW,EAAW,MAAgB,EAAQ,YAAY,OAAO,CAAC,GAGxF,EAAQ,WAAW,OAAO,CAC5B,CAEA,EAAQ,SAAS,CAAM,CAFvB,CAGF,EAEM,GAAS,EAAgE,CAAC,IAAY,CAC1F,IAAM,EAAS,EAAK,QAAU,eAEzB,EAAQ,OAAO,IAEpB,EAAW,GAAO,CAAE,QAAO,CAAC,EAE5B,AAEE,KADA,EAAkB,EACE,OAGN,EAAK,cAAgB,EAAmB,IAE3C,EAAQ,oBAAoB,GAAG,MAAM,EAElD,EAAQ,UAAU,CAAM,EAC1B,EA8BA,MAlBA,GAAiB,GAAiB,CAChC,GAAI,CAAC,EAAQ,OAAO,EAAG,OAEvB,IAAM,EAAQ,EAAyD,eAAe,GAAK,CAAC,EACtF,EAAW,EAAQ,mBAAmB,EACtC,EAAQ,EAAQ,kBAAkB,GAAK,KACvC,EAAU,EAAK,IAAM,EAAM,OAC3B,EAAa,aAAkB,KAAO,EAAS,KAE/C,EAAe,EAAK,KAAM,GAAU,IAAU,GAAY,IAAU,CAAK,EACzE,EAAsB,GACvB,GAAU,SAAS,CAAU,GAAK,MAAW,GAAO,SAAS,CAAU,GAAK,IAC7E,GACW,GAAgB,GAElB,EAAM,CAAE,OAAQ,eAAgB,CAAC,CAChD,EAEO,CACL,QACA,OACA,WA/ByB,CACzB,GAAI,EAAQ,OAAO,EAAG,CACpB,EAAM,CAAE,OAAQ,SAAU,CAAC,EAE3B,MACF,CAEA,EAAK,CAAE,OAAQ,SAAU,CAAC,CAC5B,CAwBA,CACF"}

package/dist/controls/popup-list-control.cjs

@@ -0,0 +1,2 @@
+const e=require(`./list-control.cjs`),t=require(`./overlay-control.cjs`),n=require(`../host.cjs`);let r=require(`@vielzeug/stateit`);var i=i=>{let a=e.createListControl({disabled:()=>!i.isOpen(),getIndex:i.getIndex,getItems:i.getItems,isItemDisabled:i.isItemDisabled,keys:i.keyboardMapping,loop:i.loop??!0,onNavigate:(e,t,n)=>{t>=0&&i.onNavigate?.(e,t,n)},setIndex:i.setIndex}),o=t.createOverlayControl({getBoundaryElement:i.getBoundaryElement,getPanelElement:i.getPanelElement,getTriggerElement:i.getTriggerElement,isDisabled:i.isDisabled,isOpen:i.isOpen,onClose:i.onClose,onOpen:i.onOpen,positioner:i.positioner,restoreFocus:i.restoreFocus,setOpen:i.setOpen}),s=(e=`listbox`)=>e===`menu`?{defaultTriggerAttributes:{controls:()=>i.listId,haspopup:`menu`},defaultTriggerRole:`button`}:{defaultTriggerAttributes:{controls:()=>i.listId,haspopup:`listbox`},defaultTriggerRole:`combobox`},c=(e,t)=>{let r=s(t?.role??i.ariaSync?.role??`listbox`);return n.syncAria(e,{...r.defaultTriggerAttributes,...t?.additional,...i.ariaSync?.additional,disabled:()=>i.isDisabled?.()??!1,expanded:()=>i.isOpen()?`true`:`false`,role:r.defaultTriggerRole})};return i.triggerRef&&(0,r.watch)(()=>i.triggerRef?.value,e=>{if(e)return c(e,i.ariaSync)}),{close:e=>o.close({reason:e??`programmatic`}),first:a.first,getActiveItem:a.getActiveItem,handleListKeydown:a.handleKeydown,last:a.last,next:a.next,open:e=>o.open({reason:e??`programmatic`}),prev:a.prev,reset:a.reset,set:a.set,toggle:o.toggle}};exports.createPopupListControl=i;
+//# sourceMappingURL=popup-list-control.cjs.map

package/dist/controls/popup-list-control.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"popup-list-control.cjs","names":[],"sources":["../../src/controls/popup-list-control.ts"],"sourcesContent":["import { watch } from '@vielzeug/stateit';\n\nimport type { OverlayCloseReason, OverlayOpenReason } from './overlay-control';\n\nimport { syncAria } from '../host';\nimport { createListControl } from './list-control';\nimport { createOverlayControl } from './overlay-control';\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Types\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * ARIA role for the popup list. Affects which attributes are synced to the trigger.\n * - 'listbox': For select/combobox (role=\"combobox\" on trigger, role=\"listbox\" on panel)\n * - 'menu': For menus (role=\"menu\" on trigger, role=\"menu\" on panel)\n */\nexport type PopupListRole = 'listbox' | 'menu';\n\n/**\n * Configuration for syncing ARIA attributes to the trigger element.\n * Automatically handles role-specific attributes like aria-haspopup.\n */\nexport type PopupListAriaSyncConfig = {\n  /**\n   * Additional ARIA attributes to sync to the trigger beyond the standard ones.\n   * These will be merged with role-specific defaults.\n   */\n  additional?: Record<\n    string,\n    boolean | null | number | string | undefined | (() => boolean | null | number | string | undefined)\n  >;\n  /**\n   * The role of the popup list component. Controls which ARIA attributes are synced.\n   * @default 'listbox'\n   */\n  role?: PopupListRole;\n};\n\n/**\n * Configuration for positioning the popup list using floatit.\n */\nexport type PopupListPositioner = {\n  /** Gets the floating element (popup panel) */\n  floating: () => HTMLElement | null;\n  /** Get the reference element (trigger) */\n  reference: () => HTMLElement | null;\n  /** Update the position (called on open and during auto-update) */\n  update: () => void;\n};\n\n/**\n * Main options for createPopupListControl.\n */\nexport type PopupListControlOptions<T> = {\n  // ARIA\n  /** Configuration for ARIA attributes */\n  ariaSync?: PopupListAriaSyncConfig;\n  // Overlay\n  /** Get the boundary element (for click-outside detection) */\n  getBoundaryElement: () => HTMLElement | null;\n\n  // List state\n  /** Get the current focused index (-1 if none focused) */\n  getIndex: () => number;\n  /** Get all items in the list */\n  getItems: () => T[];\n  /** Get the panel element */\n  getPanelElement: () => HTMLElement | null;\n\n  /** Get the trigger element */\n  getTriggerElement: () => HTMLElement | null;\n  // Overlay state\n  /** Check if disabled */\n  isDisabled?: () => boolean;\n\n  // List navigation\n  /** Check if an item is disabled */\n  isItemDisabled?: (item: T, index: number) => boolean;\n\n  /** Whether the popup is open */\n  isOpen: () => boolean;\n  /** Custom keyboard mappings for list navigation. Defaults to arrow keys. */\n  keyboardMapping?:\n    | (() => Partial<Record<'first' | 'last' | 'next' | 'prev', string[]>>)\n    | Partial<Record<'first' | 'last' | 'next' | 'prev', string[]>>;\n\n  /** The ID of the list element (for aria-controls/aria-owns) */\n  listId?: string;\n\n  /** Whether list navigation should loop (wrap around). @default true */\n  loop?: boolean;\n\n  /** Called when popup closes */\n  onClose?: (reason: OverlayCloseReason) => void;\n\n  /** Called when keyboard navigation is invoked */\n  onNavigate?: (action: 'first' | 'last' | 'next' | 'prev', index: number, event: KeyboardEvent) => void;\n\n  /** Called when popup opens */\n  onOpen?: (reason: OverlayOpenReason) => void;\n\n  /** Positioner for floating/positioning library integration */\n  positioner?: PopupListPositioner;\n\n  /** Whether to restore focus to trigger when closing. @default true */\n  restoreFocus?: boolean | (() => boolean);\n\n  /** Set the focused index */\n  setIndex: (index: number) => void;\n\n  /** Set open state */\n  setOpen: (next: boolean, context: { reason: OverlayCloseReason | OverlayOpenReason }) => void;\n\n  /** Ref-like trigger element used for internal ARIA syncing. */\n  triggerRef?: { value: HTMLElement | null };\n};\n\n/**\n * Handle returned by createPopupListControl.\n * Provides methods to control the popup and list, and exposes underlying controls for advanced use.\n */\nexport type PopupListControl<T> = {\n  /** Close the popup */\n  close(reason?: OverlayCloseReason): void;\n\n  // List navigation methods\n  /** Move to first enabled item */\n  first(): void;\n\n  /** Get currently focused item */\n  getActiveItem(): T | undefined;\n\n  /** Handle keydown events for list navigation. Returns true if event was handled. */\n  handleListKeydown(event: KeyboardEvent): boolean;\n\n  /** Move to last enabled item */\n  last(): void;\n\n  /** Move to next enabled item */\n  next(): void;\n\n  /** Open the popup */\n  open(reason?: OverlayOpenReason): void;\n\n  /** Move to previous enabled item */\n  prev(): void;\n\n  /** Reset to no selection */\n  reset(): void;\n\n  /** Move to specific index */\n  set(index: number): void;\n\n  /** Toggle popup open/closed state */\n  toggle(): void;\n};\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Implementation\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Creates a unified popup list control that manages overlay positioning, list navigation,\n * keyboard handling, and ARIA attributes for select, combobox, and menu components.\n *\n * This composable eliminates duplication across components by providing a single,\n * flexible API for:\n * - Opening/closing popups with proper positioning\n * - Navigating lists with keyboard (arrow keys, Home, End)\n * - Syncing ARIA attributes for accessibility\n * - Managing focus restoration\n * - Handling outside-click dismissal\n *\n * @example\n * ```ts\n * // In a select component setup\n * const popupList = createPopupListControl({\n *   // List state\n *   getIndex: () => focusedIndex.value,\n *   getItems: () => options.value,\n *   setIndex: (idx) => { focusedIndex.value = idx; },\n *\n *   // Elements\n *   getBoundaryElement: () => host.el,\n *   getTriggerElement: () => triggerEl,\n *   getPanelElement: () => panelEl,\n *   isOpen: () => isOpen.value,\n *   setOpen: (next, ctx) => { isOpen.value = next; },\n *\n *   // Positioning\n *   positioner: {\n *     reference: () => triggerEl,\n *     floating: () => panelEl,\n *     update: () => positioner.updatePosition(),\n *   },\n *\n *   // ARIA\n *   ariaSync: { role: 'listbox' },\n *   listId: `${selectId}-listbox`,\n * });\n *\n * // Keyboard events\n * function handleKeydown(e: KeyboardEvent) {\n *   if (popupList.handleListKeydown(e)) return; // Consumed by navigation\n *   // Custom keydown logic\n * }\n * ```\n */\nexport const createPopupListControl = <T>(options: PopupListControlOptions<T>): PopupListControl<T> => {\n  // Create underlying list control\n  const list = createListControl<T>({\n    disabled: () => !options.isOpen(),\n    getIndex: options.getIndex,\n    getItems: options.getItems,\n    isItemDisabled: options.isItemDisabled,\n    keys: options.keyboardMapping,\n    loop: options.loop ?? true,\n    onNavigate: (action, index, event) => {\n      if (index >= 0) {\n        options.onNavigate?.(action, index, event);\n      }\n    },\n    setIndex: options.setIndex,\n  });\n\n  // Create underlying overlay control\n  const overlay = createOverlayControl({\n    getBoundaryElement: options.getBoundaryElement,\n    getPanelElement: options.getPanelElement,\n    getTriggerElement: options.getTriggerElement,\n    isDisabled: options.isDisabled,\n    isOpen: options.isOpen,\n    onClose: options.onClose,\n    onOpen: options.onOpen,\n    positioner: options.positioner,\n    restoreFocus: options.restoreFocus,\n    setOpen: options.setOpen,\n  });\n\n  // ─────────────────────────────────────────────────────────────────────────\n  // ARIA Syncing\n  // ─────────────────────────────────────────────────────────────────────────\n\n  const getRoleConfig = (role: PopupListRole = 'listbox') => {\n    if (role === 'menu') {\n      return {\n        defaultTriggerAttributes: {\n          controls: () => options.listId,\n          haspopup: 'menu' as const,\n        },\n        defaultTriggerRole: 'button' as const,\n      };\n    }\n\n    return {\n      defaultTriggerAttributes: {\n        controls: () => options.listId,\n        haspopup: 'listbox' as const,\n      },\n      defaultTriggerRole: 'combobox' as const,\n    };\n  };\n\n  const syncTriggerAria = (trigger: Element, config?: PopupListAriaSyncConfig): (() => void) => {\n    const role = config?.role ?? options.ariaSync?.role ?? 'listbox';\n    const roleConfig = getRoleConfig(role);\n\n    return syncAria(trigger, {\n      ...roleConfig.defaultTriggerAttributes,\n      ...config?.additional,\n      ...options.ariaSync?.additional,\n      disabled: () => options.isDisabled?.() ?? false,\n      expanded: () => (options.isOpen() ? 'true' : 'false'),\n      role: roleConfig.defaultTriggerRole,\n    });\n  };\n\n  if (options.triggerRef) {\n    watch(\n      () => options.triggerRef?.value,\n      (trigger) => {\n        if (!trigger) return;\n\n        return syncTriggerAria(trigger, options.ariaSync);\n      },\n    );\n  }\n\n  // ─────────────────────────────────────────────────────────────────────────\n  // Public API\n  // ─────────────────────────────────────────────────────────────────────────\n\n  return {\n    close: (reason) => overlay.close({ reason: reason ?? 'programmatic' }),\n    first: list.first,\n    getActiveItem: list.getActiveItem,\n    handleListKeydown: list.handleKeydown,\n    last: list.last,\n    next: list.next,\n    open: (reason) => overlay.open({ reason: reason ?? 'programmatic' }),\n    prev: list.prev,\n    reset: list.reset,\n    set: list.set,\n    toggle: overlay.toggle,\n  };\n};\n"],"mappings":"qIAiNA,IAAa,EAA6B,GAA6D,CAErG,IAAM,EAAO,EAAA,kBAAqB,CAChC,aAAgB,CAAC,EAAQ,OAAO,EAChC,SAAU,EAAQ,SAClB,SAAU,EAAQ,SAClB,eAAgB,EAAQ,eACxB,KAAM,EAAQ,gBACd,KAAM,EAAQ,MAAQ,GACtB,YAAa,EAAQ,EAAO,IAAU,CAChC,GAAS,GACX,EAAQ,aAAa,EAAQ,EAAO,CAAK,CAE7C,EACA,SAAU,EAAQ,QACpB,CAAC,EAGK,EAAU,EAAA,qBAAqB,CACnC,mBAAoB,EAAQ,mBAC5B,gBAAiB,EAAQ,gBACzB,kBAAmB,EAAQ,kBAC3B,WAAY,EAAQ,WACpB,OAAQ,EAAQ,OAChB,QAAS,EAAQ,QACjB,OAAQ,EAAQ,OAChB,WAAY,EAAQ,WACpB,aAAc,EAAQ,aACtB,QAAS,EAAQ,OACnB,CAAC,EAMK,GAAiB,EAAsB,YACvC,IAAS,OACJ,CACL,yBAA0B,CACxB,aAAgB,EAAQ,OACxB,SAAU,MACZ,EACA,mBAAoB,QACtB,EAGK,CACL,yBAA0B,CACxB,aAAgB,EAAQ,OACxB,SAAU,SACZ,EACA,mBAAoB,UACtB,EAGI,GAAmB,EAAkB,IAAmD,CAE5F,IAAM,EAAa,EADN,GAAQ,MAAQ,EAAQ,UAAU,MAAQ,SAClB,EAErC,OAAO,EAAA,SAAS,EAAS,CACvB,GAAG,EAAW,yBACd,GAAG,GAAQ,WACX,GAAG,EAAQ,UAAU,WACrB,aAAgB,EAAQ,aAAa,GAAK,GAC1C,aAAiB,EAAQ,OAAO,EAAI,OAAS,QAC7C,KAAM,EAAW,kBACnB,CAAC,CACH,EAiBA,OAfI,EAAQ,aACV,EAAA,EAAA,WACQ,EAAQ,YAAY,MACzB,GAAY,CACN,KAEL,OAAO,EAAgB,EAAS,EAAQ,QAAQ,CAClD,CACF,EAOK,CACL,MAAQ,GAAW,EAAQ,MAAM,CAAE,OAAQ,GAAU,cAAe,CAAC,EACrE,MAAO,EAAK,MACZ,cAAe,EAAK,cACpB,kBAAmB,EAAK,cACxB,KAAM,EAAK,KACX,KAAM,EAAK,KACX,KAAO,GAAW,EAAQ,KAAK,CAAE,OAAQ,GAAU,cAAe,CAAC,EACnE,KAAM,EAAK,KACX,MAAO,EAAK,MACZ,IAAK,EAAK,IACV,OAAQ,EAAQ,MAClB,CACF"}

package/dist/controls/popup-list-control.d.ts

@@ -0,0 +1,160 @@
+import type { OverlayCloseReason, OverlayOpenReason } from './overlay-control';
+/**
+ * ARIA role for the popup list. Affects which attributes are synced to the trigger.
+ * - 'listbox': For select/combobox (role="combobox" on trigger, role="listbox" on panel)
+ * - 'menu': For menus (role="menu" on trigger, role="menu" on panel)
+ */
+export type PopupListRole = 'listbox' | 'menu';
+/**
+ * Configuration for syncing ARIA attributes to the trigger element.
+ * Automatically handles role-specific attributes like aria-haspopup.
+ */
+export type PopupListAriaSyncConfig = {
+    /**
+     * Additional ARIA attributes to sync to the trigger beyond the standard ones.
+     * These will be merged with role-specific defaults.
+     */
+    additional?: Record<string, boolean | null | number | string | undefined | (() => boolean | null | number | string | undefined)>;
+    /**
+     * The role of the popup list component. Controls which ARIA attributes are synced.
+     * @default 'listbox'
+     */
+    role?: PopupListRole;
+};
+/**
+ * Configuration for positioning the popup list using floatit.
+ */
+export type PopupListPositioner = {
+    /** Gets the floating element (popup panel) */
+    floating: () => HTMLElement | null;
+    /** Get the reference element (trigger) */
+    reference: () => HTMLElement | null;
+    /** Update the position (called on open and during auto-update) */
+    update: () => void;
+};
+/**
+ * Main options for createPopupListControl.
+ */
+export type PopupListControlOptions<T> = {
+    /** Configuration for ARIA attributes */
+    ariaSync?: PopupListAriaSyncConfig;
+    /** Get the boundary element (for click-outside detection) */
+    getBoundaryElement: () => HTMLElement | null;
+    /** Get the current focused index (-1 if none focused) */
+    getIndex: () => number;
+    /** Get all items in the list */
+    getItems: () => T[];
+    /** Get the panel element */
+    getPanelElement: () => HTMLElement | null;
+    /** Get the trigger element */
+    getTriggerElement: () => HTMLElement | null;
+    /** Check if disabled */
+    isDisabled?: () => boolean;
+    /** Check if an item is disabled */
+    isItemDisabled?: (item: T, index: number) => boolean;
+    /** Whether the popup is open */
+    isOpen: () => boolean;
+    /** Custom keyboard mappings for list navigation. Defaults to arrow keys. */
+    keyboardMapping?: (() => Partial<Record<'first' | 'last' | 'next' | 'prev', string[]>>) | Partial<Record<'first' | 'last' | 'next' | 'prev', string[]>>;
+    /** The ID of the list element (for aria-controls/aria-owns) */
+    listId?: string;
+    /** Whether list navigation should loop (wrap around). @default true */
+    loop?: boolean;
+    /** Called when popup closes */
+    onClose?: (reason: OverlayCloseReason) => void;
+    /** Called when keyboard navigation is invoked */
+    onNavigate?: (action: 'first' | 'last' | 'next' | 'prev', index: number, event: KeyboardEvent) => void;
+    /** Called when popup opens */
+    onOpen?: (reason: OverlayOpenReason) => void;
+    /** Positioner for floating/positioning library integration */
+    positioner?: PopupListPositioner;
+    /** Whether to restore focus to trigger when closing. @default true */
+    restoreFocus?: boolean | (() => boolean);
+    /** Set the focused index */
+    setIndex: (index: number) => void;
+    /** Set open state */
+    setOpen: (next: boolean, context: {
+        reason: OverlayCloseReason | OverlayOpenReason;
+    }) => void;
+    /** Ref-like trigger element used for internal ARIA syncing. */
+    triggerRef?: {
+        value: HTMLElement | null;
+    };
+};
+/**
+ * Handle returned by createPopupListControl.
+ * Provides methods to control the popup and list, and exposes underlying controls for advanced use.
+ */
+export type PopupListControl<T> = {
+    /** Close the popup */
+    close(reason?: OverlayCloseReason): void;
+    /** Move to first enabled item */
+    first(): void;
+    /** Get currently focused item */
+    getActiveItem(): T | undefined;
+    /** Handle keydown events for list navigation. Returns true if event was handled. */
+    handleListKeydown(event: KeyboardEvent): boolean;
+    /** Move to last enabled item */
+    last(): void;
+    /** Move to next enabled item */
+    next(): void;
+    /** Open the popup */
+    open(reason?: OverlayOpenReason): void;
+    /** Move to previous enabled item */
+    prev(): void;
+    /** Reset to no selection */
+    reset(): void;
+    /** Move to specific index */
+    set(index: number): void;
+    /** Toggle popup open/closed state */
+    toggle(): void;
+};
+/**
+ * Creates a unified popup list control that manages overlay positioning, list navigation,
+ * keyboard handling, and ARIA attributes for select, combobox, and menu components.
+ *
+ * This composable eliminates duplication across components by providing a single,
+ * flexible API for:
+ * - Opening/closing popups with proper positioning
+ * - Navigating lists with keyboard (arrow keys, Home, End)
+ * - Syncing ARIA attributes for accessibility
+ * - Managing focus restoration
+ * - Handling outside-click dismissal
+ *
+ * @example
+ * ```ts
+ * // In a select component setup
+ * const popupList = createPopupListControl({
+ *   // List state
+ *   getIndex: () => focusedIndex.value,
+ *   getItems: () => options.value,
+ *   setIndex: (idx) => { focusedIndex.value = idx; },
+ *
+ *   // Elements
+ *   getBoundaryElement: () => host.el,
+ *   getTriggerElement: () => triggerEl,
+ *   getPanelElement: () => panelEl,
+ *   isOpen: () => isOpen.value,
+ *   setOpen: (next, ctx) => { isOpen.value = next; },
+ *
+ *   // Positioning
+ *   positioner: {
+ *     reference: () => triggerEl,
+ *     floating: () => panelEl,
+ *     update: () => positioner.updatePosition(),
+ *   },
+ *
+ *   // ARIA
+ *   ariaSync: { role: 'listbox' },
+ *   listId: `${selectId}-listbox`,
+ * });
+ *
+ * // Keyboard events
+ * function handleKeydown(e: KeyboardEvent) {
+ *   if (popupList.handleListKeydown(e)) return; // Consumed by navigation
+ *   // Custom keydown logic
+ * }
+ * ```
+ */
+export declare const createPopupListControl: <T>(options: PopupListControlOptions<T>) => PopupListControl<T>;
+//# sourceMappingURL=popup-list-control.d.ts.map

package/dist/controls/popup-list-control.d.ts.map

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

package/dist/controls/popup-list-control.js

@@ -0,0 +1,2 @@
+import{createListControl as e}from"./list-control.js";import{createOverlayControl as t}from"./overlay-control.js";import{syncAria as n}from"../host.js";import{watch as r}from"@vielzeug/stateit";var i=i=>{let a=e({disabled:()=>!i.isOpen(),getIndex:i.getIndex,getItems:i.getItems,isItemDisabled:i.isItemDisabled,keys:i.keyboardMapping,loop:i.loop??!0,onNavigate:(e,t,n)=>{t>=0&&i.onNavigate?.(e,t,n)},setIndex:i.setIndex}),o=t({getBoundaryElement:i.getBoundaryElement,getPanelElement:i.getPanelElement,getTriggerElement:i.getTriggerElement,isDisabled:i.isDisabled,isOpen:i.isOpen,onClose:i.onClose,onOpen:i.onOpen,positioner:i.positioner,restoreFocus:i.restoreFocus,setOpen:i.setOpen}),s=(e=`listbox`)=>e===`menu`?{defaultTriggerAttributes:{controls:()=>i.listId,haspopup:`menu`},defaultTriggerRole:`button`}:{defaultTriggerAttributes:{controls:()=>i.listId,haspopup:`listbox`},defaultTriggerRole:`combobox`},c=(e,t)=>{let r=s(t?.role??i.ariaSync?.role??`listbox`);return n(e,{...r.defaultTriggerAttributes,...t?.additional,...i.ariaSync?.additional,disabled:()=>i.isDisabled?.()??!1,expanded:()=>i.isOpen()?`true`:`false`,role:r.defaultTriggerRole})};return i.triggerRef&&r(()=>i.triggerRef?.value,e=>{if(e)return c(e,i.ariaSync)}),{close:e=>o.close({reason:e??`programmatic`}),first:a.first,getActiveItem:a.getActiveItem,handleListKeydown:a.handleKeydown,last:a.last,next:a.next,open:e=>o.open({reason:e??`programmatic`}),prev:a.prev,reset:a.reset,set:a.set,toggle:o.toggle}};export{i as createPopupListControl};
+//# sourceMappingURL=popup-list-control.js.map

package/dist/controls/popup-list-control.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"popup-list-control.js","names":[],"sources":["../../src/controls/popup-list-control.ts"],"sourcesContent":["import { watch } from '@vielzeug/stateit';\n\nimport type { OverlayCloseReason, OverlayOpenReason } from './overlay-control';\n\nimport { syncAria } from '../host';\nimport { createListControl } from './list-control';\nimport { createOverlayControl } from './overlay-control';\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Types\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * ARIA role for the popup list. Affects which attributes are synced to the trigger.\n * - 'listbox': For select/combobox (role=\"combobox\" on trigger, role=\"listbox\" on panel)\n * - 'menu': For menus (role=\"menu\" on trigger, role=\"menu\" on panel)\n */\nexport type PopupListRole = 'listbox' | 'menu';\n\n/**\n * Configuration for syncing ARIA attributes to the trigger element.\n * Automatically handles role-specific attributes like aria-haspopup.\n */\nexport type PopupListAriaSyncConfig = {\n  /**\n   * Additional ARIA attributes to sync to the trigger beyond the standard ones.\n   * These will be merged with role-specific defaults.\n   */\n  additional?: Record<\n    string,\n    boolean | null | number | string | undefined | (() => boolean | null | number | string | undefined)\n  >;\n  /**\n   * The role of the popup list component. Controls which ARIA attributes are synced.\n   * @default 'listbox'\n   */\n  role?: PopupListRole;\n};\n\n/**\n * Configuration for positioning the popup list using floatit.\n */\nexport type PopupListPositioner = {\n  /** Gets the floating element (popup panel) */\n  floating: () => HTMLElement | null;\n  /** Get the reference element (trigger) */\n  reference: () => HTMLElement | null;\n  /** Update the position (called on open and during auto-update) */\n  update: () => void;\n};\n\n/**\n * Main options for createPopupListControl.\n */\nexport type PopupListControlOptions<T> = {\n  // ARIA\n  /** Configuration for ARIA attributes */\n  ariaSync?: PopupListAriaSyncConfig;\n  // Overlay\n  /** Get the boundary element (for click-outside detection) */\n  getBoundaryElement: () => HTMLElement | null;\n\n  // List state\n  /** Get the current focused index (-1 if none focused) */\n  getIndex: () => number;\n  /** Get all items in the list */\n  getItems: () => T[];\n  /** Get the panel element */\n  getPanelElement: () => HTMLElement | null;\n\n  /** Get the trigger element */\n  getTriggerElement: () => HTMLElement | null;\n  // Overlay state\n  /** Check if disabled */\n  isDisabled?: () => boolean;\n\n  // List navigation\n  /** Check if an item is disabled */\n  isItemDisabled?: (item: T, index: number) => boolean;\n\n  /** Whether the popup is open */\n  isOpen: () => boolean;\n  /** Custom keyboard mappings for list navigation. Defaults to arrow keys. */\n  keyboardMapping?:\n    | (() => Partial<Record<'first' | 'last' | 'next' | 'prev', string[]>>)\n    | Partial<Record<'first' | 'last' | 'next' | 'prev', string[]>>;\n\n  /** The ID of the list element (for aria-controls/aria-owns) */\n  listId?: string;\n\n  /** Whether list navigation should loop (wrap around). @default true */\n  loop?: boolean;\n\n  /** Called when popup closes */\n  onClose?: (reason: OverlayCloseReason) => void;\n\n  /** Called when keyboard navigation is invoked */\n  onNavigate?: (action: 'first' | 'last' | 'next' | 'prev', index: number, event: KeyboardEvent) => void;\n\n  /** Called when popup opens */\n  onOpen?: (reason: OverlayOpenReason) => void;\n\n  /** Positioner for floating/positioning library integration */\n  positioner?: PopupListPositioner;\n\n  /** Whether to restore focus to trigger when closing. @default true */\n  restoreFocus?: boolean | (() => boolean);\n\n  /** Set the focused index */\n  setIndex: (index: number) => void;\n\n  /** Set open state */\n  setOpen: (next: boolean, context: { reason: OverlayCloseReason | OverlayOpenReason }) => void;\n\n  /** Ref-like trigger element used for internal ARIA syncing. */\n  triggerRef?: { value: HTMLElement | null };\n};\n\n/**\n * Handle returned by createPopupListControl.\n * Provides methods to control the popup and list, and exposes underlying controls for advanced use.\n */\nexport type PopupListControl<T> = {\n  /** Close the popup */\n  close(reason?: OverlayCloseReason): void;\n\n  // List navigation methods\n  /** Move to first enabled item */\n  first(): void;\n\n  /** Get currently focused item */\n  getActiveItem(): T | undefined;\n\n  /** Handle keydown events for list navigation. Returns true if event was handled. */\n  handleListKeydown(event: KeyboardEvent): boolean;\n\n  /** Move to last enabled item */\n  last(): void;\n\n  /** Move to next enabled item */\n  next(): void;\n\n  /** Open the popup */\n  open(reason?: OverlayOpenReason): void;\n\n  /** Move to previous enabled item */\n  prev(): void;\n\n  /** Reset to no selection */\n  reset(): void;\n\n  /** Move to specific index */\n  set(index: number): void;\n\n  /** Toggle popup open/closed state */\n  toggle(): void;\n};\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Implementation\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Creates a unified popup list control that manages overlay positioning, list navigation,\n * keyboard handling, and ARIA attributes for select, combobox, and menu components.\n *\n * This composable eliminates duplication across components by providing a single,\n * flexible API for:\n * - Opening/closing popups with proper positioning\n * - Navigating lists with keyboard (arrow keys, Home, End)\n * - Syncing ARIA attributes for accessibility\n * - Managing focus restoration\n * - Handling outside-click dismissal\n *\n * @example\n * ```ts\n * // In a select component setup\n * const popupList = createPopupListControl({\n *   // List state\n *   getIndex: () => focusedIndex.value,\n *   getItems: () => options.value,\n *   setIndex: (idx) => { focusedIndex.value = idx; },\n *\n *   // Elements\n *   getBoundaryElement: () => host.el,\n *   getTriggerElement: () => triggerEl,\n *   getPanelElement: () => panelEl,\n *   isOpen: () => isOpen.value,\n *   setOpen: (next, ctx) => { isOpen.value = next; },\n *\n *   // Positioning\n *   positioner: {\n *     reference: () => triggerEl,\n *     floating: () => panelEl,\n *     update: () => positioner.updatePosition(),\n *   },\n *\n *   // ARIA\n *   ariaSync: { role: 'listbox' },\n *   listId: `${selectId}-listbox`,\n * });\n *\n * // Keyboard events\n * function handleKeydown(e: KeyboardEvent) {\n *   if (popupList.handleListKeydown(e)) return; // Consumed by navigation\n *   // Custom keydown logic\n * }\n * ```\n */\nexport const createPopupListControl = <T>(options: PopupListControlOptions<T>): PopupListControl<T> => {\n  // Create underlying list control\n  const list = createListControl<T>({\n    disabled: () => !options.isOpen(),\n    getIndex: options.getIndex,\n    getItems: options.getItems,\n    isItemDisabled: options.isItemDisabled,\n    keys: options.keyboardMapping,\n    loop: options.loop ?? true,\n    onNavigate: (action, index, event) => {\n      if (index >= 0) {\n        options.onNavigate?.(action, index, event);\n      }\n    },\n    setIndex: options.setIndex,\n  });\n\n  // Create underlying overlay control\n  const overlay = createOverlayControl({\n    getBoundaryElement: options.getBoundaryElement,\n    getPanelElement: options.getPanelElement,\n    getTriggerElement: options.getTriggerElement,\n    isDisabled: options.isDisabled,\n    isOpen: options.isOpen,\n    onClose: options.onClose,\n    onOpen: options.onOpen,\n    positioner: options.positioner,\n    restoreFocus: options.restoreFocus,\n    setOpen: options.setOpen,\n  });\n\n  // ─────────────────────────────────────────────────────────────────────────\n  // ARIA Syncing\n  // ─────────────────────────────────────────────────────────────────────────\n\n  const getRoleConfig = (role: PopupListRole = 'listbox') => {\n    if (role === 'menu') {\n      return {\n        defaultTriggerAttributes: {\n          controls: () => options.listId,\n          haspopup: 'menu' as const,\n        },\n        defaultTriggerRole: 'button' as const,\n      };\n    }\n\n    return {\n      defaultTriggerAttributes: {\n        controls: () => options.listId,\n        haspopup: 'listbox' as const,\n      },\n      defaultTriggerRole: 'combobox' as const,\n    };\n  };\n\n  const syncTriggerAria = (trigger: Element, config?: PopupListAriaSyncConfig): (() => void) => {\n    const role = config?.role ?? options.ariaSync?.role ?? 'listbox';\n    const roleConfig = getRoleConfig(role);\n\n    return syncAria(trigger, {\n      ...roleConfig.defaultTriggerAttributes,\n      ...config?.additional,\n      ...options.ariaSync?.additional,\n      disabled: () => options.isDisabled?.() ?? false,\n      expanded: () => (options.isOpen() ? 'true' : 'false'),\n      role: roleConfig.defaultTriggerRole,\n    });\n  };\n\n  if (options.triggerRef) {\n    watch(\n      () => options.triggerRef?.value,\n      (trigger) => {\n        if (!trigger) return;\n\n        return syncTriggerAria(trigger, options.ariaSync);\n      },\n    );\n  }\n\n  // ─────────────────────────────────────────────────────────────────────────\n  // Public API\n  // ─────────────────────────────────────────────────────────────────────────\n\n  return {\n    close: (reason) => overlay.close({ reason: reason ?? 'programmatic' }),\n    first: list.first,\n    getActiveItem: list.getActiveItem,\n    handleListKeydown: list.handleKeydown,\n    last: list.last,\n    next: list.next,\n    open: (reason) => overlay.open({ reason: reason ?? 'programmatic' }),\n    prev: list.prev,\n    reset: list.reset,\n    set: list.set,\n    toggle: overlay.toggle,\n  };\n};\n"],"mappings":"kMAiNA,IAAa,EAA6B,GAA6D,CAErG,IAAM,EAAO,EAAqB,CAChC,aAAgB,CAAC,EAAQ,OAAO,EAChC,SAAU,EAAQ,SAClB,SAAU,EAAQ,SAClB,eAAgB,EAAQ,eACxB,KAAM,EAAQ,gBACd,KAAM,EAAQ,MAAQ,GACtB,YAAa,EAAQ,EAAO,IAAU,CAChC,GAAS,GACX,EAAQ,aAAa,EAAQ,EAAO,CAAK,CAE7C,EACA,SAAU,EAAQ,QACpB,CAAC,EAGK,EAAU,EAAqB,CACnC,mBAAoB,EAAQ,mBAC5B,gBAAiB,EAAQ,gBACzB,kBAAmB,EAAQ,kBAC3B,WAAY,EAAQ,WACpB,OAAQ,EAAQ,OAChB,QAAS,EAAQ,QACjB,OAAQ,EAAQ,OAChB,WAAY,EAAQ,WACpB,aAAc,EAAQ,aACtB,QAAS,EAAQ,OACnB,CAAC,EAMK,GAAiB,EAAsB,YACvC,IAAS,OACJ,CACL,yBAA0B,CACxB,aAAgB,EAAQ,OACxB,SAAU,MACZ,EACA,mBAAoB,QACtB,EAGK,CACL,yBAA0B,CACxB,aAAgB,EAAQ,OACxB,SAAU,SACZ,EACA,mBAAoB,UACtB,EAGI,GAAmB,EAAkB,IAAmD,CAE5F,IAAM,EAAa,EADN,GAAQ,MAAQ,EAAQ,UAAU,MAAQ,SAClB,EAErC,OAAO,EAAS,EAAS,CACvB,GAAG,EAAW,yBACd,GAAG,GAAQ,WACX,GAAG,EAAQ,UAAU,WACrB,aAAgB,EAAQ,aAAa,GAAK,GAC1C,aAAiB,EAAQ,OAAO,EAAI,OAAS,QAC7C,KAAM,EAAW,kBACnB,CAAC,CACH,EAiBA,OAfI,EAAQ,YACV,MACQ,EAAQ,YAAY,MACzB,GAAY,CACN,KAEL,OAAO,EAAgB,EAAS,EAAQ,QAAQ,CAClD,CACF,EAOK,CACL,MAAQ,GAAW,EAAQ,MAAM,CAAE,OAAQ,GAAU,cAAe,CAAC,EACrE,MAAO,EAAK,MACZ,cAAe,EAAK,cACpB,kBAAmB,EAAK,cACxB,KAAM,EAAK,KACX,KAAM,EAAK,KACX,KAAO,GAAW,EAAQ,KAAK,CAAE,OAAQ,GAAU,cAAe,CAAC,EACnE,KAAM,EAAK,KACX,MAAO,EAAK,MACZ,IAAK,EAAK,IACV,OAAQ,EAAQ,MAClB,CACF"}

package/dist/controls/press-control.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"press-control.cjs","names":[],"sources":["../../src/controls/press-control.ts"],"sourcesContent":["import { dispatchKeyboardAction } from './internal/keyboard-utils';\n\nexport type PressTrigger = 'keyboard' | 'pointer';\n\nexport type PressControlOptions = {\n  disabled?: () => boolean;\n  keys?: string[];\n  onPress: (originalEvent: KeyboardEvent | MouseEvent, trigger: PressTrigger) => void;\n};\n\nexport type PressControl = {\n  handleClick: (event: MouseEvent) => boolean;\n  handleKeydown: (event: KeyboardEvent) => boolean;\n};\n\nexport const createPressControl = (options: PressControlOptions): PressControl => {\n  const isDisabled = (): boolean => Boolean(options.disabled?.());\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  const handleClick = (event: MouseEvent): boolean => {\n    if (isDisabled()) return false;\n\n    options.onPress(event, 'pointer');\n\n    return true;\n  };\n\n  const handleKeydown = (event: KeyboardEvent): boolean => {\n    return dispatchKeyboardAction(event, {\n      disabled: isDisabled,\n      keymap,\n    });\n  };\n\n  return {\n    handleClick,\n    handleKeydown,\n  };\n};\n"],"mappings":"iDAeA,IAAa,EAAsB,GAA+C,CAChF,IAAM,MAA4B,EAAQ,EAAQ,YAAY,CACxD,EAAe,EAAQ,MAAQ,CAAC,QAAS,IAAI,CAC7C,EAAS,OAAO,YACpB,EAAa,IAAK,GAAQ,CAAC,EAAM,GAAiC,EAAQ,QAAQ,EAAe,WAAW,CAAC,CAAC,CAC/G,CAiBD,MAAO,CACL,YAhBmB,GACf,GAAY,CAAS,IAEzB,EAAQ,QAAQ,EAAO,UAAU,CAE1B,IAYP,cATqB,GACd,EAAA,uBAAuB,EAAO,CACnC,SAAU,EACV,SACD,CAAC,CAMH"}
+{"version":3,"file":"press-control.cjs","names":[],"sources":["../../src/controls/press-control.ts"],"sourcesContent":["import { dispatchKeyboardAction } from './internal/keyboard-utils';\n\nexport type PressTrigger = 'keyboard' | 'pointer';\n\nexport type PressControlOptions = {\n  disabled?: () => boolean;\n  keys?: string[];\n  onPress: (originalEvent: KeyboardEvent | MouseEvent, trigger: PressTrigger) => void;\n};\n\nexport type PressControl = {\n  handleClick: (event: MouseEvent) => boolean;\n  handleKeydown: (event: KeyboardEvent) => boolean;\n};\n\nexport const createPressControl = (options: PressControlOptions): PressControl => {\n  const isDisabled = (): boolean => Boolean(options.disabled?.());\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  const handleClick = (event: MouseEvent): boolean => {\n    if (isDisabled()) return false;\n\n    options.onPress(event, 'pointer');\n\n    return true;\n  };\n\n  const handleKeydown = (event: KeyboardEvent): boolean => {\n    return dispatchKeyboardAction(event, {\n      disabled: isDisabled,\n      keymap,\n    });\n  };\n\n  return {\n    handleClick,\n    handleKeydown,\n  };\n};\n"],"mappings":"iDAeA,IAAa,EAAsB,GAA+C,CAChF,IAAM,MAA4B,EAAQ,EAAQ,WAAW,EACvD,EAAe,EAAQ,MAAQ,CAAC,QAAS,GAAG,EAC5C,EAAS,OAAO,YACpB,EAAa,IAAK,GAAQ,CAAC,EAAM,GAAiC,EAAQ,QAAQ,EAAe,UAAU,CAAC,CAAC,CAC/G,EAiBA,MAAO,CACL,YAhBmB,GACf,EAAW,EAAU,IAEzB,EAAQ,QAAQ,EAAO,SAAS,EAEzB,IAYP,cATqB,GACd,EAAA,uBAAuB,EAAO,CACnC,SAAU,EACV,QACF,CAAC,CAMH,CACF"}