@proyecto-viviana/solidaria 0.3.0 → 0.4.1

package/dist/_chunk/focus2.jsx.map

@@ -0,0 +1 @@
+{"version":3,"file":"focus2.jsx","names":["getActiveElement"],"sources":["../../src/focus/createFocusRestore.ts","../../src/focus/createVirtualFocus.ts","../../src/focus/virtualFocus.ts","../../src/focus/createAutoFocus.ts"],"sourcesContent":["/**\n * Focus restoration utilities for solidaria\n *\n * Provides enhanced focus restoration with retry logic, cross-scope tracking,\n * and safe restoration patterns.\n */\n\nimport { createEffect, onCleanup, onMount } from \"solid-js\";\nimport { isServer } from \"solid-js/web\";\nimport { getOwnerDocument } from \"../utils\";\nimport { focusSafely } from \"../utils/focus\";\n\nexport interface FocusRestoreOptions {\n  /**\n   * Whether to restore focus when the component unmounts.\n   * @default true\n   */\n  restoreOnUnmount?: boolean;\n  /**\n   * Maximum number of retries if the element is not in the DOM.\n   * @default 3\n   */\n  maxRetries?: number;\n  /**\n   * Delay between retries in milliseconds.\n   * @default 50\n   */\n  retryDelay?: number;\n  /**\n   * Callback when focus is successfully restored.\n   */\n  onRestore?: (element: HTMLElement) => void;\n  /**\n   * Callback when focus restoration fails.\n   */\n  onRestoreFailed?: () => void;\n  /**\n   * Whether to prevent scrolling when restoring focus.\n   * @default true\n   */\n  preventScroll?: boolean;\n}\n\nexport interface FocusRestoreResult {\n  /**\n   * Manually restore focus to the saved element.\n   */\n  restore: () => boolean;\n  /**\n   * Get the saved element (if any).\n   */\n  getSavedElement: () => HTMLElement | null;\n  /**\n   * Save the currently focused element.\n   */\n  saveCurrentFocus: () => void;\n  /**\n   * Clear the saved element without restoring.\n   */\n  clear: () => void;\n}\n\n// Stack to track focus history across scopes\nconst focusStack: HTMLElement[] = [];\n\n/**\n * Push an element onto the focus stack.\n */\nexport function pushFocusStack(element: HTMLElement): void {\n  focusStack.push(element);\n}\n\n/**\n * Pop the last element from the focus stack.\n */\nexport function popFocusStack(): HTMLElement | undefined {\n  return focusStack.pop();\n}\n\n/**\n * Get the current focus stack length.\n */\nexport function getFocusStackLength(): number {\n  return focusStack.length;\n}\n\n/**\n * Clear the entire focus stack.\n */\nexport function clearFocusStack(): void {\n  focusStack.length = 0;\n}\n\n/**\n * Gets the active element, accounting for shadow DOM.\n */\nfunction getActiveElement(doc: Document): HTMLElement | null {\n  let activeElement = doc.activeElement as HTMLElement | null;\n  while (activeElement?.shadowRoot?.activeElement) {\n    activeElement = activeElement.shadowRoot.activeElement as HTMLElement;\n  }\n  return activeElement;\n}\n\n/**\n * Checks if an element is still valid for focus restoration.\n */\nfunction isValidForRestore(element: HTMLElement | null): boolean {\n  if (!element) return false;\n  if (!document.body.contains(element)) return false;\n  if (element.hasAttribute(\"disabled\")) return false;\n  if (element.getAttribute(\"aria-disabled\") === \"true\") return false;\n  if (element.getAttribute(\"aria-hidden\") === \"true\") return false;\n  return true;\n}\n\n/**\n * Attempts to restore focus with retries.\n */\nfunction tryRestoreFocus(\n  element: HTMLElement | null,\n  options: Required<\n    Pick<\n      FocusRestoreOptions,\n      \"maxRetries\" | \"retryDelay\" | \"preventScroll\" | \"onRestore\" | \"onRestoreFailed\"\n    >\n  >,\n): void {\n  const { maxRetries, retryDelay, preventScroll, onRestore, onRestoreFailed } = options;\n  let attempts = 0;\n\n  const attempt = () => {\n    if (!element) {\n      onRestoreFailed?.();\n      return;\n    }\n\n    if (isValidForRestore(element)) {\n      if (preventScroll) {\n        focusSafely(element);\n      } else {\n        element.focus();\n      }\n      onRestore?.(element);\n      return;\n    }\n\n    attempts++;\n    if (attempts < maxRetries) {\n      setTimeout(attempt, retryDelay);\n    } else {\n      onRestoreFailed?.();\n    }\n  };\n\n  // Use requestAnimationFrame for the first attempt to ensure DOM is ready\n  requestAnimationFrame(attempt);\n}\n\n/**\n * Creates a focus restoration manager.\n *\n * This hook saves the currently focused element when mounted and provides\n * methods to restore focus later, with retry logic for reliability.\n *\n * @example\n * ```tsx\n * function Modal(props) {\n *   const focusRestore = createFocusRestore({\n *     restoreOnUnmount: true,\n *     onRestore: () => console.log('Focus restored'),\n *   });\n *\n *   return (\n *     <div role=\"dialog\">\n *       {props.children}\n *       <button onClick={() => focusRestore.restore()}>\n *         Close\n *       </button>\n *     </div>\n *   );\n * }\n * ```\n *\n * @example\n * ```tsx\n * // Manual focus management\n * function Dropdown() {\n *   const focusRestore = createFocusRestore({ restoreOnUnmount: false });\n *\n *   const onOpen = () => {\n *     focusRestore.saveCurrentFocus();\n *     // Focus dropdown content\n *   };\n *\n *   const onClose = () => {\n *     focusRestore.restore();\n *   };\n *\n *   return <div>...</div>;\n * }\n * ```\n */\nexport function createFocusRestore(options: FocusRestoreOptions = {}): FocusRestoreResult {\n  const {\n    restoreOnUnmount = true,\n    maxRetries = 3,\n    retryDelay = 50,\n    onRestore,\n    onRestoreFailed,\n    preventScroll = true,\n  } = options;\n\n  // During SSR, return no-op functions\n  if (isServer) {\n    return {\n      restore: () => false,\n      getSavedElement: () => null,\n      saveCurrentFocus: () => {},\n      clear: () => {},\n    };\n  }\n\n  let savedElement: HTMLElement | null = null;\n\n  // Save focus on mount\n  onMount(() => {\n    saveCurrentFocus();\n  });\n\n  // Restore focus on cleanup\n  onCleanup(() => {\n    if (restoreOnUnmount && savedElement) {\n      tryRestoreFocus(savedElement, {\n        maxRetries,\n        retryDelay,\n        preventScroll,\n        onRestore: onRestore ?? (() => {}),\n        onRestoreFailed: onRestoreFailed ?? (() => {}),\n      });\n    }\n  });\n\n  function saveCurrentFocus(): void {\n    const doc = typeof document !== \"undefined\" ? document : null;\n    if (!doc) return;\n\n    const active = getActiveElement(doc);\n    if (active && active !== doc.body) {\n      savedElement = active;\n      pushFocusStack(active);\n    }\n  }\n\n  function restore(): boolean {\n    if (!savedElement) return false;\n\n    if (isValidForRestore(savedElement)) {\n      if (preventScroll) {\n        focusSafely(savedElement);\n      } else {\n        savedElement.focus();\n      }\n      onRestore?.(savedElement);\n      return true;\n    }\n\n    // Try the focus stack\n    while (focusStack.length > 0) {\n      const stackElement = popFocusStack();\n      if (stackElement && isValidForRestore(stackElement)) {\n        if (preventScroll) {\n          focusSafely(stackElement);\n        } else {\n          stackElement.focus();\n        }\n        onRestore?.(stackElement);\n        return true;\n      }\n    }\n\n    onRestoreFailed?.();\n    return false;\n  }\n\n  function getSavedElement(): HTMLElement | null {\n    return savedElement;\n  }\n\n  function clear(): void {\n    savedElement = null;\n  }\n\n  return {\n    restore,\n    getSavedElement,\n    saveCurrentFocus,\n    clear,\n  };\n}\n","/**\n * Virtual focus management for solidaria\n *\n * Provides virtual focus for large collections where tracking DOM focus\n * on every item is impractical. Instead, a single element receives real\n * focus while aria-activedescendant indicates the virtually focused item.\n *\n * This is commonly used in:\n * - Virtualized lists (where not all items are in the DOM)\n * - Large trees\n * - Autocomplete/combobox suggestions\n * - Grid/table navigation\n */\n\nimport { type Accessor, createSignal, createEffect, onCleanup } from \"solid-js\";\nimport { isServer } from \"solid-js/web\";\n\nexport interface VirtualFocusOptions<T> {\n  /**\n   * The items in the collection.\n   */\n  items: Accessor<T[]>;\n  /**\n   * Function to get a unique key for each item.\n   */\n  getKey: (item: T) => string;\n  /**\n   * Function to check if an item is disabled.\n   */\n  isDisabled?: (item: T) => boolean;\n  /**\n   * Initial focused key.\n   */\n  defaultFocusedKey?: string;\n  /**\n   * Controlled focused key.\n   */\n  focusedKey?: Accessor<string | null>;\n  /**\n   * Callback when focused key changes.\n   */\n  onFocusChange?: (key: string | null) => void;\n  /**\n   * Whether to wrap focus at the edges.\n   * @default true\n   */\n  wrap?: boolean;\n  /**\n   * Whether to loop through disabled items.\n   * @default false\n   */\n  skipDisabled?: boolean;\n  /**\n   * Orientation for keyboard navigation.\n   * @default 'vertical'\n   */\n  orientation?: \"horizontal\" | \"vertical\" | \"both\";\n}\n\nexport interface VirtualFocusResult<T> {\n  /**\n   * The currently focused key.\n   */\n  focusedKey: Accessor<string | null>;\n  /**\n   * The currently focused item (if any).\n   */\n  focusedItem: Accessor<T | null>;\n  /**\n   * Set the focused key.\n   */\n  setFocusedKey: (key: string | null) => void;\n  /**\n   * Move focus to the next item.\n   */\n  focusNext: () => void;\n  /**\n   * Move focus to the previous item.\n   */\n  focusPrevious: () => void;\n  /**\n   * Move focus to the first item.\n   */\n  focusFirst: () => void;\n  /**\n   * Move focus to the last item.\n   */\n  focusLast: () => void;\n  /**\n   * Move focus by a page (for large lists).\n   */\n  focusPageDown: (pageSize?: number) => void;\n  /**\n   * Move focus up by a page (for large lists).\n   */\n  focusPageUp: (pageSize?: number) => void;\n  /**\n   * Check if a key is the currently focused key.\n   */\n  isFocused: (key: string) => boolean;\n  /**\n   * Props to spread on the container element.\n   */\n  containerProps: {\n    \"aria-activedescendant\": Accessor<string | undefined>;\n    onKeyDown: (e: KeyboardEvent) => void;\n  };\n  /**\n   * Get props for an item element.\n   */\n  getItemProps: (key: string) => {\n    id: string;\n    \"aria-selected\"?: boolean;\n  };\n}\n\nconst DEFAULT_PAGE_SIZE = 10;\n\n/**\n * Creates virtual focus management for a collection.\n *\n * Virtual focus uses aria-activedescendant to indicate which item is\n * \"focused\" while keeping real DOM focus on a container element. This\n * is more performant for large collections and required for virtualized\n * lists where items may not be in the DOM.\n *\n * @example\n * ```tsx\n * function Listbox(props) {\n *   const virtualFocus = createVirtualFocus({\n *     items: () => props.items,\n *     getKey: (item) => item.id,\n *     isDisabled: (item) => item.disabled,\n *   });\n *\n *   return (\n *     <ul\n *       role=\"listbox\"\n *       tabIndex={0}\n *       aria-activedescendant={virtualFocus.containerProps['aria-activedescendant']()}\n *       onKeyDown={virtualFocus.containerProps.onKeyDown}\n *     >\n *       <For each={props.items}>\n *         {(item) => (\n *           <li\n *             {...virtualFocus.getItemProps(item.id)}\n *             role=\"option\"\n *             aria-selected={virtualFocus.isFocused(item.id)}\n *           >\n *             {item.name}\n *           </li>\n *         )}\n *       </For>\n *     </ul>\n *   );\n * }\n * ```\n *\n * @example\n * ```tsx\n * // With controlled focus\n * function ControlledListbox() {\n *   const [focusedKey, setFocusedKey] = createSignal<string | null>(null);\n *\n *   const virtualFocus = createVirtualFocus({\n *     items: () => items,\n *     getKey: (item) => item.id,\n *     focusedKey: focusedKey,\n *     onFocusChange: setFocusedKey,\n *   });\n *\n *   return <ul>...</ul>;\n * }\n * ```\n */\nexport function createVirtualFocus<T>(options: VirtualFocusOptions<T>): VirtualFocusResult<T> {\n  const {\n    items,\n    getKey,\n    isDisabled = () => false,\n    defaultFocusedKey,\n    focusedKey: controlledFocusedKey,\n    onFocusChange,\n    wrap = true,\n    skipDisabled = true,\n    orientation = \"vertical\",\n  } = options;\n\n  // During SSR, return minimal implementation\n  if (isServer) {\n    const emptyAccessor = () => null;\n    return {\n      focusedKey: emptyAccessor,\n      focusedItem: emptyAccessor,\n      setFocusedKey: () => {},\n      focusNext: () => {},\n      focusPrevious: () => {},\n      focusFirst: () => {},\n      focusLast: () => {},\n      focusPageDown: () => {},\n      focusPageUp: () => {},\n      isFocused: () => false,\n      containerProps: {\n        \"aria-activedescendant\": () => undefined,\n        onKeyDown: () => {},\n      },\n      getItemProps: (key: string) => ({ id: `item-${key}` }),\n    };\n  }\n\n  // Internal state for uncontrolled mode\n  const [internalKey, setInternalKey] = createSignal<string | null>(defaultFocusedKey ?? null);\n\n  // Use controlled or uncontrolled value\n  const focusedKey = controlledFocusedKey ?? internalKey;\n\n  const setFocusedKey = (key: string | null) => {\n    if (controlledFocusedKey) {\n      onFocusChange?.(key);\n    } else {\n      setInternalKey(key);\n      onFocusChange?.(key);\n    }\n  };\n\n  // Get focused item\n  const focusedItem = (): T | null => {\n    const key = focusedKey();\n    if (!key) return null;\n    return items().find((item) => getKey(item) === key) ?? null;\n  };\n\n  // Get valid items (not disabled if skipDisabled is true)\n  const getValidItems = (): T[] => {\n    if (!skipDisabled) return items();\n    return items().filter((item) => !isDisabled(item));\n  };\n\n  // Get index of key in valid items\n  const getKeyIndex = (key: string | null): number => {\n    if (!key) return -1;\n    const validItems = getValidItems();\n    return validItems.findIndex((item) => getKey(item) === key);\n  };\n\n  // Focus by index\n  const focusByIndex = (index: number): void => {\n    const validItems = getValidItems();\n    if (validItems.length === 0) return;\n\n    let targetIndex = index;\n\n    if (wrap) {\n      targetIndex = ((index % validItems.length) + validItems.length) % validItems.length;\n    } else {\n      targetIndex = Math.max(0, Math.min(index, validItems.length - 1));\n    }\n\n    const item = validItems[targetIndex];\n    if (item) {\n      setFocusedKey(getKey(item));\n    }\n  };\n\n  const focusNext = (): void => {\n    const currentIndex = getKeyIndex(focusedKey());\n    focusByIndex(currentIndex + 1);\n  };\n\n  const focusPrevious = (): void => {\n    const currentIndex = getKeyIndex(focusedKey());\n    if (currentIndex === -1) {\n      focusByIndex(getValidItems().length - 1);\n    } else {\n      focusByIndex(currentIndex - 1);\n    }\n  };\n\n  const focusFirst = (): void => {\n    focusByIndex(0);\n  };\n\n  const focusLast = (): void => {\n    focusByIndex(getValidItems().length - 1);\n  };\n\n  const focusPageDown = (pageSize: number = DEFAULT_PAGE_SIZE): void => {\n    const currentIndex = getKeyIndex(focusedKey());\n    focusByIndex(currentIndex + pageSize);\n  };\n\n  const focusPageUp = (pageSize: number = DEFAULT_PAGE_SIZE): void => {\n    const currentIndex = getKeyIndex(focusedKey());\n    if (currentIndex === -1) {\n      focusByIndex(getValidItems().length - 1);\n    } else {\n      focusByIndex(currentIndex - pageSize);\n    }\n  };\n\n  const isFocused = (key: string): boolean => {\n    return focusedKey() === key;\n  };\n\n  // Keyboard handler\n  const onKeyDown = (e: KeyboardEvent): void => {\n    const isVertical = orientation === \"vertical\" || orientation === \"both\";\n    const isHorizontal = orientation === \"horizontal\" || orientation === \"both\";\n\n    switch (e.key) {\n      case \"ArrowDown\":\n        if (isVertical) {\n          e.preventDefault();\n          focusNext();\n        }\n        break;\n      case \"ArrowUp\":\n        if (isVertical) {\n          e.preventDefault();\n          focusPrevious();\n        }\n        break;\n      case \"ArrowRight\":\n        if (isHorizontal) {\n          e.preventDefault();\n          focusNext();\n        }\n        break;\n      case \"ArrowLeft\":\n        if (isHorizontal) {\n          e.preventDefault();\n          focusPrevious();\n        }\n        break;\n      case \"Home\":\n        e.preventDefault();\n        focusFirst();\n        break;\n      case \"End\":\n        e.preventDefault();\n        focusLast();\n        break;\n      case \"PageDown\":\n        e.preventDefault();\n        focusPageDown();\n        break;\n      case \"PageUp\":\n        e.preventDefault();\n        focusPageUp();\n        break;\n    }\n  };\n\n  const containerProps = {\n    \"aria-activedescendant\": () => {\n      const key = focusedKey();\n      return key ? `item-${key}` : undefined;\n    },\n    onKeyDown,\n  };\n\n  const getItemProps = (key: string) => ({\n    id: `item-${key}`,\n  });\n\n  return {\n    focusedKey,\n    focusedItem,\n    setFocusedKey,\n    focusNext,\n    focusPrevious,\n    focusFirst,\n    focusLast,\n    focusPageDown,\n    focusPageUp,\n    isFocused,\n    containerProps,\n    getItemProps,\n  };\n}\n","/**\n * Virtual-focus event dispatch primitives.\n *\n * A faithful port of @react-aria/focus's `virtualFocus` module. Under virtual\n * focus (e.g. Autocomplete), real DOM focus stays on an input while the\n * \"focused\" collection option is indicated by `aria-activedescendant`. Moving\n * that virtual cursor dispatches synthetic `focus`/`blur` events (with matching\n * bubbling `focusin`/`focusout`) on the option elements so listeners — notably\n * the autocomplete input's `focusin` handler that mirrors the active descendant\n * — react as if the element were really focused.\n */\n\nimport { getActiveElement, getOwnerDocument } from \"../utils/dom\";\n\n/**\n * Moves virtual focus to `to`, dispatching a virtual blur on the previously\n * virtually-focused element (if any) and a virtual focus on `to` (if non-null).\n */\nexport function moveVirtualFocus(to: Element | null): void {\n  const from = getVirtuallyFocusedElement(getOwnerDocument(to));\n  if (from !== to) {\n    if (from) {\n      dispatchVirtualBlur(from, to);\n    }\n    if (to) {\n      dispatchVirtualFocus(to, from);\n    }\n  }\n}\n\n/** Dispatches synthetic `blur` + bubbling `focusout` events on `from`. */\nexport function dispatchVirtualBlur(from: Element, to: Element | null): void {\n  from.dispatchEvent(new FocusEvent(\"blur\", { relatedTarget: to }));\n  from.dispatchEvent(new FocusEvent(\"focusout\", { bubbles: true, relatedTarget: to }));\n}\n\n/** Dispatches synthetic `focus` + bubbling `focusin` events on `to`. */\nexport function dispatchVirtualFocus(to: Element, from: Element | null): void {\n  to.dispatchEvent(new FocusEvent(\"focus\", { relatedTarget: from }));\n  to.dispatchEvent(new FocusEvent(\"focusin\", { bubbles: true, relatedTarget: from }));\n}\n\n/**\n * Returns the currently virtually-focused element: the element referenced by the\n * active element's `aria-activedescendant`, or the active element itself.\n */\nexport function getVirtuallyFocusedElement(document: Document): Element | null {\n  const activeElement = getActiveElement(document);\n  const activeDescendant = activeElement?.getAttribute(\"aria-activedescendant\");\n  if (activeDescendant) {\n    return document.getElementById(activeDescendant) || activeElement;\n  }\n\n  return activeElement;\n}\n","/**\n * Auto-focus management for solidaria\n *\n * Provides priority-based auto-focus with deferred execution\n * and conflict resolution for multiple auto-focus elements.\n */\n\nimport { createEffect, onCleanup, onMount } from \"solid-js\";\nimport { isServer } from \"solid-js/web\";\nimport { focusSafely } from \"../utils/focus\";\n\nexport interface AutoFocusOptions {\n  /**\n   * Whether auto-focus is enabled.\n   * @default true\n   */\n  isEnabled?: boolean;\n  /**\n   * Priority level (higher = more important).\n   * When multiple elements request auto-focus, the highest priority wins.\n   * @default 0\n   */\n  priority?: number;\n  /**\n   * Delay in milliseconds before focusing.\n   * Useful for animations or transitions.\n   * @default 0\n   */\n  delay?: number;\n  /**\n   * Whether to focus even if another element is already focused.\n   * @default false\n   */\n  force?: boolean;\n  /**\n   * Whether to prevent scrolling when focusing.\n   * @default true\n   */\n  preventScroll?: boolean;\n  /**\n   * Callback when focus is applied.\n   */\n  onFocus?: (element: HTMLElement) => void;\n  /**\n   * Callback when focus is skipped (due to lower priority or other reasons).\n   */\n  onSkip?: () => void;\n}\n\nexport interface AutoFocusResult {\n  /**\n   * Manually trigger the auto-focus.\n   */\n  focus: () => void;\n  /**\n   * Cancel any pending auto-focus.\n   */\n  cancel: () => void;\n}\n\ninterface QueuedFocus {\n  ref: () => HTMLElement | null | undefined;\n  priority: number;\n  delay: number;\n  force: boolean;\n  preventScroll: boolean;\n  onFocus?: (element: HTMLElement) => void;\n  onSkip?: () => void;\n}\n\n// Global queue for managing auto-focus requests\nlet autoFocusQueue: QueuedFocus[] = [];\nlet processingTimeout: ReturnType<typeof setTimeout> | null = null;\n\n/**\n * Process the auto-focus queue and focus the highest priority element.\n */\nfunction processAutoFocusQueue(): void {\n  if (processingTimeout) {\n    clearTimeout(processingTimeout);\n    processingTimeout = null;\n  }\n\n  if (autoFocusQueue.length === 0) return;\n\n  // Sort by priority (highest first)\n  autoFocusQueue.sort((a, b) => b.priority - a.priority);\n\n  // Get the highest priority item\n  const winner = autoFocusQueue[0];\n  const losers = autoFocusQueue.slice(1);\n\n  // Clear the queue\n  autoFocusQueue = [];\n\n  // Notify losers\n  for (const loser of losers) {\n    loser.onSkip?.();\n  }\n\n  // Focus the winner\n  const element = winner.ref();\n  if (!element) {\n    winner.onSkip?.();\n    return;\n  }\n\n  // Check if we should focus\n  const activeElement = document.activeElement;\n  const shouldFocus =\n    winner.force ||\n    !activeElement ||\n    activeElement === document.body ||\n    activeElement === document.documentElement;\n\n  if (!shouldFocus) {\n    winner.onSkip?.();\n    return;\n  }\n\n  // Apply focus with optional delay\n  if (winner.delay > 0) {\n    setTimeout(() => {\n      const el = winner.ref();\n      if (el && document.body.contains(el)) {\n        if (winner.preventScroll) {\n          focusSafely(el);\n        } else {\n          el.focus();\n        }\n        winner.onFocus?.(el);\n      }\n    }, winner.delay);\n  } else {\n    if (winner.preventScroll) {\n      focusSafely(element);\n    } else {\n      element.focus();\n    }\n    winner.onFocus?.(element);\n  }\n}\n\n/**\n * Queue an element for auto-focus.\n */\nfunction queueAutoFocus(item: QueuedFocus): void {\n  autoFocusQueue.push(item);\n\n  // Schedule processing on next frame to allow all components to register\n  if (processingTimeout === null) {\n    processingTimeout = setTimeout(processAutoFocusQueue, 0);\n  }\n}\n\n/**\n * Remove an item from the auto-focus queue.\n */\nfunction removeFromQueue(ref: () => HTMLElement | null | undefined): void {\n  autoFocusQueue = autoFocusQueue.filter((item) => item.ref !== ref);\n}\n\n/**\n * Creates auto-focus behavior for an element.\n *\n * This hook registers the element for auto-focus when mounted. If multiple\n * elements request auto-focus, the one with the highest priority wins.\n *\n * @param ref - Accessor for the element to focus\n * @param options - Auto-focus options\n *\n * @example\n * ```tsx\n * function Dialog(props) {\n *   let contentRef: HTMLDivElement | undefined;\n *\n *   createAutoFocus(() => contentRef, {\n *     priority: 10, // High priority for dialogs\n *     onFocus: () => console.log('Dialog focused'),\n *   });\n *\n *   return (\n *     <div ref={contentRef} tabIndex={-1}>\n *       {props.children}\n *     </div>\n *   );\n * }\n * ```\n *\n * @example\n * ```tsx\n * // With delay for animations\n * function AnimatedPanel() {\n *   let panelRef: HTMLDivElement | undefined;\n *\n *   createAutoFocus(() => panelRef, {\n *     delay: 300, // Wait for animation\n *   });\n *\n *   return <div ref={panelRef} class=\"animated-panel\">...</div>;\n * }\n * ```\n *\n * @example\n * ```tsx\n * // Conditional auto-focus\n * function Input(props) {\n *   let inputRef: HTMLInputElement | undefined;\n *\n *   createAutoFocus(() => inputRef, {\n *     isEnabled: props.autoFocus,\n *   });\n *\n *   return <input ref={inputRef} />;\n * }\n * ```\n */\nexport function createAutoFocus(\n  ref: () => HTMLElement | null | undefined,\n  options: AutoFocusOptions = {},\n): AutoFocusResult {\n  const {\n    isEnabled = true,\n    priority = 0,\n    delay = 0,\n    force = false,\n    preventScroll = true,\n    onFocus,\n    onSkip,\n  } = options;\n\n  // During SSR, return no-op functions\n  if (isServer) {\n    return {\n      focus: () => {},\n      cancel: () => {},\n    };\n  }\n\n  let canceled = false;\n\n  // Queue auto-focus on mount\n  onMount(() => {\n    if (!isEnabled || canceled) return;\n\n    queueAutoFocus({\n      ref,\n      priority,\n      delay,\n      force,\n      preventScroll,\n      onFocus,\n      onSkip,\n    });\n  });\n\n  // Remove from queue on cleanup\n  onCleanup(() => {\n    removeFromQueue(ref);\n  });\n\n  const focus = (): void => {\n    if (canceled) return;\n\n    const element = ref();\n    if (!element) return;\n\n    if (preventScroll) {\n      focusSafely(element);\n    } else {\n      element.focus();\n    }\n    onFocus?.(element);\n  };\n\n  const cancel = (): void => {\n    canceled = true;\n    removeFromQueue(ref);\n  };\n\n  return {\n    focus,\n    cancel,\n  };\n}\n\n/**\n * Clears all pending auto-focus requests.\n * Useful for testing or when navigating away.\n */\nexport function clearAutoFocusQueue(): void {\n  if (processingTimeout) {\n    clearTimeout(processingTimeout);\n    processingTimeout = null;\n  }\n  autoFocusQueue = [];\n}\n\n/**\n * Gets the current auto-focus queue length.\n * Useful for debugging.\n */\nexport function getAutoFocusQueueLength(): number {\n  return autoFocusQueue.length;\n}\n"],"mappings":"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"}