se-design 1.0.79 → 1.0.81-dev1

package/dist/index72.js

@@ -1,105 +1,111 @@
-import { useRef as h, useLayoutEffect as a } from "react";
-import { getFirstFocusableElement as p, getFocusableElements as A } from "./index71.js";
+import { useRef as p, useLayoutEffect as a } from "react";
+import { getFirstFocusableElement as A, getFocusableElements as L } from "./index71.js";
 let f = null;
-function L(e) {
+function F(e) {
   const n = e.composedPath();
-  for (const c of n)
-    if (c instanceof HTMLElement && c.tabIndex >= 0) {
-      f = c;
+  for (const s of n)
+    if (s instanceof HTMLElement && s.tabIndex >= 0) {
+      f = s;
       return;
     }
 }
 function k(e) {
   (e.key === "Enter" || e.key === " ") && (f = document.activeElement);
 }
-typeof document < "u" && (document.addEventListener("pointerdown", L, !0), document.addEventListener("keydown", k, !0));
-function q() {
+typeof document < "u" && (document.addEventListener("pointerdown", F, !0), document.addEventListener("keydown", k, !0));
+function T() {
   const e = f;
   return f = null, e;
 }
-let i = null, l = null;
-function T(e) {
-  l !== null && cancelAnimationFrame(l), i = e, l = requestAnimationFrame(() => {
-    i = null, l = null;
+let m = null, l = null;
+function _(e) {
+  l !== null && cancelAnimationFrame(l), m = e, l = requestAnimationFrame(() => {
+    m = null, l = null;
   });
 }
-function w() {
+function I() {
   l !== null && (cancelAnimationFrame(l), l = null);
-  const e = i;
-  return i = null, e;
+  const e = m;
+  return m = null, e;
 }
-function F(e, n) {
-  return n === "none" ? null : n === "first" ? p({
+function w(e, n) {
+  return n === "none" ? null : n === "first" ? A({
     container: e
   }) || e : n === "container" ? e : typeof n == "string" ? e.querySelector(n) : n instanceof HTMLElement ? n : null;
 }
-function _({
+function C({
   enabled: e,
   containerRef: n,
-  restoreFocus: c = !0,
+  restoreFocus: s = !0,
   initialFocus: d = "first",
-  returnFocusRef: g
+  returnFocusRef: g,
+  portalContainerRefs: h
 }) {
-  const u = h(null), E = h(null);
+  const u = p(null), E = p(null);
   return a(() => {
     if (!e) {
-      if (c && u.current) {
-        const r = u.current;
+      if (s && u.current) {
+        const t = u.current;
         u.current = null, requestAnimationFrame(() => {
-          r.isConnected && r.focus();
+          t.isConnected && t.focus();
         });
       }
       return;
     }
-    const t = n.current;
-    if (t)
-      return u.current = g?.current ?? w() ?? f ?? document.activeElement, f = null, t.contains(document.activeElement) || requestAnimationFrame(() => {
-        F(t, d)?.focus();
-      }), () => {
-        if (c && u.current) {
-          const r = u.current;
-          u.current = null, requestAnimationFrame(() => {
-            r.isConnected && r.focus();
-          });
-        }
-      };
-  }, [e, n, c, d]), a(() => {
+    const r = n.current;
+    if (!r) return;
+    const c = g?.current ?? I() ?? f ?? document.activeElement;
+    if (f = null, c?.tagName === "IFRAME") {
+      u.current = null;
+      return;
+    }
+    return u.current = c, r.contains(document.activeElement) || requestAnimationFrame(() => {
+      w(r, d)?.focus();
+    }), () => {
+      if (s && u.current) {
+        const t = u.current;
+        u.current = null, requestAnimationFrame(() => {
+          t.isConnected && t.focus();
+        });
+      }
+    };
+  }, [e, n, s, d]), a(() => {
     if (!e) return;
-    const t = n.current;
-    if (!t) return;
-    const r = (o) => {
-      if (o.key === "Tab") {
-        const s = A({
-          container: t
+    const r = n.current;
+    if (!r) return;
+    const c = (t) => {
+      if (t.key === "Tab") {
+        const o = L({
+          container: r
         });
-        if (s.length === 0) {
-          o.preventDefault(), t.focus();
+        if (o.length === 0) {
+          t.preventDefault(), r.focus();
           return;
         }
-        const m = s[0], v = s[s.length - 1], y = document.activeElement;
-        o.shiftKey && y === m ? (o.preventDefault(), v.focus()) : !o.shiftKey && y === v && (o.preventDefault(), m.focus());
+        const i = o[0], v = o[o.length - 1], y = document.activeElement;
+        t.shiftKey && y === i ? (t.preventDefault(), v.focus()) : !t.shiftKey && y === v && (t.preventDefault(), i.focus());
       }
     };
-    return document.addEventListener("keydown", r, !0), () => document.removeEventListener("keydown", r, !0);
+    return document.addEventListener("keydown", c, !0), () => document.removeEventListener("keydown", c, !0);
   }, [e, n]), a(() => {
     if (!e) return;
-    const t = n.current;
-    if (!t) return;
-    const r = (o) => {
-      const s = o.target;
-      t.contains(s) ? E.current = s : (E.current || p({
-        container: t
-      }) || t).focus();
+    const r = n.current;
+    if (!r) return;
+    const c = (t) => {
+      const o = t.target;
+      o?.tagName !== "IFRAME" && (r.contains(o) ? E.current = o : h?.current?.some((i) => i.current?.contains(o)) || (E.current || A({
+        container: r
+      }) || r).focus());
     };
-    return document.addEventListener("focusin", r, !0), () => document.removeEventListener("focusin", r, !0);
+    return document.addEventListener("focusin", c, !0), () => document.removeEventListener("focusin", c, !0);
   }, [e, n]), {
     triggerRef: u
   };
 }
 export {
-  w as consumeFocusAnchor,
-  q as consumeLastInteractedElement,
-  T as setFocusAnchor,
-  _ as useFocusTrap
+  I as consumeFocusAnchor,
+  T as consumeLastInteractedElement,
+  _ as setFocusAnchor,
+  C as useFocusTrap
 };
 //# sourceMappingURL=index72.js.map

package/dist/index72.js.map

@@ -1 +1 @@
-{"version":3,"file":"index72.js","sources":["../src/utils/a11y/useFocusTrap.ts"],"sourcesContent":["import { useLayoutEffect, useRef } from 'react';\nimport { getFocusableElements, getFirstFocusableElement } from './focusableElements';\n\nexport interface UseFocusTrapOptions<T extends HTMLElement = HTMLElement> {\n  /**\n   * Whether the focus trap is active.\n   */\n  enabled: boolean;\n  /**\n   * Container element ref to trap focus within.\n   */\n  containerRef: React.RefObject<T | null>;\n  /**\n   * Whether to restore focus to the element that had focus before trap activated.\n   * Default: true\n   */\n  restoreFocus?: boolean;\n  /**\n   * Initial focus target when trap activates.\n   * - 'first': Focus first focusable element (default)\n   * - 'container': Focus the container itself\n   * - 'none': Skip initial focus — browser handles it (e.g. autofocus attribute)\n   * - CSS selector: Focus element matching selector\n   * - HTMLElement: Focus this specific element\n   */\n  initialFocus?: 'first' | 'container' | 'none' | string | HTMLElement;\n  /**\n   * Explicit element to restore focus to when the trap deactivates.\n   * Overrides the automatic trigger capture (_lastInteractedElement / document.activeElement).\n   * Use when the opener is known at call-site (e.g. a ref on the toggle button).\n   */\n  returnFocusRef?: React.RefObject<HTMLElement | null>;\n}\n\nexport interface UseFocusTrapReturn {\n  /**\n   * Ref to the element that had focus before trap activated.\n   * Useful for manual focus restoration if needed.\n   */\n  triggerRef: React.MutableRefObject<HTMLElement | null>;\n}\n\n// Module-level trigger tracking: React's commit phase is bottom-up, so by the\n// time useFocusTrap's useLayoutEffect runs, document.activeElement may already\n// be the autoFocus element inside the modal rather than the opener button.\n// We capture the last interacted element via pointerdown/keydown listeners\n// (which fire before any React state update commits) to work around this.\nlet _lastInteractedElement: HTMLElement | null = null;\n\nfunction _onPointerDown(e: PointerEvent): void {\n  // Walk composedPath to find the nearest focusable element being pressed.\n  const path = e.composedPath();\n  for (const node of path) {\n    if (node instanceof HTMLElement && node.tabIndex >= 0) {\n      _lastInteractedElement = node;\n      return;\n    }\n  }\n}\n\nfunction _onKeyDown(e: KeyboardEvent): void {\n  // Enter/Space on a focused button will synthesise a click — capture before that.\n  if (e.key === 'Enter' || e.key === ' ') {\n    _lastInteractedElement = document.activeElement as HTMLElement;\n  }\n}\n\nif (typeof document !== 'undefined') {\n  document.addEventListener('pointerdown', _onPointerDown, true);\n  document.addEventListener('keydown', _onKeyDown, true);\n}\n\n/**\n * Returns (and clears) the last element interacted with before a React commit.\n * Used by SidebarOverlay complementary mode to seed its trigger ref without\n * relying on document.activeElement timing.\n */\nexport function consumeLastInteractedElement(): HTMLElement | null {\n  const el = _lastInteractedElement;\n  _lastInteractedElement = null;\n  return el;\n}\n\n// Focus anchor — explicit stable return-focus target, higher priority than\n// _lastInteractedElement. Auto-clears via setTimeout(0) to prevent a stale\n// anchor leaking to an unrelated open.\nlet _focusAnchor: HTMLElement | null = null;\nlet _focusAnchorClearFrame: ReturnType<typeof requestAnimationFrame> | null = null;\n\n/**\n * Sets an explicit focus-return anchor element.\n * Call this before dispatching an action that will open a modal or sidebar,\n * when the natural last-interacted element is not the right return target\n * (e.g. a popover menu item that will be unmounted when the popover closes).\n */\nexport function setFocusAnchor(el: HTMLElement | null): void {\n  if (_focusAnchorClearFrame !== null) cancelAnimationFrame(_focusAnchorClearFrame);\n  _focusAnchor = el;\n  // Auto-clear if not consumed — prevents stale anchor leaking to unrelated opens.\n  // rAF fires after React has committed and painted, giving useFocusTrap time to\n  // consume the anchor before it is discarded.\n  _focusAnchorClearFrame = requestAnimationFrame(() => {\n    _focusAnchor = null;\n    _focusAnchorClearFrame = null;\n  });\n}\n\n/**\n * Returns (and clears) the focus anchor if one was set, otherwise null.\n * Used internally by useFocusTrap and SidebarOverlay.\n */\nexport function consumeFocusAnchor(): HTMLElement | null {\n  if (_focusAnchorClearFrame !== null) {\n    cancelAnimationFrame(_focusAnchorClearFrame);\n    _focusAnchorClearFrame = null;\n  }\n  const el = _focusAnchor;\n  _focusAnchor = null;\n  return el;\n}\n\n/**\n * Resolve the initial focus target based on the initialFocus option.\n */\nfunction resolveInitialFocusTarget(\n  container: HTMLElement,\n  initialFocus: 'first' | 'container' | 'none' | string | HTMLElement\n): HTMLElement | null {\n  if (initialFocus === 'none') return null;\n  if (initialFocus === 'first') {\n    return getFirstFocusableElement({ container }) || container;\n  }\n  if (initialFocus === 'container') {\n    return container;\n  }\n  if (typeof initialFocus === 'string') {\n    return container.querySelector<HTMLElement>(initialFocus);\n  }\n  if (initialFocus instanceof HTMLElement) {\n    return initialFocus;\n  }\n  return null;\n}\n\n/**\n * Hook to trap focus within a container (for modals, dialogs, drawers).\n *\n * Implements WCAG 2.1 focus trap pattern:\n * - Moves focus into container on activation\n * - Wraps Tab/Shift+Tab navigation within container\n * - Restores focus to trigger element on deactivation\n * - Safety net: catches focus escaping via other means\n * - Handles autoFocus content: captures trigger before autoFocus fires\n * - Handles {isOpen && <Modal>} pattern: restores focus on unmount\n *\n * Note: For Escape key handling, use `useDismissOnEscape` hook separately.\n * This keeps focus trap (accessibility) separate from Escape handling (UX).\n *\n * @example\n * ```tsx\n * const MyModal = ({ isOpen, onClose }) => {\n *   const containerRef = useRef<HTMLDivElement>(null);\n *\n *   // Escape handling (UX)\n *   useDismissOnEscape({\n *     containerRef,\n *     onDismiss: onClose,\n *     enabled: isOpen\n *   });\n *\n *   // Focus trap (accessibility)\n *   const { triggerRef } = useFocusTrap({\n *     enabled: isOpen,\n *     containerRef,\n *     restoreFocus: true\n *   });\n *\n *   return (\n *     <div ref={containerRef}>\n *       <button>First</button>\n *       <button>Second</button>\n *     </div>\n *   );\n * };\n * ```\n */\nexport function useFocusTrap<T extends HTMLElement = HTMLElement>({\n  enabled,\n  containerRef,\n  restoreFocus = true,\n  initialFocus = 'first',\n  returnFocusRef,\n}: UseFocusTrapOptions<T>): UseFocusTrapReturn {\n  const triggerRef = useRef<HTMLElement | null>(null);\n  const lastFocusedInContainer = useRef<HTMLElement | null>(null);\n\n  // Focus management: save trigger, move focus into container on activate, restore on deactivate\n  useLayoutEffect(() => {\n    if (!enabled) {\n      // Restore focus to trigger when trap deactivates\n      if (restoreFocus && triggerRef.current) {\n        const el = triggerRef.current;\n        triggerRef.current = null;\n        requestAnimationFrame(() => {\n          if (el.isConnected) el.focus();\n        });\n      }\n      return;\n    }\n\n    const container = containerRef.current;\n    if (!container) return;\n\n    // Resolve trigger: explicit returnFocusRef wins, then focusAnchor (explicitly set\n    // by caller for two-step flows like popover menu → modal), then the pre-commit\n    // interaction record, then document.activeElement as final fallback.\n    triggerRef.current = returnFocusRef?.current ?? consumeFocusAnchor() ?? _lastInteractedElement ?? (document.activeElement as HTMLElement);\n    _lastInteractedElement = null;\n\n    // Only move initial focus if autoFocus hasn't already placed it inside the container.\n    if (!container.contains(document.activeElement)) {\n      requestAnimationFrame(() => {\n        resolveInitialFocusTarget(container, initialFocus)?.focus();\n      });\n    }\n\n    // Restore focus on unmount while enabled (covers {isOpen && <Modal>} pattern\n    // where the component unmounts before enabled can transition true → false)\n    return () => {\n      if (restoreFocus && triggerRef.current) {\n        const el = triggerRef.current;\n        triggerRef.current = null;\n        requestAnimationFrame(() => {\n          if (el.isConnected) el.focus();\n        });\n      }\n    };\n  }, [enabled, containerRef, restoreFocus, initialFocus]);\n\n  // Focus trap: Tab wrapping (only when enabled)\n  useLayoutEffect(() => {\n    if (!enabled) return;\n\n    const container = containerRef.current;\n    if (!container) return;\n\n    const handleKeyDown = (e: KeyboardEvent) => {\n      // Tab wrapping\n      if (e.key === 'Tab') {\n        const focusables = getFocusableElements({ container });\n\n        if (focusables.length === 0) {\n          e.preventDefault();\n          container.focus();\n          return;\n        }\n\n        const first = focusables[0];\n        const last = focusables[focusables.length - 1];\n        const activeElement = document.activeElement;\n\n        if (e.shiftKey && activeElement === first) {\n          e.preventDefault();\n          last.focus();\n        } else if (!e.shiftKey && activeElement === last) {\n          e.preventDefault();\n          first.focus();\n        }\n      }\n    };\n\n    document.addEventListener('keydown', handleKeyDown, true);\n    return () => document.removeEventListener('keydown', handleKeyDown, true);\n  }, [enabled, containerRef]);\n\n  // Focus trap safety net: catch focus escaping\n  useLayoutEffect(() => {\n    if (!enabled) return;\n\n    const container = containerRef.current;\n    if (!container) return;\n\n    const handleFocusIn = (e: FocusEvent) => {\n      const target = e.target as Node;\n\n      if (container.contains(target)) {\n        lastFocusedInContainer.current = target as HTMLElement;\n      } else {\n        // Focus escaped - redirect back\n        const fallback = lastFocusedInContainer.current\n          || getFirstFocusableElement({ container })\n          || container;\n        fallback.focus();\n      }\n    };\n\n    document.addEventListener('focusin', handleFocusIn, true);\n    return () => document.removeEventListener('focusin', handleFocusIn, true);\n  }, [enabled, containerRef]);\n\n  return { triggerRef };\n}\n"],"names":["_lastInteractedElement","_onPointerDown","e","path","composedPath","node","HTMLElement","tabIndex","_onKeyDown","key","document","activeElement","addEventListener","consumeLastInteractedElement","el","_focusAnchor","_focusAnchorClearFrame","setFocusAnchor","cancelAnimationFrame","requestAnimationFrame","consumeFocusAnchor","resolveInitialFocusTarget","container","initialFocus","getFirstFocusableElement","querySelector","useFocusTrap","enabled","containerRef","restoreFocus","returnFocusRef","triggerRef","useRef","lastFocusedInContainer","useLayoutEffect","current","isConnected","focus","contains","handleKeyDown","focusables","getFocusableElements","length","preventDefault","first","last","shiftKey","removeEventListener","handleFocusIn","target"],"mappings":"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"}
+{"version":3,"file":"index72.js","sources":["../src/utils/a11y/useFocusTrap.ts"],"sourcesContent":["import { useLayoutEffect, useRef } from 'react';\nimport type { MutableRefObject, RefObject } from 'react';\nimport { getFocusableElements, getFirstFocusableElement } from './focusableElements';\n\nexport interface UseFocusTrapOptions<T extends HTMLElement = HTMLElement> {\n  /**\n   * Whether the focus trap is active.\n   */\n  enabled: boolean;\n  /**\n   * Container element ref to trap focus within.\n   */\n  containerRef: React.RefObject<T | null>;\n  /**\n   * Whether to restore focus to the element that had focus before trap activated.\n   * Default: true\n   */\n  restoreFocus?: boolean;\n  /**\n   * Initial focus target when trap activates.\n   * - 'first': Focus first focusable element (default)\n   * - 'container': Focus the container itself\n   * - 'none': Skip initial focus — browser handles it (e.g. autofocus attribute)\n   * - CSS selector: Focus element matching selector\n   * - HTMLElement: Focus this specific element\n   */\n  initialFocus?: 'first' | 'container' | 'none' | string | HTMLElement;\n  /**\n   * Explicit element to restore focus to when the trap deactivates.\n   * Overrides the automatic trigger capture (_lastInteractedElement / document.activeElement).\n   * Use when the opener is known at call-site (e.g. a ref on the toggle button).\n   */\n  returnFocusRef?: React.RefObject<HTMLElement | null>;\n  /**\n   * Additional container refs that are logically part of this focus trap\n   * (e.g., portal-rendered content from Popover/Dropdown). Focus moving to\n   * these containers will NOT trigger the safety net redirect.\n   */\n  portalContainerRefs?: MutableRefObject<RefObject<HTMLElement | null>[]>;\n}\n\nexport interface UseFocusTrapReturn {\n  /**\n   * Ref to the element that had focus before trap activated.\n   * Useful for manual focus restoration if needed.\n   */\n  triggerRef: React.MutableRefObject<HTMLElement | null>;\n}\n\n// Module-level trigger tracking: React's commit phase is bottom-up, so by the\n// time useFocusTrap's useLayoutEffect runs, document.activeElement may already\n// be the autoFocus element inside the modal rather than the opener button.\n// We capture the last interacted element via pointerdown/keydown listeners\n// (which fire before any React state update commits) to work around this.\nlet _lastInteractedElement: HTMLElement | null = null;\n\nfunction _onPointerDown(e: PointerEvent): void {\n  // Walk composedPath to find the nearest focusable element being pressed.\n  const path = e.composedPath();\n  for (const node of path) {\n    if (node instanceof HTMLElement && node.tabIndex >= 0) {\n      _lastInteractedElement = node;\n      return;\n    }\n  }\n}\n\nfunction _onKeyDown(e: KeyboardEvent): void {\n  // Enter/Space on a focused button will synthesise a click — capture before that.\n  if (e.key === 'Enter' || e.key === ' ') {\n    _lastInteractedElement = document.activeElement as HTMLElement;\n  }\n}\n\nif (typeof document !== 'undefined') {\n  document.addEventListener('pointerdown', _onPointerDown, true);\n  document.addEventListener('keydown', _onKeyDown, true);\n}\n\n/**\n * Returns (and clears) the last element interacted with before a React commit.\n * Used by SidebarOverlay complementary mode to seed its trigger ref without\n * relying on document.activeElement timing.\n */\nexport function consumeLastInteractedElement(): HTMLElement | null {\n  const el = _lastInteractedElement;\n  _lastInteractedElement = null;\n  return el;\n}\n\n// Focus anchor — explicit stable return-focus target, higher priority than\n// _lastInteractedElement. Auto-clears via setTimeout(0) to prevent a stale\n// anchor leaking to an unrelated open.\nlet _focusAnchor: HTMLElement | null = null;\nlet _focusAnchorClearFrame: ReturnType<typeof requestAnimationFrame> | null = null;\n\n/**\n * Sets an explicit focus-return anchor element.\n * Call this before dispatching an action that will open a modal or sidebar,\n * when the natural last-interacted element is not the right return target\n * (e.g. a popover menu item that will be unmounted when the popover closes).\n */\nexport function setFocusAnchor(el: HTMLElement | null): void {\n  if (_focusAnchorClearFrame !== null) cancelAnimationFrame(_focusAnchorClearFrame);\n  _focusAnchor = el;\n  // Auto-clear if not consumed — prevents stale anchor leaking to unrelated opens.\n  // rAF fires after React has committed and painted, giving useFocusTrap time to\n  // consume the anchor before it is discarded.\n  _focusAnchorClearFrame = requestAnimationFrame(() => {\n    _focusAnchor = null;\n    _focusAnchorClearFrame = null;\n  });\n}\n\n/**\n * Returns (and clears) the focus anchor if one was set, otherwise null.\n * Used internally by useFocusTrap and SidebarOverlay.\n */\nexport function consumeFocusAnchor(): HTMLElement | null {\n  if (_focusAnchorClearFrame !== null) {\n    cancelAnimationFrame(_focusAnchorClearFrame);\n    _focusAnchorClearFrame = null;\n  }\n  const el = _focusAnchor;\n  _focusAnchor = null;\n  return el;\n}\n\n/**\n * Resolve the initial focus target based on the initialFocus option.\n */\nfunction resolveInitialFocusTarget(\n  container: HTMLElement,\n  initialFocus: 'first' | 'container' | 'none' | string | HTMLElement\n): HTMLElement | null {\n  if (initialFocus === 'none') return null;\n  if (initialFocus === 'first') {\n    return getFirstFocusableElement({ container }) || container;\n  }\n  if (initialFocus === 'container') {\n    return container;\n  }\n  if (typeof initialFocus === 'string') {\n    return container.querySelector<HTMLElement>(initialFocus);\n  }\n  if (initialFocus instanceof HTMLElement) {\n    return initialFocus;\n  }\n  return null;\n}\n\n/**\n * Hook to trap focus within a container (for modals, dialogs, drawers).\n *\n * Implements WCAG 2.1 focus trap pattern:\n * - Moves focus into container on activation\n * - Wraps Tab/Shift+Tab navigation within container\n * - Restores focus to trigger element on deactivation\n * - Safety net: catches focus escaping via other means\n * - Handles autoFocus content: captures trigger before autoFocus fires\n * - Handles {isOpen && <Modal>} pattern: restores focus on unmount\n *\n * Note: For Escape key handling, use `useDismissOnEscape` hook separately.\n * This keeps focus trap (accessibility) separate from Escape handling (UX).\n *\n * @example\n * ```tsx\n * const MyModal = ({ isOpen, onClose }) => {\n *   const containerRef = useRef<HTMLDivElement>(null);\n *\n *   // Escape handling (UX)\n *   useDismissOnEscape({\n *     containerRef,\n *     onDismiss: onClose,\n *     enabled: isOpen\n *   });\n *\n *   // Focus trap (accessibility)\n *   const { triggerRef } = useFocusTrap({\n *     enabled: isOpen,\n *     containerRef,\n *     restoreFocus: true\n *   });\n *\n *   return (\n *     <div ref={containerRef}>\n *       <button>First</button>\n *       <button>Second</button>\n *     </div>\n *   );\n * };\n * ```\n */\nexport function useFocusTrap<T extends HTMLElement = HTMLElement>({\n  enabled,\n  containerRef,\n  restoreFocus = true,\n  initialFocus = 'first',\n  returnFocusRef,\n  portalContainerRefs,\n}: UseFocusTrapOptions<T>): UseFocusTrapReturn {\n  const triggerRef = useRef<HTMLElement | null>(null);\n  const lastFocusedInContainer = useRef<HTMLElement | null>(null);\n\n  // Focus management: save trigger, move focus into container on activate, restore on deactivate\n  useLayoutEffect(() => {\n    if (!enabled) {\n      // Restore focus to trigger when trap deactivates\n      if (restoreFocus && triggerRef.current) {\n        const el = triggerRef.current;\n        triggerRef.current = null;\n        requestAnimationFrame(() => {\n          if (el.isConnected) el.focus();\n        });\n      }\n      return;\n    }\n\n    const container = containerRef.current;\n    if (!container) return;\n\n    // Resolve trigger: explicit returnFocusRef wins, then focusAnchor (explicitly set\n    // by caller for two-step flows like popover menu → modal), then the pre-commit\n    // interaction record, then document.activeElement as final fallback.\n    const previousActiveElement = returnFocusRef?.current ?? consumeFocusAnchor() ?? _lastInteractedElement ?? (document.activeElement as HTMLElement);\n    _lastInteractedElement = null;\n\n    // iframes manage their own internal focus. document.activeElement only ever\n    // resolves to the <iframe> element from the parent doc — calling .focus()\n    // on any parent-doc element forcibly blurs the iframe content (kills caret\n    // in textareas, cancels native <select> dropdowns). Skip capture so the\n    // auto-focus on open and focus-restore on close short-circuit on null trigger.\n    if (previousActiveElement?.tagName === 'IFRAME') {\n      triggerRef.current = null;\n      return;\n    }\n\n    triggerRef.current = previousActiveElement;\n\n    // Only move initial focus if autoFocus hasn't already placed it inside the container.\n    if (!container.contains(document.activeElement)) {\n      requestAnimationFrame(() => {\n        resolveInitialFocusTarget(container, initialFocus)?.focus();\n      });\n    }\n\n    // Restore focus on unmount while enabled (covers {isOpen && <Modal>} pattern\n    // where the component unmounts before enabled can transition true → false)\n    return () => {\n      if (restoreFocus && triggerRef.current) {\n        const el = triggerRef.current;\n        triggerRef.current = null;\n        requestAnimationFrame(() => {\n          if (el.isConnected) el.focus();\n        });\n      }\n    };\n  }, [enabled, containerRef, restoreFocus, initialFocus]);\n\n  // Focus trap: Tab wrapping (only when enabled)\n  useLayoutEffect(() => {\n    if (!enabled) return;\n\n    const container = containerRef.current;\n    if (!container) return;\n\n    const handleKeyDown = (e: KeyboardEvent) => {\n      // Tab wrapping\n      if (e.key === 'Tab') {\n        const focusables = getFocusableElements({ container });\n\n        if (focusables.length === 0) {\n          e.preventDefault();\n          container.focus();\n          return;\n        }\n\n        const first = focusables[0];\n        const last = focusables[focusables.length - 1];\n        const activeElement = document.activeElement;\n\n        if (e.shiftKey && activeElement === first) {\n          e.preventDefault();\n          last.focus();\n        } else if (!e.shiftKey && activeElement === last) {\n          e.preventDefault();\n          first.focus();\n        }\n      }\n    };\n\n    document.addEventListener('keydown', handleKeyDown, true);\n    return () => document.removeEventListener('keydown', handleKeyDown, true);\n  }, [enabled, containerRef]);\n\n  // Focus trap safety net: catch focus escaping\n  useLayoutEffect(() => {\n    if (!enabled) return;\n\n    const container = containerRef.current;\n    if (!container) return;\n\n    const handleFocusIn = (e: FocusEvent) => {\n      const target = e.target as Node;\n\n      // iframe focus is opaque from the parent doc — leave it alone, otherwise\n      // a click into the iframe gets yanked back into the trap.\n      if ((target as Element | null)?.tagName === 'IFRAME') return;\n\n      if (container.contains(target)) {\n        lastFocusedInContainer.current = target as HTMLElement;\n      } else if (portalContainerRefs?.current?.some(ref => ref.current?.contains(target))) {\n        // Focus is in a registered portal — allow it, but don't update\n        // lastFocusedInContainer so safety net restores to the last main-container\n        // element (e.g., the dropdown trigger) when the portal unmounts\n      } else {\n        // Focus escaped — redirect back\n        const fallback = lastFocusedInContainer.current\n          || getFirstFocusableElement({ container })\n          || container;\n        fallback.focus();\n      }\n    };\n\n    document.addEventListener('focusin', handleFocusIn, true);\n    return () => document.removeEventListener('focusin', handleFocusIn, true);\n  }, [enabled, containerRef]);\n\n  return { triggerRef };\n}\n"],"names":["_lastInteractedElement","_onPointerDown","e","path","composedPath","node","HTMLElement","tabIndex","_onKeyDown","key","document","activeElement","addEventListener","consumeLastInteractedElement","el","_focusAnchor","_focusAnchorClearFrame","setFocusAnchor","cancelAnimationFrame","requestAnimationFrame","consumeFocusAnchor","resolveInitialFocusTarget","container","initialFocus","getFirstFocusableElement","querySelector","useFocusTrap","enabled","containerRef","restoreFocus","returnFocusRef","portalContainerRefs","triggerRef","useRef","lastFocusedInContainer","useLayoutEffect","current","isConnected","focus","previousActiveElement","tagName","contains","handleKeyDown","focusables","getFocusableElements","length","preventDefault","first","last","shiftKey","removeEventListener","handleFocusIn","target","some","ref"],"mappings":"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"}

package/dist/index76.js

@@ -1,53 +1,56 @@
-import { useState as m, useEffect as w, useCallback as b } from "react";
-import { useScrollActiveIntoView as x } from "./index240.js";
+import { useState as v, useEffect as w, useCallback as h } from "react";
+import { useScrollActiveIntoView as x } from "./index80.js";
 function E({
   items: u,
   isOpen: t,
   onSelect: o,
-  onClose: c,
-  onOpen: l,
-  loop: i = !0,
-  disabled: h = !1,
+  onClose: i,
+  onOpen: n,
+  loop: l = !0,
+  disabled: b = !1,
   listboxRef: k,
-  optionSelector: g = '[role="option"]'
+  optionSelector: D = '[role="option"]'
 }) {
-  const [f, a] = m(-1);
+  const [e, r] = v(-1);
   w(() => {
-    t || a(-1);
+    t || r(-1);
   }, [t]), x({
     containerRef: k,
-    activeIndex: f,
-    itemSelector: g,
+    activeIndex: e,
+    itemSelector: D,
     enabled: t
   });
-  const D = b((r) => {
-    if (h) {
-      r.key === "Escape" && t && (r.preventDefault(), c());
+  const g = h((a) => {
+    if (b) {
+      a.key === "Escape" && t && (a.preventDefault(), i());
       return;
     }
-    const e = u.length;
-    switch (r.key) {
+    const f = u.length;
+    switch (a.key) {
       case "ArrowDown":
-        r.preventDefault(), !t && e > 0 ? (l?.(), a(0)) : t && e > 0 && a((n) => i ? (n + 1) % e : Math.min(n + 1, e - 1));
+        a.preventDefault(), !t && f > 0 ? (n?.(), r(0)) : t && f > 0 && r((c) => l ? (c + 1) % f : Math.min(c + 1, f - 1));
         break;
       case "ArrowUp":
-        r.preventDefault(), t && e > 0 && a((n) => n === -1 ? e - 1 : i ? (n - 1 + e) % e : Math.max(n - 1, 0));
+        a.preventDefault(), t && f > 0 && r((c) => c === -1 ? f - 1 : l ? (c - 1 + f) % f : Math.max(c - 1, 0));
         break;
       case "Enter":
-        t && f >= 0 && u[f] && (r.preventDefault(), o(u[f], f), a(-1));
+        a.preventDefault(), t ? e >= 0 && u[e] && (o(u[e], e), r(-1)) : (n?.(), r(0));
+        break;
+      case " ":
+        a.preventDefault(), t ? e >= 0 && u[e] && (o(u[e], e), r(-1)) : (n?.(), r(0));
         break;
       case "Escape":
-        t && (r.preventDefault(), c(), a(-1));
+        t && (a.preventDefault(), i(), r(-1));
         break;
       case "Tab":
-        t && (c(), a(-1));
+        t && (i(), r(-1));
         break;
     }
-  }, [h, u, t, f, o, c, l, i]), d = b((r, e) => `${r}-option-${e}`, []);
+  }, [b, u, t, e, o, i, n, l]), d = h((a, f) => `${a}-option-${f}`, []);
   return {
-    highlightedIndex: f,
-    setHighlightedIndex: a,
-    handleKeyDown: D,
+    highlightedIndex: e,
+    setHighlightedIndex: r,
+    handleKeyDown: g,
     getOptionId: d
   };
 }

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          if (isOpen && highlightedIndex >= 0 && items[highlightedIndex]) {\n            e.preventDefault();\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;AACH,QAAIpB,KAAUQ,KAAoB,KAAKT,EAAMS,CAAgB,MAC3DO,EAAEE,eAAAA,GACFhB,EAASF,EAAMS,CAAgB,GAAGA,CAAgB,GAClDC,EAAoB,EAAE;AAExB;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/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 ' ':\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;AACHM,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;"}

package/dist/{index208.js → index79.js}

@@ -23,4 +23,4 @@ function p({
 export {
   p as useDismissOnEscape
 };
-//# sourceMappingURL=index208.js.map
+//# sourceMappingURL=index79.js.map

package/dist/index79.js.map

@@ -0,0 +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;"}

package/dist/index80.js

@@ -1,5 +1,22 @@
-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";
+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
+}) {
+  s(() => {
+    if (!c || o < 0 || !t?.current)
+      return;
+    const n = t.current.querySelectorAll(r)[o];
+    n && n.scrollIntoView(e);
+  }, [o, t, r, c, e]);
+}
 export {
-  L as default
+  m as useScrollActiveIntoView
 };
 //# sourceMappingURL=index80.js.map

package/dist/index80.js.map

@@ -1 +1 @@
-{"version":3,"file":"index80.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;"}
+{"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;"}

package/dist/index81.js

@@ -1,5 +1,12 @@
-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";
+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;
+}
 export {
-  C as default
+  n as isElementVisible
 };
 //# sourceMappingURL=index81.js.map

package/dist/index81.js.map

@@ -1 +1 @@
-{"version":3,"file":"index81.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;"}
+{"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;"}

package/dist/index82.js

@@ -1,5 +1,45 @@
-const e = "data:image/svg+xml,%3csvg%20width='21'%20height='20'%20viewBox='0%200%2021%2020'%20fill='none'%20xmlns='http://www.w3.org/2000/svg'%3e%3cg%20opacity='0.8'%3e%3cg%20clip-path='url(%23clip0_11623_94780)'%3e%3cpath%20d='M8.93929%2014.7575C12.1504%2014.7575%2014.7536%2012.1543%2014.7536%208.94319C14.7536%205.73205%2012.1504%203.12891%208.93929%203.12891C5.72814%203.12891%203.125%205.73205%203.125%208.94319C3.125%2012.1543%205.72814%2014.7575%208.93929%2014.7575Z'%20stroke='%23D8E8F6'%20stroke-width='1.2'%20stroke-linecap='round'%20stroke-linejoin='round'/%3e%3cpath%20d='M16.8642%2016.872L13.0469%2013.0547'%20stroke='%23D8E8F6'%20stroke-width='1.2'%20stroke-linecap='round'%20stroke-linejoin='round'/%3e%3cpath%20d='M12.4688%201.47559C13.0214%202.58108%2013.918%203.47752%2015.0234%204.03027L15.9619%204.5L15.0234%204.96973C13.918%205.52248%2013.0214%206.41892%2012.4688%207.52441L12%208.46191L11.5313%207.52441C10.9786%206.41892%2010.082%205.52248%208.97656%204.96973L8.03711%204.5L8.97656%204.03027C10.082%203.47752%2010.9786%202.58108%2011.5313%201.47559L12%200.538086L12.4688%201.47559Z'%20fill='white'%20stroke='%233E8BD1'%20stroke-width='1.375'/%3e%3c/g%3e%3c/g%3e%3cdefs%3e%3cclipPath%20id='clip0_11623_94780'%3e%3crect%20width='16'%20height='18'%20fill='white'%20transform='translate(2)'/%3e%3c/clipPath%3e%3c/defs%3e%3c/svg%3e";
+import { useRef as d } from "react";
+import { useFocusTrap as u } from "./index72.js";
+import { useDismissOnEscape as c } from "./index79.js";
+import { getA11yNameAttributes as f } from "./index78.js";
+import { useStableId as p } from "./index83.js";
+function x({
+  isOpen: e,
+  onDismiss: s,
+  ariaLabel: o,
+  ariaLabelledBy: a,
+  titleIdPrefix: i = "modal-title",
+  initialFocus: m = "first",
+  portalContainerRefs: n
+}) {
+  const t = d(null), r = p(void 0, i);
+  u({
+    enabled: e,
+    containerRef: t,
+    restoreFocus: !0,
+    initialFocus: m,
+    portalContainerRefs: n
+  }), c({
+    containerRef: t,
+    onDismiss: s,
+    enabled: e
+  });
+  const l = {
+    role: "dialog",
+    "aria-modal": !0,
+    tabIndex: -1,
+    ...f({
+      ariaLabelledBy: a ?? (o ? void 0 : r),
+      ariaLabel: o
+    })
+  };
+  return {
+    containerRef: t,
+    titleId: r,
+    dialogProps: l
+  };
+}
 export {
-  e as default
+  x as useModalA11y
 };
 //# sourceMappingURL=index82.js.map

package/dist/index82.js.map

@@ -1 +1 @@
-{"version":3,"file":"index82.js","sources":["../src/assets/icons/ai-search.svg?url"],"sourcesContent":["export default \"data:image/svg+xml,%3csvg%20width='21'%20height='20'%20viewBox='0%200%2021%2020'%20fill='none'%20xmlns='http://www.w3.org/2000/svg'%3e%3cg%20opacity='0.8'%3e%3cg%20clip-path='url(%23clip0_11623_94780)'%3e%3cpath%20d='M8.93929%2014.7575C12.1504%2014.7575%2014.7536%2012.1543%2014.7536%208.94319C14.7536%205.73205%2012.1504%203.12891%208.93929%203.12891C5.72814%203.12891%203.125%205.73205%203.125%208.94319C3.125%2012.1543%205.72814%2014.7575%208.93929%2014.7575Z'%20stroke='%23D8E8F6'%20stroke-width='1.2'%20stroke-linecap='round'%20stroke-linejoin='round'/%3e%3cpath%20d='M16.8642%2016.872L13.0469%2013.0547'%20stroke='%23D8E8F6'%20stroke-width='1.2'%20stroke-linecap='round'%20stroke-linejoin='round'/%3e%3cpath%20d='M12.4688%201.47559C13.0214%202.58108%2013.918%203.47752%2015.0234%204.03027L15.9619%204.5L15.0234%204.96973C13.918%205.52248%2013.0214%206.41892%2012.4688%207.52441L12%208.46191L11.5313%207.52441C10.9786%206.41892%2010.082%205.52248%208.97656%204.96973L8.03711%204.5L8.97656%204.03027C10.082%203.47752%2010.9786%202.58108%2011.5313%201.47559L12%200.538086L12.4688%201.47559Z'%20fill='white'%20stroke='%233E8BD1'%20stroke-width='1.375'/%3e%3c/g%3e%3c/g%3e%3cdefs%3e%3cclipPath%20id='clip0_11623_94780'%3e%3crect%20width='16'%20height='18'%20fill='white'%20transform='translate(2)'/%3e%3c/clipPath%3e%3c/defs%3e%3c/svg%3e\""],"names":["__vite_glob_0_2"],"mappings":"AAAA,MAAAA,IAAe;"}
+{"version":3,"file":"index82.js","sources":["../src/utils/a11y/useModalA11y.ts"],"sourcesContent":["import { useRef } from 'react';\nimport type { MutableRefObject, RefObject } from 'react';\nimport { useFocusTrap } from './useFocusTrap';\nimport { useDismissOnEscape } from './useDismissOnEscape';\nimport { getA11yNameAttributes } from './accessibleName';\nimport { useStableId } from 'src/utils/useStableId';\n\nexport interface UseModalA11yOptions {\n  /**\n   * Whether the modal is open. Controls focus trap and Escape handler activation.\n   */\n  isOpen: boolean;\n  /**\n   * Called when Escape is pressed while focus is within the modal.\n   * If undefined, Escape dismissal is disabled.\n   */\n  onDismiss?: () => void;\n  /**\n   * aria-label for modals without a visible title heading.\n   * Only used when `ariaLabelledBy` is not provided.\n   */\n  ariaLabel?: string;\n  /**\n   * ID of an existing visible element (e.g. an h2 inside the modal content) that labels\n   * the dialog. Preferred over ariaLabel when a visible heading already exists in the content.\n   * Only used when `title` is not provided.\n   */\n  ariaLabelledBy?: string;\n  /**\n   * Prefix for the auto-generated title element id. Default: 'modal-title'.\n   */\n  titleIdPrefix?: string;\n  /**\n   * Initial focus target when the modal opens. Forwarded to useFocusTrap.\n   * - 'first': Focus first focusable element (default)\n   * - 'container': Focus the dialog container itself\n   * - 'none': Skip — browser handles it (e.g. autofocus attribute on inner element)\n   * - CSS selector string: Focus matching element\n   * - HTMLElement: Focus specific element\n   */\n  initialFocus?: 'first' | 'container' | 'none' | string | HTMLElement;\n  /**\n   * Additional container refs for portal content that is logically part of this modal.\n   * Passed through to useFocusTrap and useDismissOnEscape so their safety nets\n   * allow focus to move into portal-rendered content (e.g., Dropdown with isWithPortal).\n   */\n  portalContainerRefs?: MutableRefObject<RefObject<HTMLElement | null>[]>;\n}\n\nexport interface UseModalA11yReturn {\n  /**\n   * Ref to attach to the dialog container element.\n   */\n  containerRef: React.RefObject<HTMLDivElement | null>;\n  /**\n   * Stable ID to set on the visible title element: `<h2 id={titleId}>`.\n   * Only relevant when `title` is provided.\n   */\n  titleId: string;\n  /**\n   * Spread onto the dialog container element.\n   * Includes: role=\"dialog\", aria-modal, tabIndex, aria-labelledby or aria-label.\n   */\n  dialogProps: {\n    role: 'dialog';\n    'aria-modal': true;\n    tabIndex: number;\n    [key: string]: unknown;\n  };\n}\n\n/**\n * Bundles all WCAG dialog semantics into a single hook.\n *\n * Handles:\n * - Stable ID for title element (aria-labelledby association)\n * - Focus trap: moves focus into modal on open, wraps Tab, restores focus on close\n * - Escape dismissal: calls onDismiss when Escape is pressed within the modal\n * - dialogProps: role=\"dialog\", aria-modal, tabIndex, aria-labelledby / aria-label\n *\n * @example Modal with a visible title (most common)\n * ```tsx\n * const MyModal = ({ isOpen, onClose }) => {\n *   const { containerRef, titleId, dialogProps } = useModalA11y({\n *     isOpen,\n *     onDismiss: onClose,\n *   });\n *\n *   return (\n *     <div ref={containerRef} {...dialogProps} className=\"modal-content\">\n *       <h2 id={titleId}>My Title</h2>\n *       ...\n *     </div>\n *   );\n * };\n * ```\n *\n * @example Modal without a visible title\n * ```tsx\n * const { containerRef, dialogProps } = useModalA11y({\n *   isOpen,\n *   onDismiss: onClose,\n *   ariaLabel: 'Upload document',\n * });\n * ```\n *\n * @example Custom initial focus (specific button) or skip (autofocus)\n * ```tsx\n * useModalA11y({ isOpen, onDismiss, initialFocus: '.my-cta-btn' });\n * useModalA11y({ isOpen, onDismiss, initialFocus: 'none' }); // autofocus on inner element\n * ```\n */\nexport function useModalA11y({\n  isOpen,\n  onDismiss,\n  ariaLabel,\n  ariaLabelledBy,\n  titleIdPrefix = 'modal-title',\n  initialFocus = 'first',\n  portalContainerRefs,\n}: UseModalA11yOptions): UseModalA11yReturn {\n  const containerRef = useRef<HTMLDivElement>(null);\n  const titleId = useStableId(undefined, titleIdPrefix);\n\n  useFocusTrap({\n    enabled: isOpen,\n    containerRef,\n    restoreFocus: true,\n    initialFocus,\n    portalContainerRefs,\n  });\n\n  useDismissOnEscape({\n    containerRef,\n    onDismiss,\n    enabled: isOpen,\n  });\n\n  const nameAttrs = getA11yNameAttributes({\n    ariaLabelledBy: ariaLabelledBy ?? (ariaLabel ? undefined : titleId),\n    ariaLabel: ariaLabel,\n  });\n\n  const dialogProps = {\n    role: 'dialog' as const,\n    'aria-modal': true as const,\n    tabIndex: -1,\n    ...nameAttrs,\n  };\n\n  return { containerRef, titleId, dialogProps };\n}\n"],"names":["useRef","useFocusTrap","useDismissOnEscape","getA11yNameAttributes","useStableId","useModalA11y","isOpen","onDismiss","ariaLabel","ariaLabelledBy","titleIdPrefix","initialFocus","portalContainerRefs","containerRef","titleId","undefined","enabled","restoreFocus","dialogProps","role","tabIndex","nameAttrs"],"mappings":"AAgHO,SAAA,UAAAA,SAAA;AAAA,SAAA,gBAAAC,SAAA;AAAA,SAAA,sBAAAC,SAAA;AAAA,SAAA,yBAAAC,SAAA;AAAA,SAAA,eAAAC,SAAA;AAAA,SAASC,EAAa;AAAA,EAC3BC,QAAAA;AAAAA,EACAC,WAAAA;AAAAA,EACAC,WAAAA;AAAAA,EACAC,gBAAAA;AAAAA,EACAC,eAAAA,IAAgB;AAAA,EAChBC,cAAAA,IAAe;AAAA,EACfC,qBAAAA;AACmB,GAAuB;AAC1C,QAAMC,IAAeb,EAAuB,IAAI,GAC1Cc,IAAUV,EAAYW,QAAWL,CAAa;AAEpDT,EAAAA,EAAa;AAAA,IACXe,SAASV;AAAAA,IACTO,cAAAA;AAAAA,IACAI,cAAc;AAAA,IACdN,cAAAA;AAAAA,IACAC,qBAAAA;AAAAA,EAAAA,CACD,GAEDV,EAAmB;AAAA,IACjBW,cAAAA;AAAAA,IACAN,WAAAA;AAAAA,IACAS,SAASV;AAAAA,EAAAA,CACV;AAOD,QAAMY,IAAc;AAAA,IAClBC,MAAM;AAAA,IACN,cAAc;AAAA,IACdC,UAAU;AAAA,IACV,GATgBjB,EAAsB;AAAA,MACtCM,gBAAgBA,MAAmBD,IAAYO,SAAYD;AAAAA,MAC3DN,WAAAA;AAAAA,IAAAA,CACD;AAAA,EAMIa;AAGL,SAAO;AAAA,IAAER,cAAAA;AAAAA,IAAcC,SAAAA;AAAAA,IAASI,aAAAA;AAAAA,EAAAA;AAClC;"}

package/dist/index83.js

@@ -1,5 +1,9 @@
-const L = "data:image/svg+xml,%3csvg%20width='16'%20height='17'%20viewBox='0%200%2016%2017'%20fill='none'%20xmlns='http://www.w3.org/2000/svg'%3e%3cpath%20d='M10.4958%207.65801L9.58298%205.83203L8.67016%207.65801C8.37987%208.23869%207.90907%208.70953%207.32841%208.99985L5.50189%209.91312L7.32841%2010.8264C7.90907%2011.1167%208.37987%2011.5876%208.67016%2012.1682L9.58298%2013.9942L10.4958%2012.1682C10.7861%2011.5876%2011.2569%2011.1167%2011.8375%2010.8264L13.6641%209.91312L11.8375%208.99986C11.2569%208.70953%2010.7861%208.23869%2010.4958%207.65801Z'%20fill='%23415575'%20stroke='%23415575'/%3e%3cpath%20d='M4.66587%203.16003L4.33592%202.5L4.00597%203.16003C3.71568%203.7407%203.24488%204.21155%202.66423%204.50187L2.00387%204.83205L2.66422%205.16223C3.24487%205.45255%203.71568%205.9234%204.00597%206.50407L4.33592%207.1641L4.66587%206.50407C4.95615%205.9234%205.42696%205.45255%206.00761%205.16223L6.66797%204.83205L6.00761%204.50187C5.42696%204.21155%204.95615%203.7407%204.66587%203.16003Z'%20fill='%23415575'%20stroke='%23415575'/%3e%3c/svg%3e";
+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;
+}
 export {
-  L as default
+  u as useStableId
 };
 //# sourceMappingURL=index83.js.map

package/dist/index83.js.map

@@ -1 +1 @@
-{"version":3,"file":"index83.js","sources":["../src/assets/icons/ai-stars.svg?url"],"sourcesContent":["export default \"data:image/svg+xml,%3csvg%20width='16'%20height='17'%20viewBox='0%200%2016%2017'%20fill='none'%20xmlns='http://www.w3.org/2000/svg'%3e%3cpath%20d='M10.4958%207.65801L9.58298%205.83203L8.67016%207.65801C8.37987%208.23869%207.90907%208.70953%207.32841%208.99985L5.50189%209.91312L7.32841%2010.8264C7.90907%2011.1167%208.37987%2011.5876%208.67016%2012.1682L9.58298%2013.9942L10.4958%2012.1682C10.7861%2011.5876%2011.2569%2011.1167%2011.8375%2010.8264L13.6641%209.91312L11.8375%208.99986C11.2569%208.70953%2010.7861%208.23869%2010.4958%207.65801Z'%20fill='%23415575'%20stroke='%23415575'/%3e%3cpath%20d='M4.66587%203.16003L4.33592%202.5L4.00597%203.16003C3.71568%203.7407%203.24488%204.21155%202.66423%204.50187L2.00387%204.83205L2.66422%205.16223C3.24487%205.45255%203.71568%205.9234%204.00597%206.50407L4.33592%207.1641L4.66587%206.50407C4.95615%205.9234%205.42696%205.45255%206.00761%205.16223L6.66797%204.83205L6.00761%204.50187C5.42696%204.21155%204.95615%203.7407%204.66587%203.16003Z'%20fill='%23415575'%20stroke='%23415575'/%3e%3c/svg%3e\""],"names":["__vite_glob_0_3"],"mappings":"AAAA,MAAAA,IAAe;"}
+{"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;"}