se-design 1.0.51 → 1.0.52

package/dist/index177.js

@@ -1,8 +1,8 @@
-import N from "./index219.js";
-import R from "./index220.js";
-import D from "./index221.js";
-import { SVGInjector as A } from "./index222.js";
-import { p as t } from "./index223.js";
+import N from "./index217.js";
+import R from "./index218.js";
+import D from "./index219.js";
+import { SVGInjector as A } from "./index220.js";
+import { p as t } from "./index221.js";
 import * as h from "react";
 var O = function(s) {
   var o = s?.ownerDocument || document;

package/dist/index185.js

@@ -1,62 +1,26 @@
-import { useRef as E, useLayoutEffect as f } from "react";
-import { getFirstFocusableElement as d, getFocusableElements as g } from "./index218.js";
-function y(e, t) {
-  return t === "first" ? d({
-    container: e
-  }) || e : t === "container" ? e : typeof t == "string" ? e.querySelector(t) : t instanceof HTMLElement ? t : null;
-}
-function L({
-  enabled: e,
-  containerRef: t,
-  restoreFocus: i = !0,
-  initialFocus: l = "first"
+import { useEffect as d } from "react";
+function p({
+  containerRef: r,
+  onDismiss: e,
+  enabled: n = !0,
+  preventDefault: u = !0,
+  stopPropagation: c = !0
 }) {
-  const s = E(null), m = E(null);
-  return f(() => {
-    if (!e) {
-      i && s.current && requestAnimationFrame(() => {
-        s.current?.focus(), s.current = null;
-      });
-      return;
-    }
-    const r = t.current;
-    r && (s.current = document.activeElement, requestAnimationFrame(() => {
-      y(r, l)?.focus();
-    }));
-  }, [e, t, i, l]), f(() => {
-    if (!e) return;
-    const r = t.current;
-    if (!r) return;
-    const c = (n) => {
-      if (n.key === "Tab") {
-        const u = g({
-          container: r
-        });
-        if (u.length === 0) {
-          n.preventDefault(), r.focus();
-          return;
-        }
-        const o = u[0], a = u[u.length - 1], v = document.activeElement;
-        n.shiftKey && v === o ? (n.preventDefault(), a.focus()) : !n.shiftKey && v === a && (n.preventDefault(), o.focus());
-      }
-    };
-    return document.addEventListener("keydown", c, !0), () => document.removeEventListener("keydown", c, !0);
-  }, [e, t]), f(() => {
-    if (!e) return;
-    const r = t.current;
-    if (!r) return;
-    const c = (n) => {
-      const u = n.target;
-      r.contains(u) ? m.current = u : (m.current || d({
-        container: r
-      }) || r).focus();
+  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("focusin", c, !0), () => document.removeEventListener("focusin", c, !0);
-  }, [e, t]), {
-    triggerRef: s
-  };
+    return document.addEventListener("keydown", a, {
+      capture: !0
+    }), () => document.removeEventListener("keydown", a, {
+      capture: !0
+    });
+  }, [n, e, r, u, c]);
 }
 export {
-  L as useFocusTrap
+  p as useDismissOnEscape
 };
 //# sourceMappingURL=index185.js.map

package/dist/index185.js.map

@@ -1 +1 @@
-{"version":3,"file":"index185.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   * - CSS selector: Focus element matching selector\n   * - HTMLElement: Focus this specific element\n   */\n  initialFocus?: 'first' | 'container' | string | HTMLElement;\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/**\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 * \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 */\n/**\n * Resolve the initial focus target based on the initialFocus option.\n */\nfunction resolveInitialFocusTarget(\n  container: HTMLElement,\n  initialFocus: 'first' | 'container' | string | HTMLElement\n): HTMLElement | 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\nexport function useFocusTrap<T extends HTMLElement = HTMLElement>({\n  enabled,\n  containerRef,\n  restoreFocus = true,\n  initialFocus = 'first'\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        requestAnimationFrame(() => {\n          triggerRef.current?.focus();\n          triggerRef.current = null;\n        });\n      }\n      return;\n    }\n\n    const container = containerRef.current;\n    if (!container) return;\n\n    // Save the element that had focus before trap activated\n    triggerRef.current = document.activeElement as HTMLElement;\n\n    // Focus initial target\n    requestAnimationFrame(() => {\n      resolveInitialFocusTarget(container, initialFocus)?.focus();\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":["useRef","useLayoutEffect","getFirstFocusableElement","getFocusableElements","resolveInitialFocusTarget","container","initialFocus","querySelector","HTMLElement","useFocusTrap","enabled","containerRef","restoreFocus","triggerRef","lastFocusedInContainer","current","requestAnimationFrame","focus","document","activeElement","handleKeyDown","e","key","focusables","length","preventDefault","first","last","shiftKey","addEventListener","removeEventListener","handleFocusIn","target","contains"],"mappings":"AA8EA,SAAA,UAAAA,GAAA,mBAAAC,SAAA;AAAA,SAAA,4BAAAC,GAAA,wBAAAC,SAAA;AAAA,SAASC,EACPC,GACAC,GACoB;AACpB,SAAIA,MAAiB,UACZJ,EAAyB;AAAA,IAAEG,WAAAA;AAAAA,EAAAA,CAAW,KAAKA,IAEhDC,MAAiB,cACZD,IAEL,OAAOC,KAAiB,WACnBD,EAAUE,cAA2BD,CAAY,IAEtDA,aAAwBE,cACnBF,IAEF;AACT;AAEO,SAASG,EAAkD;AAAA,EAChEC,SAAAA;AAAAA,EACAC,cAAAA;AAAAA,EACAC,cAAAA,IAAe;AAAA,EACfN,cAAAA,IAAe;AACO,GAAuB;AAC7C,QAAMO,IAAab,EAA2B,IAAI,GAC5Cc,IAAyBd,EAA2B,IAAI;AAG9DC,SAAAA,EAAgB,MAAM;AACpB,QAAI,CAACS,GAAS;AAEZ,MAAIE,KAAgBC,EAAWE,WAC7BC,sBAAsB,MAAM;AAC1BH,QAAAA,EAAWE,SAASE,MAAAA,GACpBJ,EAAWE,UAAU;AAAA,MACvB,CAAC;AAEH;AAAA,IACF;AAEA,UAAMV,IAAYM,EAAaI;AAC/B,IAAKV,MAGLQ,EAAWE,UAAUG,SAASC,eAG9BH,sBAAsB,MAAM;AAC1BZ,MAAAA,EAA0BC,GAAWC,CAAY,GAAGW,MAAAA;AAAAA,IACtD,CAAC;AAAA,EACH,GAAG,CAACP,GAASC,GAAcC,GAAcN,CAAY,CAAC,GAGtDL,EAAgB,MAAM;AACpB,QAAI,CAACS,EAAS;AAEd,UAAML,IAAYM,EAAaI;AAC/B,QAAI,CAACV,EAAW;AAEhB,UAAMe,IAAgBA,CAACC,MAAqB;AAE1C,UAAIA,EAAEC,QAAQ,OAAO;AACnB,cAAMC,IAAapB,EAAqB;AAAA,UAAEE,WAAAA;AAAAA,QAAAA,CAAW;AAErD,YAAIkB,EAAWC,WAAW,GAAG;AAC3BH,UAAAA,EAAEI,eAAAA,GACFpB,EAAUY,MAAAA;AACV;AAAA,QACF;AAEA,cAAMS,IAAQH,EAAW,CAAC,GACpBI,IAAOJ,EAAWA,EAAWC,SAAS,CAAC,GACvCL,IAAgBD,SAASC;AAE/B,QAAIE,EAAEO,YAAYT,MAAkBO,KAClCL,EAAEI,eAAAA,GACFE,EAAKV,MAAAA,KACI,CAACI,EAAEO,YAAYT,MAAkBQ,MAC1CN,EAAEI,eAAAA,GACFC,EAAMT,MAAAA;AAAAA,MAEV;AAAA,IACF;AAEAC,oBAASW,iBAAiB,WAAWT,GAAe,EAAI,GACjD,MAAMF,SAASY,oBAAoB,WAAWV,GAAe,EAAI;AAAA,EAC1E,GAAG,CAACV,GAASC,CAAY,CAAC,GAG1BV,EAAgB,MAAM;AACpB,QAAI,CAACS,EAAS;AAEd,UAAML,IAAYM,EAAaI;AAC/B,QAAI,CAACV,EAAW;AAEhB,UAAM0B,IAAgBA,CAACV,MAAkB;AACvC,YAAMW,IAASX,EAAEW;AAEjB,MAAI3B,EAAU4B,SAASD,CAAM,IAC3BlB,EAAuBC,UAAUiB,KAGhBlB,EAAuBC,WACnCb,EAAyB;AAAA,QAAEG,WAAAA;AAAAA,MAAAA,CAAW,KACtCA,GACIY,MAAAA;AAAAA,IAEb;AAEAC,oBAASW,iBAAiB,WAAWE,GAAe,EAAI,GACjD,MAAMb,SAASY,oBAAoB,WAAWC,GAAe,EAAI;AAAA,EAC1E,GAAG,CAACrB,GAASC,CAAY,CAAC,GAEnB;AAAA,IAAEE,YAAAA;AAAAA,EAAAA;AACX;"}
+{"version":3,"file":"index185.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/{index194.js → index193.js}

@@ -12,4 +12,4 @@ function n(o, u) {
 export {
   n as debounce
 };
-//# sourceMappingURL=index194.js.map
+//# sourceMappingURL=index193.js.map

package/dist/{index194.js.map → index193.js.map}

@@ -1 +1 @@
-{"version":3,"file":"index194.js","sources":["../src/utils/debounce.ts"],"sourcesContent":["export function debounce<T extends (...args: any[]) => void>(func: T, wait: number) {\n    let timeout: ReturnType<typeof setTimeout> | null;\n    const debounced = (...args: Parameters<T>) => {\n      if (timeout) clearTimeout(timeout);\n      timeout = setTimeout(() => {\n        func(...args);\n      }, wait);\n    };\n    debounced.cancel = () => {\n      if (timeout) clearTimeout(timeout);\n      timeout = null;\n    };\n    return debounced as T & { cancel: () => void };\n  }"],"names":["debounce","func","wait","timeout","debounced","args","setTimeout","cancel"],"mappings":"AAAO,SAASA,EAA6CC,GAASC,GAAc;AAChF,MAAIC;AACJ,QAAMC,IAAYA,IAAIC,MAAwB;AAC5C,IAAIF,kBAAsBA,CAAO,GACjCA,IAAUG,WAAW,MAAM;AACzBL,MAAAA,EAAK,GAAGI,CAAI;AAAA,IACd,GAAGH,CAAI;AAAA,EACT;AACAE,SAAAA,EAAUG,SAAS,MAAM;AACvB,IAAIJ,kBAAsBA,CAAO,GACjCA,IAAU;AAAA,EACZ,GACOC;AACT;"}
+{"version":3,"file":"index193.js","sources":["../src/utils/debounce.ts"],"sourcesContent":["export function debounce<T extends (...args: any[]) => void>(func: T, wait: number) {\n    let timeout: ReturnType<typeof setTimeout> | null;\n    const debounced = (...args: Parameters<T>) => {\n      if (timeout) clearTimeout(timeout);\n      timeout = setTimeout(() => {\n        func(...args);\n      }, wait);\n    };\n    debounced.cancel = () => {\n      if (timeout) clearTimeout(timeout);\n      timeout = null;\n    };\n    return debounced as T & { cancel: () => void };\n  }"],"names":["debounce","func","wait","timeout","debounced","args","setTimeout","cancel"],"mappings":"AAAO,SAASA,EAA6CC,GAASC,GAAc;AAChF,MAAIC;AACJ,QAAMC,IAAYA,IAAIC,MAAwB;AAC5C,IAAIF,kBAAsBA,CAAO,GACjCA,IAAUG,WAAW,MAAM;AACzBL,MAAAA,EAAK,GAAGI,CAAI;AAAA,IACd,GAAGH,CAAI;AAAA,EACT;AACAE,SAAAA,EAAUG,SAAS,MAAM;AACvB,IAAIJ,kBAAsBA,CAAO,GACjCA,IAAU;AAAA,EACZ,GACOC;AACT;"}

package/dist/{index202.js → index201.js}

@@ -1233,4 +1233,4 @@ const e = [
 export {
   e as default
 };
-//# sourceMappingURL=index202.js.map
+//# sourceMappingURL=index201.js.map

package/dist/{index202.js.map → index201.js.map}

@@ -1 +1 @@
-{"version":3,"file":"index202.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index201.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/index203.js

@@ -0,0 +1,35 @@
+import u, { forwardRef as c } from "react";
+import { Button as p } from "./index3.js";
+const b = /* @__PURE__ */ c(({
+  id: t,
+  label: e,
+  isSelected: a,
+  isDisabled: r = !1,
+  panelId: o,
+  tabIndex: l,
+  className: n = "",
+  automationId: d,
+  onClick: s,
+  onFocus: f,
+  onKeyDown: i
+}, m) => /* @__PURE__ */ u.createElement(p, {
+  ref: m,
+  type: "unstyled",
+  label: e,
+  disabled: r,
+  onClick: s,
+  className: n,
+  automationId: d,
+  role: "tab",
+  id: t,
+  "aria-selected": a,
+  "aria-controls": o,
+  tabIndex: l,
+  onFocus: f,
+  onKeyDown: i
+}));
+b.displayName = "TabButton";
+export {
+  b as TabButton
+};
+//# sourceMappingURL=index203.js.map

package/dist/index203.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index203.js","sources":["../src/components/NavigationBar/TabButton.tsx"],"sourcesContent":["import React, { forwardRef } from 'react';\nimport { Button } from '../Button';\n\nexport interface TabButtonProps {\n  id: string;\n  label: string;\n  isSelected: boolean;\n  isDisabled?: boolean;\n  panelId: string;\n  tabIndex: number;\n  className?: string;\n  automationId?: string;\n  onClick: (e: React.MouseEvent<HTMLButtonElement>) => void;\n  onFocus: () => void;\n  onKeyDown: (e: React.KeyboardEvent<HTMLButtonElement>) => void;\n}\n\n/**\n * Internal TabButton component for NavigationBar.\n * Uses Button (unstyled) internally for consistent activation handling.\n * Supports forwardRef for focus management (roving tabindex).\n */\nexport const TabButton = forwardRef<HTMLButtonElement, TabButtonProps>(\n  (\n    {\n      id,\n      label,\n      isSelected,\n      isDisabled = false,\n      panelId,\n      tabIndex,\n      className = '',\n      automationId,\n      onClick,\n      onFocus,\n      onKeyDown\n    },\n    ref\n  ) => {\n    return (\n      <Button\n        ref={ref}\n        type=\"unstyled\"\n        label={label}\n        disabled={isDisabled}\n        onClick={onClick}\n        className={className}\n        automationId={automationId}\n        role=\"tab\"\n        id={id}\n        aria-selected={isSelected}\n        aria-controls={panelId}\n        tabIndex={tabIndex}\n        onFocus={onFocus}\n        onKeyDown={onKeyDown}\n      />\n    );\n  }\n);\n\nTabButton.displayName = 'TabButton';\n"],"names":["React__default","forwardRef","Button","TabButton","id","label","isSelected","isDisabled","panelId","tabIndex","className","automationId","onClick","onFocus","onKeyDown","ref","React","createElement","type","disabled","role","displayName"],"mappings":"AAsBO,OAAAA,KAAA,cAAAC,SAAA;AAAA,SAAA,UAAAC,SAAA;AAAA,MAAMC,sBACX,CACE;AAAA,EACEC,IAAAA;AAAAA,EACAC,OAAAA;AAAAA,EACAC,YAAAA;AAAAA,EACAC,YAAAA,IAAa;AAAA,EACbC,SAAAA;AAAAA,EACAC,UAAAA;AAAAA,EACAC,WAAAA,IAAY;AAAA,EACZC,cAAAA;AAAAA,EACAC,SAAAA;AAAAA,EACAC,SAAAA;AAAAA,EACAC,WAAAA;AACF,GACAC,MAGEC,gBAAAA,EAAAC,cAACf,GAAM;AAAA,EACLa,KAAAA;AAAAA,EACAG,MAAK;AAAA,EACLb,OAAAA;AAAAA,EACAc,UAAUZ;AAAAA,EACVK,SAAAA;AAAAA,EACAF,WAAAA;AAAAA,EACAC,cAAAA;AAAAA,EACAS,MAAK;AAAA,EACLhB,IAAAA;AAAAA,EACA,iBAAeE;AAAAA,EACf,iBAAeE;AAAAA,EACfC,UAAAA;AAAAA,EACAI,SAAAA;AAAAA,EACAC,WAAAA;AAAAA,CACD,CAGP;AAEAX,EAAUkB,cAAc;"}

package/dist/index204.js

@@ -1,35 +1,44 @@
-import u, { forwardRef as c } from "react";
-import { Button as p } from "./index3.js";
-const b = /* @__PURE__ */ c(({
-  id: t,
-  label: e,
-  isSelected: a,
-  isDisabled: r = !1,
-  panelId: o,
-  tabIndex: l,
-  className: n = "",
-  automationId: d,
-  onClick: s,
-  onFocus: f,
-  onKeyDown: i
-}, m) => /* @__PURE__ */ u.createElement(p, {
-  ref: m,
-  type: "unstyled",
-  label: e,
-  disabled: r,
-  onClick: s,
-  className: n,
-  automationId: d,
-  role: "tab",
-  id: t,
-  "aria-selected": a,
-  "aria-controls": o,
-  tabIndex: l,
-  onFocus: f,
-  onKeyDown: i
-}));
-b.displayName = "TabButton";
+import { useCallback as d } from "react";
+import { useRovingFocus as g } from "./index215.js";
+const u = (e, t) => `tab${t ? `-${t}` : ""}-${e}`, c = (e, t) => `panel${t ? `-${t}` : ""}-${e}`;
+function P({
+  itemIds: e,
+  orientation: t = "horizontal",
+  activeNavigationItem: r,
+  idBase: n = ""
+}) {
+  const {
+    setFocusedId: f,
+    handleKeyDown: l,
+    getRovingItemProps: s
+  } = g({
+    itemIds: e,
+    defaultFocusedId: r,
+    orientation: t,
+    loop: !0
+  });
+  return {
+    getTabProps: d((o) => {
+      const {
+        ref: b,
+        tabIndex: a
+      } = s(o), p = r === o;
+      return {
+        ref: b,
+        tabIndex: a,
+        id: u(o, n),
+        "aria-controls": c(o, n),
+        "aria-selected": p,
+        role: "tab"
+      };
+    }, [r, s, n]),
+    setFocusedTabId: f,
+    handleKeyDown: l,
+    getPanelId: (o) => c(o, n),
+    getTabId: (o) => u(o, n)
+  };
+}
 export {
-  b as TabButton
+  P as useTabsA11y
 };
 //# sourceMappingURL=index204.js.map

package/dist/index204.js.map

@@ -1 +1 @@
-{"version":3,"file":"index204.js","sources":["../src/components/NavigationBar/TabButton.tsx"],"sourcesContent":["import React, { forwardRef } from 'react';\nimport { Button } from '../Button';\n\nexport interface TabButtonProps {\n  id: string;\n  label: string;\n  isSelected: boolean;\n  isDisabled?: boolean;\n  panelId: string;\n  tabIndex: number;\n  className?: string;\n  automationId?: string;\n  onClick: (e: React.MouseEvent<HTMLButtonElement>) => void;\n  onFocus: () => void;\n  onKeyDown: (e: React.KeyboardEvent<HTMLButtonElement>) => void;\n}\n\n/**\n * Internal TabButton component for NavigationBar.\n * Uses Button (unstyled) internally for consistent activation handling.\n * Supports forwardRef for focus management (roving tabindex).\n */\nexport const TabButton = forwardRef<HTMLButtonElement, TabButtonProps>(\n  (\n    {\n      id,\n      label,\n      isSelected,\n      isDisabled = false,\n      panelId,\n      tabIndex,\n      className = '',\n      automationId,\n      onClick,\n      onFocus,\n      onKeyDown\n    },\n    ref\n  ) => {\n    return (\n      <Button\n        ref={ref}\n        type=\"unstyled\"\n        label={label}\n        disabled={isDisabled}\n        onClick={onClick}\n        className={className}\n        automationId={automationId}\n        role=\"tab\"\n        id={id}\n        aria-selected={isSelected}\n        aria-controls={panelId}\n        tabIndex={tabIndex}\n        onFocus={onFocus}\n        onKeyDown={onKeyDown}\n      />\n    );\n  }\n);\n\nTabButton.displayName = 'TabButton';\n"],"names":["React__default","forwardRef","Button","TabButton","id","label","isSelected","isDisabled","panelId","tabIndex","className","automationId","onClick","onFocus","onKeyDown","ref","React","createElement","type","disabled","role","displayName"],"mappings":"AAsBO,OAAAA,KAAA,cAAAC,SAAA;AAAA,SAAA,UAAAC,SAAA;AAAA,MAAMC,sBACX,CACE;AAAA,EACEC,IAAAA;AAAAA,EACAC,OAAAA;AAAAA,EACAC,YAAAA;AAAAA,EACAC,YAAAA,IAAa;AAAA,EACbC,SAAAA;AAAAA,EACAC,UAAAA;AAAAA,EACAC,WAAAA,IAAY;AAAA,EACZC,cAAAA;AAAAA,EACAC,SAAAA;AAAAA,EACAC,SAAAA;AAAAA,EACAC,WAAAA;AACF,GACAC,MAGEC,gBAAAA,EAAAC,cAACf,GAAM;AAAA,EACLa,KAAAA;AAAAA,EACAG,MAAK;AAAA,EACLb,OAAAA;AAAAA,EACAc,UAAUZ;AAAAA,EACVK,SAAAA;AAAAA,EACAF,WAAAA;AAAAA,EACAC,cAAAA;AAAAA,EACAS,MAAK;AAAA,EACLhB,IAAAA;AAAAA,EACA,iBAAeE;AAAAA,EACf,iBAAeE;AAAAA,EACfC,UAAAA;AAAAA,EACAI,SAAAA;AAAAA,EACAC,WAAAA;AAAAA,CACD,CAGP;AAEAX,EAAUkB,cAAc;"}
+{"version":3,"file":"index204.js","sources":["../src/components/NavigationBar/useTabsA11y.ts"],"sourcesContent":["import { useCallback } from 'react';\nimport { useRovingFocus } from '../../utils/a11y';\n\nconst getTabId = (itemId: string, idBase: string) => {\n  const suffix = idBase ? `-${idBase}` : '';\n  return `tab${suffix}-${itemId}`;\n};\n\nconst getPanelId = (itemId: string, idBase: string) => {\n  const suffix = idBase ? `-${idBase}` : '';\n  return `panel${suffix}-${itemId}`;\n};\n\ninterface UseTabsA11yProps {\n  itemIds: string[];\n  orientation?: 'horizontal' | 'vertical';\n  activeNavigationItem: string;\n  idBase?: string;\n}\n\ninterface TabA11yProps {\n  ref: (el: HTMLElement | null) => void;\n  tabIndex: number;\n  id: string;\n  'aria-controls': string;\n  'aria-selected': boolean;\n  role: 'tab';\n}\n\n/**\n * Hook for managing Tabs (NavigationBar) focus and ARIA props.\n * Handles roving tabindex pattern and generates tab-specific ARIA attributes.\n * \n * @example\n * const itemIds = useMemo(() => navigationItems.map(item => item.id), [navigationItems]);\n * const { getTabProps, setFocusedTabId, handleKeyDown } = useTabsA11y({\n *   itemIds,\n *   activeNavigationItem: 'tab-1',\n *   orientation: 'horizontal',\n *   idBase: 'settings'\n * });\n */\nexport function useTabsA11y({\n  itemIds,\n  orientation = 'horizontal',\n  activeNavigationItem,\n  idBase = ''\n}: UseTabsA11yProps) {\n  const {\n    setFocusedId: setFocusedTabId,\n    handleKeyDown,\n    getRovingItemProps\n  } = useRovingFocus({\n    itemIds,\n    defaultFocusedId: activeNavigationItem,\n    orientation,\n    loop: true\n  });\n\n  /**\n   * Get all props needed for a tab button.\n   * Combines roving focus props (ref, tabIndex) with tab-specific ARIA attributes.\n   */\n  const getTabProps = useCallback((itemId: string): TabA11yProps => {\n    const { ref, tabIndex } = getRovingItemProps(itemId);\n    const isSelected = activeNavigationItem === itemId;\n\n    return {\n      ref,\n      tabIndex,\n      id: getTabId(itemId, idBase),\n      'aria-controls': getPanelId(itemId, idBase),\n      'aria-selected': isSelected,\n      role: 'tab'\n    };\n  }, [activeNavigationItem, getRovingItemProps, idBase]);\n\n  return {\n    getTabProps,\n    setFocusedTabId,\n    handleKeyDown,\n    getPanelId: (itemId: string) => getPanelId(itemId, idBase),\n    getTabId: (itemId: string) => getTabId(itemId, idBase)\n  };\n}\n\n"],"names":["useCallback","useRovingFocus","getTabId","itemId","idBase","getPanelId","useTabsA11y","itemIds","orientation","activeNavigationItem","setFocusedId","setFocusedTabId","handleKeyDown","getRovingItemProps","defaultFocusedId","loop","getTabProps","ref","tabIndex","isSelected","id","role"],"mappings":"AAGA,SAAA,eAAAA,SAAA;AAAA,SAAA,kBAAAC,SAAA;AAAA,MAAMC,IAAWA,CAACC,GAAgBC,MAEzB,MADQA,IAAS,IAAIA,CAAM,KAAK,EACpB,IAAID,CAAM,IAGzBE,IAAaA,CAACF,GAAgBC,MAE3B,QADQA,IAAS,IAAIA,CAAM,KAAK,EAClB,IAAID,CAAM;AAgC1B,SAASG,EAAY;AAAA,EAC1BC,SAAAA;AAAAA,EACAC,aAAAA,IAAc;AAAA,EACdC,sBAAAA;AAAAA,EACAL,QAAAA,IAAS;AACO,GAAG;AACnB,QAAM;AAAA,IACJM,cAAcC;AAAAA,IACdC,eAAAA;AAAAA,IACAC,oBAAAA;AAAAA,EAAAA,IACEZ,EAAe;AAAA,IACjBM,SAAAA;AAAAA,IACAO,kBAAkBL;AAAAA,IAClBD,aAAAA;AAAAA,IACAO,MAAM;AAAA,EAAA,CACP;AAoBD,SAAO;AAAA,IACLC,aAfkBhB,EAAY,CAACG,MAAiC;AAChE,YAAM;AAAA,QAAEc,KAAAA;AAAAA,QAAKC,UAAAA;AAAAA,MAAAA,IAAaL,EAAmBV,CAAM,GAC7CgB,IAAaV,MAAyBN;AAE5C,aAAO;AAAA,QACLc,KAAAA;AAAAA,QACAC,UAAAA;AAAAA,QACAE,IAAIlB,EAASC,GAAQC,CAAM;AAAA,QAC3B,iBAAiBC,EAAWF,GAAQC,CAAM;AAAA,QAC1C,iBAAiBe;AAAAA,QACjBE,MAAM;AAAA,MAAA;AAAA,IAEV,GAAG,CAACZ,GAAsBI,GAAoBT,CAAM,CAAC;AAAA,IAInDO,iBAAAA;AAAAA,IACAC,eAAAA;AAAAA,IACAP,YAAYA,CAACF,MAAmBE,EAAWF,GAAQC,CAAM;AAAA,IACzDF,UAAUA,CAACC,MAAmBD,EAASC,GAAQC,CAAM;AAAA,EAAA;AAEzD;"}

package/dist/{index214.js → index213.js}

@@ -4,4 +4,4 @@ function n(e) {
 export {
   n as delay
 };
-//# sourceMappingURL=index214.js.map
+//# sourceMappingURL=index213.js.map

package/dist/{index214.js.map → index213.js.map}

@@ -1 +1 @@
-{"version":3,"file":"index214.js","sources":["../src/utils/delay.ts"],"sourcesContent":["/**\n * Delays execution by the specified number of milliseconds\n * @param ms - The number of milliseconds to delay\n * @returns A Promise that resolves after the specified delay\n */\nexport function delay(ms: number): Promise<void> {\n    return new Promise(resolve => setTimeout(resolve, ms));\n} "],"names":["delay","ms","Promise","resolve","setTimeout"],"mappings":"AAKO,SAASA,EAAMC,GAA2B;AAC7C,SAAO,IAAIC,QAAQC,CAAAA,MAAWC,WAAWD,GAASF,CAAE,CAAC;AACzD;"}
+{"version":3,"file":"index213.js","sources":["../src/utils/delay.ts"],"sourcesContent":["/**\n * Delays execution by the specified number of milliseconds\n * @param ms - The number of milliseconds to delay\n * @returns A Promise that resolves after the specified delay\n */\nexport function delay(ms: number): Promise<void> {\n    return new Promise(resolve => setTimeout(resolve, ms));\n} "],"names":["delay","ms","Promise","resolve","setTimeout"],"mappings":"AAKO,SAASA,EAAMC,GAA2B;AAC7C,SAAO,IAAIC,QAAQC,CAAAA,MAAWC,WAAWD,GAASF,CAAE,CAAC;AACzD;"}

package/dist/index215.js

@@ -0,0 +1,65 @@
+import * as c from "react";
+function y({
+  itemIds: t,
+  tabIndex: h = 0,
+  defaultFocusedId: l,
+  orientation: f = "horizontal",
+  loop: u = !0,
+  onFocusChange: k
+}) {
+  const [a, x] = c.useState(l || t[0] || ""), g = c.useRef({});
+  c.useEffect(() => {
+    if (t.length > 0 && !t.includes(a)) {
+      const e = l || t[0] || "";
+      x(e);
+    }
+  }, [t, a, l]);
+  const p = c.useCallback((e) => {
+    x(e), k?.(e);
+  }, [k]), s = c.useCallback((e) => {
+    if (t.length === 0) return;
+    const o = t.indexOf(a), n = Math.max(0, o);
+    let r = n;
+    switch (e) {
+      case "first":
+        r = 0;
+        break;
+      case "last":
+        r = t.length - 1;
+        break;
+      case "prev":
+        u ? r = (n - 1 + t.length) % t.length : r = Math.max(0, n - 1);
+        break;
+      case "next":
+        u ? r = (n + 1) % t.length : r = Math.min(t.length - 1, n + 1);
+        break;
+    }
+    const v = t[r];
+    v && g.current[v]?.focus();
+  }, [t, a, u]), b = c.useCallback((e) => ({
+    ref: (o) => {
+      g.current[e] = o;
+    },
+    tabIndex: a === e ? h : -1
+  }), [a, h]), w = c.useCallback((e) => {
+    if (e.key === "Home") {
+      e.preventDefault(), s("first");
+      return;
+    }
+    if (e.key === "End") {
+      e.preventDefault(), s("last");
+      return;
+    }
+    const o = f === "horizontal" ? "ArrowLeft" : "ArrowUp", n = f === "horizontal" ? "ArrowRight" : "ArrowDown";
+    e.key === o ? (e.preventDefault(), s("prev")) : e.key === n && (e.preventDefault(), s("next"));
+  }, [f, s]);
+  return {
+    setFocusedId: p,
+    handleKeyDown: w,
+    getRovingItemProps: b
+  };
+}
+export {
+  y as useRovingFocus
+};
+//# sourceMappingURL=index215.js.map

package/dist/index215.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index215.js","sources":["../src/utils/a11y/useRovingFocus.ts"],"sourcesContent":["import * as React from 'react';\n\nexport type RovingDirection = 'prev' | 'next' | 'first' | 'last';\n\nexport interface UseRovingFocusOptions {\n  /**\n   * Array of item IDs in order\n   */\n  itemIds: string[];\n\n  /**\n   * The tabIndex to apply to the currently focused item in the roving group.\n   * Defaults to 0 \n   */\n  tabIndex?: number;\n\n  /**\n   * Initial focused item ID. Defaults to first item.\n   */\n  defaultFocusedId?: string;\n\n  /**\n   * Orientation for arrow key mapping.\n   * - horizontal: ArrowLeft/ArrowRight\n   * - vertical: ArrowUp/ArrowDown\n   */\n  orientation?: 'horizontal' | 'vertical';\n\n  /**\n   * Whether navigation wraps around at ends. Defaults to true.\n   */\n  loop?: boolean;\n\n  /**\n   * Callback when focus changes\n   */\n  onFocusChange?: (id: string) => void;\n}\n\nexport interface RovingItemProps {\n  ref: (el: HTMLElement | null) => void;\n  tabIndex: number;\n}\n\nexport interface UseRovingFocusReturn {\n  /**\n   * Set focused item ID manually\n   */\n  setFocusedId: (id: string) => void;\n\n  /**\n   * Keyboard handler for arrow/Home/End navigation.\n   * Attach to each item's onKeyDown.\n   */\n  handleKeyDown: (e: React.KeyboardEvent) => void;\n\n  /**\n   * Get props for an item in the roving focus group (ref + tabIndex)\n   */\n  getRovingItemProps: (id: string) => RovingItemProps;\n}\n\n/**\n * Hook for managing roving focus pattern (roving tabindex).\n * Reusable for composite widgets: tabs, toolbars, menus, listboxes, radio groups.\n *\n * @example\n * const { getRovingItemProps, handleKeyDown } = useRovingFocus({\n *   itemIds: ['tab1', 'tab2', 'tab3'],\n *   orientation: 'horizontal'\n * });\n *\n * // In render:\n * <button {...getRovingItemProps('tab1')} onKeyDown={handleKeyDown}>Tab 1</button>\n */\nexport function useRovingFocus({\n  itemIds,\n  tabIndex = 0,\n  defaultFocusedId,\n  orientation = 'horizontal',\n  loop = true,\n  onFocusChange\n}: UseRovingFocusOptions): UseRovingFocusReturn {\n  const [focusedId, setFocusedIdState] = React.useState<string>(\n    defaultFocusedId || itemIds[0] || ''\n  );\n\n  const itemRefs = React.useRef<Record<string, HTMLElement | null>>({});\n\n  // Sync focusedId if itemIds change and current focusedId is no longer valid\n  React.useEffect(() => {\n    if (itemIds.length > 0 && !itemIds.includes(focusedId)) {\n      const newFocusedId = defaultFocusedId || itemIds[0] || '';\n      setFocusedIdState(newFocusedId);\n    }\n  }, [itemIds, focusedId, defaultFocusedId]);\n\n  const setFocusedId = React.useCallback(\n    (id: string) => {\n      setFocusedIdState(id);\n      onFocusChange?.(id);\n    },\n    [onFocusChange]\n  );\n\n  const moveFocus = React.useCallback(\n    (direction: RovingDirection) => {\n      if (itemIds.length === 0) return;\n\n      const currentIdx = itemIds.indexOf(focusedId);\n      const safeIdx = Math.max(0, currentIdx);\n      let nextIdx = safeIdx;\n\n      switch (direction) {\n        case 'first':\n          nextIdx = 0;\n          break;\n        case 'last':\n          nextIdx = itemIds.length - 1;\n          break;\n        case 'prev':\n          if (loop) {\n            nextIdx = (safeIdx - 1 + itemIds.length) % itemIds.length;\n          } else {\n            nextIdx = Math.max(0, safeIdx - 1);\n          }\n          break;\n        case 'next':\n          if (loop) {\n            nextIdx = (safeIdx + 1) % itemIds.length;\n          } else {\n            nextIdx = Math.min(itemIds.length - 1, safeIdx + 1);\n          }\n          break;\n      }\n\n      const nextId = itemIds[nextIdx];\n      if (!nextId) return;\n\n      // Focus the element\n      itemRefs.current[nextId]?.focus();\n      // Note: We don't call setFocusedId here because the element's onFocus\n      // should handle that (follows \"focus follows DOM focus\" pattern)\n    },\n    [itemIds, focusedId, loop]\n  );\n\n  const getRovingItemProps = React.useCallback(\n    (id: string): RovingItemProps => ({\n      ref: (el: HTMLElement | null) => {\n        itemRefs.current[id] = el;\n      },\n      tabIndex: focusedId === id ? tabIndex : -1\n    }),\n    [focusedId, tabIndex]\n  );\n\n  // Keyboard handler for arrow/Home/End navigation\n  const handleKeyDown = React.useCallback(\n    (e: React.KeyboardEvent) => {\n      if (e.key === 'Home') {\n        e.preventDefault();\n        moveFocus('first');\n        return;\n      }\n      if (e.key === 'End') {\n        e.preventDefault();\n        moveFocus('last');\n        return;\n      }\n\n      const prevKey = orientation === 'horizontal' ? 'ArrowLeft' : 'ArrowUp';\n      const nextKey = orientation === 'horizontal' ? 'ArrowRight' : 'ArrowDown';\n\n      if (e.key === prevKey) {\n        e.preventDefault();\n        moveFocus('prev');\n      } else if (e.key === nextKey) {\n        e.preventDefault();\n        moveFocus('next');\n      }\n    },\n    [orientation, moveFocus]\n  );\n\n  return {\n    setFocusedId,\n    handleKeyDown,\n    getRovingItemProps\n  };\n}\n"],"names":["React","useRovingFocus","itemIds","tabIndex","defaultFocusedId","orientation","loop","onFocusChange","focusedId","setFocusedIdState","useState","itemRefs","useRef","useEffect","length","includes","newFocusedId","setFocusedId","useCallback","id","moveFocus","direction","currentIdx","indexOf","safeIdx","Math","max","nextIdx","min","nextId","current","focus","getRovingItemProps","ref","el","handleKeyDown","e","key","preventDefault","prevKey","nextKey"],"mappings":"AA2EO,YAAAA,OAAA;AAAA,SAASC,EAAe;AAAA,EAC7BC,SAAAA;AAAAA,EACAC,UAAAA,IAAW;AAAA,EACXC,kBAAAA;AAAAA,EACAC,aAAAA,IAAc;AAAA,EACdC,MAAAA,IAAO;AAAA,EACPC,eAAAA;AACqB,GAAyB;AAC9C,QAAM,CAACC,GAAWC,CAAiB,IAAIT,EAAMU,SAC3CN,KAAoBF,EAAQ,CAAC,KAAK,EACpC,GAEMS,IAAWX,EAAMY,OAA2C,EAAE;AAGpEZ,EAAAA,EAAMa,UAAU,MAAM;AACpB,QAAIX,EAAQY,SAAS,KAAK,CAACZ,EAAQa,SAASP,CAAS,GAAG;AACtD,YAAMQ,IAAeZ,KAAoBF,EAAQ,CAAC,KAAK;AACvDO,MAAAA,EAAkBO,CAAY;AAAA,IAChC;AAAA,EACF,GAAG,CAACd,GAASM,GAAWJ,CAAgB,CAAC;AAEzC,QAAMa,IAAejB,EAAMkB,YACzB,CAACC,MAAe;AACdV,IAAAA,EAAkBU,CAAE,GACpBZ,IAAgBY,CAAE;AAAA,EACpB,GACA,CAACZ,CAAa,CAChB,GAEMa,IAAYpB,EAAMkB,YACtB,CAACG,MAA+B;AAC9B,QAAInB,EAAQY,WAAW,EAAG;AAE1B,UAAMQ,IAAapB,EAAQqB,QAAQf,CAAS,GACtCgB,IAAUC,KAAKC,IAAI,GAAGJ,CAAU;AACtC,QAAIK,IAAUH;AAEd,YAAQH,GAAAA;AAAAA,MACN,KAAK;AACHM,QAAAA,IAAU;AACV;AAAA,MACF,KAAK;AACHA,QAAAA,IAAUzB,EAAQY,SAAS;AAC3B;AAAA,MACF,KAAK;AACH,QAAIR,IACFqB,KAAWH,IAAU,IAAItB,EAAQY,UAAUZ,EAAQY,SAEnDa,IAAUF,KAAKC,IAAI,GAAGF,IAAU,CAAC;AAEnC;AAAA,MACF,KAAK;AACH,QAAIlB,IACFqB,KAAWH,IAAU,KAAKtB,EAAQY,SAElCa,IAAUF,KAAKG,IAAI1B,EAAQY,SAAS,GAAGU,IAAU,CAAC;AAEpD;AAAA,IAAA;AAGJ,UAAMK,IAAS3B,EAAQyB,CAAO;AAC9B,IAAKE,KAGLlB,EAASmB,QAAQD,CAAM,GAAGE,MAAAA;AAAAA,EAG5B,GACA,CAAC7B,GAASM,GAAWF,CAAI,CAC3B,GAEM0B,IAAqBhC,EAAMkB,YAC/B,CAACC,OAAiC;AAAA,IAChCc,KAAKA,CAACC,MAA2B;AAC/BvB,MAAAA,EAASmB,QAAQX,CAAE,IAAIe;AAAAA,IACzB;AAAA,IACA/B,UAAUK,MAAcW,IAAKhB,IAAW;AAAA,EAAA,IAE1C,CAACK,GAAWL,CAAQ,CACtB,GAGMgC,IAAgBnC,EAAMkB,YAC1B,CAACkB,MAA2B;AAC1B,QAAIA,EAAEC,QAAQ,QAAQ;AACpBD,QAAEE,eAAAA,GACFlB,EAAU,OAAO;AACjB;AAAA,IACF;AACA,QAAIgB,EAAEC,QAAQ,OAAO;AACnBD,QAAEE,eAAAA,GACFlB,EAAU,MAAM;AAChB;AAAA,IACF;AAEA,UAAMmB,IAAUlC,MAAgB,eAAe,cAAc,WACvDmC,IAAUnC,MAAgB,eAAe,eAAe;AAE9D,IAAI+B,EAAEC,QAAQE,KACZH,EAAEE,eAAAA,GACFlB,EAAU,MAAM,KACPgB,EAAEC,QAAQG,MACnBJ,EAAEE,eAAAA,GACFlB,EAAU,MAAM;AAAA,EAEpB,GACA,CAACf,GAAae,CAAS,CACzB;AAEA,SAAO;AAAA,IACLH,cAAAA;AAAAA,IACAkB,eAAAA;AAAAA,IACAH,oBAAAA;AAAAA,EAAAA;AAEJ;"}

package/dist/index216.js

@@ -1,65 +1,8 @@
-import * as c from "react";
-function y({
-  itemIds: t,
-  tabIndex: h = 0,
-  defaultFocusedId: l,
-  orientation: f = "horizontal",
-  loop: u = !0,
-  onFocusChange: k
-}) {
-  const [a, x] = c.useState(l || t[0] || ""), g = c.useRef({});
-  c.useEffect(() => {
-    if (t.length > 0 && !t.includes(a)) {
-      const e = l || t[0] || "";
-      x(e);
-    }
-  }, [t, a, l]);
-  const p = c.useCallback((e) => {
-    x(e), k?.(e);
-  }, [k]), s = c.useCallback((e) => {
-    if (t.length === 0) return;
-    const o = t.indexOf(a), n = Math.max(0, o);
-    let r = n;
-    switch (e) {
-      case "first":
-        r = 0;
-        break;
-      case "last":
-        r = t.length - 1;
-        break;
-      case "prev":
-        u ? r = (n - 1 + t.length) % t.length : r = Math.max(0, n - 1);
-        break;
-      case "next":
-        u ? r = (n + 1) % t.length : r = Math.min(t.length - 1, n + 1);
-        break;
-    }
-    const v = t[r];
-    v && g.current[v]?.focus();
-  }, [t, a, u]), b = c.useCallback((e) => ({
-    ref: (o) => {
-      g.current[e] = o;
-    },
-    tabIndex: a === e ? h : -1
-  }), [a, h]), w = c.useCallback((e) => {
-    if (e.key === "Home") {
-      e.preventDefault(), s("first");
-      return;
-    }
-    if (e.key === "End") {
-      e.preventDefault(), s("last");
-      return;
-    }
-    const o = f === "horizontal" ? "ArrowLeft" : "ArrowUp", n = f === "horizontal" ? "ArrowRight" : "ArrowDown";
-    e.key === o ? (e.preventDefault(), s("prev")) : e.key === n && (e.preventDefault(), s("next"));
-  }, [f, s]);
-  return {
-    setFocusedId: p,
-    handleKeyDown: w,
-    getRovingItemProps: b
-  };
-}
+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 {
-  y as useRovingFocus
+  o as isVirtualClick
 };
 //# sourceMappingURL=index216.js.map

package/dist/index216.js.map

@@ -1 +1 @@
-{"version":3,"file":"index216.js","sources":["../src/utils/a11y/useRovingFocus.ts"],"sourcesContent":["import * as React from 'react';\n\nexport type RovingDirection = 'prev' | 'next' | 'first' | 'last';\n\nexport interface UseRovingFocusOptions {\n  /**\n   * Array of item IDs in order\n   */\n  itemIds: string[];\n\n  /**\n   * The tabIndex to apply to the currently focused item in the roving group.\n   * Defaults to 0 \n   */\n  tabIndex?: number;\n\n  /**\n   * Initial focused item ID. Defaults to first item.\n   */\n  defaultFocusedId?: string;\n\n  /**\n   * Orientation for arrow key mapping.\n   * - horizontal: ArrowLeft/ArrowRight\n   * - vertical: ArrowUp/ArrowDown\n   */\n  orientation?: 'horizontal' | 'vertical';\n\n  /**\n   * Whether navigation wraps around at ends. Defaults to true.\n   */\n  loop?: boolean;\n\n  /**\n   * Callback when focus changes\n   */\n  onFocusChange?: (id: string) => void;\n}\n\nexport interface RovingItemProps {\n  ref: (el: HTMLElement | null) => void;\n  tabIndex: number;\n}\n\nexport interface UseRovingFocusReturn {\n  /**\n   * Set focused item ID manually\n   */\n  setFocusedId: (id: string) => void;\n\n  /**\n   * Keyboard handler for arrow/Home/End navigation.\n   * Attach to each item's onKeyDown.\n   */\n  handleKeyDown: (e: React.KeyboardEvent) => void;\n\n  /**\n   * Get props for an item in the roving focus group (ref + tabIndex)\n   */\n  getRovingItemProps: (id: string) => RovingItemProps;\n}\n\n/**\n * Hook for managing roving focus pattern (roving tabindex).\n * Reusable for composite widgets: tabs, toolbars, menus, listboxes, radio groups.\n *\n * @example\n * const { getRovingItemProps, handleKeyDown } = useRovingFocus({\n *   itemIds: ['tab1', 'tab2', 'tab3'],\n *   orientation: 'horizontal'\n * });\n *\n * // In render:\n * <button {...getRovingItemProps('tab1')} onKeyDown={handleKeyDown}>Tab 1</button>\n */\nexport function useRovingFocus({\n  itemIds,\n  tabIndex = 0,\n  defaultFocusedId,\n  orientation = 'horizontal',\n  loop = true,\n  onFocusChange\n}: UseRovingFocusOptions): UseRovingFocusReturn {\n  const [focusedId, setFocusedIdState] = React.useState<string>(\n    defaultFocusedId || itemIds[0] || ''\n  );\n\n  const itemRefs = React.useRef<Record<string, HTMLElement | null>>({});\n\n  // Sync focusedId if itemIds change and current focusedId is no longer valid\n  React.useEffect(() => {\n    if (itemIds.length > 0 && !itemIds.includes(focusedId)) {\n      const newFocusedId = defaultFocusedId || itemIds[0] || '';\n      setFocusedIdState(newFocusedId);\n    }\n  }, [itemIds, focusedId, defaultFocusedId]);\n\n  const setFocusedId = React.useCallback(\n    (id: string) => {\n      setFocusedIdState(id);\n      onFocusChange?.(id);\n    },\n    [onFocusChange]\n  );\n\n  const moveFocus = React.useCallback(\n    (direction: RovingDirection) => {\n      if (itemIds.length === 0) return;\n\n      const currentIdx = itemIds.indexOf(focusedId);\n      const safeIdx = Math.max(0, currentIdx);\n      let nextIdx = safeIdx;\n\n      switch (direction) {\n        case 'first':\n          nextIdx = 0;\n          break;\n        case 'last':\n          nextIdx = itemIds.length - 1;\n          break;\n        case 'prev':\n          if (loop) {\n            nextIdx = (safeIdx - 1 + itemIds.length) % itemIds.length;\n          } else {\n            nextIdx = Math.max(0, safeIdx - 1);\n          }\n          break;\n        case 'next':\n          if (loop) {\n            nextIdx = (safeIdx + 1) % itemIds.length;\n          } else {\n            nextIdx = Math.min(itemIds.length - 1, safeIdx + 1);\n          }\n          break;\n      }\n\n      const nextId = itemIds[nextIdx];\n      if (!nextId) return;\n\n      // Focus the element\n      itemRefs.current[nextId]?.focus();\n      // Note: We don't call setFocusedId here because the element's onFocus\n      // should handle that (follows \"focus follows DOM focus\" pattern)\n    },\n    [itemIds, focusedId, loop]\n  );\n\n  const getRovingItemProps = React.useCallback(\n    (id: string): RovingItemProps => ({\n      ref: (el: HTMLElement | null) => {\n        itemRefs.current[id] = el;\n      },\n      tabIndex: focusedId === id ? tabIndex : -1\n    }),\n    [focusedId, tabIndex]\n  );\n\n  // Keyboard handler for arrow/Home/End navigation\n  const handleKeyDown = React.useCallback(\n    (e: React.KeyboardEvent) => {\n      if (e.key === 'Home') {\n        e.preventDefault();\n        moveFocus('first');\n        return;\n      }\n      if (e.key === 'End') {\n        e.preventDefault();\n        moveFocus('last');\n        return;\n      }\n\n      const prevKey = orientation === 'horizontal' ? 'ArrowLeft' : 'ArrowUp';\n      const nextKey = orientation === 'horizontal' ? 'ArrowRight' : 'ArrowDown';\n\n      if (e.key === prevKey) {\n        e.preventDefault();\n        moveFocus('prev');\n      } else if (e.key === nextKey) {\n        e.preventDefault();\n        moveFocus('next');\n      }\n    },\n    [orientation, moveFocus]\n  );\n\n  return {\n    setFocusedId,\n    handleKeyDown,\n    getRovingItemProps\n  };\n}\n"],"names":["React","useRovingFocus","itemIds","tabIndex","defaultFocusedId","orientation","loop","onFocusChange","focusedId","setFocusedIdState","useState","itemRefs","useRef","useEffect","length","includes","newFocusedId","setFocusedId","useCallback","id","moveFocus","direction","currentIdx","indexOf","safeIdx","Math","max","nextIdx","min","nextId","current","focus","getRovingItemProps","ref","el","handleKeyDown","e","key","preventDefault","prevKey","nextKey"],"mappings":"AA2EO,YAAAA,OAAA;AAAA,SAASC,EAAe;AAAA,EAC7BC,SAAAA;AAAAA,EACAC,UAAAA,IAAW;AAAA,EACXC,kBAAAA;AAAAA,EACAC,aAAAA,IAAc;AAAA,EACdC,MAAAA,IAAO;AAAA,EACPC,eAAAA;AACqB,GAAyB;AAC9C,QAAM,CAACC,GAAWC,CAAiB,IAAIT,EAAMU,SAC3CN,KAAoBF,EAAQ,CAAC,KAAK,EACpC,GAEMS,IAAWX,EAAMY,OAA2C,EAAE;AAGpEZ,EAAAA,EAAMa,UAAU,MAAM;AACpB,QAAIX,EAAQY,SAAS,KAAK,CAACZ,EAAQa,SAASP,CAAS,GAAG;AACtD,YAAMQ,IAAeZ,KAAoBF,EAAQ,CAAC,KAAK;AACvDO,MAAAA,EAAkBO,CAAY;AAAA,IAChC;AAAA,EACF,GAAG,CAACd,GAASM,GAAWJ,CAAgB,CAAC;AAEzC,QAAMa,IAAejB,EAAMkB,YACzB,CAACC,MAAe;AACdV,IAAAA,EAAkBU,CAAE,GACpBZ,IAAgBY,CAAE;AAAA,EACpB,GACA,CAACZ,CAAa,CAChB,GAEMa,IAAYpB,EAAMkB,YACtB,CAACG,MAA+B;AAC9B,QAAInB,EAAQY,WAAW,EAAG;AAE1B,UAAMQ,IAAapB,EAAQqB,QAAQf,CAAS,GACtCgB,IAAUC,KAAKC,IAAI,GAAGJ,CAAU;AACtC,QAAIK,IAAUH;AAEd,YAAQH,GAAAA;AAAAA,MACN,KAAK;AACHM,QAAAA,IAAU;AACV;AAAA,MACF,KAAK;AACHA,QAAAA,IAAUzB,EAAQY,SAAS;AAC3B;AAAA,MACF,KAAK;AACH,QAAIR,IACFqB,KAAWH,IAAU,IAAItB,EAAQY,UAAUZ,EAAQY,SAEnDa,IAAUF,KAAKC,IAAI,GAAGF,IAAU,CAAC;AAEnC;AAAA,MACF,KAAK;AACH,QAAIlB,IACFqB,KAAWH,IAAU,KAAKtB,EAAQY,SAElCa,IAAUF,KAAKG,IAAI1B,EAAQY,SAAS,GAAGU,IAAU,CAAC;AAEpD;AAAA,IAAA;AAGJ,UAAMK,IAAS3B,EAAQyB,CAAO;AAC9B,IAAKE,KAGLlB,EAASmB,QAAQD,CAAM,GAAGE,MAAAA;AAAAA,EAG5B,GACA,CAAC7B,GAASM,GAAWF,CAAI,CAC3B,GAEM0B,IAAqBhC,EAAMkB,YAC/B,CAACC,OAAiC;AAAA,IAChCc,KAAKA,CAACC,MAA2B;AAC/BvB,MAAAA,EAASmB,QAAQX,CAAE,IAAIe;AAAAA,IACzB;AAAA,IACA/B,UAAUK,MAAcW,IAAKhB,IAAW;AAAA,EAAA,IAE1C,CAACK,GAAWL,CAAQ,CACtB,GAGMgC,IAAgBnC,EAAMkB,YAC1B,CAACkB,MAA2B;AAC1B,QAAIA,EAAEC,QAAQ,QAAQ;AACpBD,QAAEE,eAAAA,GACFlB,EAAU,OAAO;AACjB;AAAA,IACF;AACA,QAAIgB,EAAEC,QAAQ,OAAO;AACnBD,QAAEE,eAAAA,GACFlB,EAAU,MAAM;AAChB;AAAA,IACF;AAEA,UAAMmB,IAAUlC,MAAgB,eAAe,cAAc,WACvDmC,IAAUnC,MAAgB,eAAe,eAAe;AAE9D,IAAI+B,EAAEC,QAAQE,KACZH,EAAEE,eAAAA,GACFlB,EAAU,MAAM,KACPgB,EAAEC,QAAQG,MACnBJ,EAAEE,eAAAA,GACFlB,EAAU,MAAM;AAAA,EAEpB,GACA,CAACf,GAAae,CAAS,CACzB;AAEA,SAAO;AAAA,IACLH,cAAAA;AAAAA,IACAkB,eAAAA;AAAAA,IACAH,oBAAAA;AAAAA,EAAAA;AAEJ;"}
+{"version":3,"file":"index216.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/index217.js

@@ -1,8 +1,13 @@
-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;
-};
+function r(t, i) {
+  if (t == null) return {};
+  var o = {};
+  for (var e in t) if ({}.hasOwnProperty.call(t, e)) {
+    if (i.indexOf(e) !== -1) continue;
+    o[e] = t[e];
+  }
+  return o;
+}
 export {
-  o as isVirtualClick
+  r as default
 };
 //# sourceMappingURL=index217.js.map

package/dist/index217.js.map

@@ -1 +1 @@
-{"version":3,"file":"index217.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;"}
+{"version":3,"file":"index217.js","sources":["../node_modules/@babel/runtime/helpers/esm/objectWithoutPropertiesLoose.js"],"sourcesContent":["function _objectWithoutPropertiesLoose(r, e) {\n  if (null == r) return {};\n  var t = {};\n  for (var n in r) if ({}.hasOwnProperty.call(r, n)) {\n    if (-1 !== e.indexOf(n)) continue;\n    t[n] = r[n];\n  }\n  return t;\n}\nexport { _objectWithoutPropertiesLoose as default };"],"names":["_objectWithoutPropertiesLoose","r","e","t","n"],"mappings":"AAAA,SAASA,EAA8BC,GAAGC,GAAG;AAC3C,MAAYD,KAAR,KAAW,QAAO,CAAA;AACtB,MAAIE,IAAI,CAAA;AACR,WAASC,KAAKH,EAAG,KAAI,CAAA,EAAG,eAAe,KAAKA,GAAGG,CAAC,GAAG;AACjD,QAAWF,EAAE,QAAQE,CAAC,MAAlB,GAAqB;AACzB,IAAAD,EAAEC,CAAC,IAAIH,EAAEG,CAAC;AAAA,EACZ;AACA,SAAOD;AACT;","x_google_ignoreList":[0]}

package/dist/index218.js

@@ -1,25 +1,13 @@
-const l = ["button:not([disabled])", "[href]", "input:not([disabled])", "select:not([disabled])", "textarea:not([disabled])", '[tabindex]:not([tabindex="-1"]):not([disabled])', '[contenteditable="true"]'].join(", "), a = [l, '[role="menuitem"]', '[role="option"]', '[role="menuitemcheckbox"]', '[role="menuitemradio"]'].join(", ");
-function u({
-  container: e,
-  includeRoles: t = !1,
-  additionalSelectors: r = [],
-  filterHidden: s = !1
-}) {
-  if (!e) return [];
-  const d = [t ? a : l, ...r].filter(Boolean).join(", "), i = Array.from(e.querySelectorAll(d));
-  return s ? i.filter((n) => {
-    const o = window.getComputedStyle(n);
-    return o.display !== "none" && o.visibility !== "hidden" && o.opacity !== "0" && !n.hasAttribute("hidden") && n.offsetWidth > 0 && n.offsetHeight > 0;
-  }) : i;
-}
-function c(e) {
-  const t = u(e);
-  return t.length > 0 ? t[0] : null;
+function e() {
+  return e = Object.assign ? Object.assign.bind() : function(t) {
+    for (var n = 1; n < arguments.length; n++) {
+      var a = arguments[n];
+      for (var r in a) ({}).hasOwnProperty.call(a, r) && (t[r] = a[r]);
+    }
+    return t;
+  }, e.apply(null, arguments);
 }
 export {
-  l as FOCUSABLE_SELECTOR,
-  a as FOCUSABLE_WITH_ROLES_SELECTOR,
-  c as getFirstFocusableElement,
-  u as getFocusableElements
+  e as default
 };
 //# sourceMappingURL=index218.js.map

package/dist/index218.js.map

@@ -1 +1 @@
-{"version":3,"file":"index218.js","sources":["../src/utils/a11y/focusableElements.ts"],"sourcesContent":["/**\n * Utilities for finding focusable elements within a container.\n * \n * Used for focus management in modals, popovers, and other interactive overlays.\n */\n\n/**\n * Base selector for standard focusable elements.\n * Matches: buttons, links, inputs, selects, textareas, elements with tabindex >= 0, contenteditable.\n */\nexport const FOCUSABLE_SELECTOR = [\n  'button:not([disabled])',\n  '[href]',\n  'input:not([disabled])',\n  'select:not([disabled])',\n  'textarea:not([disabled])',\n  '[tabindex]:not([tabindex=\"-1\"]):not([disabled])',\n  '[contenteditable=\"true\"]'\n].join(', ');\n\n/**\n * Extended selector that includes ARIA role-based focusable elements.\n * Useful for composite widgets like menus, listboxes, etc.\n */\nexport const FOCUSABLE_WITH_ROLES_SELECTOR = [\n  FOCUSABLE_SELECTOR,\n  '[role=\"menuitem\"]',\n  '[role=\"option\"]',\n  '[role=\"menuitemcheckbox\"]',\n  '[role=\"menuitemradio\"]'\n].join(', ');\n\n/**\n * Options for getFocusableElements\n */\nexport interface GetFocusableElementsOptions {\n  /**\n   * Container element to search within. If null/undefined, returns empty array.\n   */\n  container: HTMLElement | null;\n  /**\n   * Whether to include role-based focusable elements (menuitem, option, etc.).\n   * Default: false (uses base selector only)\n   */\n  includeRoles?: boolean;\n  /**\n   * Additional custom selectors to include.\n   */\n  additionalSelectors?: string[];\n  /**\n   * Whether to filter out hidden/invisible elements.\n   * Default: false (returns all matching elements regardless of visibility)\n   */\n  filterHidden?: boolean;\n}\n\n/**\n * Get all focusable elements within a container.\n * \n * @example Basic usage (standard focusable elements)\n * ```ts\n * const focusables = getFocusableElements({ container: dialogRef.current });\n * focusables[0]?.focus(); // Focus first element\n * ```\n * \n * @example With role-based elements (for menus/listboxes)\n * ```ts\n * const focusables = getFocusableElements({ \n *   container: menuRef.current,\n *   includeRoles: true \n * });\n * ```\n * \n * @example With custom selectors\n * ```ts\n * const focusables = getFocusableElements({ \n *   container: customWidgetRef.current,\n *   additionalSelectors: ['[data-focusable=\"true\"]']\n * });\n * ```\n */\nexport function getFocusableElements({\n  container,\n  includeRoles = false,\n  additionalSelectors = [],\n  filterHidden = false\n}: GetFocusableElementsOptions): HTMLElement[] {\n  if (!container) return [];\n\n  const selector = [\n    includeRoles ? FOCUSABLE_WITH_ROLES_SELECTOR : FOCUSABLE_SELECTOR,\n    ...additionalSelectors\n  ].filter(Boolean).join(', ');\n\n  const elements = Array.from(container.querySelectorAll<HTMLElement>(selector));\n\n  if (!filterHidden) return elements;\n\n  // Filter out hidden/invisible elements\n  return elements.filter((el) => {\n    const style = window.getComputedStyle(el);\n    return (\n      style.display !== 'none' &&\n      style.visibility !== 'hidden' &&\n      style.opacity !== '0' &&\n      !el.hasAttribute('hidden') &&\n      el.offsetWidth > 0 &&\n      el.offsetHeight > 0\n    );\n  });\n}\n\n/**\n * Get the first focusable element in a container.\n * Returns null if none found.\n */\nexport function getFirstFocusableElement(\n  options: GetFocusableElementsOptions\n): HTMLElement | null {\n  const focusables = getFocusableElements(options);\n  return focusables.length > 0 ? focusables[0] : null;\n}\n\n/**\n * Get the last focusable element in a container.\n * Returns null if none found.\n */\nexport function getLastFocusableElement(\n  options: GetFocusableElementsOptions\n): HTMLElement | null {\n  const focusables = getFocusableElements(options);\n  return focusables.length > 0 ? focusables[focusables.length - 1] : null;\n}\n"],"names":["FOCUSABLE_SELECTOR","join","FOCUSABLE_WITH_ROLES_SELECTOR","getFocusableElements","container","includeRoles","additionalSelectors","filterHidden","selector","filter","Boolean","elements","Array","from","querySelectorAll","el","style","window","getComputedStyle","display","visibility","opacity","hasAttribute","offsetWidth","offsetHeight","getFirstFocusableElement","options","focusables","length"],"mappings":"AAUO,MAAMA,IAAqB,CAChC,0BACA,UACA,yBACA,0BACA,4BACA,mDACA,0BAA0B,EAC1BC,KAAK,IAAI,GAMEC,IAAgC,CAC3CF,GACA,qBACA,mBACA,6BACA,wBAAwB,EACxBC,KAAK,IAAI;AAmDJ,SAASE,EAAqB;AAAA,EACnCC,WAAAA;AAAAA,EACAC,cAAAA,IAAe;AAAA,EACfC,qBAAAA,IAAsB,CAAA;AAAA,EACtBC,cAAAA,IAAe;AACY,GAAkB;AAC7C,MAAI,CAACH,EAAW,QAAO,CAAA;AAEvB,QAAMI,IAAW,CACfH,IAAeH,IAAgCF,GAC/C,GAAGM,CAAmB,EACtBG,OAAOC,OAAO,EAAET,KAAK,IAAI,GAErBU,IAAWC,MAAMC,KAAKT,EAAUU,iBAA8BN,CAAQ,CAAC;AAE7E,SAAKD,IAGEI,EAASF,OAAQM,CAAAA,MAAO;AAC7B,UAAMC,IAAQC,OAAOC,iBAAiBH,CAAE;AACxC,WACEC,EAAMG,YAAY,UAClBH,EAAMI,eAAe,YACrBJ,EAAMK,YAAY,OAClB,CAACN,EAAGO,aAAa,QAAQ,KACzBP,EAAGQ,cAAc,KACjBR,EAAGS,eAAe;AAAA,EAEtB,CAAC,IAbyBb;AAc5B;AAMO,SAASc,EACdC,GACoB;AACpB,QAAMC,IAAaxB,EAAqBuB,CAAO;AAC/C,SAAOC,EAAWC,SAAS,IAAID,EAAW,CAAC,IAAI;AACjD;"}
+{"version":3,"file":"index218.js","sources":["../node_modules/@babel/runtime/helpers/esm/extends.js"],"sourcesContent":["function _extends() {\n  return _extends = Object.assign ? Object.assign.bind() : function (n) {\n    for (var e = 1; e < arguments.length; e++) {\n      var t = arguments[e];\n      for (var r in t) ({}).hasOwnProperty.call(t, r) && (n[r] = t[r]);\n    }\n    return n;\n  }, _extends.apply(null, arguments);\n}\nexport { _extends as default };"],"names":["_extends","n","e","t"],"mappings":"AAAA,SAASA,IAAW;AAClB,SAAOA,IAAW,OAAO,SAAS,OAAO,OAAO,KAAI,IAAK,SAAUC,GAAG;AACpE,aAASC,IAAI,GAAGA,IAAI,UAAU,QAAQA,KAAK;AACzC,UAAIC,IAAI,UAAUD,CAAC;AACnB,eAAS,KAAKC,EAAG,EAAC,CAAA,GAAI,eAAe,KAAKA,GAAG,CAAC,MAAMF,EAAE,CAAC,IAAIE,EAAE,CAAC;AAAA,IAChE;AACA,WAAOF;AAAA,EACT,GAAGD,EAAS,MAAM,MAAM,SAAS;AACnC;","x_google_ignoreList":[0]}