se-design 1.1.1-dev → 1.1.1

package/dist/index230.js

@@ -1,24 +0,0 @@
-import { createContext as u, useRef as o, useCallback as s, useContext as c, useEffect as a } from "react";
-const f = /* @__PURE__ */ u(null);
-function l() {
-  const r = o(/* @__PURE__ */ new Set()), t = o([]);
-  return {
-    register: s((n) => (r.current.add(n), t.current = Array.from(r.current), () => {
-      r.current.delete(n), t.current = Array.from(r.current);
-    }), []),
-    portalContainerRefs: t
-  };
-}
-function p(r, t) {
-  const e = c(f);
-  a(() => {
-    if (!(!e || !t))
-      return e(r);
-  }, [e, t, r]);
-}
-export {
-  f as FocusTrapPortalContext,
-  l as useFocusTrapPortalRegistry,
-  p as useRegisterPortalWithFocusTrap
-};
-//# sourceMappingURL=index230.js.map

package/dist/index230.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index230.js","sources":["../src/utils/a11y/FocusTrapPortalContext.tsx"],"sourcesContent":["import { createContext, useCallback, useContext, useEffect, useRef } from 'react';\n\ntype RegisterPortal = (ref: React.RefObject<HTMLElement | null>) => () => void;\n\n/**\n * Context for portal content to register with the nearest focus trap.\n * When a Modal (or any focus trap owner) provides this context, portal-rendered\n * content (e.g., Popover with isWithPortal) can register its container ref so\n * the focus trap's safety net allows focus to move into it.\n */\nexport const FocusTrapPortalContext = createContext<RegisterPortal | null>(null);\n\n/**\n * Hook for the focus trap owner (Modal) to create a portal registration function\n * and a stable ref to the current list of portal container refs.\n *\n * Usage in Modal:\n * ```tsx\n * const { register, portalContainerRefs } = useFocusTrapPortalRegistry();\n * // Pass portalContainerRefs.current to useModalA11y\n * // Wrap children with <FocusTrapPortalContext.Provider value={register}>\n * ```\n */\nexport function useFocusTrapPortalRegistry() {\n  const portalRefsSet = useRef<Set<React.RefObject<HTMLElement | null>>>(new Set());\n  const portalContainerRefs = useRef<React.RefObject<HTMLElement | null>[]>([]);\n\n  const register: RegisterPortal = useCallback((ref) => {\n    portalRefsSet.current.add(ref);\n    portalContainerRefs.current = Array.from(portalRefsSet.current);\n    return () => {\n      portalRefsSet.current.delete(ref);\n      portalContainerRefs.current = Array.from(portalRefsSet.current);\n    };\n  }, []);\n\n  return { register, portalContainerRefs };\n}\n\n/**\n * Hook for portal content (Popover) to register its container ref with the\n * nearest ancestor focus trap. No-op if there is no focus trap ancestor.\n *\n * @param portalRef - Ref to the portal's root DOM element\n * @param isActive - Whether the portal is currently mounted and should be registered\n */\nexport function useRegisterPortalWithFocusTrap(\n  portalRef: React.RefObject<HTMLElement | null>,\n  isActive: boolean\n) {\n  const register = useContext(FocusTrapPortalContext);\n\n  useEffect(() => {\n    if (!register || !isActive) return;\n    return register(portalRef);\n  }, [register, isActive, portalRef]);\n}\n"],"names":["createContext","useRef","useCallback","useContext","useEffect","FocusTrapPortalContext","useFocusTrapPortalRegistry","portalRefsSet","Set","portalContainerRefs","register","ref","current","add","Array","from","delete","useRegisterPortalWithFocusTrap","portalRef","isActive"],"mappings":"AAUO,SAAA,iBAAAA,GAAA,UAAAC,GAAA,eAAAC,GAAA,cAAAC,GAAA,aAAAC,SAAA;AAAA,MAAMC,sBAA8D,IAAI;AAaxE,SAASC,IAA6B;AAC3C,QAAMC,IAAgBN,EAAiD,oBAAIO,KAAK,GAC1EC,IAAsBR,EAA8C,EAAE;AAW5E,SAAO;AAAA,IAAES,UATwBR,EAAaS,CAAAA,OAC5CJ,EAAcK,QAAQC,IAAIF,CAAG,GAC7BF,EAAoBG,UAAUE,MAAMC,KAAKR,EAAcK,OAAO,GACvD,MAAM;AACXL,MAAAA,EAAcK,QAAQI,OAAOL,CAAG,GAChCF,EAAoBG,UAAUE,MAAMC,KAAKR,EAAcK,OAAO;AAAA,IAChE,IACC,CAAA,CAAE;AAAA,IAEcH,qBAAAA;AAAAA,EAAAA;AACrB;AASO,SAASQ,EACdC,GACAC,GACA;AACA,QAAMT,IAAWP,EAAWE,CAAsB;AAElDD,EAAAA,EAAU,MAAM;AACd,QAAI,GAACM,KAAY,CAACS;AAClB,aAAOT,EAASQ,CAAS;AAAA,EAC3B,GAAG,CAACR,GAAUS,GAAUD,CAAS,CAAC;AACpC;"}

package/dist/index238.js

@@ -1,75 +0,0 @@
-import { useRef as a, useLayoutEffect as m, useEffect as g } from "react";
-import { getFirstFocusableElement as d, getLastFocusableElement as F } from "./index77.js";
-import { consumeFocusAnchor as I, consumeLastInteractedElement as E } from "./index78.js";
-const f = {
-  position: "absolute",
-  opacity: 0,
-  pointerEvents: "none",
-  width: 0,
-  height: 0
-};
-function T({
-  isOpen: o,
-  isModal: i,
-  containerRef: e,
-  returnFocusRef: l
-}) {
-  const c = a(null), r = a(null), u = a(null);
-  return m(() => {
-    if (i || !o) return;
-    const t = l?.current ?? I() ?? E() ?? document.activeElement;
-    if (!(!t || t === document.body) && t.tagName !== "IFRAME")
-      return c.current = t, u.current && (u.current.tabIndex = 0), () => {
-        u.current && (u.current.tabIndex = -1);
-      };
-  }, [o, i]), g(() => {
-    if (i || !o || !c.current) return;
-    const t = requestAnimationFrame(() => {
-      (d({
-        container: e.current
-      }) ?? e.current)?.focus(), r.current && (r.current.tabIndex = 0);
-    });
-    return () => {
-      cancelAnimationFrame(t), r.current && (r.current.tabIndex = -1);
-      const s = c.current;
-      c.current = null, s?.isConnected && requestAnimationFrame(() => s.focus());
-    };
-  }, [o, i]), {
-    startSentinelProps: {
-      ref: r,
-      tabIndex: -1,
-      style: f,
-      "aria-hidden": !0,
-      "data-focus-sentinel": "start",
-      onFocus: (t) => {
-        if (e.current?.contains(t.relatedTarget) && t.relatedTarget !== e.current) {
-          const n = c.current;
-          n?.isConnected && n.focus();
-        } else
-          r.current && (r.current.tabIndex = -1), (d({
-            container: e.current
-          }) ?? e.current)?.focus();
-      }
-    },
-    endSentinelProps: {
-      ref: u,
-      tabIndex: -1,
-      style: f,
-      "aria-hidden": !0,
-      "data-focus-sentinel": "end",
-      onFocus: (t) => {
-        if (e.current?.contains(t.relatedTarget) && t.relatedTarget !== e.current) {
-          const n = c.current;
-          n?.isConnected && n.focus();
-        } else
-          (F({
-            container: e.current
-          }) ?? e.current)?.focus();
-      }
-    }
-  };
-}
-export {
-  T as useFocusSentinel
-};
-//# sourceMappingURL=index238.js.map

package/dist/index238.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index238.js","sources":["../src/utils/a11y/useFocusSentinel.ts"],"sourcesContent":["import { useRef, useEffect, useLayoutEffect } from 'react';\n\nimport { getFirstFocusableElement, getLastFocusableElement } from './focusableElements';\nimport { consumeLastInteractedElement, consumeFocusAnchor } from './useFocusTrap';\n\nconst SENTINEL_STYLE: React.CSSProperties = {\n  position: 'absolute',\n  opacity: 0,\n  pointerEvents: 'none',\n  width: 0,\n  height: 0,\n};\n\nexport interface UseFocusSentinelOptions {\n  /** Whether the panel is currently open. */\n  isOpen: boolean | undefined;\n  /**\n   * When true the hook is a no-op — dialog mode (focus trap) handles focus management instead.\n   */\n  isModal: boolean;\n  /** Ref to the panel container element. */\n  containerRef: React.RefObject<HTMLElement | null>;\n  /**\n   * Explicit element to restore focus to on close.\n   * Overrides the automatic trigger capture.\n   */\n  returnFocusRef?: React.RefObject<HTMLElement | null>;\n}\n\nexport interface SentinelProps {\n  ref: React.RefObject<HTMLDivElement | null>;\n  tabIndex: number;\n  style: React.CSSProperties;\n  'aria-hidden': true;\n  'data-focus-sentinel': 'start' | 'end';\n  onFocus: (e: React.FocusEvent) => void;\n}\n\nexport interface UseFocusSentinelReturn {\n  /** Spread onto an invisible div placed before the panel content. */\n  startSentinelProps: SentinelProps;\n  /** Spread onto an invisible div placed after the panel content. */\n  endSentinelProps: SentinelProps;\n}\n\n/**\n * Focus management for complementary (non-modal) side panels.\n *\n * Moves focus into the panel on open, restores it to the trigger on close,\n * and wraps Tab / Shift+Tab back to the trigger when focus reaches either end.\n *\n * Sentinel tabIndex values are mutated imperatively (no state) to avoid\n * re-renders. React does not touch a DOM attribute unless the JSX prop value\n * changes, so the initial tabIndex={-1} in the returned props is safe.\n */\nexport function useFocusSentinel({\n  isOpen,\n  isModal,\n  containerRef,\n  returnFocusRef,\n}: UseFocusSentinelOptions): UseFocusSentinelReturn {\n  const triggerRef = useRef<HTMLElement | null>(null);\n  const startSentinelRef = useRef<HTMLDivElement>(null);\n  const endSentinelRef = useRef<HTMLDivElement>(null);\n\n  // Capture trigger before React commits (document.activeElement is still the opener).\n  // Body focus = page-load open → skip so sentinels stay inert.\n  useLayoutEffect(() => {\n    if (isModal || !isOpen) return;\n    const trigger =\n      returnFocusRef?.current ??\n      consumeFocusAnchor() ??\n      consumeLastInteractedElement() ??\n      (document.activeElement as HTMLElement);\n    if (!trigger || trigger === document.body) return;\n    // iframes manage their own internal focus. The parent doc only sees the\n    // <iframe> element. Calling .focus() on any parent-doc element while the\n    // user is inside an iframe forcibly blurs the iframe content (kills caret\n    // on textareas, cancels native <select> dropdowns). Skip capture so the\n    // auto-focus on open and focus-restore on close don't run.\n    if (trigger.tagName === 'IFRAME') return;\n    triggerRef.current = trigger;\n    if (endSentinelRef.current) endSentinelRef.current.tabIndex = 0;\n    return () => {\n      if (endSentinelRef.current) endSentinelRef.current.tabIndex = -1;\n    };\n  }, [isOpen, isModal]);\n\n  // Move focus into panel on open; restore to trigger on close.\n  useEffect(() => {\n    if (isModal || !isOpen || !triggerRef.current) return;\n\n    const rafId = requestAnimationFrame(() => {\n      const first = getFirstFocusableElement({ container: containerRef.current });\n      (first ?? containerRef.current)?.focus();\n      // Activate start sentinel so Shift+Tab from first content returns to trigger.\n      if (startSentinelRef.current) startSentinelRef.current.tabIndex = 0;\n    });\n\n    return () => {\n      cancelAnimationFrame(rafId);\n      if (startSentinelRef.current) startSentinelRef.current.tabIndex = -1;\n      const trigger = triggerRef.current;\n      triggerRef.current = null;\n      if (trigger?.isConnected) {\n        requestAnimationFrame(() => trigger.focus());\n      }\n    };\n  }, [isOpen, isModal]);\n\n  const handleStartFocus = (e: React.FocusEvent) => {\n    const fromInside =\n      containerRef.current?.contains(e.relatedTarget as Node) &&\n      e.relatedTarget !== containerRef.current;\n    if (fromInside) {\n      // Shift+Tab from first content → restore trigger\n      const trigger = triggerRef.current;\n      if (trigger?.isConnected) trigger.focus();\n    } else {\n      // Natural Tab entry from outside → forward to first content,\n      // deactivate so next Shift+Tab exits naturally.\n      if (startSentinelRef.current) startSentinelRef.current.tabIndex = -1;\n      const first = getFirstFocusableElement({ container: containerRef.current });\n      (first ?? containerRef.current)?.focus();\n    }\n  };\n\n  const handleEndFocus = (e: React.FocusEvent) => {\n    const fromInside =\n      containerRef.current?.contains(e.relatedTarget as Node) &&\n      e.relatedTarget !== containerRef.current;\n    if (fromInside) {\n      // Tab from last content → restore trigger\n      const trigger = triggerRef.current;\n      if (trigger?.isConnected) trigger.focus();\n    } else {\n      // Shift+Tab entry from outside → back to last content\n      const last = getLastFocusableElement({ container: containerRef.current });\n      (last ?? containerRef.current)?.focus();\n    }\n  };\n\n  return {\n    startSentinelProps: {\n      ref: startSentinelRef,\n      tabIndex: -1,\n      style: SENTINEL_STYLE,\n      'aria-hidden': true as const,\n      'data-focus-sentinel': 'start' as const,\n      onFocus: handleStartFocus,\n    },\n    endSentinelProps: {\n      ref: endSentinelRef,\n      tabIndex: -1,\n      style: SENTINEL_STYLE,\n      'aria-hidden': true as const,\n      'data-focus-sentinel': 'end' as const,\n      onFocus: handleEndFocus,\n    },\n  };\n}\n"],"names":["useRef","useLayoutEffect","useEffect","getFirstFocusableElement","getLastFocusableElement","consumeFocusAnchor","consumeLastInteractedElement","SENTINEL_STYLE","position","opacity","pointerEvents","width","height","useFocusSentinel","isOpen","isModal","containerRef","returnFocusRef","triggerRef","startSentinelRef","endSentinelRef","trigger","current","document","activeElement","body","tagName","tabIndex","rafId","requestAnimationFrame","container","focus","cancelAnimationFrame","isConnected","startSentinelProps","ref","style","onFocus","handleStartFocus","e","contains","relatedTarget","endSentinelProps","handleEndFocus"],"mappings":"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"}

package/dist/index269.js

@@ -1,7 +0,0 @@
-function n(e) {
-  return new Promise((t) => setTimeout(t, e));
-}
-export {
-  n as delay
-};
-//# sourceMappingURL=index269.js.map

package/dist/index269.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index269.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/index88.js.map

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