se-design 1.0.81 → 1.0.83-dev.1

package/dist/index76.js

@@ -1,57 +1,21 @@
-import { useState as m, useEffect as w, useCallback as b } from "react";
-import { useScrollActiveIntoView as x } from "./index80.js";
-function s({
-  items: c,
-  isOpen: t,
-  onSelect: l,
-  onClose: i,
-  onOpen: n,
-  loop: o = !0,
-  disabled: h = !1,
-  listboxRef: k,
-  optionSelector: g = '[role="option"]'
-}) {
-  const [f, r] = m(-1);
-  w(() => {
-    t || r(-1);
-  }, [t]), x({
-    containerRef: k,
-    activeIndex: f,
-    itemSelector: g,
-    enabled: t
-  });
-  const D = b((a) => {
-    if (h) {
-      a.key === "Escape" && t && (a.preventDefault(), i());
-      return;
-    }
-    const e = c.length;
-    switch (a.key) {
-      case "ArrowDown":
-        a.preventDefault(), !t && e > 0 ? (n?.(), r(0)) : t && e > 0 && r((u) => o ? (u + 1) % e : Math.min(u + 1, e - 1));
-        break;
-      case "ArrowUp":
-        a.preventDefault(), t && e > 0 && r((u) => u === -1 ? e - 1 : o ? (u - 1 + e) % e : Math.max(u - 1, 0));
-        break;
-      case "Enter":
-        a.preventDefault(), t ? f >= 0 && c[f] && (l(c[f], f), r(-1)) : (n?.(), r(0));
-        break;
-      case "Escape":
-        t && (a.preventDefault(), i(), r(-1));
-        break;
-      case "Tab":
-        t && (i(), r(-1));
-        break;
-    }
-  }, [h, c, t, f, l, i, n, o]), d = b((a, e) => `${a}-option-${e}`, []);
-  return {
-    highlightedIndex: f,
-    setHighlightedIndex: r,
-    handleKeyDown: D,
-    getOptionId: d
-  };
-}
+import o, { useEffect as t, useMemo as c, createContext as u } from "react";
+import { announce as e, destroyAnnouncer as a, clearAnnouncer as l } from "./index75.js";
+const i = /* @__PURE__ */ u(null), f = ({
+  children: n
+}) => {
+  t(() => (e(""), () => {
+    a();
+  }), []);
+  const r = c(() => ({
+    announce: e,
+    clear: l
+  }), []);
+  return /* @__PURE__ */ o.createElement(i.Provider, {
+    value: r
+  }, n);
+};
 export {
-  s as useComboboxNavigation
+  i as LiveAnnouncerContext,
+  f as LiveAnnouncerProvider
 };
 //# sourceMappingURL=index76.js.map

package/dist/index76.js.map

@@ -1 +1 @@
-{"version":3,"file":"index76.js","sources":["../src/utils/a11y/useComboboxNavigation.ts"],"sourcesContent":["import { useCallback, useState, useEffect } from 'react';\nimport type { RefObject } from 'react';\nimport { useScrollActiveIntoView } from './useScrollActiveIntoView';\n\nexport interface UseComboboxNavigationOptions<T = any> {\n  /**\n   * Array of items to navigate through\n   */\n  items: T[];\n  \n  /**\n   * Whether the dropdown is currently open\n   */\n  isOpen: boolean;\n  \n  /**\n   * Callback when an item is selected (Enter key)\n   */\n  onSelect: (item: T, index: number) => void;\n  \n  /**\n   * Callback to close the dropdown\n   */\n  onClose: () => void;\n  \n  /**\n   * Optional: Callback to open the dropdown\n   */\n  onOpen?: () => void;\n  \n  /**\n   * Whether to wrap around at the ends of the list.\n   * Default: true\n   */\n  loop?: boolean;\n  \n  /**\n   * Whether keyboard navigation is disabled\n   * (e.g., for custom rendered content)\n   */\n  disabled?: boolean;\n  \n  /**\n   * Ref to the listbox container for scroll management\n   */\n  listboxRef?: RefObject<HTMLElement | null>;\n  \n  /**\n   * CSS selector for option elements (default: '[role=\"option\"]')\n   */\n  optionSelector?: string;\n}\n\nexport interface UseComboboxNavigationReturn {\n  /**\n   * Currently highlighted index (-1 if none)\n   */\n  highlightedIndex: number;\n  \n  /**\n   * Set the highlighted index manually\n   */\n  setHighlightedIndex: (index: number | ((prev: number) => number)) => void;\n  \n  /**\n   * Keyboard event handler for the combobox input\n   */\n  handleKeyDown: (e: React.KeyboardEvent) => void;\n  \n  /**\n   * Generate stable ID for an option\n   */\n  getOptionId: (listboxId: string, index: number) => string;\n  \n}\n\n/**\n * Hook for managing combobox keyboard navigation with aria-activedescendant.\n * \n * Implements WAI-ARIA 1.2 Combobox pattern:\n * - Arrow Up/Down to navigate options\n * - Enter to select highlighted option\n * - Escape to close dropdown\n * - Tab to close and move focus\n * - Auto-scrolls highlighted option into view\n * \n * @example\n * ```tsx\n * const { \n *   highlightedIndex, \n *   handleKeyDown, \n *   getOptionId \n * } = useComboboxNavigation({\n *   items: suggestions,\n *   isOpen: isDropdownOpen,\n *   onSelect: (item, idx) => handleSelect(item),\n *   onClose: () => setIsOpen(false),\n *   listboxRef\n * });\n * \n * <input\n *   role=\"combobox\"\n *   onKeyDown={handleKeyDown}\n *   aria-activedescendant={highlightedIndex >= 0 ? getOptionId(listboxId, highlightedIndex) : undefined}\n * />\n * ```\n */\nexport function useComboboxNavigation<T = any>({\n  items,\n  isOpen,\n  onSelect,\n  onClose,\n  onOpen,\n  loop = true,\n  disabled = false,\n  listboxRef,\n  optionSelector = '[role=\"option\"]'\n}: UseComboboxNavigationOptions<T>): UseComboboxNavigationReturn {\n  const [highlightedIndex, setHighlightedIndex] = useState<number>(-1);\n  \n  // Reset highlighted index when dropdown closes\n  useEffect(() => {\n    if (!isOpen) {\n      setHighlightedIndex(-1);\n    }\n  }, [isOpen]);\n  \n  // Auto-scroll highlighted item into view\n  useScrollActiveIntoView({\n    containerRef: listboxRef,\n    activeIndex: highlightedIndex,\n    itemSelector: optionSelector,\n    enabled: isOpen\n  });\n  \n  const handleKeyDown = useCallback(\n    (e: React.KeyboardEvent) => {\n      if (disabled) {\n        // For disabled navigation, still handle Escape\n        if (e.key === 'Escape' && isOpen) {\n          e.preventDefault();\n          onClose();\n        }\n        return;\n      }\n      \n      const itemCount = items.length;\n      \n      switch (e.key) {\n        case 'ArrowDown':\n          e.preventDefault();\n          if (!isOpen && itemCount > 0) {\n            // Open dropdown and highlight first item\n            onOpen?.();\n            setHighlightedIndex(0);\n          } else if (isOpen && itemCount > 0) {\n            // Navigate down\n            setHighlightedIndex((prev) => {\n              if (loop) {\n                return (prev + 1) % itemCount;\n              }\n              return Math.min(prev + 1, itemCount - 1);\n            });\n          }\n          break;\n          \n        case 'ArrowUp':\n          e.preventDefault();\n          if (isOpen && itemCount > 0) {\n            // Navigate up\n            setHighlightedIndex((prev) => {\n              // If nothing highlighted, go to last item\n              if (prev === -1) {\n                return itemCount - 1;\n              }\n              if (loop) {\n                return (prev - 1 + itemCount) % itemCount;\n              }\n              return Math.max(prev - 1, 0);\n            });\n          }\n          break;\n          \n        case 'Enter':\n          e.preventDefault();\n          if (!isOpen) {\n            onOpen?.();\n            setHighlightedIndex(0);\n          } else if (highlightedIndex >= 0 && items[highlightedIndex]) {\n            onSelect(items[highlightedIndex], highlightedIndex);\n            setHighlightedIndex(-1);\n          }\n          break;\n\n        case 'Escape':\n          if (isOpen) {\n            e.preventDefault();\n            onClose();\n            setHighlightedIndex(-1);\n          }\n          break;\n          \n        case 'Tab':\n          // Close dropdown on Tab (don't preventDefault - let focus move naturally)\n          if (isOpen) {\n            onClose();\n            setHighlightedIndex(-1);\n          }\n          break;\n      }\n    },\n    [disabled, items, isOpen, highlightedIndex, onSelect, onClose, onOpen, loop]\n  );\n  \n  const getOptionId = useCallback(\n    (listboxId: string, index: number) => `${listboxId}-option-${index}`,\n    []\n  );\n  \n  return {\n    highlightedIndex,\n    setHighlightedIndex,\n    handleKeyDown,\n    getOptionId\n  };\n}\n"],"names":["useState","useEffect","useCallback","useScrollActiveIntoView","useComboboxNavigation","items","isOpen","onSelect","onClose","onOpen","loop","disabled","listboxRef","optionSelector","highlightedIndex","setHighlightedIndex","containerRef","activeIndex","itemSelector","enabled","handleKeyDown","e","key","preventDefault","itemCount","length","prev","Math","min","max","getOptionId","listboxId","index"],"mappings":"AA2GO,SAAA,YAAAA,GAAA,aAAAC,GAAA,eAAAC,SAAA;AAAA,SAAA,2BAAAC,SAAA;AAAA,SAASC,EAA+B;AAAA,EAC7CC,OAAAA;AAAAA,EACAC,QAAAA;AAAAA,EACAC,UAAAA;AAAAA,EACAC,SAAAA;AAAAA,EACAC,QAAAA;AAAAA,EACAC,MAAAA,IAAO;AAAA,EACPC,UAAAA,IAAW;AAAA,EACXC,YAAAA;AAAAA,EACAC,gBAAAA,IAAiB;AACc,GAAgC;AAC/D,QAAM,CAACC,GAAkBC,CAAmB,IAAIf,EAAiB,EAAE;AAGnEC,EAAAA,EAAU,MAAM;AACd,IAAKK,KACHS,EAAoB,EAAE;AAAA,EAE1B,GAAG,CAACT,CAAM,CAAC,GAGXH,EAAwB;AAAA,IACtBa,cAAcJ;AAAAA,IACdK,aAAaH;AAAAA,IACbI,cAAcL;AAAAA,IACdM,SAASb;AAAAA,EAAAA,CACV;AAED,QAAMc,IAAgBlB,EACpB,CAACmB,MAA2B;AAC1B,QAAIV,GAAU;AAEZ,MAAIU,EAAEC,QAAQ,YAAYhB,MACxBe,EAAEE,eAAAA,GACFf,EAAAA;AAEF;AAAA,IACF;AAEA,UAAMgB,IAAYnB,EAAMoB;AAExB,YAAQJ,EAAEC,KAAAA;AAAAA,MACR,KAAK;AACHD,QAAAA,EAAEE,eAAAA,GACE,CAACjB,KAAUkB,IAAY,KAEzBf,IAAAA,GACAM,EAAoB,CAAC,KACZT,KAAUkB,IAAY,KAE/BT,EAAqBW,CAAAA,MACfhB,KACMgB,IAAO,KAAKF,IAEfG,KAAKC,IAAIF,IAAO,GAAGF,IAAY,CAAC,CACxC;AAEH;AAAA,MAEF,KAAK;AACHH,QAAAA,EAAEE,eAAAA,GACEjB,KAAUkB,IAAY,KAExBT,EAAqBW,CAAAA,MAEfA,MAAS,KACJF,IAAY,IAEjBd,KACMgB,IAAO,IAAIF,KAAaA,IAE3BG,KAAKE,IAAIH,IAAO,GAAG,CAAC,CAC5B;AAEH;AAAA,MAEF,KAAK;AACHL,QAAAA,EAAEE,eAAAA,GACGjB,IAGMQ,KAAoB,KAAKT,EAAMS,CAAgB,MACxDP,EAASF,EAAMS,CAAgB,GAAGA,CAAgB,GAClDC,EAAoB,EAAE,MAJtBN,IAAAA,GACAM,EAAoB,CAAC;AAKvB;AAAA,MAEF,KAAK;AACH,QAAIT,MACFe,EAAEE,eAAAA,GACFf,EAAAA,GACAO,EAAoB,EAAE;AAExB;AAAA,MAEF,KAAK;AAEH,QAAIT,MACFE,EAAAA,GACAO,EAAoB,EAAE;AAExB;AAAA,IAAA;AAAA,EAEN,GACA,CAACJ,GAAUN,GAAOC,GAAQQ,GAAkBP,GAAUC,GAASC,GAAQC,CAAI,CAC7E,GAEMoB,IAAc5B,EAClB,CAAC6B,GAAmBC,MAAkB,GAAGD,CAAS,WAAWC,CAAK,IAClE,CAAA,CACF;AAEA,SAAO;AAAA,IACLlB,kBAAAA;AAAAA,IACAC,qBAAAA;AAAAA,IACAK,eAAAA;AAAAA,IACAU,aAAAA;AAAAA,EAAAA;AAEJ;"}
+{"version":3,"file":"index76.js","sources":["../src/utils/a11y/liveAnnouncer/LiveAnnouncerProvider.tsx"],"sourcesContent":["import React, { createContext, useEffect, useMemo } from 'react';\nimport {\n  announce,\n  clearAnnouncer,\n  destroyAnnouncer,\n  type AnnounceOptions,\n  type Assertiveness,\n} from './LiveAnnouncer';\n\n// ---------------------------------------------------------------------------\n// Context\n// ---------------------------------------------------------------------------\n\nexport interface LiveAnnouncerContextValue {\n  announce: (message: string, options?: AnnounceOptions) => void;\n  clear: (assertiveness?: Assertiveness) => void;\n}\n\nexport const LiveAnnouncerContext = createContext<LiveAnnouncerContextValue | null>(null);\n\n// ---------------------------------------------------------------------------\n// Provider\n// ---------------------------------------------------------------------------\n\nexport interface LiveAnnouncerProviderProps {\n  children: React.ReactNode;\n}\n\n/**\n * Mounts the singleton live-region container on mount and tears it down on\n * unmount. Provides `{ announce, clear }` via React context so descendants\n * can use the `useLiveAnnouncer` hook.\n *\n * Optional — `announce()` works without a provider (the singleton auto-creates\n * on first call). The provider simply gives you explicit lifecycle control.\n *\n * @example\n *   <LiveAnnouncerProvider>\n *     <App />\n *   </LiveAnnouncerProvider>\n */\nexport const LiveAnnouncerProvider: React.FC<LiveAnnouncerProviderProps> = ({ children }) => {\n  // Trigger singleton creation on mount (if not already created).\n  // The announce import already lazily creates, but calling it with an empty\n  // string ensures the container is in the DOM before any child renders.\n  useEffect(() => {\n    // Force singleton init by importing — the constructor runs on getInstance().\n    // We don't announce anything; just ensure the container exists.\n    announce('');\n    return () => {\n      destroyAnnouncer();\n    };\n  }, []);\n\n  const value = useMemo<LiveAnnouncerContextValue>(\n    () => ({ announce, clear: clearAnnouncer }),\n    []\n  );\n\n  return (\n    <LiveAnnouncerContext.Provider value={value}>\n      {children}\n    </LiveAnnouncerContext.Provider>\n  );\n};\n"],"names":["React__default","useEffect","useMemo","createContext","announce","destroyAnnouncer","clearAnnouncer","LiveAnnouncerContext","LiveAnnouncerProvider","children","value","clear","React","createElement","Provider"],"mappings":"AAkBO,OAAAA,KAAA,aAAAC,GAAA,WAAAC,GAAA,iBAAAC,SAAA;AAAA,SAAA,YAAAC,GAAA,oBAAAC,GAAA,kBAAAC,SAAA;AAAA,MAAMC,sBAAuE,IAAI,GAuB3EC,IAA8DA,CAAC;AAAA,EAAEC,UAAAA;AAAS,MAAM;AAI3FR,EAAAA,EAAU,OAGRG,EAAS,EAAE,GACJ,MAAM;AACXC,IAAAA,EAAAA;AAAAA,EACF,IACC,CAAA,CAAE;AAEL,QAAMK,IAAQR,EACZ,OAAO;AAAA,IAAEE,UAAAA;AAAAA,IAAUO,OAAOL;AAAAA,EAAAA,IAC1B,CAAA,CACF;AAEA,SACEM,gBAAAA,EAAAC,cAACN,EAAqBO,UAAQ;AAAA,IAACJ,OAAAA;AAAAA,EAAAA,GAC5BD,CAC4B;AAEnC;"}

package/dist/index77.js

@@ -1,27 +1,14 @@
-import * as e from "react";
-function p({
-  disabled: t = !1,
-  onFocusIn: u,
-  onFocusOut: n,
-  onEscape: a,
-  closeOnEscape: c = !0
-}) {
-  const f = e.useCallback((r) => {
-    t || u?.();
-  }, [t, u]), s = e.useCallback((r) => {
-    if (t) return;
-    const o = r.relatedTarget;
-    o && r.currentTarget.contains(o) || n?.();
-  }, [t, n]), C = e.useCallback((r) => {
-    t || !c || r.key !== "Escape" || (r.preventDefault(), a?.());
-  }, [t, c, a]);
-  return {
-    onFocusCapture: f,
-    onBlurCapture: s,
-    onKeyDownCapture: C
-  };
+import { useContext as t, useMemo as c } from "react";
+import { clearAnnouncer as u, announce as m } from "./index75.js";
+import { LiveAnnouncerContext as a } from "./index76.js";
+function l() {
+  const o = t(a), e = c(() => ({
+    announce: (n, r) => m(n, r ?? {}),
+    clear: (n) => u(n)
+  }), []);
+  return o ?? e;
 }
 export {
-  p as useDismissOnFocusOut
+  l as useLiveAnnouncer
 };
 //# sourceMappingURL=index77.js.map

package/dist/index77.js.map

@@ -1 +1 @@
-{"version":3,"file":"index77.js","sources":["../src/utils/a11y/useDismissOnFocusOut.ts"],"sourcesContent":["import * as React from 'react';\n\nexport type UseDismissOnFocusOutOptions = {\n  /**\n   * Disable all handlers (no-ops). Useful when a component provides alternate\n   * focus/keyboard behavior (e.g., disabled-trigger tooltip wrapper).\n   */\n  disabled?: boolean;\n  /**\n   * Called when focus enters anywhere within the target.\n   */\n  onFocusIn?: () => void;\n  /**\n   * Called when focus leaves the target (i.e., focus moves to an element\n   * outside the currentTarget).\n   */\n  onFocusOut?: () => void;\n  /**\n   * Called when Escape is pressed while focus is within the target.\n   */\n  onEscape?: () => void;\n  /**\n   * Whether Escape should trigger dismissal. Default: true.\n   */\n  closeOnEscape?: boolean;\n};\n\nexport type UseDismissOnFocusOutReturn<T extends HTMLElement = HTMLElement> = {\n  onFocusCapture: (e: React.FocusEvent<T>) => void;\n  onBlurCapture: (e: React.FocusEvent<T>) => void;\n  onKeyDownCapture: (e: React.KeyboardEvent<T>) => void;\n};\n\n/**\n * Returns capture-phase handlers to \"show on focus within\" and \"dismiss on focus out\",\n * with optional Escape-to-dismiss.\n *\n * Intended for non-interactive surfaces like tooltips where content should remain\n * visible while focus stays within the wrapper.\n */\nexport function useDismissOnFocusOut<T extends HTMLElement = HTMLElement>({\n  disabled = false,\n  onFocusIn,\n  onFocusOut,\n  onEscape,\n  closeOnEscape = true\n}: UseDismissOnFocusOutOptions): UseDismissOnFocusOutReturn<T> {\n  const onFocusCapture = React.useCallback(\n    (_e: React.FocusEvent<T>) => {\n      if (disabled) return;\n      onFocusIn?.();\n    },\n    [disabled, onFocusIn]\n  );\n\n  const onBlurCapture = React.useCallback(\n    (e: React.FocusEvent<T>) => {\n      if (disabled) return;\n\n      const nextFocused = e.relatedTarget as Node | null;\n      if (nextFocused && e.currentTarget.contains(nextFocused)) return;\n\n      onFocusOut?.();\n    },\n    [disabled, onFocusOut]\n  );\n\n  const onKeyDownCapture = React.useCallback(\n    (e: React.KeyboardEvent<T>) => {\n      if (disabled || !closeOnEscape || e.key !== 'Escape') return;\n\n      e.preventDefault();\n      onEscape?.();\n    },\n    [disabled, closeOnEscape, onEscape]\n  );\n\n  return { onFocusCapture, onBlurCapture, onKeyDownCapture };\n}\n\n"],"names":["React","useDismissOnFocusOut","disabled","onFocusIn","onFocusOut","onEscape","closeOnEscape","onFocusCapture","useCallback","_e","onBlurCapture","e","nextFocused","relatedTarget","currentTarget","contains","onKeyDownCapture","key","preventDefault"],"mappings":"AAwCO,YAAAA,OAAA;AAAA,SAASC,EAA0D;AAAA,EACxEC,UAAAA,IAAW;AAAA,EACXC,WAAAA;AAAAA,EACAC,YAAAA;AAAAA,EACAC,UAAAA;AAAAA,EACAC,eAAAA,IAAgB;AACW,GAAkC;AAC7D,QAAMC,IAAiBP,EAAMQ,YAC3B,CAACC,MAA4B;AAC3B,IAAIP,KACJC,IAAAA;AAAAA,EACF,GACA,CAACD,GAAUC,CAAS,CACtB,GAEMO,IAAgBV,EAAMQ,YAC1B,CAACG,MAA2B;AAC1B,QAAIT,EAAU;AAEd,UAAMU,IAAcD,EAAEE;AACtB,IAAID,KAAeD,EAAEG,cAAcC,SAASH,CAAW,KAEvDR,IAAAA;AAAAA,EACF,GACA,CAACF,GAAUE,CAAU,CACvB,GAEMY,IAAmBhB,EAAMQ,YAC7B,CAACG,MAA8B;AAC7B,IAAIT,KAAY,CAACI,KAAiBK,EAAEM,QAAQ,aAE5CN,EAAEO,eAAAA,GACFb,IAAAA;AAAAA,EACF,GACA,CAACH,GAAUI,GAAeD,CAAQ,CACpC;AAEA,SAAO;AAAA,IAAEE,gBAAAA;AAAAA,IAAgBG,eAAAA;AAAAA,IAAeM,kBAAAA;AAAAA,EAAAA;AAC1C;"}
+{"version":3,"file":"index77.js","sources":["../src/utils/a11y/liveAnnouncer/useLiveAnnouncer.ts"],"sourcesContent":["import { useContext, useMemo } from 'react';\nimport {\n  announce,\n  clearAnnouncer,\n  type AnnounceOptions,\n  type Assertiveness,\n} from './LiveAnnouncer';\nimport { LiveAnnouncerContext, type LiveAnnouncerContextValue } from './LiveAnnouncerProvider';\n\n/**\n * React hook that returns `{ announce, clear }`.\n *\n * Uses the LiveAnnouncerProvider context if available; otherwise falls back\n * to the module-level singleton (which auto-creates on first call).\n *\n * @example\n *   const { announce } = useLiveAnnouncer();\n *   announce('Document saved');\n *   announce('Upload failed', { assertiveness: 'assertive' });\n *   announce('5 results', { batchId: 'search-count' });\n */\nexport function useLiveAnnouncer(): LiveAnnouncerContextValue {\n  const fromContext = useContext(LiveAnnouncerContext);\n\n  const fallback = useMemo<LiveAnnouncerContextValue>(\n    () => ({\n      announce: (message: string, options?: AnnounceOptions) => announce(message, options ?? {}),\n      clear: (assertiveness?: Assertiveness) => clearAnnouncer(assertiveness),\n    }),\n    []\n  );\n\n  return fromContext ?? fallback;\n}\n"],"names":["useContext","useMemo","clearAnnouncer","announce","LiveAnnouncerContext","useLiveAnnouncer","fromContext","fallback","message","options","clear","assertiveness"],"mappings":"AAqBO,SAAA,cAAAA,GAAA,WAAAC,SAAA;AAAA,SAAA,kBAAAC,GAAA,YAAAC,SAAA;AAAA,SAAA,wBAAAC,SAAA;AAAA,SAASC,IAA8C;AAC5D,QAAMC,IAAcN,EAAWI,CAAoB,GAE7CG,IAAWN,EACf,OAAO;AAAA,IACLE,UAAUA,CAACK,GAAiBC,MAA8BN,EAASK,GAASC,KAAW,EAAE;AAAA,IACzFC,OAAOA,CAACC,MAAkCT,EAAeS,CAAa;AAAA,EAAA,IAExE,CAAA,CACF;AAEA,SAAOL,KAAeC;AACxB;"}

package/dist/index78.js

@@ -1,12 +1,8 @@
-function f({
-  ariaLabel: e,
-  ariaLabelledBy: i,
-  ariaDescribedBy: r
-}) {
-  const t = {};
-  return i ? t["aria-labelledby"] = i : e && (t["aria-label"] = e), r && (t["aria-describedby"] = r), t;
-}
+const t = () => typeof navigator < "u" && /Android/i.test(navigator.userAgent), o = (i) => {
+  const r = "pointerType" in i ? i.pointerType : void 0;
+  return r === "" && i.isTrusted ? !0 : t() && r ? i.type === "click" && i.buttons === 1 : i.detail === 0 && !r;
+};
 export {
-  f as getA11yNameAttributes
+  o as isVirtualClick
 };
 //# sourceMappingURL=index78.js.map

package/dist/index78.js.map

@@ -1 +1 @@
-{"version":3,"file":"index78.js","sources":["../src/utils/a11y/accessibleName.ts"],"sourcesContent":["/**\n * Accessible name/description utilities following WCAG precedence rules.\n * \n * **When to use:**\n * - `ariaLabelledBy`: visible label exists (preferred - keeps SR and visual text in sync)\n * - `ariaLabel`: no visible label (e.g., icon-only buttons)\n * - `ariaDescribedBy`: additional context needed (warnings, hints, constraints)\n * \n * **Precedence:** ariaLabelledBy > ariaLabel > visible text content\n * \n * @example Icon-only button\n * ```tsx\n * <Button iconProps={{ name: 'close' }} ariaLabel=\"Close dialog\" />\n * ```\n * \n * @example Disambiguate generic labels\n * ```tsx\n * <Button label=\"Edit\" ariaLabel=\"Edit name\" />\n * <Button label=\"Edit\" ariaLabel=\"Edit email\" />\n * ```\n */\n\nexport type AccessibleNameInput = {\n  /** Accessible name when no visible label exists (icon-only buttons). */\n  ariaLabel?: string;\n  /** ID(s) of visible element(s) that label this control. Preferred over ariaLabel. */\n  ariaLabelledBy?: string;\n  /** ID(s) of element(s) providing additional description (additive). */\n  ariaDescribedBy?: string;\n};\n\n/**\n * Returns ARIA attributes with correct precedence.\n * Prefer ariaLabelledBy > ariaLabel. ariaDescribedBy is always additive.\n */\nexport function getA11yNameAttributes({\n  ariaLabel,\n  ariaLabelledBy,\n  ariaDescribedBy\n}: AccessibleNameInput): Record<string, string> {\n  const props: Record<string, string> = {};\n\n  if (ariaLabelledBy) props['aria-labelledby'] = ariaLabelledBy;\n  else if (ariaLabel) props['aria-label'] = ariaLabel;\n\n  if (ariaDescribedBy) props['aria-describedby'] = ariaDescribedBy;\n\n  return props;\n}\n"],"names":["getA11yNameAttributes","ariaLabel","ariaLabelledBy","ariaDescribedBy","props"],"mappings":"AAmCO,SAASA,EAAsB;AAAA,EACpCC,WAAAA;AAAAA,EACAC,gBAAAA;AAAAA,EACAC,iBAAAA;AACmB,GAA2B;AAC9C,QAAMC,IAAgC,CAAA;AAEtC,SAAIF,IAAgBE,EAAM,iBAAiB,IAAIF,IACtCD,MAAWG,EAAM,YAAY,IAAIH,IAEtCE,MAAiBC,EAAM,kBAAkB,IAAID,IAE1CC;AACT;"}
+{"version":3,"file":"index78.js","sources":["../src/utils/virtualClick.ts"],"sourcesContent":["/**\n * Input/virtual click detection helpers.\n */\n\nconst isAndroid = () =>\n  typeof navigator !== 'undefined' && /Android/i.test(navigator.userAgent);\n\nexport const isVirtualClick = (event: MouseEvent | PointerEvent): boolean => {\n  const pointerType = 'pointerType' in event ? event.pointerType : undefined;\n\n  // JAWS/NVDA with Firefox.\n  if (pointerType === '' && event.isTrusted) {\n    return true;\n  }\n\n  // Android TalkBack's detail value varies depending on listener type.\n  if (isAndroid() && pointerType) {\n    return event.type === 'click' && event.buttons === 1;\n  }\n\n  // Most browsers: virtual click has detail === 0 and no pointerType.\n  return event.detail === 0 && !pointerType;\n};\n\n\n"],"names":["isAndroid","navigator","test","userAgent","isVirtualClick","event","pointerType","undefined","isTrusted","type","buttons","detail"],"mappings":"AAIA,MAAMA,IAAYA,MAChB,OAAOC,YAAc,OAAe,WAAWC,KAAKD,UAAUE,SAAS,GAE5DC,IAAiBA,CAACC,MAA8C;AAC3E,QAAMC,IAAc,iBAAiBD,IAAQA,EAAMC,cAAcC;AAGjE,SAAID,MAAgB,MAAMD,EAAMG,YACvB,KAILR,EAAAA,KAAeM,IACVD,EAAMI,SAAS,WAAWJ,EAAMK,YAAY,IAI9CL,EAAMM,WAAW,KAAK,CAACL;AAChC;"}

package/dist/index79.js

@@ -1,26 +1,62 @@
-import { useEffect as d } from "react";
-function p({
-  containerRef: r,
-  onDismiss: e,
-  enabled: n = !0,
-  preventDefault: u = !0,
-  stopPropagation: c = !0
+import { useState as g, useEffect as s, useCallback as d } from "react";
+import { useScrollActiveIntoView as I } from "./index247.js";
+function y({
+  items: u,
+  isOpen: t,
+  onSelect: n,
+  onClose: i,
+  onOpen: c,
+  loop: b = !0,
+  disabled: D = !1,
+  listboxRef: h,
+  optionSelector: v = '[role="option"]',
+  keepHighlightOnSelect: l = !1,
+  closeOnTab: k = !0
 }) {
-  d(() => {
-    if (!n || !e) return;
-    const o = r.current;
-    if (!o) return;
-    const a = (t) => {
-      t.key === "Escape" && o.contains(document.activeElement) && (u && t.preventDefault(), c && t.stopPropagation(), e());
-    };
-    return document.addEventListener("keydown", a, {
-      capture: !0
-    }), () => document.removeEventListener("keydown", a, {
-      capture: !0
-    });
-  }, [n, e, r, u, c]);
+  const [a, e] = g(-1);
+  s(() => {
+    t || e(-1);
+  }, [t]), I({
+    containerRef: h,
+    activeIndex: a,
+    itemSelector: v,
+    enabled: t
+  });
+  const w = d((r) => {
+    if (D) {
+      r.key === "Escape" && t && (r.preventDefault(), i());
+      return;
+    }
+    const f = u.length;
+    switch (r.key) {
+      case "ArrowDown":
+        r.preventDefault(), r.stopPropagation(), !t && f > 0 ? (c?.(), e(0)) : t && f > 0 && e((o) => b ? (o + 1) % f : Math.min(o + 1, f - 1));
+        break;
+      case "ArrowUp":
+        r.preventDefault(), r.stopPropagation(), t && f > 0 && e((o) => o === -1 ? f - 1 : b ? (o - 1 + f) % f : Math.max(o - 1, 0));
+        break;
+      case "Enter":
+        r.preventDefault(), t ? a >= 0 && u[a] && (n(u[a], a), l || e(-1)) : (c?.(), e(0));
+        break;
+      case " ":
+        r.preventDefault(), t ? a >= 0 && u[a] && (n(u[a], a), l || e(-1)) : (c?.(), e(0));
+        break;
+      case "Escape":
+        t && (r.preventDefault(), i(), e(-1));
+        break;
+      case "Tab":
+        t && k && (i(), e(-1));
+        break;
+    }
+  }, [D, u, t, a, n, i, c, b, l, k]), x = d((r, f) => `${r}-option-${f}`, []);
+  return {
+    highlightedIndex: a,
+    setHighlightedIndex: e,
+    handleKeyDown: w,
+    getOptionId: x
+  };
 }
 export {
-  p as useDismissOnEscape
+  y as useComboboxNavigation
 };
 //# sourceMappingURL=index79.js.map

package/dist/index79.js.map

@@ -1 +1 @@
-{"version":3,"file":"index79.js","sources":["../src/utils/a11y/useDismissOnEscape.ts"],"sourcesContent":["import { useEffect } from 'react';\nimport type { RefObject } from 'react';\n\nexport interface UseDismissOnEscapeOptions<T extends HTMLElement = HTMLElement> {\n  /**\n   * Container element ref to check if focus is within.\n   * Escape will only trigger if focus is within this container.\n   */\n  containerRef: RefObject<T | null>;\n  /**\n   * Callback when Escape key is pressed and focus is within container.\n   */\n  onDismiss?: () => void;\n  /**\n   * Whether the Escape handler is active.\n   * Default: true\n   */\n  enabled?: boolean;\n  /**\n   * Whether to call preventDefault() when handling Escape.\n   * Default: true\n   */\n  preventDefault?: boolean;\n  /**\n   * Whether to call stopPropagation() when handling Escape.\n   * Default: true\n   */\n  stopPropagation?: boolean;\n}\n\n/**\n * Hook to handle Escape key dismissal when focus is within a container.\n *\n * This is a UX pattern: if user is interacting with an overlay/sidebar\n * (indicated by focus being within it), Escape should close it.\n *\n * @example\n * ```tsx\n * const MySidebar = ({ isOpen, onClose }) => {\n *   const containerRef = useRef<HTMLDivElement>(null);\n *\n *   useDismissOnEscape({\n *     containerRef,\n *     onDismiss: onClose,\n *     enabled: isOpen\n *   });\n *\n *   return <div ref={containerRef}>...</div>;\n * };\n * ```\n */\nexport function useDismissOnEscape<T extends HTMLElement = HTMLElement>({\n  containerRef,\n  onDismiss,\n  enabled = true,\n  preventDefault = true,\n  stopPropagation = true\n}: UseDismissOnEscapeOptions<T>): void {\n  useEffect(() => {\n    if (!enabled || !onDismiss) return;\n\n    const container = containerRef.current;\n    if (!container) return;\n\n    const handleEscape = (e: KeyboardEvent) => {\n      if (e.key === 'Escape' && container.contains(document.activeElement)) {\n        preventDefault && e.preventDefault();\n        stopPropagation && e.stopPropagation();\n        onDismiss();\n      }\n    };\n\n    document.addEventListener('keydown', handleEscape, { capture: true });\n    return () => document.removeEventListener('keydown', handleEscape, { capture: true });\n  }, [enabled, onDismiss, containerRef, preventDefault, stopPropagation]);\n}\n"],"names":["useEffect","useDismissOnEscape","containerRef","onDismiss","enabled","preventDefault","stopPropagation","container","current","handleEscape","e","key","contains","document","activeElement","addEventListener","capture","removeEventListener"],"mappings":"AAmDO,SAAA,aAAAA,SAAA;AAAA,SAASC,EAAwD;AAAA,EACtEC,cAAAA;AAAAA,EACAC,WAAAA;AAAAA,EACAC,SAAAA,IAAU;AAAA,EACVC,gBAAAA,IAAiB;AAAA,EACjBC,iBAAAA,IAAkB;AACU,GAAS;AACrCN,EAAAA,EAAU,MAAM;AACd,QAAI,CAACI,KAAW,CAACD,EAAW;AAE5B,UAAMI,IAAYL,EAAaM;AAC/B,QAAI,CAACD,EAAW;AAEhB,UAAME,IAAeA,CAACC,MAAqB;AACzC,MAAIA,EAAEC,QAAQ,YAAYJ,EAAUK,SAASC,SAASC,aAAa,MACjET,KAAkBK,EAAEL,eAAAA,GACpBC,KAAmBI,EAAEJ,gBAAAA,GACrBH,EAAAA;AAAAA,IAEJ;AAEAU,oBAASE,iBAAiB,WAAWN,GAAc;AAAA,MAAEO,SAAS;AAAA,IAAA,CAAM,GAC7D,MAAMH,SAASI,oBAAoB,WAAWR,GAAc;AAAA,MAAEO,SAAS;AAAA,IAAA,CAAM;AAAA,EACtF,GAAG,CAACZ,GAASD,GAAWD,GAAcG,GAAgBC,CAAe,CAAC;AACxE;"}
+{"version":3,"file":"index79.js","sources":["../src/utils/a11y/useComboboxNavigation.ts"],"sourcesContent":["import { useCallback, useState, useEffect } from 'react';\nimport type { RefObject } from 'react';\nimport { useScrollActiveIntoView } from './useScrollActiveIntoView';\n\nexport interface UseComboboxNavigationOptions<T = any> {\n  /**\n   * Array of items to navigate through\n   */\n  items: T[];\n  \n  /**\n   * Whether the dropdown is currently open\n   */\n  isOpen: boolean;\n  \n  /**\n   * Callback when an item is selected (Enter key)\n   */\n  onSelect: (item: T, index: number) => void;\n  \n  /**\n   * Callback to close the dropdown\n   */\n  onClose: () => void;\n  \n  /**\n   * Optional: Callback to open the dropdown\n   */\n  onOpen?: () => void;\n  \n  /**\n   * Whether to wrap around at the ends of the list.\n   * Default: true\n   */\n  loop?: boolean;\n  \n  /**\n   * Whether keyboard navigation is disabled\n   * (e.g., for custom rendered content)\n   */\n  disabled?: boolean;\n\n  /**\n   * Whether to keep the highlighted index after selecting an item.\n   * Useful for multi-select where the dropdown stays open after selection.\n   * Default: false\n   */\n  keepHighlightOnSelect?: boolean;\n\n  /**\n   * Whether Tab should close the dropdown.\n   * Set to false when Tab should move focus to elements within the popup (e.g. CTAs).\n   * Default: true\n   */\n  closeOnTab?: boolean;\n\n  /**\n   * Ref to the listbox container for scroll management\n   */\n  listboxRef?: RefObject<HTMLElement | null>;\n  \n  /**\n   * CSS selector for option elements (default: '[role=\"option\"]')\n   */\n  optionSelector?: string;\n}\n\nexport interface UseComboboxNavigationReturn {\n  /**\n   * Currently highlighted index (-1 if none)\n   */\n  highlightedIndex: number;\n  \n  /**\n   * Set the highlighted index manually\n   */\n  setHighlightedIndex: (index: number | ((prev: number) => number)) => void;\n  \n  /**\n   * Keyboard event handler for the combobox input\n   */\n  handleKeyDown: (e: React.KeyboardEvent) => void;\n  \n  /**\n   * Generate stable ID for an option\n   */\n  getOptionId: (listboxId: string, index: number) => string;\n  \n}\n\n/**\n * Hook for managing combobox keyboard navigation with aria-activedescendant.\n * \n * Implements WAI-ARIA 1.2 Combobox pattern:\n * - Arrow Up/Down to navigate options\n * - Enter to select highlighted option\n * - Escape to close dropdown\n * - Tab to close and move focus\n * - Auto-scrolls highlighted option into view\n * \n * @example\n * ```tsx\n * const { \n *   highlightedIndex, \n *   handleKeyDown, \n *   getOptionId \n * } = useComboboxNavigation({\n *   items: suggestions,\n *   isOpen: isDropdownOpen,\n *   onSelect: (item, idx) => handleSelect(item),\n *   onClose: () => setIsOpen(false),\n *   listboxRef\n * });\n * \n * <input\n *   role=\"combobox\"\n *   onKeyDown={handleKeyDown}\n *   aria-activedescendant={highlightedIndex >= 0 ? getOptionId(listboxId, highlightedIndex) : undefined}\n * />\n * ```\n */\nexport function useComboboxNavigation<T = any>({\n  items,\n  isOpen,\n  onSelect,\n  onClose,\n  onOpen,\n  loop = true,\n  disabled = false,\n  listboxRef,\n  optionSelector = '[role=\"option\"]',\n  keepHighlightOnSelect = false,\n  closeOnTab = true\n}: UseComboboxNavigationOptions<T>): UseComboboxNavigationReturn {\n  const [highlightedIndex, setHighlightedIndex] = useState<number>(-1);\n  \n  // Reset highlighted index when dropdown closes\n  useEffect(() => {\n    if (!isOpen) {\n      setHighlightedIndex(-1);\n    }\n  }, [isOpen]);\n  \n  // Auto-scroll highlighted item into view\n  useScrollActiveIntoView({\n    containerRef: listboxRef,\n    activeIndex: highlightedIndex,\n    itemSelector: optionSelector,\n    enabled: isOpen\n  });\n  \n  const handleKeyDown = useCallback(\n    (e: React.KeyboardEvent) => {\n      if (disabled) {\n        // For disabled navigation, still handle Escape\n        if (e.key === 'Escape' && isOpen) {\n          e.preventDefault();\n          onClose();\n        }\n        return;\n      }\n      \n      const itemCount = items.length;\n      \n      switch (e.key) {\n        case 'ArrowDown':\n          e.preventDefault();\n          e.stopPropagation();\n          if (!isOpen && itemCount > 0) {\n            // Open dropdown and highlight first item\n            onOpen?.();\n            setHighlightedIndex(0);\n          } else if (isOpen && itemCount > 0) {\n            // Navigate down\n            setHighlightedIndex((prev) => {\n              if (loop) {\n                return (prev + 1) % itemCount;\n              }\n              return Math.min(prev + 1, itemCount - 1);\n            });\n          }\n          break;\n\n        case 'ArrowUp':\n          e.preventDefault();\n          e.stopPropagation();\n          if (isOpen && itemCount > 0) {\n            // Navigate up\n            setHighlightedIndex((prev) => {\n              // If nothing highlighted, go to last item\n              if (prev === -1) {\n                return itemCount - 1;\n              }\n              if (loop) {\n                return (prev - 1 + itemCount) % itemCount;\n              }\n              return Math.max(prev - 1, 0);\n            });\n          }\n          break;\n          \n        case 'Enter':\n          e.preventDefault();\n          if (!isOpen) {\n            onOpen?.();\n            setHighlightedIndex(0);\n          } else if (highlightedIndex >= 0 && items[highlightedIndex]) {\n            onSelect(items[highlightedIndex], highlightedIndex);\n            if (!keepHighlightOnSelect) {\n              setHighlightedIndex(-1);\n            }\n          }\n          break;\n\n        case ' ':\n          e.preventDefault();\n          if (!isOpen) {\n            onOpen?.();\n            setHighlightedIndex(0);\n          } else if (highlightedIndex >= 0 && items[highlightedIndex]) {\n            onSelect(items[highlightedIndex], highlightedIndex);\n            if (!keepHighlightOnSelect) {\n              setHighlightedIndex(-1);\n            }\n          }\n          break;\n        case 'Escape':\n          if (isOpen) {\n            e.preventDefault();\n            onClose();\n            setHighlightedIndex(-1);\n          }\n          break;\n          \n        case 'Tab':\n          // closeOnTab=true (default): close dropdown and let focus move to next element\n          // closeOnTab=false: keep dropdown open so Tab reaches CTAs (Clear/Apply)\n          if (isOpen && closeOnTab) {\n            onClose();\n            setHighlightedIndex(-1);\n          }\n          break;\n      }\n    },\n    [disabled, items, isOpen, highlightedIndex, onSelect, onClose, onOpen, loop, keepHighlightOnSelect, closeOnTab]\n  );\n  \n  const getOptionId = useCallback(\n    (listboxId: string, index: number) => `${listboxId}-option-${index}`,\n    []\n  );\n  \n  return {\n    highlightedIndex,\n    setHighlightedIndex,\n    handleKeyDown,\n    getOptionId\n  };\n}\n"],"names":["useState","useEffect","useCallback","useScrollActiveIntoView","useComboboxNavigation","items","isOpen","onSelect","onClose","onOpen","loop","disabled","listboxRef","optionSelector","keepHighlightOnSelect","closeOnTab","highlightedIndex","setHighlightedIndex","containerRef","activeIndex","itemSelector","enabled","handleKeyDown","e","key","preventDefault","itemCount","length","stopPropagation","prev","Math","min","max","getOptionId","listboxId","index"],"mappings":"AAyHO,SAAA,YAAAA,GAAA,aAAAC,GAAA,eAAAC,SAAA;AAAA,SAAA,2BAAAC,SAAA;AAAA,SAASC,EAA+B;AAAA,EAC7CC,OAAAA;AAAAA,EACAC,QAAAA;AAAAA,EACAC,UAAAA;AAAAA,EACAC,SAAAA;AAAAA,EACAC,QAAAA;AAAAA,EACAC,MAAAA,IAAO;AAAA,EACPC,UAAAA,IAAW;AAAA,EACXC,YAAAA;AAAAA,EACAC,gBAAAA,IAAiB;AAAA,EACjBC,uBAAAA,IAAwB;AAAA,EACxBC,YAAAA,IAAa;AACkB,GAAgC;AAC/D,QAAM,CAACC,GAAkBC,CAAmB,IAAIjB,EAAiB,EAAE;AAGnEC,EAAAA,EAAU,MAAM;AACd,IAAKK,KACHW,EAAoB,EAAE;AAAA,EAE1B,GAAG,CAACX,CAAM,CAAC,GAGXH,EAAwB;AAAA,IACtBe,cAAcN;AAAAA,IACdO,aAAaH;AAAAA,IACbI,cAAcP;AAAAA,IACdQ,SAASf;AAAAA,EAAAA,CACV;AAED,QAAMgB,IAAgBpB,EACpB,CAACqB,MAA2B;AAC1B,QAAIZ,GAAU;AAEZ,MAAIY,EAAEC,QAAQ,YAAYlB,MACxBiB,EAAEE,eAAAA,GACFjB,EAAAA;AAEF;AAAA,IACF;AAEA,UAAMkB,IAAYrB,EAAMsB;AAExB,YAAQJ,EAAEC,KAAAA;AAAAA,MACR,KAAK;AACHD,QAAAA,EAAEE,eAAAA,GACFF,EAAEK,gBAAAA,GACE,CAACtB,KAAUoB,IAAY,KAEzBjB,IAAAA,GACAQ,EAAoB,CAAC,KACZX,KAAUoB,IAAY,KAE/BT,EAAqBY,CAAAA,MACfnB,KACMmB,IAAO,KAAKH,IAEfI,KAAKC,IAAIF,IAAO,GAAGH,IAAY,CAAC,CACxC;AAEH;AAAA,MAEF,KAAK;AACHH,QAAAA,EAAEE,eAAAA,GACFF,EAAEK,gBAAAA,GACEtB,KAAUoB,IAAY,KAExBT,EAAqBY,CAAAA,MAEfA,MAAS,KACJH,IAAY,IAEjBhB,KACMmB,IAAO,IAAIH,KAAaA,IAE3BI,KAAKE,IAAIH,IAAO,GAAG,CAAC,CAC5B;AAEH;AAAA,MAEF,KAAK;AACHN,QAAAA,EAAEE,eAAAA,GACGnB,IAGMU,KAAoB,KAAKX,EAAMW,CAAgB,MACxDT,EAASF,EAAMW,CAAgB,GAAGA,CAAgB,GAC7CF,KACHG,EAAoB,EAAE,MALxBR,IAAAA,GACAQ,EAAoB,CAAC;AAOvB;AAAA,MAEF,KAAK;AACHM,QAAAA,EAAEE,eAAAA,GACGnB,IAGMU,KAAoB,KAAKX,EAAMW,CAAgB,MACxDT,EAASF,EAAMW,CAAgB,GAAGA,CAAgB,GAC7CF,KACHG,EAAoB,EAAE,MALxBR,IAAAA,GACAQ,EAAoB,CAAC;AAOvB;AAAA,MACF,KAAK;AACH,QAAIX,MACFiB,EAAEE,eAAAA,GACFjB,EAAAA,GACAS,EAAoB,EAAE;AAExB;AAAA,MAEF,KAAK;AAGH,QAAIX,KAAUS,MACZP,EAAAA,GACAS,EAAoB,EAAE;AAExB;AAAA,IAAA;AAAA,EAEN,GACA,CAACN,GAAUN,GAAOC,GAAQU,GAAkBT,GAAUC,GAASC,GAAQC,GAAMI,GAAuBC,CAAU,CAChH,GAEMkB,IAAc/B,EAClB,CAACgC,GAAmBC,MAAkB,GAAGD,CAAS,WAAWC,CAAK,IAClE,CAAA,CACF;AAEA,SAAO;AAAA,IACLnB,kBAAAA;AAAAA,IACAC,qBAAAA;AAAAA,IACAK,eAAAA;AAAAA,IACAW,aAAAA;AAAAA,EAAAA;AAEJ;"}

package/dist/index80.js

@@ -1,22 +1,27 @@
-import { useEffect as s } from "react";
-const u = {
-  block: "nearest"
-};
-function m({
-  containerRef: t,
-  activeIndex: o,
-  itemSelector: r = '[role="option"]',
-  enabled: c = !0,
-  scrollOptions: e = u
+import * as e from "react";
+function p({
+  disabled: t = !1,
+  onFocusIn: u,
+  onFocusOut: n,
+  onEscape: a,
+  closeOnEscape: c = !0
 }) {
-  s(() => {
-    if (!c || o < 0 || !t?.current)
-      return;
-    const n = t.current.querySelectorAll(r)[o];
-    n && n.scrollIntoView(e);
-  }, [o, t, r, c, e]);
+  const f = e.useCallback((r) => {
+    t || u?.();
+  }, [t, u]), s = e.useCallback((r) => {
+    if (t) return;
+    const o = r.relatedTarget;
+    o && r.currentTarget.contains(o) || n?.();
+  }, [t, n]), C = e.useCallback((r) => {
+    t || !c || r.key !== "Escape" || (r.preventDefault(), a?.());
+  }, [t, c, a]);
+  return {
+    onFocusCapture: f,
+    onBlurCapture: s,
+    onKeyDownCapture: C
+  };
 }
 export {
-  m as useScrollActiveIntoView
+  p as useDismissOnFocusOut
 };
 //# sourceMappingURL=index80.js.map

package/dist/index80.js.map

@@ -1 +1 @@
-{"version":3,"file":"index80.js","sources":["../src/utils/a11y/useScrollActiveIntoView.ts"],"sourcesContent":["import { useEffect } from 'react';\nimport type { RefObject } from 'react';\n\nconst DEFAULT_SCROLL_OPTIONS: ScrollIntoViewOptions = { block: 'nearest' };\n\nexport interface UseScrollActiveIntoViewOptions {\n  /**\n   * Ref to the container element\n   */\n  containerRef?: RefObject<HTMLElement | null>;\n  \n  /**\n   * Index of the currently active/highlighted item (-1 if none)\n   */\n  activeIndex: number;\n  \n  /**\n   * CSS selector for item elements\n   * Default: '[role=\"option\"]'\n   */\n  itemSelector?: string;\n  \n  /**\n   * Whether scrolling is enabled\n   * Default: true\n   */\n  enabled?: boolean;\n  \n  /**\n   * ScrollIntoView options\n   * Default: { block: 'nearest' }\n   */\n  scrollOptions?: ScrollIntoViewOptions;\n}\n\n/**\n * Hook to automatically scroll the active item into view.\n * \n * Useful for aria-activedescendant patterns where DOM focus stays\n * on the container (e.g., input field) but we need to visually show\n * which descendant option is logically active.\n * \n * Common use cases:\n * - Combobox dropdown options\n * - Menu items with virtual focus\n * - Grid cells with keyboard navigation\n * - Tree view items\n * - Listbox options\n * \n * @example\n * ```tsx\n * const [highlightedIndex, setHighlightedIndex] = useState(-1);\n * const listboxRef = useRef<HTMLDivElement>(null);\n * \n * useScrollActiveIntoView({\n *   containerRef: listboxRef,\n *   activeIndex: highlightedIndex,\n *   itemSelector: '[role=\"option\"]'\n * });\n * \n * // Now when highlightedIndex changes, the item scrolls into view\n * ```\n * \n * @example Custom scroll behavior\n * ```tsx\n * useScrollActiveIntoView({\n *   containerRef: menuRef,\n *   activeIndex: activeMenuIndex,\n *   itemSelector: '[role=\"menuitem\"]',\n *   scrollOptions: { block: 'center', behavior: 'smooth' }\n * });\n * ```\n */\nexport function useScrollActiveIntoView({\n  containerRef,\n  activeIndex,\n  itemSelector = '[role=\"option\"]',\n  enabled = true,\n  scrollOptions = DEFAULT_SCROLL_OPTIONS\n}: UseScrollActiveIntoViewOptions): void {\n  useEffect(() => {\n    // Early returns for disabled states\n    if (!enabled || activeIndex < 0 || !containerRef?.current) {\n      return;\n    }\n    \n    const container = containerRef.current;\n    const items = container.querySelectorAll(itemSelector);\n    const activeItem = items[activeIndex] as HTMLElement;\n    \n    if (activeItem) {\n      activeItem.scrollIntoView(scrollOptions);\n    }\n  }, [activeIndex, containerRef, itemSelector, enabled, scrollOptions]);\n}\n"],"names":["useEffect","DEFAULT_SCROLL_OPTIONS","block","useScrollActiveIntoView","containerRef","activeIndex","itemSelector","enabled","scrollOptions","current","activeItem","querySelectorAll","scrollIntoView"],"mappings":"AAGA,SAAA,aAAAA,SAAA;AAAA,MAAMC,IAAgD;AAAA,EAAEC,OAAO;AAAU;AAsElE,SAASC,EAAwB;AAAA,EACtCC,cAAAA;AAAAA,EACAC,aAAAA;AAAAA,EACAC,cAAAA,IAAe;AAAA,EACfC,SAAAA,IAAU;AAAA,EACVC,eAAAA,IAAgBP;AACc,GAAS;AACvCD,EAAAA,EAAU,MAAM;AAEd,QAAI,CAACO,KAAWF,IAAc,KAAK,CAACD,GAAcK;AAChD;AAKF,UAAMC,IAFYN,EAAaK,QACPE,iBAAiBL,CAAY,EAC5BD,CAAW;AAEpC,IAAIK,KACFA,EAAWE,eAAeJ,CAAa;AAAA,EAE3C,GAAG,CAACH,GAAaD,GAAcE,GAAcC,GAASC,CAAa,CAAC;AACtE;"}
+{"version":3,"file":"index80.js","sources":["../src/utils/a11y/useDismissOnFocusOut.ts"],"sourcesContent":["import * as React from 'react';\n\nexport type UseDismissOnFocusOutOptions = {\n  /**\n   * Disable all handlers (no-ops). Useful when a component provides alternate\n   * focus/keyboard behavior (e.g., disabled-trigger tooltip wrapper).\n   */\n  disabled?: boolean;\n  /**\n   * Called when focus enters anywhere within the target.\n   */\n  onFocusIn?: () => void;\n  /**\n   * Called when focus leaves the target (i.e., focus moves to an element\n   * outside the currentTarget).\n   */\n  onFocusOut?: () => void;\n  /**\n   * Called when Escape is pressed while focus is within the target.\n   */\n  onEscape?: () => void;\n  /**\n   * Whether Escape should trigger dismissal. Default: true.\n   */\n  closeOnEscape?: boolean;\n};\n\nexport type UseDismissOnFocusOutReturn<T extends HTMLElement = HTMLElement> = {\n  onFocusCapture: (e: React.FocusEvent<T>) => void;\n  onBlurCapture: (e: React.FocusEvent<T>) => void;\n  onKeyDownCapture: (e: React.KeyboardEvent<T>) => void;\n};\n\n/**\n * Returns capture-phase handlers to \"show on focus within\" and \"dismiss on focus out\",\n * with optional Escape-to-dismiss.\n *\n * Intended for non-interactive surfaces like tooltips where content should remain\n * visible while focus stays within the wrapper.\n */\nexport function useDismissOnFocusOut<T extends HTMLElement = HTMLElement>({\n  disabled = false,\n  onFocusIn,\n  onFocusOut,\n  onEscape,\n  closeOnEscape = true\n}: UseDismissOnFocusOutOptions): UseDismissOnFocusOutReturn<T> {\n  const onFocusCapture = React.useCallback(\n    (_e: React.FocusEvent<T>) => {\n      if (disabled) return;\n      onFocusIn?.();\n    },\n    [disabled, onFocusIn]\n  );\n\n  const onBlurCapture = React.useCallback(\n    (e: React.FocusEvent<T>) => {\n      if (disabled) return;\n\n      const nextFocused = e.relatedTarget as Node | null;\n      if (nextFocused && e.currentTarget.contains(nextFocused)) return;\n\n      onFocusOut?.();\n    },\n    [disabled, onFocusOut]\n  );\n\n  const onKeyDownCapture = React.useCallback(\n    (e: React.KeyboardEvent<T>) => {\n      if (disabled || !closeOnEscape || e.key !== 'Escape') return;\n\n      e.preventDefault();\n      onEscape?.();\n    },\n    [disabled, closeOnEscape, onEscape]\n  );\n\n  return { onFocusCapture, onBlurCapture, onKeyDownCapture };\n}\n\n"],"names":["React","useDismissOnFocusOut","disabled","onFocusIn","onFocusOut","onEscape","closeOnEscape","onFocusCapture","useCallback","_e","onBlurCapture","e","nextFocused","relatedTarget","currentTarget","contains","onKeyDownCapture","key","preventDefault"],"mappings":"AAwCO,YAAAA,OAAA;AAAA,SAASC,EAA0D;AAAA,EACxEC,UAAAA,IAAW;AAAA,EACXC,WAAAA;AAAAA,EACAC,YAAAA;AAAAA,EACAC,UAAAA;AAAAA,EACAC,eAAAA,IAAgB;AACW,GAAkC;AAC7D,QAAMC,IAAiBP,EAAMQ,YAC3B,CAACC,MAA4B;AAC3B,IAAIP,KACJC,IAAAA;AAAAA,EACF,GACA,CAACD,GAAUC,CAAS,CACtB,GAEMO,IAAgBV,EAAMQ,YAC1B,CAACG,MAA2B;AAC1B,QAAIT,EAAU;AAEd,UAAMU,IAAcD,EAAEE;AACtB,IAAID,KAAeD,EAAEG,cAAcC,SAASH,CAAW,KAEvDR,IAAAA;AAAAA,EACF,GACA,CAACF,GAAUE,CAAU,CACvB,GAEMY,IAAmBhB,EAAMQ,YAC7B,CAACG,MAA8B;AAC7B,IAAIT,KAAY,CAACI,KAAiBK,EAAEM,QAAQ,aAE5CN,EAAEO,eAAAA,GACFb,IAAAA;AAAAA,EACF,GACA,CAACH,GAAUI,GAAeD,CAAQ,CACpC;AAEA,SAAO;AAAA,IAAEE,gBAAAA;AAAAA,IAAgBG,eAAAA;AAAAA,IAAeM,kBAAAA;AAAAA,EAAAA;AAC1C;"}

package/dist/index81.js

@@ -1,12 +1,12 @@
-function n(i) {
-  if (!i) return !1;
-  const t = window.getComputedStyle(i);
-  if (t.display === "none" || t.visibility === "hidden")
-    return !1;
-  const e = i.getBoundingClientRect();
-  return e.width > 0 && e.height > 0;
+function f({
+  ariaLabel: e,
+  ariaLabelledBy: i,
+  ariaDescribedBy: r
+}) {
+  const t = {};
+  return i ? t["aria-labelledby"] = i : e && (t["aria-label"] = e), r && (t["aria-describedby"] = r), t;
 }
 export {
-  n as isElementVisible
+  f as getA11yNameAttributes
 };
 //# sourceMappingURL=index81.js.map

package/dist/index81.js.map

@@ -1 +1 @@
-{"version":3,"file":"index81.js","sources":["../src/utils/a11y/elementVisibility.ts"],"sourcesContent":["/**\n * Checks if an element is visible in the DOM.\n * \n * An element is considered visible if:\n * - It exists in the DOM\n * - It's not hidden via CSS (display: none, visibility: hidden)\n * - It has actual dimensions (width > 0 and height > 0)\n * \n * @param element - The element to check, or null\n * @returns true if the element is visible, false otherwise\n * \n * @example\n * const element = document.getElementById('my-element');\n * if (isElementVisible(element)) {\n *   // Element is visible\n * }\n */\nexport function isElementVisible(element: HTMLElement | null): boolean {\n  if (!element) return false;\n\n  // Check computed style for display/visibility\n  const style = window.getComputedStyle(element);\n  if (style.display === 'none' || style.visibility === 'hidden') {\n    return false;\n  }\n\n  // Check if element has dimensions\n  const rect = element.getBoundingClientRect();\n  return rect.width > 0 && rect.height > 0;\n}\n"],"names":["isElementVisible","element","style","window","getComputedStyle","display","visibility","rect","getBoundingClientRect","width","height"],"mappings":"AAiBO,SAASA,EAAiBC,GAAsC;AACrE,MAAI,CAACA,EAAS,QAAO;AAGrB,QAAMC,IAAQC,OAAOC,iBAAiBH,CAAO;AAC7C,MAAIC,EAAMG,YAAY,UAAUH,EAAMI,eAAe;AACnD,WAAO;AAIT,QAAMC,IAAON,EAAQO,sBAAAA;AACrB,SAAOD,EAAKE,QAAQ,KAAKF,EAAKG,SAAS;AACzC;"}
+{"version":3,"file":"index81.js","sources":["../src/utils/a11y/accessibleName.ts"],"sourcesContent":["/**\n * Accessible name/description utilities following WCAG precedence rules.\n * \n * **When to use:**\n * - `ariaLabelledBy`: visible label exists (preferred - keeps SR and visual text in sync)\n * - `ariaLabel`: no visible label (e.g., icon-only buttons)\n * - `ariaDescribedBy`: additional context needed (warnings, hints, constraints)\n * \n * **Precedence:** ariaLabelledBy > ariaLabel > visible text content\n * \n * @example Icon-only button\n * ```tsx\n * <Button iconProps={{ name: 'close' }} ariaLabel=\"Close dialog\" />\n * ```\n * \n * @example Disambiguate generic labels\n * ```tsx\n * <Button label=\"Edit\" ariaLabel=\"Edit name\" />\n * <Button label=\"Edit\" ariaLabel=\"Edit email\" />\n * ```\n */\n\nexport type AccessibleNameInput = {\n  /** Accessible name when no visible label exists (icon-only buttons). */\n  ariaLabel?: string;\n  /** ID(s) of visible element(s) that label this control. Preferred over ariaLabel. */\n  ariaLabelledBy?: string;\n  /** ID(s) of element(s) providing additional description (additive). */\n  ariaDescribedBy?: string;\n};\n\n/**\n * Returns ARIA attributes with correct precedence.\n * Prefer ariaLabelledBy > ariaLabel. ariaDescribedBy is always additive.\n */\nexport function getA11yNameAttributes({\n  ariaLabel,\n  ariaLabelledBy,\n  ariaDescribedBy\n}: AccessibleNameInput): Record<string, string> {\n  const props: Record<string, string> = {};\n\n  if (ariaLabelledBy) props['aria-labelledby'] = ariaLabelledBy;\n  else if (ariaLabel) props['aria-label'] = ariaLabel;\n\n  if (ariaDescribedBy) props['aria-describedby'] = ariaDescribedBy;\n\n  return props;\n}\n"],"names":["getA11yNameAttributes","ariaLabel","ariaLabelledBy","ariaDescribedBy","props"],"mappings":"AAmCO,SAASA,EAAsB;AAAA,EACpCC,WAAAA;AAAAA,EACAC,gBAAAA;AAAAA,EACAC,iBAAAA;AACmB,GAA2B;AAC9C,QAAMC,IAAgC,CAAA;AAEtC,SAAIF,IAAgBE,EAAM,iBAAiB,IAAIF,IACtCD,MAAWG,EAAM,YAAY,IAAIH,IAEtCE,MAAiBC,EAAM,kBAAkB,IAAID,IAE1CC;AACT;"}

package/dist/index83.js

@@ -1,9 +1,5 @@
-import { useRef as n } from "react";
-function u(e, t = "se-id") {
-  const r = n("");
-  return r.current || (r.current = `${t}-${crypto.randomUUID()}`), e || r.current;
-}
+const L = "data:image/svg+xml,%3csvg%20width='32'%20height='32'%20viewBox='0%200%2032%2032'%20fill='none'%20xmlns='http://www.w3.org/2000/svg'%3e%3crect%20width='32'%20height='32'%20rx='16'%20fill='white'/%3e%3cpath%20d='M11.0179%2013.3597L12.27%2010.855L13.5222%2013.3597C13.9204%2014.1563%2014.5662%2014.8021%2015.3627%2015.2004L17.8682%2016.4531L15.3627%2017.7059C14.5662%2018.1041%2013.9204%2018.75%2013.5222%2019.5465L12.27%2022.0513L11.0179%2019.5465C10.6197%2018.75%209.97387%2018.1041%209.17738%2017.7059L6.67188%2016.4531L9.17738%2015.2004C9.97387%2014.8021%2010.6197%2014.1563%2011.0179%2013.3597Z'%20fill='%23415575'/%3e%3cpath%20d='M19.0159%207.18859L19.4685%206.2832L19.9211%207.18859C20.3193%207.98511%2020.9651%208.63098%2021.7616%209.02923L22.6674%209.48215L21.7616%209.93506C20.9651%2010.3333%2020.3193%2010.9792%2019.9211%2011.7757L19.4685%2012.6811L19.0159%2011.7757C18.6177%2010.9792%2017.9719%2010.3333%2017.1754%209.93506L16.2695%209.48215L17.1754%209.02923C17.9719%208.63098%2018.6177%207.98511%2019.0159%207.18859Z'%20fill='%23415575'/%3e%3cpath%20d='M19.0159%2021.3561L19.4685%2020.4507L19.9211%2021.3561C20.3193%2022.1526%2020.9651%2022.7985%2021.7616%2023.1967L22.6674%2023.6496L21.7616%2024.1025C20.9651%2024.5008%2020.3193%2025.1467%2019.9211%2025.9432L19.4685%2026.8486L19.0159%2025.9432C18.6177%2025.1467%2017.9719%2024.5008%2017.1754%2024.1025L16.2695%2023.6496L17.1754%2023.1967C17.9719%2022.7985%2018.6177%2022.1526%2019.0159%2021.3561Z'%20fill='%23415575'/%3e%3c/svg%3e";
 export {
-  u as useStableId
+  L as default
 };
 //# sourceMappingURL=index83.js.map

package/dist/index83.js.map

@@ -1 +1 @@
-{"version":3,"file":"index83.js","sources":["../src/utils/useStableId.ts"],"sourcesContent":["import { useRef } from 'react';\n\n/**\n * Generates a stable unique ID for component instances (React 16 compatible).\n * Returns the provided id if given, otherwise generates a stable per-mount id.\n * \n * @param id - Optional explicit id\n * @param prefix - Prefix for auto-generated ids (default: 'se-id')\n * @returns Stable id string\n */\nexport function useStableId(id?: string, prefix: string = 'se-id'): string {\n  const autoIdRef = useRef<string>('');\n  \n  if (!autoIdRef.current) {\n    autoIdRef.current = `${prefix}-${crypto.randomUUID()}`;\n  }\n  \n  return id || autoIdRef.current;\n}\n\n\n\n\n\n\n\n"],"names":["useRef","useStableId","id","prefix","autoIdRef","current","crypto","randomUUID"],"mappings":"AAUO,SAAA,UAAAA,SAAA;AAAA,SAASC,EAAYC,GAAaC,IAAiB,SAAiB;AACzE,QAAMC,IAAYJ,EAAe,EAAE;AAEnC,SAAKI,EAAUC,YACbD,EAAUC,UAAU,GAAGF,CAAM,IAAIG,OAAOC,YAAY,KAG/CL,KAAME,EAAUC;AACzB;"}
+{"version":3,"file":"index83.js","sources":["../src/assets/icons/ai-off.svg?url"],"sourcesContent":["export default \"data:image/svg+xml,%3csvg%20width='32'%20height='32'%20viewBox='0%200%2032%2032'%20fill='none'%20xmlns='http://www.w3.org/2000/svg'%3e%3crect%20width='32'%20height='32'%20rx='16'%20fill='white'/%3e%3cpath%20d='M11.0179%2013.3597L12.27%2010.855L13.5222%2013.3597C13.9204%2014.1563%2014.5662%2014.8021%2015.3627%2015.2004L17.8682%2016.4531L15.3627%2017.7059C14.5662%2018.1041%2013.9204%2018.75%2013.5222%2019.5465L12.27%2022.0513L11.0179%2019.5465C10.6197%2018.75%209.97387%2018.1041%209.17738%2017.7059L6.67188%2016.4531L9.17738%2015.2004C9.97387%2014.8021%2010.6197%2014.1563%2011.0179%2013.3597Z'%20fill='%23415575'/%3e%3cpath%20d='M19.0159%207.18859L19.4685%206.2832L19.9211%207.18859C20.3193%207.98511%2020.9651%208.63098%2021.7616%209.02923L22.6674%209.48215L21.7616%209.93506C20.9651%2010.3333%2020.3193%2010.9792%2019.9211%2011.7757L19.4685%2012.6811L19.0159%2011.7757C18.6177%2010.9792%2017.9719%2010.3333%2017.1754%209.93506L16.2695%209.48215L17.1754%209.02923C17.9719%208.63098%2018.6177%207.98511%2019.0159%207.18859Z'%20fill='%23415575'/%3e%3cpath%20d='M19.0159%2021.3561L19.4685%2020.4507L19.9211%2021.3561C20.3193%2022.1526%2020.9651%2022.7985%2021.7616%2023.1967L22.6674%2023.6496L21.7616%2024.1025C20.9651%2024.5008%2020.3193%2025.1467%2019.9211%2025.9432L19.4685%2026.8486L19.0159%2025.9432C18.6177%2025.1467%2017.9719%2024.5008%2017.1754%2024.1025L16.2695%2023.6496L17.1754%2023.1967C17.9719%2022.7985%2018.6177%2022.1526%2019.0159%2021.3561Z'%20fill='%23415575'/%3e%3c/svg%3e\""],"names":["__vite_glob_0_0"],"mappings":"AAAA,MAAAA,IAAe;"}

package/dist/index84.js

@@ -1,71 +1,5 @@
-import { useRef as a, useLayoutEffect as m, useEffect as g } from "react";
-import { getFirstFocusableElement as f, getLastFocusableElement as F } from "./index71.js";
-import { consumeFocusAnchor as I, consumeLastInteractedElement as E } from "./index72.js";
-const l = {
-  position: "absolute",
-  opacity: 0,
-  pointerEvents: "none",
-  width: 0,
-  height: 0
-};
-function T({
-  isOpen: o,
-  isModal: i,
-  containerRef: e,
-  returnFocusRef: d
-}) {
-  const c = a(null), r = a(null), u = a(null);
-  return m(() => {
-    if (i || !o) return;
-    const t = d?.current ?? I() ?? E() ?? document.activeElement;
-    if (!(!t || t === document.body) && t.tagName !== "IFRAME")
-      return c.current = t, u.current && (u.current.tabIndex = 0), () => {
-        u.current && (u.current.tabIndex = -1);
-      };
-  }, [o, i]), g(() => {
-    if (i || !o || !c.current) return;
-    const t = requestAnimationFrame(() => {
-      (f({
-        container: e.current
-      }) ?? e.current)?.focus(), r.current && (r.current.tabIndex = 0);
-    });
-    return () => {
-      cancelAnimationFrame(t), r.current && (r.current.tabIndex = -1);
-      const s = c.current;
-      c.current = null, s?.isConnected && requestAnimationFrame(() => s.focus());
-    };
-  }, [o, i]), {
-    startSentinelProps: {
-      ref: r,
-      tabIndex: -1,
-      style: l,
-      onFocus: (t) => {
-        if (e.current?.contains(t.relatedTarget) && t.relatedTarget !== e.current) {
-          const n = c.current;
-          n?.isConnected && n.focus();
-        } else
-          r.current && (r.current.tabIndex = -1), (f({
-            container: e.current
-          }) ?? e.current)?.focus();
-      }
-    },
-    endSentinelProps: {
-      ref: u,
-      tabIndex: -1,
-      style: l,
-      onFocus: (t) => {
-        if (e.current?.contains(t.relatedTarget) && t.relatedTarget !== e.current) {
-          const n = c.current;
-          n?.isConnected && n.focus();
-        } else
-          (F({
-            container: e.current
-          }) ?? e.current)?.focus();
-      }
-    }
-  };
-}
+const C = "data:image/svg+xml,%3csvg%20width='67'%20height='67'%20viewBox='0%200%2067%2067'%20fill='none'%20xmlns='http://www.w3.org/2000/svg'%3e%3cpath%20d='M19.166%204.53418C25.8215%201.28372%2033.4025%200.455651%2040.6025%202.19336C45.6308%203.40697%2050.254%205.81881%2054.0977%209.18262L56.2627%2011.0771V5.22852C56.2628%204.50782%2056.8467%203.92384%2057.5674%203.92383C58.288%203.92383%2058.872%204.50784%2058.8721%205.22852V14.8369C58.872%2015.5575%2058.288%2016.1416%2057.5674%2016.1416H47.874C47.1533%2016.1416%2046.5684%2015.5576%2046.5684%2014.8369C46.5684%2014.1161%2047.1533%2013.5322%2047.874%2013.5322H55.0752L52.4951%2011.249C48.9439%208.10762%2044.6571%205.85686%2039.9902%204.73047C33.3806%203.13527%2026.4212%203.89496%2020.3115%206.87891C14.2018%209.86288%209.32423%2014.8845%206.51855%2021.0781C3.71296%2027.2719%203.15512%2034.2508%204.94141%2040.8115C5.1304%2041.5068%204.72038%2042.2236%204.02539%2042.4131C3.32995%2042.6024%202.6123%2042.1923%202.42285%2041.4971C0.47701%2034.3503%201.08442%2026.748%204.14062%2020.001C7.19678%2013.2541%2012.5107%207.78477%2019.166%204.53418Z'%20stroke='black'%20stroke-width='2.61'/%3e%3cpath%20d='M62.2422%2023.8568C62.9375%2023.6675%2063.6544%2024.0777%2063.8438%2024.7728C65.7896%2031.9196%2065.1823%2039.522%2062.126%2046.2689C59.0697%2053.0158%2053.756%2058.4853%2047.1006%2061.7357C40.445%2064.9863%2032.8642%2065.8144%2025.6641%2064.0765C20.6357%2062.8629%2016.0126%2060.4512%2012.1689%2057.0873L10.0049%2055.1927V60.892C10.0048%2061.6124%209.42064%2062.1965%208.7002%2062.1967C7.97953%2062.1967%207.39465%2061.6126%207.39453%2060.892V51.433C7.39459%2050.7123%207.97949%2050.1283%208.7002%2050.1283H18.2441C18.9647%2050.1284%2019.5488%2050.7124%2019.5488%2051.433C19.5488%2052.1537%2018.9648%2052.7376%2018.2441%2052.7377H11.1914L13.7715%2055.0209C17.3228%2058.1623%2021.6095%2060.413%2026.2764%2061.5394C32.886%2063.1347%2039.8453%2062.3748%2045.9551%2059.391C52.0648%2056.407%2056.9434%2051.3855%2059.749%2045.1918C62.5546%2038.998%2063.1125%2032.0191%2061.3262%2025.4584C61.1488%2024.8064%2061.4978%2024.1351%2062.1152%2023.8978L62.2422%2023.8568Z'%20stroke='black'%20stroke-width='2.61'/%3e%3cpath%20d='M32.5%2020.4045C32.6936%2019.8812%2033.4332%2019.881%2033.627%2020.4045C35.7001%2026.0073%2040.1179%2030.425%2045.7207%2032.4983C46.2441%2032.6919%2046.2441%2033.4316%2045.7207%2033.6252C40.1179%2035.6985%2035.7001%2040.1162%2033.627%2045.719C33.4332%2046.2424%2032.6937%2046.2424%2032.5%2045.719C30.4267%2040.1162%2026.0091%2035.6985%2020.4062%2033.6252C19.8829%2033.4316%2019.8829%2032.6919%2020.4062%2032.4983C26.0091%2030.425%2030.4267%2026.0073%2032.5%2020.4045Z'%20stroke='black'%20stroke-width='3.48'/%3e%3c/svg%3e";
 export {
-  T as useFocusSentinel
+  C as default
 };
 //# sourceMappingURL=index84.js.map

package/dist/index84.js.map

@@ -1 +1 @@
-{"version":3,"file":"index84.js","sources":["../src/utils/a11y/useFocusSentinel.ts"],"sourcesContent":["import { useRef, useEffect, useLayoutEffect } from 'react';\n\nimport { getFirstFocusableElement, getLastFocusableElement } from './focusableElements';\nimport { consumeLastInteractedElement, consumeFocusAnchor } from './useFocusTrap';\n\nconst SENTINEL_STYLE: React.CSSProperties = {\n  position: 'absolute',\n  opacity: 0,\n  pointerEvents: 'none',\n  width: 0,\n  height: 0,\n};\n\nexport interface UseFocusSentinelOptions {\n  /** Whether the panel is currently open. */\n  isOpen: boolean | undefined;\n  /**\n   * When true the hook is a no-op — dialog mode (focus trap) handles focus management instead.\n   */\n  isModal: boolean;\n  /** Ref to the panel container element. */\n  containerRef: React.RefObject<HTMLElement | null>;\n  /**\n   * Explicit element to restore focus to on close.\n   * Overrides the automatic trigger capture.\n   */\n  returnFocusRef?: React.RefObject<HTMLElement | null>;\n}\n\nexport interface SentinelProps {\n  ref: React.RefObject<HTMLDivElement | null>;\n  tabIndex: number;\n  style: React.CSSProperties;\n  onFocus: (e: React.FocusEvent) => void;\n}\n\nexport interface UseFocusSentinelReturn {\n  /** Spread onto an invisible div placed before the panel content. */\n  startSentinelProps: SentinelProps;\n  /** Spread onto an invisible div placed after the panel content. */\n  endSentinelProps: SentinelProps;\n}\n\n/**\n * Focus management for complementary (non-modal) side panels.\n *\n * Moves focus into the panel on open, restores it to the trigger on close,\n * and wraps Tab / Shift+Tab back to the trigger when focus reaches either end.\n *\n * Sentinel tabIndex values are mutated imperatively (no state) to avoid\n * re-renders. React does not touch a DOM attribute unless the JSX prop value\n * changes, so the initial tabIndex={-1} in the returned props is safe.\n */\nexport function useFocusSentinel({\n  isOpen,\n  isModal,\n  containerRef,\n  returnFocusRef,\n}: UseFocusSentinelOptions): UseFocusSentinelReturn {\n  const triggerRef = useRef<HTMLElement | null>(null);\n  const startSentinelRef = useRef<HTMLDivElement>(null);\n  const endSentinelRef = useRef<HTMLDivElement>(null);\n\n  // Capture trigger before React commits (document.activeElement is still the opener).\n  // Body focus = page-load open → skip so sentinels stay inert.\n  useLayoutEffect(() => {\n    if (isModal || !isOpen) return;\n    const trigger =\n      returnFocusRef?.current ??\n      consumeFocusAnchor() ??\n      consumeLastInteractedElement() ??\n      (document.activeElement as HTMLElement);\n    if (!trigger || trigger === document.body) return;\n    // iframes manage their own internal focus. The parent doc only sees the\n    // <iframe> element. Calling .focus() on any parent-doc element while the\n    // user is inside an iframe forcibly blurs the iframe content (kills caret\n    // on textareas, cancels native <select> dropdowns). Skip capture so the\n    // auto-focus on open and focus-restore on close don't run.\n    if (trigger.tagName === 'IFRAME') return;\n    triggerRef.current = trigger;\n    if (endSentinelRef.current) endSentinelRef.current.tabIndex = 0;\n    return () => {\n      if (endSentinelRef.current) endSentinelRef.current.tabIndex = -1;\n    };\n  }, [isOpen, isModal]);\n\n  // Move focus into panel on open; restore to trigger on close.\n  useEffect(() => {\n    if (isModal || !isOpen || !triggerRef.current) return;\n\n    const rafId = requestAnimationFrame(() => {\n      const first = getFirstFocusableElement({ container: containerRef.current });\n      (first ?? containerRef.current)?.focus();\n      // Activate start sentinel so Shift+Tab from first content returns to trigger.\n      if (startSentinelRef.current) startSentinelRef.current.tabIndex = 0;\n    });\n\n    return () => {\n      cancelAnimationFrame(rafId);\n      if (startSentinelRef.current) startSentinelRef.current.tabIndex = -1;\n      const trigger = triggerRef.current;\n      triggerRef.current = null;\n      if (trigger?.isConnected) {\n        requestAnimationFrame(() => trigger.focus());\n      }\n    };\n  }, [isOpen, isModal]);\n\n  const handleStartFocus = (e: React.FocusEvent) => {\n    const fromInside =\n      containerRef.current?.contains(e.relatedTarget as Node) &&\n      e.relatedTarget !== containerRef.current;\n    if (fromInside) {\n      // Shift+Tab from first content → restore trigger\n      const trigger = triggerRef.current;\n      if (trigger?.isConnected) trigger.focus();\n    } else {\n      // Natural Tab entry from outside → forward to first content,\n      // deactivate so next Shift+Tab exits naturally.\n      if (startSentinelRef.current) startSentinelRef.current.tabIndex = -1;\n      const first = getFirstFocusableElement({ container: containerRef.current });\n      (first ?? containerRef.current)?.focus();\n    }\n  };\n\n  const handleEndFocus = (e: React.FocusEvent) => {\n    const fromInside =\n      containerRef.current?.contains(e.relatedTarget as Node) &&\n      e.relatedTarget !== containerRef.current;\n    if (fromInside) {\n      // Tab from last content → restore trigger\n      const trigger = triggerRef.current;\n      if (trigger?.isConnected) trigger.focus();\n    } else {\n      // Shift+Tab entry from outside → back to last content\n      const last = getLastFocusableElement({ container: containerRef.current });\n      (last ?? containerRef.current)?.focus();\n    }\n  };\n\n  return {\n    startSentinelProps: {\n      ref: startSentinelRef,\n      tabIndex: -1,\n      style: SENTINEL_STYLE,\n      onFocus: handleStartFocus,\n    },\n    endSentinelProps: {\n      ref: endSentinelRef,\n      tabIndex: -1,\n      style: SENTINEL_STYLE,\n      onFocus: handleEndFocus,\n    },\n  };\n}\n"],"names":["useRef","useLayoutEffect","useEffect","getFirstFocusableElement","getLastFocusableElement","consumeFocusAnchor","consumeLastInteractedElement","SENTINEL_STYLE","position","opacity","pointerEvents","width","height","useFocusSentinel","isOpen","isModal","containerRef","returnFocusRef","triggerRef","startSentinelRef","endSentinelRef","trigger","current","document","activeElement","body","tagName","tabIndex","rafId","requestAnimationFrame","container","focus","cancelAnimationFrame","isConnected","startSentinelProps","ref","style","onFocus","handleStartFocus","e","contains","relatedTarget","endSentinelProps","handleEndFocus"],"mappings":"AAKA,SAAA,UAAAA,GAAA,mBAAAC,GAAA,aAAAC,SAAA;AAAA,SAAA,4BAAAC,GAAA,2BAAAC,SAAA;AAAA,SAAA,sBAAAC,GAAA,gCAAAC,SAAA;AAAA,MAAMC,IAAsC;AAAA,EAC1CC,UAAU;AAAA,EACVC,SAAS;AAAA,EACTC,eAAe;AAAA,EACfC,OAAO;AAAA,EACPC,QAAQ;AACV;AA0CO,SAASC,EAAiB;AAAA,EAC/BC,QAAAA;AAAAA,EACAC,SAAAA;AAAAA,EACAC,cAAAA;AAAAA,EACAC,gBAAAA;AACuB,GAA2B;AAClD,QAAMC,IAAalB,EAA2B,IAAI,GAC5CmB,IAAmBnB,EAAuB,IAAI,GAC9CoB,IAAiBpB,EAAuB,IAAI;AAIlDC,SAAAA,EAAgB,MAAM;AACpB,QAAIc,KAAW,CAACD,EAAQ;AACxB,UAAMO,IACJJ,GAAgBK,WAChBjB,OACAC,EAAAA,KACCiB,SAASC;AACZ,QAAI,GAACH,KAAWA,MAAYE,SAASE,SAMjCJ,EAAQK,YAAY;AACxBR,aAAAA,EAAWI,UAAUD,GACjBD,EAAeE,YAASF,EAAeE,QAAQK,WAAW,IACvD,MAAM;AACX,QAAIP,EAAeE,YAASF,EAAeE,QAAQK,WAAW;AAAA,MAChE;AAAA,EACF,GAAG,CAACb,GAAQC,CAAO,CAAC,GAGpBb,EAAU,MAAM;AACd,QAAIa,KAAW,CAACD,KAAU,CAACI,EAAWI,QAAS;AAE/C,UAAMM,IAAQC,sBAAsB,MAAM;AAExC,OADc1B,EAAyB;AAAA,QAAE2B,WAAWd,EAAaM;AAAAA,MAAAA,CAAS,KAChEN,EAAaM,UAAUS,MAAAA,GAE7BZ,EAAiBG,YAASH,EAAiBG,QAAQK,WAAW;AAAA,IACpE,CAAC;AAED,WAAO,MAAM;AACXK,2BAAqBJ,CAAK,GACtBT,EAAiBG,YAASH,EAAiBG,QAAQK,WAAW;AAClE,YAAMN,IAAUH,EAAWI;AAC3BJ,MAAAA,EAAWI,UAAU,MACjBD,GAASY,eACXJ,sBAAsB,MAAMR,EAAQU,OAAO;AAAA,IAE/C;AAAA,EACF,GAAG,CAACjB,GAAQC,CAAO,CAAC,GAkCb;AAAA,IACLmB,oBAAoB;AAAA,MAClBC,KAAKhB;AAAAA,MACLQ,UAAU;AAAA,MACVS,OAAO7B;AAAAA,MACP8B,SArCqBC,CAACC,MAAwB;AAIhD,YAFEvB,EAAaM,SAASkB,SAASD,EAAEE,aAAqB,KACtDF,EAAEE,kBAAkBzB,EAAaM,SACnB;AAEd,gBAAMD,IAAUH,EAAWI;AAC3B,UAAID,GAASY,eAAaZ,EAAQU,MAAAA;AAAAA,QACpC;AAGE,UAAIZ,EAAiBG,YAASH,EAAiBG,QAAQK,WAAW,MACpDxB,EAAyB;AAAA,YAAE2B,WAAWd,EAAaM;AAAAA,UAAAA,CAAS,KAChEN,EAAaM,UAAUS,MAAAA;AAAAA,MAErC;AAAA,IAsBaO;AAAAA,IAEXI,kBAAkB;AAAA,MAChBP,KAAKf;AAAAA,MACLO,UAAU;AAAA,MACVS,OAAO7B;AAAAA,MACP8B,SA1BmBM,CAACJ,MAAwB;AAI9C,YAFEvB,EAAaM,SAASkB,SAASD,EAAEE,aAAqB,KACtDF,EAAEE,kBAAkBzB,EAAaM,SACnB;AAEd,gBAAMD,IAAUH,EAAWI;AAC3B,UAAID,GAASY,eAAaZ,EAAQU,MAAAA;AAAAA,QACpC;AAGE,WADa3B,EAAwB;AAAA,YAAE0B,WAAWd,EAAaM;AAAAA,UAAAA,CAAS,KAC/DN,EAAaM,UAAUS,MAAAA;AAAAA,MAEpC;AAAA,IAaaY;AAAAA,EACX;AAEJ;"}
+{"version":3,"file":"index84.js","sources":["../src/assets/icons/ai-re-run.svg?url"],"sourcesContent":["export default \"data:image/svg+xml,%3csvg%20width='67'%20height='67'%20viewBox='0%200%2067%2067'%20fill='none'%20xmlns='http://www.w3.org/2000/svg'%3e%3cpath%20d='M19.166%204.53418C25.8215%201.28372%2033.4025%200.455651%2040.6025%202.19336C45.6308%203.40697%2050.254%205.81881%2054.0977%209.18262L56.2627%2011.0771V5.22852C56.2628%204.50782%2056.8467%203.92384%2057.5674%203.92383C58.288%203.92383%2058.872%204.50784%2058.8721%205.22852V14.8369C58.872%2015.5575%2058.288%2016.1416%2057.5674%2016.1416H47.874C47.1533%2016.1416%2046.5684%2015.5576%2046.5684%2014.8369C46.5684%2014.1161%2047.1533%2013.5322%2047.874%2013.5322H55.0752L52.4951%2011.249C48.9439%208.10762%2044.6571%205.85686%2039.9902%204.73047C33.3806%203.13527%2026.4212%203.89496%2020.3115%206.87891C14.2018%209.86288%209.32423%2014.8845%206.51855%2021.0781C3.71296%2027.2719%203.15512%2034.2508%204.94141%2040.8115C5.1304%2041.5068%204.72038%2042.2236%204.02539%2042.4131C3.32995%2042.6024%202.6123%2042.1923%202.42285%2041.4971C0.47701%2034.3503%201.08442%2026.748%204.14062%2020.001C7.19678%2013.2541%2012.5107%207.78477%2019.166%204.53418Z'%20stroke='black'%20stroke-width='2.61'/%3e%3cpath%20d='M62.2422%2023.8568C62.9375%2023.6675%2063.6544%2024.0777%2063.8438%2024.7728C65.7896%2031.9196%2065.1823%2039.522%2062.126%2046.2689C59.0697%2053.0158%2053.756%2058.4853%2047.1006%2061.7357C40.445%2064.9863%2032.8642%2065.8144%2025.6641%2064.0765C20.6357%2062.8629%2016.0126%2060.4512%2012.1689%2057.0873L10.0049%2055.1927V60.892C10.0048%2061.6124%209.42064%2062.1965%208.7002%2062.1967C7.97953%2062.1967%207.39465%2061.6126%207.39453%2060.892V51.433C7.39459%2050.7123%207.97949%2050.1283%208.7002%2050.1283H18.2441C18.9647%2050.1284%2019.5488%2050.7124%2019.5488%2051.433C19.5488%2052.1537%2018.9648%2052.7376%2018.2441%2052.7377H11.1914L13.7715%2055.0209C17.3228%2058.1623%2021.6095%2060.413%2026.2764%2061.5394C32.886%2063.1347%2039.8453%2062.3748%2045.9551%2059.391C52.0648%2056.407%2056.9434%2051.3855%2059.749%2045.1918C62.5546%2038.998%2063.1125%2032.0191%2061.3262%2025.4584C61.1488%2024.8064%2061.4978%2024.1351%2062.1152%2023.8978L62.2422%2023.8568Z'%20stroke='black'%20stroke-width='2.61'/%3e%3cpath%20d='M32.5%2020.4045C32.6936%2019.8812%2033.4332%2019.881%2033.627%2020.4045C35.7001%2026.0073%2040.1179%2030.425%2045.7207%2032.4983C46.2441%2032.6919%2046.2441%2033.4316%2045.7207%2033.6252C40.1179%2035.6985%2035.7001%2040.1162%2033.627%2045.719C33.4332%2046.2424%2032.6937%2046.2424%2032.5%2045.719C30.4267%2040.1162%2026.0091%2035.6985%2020.4062%2033.6252C19.8829%2033.4316%2019.8829%2032.6919%2020.4062%2032.4983C26.0091%2030.425%2030.4267%2026.0073%2032.5%2020.4045Z'%20stroke='black'%20stroke-width='3.48'/%3e%3c/svg%3e\""],"names":["__vite_glob_0_1"],"mappings":"AAAA,MAAAA,IAAe;"}