se-design 1.0.90-dev.0 → 1.0.91-r-dev.1

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 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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"}
+{"version":3,"file":"index72.js","sources":["../src/utils/a11y/useAccessiblePress.ts"],"sourcesContent":["import * as React from 'react';\nimport { isVirtualClick } from '../virtualClick';\n\n/**\n * Hook for accessible press interactions (pointer vs keyboard vs virtual click).\n *\n * Handles:\n * - Pointer intent tracking (mouse/touch)\n * - Virtual click detection (NVDA browse mode, etc.)\n * - Routing to appropriate handler (onClick vs onKeyboardActivate)\n * - For non-native elements: Enter/Space → activation\n * - Optional stopPropagation and preventDefault\n *\n * @example\n * // Native button (isNative=true, the default)\n * const { pressProps } = useAccessiblePress({ onClick, disabled });\n * <button {...pressProps}>Click me</button>\n *\n * @example\n * // Non-native element (div acting as button)\n * const { pressProps, role, tabIndex } = useAccessiblePress({ onClick, isNative: false });\n * <div role={role} tabIndex={tabIndex} {...pressProps}>Click me</div>\n *\n * @example\n * // Element nested inside clickable parent (prevent event bubbling)\n * const { pressProps, tabIndex } = useAccessiblePress({ \n *   onClick, \n *   isNative: false, \n *   stopPropagation: true \n * });\n * <div role=\"button\" tabIndex={tabIndex} {...pressProps}>Click me</div>\n */\n\ntype InputKind = 'pointer' | 'keyboard' | 'virtual';\n\nexport type UseAccessiblePressOptions = {\n  /**\n   * Whether the element is disabled\n   */\n  disabled?: boolean;\n\n  /**\n   * Whether the element is in a loading state (will also disable)\n   */\n  loading?: boolean;\n\n  /**\n   * Handler for pointer/touch activations (or all activations if onKeyboardActivate is not provided)\n   */\n  onClick?: (e: React.MouseEvent<HTMLElement>) => void;\n\n  /**\n   * Handler for keyboard + assistive tech virtual activation.\n   * If omitted, onClick is used for all activations.\n   */\n  onKeyboardActivate?: (e: React.MouseEvent<HTMLElement>) => void;\n\n  /**\n   * If true, this is a native <button> (or other native pressable) and we MUST NOT add Enter/Space handling.\n   * Default: true\n   */\n  isNative?: boolean;\n\n  /**\n   * Only for non-native elements (div/span). Defaults to 'button'.\n   */\n  role?: string;\n\n  /**\n   * Only for non-native elements. Defaults to 0.\n   */\n  tabIndex?: number;\n\n  /**\n   * If true, calls e.stopPropagation() before invoking onClick handler.\n   * Useful when element is nested inside another clickable element.\n   * Default: false\n   */\n  stopPropagation?: boolean;\n\n  /**\n   * If true, calls e.preventDefault() before invoking onClick handler.\n   * Note: For non-native elements, preventDefault is already called on Space/Enter keys.\n   * Default: false\n   */\n  preventDefault?: boolean;\n\n  /**\n   * Toggle/pressed state. When true or false, sets aria-pressed on the element (e.g. selected color swatch).\n   * Omit for non-toggle buttons.\n   */\n  pressed?: boolean;\n\n  /**\n   * User-provided pointer/mouse/touch handlers. When provided, they are chained\n   * after the internal pointer-intent tracking handler (markPointer), so both run.\n   */\n  onPointerDown?: (e: React.PointerEvent<HTMLElement>) => void;\n  onMouseDown?: (e: React.MouseEvent<HTMLElement>) => void;\n  onTouchStart?: (e: React.TouchEvent<HTMLElement>) => void;\n};\n\nexport type UseAccessiblePressReturn = {\n  /**\n   * Props to spread onto the element. Includes event handlers and ARIA attributes.\n   * Does NOT include role/tabIndex — apply those separately.\n   */\n  pressProps: React.HTMLAttributes<HTMLElement> & {\n    'aria-disabled'?: 'true';\n    'aria-busy'?: 'true';\n    'aria-pressed'?: boolean;\n  };\n\n  /**\n   * Combined disabled state (disabled || loading)\n   */\n  isDisabled: boolean;\n\n  /**\n   * Role for non-native elements (e.g., 'button', 'menuitem').\n   * Only returned when isNative=false.\n   */\n  role?: string;\n\n  /**\n   * TabIndex for non-native elements.\n   * Returns -1 when disabled, otherwise the provided tabIndex (default 0).\n   * Only returned when isNative=false.\n   */\n  tabIndex?: number;\n};\n\nexport function useAccessiblePress({\n  disabled = false,\n  loading = false,\n  onClick,\n  onKeyboardActivate,\n  isNative = true,\n  role = 'button',\n  tabIndex = 0,\n  stopPropagation = false,\n  preventDefault = false,\n  pressed,\n  onPointerDown,\n  onMouseDown,\n  onTouchStart\n}: UseAccessiblePressOptions = {}): UseAccessiblePressReturn {\n  const isDisabled = disabled || loading;\n  const lastWasPointerRef = React.useRef(false);\n\n  const markPointer = React.useCallback(() => {\n    lastWasPointerRef.current = true;\n  }, []);\n\n  const handleClick = React.useCallback(\n    (e: React.MouseEvent<HTMLElement>) => {\n      if (isDisabled) return;\n\n      // Handle event control flags\n      if (stopPropagation) e.stopPropagation();\n      if (preventDefault) e.preventDefault();\n\n      const virtual = isVirtualClick(e.nativeEvent as any);\n      const isPointer = lastWasPointerRef.current;\n      lastWasPointerRef.current = false;\n\n      const input: InputKind = virtual ? 'virtual' : isPointer ? 'pointer' : 'keyboard';\n\n      // If we have a keyboard handler, route keyboard + virtual clicks there.\n      if ((input === 'keyboard' || input === 'virtual') && onKeyboardActivate) {\n        onKeyboardActivate(e);\n        return;\n      }\n\n      onClick?.(e);\n    },\n    [isDisabled, onClick, onKeyboardActivate, stopPropagation, preventDefault]\n  );\n\n  // Only used for non-native elements: Enter/Space should trigger click(), reusing the same click routing.\n  const handleKeyDown = React.useCallback(\n    (e: React.KeyboardEvent<HTMLElement>) => {\n      if (isDisabled) return;\n\n      if (e.key === 'Enter' || e.key === ' ') {\n        e.preventDefault();\n        // Trigger native click event so all routing goes through handleClick\n        (e.currentTarget as HTMLElement).click();\n      }\n    },\n    [isDisabled]\n  );\n\n  const pressProps: UseAccessiblePressReturn['pressProps'] = {\n    onPointerDown: onPointerDown\n      ? (e: React.PointerEvent<HTMLElement>) => { markPointer(); onPointerDown(e); }\n      : markPointer,\n    onMouseDown: onMouseDown\n      ? (e: React.MouseEvent<HTMLElement>) => { markPointer(); onMouseDown(e); }\n      : markPointer,\n    onTouchStart: onTouchStart\n      ? (e: React.TouchEvent<HTMLElement>) => { markPointer(); onTouchStart(e); }\n      : markPointer,\n    onClick: handleClick,\n    'aria-disabled': isDisabled ? 'true' : undefined,\n    'aria-busy': loading ? 'true' : undefined,\n    'aria-pressed': pressed\n  };\n\n  // For non-native elements, add Enter/Space handling\n  if (!isNative) {\n    pressProps.onKeyDown = handleKeyDown;\n  }\n\n  // Return role/tabIndex separately (only for non-native elements)\n  const result: UseAccessiblePressReturn = { pressProps, isDisabled };\n\n  if (!isNative) {\n    result.role = role;\n    result.tabIndex = isDisabled ? -1 : tabIndex;\n  }\n\n  return result;\n}\n\n"],"names":["React","isVirtualClick","useAccessiblePress","disabled","loading","onClick","onKeyboardActivate","isNative","role","tabIndex","stopPropagation","preventDefault","pressed","onPointerDown","onMouseDown","onTouchStart","isDisabled","lastWasPointerRef","useRef","markPointer","useCallback","current","handleClick","e","virtual","nativeEvent","isPointer","input","handleKeyDown","key","currentTarget","click","pressProps","undefined","onKeyDown","result"],"mappings":"AAoIO,YAAAA,OAAA;AAAA,SAAA,kBAAAC,SAAA;AAAA,SAASC,EAAmB;AAAA,EACjCC,UAAAA,IAAW;AAAA,EACXC,SAAAA,IAAU;AAAA,EACVC,SAAAA;AAAAA,EACAC,oBAAAA;AAAAA,EACAC,UAAAA,IAAW;AAAA,EACXC,MAAAA,IAAO;AAAA,EACPC,UAAAA,IAAW;AAAA,EACXC,iBAAAA,IAAkB;AAAA,EAClBC,gBAAAA,IAAiB;AAAA,EACjBC,SAAAA;AAAAA,EACAC,eAAAA;AAAAA,EACAC,aAAAA;AAAAA,EACAC,cAAAA;AACyB,IAAI,IAA8B;AAC3D,QAAMC,IAAab,KAAYC,GACzBa,IAAoBjB,EAAMkB,OAAO,EAAK,GAEtCC,IAAcnB,EAAMoB,YAAY,MAAM;AAC1CH,IAAAA,EAAkBI,UAAU;AAAA,EAC9B,GAAG,CAAA,CAAE,GAECC,IAActB,EAAMoB,YACxB,CAACG,MAAqC;AACpC,QAAIP,EAAY;AAGhB,IAAIN,OAAmBA,gBAAAA,GACnBC,OAAkBA,eAAAA;AAEtB,UAAMa,IAAUvB,EAAesB,EAAEE,WAAkB,GAC7CC,IAAYT,EAAkBI;AACpCJ,IAAAA,EAAkBI,UAAU;AAE5B,UAAMM,IAAmBH,IAAU,YAAYE,IAAY,YAAY;AAGvE,SAAKC,MAAU,cAAcA,MAAU,cAAcrB,GAAoB;AACvEA,MAAAA,EAAmBiB,CAAC;AACpB;AAAA,IACF;AAEAlB,IAAAA,IAAUkB,CAAC;AAAA,EACb,GACA,CAACP,GAAYX,GAASC,GAAoBI,GAAiBC,CAAc,CAC3E,GAGMiB,IAAgB5B,EAAMoB,YAC1B,CAACG,MAAwC;AACvC,IAAIP,MAEAO,EAAEM,QAAQ,WAAWN,EAAEM,QAAQ,SACjCN,EAAEZ,eAAAA,GAEDY,EAAEO,cAA8BC,MAAAA;AAAAA,EAErC,GACA,CAACf,CAAU,CACb,GAEMgB,IAAqD;AAAA,IACzDnB,eAAeA,IACX,CAACU,MAAuC;AAAEJ,MAAAA,EAAAA,GAAeN,EAAcU,CAAC;AAAA,IAAG,IAC3EJ;AAAAA,IACJL,aAAaA,IACT,CAACS,MAAqC;AAAEJ,MAAAA,EAAAA,GAAeL,EAAYS,CAAC;AAAA,IAAG,IACvEJ;AAAAA,IACJJ,cAAcA,IACV,CAACQ,MAAqC;AAAEJ,MAAAA,EAAAA,GAAeJ,EAAaQ,CAAC;AAAA,IAAG,IACxEJ;AAAAA,IACJd,SAASiB;AAAAA,IACT,iBAAiBN,IAAa,SAASiB;AAAAA,IACvC,aAAa7B,IAAU,SAAS6B;AAAAA,IAChC,gBAAgBrB;AAAAA,EAAAA;AAIlB,EAAKL,MACHyB,EAAWE,YAAYN;AAIzB,QAAMO,IAAmC;AAAA,IAAEH,YAAAA;AAAAA,IAAYhB,YAAAA;AAAAA,EAAAA;AAEvD,SAAKT,MACH4B,EAAO3B,OAAOA,GACd2B,EAAO1B,WAAWO,IAAa,KAAKP,IAG/B0B;AACT;"}

package/dist/index73.js

@@ -1,65 +1,116 @@
-import { useCallback as c } from "react";
-import { useRovingFocus as d } from "./index70.js";
-const s = (r, t) => `tab${t ? `-${t}` : ""}-${r}`, l = (r, t) => `panel${t ? `-${t}` : ""}-${r}`, C = (r, t) => ({
-  id: l(r, t),
-  role: "tabpanel",
-  "aria-labelledby": s(r, t)
-});
-function R({
-  itemIds: r,
-  orientation: t = "horizontal",
-  activeItem: n,
-  idBase: e = "",
-  includePanelLinks: a = !0,
-  externalPanelId: u
+import { useRef as l, useState as M, useCallback as y, useEffect as U } from "react";
+import { useComboboxNavigation as E } from "./index84.js";
+import { useDismissOnFocusOut as H } from "./index85.js";
+function L({
+  items: a,
+  isOpen: r,
+  onOpenChange: c,
+  onSelect: x,
+  listboxId: n,
+  loop: C = !0,
+  disabled: D = !1,
+  optionSelector: v = '[role="option"]',
+  hasItems: g,
+  keepHighlightOnSelect: P = !1,
+  closeOnTab: k = !0,
+  isItemDisabled: f
 }) {
-  const {
-    setFocusedId: f,
-    handleKeyDown: p,
-    getRovingItemProps: b,
-    getContainerProps: g
-  } = d({
-    itemIds: r,
-    defaultFocusedId: n,
-    orientation: t,
-    loop: !0,
-    role: "tablist"
-  }), P = c((o) => {
-    const {
-      ref: $,
-      tabIndex: x,
-      onFocus: F
-    } = b(o), y = n === o;
+  const h = l(null), s = l(!1), d = l(!1), u = l(!1), [w, t] = M(!1), F = g !== void 0 ? g : a.length > 0, p = y(() => {
+    c(!1);
+  }, [c]);
+  U(() => {
+    r || (s.current = !1, u.current = !1);
+  }, [r]);
+  const o = E({
+    items: a,
+    isOpen: r,
+    onSelect: x,
+    onClose: p,
+    onOpen: () => c(!0),
+    loop: C,
+    disabled: D,
+    listboxRef: h,
+    optionSelector: v,
+    keepHighlightOnSelect: P,
+    closeOnTab: k,
+    isItemDisabled: f
+  }), i = H({
+    onFocusOut: p,
+    onEscape: p,
+    disabled: !r
+  }), K = {
+    ...i,
+    onPointerMove: () => {
+      w && t(!1);
+    },
+    onPointerDown: () => {
+      u.current = !0, t(!1);
+    },
+    onPointerUp: () => {
+    },
+    onFocusCapture: (e) => {
+      i.onFocusCapture(e), u.current ? t(!1) : t(!0);
+    },
+    onKeyDownCapture: (e) => {
+      i.onKeyDownCapture(e), (e.key === "Tab" || e.key === "ArrowDown" || e.key === "ArrowUp") && (u.current = !1), (e.key === "ArrowDown" || e.key === "ArrowUp") && t(!0);
+    },
+    onBlurCapture: (e) => {
+      if (t(!1), !s.current) {
+        if (d.current) {
+          d.current = !1;
+          return;
+        }
+        i.onBlurCapture(e);
+      }
+    }
+  }, m = {
+    role: "combobox",
+    "aria-expanded": r && F,
+    "aria-haspopup": "listbox",
+    "aria-controls": r ? n : void 0,
+    "aria-autocomplete": "list",
+    "aria-activedescendant": o.highlightedIndex >= 0 ? o.getOptionId(n, o.highlightedIndex) : void 0,
+    onKeyDown: (e) => {
+      e.key === "Tab" && (d.current = !0), o.handleKeyDown(e);
+    }
+  }, I = {
+    id: n,
+    role: "listbox",
+    ref: h,
+    onMouseDownCapture: (e) => {
+      s.current = !0;
+    },
+    onMouseUpCapture: (e) => {
+      s.current = !1;
+    },
+    onMouseLeave: (e) => {
+      s.current = !1;
+    }
+  }, R = y((e, A = !1) => {
+    const b = f?.(a[e], e);
     return {
-      ref: $,
-      tabIndex: x,
-      onFocus: F,
-      id: s(o, e),
-      ...a && {
-        "aria-controls": u ?? l(o, e)
+      id: o.getOptionId(n, e),
+      role: "option",
+      ...b ? {} : {
+        "aria-selected": A
       },
-      "aria-selected": y,
-      role: "tab"
+      ...b ? {
+        "aria-disabled": !0
+      } : {}
     };
-  }, [n, b, e, a, u]), T = c((o) => ({
-    id: l(o, e),
-    role: "tabpanel",
-    "aria-labelledby": s(o, e)
-  }), [e]);
+  }, [o.getOptionId, n, f, a]);
   return {
-    getTabProps: P,
-    getPanelProps: T,
-    getTabListProps: g,
-    setFocusedTabId: f,
-    handleKeyDown: p,
-    getPanelId: (o) => l(o, e),
-    getTabId: (o) => s(o, e)
+    containerProps: K,
+    inputProps: m,
+    listboxProps: I,
+    getOptionProps: R,
+    highlightedIndex: o.highlightedIndex,
+    setHighlightedIndex: o.setHighlightedIndex,
+    getOptionId: o.getOptionId,
+    isKeyboardFocused: w
   };
 }
 export {
-  l as getPanelId,
-  s as getTabId,
-  C as getTabPanelProps,
-  R as useTabsA11y
+  L as useCombobox
 };
 //# sourceMappingURL=index73.js.map

package/dist/index73.js.map

@@ -1 +1 @@
-{"version":3,"file":"index73.js","sources":["../src/utils/a11y/useTabsA11y.ts"],"sourcesContent":["import { useCallback } from 'react';\nimport { useRovingFocus } from './useRovingFocus';\n\nexport const getTabId = (itemId: string, idBase: string) => {\n  const suffix = idBase ? `-${idBase}` : '';\n  return `tab${suffix}-${itemId}`;\n};\n\nexport const getPanelId = (itemId: string, idBase: string) => {\n  const suffix = idBase ? `-${idBase}` : '';\n  return `panel${suffix}-${itemId}`;\n};\n\nexport const getTabPanelProps = (tabId: string, idBase: string) => ({\n  id: getPanelId(tabId, idBase),\n  role: 'tabpanel' as const,\n  'aria-labelledby': getTabId(tabId, idBase)\n});\n\ninterface UseTabsA11yProps {\n  itemIds: string[];\n  orientation?: 'horizontal' | 'vertical';\n  activeItem: string;\n  idBase?: string;\n  includePanelLinks?: boolean; // Set to false when consumer manages their own panels externally\n  externalPanelId?: string; // When set, all tabs point aria-controls to this single external panel id\n}\n\ninterface TabA11yProps {\n  ref: (el: HTMLElement | null) => void;\n  tabIndex: number;\n  onFocus: () => void;\n  id: string;\n  'aria-controls'?: string;\n  'aria-selected': boolean;\n  role: 'tab';\n}\n\ninterface PanelA11yProps {\n  id: string;\n  role: 'tabpanel';\n  'aria-labelledby': string;\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  activeItem,\n  idBase = '',\n  includePanelLinks = true,\n  externalPanelId\n}: UseTabsA11yProps) {\n  const {\n    setFocusedId: setFocusedTabId,\n    handleKeyDown,\n    getRovingItemProps,\n    getContainerProps\n  } = useRovingFocus({\n    itemIds,\n    defaultFocusedId: activeItem,\n    orientation,\n    loop: true,\n    role: 'tablist'\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, onFocus } = getRovingItemProps(itemId);\n    const isSelected = activeItem === itemId;\n\n    return {\n      ref,\n      tabIndex,\n      onFocus,\n      id: getTabId(itemId, idBase),\n      ...(includePanelLinks && { 'aria-controls': externalPanelId ?? getPanelId(itemId, idBase) }),\n      'aria-selected': isSelected,\n      role: 'tab'\n    };\n  }, [activeItem, getRovingItemProps, idBase, includePanelLinks, externalPanelId]);\n\n  /**\n   * Get all props needed for a tab panel.\n   * Provides ARIA attributes to associate the panel with its tab.\n   */\n  const getPanelProps = useCallback((itemId: string): PanelA11yProps => {\n    return {\n      id: getPanelId(itemId, idBase),\n      role: 'tabpanel',\n      'aria-labelledby': getTabId(itemId, idBase)\n    };\n  }, [idBase]);\n\n  return {\n    getTabProps,\n    getPanelProps,\n    getTabListProps: getContainerProps,\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","getTabPanelProps","tabId","id","role","useTabsA11y","itemIds","orientation","activeItem","includePanelLinks","externalPanelId","setFocusedId","setFocusedTabId","handleKeyDown","getRovingItemProps","getContainerProps","defaultFocusedId","loop","getTabProps","ref","tabIndex","onFocus","isSelected","getPanelProps","getTabListProps"],"mappings":"AAGO,SAAA,eAAAA,SAAA;AAAA,SAAA,kBAAAC,SAAA;AAAA,MAAMC,IAAWA,CAACC,GAAgBC,MAEhC,MADQA,IAAS,IAAIA,CAAM,KAAK,EACpB,IAAID,CAAM,IAGlBE,IAAaA,CAACF,GAAgBC,MAElC,QADQA,IAAS,IAAIA,CAAM,KAAK,EAClB,IAAID,CAAM,IAGpBG,IAAmBA,CAACC,GAAeH,OAAoB;AAAA,EAClEI,IAAIH,EAAWE,GAAOH,CAAM;AAAA,EAC5BK,MAAM;AAAA,EACN,mBAAmBP,EAASK,GAAOH,CAAM;AAC3C;AAwCO,SAASM,EAAY;AAAA,EAC1BC,SAAAA;AAAAA,EACAC,aAAAA,IAAc;AAAA,EACdC,YAAAA;AAAAA,EACAT,QAAAA,IAAS;AAAA,EACTU,mBAAAA,IAAoB;AAAA,EACpBC,iBAAAA;AACgB,GAAG;AACnB,QAAM;AAAA,IACJC,cAAcC;AAAAA,IACdC,eAAAA;AAAAA,IACAC,oBAAAA;AAAAA,IACAC,mBAAAA;AAAAA,EAAAA,IACEnB,EAAe;AAAA,IACjBU,SAAAA;AAAAA,IACAU,kBAAkBR;AAAAA,IAClBD,aAAAA;AAAAA,IACAU,MAAM;AAAA,IACNb,MAAM;AAAA,EAAA,CACP,GAMKc,IAAcvB,EAAY,CAACG,MAAiC;AAChE,UAAM;AAAA,MAAEqB,KAAAA;AAAAA,MAAKC,UAAAA;AAAAA,MAAUC,SAAAA;AAAAA,IAAAA,IAAYP,EAAmBhB,CAAM,GACtDwB,IAAad,MAAeV;AAElC,WAAO;AAAA,MACLqB,KAAAA;AAAAA,MACAC,UAAAA;AAAAA,MACAC,SAAAA;AAAAA,MACAlB,IAAIN,EAASC,GAAQC,CAAM;AAAA,MAC3B,GAAIU,KAAqB;AAAA,QAAE,iBAAiBC,KAAmBV,EAAWF,GAAQC,CAAM;AAAA,MAAA;AAAA,MACxF,iBAAiBuB;AAAAA,MACjBlB,MAAM;AAAA,IAAA;AAAA,EAEV,GAAG,CAACI,GAAYM,GAAoBf,GAAQU,GAAmBC,CAAe,CAAC,GAMzEa,IAAgB5B,EAAY,CAACG,OAC1B;AAAA,IACLK,IAAIH,EAAWF,GAAQC,CAAM;AAAA,IAC7BK,MAAM;AAAA,IACN,mBAAmBP,EAASC,GAAQC,CAAM;AAAA,EAAA,IAE3C,CAACA,CAAM,CAAC;AAEX,SAAO;AAAA,IACLmB,aAAAA;AAAAA,IACAK,eAAAA;AAAAA,IACAC,iBAAiBT;AAAAA,IACjBH,iBAAAA;AAAAA,IACAC,eAAAA;AAAAA,IACAb,YAAYA,CAACF,MAAmBE,EAAWF,GAAQC,CAAM;AAAA,IACzDF,UAAUA,CAACC,MAAmBD,EAASC,GAAQC,CAAM;AAAA,EAAA;AAEzD;"}
+{"version":3,"file":"index73.js","sources":["../src/utils/a11y/useCombobox.ts"],"sourcesContent":["import { useRef, useCallback, useEffect, useState } from 'react';\nimport type { RefObject } from 'react';\nimport { useComboboxNavigation } from './useComboboxNavigation';\nimport { useDismissOnFocusOut } from './useDismissOnFocusOut';\nimport type { UseDismissOnFocusOutReturn } from './useDismissOnFocusOut';\n\nexport interface UseComboboxOptions<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 to change the open state\n   */\n  onOpenChange: (open: boolean) => void;\n  \n  /**\n   * Callback when an item is selected (Enter key)\n   */\n  onSelect: (item: T, index: number) => void;\n  \n  /**\n   * Stable ID for the listbox element\n   */\n  listboxId: string;\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   * CSS selector for option elements (default: '[role=\"option\"]')\n   */\n  optionSelector?: string;\n  \n  /**\n   * Whether the listbox has any items to show\n   * Used for aria-expanded logic\n   * Default: items.length > 0\n   */\n  hasItems?: boolean;\n\n  /**\n   * Whether to keep the highlighted index after selecting an item.\n   * Useful for multi-select where the dropdown stays open after selection.\n   * Default: false\n   */\n  keepHighlightOnSelect?: boolean;\n\n  /**\n   * Whether Tab should close the dropdown.\n   * Set to false when Tab should move focus to elements within the popup (e.g. CTAs).\n   * Default: true\n   */\n  closeOnTab?: boolean;\n\n  /**\n   * Predicate to mark items as disabled. Disabled items are reachable via arrow keys\n   * (so screen readers can announce them) but Enter/Space selection is blocked.\n   */\n  isItemDisabled?: (item: T, index: number) => boolean;\n}\n\nexport interface UseComboboxReturn {\n  /**\n   * Props to spread on the container element (handles dismiss on focus out + keyboard focus tracking)\n   */\n  containerProps: UseDismissOnFocusOutReturn<HTMLElement> & {\n    onPointerMove: () => void;\n    onPointerDown: () => void;\n    onPointerUp: () => void;\n  };\n  \n  /**\n   * Props to spread on the combobox input element\n   */\n  inputProps: {\n    role: 'combobox';\n    'aria-expanded': boolean;\n    'aria-haspopup': 'listbox';\n    'aria-controls': string | undefined;\n    'aria-autocomplete': 'list';\n    'aria-activedescendant': string | undefined;\n    onKeyDown: (e: React.KeyboardEvent) => void;\n  };\n  \n  /**\n   * Props to spread on the listbox element\n   */\n  listboxProps: {\n    id: string;\n    role: 'listbox';\n    ref: RefObject<HTMLDivElement | null>;\n    onMouseDownCapture: (e: React.MouseEvent) => void;\n    onMouseUpCapture: (e: React.MouseEvent) => void;\n    onMouseLeave: (e: React.MouseEvent) => void;\n  };\n  \n  /**\n   * Generate props for an option element at the given index\n   * @param selected - Whether this option is the currently selected/chosen value (not keyboard highlight)\n   */\n  getOptionProps: (index: number, selected?: boolean) => {\n    id: string;\n    role: 'option';\n    'aria-selected'?: boolean;\n    'aria-disabled'?: true;\n  };\n  \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   * Generate stable ID for an option\n   */\n  getOptionId: (listboxId: string, index: number) => string;\n\n  /**\n   * Whether the combobox input was focused via keyboard (Tab) rather than pointer.\n   * Use to conditionally show focus ring only on keyboard interaction.\n   */\n  isKeyboardFocused: boolean;\n}\n\n/**\n * Comprehensive hook for implementing WAI-ARIA combobox pattern.\n * \n * Combines:\n * - Keyboard navigation (Arrow Up/Down, Enter, Escape, Tab)\n * - Focus management and dismissal\n * - ARIA attributes for accessibility\n * - Auto-scroll highlighted item into view\n * \n * This hook provides a complete, batteries-included solution for building\n * accessible combobox components (autocomplete, select, search with suggestions, etc.)\n * \n * @example Basic usage\n * ```tsx\n * const MyCombobox = () => {\n *   const [isOpen, setIsOpen] = useState(false);\n *   const [items, setItems] = useState(['Apple', 'Banana', 'Cherry']);\n *   \n *   const {\n *     containerProps,\n *     inputProps,\n *     listboxProps,\n *     getOptionProps,\n *     highlightedIndex\n *   } = useCombobox({\n *     items,\n *     isOpen,\n *     onOpenChange: setIsOpen,\n *     onSelect: (item) => console.log('Selected:', item),\n *     listboxId: 'my-listbox'\n *   });\n *   \n *   return (\n *     <div {...containerProps}>\n *       <input {...inputProps} />\n *       {isOpen && (\n *         <div {...listboxProps}>\n *           {items.map((item, i) => (\n *             <div key={i} {...getOptionProps(i)}>\n *               {item}\n *             </div>\n *           ))}\n *         </div>\n *       )}\n *     </div>\n *   );\n * };\n * ```\n * \n * @example With custom ARIA labels and handlers\n * ```tsx\n * const MySearchBox = () => {\n *   const [query, setQuery] = useState('');\n *   const [suggestions, setSuggestions] = useState([]);\n *   const [isOpen, setIsOpen] = useState(false);\n *   \n *   const { containerProps, inputProps, listboxProps, getOptionProps } = useCombobox({\n *     items: suggestions,\n *     isOpen,\n *     onOpenChange: setIsOpen,\n *     onSelect: (suggestion) => {\n *       setQuery(suggestion);\n *       setIsOpen(false);\n *     },\n *     listboxId: 'search-suggestions'\n *   });\n *   \n *   return (\n *     <div {...containerProps}>\n *       <input\n *         {...inputProps}\n *         value={query}\n *         onChange={(e) => setQuery(e.target.value)}\n *         aria-label=\"Search\"\n *       />\n *       {isOpen && suggestions.length > 0 && (\n *         <div {...listboxProps} aria-label=\"Search suggestions\">\n *           {suggestions.map((suggestion, i) => (\n *             <div\n *               key={i}\n *               {...getOptionProps(i)}\n *               onClick={() => {\n *                 setQuery(suggestion);\n *                 setIsOpen(false);\n *               }}\n *             >\n *               {suggestion}\n *             </div>\n *           ))}\n *         </div>\n *       )}\n *     </div>\n *   );\n * };\n * ```\n */\nexport function useCombobox<T = any>({\n  items,\n  isOpen,\n  onOpenChange,\n  onSelect,\n  listboxId,\n  loop = true,\n  disabled = false,\n  optionSelector = '[role=\"option\"]',\n  hasItems,\n  keepHighlightOnSelect = false,\n  closeOnTab = true,\n  isItemDisabled\n}: UseComboboxOptions<T>): UseComboboxReturn {\n  const listboxRef = useRef<HTMLDivElement | null>(null);\n  const pointerDownInListboxRef = useRef(false);\n  const tabKeyPressedRef = useRef(false);\n  const pointerFocusRef = useRef(false);\n  const [isKeyboardFocused, setIsKeyboardFocused] = useState(false);\n  \n  // Determine if we should show as expanded\n  const shouldShowExpanded = hasItems !== undefined ? hasItems : items.length > 0;\n  \n  // Close dropdown callback\n  const closeDropdown = useCallback(() => {\n    onOpenChange(false);\n  }, [onOpenChange]);\n\n  // Ensure pointer state doesn't get stuck when listbox unmounts\n  useEffect(() => {\n    if (!isOpen) {\n      pointerDownInListboxRef.current = false;\n      pointerFocusRef.current = false;\n    }\n  }, [isOpen]);\n  \n  // Keyboard navigation with aria-activedescendant\n  const navigation = useComboboxNavigation<T>({\n    items,\n    isOpen,\n    onSelect,\n    onClose: closeDropdown,\n    onOpen: () => onOpenChange(true),\n    loop,\n    disabled,\n    listboxRef,\n    optionSelector,\n    keepHighlightOnSelect,\n    closeOnTab,\n    isItemDisabled\n  });\n  \n  // Focus out / Escape dismissal\n  const dismissHandlers = useDismissOnFocusOut({\n    onFocusOut: closeDropdown,\n    onEscape: closeDropdown,\n    disabled: !isOpen\n  });\n\n  const containerProps = {\n    ...dismissHandlers,\n    onPointerMove: () => {\n      if (isKeyboardFocused) {\n        setIsKeyboardFocused(false);\n      }\n    },\n    onPointerDown: () => {\n      pointerFocusRef.current = true;\n      setIsKeyboardFocused(false);\n    },\n    onPointerUp: () => {\n      // Don't reset pointerFocusRef here — timing races with programmatic focus\n      // (e.g. focus-on-open via double rAF) cause it to clear before onFocusCapture\n      // fires, incorrectly setting isKeyboardFocused=true.\n      // Instead, pointerFocusRef is reset only when keyboard navigation starts\n      // (Tab/Arrow in onKeyDownCapture), ensuring any programmatic focus after a\n      // click is always treated as pointer context.\n    },\n    onFocusCapture: (e: React.FocusEvent<HTMLElement>) => {\n      dismissHandlers.onFocusCapture(e);\n\n      if (pointerFocusRef.current) {\n        setIsKeyboardFocused(false);\n      } else {\n        setIsKeyboardFocused(true);\n      }\n    },\n    onKeyDownCapture: (e: React.KeyboardEvent<HTMLElement>) => {\n      dismissHandlers.onKeyDownCapture(e);\n\n      // Keyboard interaction starts — clear pointer context so subsequent\n      // focus events are correctly identified as keyboard-initiated.\n      if (e.key === 'Tab' || e.key === 'ArrowDown' || e.key === 'ArrowUp') {\n        pointerFocusRef.current = false;\n      }\n\n      // Arrow keys mean keyboard navigation — show focus outline even if\n      // the combobox was opened with mouse (activedescendant doesn't move\n      // DOM focus, so onFocusCapture alone can't detect the switch).\n      if (e.key === 'ArrowDown' || e.key === 'ArrowUp') {\n        setIsKeyboardFocused(true);\n      }\n    },\n    onBlurCapture: (e: React.FocusEvent<HTMLElement>) => {\n      setIsKeyboardFocused(false);\n\n      // Clicking inside a listbox option can blur the input (relatedTarget is null),\n      // which would dismiss before the click handler runs. Prevent that.\n      if (pointerDownInListboxRef.current) return;\n\n      // Tab key pressed - let Tab handler close dropdown, skip blur detection\n      if (tabKeyPressedRef.current) {\n        tabKeyPressedRef.current = false;\n        return;\n      }\n\n      dismissHandlers.onBlurCapture(e);\n    }\n  };\n  \n  // Build input props\n  const inputProps = {\n    role: 'combobox' as const,\n    'aria-expanded': isOpen && shouldShowExpanded,\n    'aria-haspopup': 'listbox' as const,\n    'aria-controls': isOpen ? listboxId : undefined,\n    'aria-autocomplete': 'list' as const,\n    'aria-activedescendant': \n      navigation.highlightedIndex >= 0 \n        ? navigation.getOptionId(listboxId, navigation.highlightedIndex) \n        : undefined,\n    onKeyDown: (e: React.KeyboardEvent) => {\n      // Set flag when Tab is pressed (before blur fires)\n      if (e.key === 'Tab') {\n        tabKeyPressedRef.current = true;\n      }\n      navigation.handleKeyDown(e);\n    }\n  };\n  \n  // Build listbox props\n  const listboxProps = {\n    id: listboxId,\n    role: 'listbox' as const,\n    ref: listboxRef,\n    onMouseDownCapture: (_e: React.MouseEvent) => {\n      pointerDownInListboxRef.current = true;\n    },\n    onMouseUpCapture: (_e: React.MouseEvent) => {\n      pointerDownInListboxRef.current = false;\n    },\n    onMouseLeave: (_e: React.MouseEvent) => {\n      pointerDownInListboxRef.current = false;\n    }\n  };\n  \n  // Option props generator\n  const getOptionProps = useCallback(\n    (index: number, selected: boolean = false) => {\n      const disabled = isItemDisabled?.(items[index], index);\n      return {\n        id: navigation.getOptionId(listboxId, index),\n        role: 'option' as const,\n        ...(!disabled ? { 'aria-selected': selected } : {}),\n        ...(disabled ? { 'aria-disabled': true as const } : {})\n      };\n    },\n    [navigation.getOptionId, listboxId, isItemDisabled, items]\n  );\n  \n  return {\n    containerProps,\n    inputProps,\n    listboxProps,\n    getOptionProps,\n    highlightedIndex: navigation.highlightedIndex,\n    setHighlightedIndex: navigation.setHighlightedIndex,\n    getOptionId: navigation.getOptionId,\n    isKeyboardFocused\n  };\n}\n"],"names":["useRef","useState","useCallback","useEffect","useComboboxNavigation","useDismissOnFocusOut","useCombobox","items","isOpen","onOpenChange","onSelect","listboxId","loop","disabled","optionSelector","hasItems","keepHighlightOnSelect","closeOnTab","isItemDisabled","listboxRef","pointerDownInListboxRef","tabKeyPressedRef","pointerFocusRef","isKeyboardFocused","setIsKeyboardFocused","shouldShowExpanded","undefined","length","closeDropdown","current","navigation","onClose","onOpen","dismissHandlers","onFocusOut","onEscape","containerProps","onPointerMove","onPointerDown","onPointerUp","onFocusCapture","e","onKeyDownCapture","key","onBlurCapture","inputProps","role","highlightedIndex","getOptionId","onKeyDown","handleKeyDown","listboxProps","id","ref","onMouseDownCapture","_e","onMouseUpCapture","onMouseLeave","getOptionProps","index","selected","setHighlightedIndex"],"mappings":"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"}

package/dist/index74.js

@@ -1,24 +1,22 @@
-import { useEffect as u } from "react";
-import { getFirstFocusableElement as f } from "./index71.js";
-function s({
-  focusRef: r,
-  containerRef: t,
-  isReady: e,
-  shouldFocus: n
-}) {
-  u(() => {
-    if (e && !(n && !n())) {
-      if (r?.current) {
-        r.current.focus();
-        return;
-      }
-      t?.current && f({
-        container: t.current
-      })?.focus();
+import { useRef as u, useEffect as i } from "react";
+function f(n, {
+  targetSelector: r = "#main-content h1",
+  fallbackId: c = "main-content"
+} = {}) {
+  const t = u(!0);
+  i(() => {
+    if (t.current) {
+      t.current = !1;
+      return;
     }
-  }, [e]);
+    const o = requestAnimationFrame(() => {
+      const e = document.querySelector(r) || document.getElementById(c);
+      e && (e.hasAttribute("tabindex") || e.setAttribute("tabindex", "-1"), e.focus());
+    });
+    return () => cancelAnimationFrame(o);
+  }, n);
 }
 export {
-  s as useFocusOnReady
+  f as useFocusManagement
 };
 //# sourceMappingURL=index74.js.map

package/dist/index74.js.map

@@ -1 +1 @@
-{"version":3,"file":"index74.js","sources":["../src/utils/a11y/useFocusOnReady.ts"],"sourcesContent":["import { useEffect } from 'react';\nimport type { RefObject } from 'react';\nimport { getFirstFocusableElement } from './focusableElements';\n\nexport interface UseFocusOnReadyOptions {\n  /**\n   * Specific element to focus. Takes priority over containerRef.\n   */\n  focusRef?: RefObject<HTMLElement | null>;\n  /**\n   * Container to search for first focusable element.\n   * Used as fallback when focusRef is not provided or its current is null.\n   */\n  containerRef?: RefObject<HTMLElement | null>;\n  /**\n   * When this transitions to true, focus is triggered.\n   */\n  isReady: boolean;\n  /**\n   * Optional guard for async content — evaluated at the moment isReady becomes true.\n   * Return false to skip focusing (e.g. if the user has tabbed away while content was loading).\n   * Not needed for synchronous open/close like modals or dropdowns where focus is immediate.\n   */\n  shouldFocus?: () => boolean;\n}\n\n/**\n * Moves focus to an element when an async condition becomes ready.\n *\n * When `focusRef` is provided, focuses that element directly.\n * When only `containerRef` is provided, finds and focuses the first focusable child.\n * When both are provided, `focusRef` takes priority; `containerRef` is the fallback.\n *\n * @example Focus first focusable in container after loading\n * ```tsx\n * useFocusOnReady({\n *   containerRef: panelRef,\n *   isReady: !isLoading,\n *   shouldFocus: () => document.activeElement === panelRef.current\n * });\n * ```\n *\n * @example Focus a specific element when modal opens\n * ```tsx\n * useFocusOnReady({\n *   focusRef: closeButtonRef,\n *   isReady: isOpen\n * });\n * ```\n *\n * @example Specific element with container fallback\n * ```tsx\n * useFocusOnReady({\n *   focusRef: preferredRef,\n *   containerRef: dialogRef,\n *   isReady: isOpen\n * });\n * ```\n */\nexport function useFocusOnReady({\n  focusRef,\n  containerRef,\n  isReady,\n  shouldFocus\n}: UseFocusOnReadyOptions): void {\n  useEffect(() => {\n    if (!isReady) return;\n    if (shouldFocus && !shouldFocus()) return;\n\n    if (focusRef?.current) {\n      focusRef.current.focus();\n      return;\n    }\n\n    if (containerRef?.current) {\n      const first = getFirstFocusableElement({ container: containerRef.current });\n      first?.focus();\n    }\n  }, [isReady]);\n}\n"],"names":["useEffect","getFirstFocusableElement","useFocusOnReady","focusRef","containerRef","isReady","shouldFocus","current","focus","container"],"mappings":"AA2DO,SAAA,aAAAA,SAAA;AAAA,SAAA,4BAAAC,SAAA;AAAA,SAASC,EAAgB;AAAA,EAC9BC,UAAAA;AAAAA,EACAC,cAAAA;AAAAA,EACAC,SAAAA;AAAAA,EACAC,aAAAA;AACsB,GAAS;AAC/BN,EAAAA,EAAU,MAAM;AACd,QAAKK,KACDC,EAAAA,KAAe,CAACA,MAEpB;AAAA,UAAIH,GAAUI,SAAS;AACrBJ,QAAAA,EAASI,QAAQC,MAAAA;AACjB;AAAA,MACF;AAEA,MAAIJ,GAAcG,WACFN,EAAyB;AAAA,QAAEQ,WAAWL,EAAaG;AAAAA,MAAAA,CAAS,GACnEC,MAAAA;AAAAA;AAAAA,EAEX,GAAG,CAACH,CAAO,CAAC;AACd;"}
+{"version":3,"file":"index74.js","sources":["../src/utils/a11y/useFocusManagement.ts"],"sourcesContent":["import { useEffect, useRef } from 'react';\nimport type { DependencyList } from 'react';\n\nexport interface UseFocusManagementOptions {\n  /**\n   * CSS selector to query the primary focus target.\n   * Default: 'h1'\n   */\n  targetSelector?: string;\n  /**\n   * Fallback element id if selector target is not found.\n   * Default: 'main-content'\n   */\n  fallbackId?: string;\n}\n\n/**\n * Generic focus management hook for route/state driven UI transitions.\n * Useful for both route changes and in-page multi-step wizards.\n * \n * Always skips first render and uses animation frame for safe DOM timing.\n */\nexport function useFocusManagement(\n  dependencies: DependencyList,\n  {\n    targetSelector = '#main-content h1',\n    fallbackId = 'main-content'\n  }: UseFocusManagementOptions = {}\n): void {\n  const isFirstRender = useRef(true);\n\n  useEffect(() => {\n    // Always skip first render\n    if (isFirstRender.current) {\n      isFirstRender.current = false;\n      return;\n    }\n\n    const focusTarget = () => {\n      const el = (document.querySelector(targetSelector) || document.getElementById(fallbackId)) as HTMLElement;\n      if (el) {\n        if (!el.hasAttribute('tabindex')) el.setAttribute('tabindex', '-1');\n        el.focus();\n      }\n    };\n\n    // Always use animation frame for safe DOM timing\n    const rafId = requestAnimationFrame(focusTarget);\n    return () => cancelAnimationFrame(rafId);\n  }, dependencies);\n}\n"],"names":["useFocusManagement","dependencies","targetSelector","fallbackId","isFirstRender","useRef","useEffect","current","rafId","requestAnimationFrame","focusTarget","el","document","querySelector","getElementById","hasAttribute","setAttribute","focus","cancelAnimationFrame"],"mappings":";AAsBO,SAASA,EACdC,GACA;AAAA,EACEC,gBAAAA,IAAiB;AAAA,EACjBC,YAAAA,IAAa;AACY,IAAI,IACzB;AACN,QAAMC,IAAgBC,EAAO,EAAI;AAEjCC,EAAAA,EAAU,MAAM;AAEd,QAAIF,EAAcG,SAAS;AACzBH,MAAAA,EAAcG,UAAU;AACxB;AAAA,IACF;AAWA,UAAMC,IAAQC,sBATMC,MAAM;AACxB,YAAMC,IAAMC,SAASC,cAAcX,CAAc,KAAKU,SAASE,eAAeX,CAAU;AACxF,MAAIQ,MACGA,EAAGI,aAAa,UAAU,KAAGJ,EAAGK,aAAa,YAAY,IAAI,GAClEL,EAAGM,MAAAA;AAAAA,IAEP,CAG+C;AAC/C,WAAO,MAAMC,qBAAqBV,CAAK;AAAA,EACzC,GAAGP,CAAY;AACjB;"}

package/dist/index75.js

@@ -1,174 +1,69 @@
-var m = Object.defineProperty;
-var g = (r, e, t) => e in r ? m(r, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : r[e] = t;
-var o = (r, e, t) => g(r, typeof e != "symbol" ? e + "" : e, t);
-const u = "sr-only", h = "data-batch-id", f = "data-modal-announcer";
-let c = null;
-function p() {
-  return c || (c = new T()), c;
-}
-class T {
-  constructor() {
-    o(this, "container", null);
-    o(this, "assertiveLog", null);
-    o(this, "politeLog", null);
-    o(this, "cleanupTimers", /* @__PURE__ */ new Map());
-    o(this, "delayTimers", /* @__PURE__ */ new Map());
-    o(this, "pendingRafByBatchId", /* @__PURE__ */ new Map());
-    o(this, "ready", !1);
-    o(this, "pendingQueue", []);
-    typeof document > "u" || (this.container = document.createElement("div"), this.container.dataset.liveAnnouncer = "true", this.container.className = u, this.assertiveLog = this.createLog("assertive"), this.politeLog = this.createLog("polite"), this.container.appendChild(this.assertiveLog), this.container.appendChild(this.politeLog), document.body.prepend(this.container), this.isTestEnvironment() ? this.ready = !0 : setTimeout(() => {
-      this.ready = !0, this.flushPendingQueue();
-    }, 100));
-  }
-  // -----------------------------------------------------------------------
-  // Public
-  // -----------------------------------------------------------------------
-  announce(e, t = {}) {
-    const i = {
-      assertiveness: t.assertiveness ?? "polite",
-      timeout: t.timeout ?? 7e3,
-      batchId: t.batchId ?? "",
-      delay: t.delay ?? 0
-    };
-    if (i.batchId) {
-      const n = this.delayTimers.get(i.batchId);
-      n && (clearTimeout(n), this.delayTimers.delete(i.batchId));
-    }
-    if (!this.ready) {
-      this.pendingQueue.push({
-        message: e,
-        options: i
-      });
-      return;
-    }
-    if (i.delay > 0) {
-      const n = i.batchId || `__delay_${Date.now()}_${Math.random()}`, a = setTimeout(() => {
-        this.delayTimers.delete(n), this.doAnnounce(e, i);
-      }, i.delay);
-      this.delayTimers.set(n, a);
-      return;
-    }
-    this.doAnnounce(e, i);
-  }
-  clear(e) {
-    (!e || e === "assertive") && this.clearLog(this.assertiveLog), (!e || e === "polite") && this.clearLog(this.politeLog);
-  }
-  destroy() {
-    this.cleanupTimers.forEach((e) => clearTimeout(e)), this.cleanupTimers.clear(), this.delayTimers.forEach((e) => clearTimeout(e)), this.delayTimers.clear(), this.pendingRafByBatchId.forEach((e) => cancelAnimationFrame(e)), this.pendingRafByBatchId.clear(), this.container?.remove(), this.container = null, this.assertiveLog = null, this.politeLog = null, this.ready = !1, this.pendingQueue = [], c === this && (c = null);
-  }
-  isAttached() {
-    return this.container?.isConnected ?? !1;
-  }
-  // -----------------------------------------------------------------------
-  // Private
-  // -----------------------------------------------------------------------
-  createLog(e) {
-    const t = document.createElement("div");
-    return t.setAttribute("role", "log"), t.setAttribute("aria-live", e), t.setAttribute("aria-relevant", "additions"), t;
-  }
-  /**
-   * Returns the appropriate log element for the current context.
-   * When an aria-modal dialog is active, announcements must be made from
-   * within the modal (screen readers ignore content outside aria-modal).
-   * A live region is lazily created inside the modal and cleaned up when
-   * the modal is removed from the DOM.
-   */
-  getLogForContext(e) {
-    const t = this.findVisibleModal();
-    if (!t)
-      return e === "assertive" ? this.assertiveLog : this.politeLog;
-    let i = t.querySelector(`[${f}]`);
-    if (!i) {
-      i = document.createElement("div"), i.setAttribute(f, "true"), i.className = u;
-      const s = this.createLog("assertive"), d = this.createLog("polite");
-      i.appendChild(s), i.appendChild(d), t.appendChild(i);
-    }
-    const n = i.querySelectorAll('[role="log"]'), a = n[0], l = n[1];
-    return e === "assertive" ? a : l;
-  }
-  /**
-   * Returns the first aria-modal element that is actually visible.
-   * A modal is considered hidden if:
-   *   - it or an ancestor has aria-hidden="true", or
-   *   - its computed visibility is "hidden" (se-design Modal uses the
-   *     `invisible` CSS class on the wrapper when closed).
-   */
-  findVisibleModal() {
-    const e = document.querySelectorAll('[aria-modal="true"]');
-    for (const t of e) {
-      const i = t;
-      if (!i.closest('[aria-hidden="true"]') && getComputedStyle(i).visibility !== "hidden")
-        return i;
+import * as n from "react";
+import { getA11yNameAttributes as C } from "./index86.js";
+function M({
+  itemIds: r,
+  tabIndex: v = 0,
+  defaultFocusedId: u,
+  orientation: a = "horizontal",
+  cols: i,
+  loop: k = !0,
+  onFocusChange: f,
+  role: h
+}) {
+  const [c, b] = n.useState(u || r[0] || ""), g = n.useRef({});
+  n.useEffect(() => {
+    if (r.length > 0 && !r.includes(c)) {
+      const t = u || r[0] || "";
+      b(t);
     }
-    return null;
-  }
-  doAnnounce(e, t) {
-    const i = this.getLogForContext(t.assertiveness);
-    if (!i) return;
-    let n = !1;
-    if (t.batchId) {
-      const s = i.querySelector(`[${h}="${CSS.escape(t.batchId)}"]`);
-      s && (this.removeNode(s), n = !0);
+  }, [r, c, u]);
+  const x = n.useCallback((t) => {
+    b((e) => e === t ? e : (f?.(t), t));
+  }, [f]), y = n.useCallback((t) => {
+    const e = g.current[t];
+    e ? e.focus() : (b(t), f?.(t));
+  }, [f]), p = n.useCallback((t, e = 1) => {
+    if (r.length === 0) return;
+    const o = r.indexOf(c), l = Math.max(0, o);
+    let s = l;
+    switch (t) {
+      case "first":
+        s = 0;
+        break;
+      case "last":
+        s = r.length - 1;
+        break;
+      case "prev":
+        k ? s = (l - e + r.length) % r.length : s = Math.max(0, l - e);
+        break;
+      case "next":
+        k ? s = (l + e) % r.length : s = Math.min(r.length - 1, l + e);
+        break;
     }
-    const a = document.createElement("div");
-    a.textContent = e, t.batchId && a.setAttribute(h, t.batchId);
-    const l = () => {
-      if (i.isConnected && (i.appendChild(a), e !== "")) {
-        const s = setTimeout(() => {
-          this.removeNode(a);
-        }, t.timeout);
-        this.cleanupTimers.set(a, s);
-      }
-    };
-    if (n) {
-      const s = this.pendingRafByBatchId.get(t.batchId);
-      s !== void 0 && cancelAnimationFrame(s);
-      const d = requestAnimationFrame(() => {
-        this.pendingRafByBatchId.delete(t.batchId), l();
-      });
-      this.pendingRafByBatchId.set(t.batchId, d);
-    } else
-      l();
-  }
-  removeNode(e) {
-    const t = this.cleanupTimers.get(e);
-    t && (clearTimeout(t), this.cleanupTimers.delete(e)), e.remove();
-  }
-  clearLog(e) {
-    e && (Array.from(e.children).forEach((t) => {
-      const i = this.cleanupTimers.get(t);
-      i && (clearTimeout(i), this.cleanupTimers.delete(t));
-    }), e.innerHTML = "");
-  }
-  flushPendingQueue() {
-    this.pendingQueue.splice(0).forEach(({
-      message: t,
-      options: i
-    }) => this.doAnnounce(t, i));
-  }
-  isTestEnvironment() {
-    try {
-      if (typeof IS_REACT_ACT_ENVIRONMENT == "boolean" && IS_REACT_ACT_ENVIRONMENT || typeof jest < "u" || typeof vitest < "u") return !0;
-    } catch {
-    }
-    return !1;
-  }
-}
-function A(r, e) {
-  const t = typeof e == "string" ? {
-    assertiveness: e
-  } : e ?? {};
-  p().announce(r, t);
-}
-function L(r) {
-  c?.clear(r);
-}
-function I() {
-  c?.destroy();
+    const w = r[s];
+    w && g.current[w]?.focus();
+  }, [r, c, k]), A = n.useCallback((t) => ({
+    ref: (e) => {
+      g.current[t] = e;
+    },
+    tabIndex: c === t ? v : -1,
+    onFocus: () => x(t)
+  }), [c, v, x]), R = n.useCallback((t) => {
+    let e = null, o = 1;
+    t.key === "Home" ? e = "first" : t.key === "End" ? e = "last" : (a !== "vertical" && (t.key === "ArrowLeft" ? e = "prev" : t.key === "ArrowRight" && (e = "next")), !e && a !== "horizontal" && (t.key === "ArrowUp" ? e = "prev" : t.key === "ArrowDown" && (e = "next"), e && i && (o = i))), e && (t.preventDefault(), t.stopPropagation(), p(e, o));
+  }, [a, i, p]), z = n.useCallback((t) => {
+    const e = {};
+    return h && (e.role = h), a === "horizontal" ? e["aria-orientation"] = "horizontal" : a === "vertical" && (e["aria-orientation"] = "vertical"), t && Object.assign(e, C(t)), e;
+  }, [h, a]);
+  return {
+    setFocusedId: x,
+    focusItem: y,
+    handleKeyDown: R,
+    getRovingItemProps: A,
+    getContainerProps: z
+  };
 }
 export {
-  A as announce,
-  L as clearAnnouncer,
-  I as destroyAnnouncer
+  M as useRovingFocus
 };
 //# sourceMappingURL=index75.js.map