@mortenbrudvik/waveui 0.9.0 → 0.11.0

package/dist/hooks/useRestoreFocus.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"useRestoreFocus.cjs","names":["isFocusable","isInsideOtherOpenModal","getOpenLayers","isInsideLayerTree","compareLayers","getGlobalRegistry","subscribeLayers","getFirstTabbable","getTabbableElements","getLayer","getTopmostLayer","focusElement","React","DismissLayerContext","useRef","require_runtime","require_globalRegistry","require_focus","require_layers","require_useDismiss","react","FOLLOWING","PORTAL_SELECTOR","isValidTarget","el","recordPosition","position","body","node","captureAnchors","opener","layers","layer","b","a","anchors","anchor","container","entry","getSurfaceEntries","tracker","getFocusTracker","isClosingByHover","seen","other","isHoverCloseOf","options","ELEMENT_NODE","isElementTarget","target","recordFocus","doc","refreshFocusRecord","last","retainFocusTracker","onFocusIn","event","onFocusOut","unsubscribe","retained","getLostFocus","element","captureOpener","isCandidate","trigger","triggerRef","active","lost","getLayerTargets","targets","first","isAfterPoint","point","ref","placement","follows","resolvePoint","index","path","root","next","previous","getNearbyTargets","resolved","levels","level","candidates","inLevel","after","before","shouldRestore","onBody","isHoverClose","getReplacementTargets","restoreCandidates","latest","replacements","parentLayer","parentLayerId","outsideParent","restore","candidate","useRestoreFocus","latestRef","capturedRef","insertionEnabledRef","layoutEnabledRef","scheduledRef","entryRef","release","surfaces","wasEnabled","enabled","captured","acts","scheduled","entryHolder","snapshot","token"],"sources":["../../src/hooks/useRestoreFocus.ts"],"sourcesContent":["import * as React from 'react';\nimport { useInsertionEffect, useLayoutEffect, useRef } from 'react';\nimport { focusElement, getFirstTabbable, getTabbableElements, isFocusable } from '../lib/focus';\nimport { getGlobalRegistry } from '../lib/globalRegistry';\nimport {\n  ALLOW_OUTSIDE_SELECTOR,\n  compareLayers,\n  getLayer,\n  getOpenLayers,\n  getTopmostLayer,\n  isInsideLayerTree,\n  isInsideOtherOpenModal,\n  subscribeLayers,\n  type LayerRecord,\n} from '../lib/layers';\nimport { DismissLayerContext } from './useDismiss';\n\n/** Options of {@link useRestoreFocus}. */\nexport interface UseRestoreFocusOptions {\n  /** `true` while the surface is open. */\n  enabled: boolean;\n  /** The layer surface: opener candidates inside it are ignored. */\n  container?: HTMLElement | null;\n  /** The trigger: preferred restore target. */\n  triggerRef?: React.RefObject<HTMLElement | null>;\n  /** Consumer override: focused first when valid. */\n  finalFocusRef?: React.RefObject<HTMLElement | null>;\n  /** Used when neither the override, the opener nor the trigger can take focus. */\n  fallback?: () => HTMLElement | null;\n  /**\n   * Popovers: restore only when focus was inside the surface (or lost to `<body>`) at close, so a\n   * click that moved focus elsewhere is respected. @default false\n   */\n  onlyIfFocusInside?: boolean;\n  /**\n   * Read when the surface closes, or unmounts while open: `true` when the hover intent closed it\n   * (Popover and Menu `openOnHover`, a submenu closing by hover). A hover close never moves focus:\n   * it restores only while focus is inside the surface, so focus on `<body>` (where a hover-opened\n   * surface leaves it) or elsewhere stays where it is. A surface opened from inside one that closes\n   * by hover (its opener, else its trigger, lies in that surface: a submenu, a hover card in a\n   * hover card, at any depth) is taken along, and its close counts as a hover close too. Every\n   * other close keeps the rules above.\n   */\n  isHoverClose?: () => boolean;\n}\n\ninterface Latest {\n  options: UseRestoreFocusOptions;\n  parentLayerId: string | null;\n}\n\n/** Where an element sat in the document, recorded so a spot near it can be found once it is gone. */\ninterface DomPosition {\n  /** The element and its ancestors up to `<body>`, innermost first. */\n  path: Element[];\n  /** The next element sibling of each `path` entry when it was recorded. */\n  next: Array<Element | null>;\n  /** The previous element sibling of each `path` entry when it was recorded. */\n  previous: Array<Element | null>;\n}\n\n/** What is captured about the opener when the surface opens. */\ninterface OpenerRecord {\n  element: HTMLElement;\n  /** Its place in the document, used when it is removed or can no longer take focus. */\n  position: DomPosition;\n  /** The anchors (triggers) of the open layers whose tree held it, innermost layer first. */\n  anchors: Array<{ element: HTMLElement; position: DomPosition }>;\n}\n\n/** A point in document order: just before `ref`, or just after `ref` and its subtree. */\ninterface DomPoint {\n  ref: Element;\n  placement: 'before' | 'after';\n}\n\nconst FOLLOWING = 4; // Node.DOCUMENT_POSITION_FOLLOWING\nconst PORTAL_SELECTOR = '[data-wave-portal]';\n\nfunction isValidTarget(el: HTMLElement | null | undefined): el is HTMLElement {\n  if (!el || !el.isConnected) return false;\n  if (!isFocusable(el)) return false; // also rejects [inert] ancestors, hidden and disabled\n  if (el.closest('[aria-hidden=\"true\"]')) return false;\n  return !isInsideOtherOpenModal(el);\n}\n\nfunction recordPosition(el: Element): DomPosition {\n  const position: DomPosition = { path: [], next: [], previous: [] };\n  const body = el.ownerDocument.body;\n  for (let node: Element | null = el; node; node = node.parentElement) {\n    position.path.push(node);\n    position.next.push(node.nextElementSibling);\n    position.previous.push(node.previousElementSibling);\n    if (node === body) break;\n  }\n  return position;\n}\n\n/**\n * The anchors of the open layers whose tree contains `opener` (a menu item's menu button),\n * innermost layer first. An opener in an allow-listed region (a toast) belongs to no layer.\n */\nfunction captureAnchors(\n  opener: HTMLElement,\n  container: HTMLElement | null | undefined,\n): OpenerRecord['anchors'] {\n  if (opener.closest(ALLOW_OUTSIDE_SELECTOR)) return [];\n  const layers = getOpenLayers()\n    .filter((layer) => isInsideLayerTree(layer.id, opener))\n    .sort((a, b) => compareLayers(b, a));\n  const anchors: OpenerRecord['anchors'] = [];\n  for (const layer of layers) {\n    const anchor = layer.getAnchor();\n    if (!anchor || anchor === opener || (container && container.contains(anchor))) continue;\n    if (anchors.some((entry) => entry.element === anchor)) continue;\n    anchors.push({ element: anchor, position: recordPosition(anchor) });\n  }\n  return anchors;\n}\n\n// ---------------------------------------------------------------------------\n// Focus tracker\n// ---------------------------------------------------------------------------\n\n/**\n * Remembers the last focused element, with its place in the document and the anchors of the\n * overlays that held it, recorded while it is still in the document. A surface captures its opener\n * in the mutation phase, and by then React has already deleted anything earlier in the tree that\n * the same commit removes. A popover rendered before a dialog, whose menu item closes the popover\n * and opens the dialog, has lost its menu item (and focus is on `<body>`) when the dialog captures.\n * The record still leads the restore to the popover's trigger. It lives in\n * `getGlobalRegistry('restoreFocusTracker')`, so two copies of the library share one set of\n * listeners.\n */\ninterface FocusTracker {\n  /** Mounted `useRestoreFocus` instances: the listeners are installed while there is one. */\n  users: number;\n  /** The last focused element; `null` once focus was moved away from it on purpose. */\n  last: OpenerRecord | null;\n  /** Removes the listeners; `null` while none are installed. */\n  uninstall: (() => void) | null;\n  /**\n   * The mounted surfaces, as the other instances see them (see {@link isClosingByHover}). Created\n   * on first use: a tracker made by another copy of the library does not have it.\n   */\n  surfaces?: Set<SurfaceEntry>;\n}\n\n/** A mounted `useRestoreFocus`, as the other instances see it. */\ninterface SurfaceEntry {\n  /** Whether the surface is closing by hover (its `isHoverClose`). */\n  isHoverClose(): boolean;\n  /** The surface element, while there is one. */\n  getContainer(): HTMLElement | null;\n  /** The element the surface was opened from: its captured opener, else its trigger. */\n  getOpener(): HTMLElement | null;\n}\n\nfunction getSurfaceEntries(): Set<SurfaceEntry> {\n  const tracker = getFocusTracker();\n  tracker.surfaces ??= new Set();\n  return tracker.surfaces;\n}\n\n/**\n * Whether the close of `entry` is a hover close: its own, or that of a surface holding the element\n * it was opened from (a submenu in a menu that closes by hover, a hover card inside a hover card,\n * at any depth), which takes it along.\n */\nfunction isClosingByHover(entry: SurfaceEntry, seen = new Set<SurfaceEntry>()): boolean {\n  if (seen.has(entry)) return false;\n  seen.add(entry);\n  if (entry.isHoverClose()) return true;\n  const opener = entry.getOpener();\n  if (!opener) return false;\n  for (const other of getSurfaceEntries()) {\n    const container = other === entry ? null : other.getContainer();\n    if (container && container.contains(opener) && isClosingByHover(other, seen)) return true;\n  }\n  return false;\n}\n\n/** Whether this close is a hover close: the surface's own, or that of a surface it was opened from. */\nfunction isHoverCloseOf(entry: SurfaceEntry | null, options: UseRestoreFocusOptions): boolean {\n  return entry ? isClosingByHover(entry) : options.isHoverClose?.() === true;\n}\n\nfunction getFocusTracker(): FocusTracker {\n  return getGlobalRegistry<FocusTracker>('restoreFocusTracker', () => ({\n    users: 0,\n    last: null,\n    uninstall: null,\n  }));\n}\n\nconst ELEMENT_NODE = 1;\n\nfunction isElementTarget(target: EventTarget | null): target is HTMLElement {\n  return !!target && (target as Partial<Node>).nodeType === ELEMENT_NODE;\n}\n\nfunction recordFocus(tracker: FocusTracker, el: HTMLElement): void {\n  const doc = el.ownerDocument;\n  if (el === doc.body || el === doc.documentElement) {\n    tracker.last = null;\n    return;\n  }\n  tracker.last = { element: el, position: recordPosition(el), anchors: captureAnchors(el, null) };\n}\n\n/**\n * A layer opened or closed: re-record the focused element's place and overlays while it is still in\n * the document. An element focused as its popover opens (autoFocus) gets focus before the\n * popover's layer registers. Anchors found earlier are kept (a layer unregistering as its content\n * is deleted no longer reports it).\n */\nfunction refreshFocusRecord(tracker: FocusTracker): void {\n  const last = tracker.last;\n  if (!last || !last.element.isConnected) return;\n  const anchors = captureAnchors(last.element, null);\n  for (const anchor of last.anchors) {\n    if (!anchors.some((entry) => entry.element === anchor.element)) anchors.push(anchor);\n  }\n  tracker.last = { element: last.element, position: recordPosition(last.element), anchors };\n}\n\n/** Installs the tracker's listeners while at least one `useRestoreFocus` is mounted. */\nfunction retainFocusTracker(): () => void {\n  if (typeof document === 'undefined') return () => {};\n  const tracker = getFocusTracker();\n  tracker.users += 1;\n  if (!tracker.uninstall) {\n    const doc = document;\n    const onFocusIn = (event: FocusEvent) => {\n      if (isElementTarget(event.target)) recordFocus(tracker, event.target);\n    };\n    // Focus leaves for nowhere when the element is removed (some browsers fire focusout then) or\n    // when the user presses a non-focusable spot. Decide once the current task has run: an element\n    // still in the document that can take focus was left on purpose and is no opener to return to.\n    const onFocusOut = (event: FocusEvent) => {\n      const target = event.target;\n      if (event.relatedTarget || !isElementTarget(target)) return;\n      queueMicrotask(() => {\n        if (tracker.last?.element !== target) return;\n        if (!target.isConnected || !isFocusable(target)) return;\n        if (target.ownerDocument.activeElement !== target) tracker.last = null;\n      });\n    };\n    doc.addEventListener('focusin', onFocusIn, true);\n    doc.addEventListener('focusout', onFocusOut, true);\n    const unsubscribe = subscribeLayers(() => refreshFocusRecord(tracker));\n    if (isElementTarget(doc.activeElement)) recordFocus(tracker, doc.activeElement);\n    tracker.uninstall = () => {\n      doc.removeEventListener('focusin', onFocusIn, true);\n      doc.removeEventListener('focusout', onFocusOut, true);\n      unsubscribe();\n      tracker.last = null;\n    };\n  }\n  let retained = true;\n  return () => {\n    if (!retained) return;\n    retained = false;\n    tracker.users = Math.max(0, tracker.users - 1);\n    if (tracker.users > 0) return;\n    tracker.uninstall?.();\n    tracker.uninstall = null;\n  };\n}\n\n/**\n * The tracker's record of the element focus was lost from: it no longer has focus and was removed,\n * or can no longer take focus (disabled, hidden, made inert). `null` when focus was moved away from\n * it on purpose, or it still has focus.\n */\nfunction getLostFocus(): OpenerRecord | null {\n  const last = getFocusTracker().last;\n  if (!last) return null;\n  const { element } = last;\n  if (element.ownerDocument.activeElement === element) return null;\n  if (element.isConnected && isFocusable(element)) return null;\n  return last;\n}\n\n/**\n * The element to restore to when the surface opens: the trigger, else the focused element, else —\n * focus already lost to `<body>` — the element the focus tracker saw lose it.\n */\nfunction captureOpener(options: UseRestoreFocusOptions): OpenerRecord | null {\n  if (typeof document === 'undefined') return null;\n  const { container, triggerRef } = options;\n  const isCandidate = (el: Element | null | undefined): el is HTMLElement =>\n    !!el &&\n    el !== el.ownerDocument.body &&\n    el !== el.ownerDocument.documentElement &&\n    !(container && container.contains(el));\n  const trigger = triggerRef?.current;\n  const active = document.activeElement;\n  let element: HTMLElement | null = null;\n  if (isCandidate(trigger)) element = trigger;\n  else if (isCandidate(active)) element = active;\n  if (element) {\n    return {\n      element,\n      position: recordPosition(element),\n      anchors: captureAnchors(element, container),\n    };\n  }\n  // The opener was removed earlier in this commit (a menu item in a popover that closed as this\n  // surface opened), or can no longer take focus: use what the tracker recorded while it could.\n  const lost = getLostFocus();\n  if (!lost || !isCandidate(lost.element)) return null;\n  return {\n    element: lost.element,\n    position: lost.position,\n    anchors: lost.anchors.filter((anchor) => !(container && container.contains(anchor.element))),\n  };\n}\n\n/** A layer's surface (or its first tabbable element), for the last-resort fallbacks. */\nfunction getLayerTargets(layer: LayerRecord | null): HTMLElement[] {\n  if (!layer) return [];\n  const targets: HTMLElement[] = [];\n  for (const el of layer.getElements()) {\n    if (!el) continue;\n    targets.push(el);\n    const first = getFirstTabbable(el);\n    if (first) targets.push(first);\n  }\n  return targets;\n}\n\nfunction isAfterPoint(el: Element, point: DomPoint): boolean {\n  const { ref, placement } = point;\n  if (el === ref) return placement === 'before';\n  const follows = (ref.compareDocumentPosition(el) & FOLLOWING) !== 0;\n  return placement === 'before' ? follows : follows && !ref.contains(el);\n}\n\n/**\n * Where to look once the recorded element is gone (or cannot take focus): its nearest ancestor\n * still in the document, and the point where the element used to be. `null` when its whole overlay\n * (the portal wrapper) was removed: that spot means nothing on the page.\n */\nfunction resolvePoint(position: DomPosition): { root: Element; point: DomPoint } | null {\n  const { path } = position;\n  const index = path.findIndex((el) => el.isConnected);\n  if (index === -1) return null;\n  if (index === 0) {\n    const root = path[0].parentElement;\n    return root ? { root, point: { ref: path[0], placement: 'after' } } : null;\n  }\n  if (path.slice(0, index).some((el) => el.matches(PORTAL_SELECTOR))) return null;\n  const root = path[index];\n  const next = position.next[index - 1];\n  if (next && next.parentElement === root) {\n    return { root, point: { ref: next, placement: 'before' } };\n  }\n  const previous = position.previous[index - 1];\n  if (previous && previous.parentElement === root) {\n    return { root, point: { ref: previous, placement: 'after' } };\n  }\n  return { root, point: { ref: root, placement: 'before' } };\n}\n\n/**\n * Tabbable elements near a recorded position, nearest first. In the innermost surviving ancestor\n * that holds a valid one: the first after the old spot (where Tab would have gone from there),\n * else the last before it; then the same one level up. The search stops at the element's overlay\n * (its portal wrapper) and never reaches behind an open modal.\n */\nfunction getNearbyTargets(\n  position: DomPosition,\n  container: HTMLElement | null | undefined,\n): HTMLElement[] {\n  const resolved = resolvePoint(position);\n  if (!resolved) return [];\n  const { root, point } = resolved;\n  const body = root.ownerDocument.body;\n  const levels: Element[] = [];\n  for (let level: Element | null = root; level; level = level.parentElement) {\n    if (isInsideOtherOpenModal(level)) break;\n    levels.push(level);\n    if (level === body || level.matches(PORTAL_SELECTOR)) break;\n  }\n  if (levels.length === 0) return [];\n  const candidates = getTabbableElements(levels[levels.length - 1])\n    .filter((el) => !(container && container.contains(el)) && isValidTarget(el))\n    .sort((a, b) => ((a.compareDocumentPosition(b) & FOLLOWING) !== 0 ? -1 : 1));\n  const targets: HTMLElement[] = [];\n  for (const level of levels) {\n    const inLevel = candidates.filter((el) => level.contains(el) && !targets.includes(el));\n    const after = inLevel.find((el) => isAfterPoint(el, point));\n    const before = inLevel.filter((el) => !isAfterPoint(el, point)).pop();\n    if (after) targets.push(after);\n    if (before) targets.push(before);\n  }\n  return targets;\n}\n\n/**\n * Whether the restore acts for this close: always while focus is inside the surface; otherwise\n * never for a hover close (`isClosingByHover`, asked only then), and with `onlyIfFocusInside` only\n * when focus was lost to `<body>`.\n */\nfunction shouldRestore(options: UseRestoreFocusOptions, isHoverClose: () => boolean): boolean {\n  if (typeof document === 'undefined') return false;\n  const active = document.activeElement;\n  const onBody = !active || active === document.body || active === document.documentElement;\n  if (!onBody && options.container?.contains(active)) return true;\n  if (!onBody && options.onlyIfFocusInside) return false;\n  return !isHoverClose();\n}\n\n/**\n * Where to go when the opener was removed or can no longer take focus, nearest first: the tabbable\n * element next to where it was, else the trigger of the overlay it was in (a menu item's menu\n * button), else the element next to that trigger.\n */\nfunction* getReplacementTargets(\n  opener: OpenerRecord,\n  container: HTMLElement | null | undefined,\n): Generator<HTMLElement> {\n  yield* getNearbyTargets(opener.position, container);\n  for (const anchor of opener.anchors) yield anchor.element;\n  for (const anchor of opener.anchors) yield* getNearbyTargets(anchor.position, container);\n}\n\n/** Restore targets in order of preference, computed lazily (the later ones cost more). */\nfunction* restoreCandidates(\n  latest: Latest,\n  opener: OpenerRecord | null,\n): Generator<HTMLElement | null | undefined> {\n  const { options, parentLayerId } = latest;\n  yield options.finalFocusRef?.current;\n  yield opener?.element;\n  yield options.triggerRef?.current;\n  yield options.fallback?.();\n  const replacements = opener ? getReplacementTargets(opener, options.container) : null;\n  const parentLayer = parentLayerId === null ? null : getLayer(parentLayerId);\n  const outsideParent: HTMLElement[] = [];\n  if (parentLayer) {\n    // The surface was rendered inside a layer that stays open (a confirm Dialog in a Drawer): the\n    // opener's replacement inside that layer (the next row after a delete) comes before the\n    // layer's surface, so where the surface sits in the React tree does not change the result.\n    for (const target of replacements ?? []) {\n      if (isInsideLayerTree(parentLayer.id, target)) yield target;\n      else outsideParent.push(target);\n    }\n    yield* getLayerTargets(parentLayer);\n    yield* outsideParent;\n  } else if (replacements) {\n    yield* replacements;\n  }\n  // Still nothing: into the modal that stays open, never onto the inert page behind it.\n  yield* getLayerTargets(getTopmostLayer((layer) => layer.kind === 'modal'));\n}\n\nfunction restore(latest: Latest, opener: OpenerRecord | null): void {\n  const container = latest.options.container;\n  for (const candidate of restoreCandidates(latest, opener)) {\n    if (container && candidate && container.contains(candidate)) continue;\n    if (isValidTarget(candidate) && focusElement(candidate, { preventScroll: true })) return;\n  }\n}\n\n/**\n * Returns focus to where it came from when a surface closes (dialogs, drawers, popovers, menus,\n * the DatePicker calendar, TeachingPopover).\n *\n * - **Capture**: when `enabled` flips to `true`, the opener is captured in an insertion effect —\n *   before React applies `autoFocus` inside the new surface — preferring `triggerRef.current` and\n *   ignoring `<body>` and elements inside `container`. Its place in the document and the triggers\n *   of the overlays it sits in are recorded with it. When focus is already on `<body>` because\n *   the focused element was removed earlier in the same commit (a menu item in a popover that\n *   closes as the dialog it opens appears, the popover coming first in the tree), a document\n *   focus tracker supplies that element with its recorded place and overlay triggers. The tracker\n *   runs while any instance of the hook is mounted, and it forgets an element the user moved focus\n *   away from on purpose.\n * - **Restore** when `enabled` flips to `false` (layout phase) and when the component unmounts\n *   while enabled. The unmount restore runs in a microtask and is cancelled if the same instance\n *   mounts again, so React StrictMode's simulated unmount does not pull focus out of a surface\n *   that just opened.\n * - **Targets**, first valid wins:\n *   1. `finalFocusRef` → the captured opener → `triggerRef` → `fallback()`.\n *   2. When the opener was removed or cannot take focus, its replacement, nearest first: the\n *      tabbable element next to where it was (in the innermost surviving ancestor that holds one,\n *      the next one — the next row's action after a delete — else the previous one; then the same\n *      one level up), else the trigger of the overlay it was in (a menu item's menu button), else\n *      the element next to that trigger. When the surface is rendered inside another open layer\n *      (its parent layer, from `DismissLayerContext`: a confirm Dialog in a Drawer's content),\n *      only the replacements inside that layer's tree are tried here.\n *   3. The parent layer's surface, then the replacements outside the parent layer.\n *   4. The surface of the modal layer that stays open.\n *\n *   So a confirm Dialog rendered in a Drawer's content and one rendered next to the Drawer both\n *   return focus to the adjacent row, not to the Drawer's panel. A target is valid when it is\n *   connected, focusable, not inside `[inert]` or `[aria-hidden=\"true\"]`, and not cut off behind\n *   another open modal layer — so focus never lands on the inert page behind a Drawer that stays\n *   open, and is not dropped on `<body>` while a valid target exists. Focus uses `preventScroll`.\n * - `onlyIfFocusInside` (popovers): restores only when focus is inside the surface or was lost to\n *   `<body>`.\n * - `isHoverClose`: a close by the hover intent restores only when focus is inside the surface, so\n *   a hover close never moves focus from `<body>` or from where the user put it. The same holds for\n *   a surface opened from inside one that closes by hover (a submenu, a hover card in a hover\n *   card): every mounted instance is known to the others through the focus tracker's record.\n */\nexport function useRestoreFocus(options: UseRestoreFocusOptions): void {\n  const parentLayerId = React.useContext(DismissLayerContext);\n  const latestRef = useRef<Latest>({ options, parentLayerId });\n  const capturedRef = useRef<OpenerRecord | null>(null);\n  const insertionEnabledRef = useRef(false);\n  const layoutEnabledRef = useRef(false);\n  const scheduledRef = useRef<object | null>(null);\n  const entryRef = useRef<SurfaceEntry | null>(null);\n  const { enabled } = options;\n\n  // Track focus while mounted, so an opener removed in the commit that opens the surface is known.\n  // And be known to the other instances: a surface closing by hover takes along the surfaces opened\n  // from inside it, whose closes are then hover closes too.\n  useLayoutEffect(() => {\n    const release = retainFocusTracker();\n    const entry: SurfaceEntry = {\n      isHoverClose: () => latestRef.current.options.isHoverClose?.() === true,\n      getContainer: () => latestRef.current.options.container ?? null,\n      getOpener: () =>\n        capturedRef.current?.element ?? latestRef.current.options.triggerRef?.current ?? null,\n    };\n    entryRef.current = entry;\n    const surfaces = getSurfaceEntries();\n    surfaces.add(entry);\n    return () => {\n      release();\n      // Kept to the end of the commit: a surface opened from inside this one, closing along with\n      // it, still asks about it.\n      queueMicrotask(() => surfaces.delete(entry));\n    };\n  }, []);\n\n  // Mutation phase: record the latest options and capture the opener when `enabled` turns on,\n  // before autoFocus (layout phase) or a focus trap's initial focus moves focus into the surface.\n  useInsertionEffect(() => {\n    latestRef.current = { options, parentLayerId };\n    const wasEnabled = insertionEnabledRef.current;\n    insertionEnabledRef.current = options.enabled;\n    if (options.enabled && !wasEnabled) capturedRef.current = captureOpener(options);\n  });\n\n  // `enabled` true → false: restore in the layout phase (after every cleanup of this commit, so a\n  // modal's isolation is already gone).\n  useLayoutEffect(() => {\n    const wasEnabled = layoutEnabledRef.current;\n    layoutEnabledRef.current = enabled;\n    if (!wasEnabled || enabled) return;\n    const latest = latestRef.current;\n    const captured = capturedRef.current;\n    const entry = entryRef.current;\n    // Decided before the opener is dropped: a hover close is also recognised through it.\n    const acts = shouldRestore(latest.options, () => isHoverCloseOf(entry, latest.options));\n    capturedRef.current = null;\n    if (acts) restore(latest, captured);\n  }, [enabled]);\n\n  // Unmount while enabled: restore in a microtask, cancelled by a remount of this instance.\n  useLayoutEffect(() => {\n    const latest = latestRef;\n    const captured = capturedRef;\n    const scheduled = scheduledRef;\n    const entryHolder = entryRef;\n    scheduled.current = null;\n    return () => {\n      const snapshot = latest.current;\n      if (!snapshot.options.enabled) return;\n      // Decide now, while the surface is still in the document.\n      const entry = entryHolder.current;\n      if (!shouldRestore(snapshot.options, () => isHoverCloseOf(entry, snapshot.options))) return;\n      const token = {};\n      scheduled.current = token;\n      const opener = captured.current;\n      queueMicrotask(() => {\n        if (scheduled.current !== token) return;\n        scheduled.current = null;\n        const active = typeof document === 'undefined' ? null : document.activeElement;\n        const container = snapshot.options.container;\n        // Focus placed elsewhere in the meantime (another surface opened) wins.\n        if (\n          active &&\n          active !== document.body &&\n          active !== document.documentElement &&\n          !(container && container.contains(active))\n        ) {\n          return;\n        }\n        restore(snapshot, opener);\n      });\n    };\n  }, []);\n}\n"],"mappings":"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"}
+{"version":3,"file":"useRestoreFocus.cjs","names":["isFocusable","isInsideOtherOpenModal","getOpenLayers","isInsideLayerTree","compareLayers","getGlobalRegistry","subscribeLayers","getFirstTabbable","getTabbableElements","isDescendantLayer","getLayer","getTopmostLayer","focusElement","React","DismissLayerContext","useRef","require_runtime","require_globalRegistry","require_focus","require_layers","require_useDismiss","react","FOLLOWING","PORTAL_SELECTOR","isValidTarget","el","recordPosition","position","body","node","captureAnchors","opener","layers","layer","b","a","anchors","anchor","container","entry","getSurfaceEntries","tracker","getFocusTracker","isClosingByHover","seen","other","isHoverCloseOf","options","ELEMENT_NODE","isElementTarget","target","recordFocus","doc","refreshFocusRecord","last","retainFocusTracker","onFocusIn","event","onFocusOut","unsubscribe","retained","getLostFocus","element","captureOpener","isCandidate","trigger","triggerRef","active","lost","getLayerTargets","targets","first","isAfterPoint","point","ref","placement","follows","resolvePoint","index","path","root","next","previous","getNearbyTargets","resolved","levels","level","candidates","inLevel","after","before","isFocusLostFromInside","isInLayerOpenedFrom","layerId","shouldRestore","onBody","isHoverClose","getReplacementTargets","restoreCandidates","latest","replacements","parentLayer","parentLayerId","outsideParent","restore","candidate","useRestoreFocus","latestRef","capturedRef","insertionEnabledRef","layoutEnabledRef","scheduledRef","entryRef","release","surfaces","wasEnabled","enabled","captured","acts","scheduled","entryHolder","snapshot","token"],"sources":["../../src/hooks/useRestoreFocus.ts"],"sourcesContent":["import * as React from 'react';\nimport { useInsertionEffect, useLayoutEffect, useRef } from 'react';\nimport { focusElement, getFirstTabbable, getTabbableElements, isFocusable } from '../lib/focus';\nimport { getGlobalRegistry } from '../lib/globalRegistry';\nimport {\n  ALLOW_OUTSIDE_SELECTOR,\n  compareLayers,\n  getLayer,\n  getOpenLayers,\n  getTopmostLayer,\n  isDescendantLayer,\n  isInsideLayerTree,\n  isInsideOtherOpenModal,\n  subscribeLayers,\n  type LayerRecord,\n} from '../lib/layers';\nimport { DismissLayerContext } from './useDismiss';\n\n/** Options of {@link useRestoreFocus}. */\nexport interface UseRestoreFocusOptions {\n  /** `true` while the surface is open. */\n  enabled: boolean;\n  /** The layer surface: opener candidates inside it are ignored. */\n  container?: HTMLElement | null;\n  /** The trigger: preferred restore target. */\n  triggerRef?: React.RefObject<HTMLElement | null>;\n  /** Consumer override: focused first when valid. */\n  finalFocusRef?: React.RefObject<HTMLElement | null>;\n  /** Used when neither the override, the opener nor the trigger can take focus. */\n  fallback?: () => HTMLElement | null;\n  /**\n   * Popovers: restore only when focus was inside the surface (or lost to `<body>`) at close, so a\n   * click that moved focus elsewhere is respected. @default false\n   */\n  onlyIfFocusInside?: boolean;\n  /**\n   * Read when the surface closes, or unmounts while open: `true` when the hover intent closed it\n   * (Popover and Menu `openOnHover`, a submenu closing by hover). A hover close never moves focus:\n   * it restores only while focus is inside the surface, so focus on `<body>` (where a hover-opened\n   * surface leaves it) or elsewhere stays where it is. A surface opened from inside one that closes\n   * by hover (its opener, else its trigger, lies in that surface: a submenu, a hover card in a\n   * hover card, at any depth) is taken along, and its close counts as a hover close too. Every\n   * other close keeps the rules above.\n   */\n  isHoverClose?: () => boolean;\n  /**\n   * Surfaces that do not trap focus (a non-modal Dialog or Drawer, an inline Drawer): restore only\n   * when focus is inside the surface at close, or was lost to `<body>` from an element inside it\n   * (removed, or made unable to take focus). Focus elsewhere, or on `<body>` for another reason\n   * (nothing had focus, a press on a spot that takes no focus, a close from code), stays where it\n   * is. Wins over `onlyIfFocusInside`. Focus in a layer opened from the surface (a Popover or a\n   * confirm Dialog, portaled outside it) counts as inside: a descendant layer of `layerId`, or a\n   * layer anchored to an element inside the surface; so does focus lost to `<body>` from one.\n   * @default false\n   */\n  requireFocusInside?: boolean;\n  /**\n   * The surface's own dismiss layer, with `requireFocusInside`: focus in one of its descendant\n   * layers counts as inside the surface, also after the surface's layer has unregistered (in the\n   * commit that closes it).\n   */\n  layerId?: string;\n}\n\ninterface Latest {\n  options: UseRestoreFocusOptions;\n  parentLayerId: string | null;\n}\n\n/** Where an element sat in the document, recorded so a spot near it can be found once it is gone. */\ninterface DomPosition {\n  /** The element and its ancestors up to `<body>`, innermost first. */\n  path: Element[];\n  /** The next element sibling of each `path` entry when it was recorded. */\n  next: Array<Element | null>;\n  /** The previous element sibling of each `path` entry when it was recorded. */\n  previous: Array<Element | null>;\n}\n\n/** What is captured about the opener when the surface opens. */\ninterface OpenerRecord {\n  element: HTMLElement;\n  /** Its place in the document, used when it is removed or can no longer take focus. */\n  position: DomPosition;\n  /** The anchors (triggers) of the open layers whose tree held it, innermost layer first. */\n  anchors: Array<{ element: HTMLElement; position: DomPosition }>;\n}\n\n/** A point in document order: just before `ref`, or just after `ref` and its subtree. */\ninterface DomPoint {\n  ref: Element;\n  placement: 'before' | 'after';\n}\n\nconst FOLLOWING = 4; // Node.DOCUMENT_POSITION_FOLLOWING\nconst PORTAL_SELECTOR = '[data-wave-portal]';\n\nfunction isValidTarget(el: HTMLElement | null | undefined): el is HTMLElement {\n  if (!el || !el.isConnected) return false;\n  if (!isFocusable(el)) return false; // also rejects [inert] ancestors, hidden and disabled\n  if (el.closest('[aria-hidden=\"true\"]')) return false;\n  return !isInsideOtherOpenModal(el);\n}\n\nfunction recordPosition(el: Element): DomPosition {\n  const position: DomPosition = { path: [], next: [], previous: [] };\n  const body = el.ownerDocument.body;\n  for (let node: Element | null = el; node; node = node.parentElement) {\n    position.path.push(node);\n    position.next.push(node.nextElementSibling);\n    position.previous.push(node.previousElementSibling);\n    if (node === body) break;\n  }\n  return position;\n}\n\n/**\n * The anchors of the open layers whose tree contains `opener` (a menu item's menu button),\n * innermost layer first. An opener in an allow-listed region (a toast) belongs to no layer.\n */\nfunction captureAnchors(\n  opener: HTMLElement,\n  container: HTMLElement | null | undefined,\n): OpenerRecord['anchors'] {\n  if (opener.closest(ALLOW_OUTSIDE_SELECTOR)) return [];\n  const layers = getOpenLayers()\n    .filter((layer) => isInsideLayerTree(layer.id, opener))\n    .sort((a, b) => compareLayers(b, a));\n  const anchors: OpenerRecord['anchors'] = [];\n  for (const layer of layers) {\n    const anchor = layer.getAnchor();\n    if (!anchor || anchor === opener || (container && container.contains(anchor))) continue;\n    if (anchors.some((entry) => entry.element === anchor)) continue;\n    anchors.push({ element: anchor, position: recordPosition(anchor) });\n  }\n  return anchors;\n}\n\n// ---------------------------------------------------------------------------\n// Focus tracker\n// ---------------------------------------------------------------------------\n\n/**\n * Remembers the last focused element, with its place in the document and the anchors of the\n * overlays that held it, recorded while it is still in the document. A surface captures its opener\n * in the mutation phase, and by then React has already deleted anything earlier in the tree that\n * the same commit removes. A popover rendered before a dialog, whose menu item closes the popover\n * and opens the dialog, has lost its menu item (and focus is on `<body>`) when the dialog captures.\n * The record still leads the restore to the popover's trigger. It lives in\n * `getGlobalRegistry('restoreFocusTracker')`, so two copies of the library share one set of\n * listeners.\n */\ninterface FocusTracker {\n  /** Mounted `useRestoreFocus` instances: the listeners are installed while there is one. */\n  users: number;\n  /** The last focused element; `null` once focus was moved away from it on purpose. */\n  last: OpenerRecord | null;\n  /** Removes the listeners; `null` while none are installed. */\n  uninstall: (() => void) | null;\n  /**\n   * The mounted surfaces, as the other instances see them (see {@link isClosingByHover}). Created\n   * on first use: a tracker made by another copy of the library does not have it.\n   */\n  surfaces?: Set<SurfaceEntry>;\n}\n\n/** A mounted `useRestoreFocus`, as the other instances see it. */\ninterface SurfaceEntry {\n  /** Whether the surface is closing by hover (its `isHoverClose`). */\n  isHoverClose(): boolean;\n  /** The surface element, while there is one. */\n  getContainer(): HTMLElement | null;\n  /** The element the surface was opened from: its captured opener, else its trigger. */\n  getOpener(): HTMLElement | null;\n}\n\nfunction getSurfaceEntries(): Set<SurfaceEntry> {\n  const tracker = getFocusTracker();\n  tracker.surfaces ??= new Set();\n  return tracker.surfaces;\n}\n\n/**\n * Whether the close of `entry` is a hover close: its own, or that of a surface holding the element\n * it was opened from (a submenu in a menu that closes by hover, a hover card inside a hover card,\n * at any depth), which takes it along.\n */\nfunction isClosingByHover(entry: SurfaceEntry, seen = new Set<SurfaceEntry>()): boolean {\n  if (seen.has(entry)) return false;\n  seen.add(entry);\n  if (entry.isHoverClose()) return true;\n  const opener = entry.getOpener();\n  if (!opener) return false;\n  for (const other of getSurfaceEntries()) {\n    const container = other === entry ? null : other.getContainer();\n    if (container && container.contains(opener) && isClosingByHover(other, seen)) return true;\n  }\n  return false;\n}\n\n/** Whether this close is a hover close: the surface's own, or that of a surface it was opened from. */\nfunction isHoverCloseOf(entry: SurfaceEntry | null, options: UseRestoreFocusOptions): boolean {\n  return entry ? isClosingByHover(entry) : options.isHoverClose?.() === true;\n}\n\nfunction getFocusTracker(): FocusTracker {\n  return getGlobalRegistry<FocusTracker>('restoreFocusTracker', () => ({\n    users: 0,\n    last: null,\n    uninstall: null,\n  }));\n}\n\nconst ELEMENT_NODE = 1;\n\nfunction isElementTarget(target: EventTarget | null): target is HTMLElement {\n  return !!target && (target as Partial<Node>).nodeType === ELEMENT_NODE;\n}\n\nfunction recordFocus(tracker: FocusTracker, el: HTMLElement): void {\n  const doc = el.ownerDocument;\n  if (el === doc.body || el === doc.documentElement) {\n    tracker.last = null;\n    return;\n  }\n  tracker.last = { element: el, position: recordPosition(el), anchors: captureAnchors(el, null) };\n}\n\n/**\n * A layer opened or closed: re-record the focused element's place and overlays while it is still in\n * the document. An element focused as its popover opens (autoFocus) gets focus before the\n * popover's layer registers. Anchors found earlier are kept (a layer unregistering as its content\n * is deleted no longer reports it).\n */\nfunction refreshFocusRecord(tracker: FocusTracker): void {\n  const last = tracker.last;\n  if (!last || !last.element.isConnected) return;\n  const anchors = captureAnchors(last.element, null);\n  for (const anchor of last.anchors) {\n    if (!anchors.some((entry) => entry.element === anchor.element)) anchors.push(anchor);\n  }\n  tracker.last = { element: last.element, position: recordPosition(last.element), anchors };\n}\n\n/** Installs the tracker's listeners while at least one `useRestoreFocus` is mounted. */\nfunction retainFocusTracker(): () => void {\n  if (typeof document === 'undefined') return () => {};\n  const tracker = getFocusTracker();\n  tracker.users += 1;\n  if (!tracker.uninstall) {\n    const doc = document;\n    const onFocusIn = (event: FocusEvent) => {\n      if (isElementTarget(event.target)) recordFocus(tracker, event.target);\n    };\n    // Focus leaves for nowhere when the element is removed (some browsers fire focusout then) or\n    // when the user presses a non-focusable spot. Decide once the current task has run: an element\n    // still in the document that can take focus was left on purpose and is no opener to return to.\n    const onFocusOut = (event: FocusEvent) => {\n      const target = event.target;\n      if (event.relatedTarget || !isElementTarget(target)) return;\n      queueMicrotask(() => {\n        if (tracker.last?.element !== target) return;\n        if (!target.isConnected || !isFocusable(target)) return;\n        if (target.ownerDocument.activeElement !== target) tracker.last = null;\n      });\n    };\n    doc.addEventListener('focusin', onFocusIn, true);\n    doc.addEventListener('focusout', onFocusOut, true);\n    const unsubscribe = subscribeLayers(() => refreshFocusRecord(tracker));\n    if (isElementTarget(doc.activeElement)) recordFocus(tracker, doc.activeElement);\n    tracker.uninstall = () => {\n      doc.removeEventListener('focusin', onFocusIn, true);\n      doc.removeEventListener('focusout', onFocusOut, true);\n      unsubscribe();\n      tracker.last = null;\n    };\n  }\n  let retained = true;\n  return () => {\n    if (!retained) return;\n    retained = false;\n    tracker.users = Math.max(0, tracker.users - 1);\n    if (tracker.users > 0) return;\n    tracker.uninstall?.();\n    tracker.uninstall = null;\n  };\n}\n\n/**\n * The tracker's record of the element focus was lost from: it no longer has focus and was removed,\n * or can no longer take focus (disabled, hidden, made inert). `null` when focus was moved away from\n * it on purpose, or it still has focus.\n */\nfunction getLostFocus(): OpenerRecord | null {\n  const last = getFocusTracker().last;\n  if (!last) return null;\n  const { element } = last;\n  if (element.ownerDocument.activeElement === element) return null;\n  if (element.isConnected && isFocusable(element)) return null;\n  return last;\n}\n\n/**\n * The element to restore to when the surface opens: the trigger, else the focused element, else —\n * focus already lost to `<body>` — the element the focus tracker saw lose it.\n */\nfunction captureOpener(options: UseRestoreFocusOptions): OpenerRecord | null {\n  if (typeof document === 'undefined') return null;\n  const { container, triggerRef } = options;\n  const isCandidate = (el: Element | null | undefined): el is HTMLElement =>\n    !!el &&\n    el !== el.ownerDocument.body &&\n    el !== el.ownerDocument.documentElement &&\n    !(container && container.contains(el));\n  const trigger = triggerRef?.current;\n  const active = document.activeElement;\n  let element: HTMLElement | null = null;\n  if (isCandidate(trigger)) element = trigger;\n  else if (isCandidate(active)) element = active;\n  if (element) {\n    return {\n      element,\n      position: recordPosition(element),\n      anchors: captureAnchors(element, container),\n    };\n  }\n  // The opener was removed earlier in this commit (a menu item in a popover that closed as this\n  // surface opened), or can no longer take focus: use what the tracker recorded while it could.\n  const lost = getLostFocus();\n  if (!lost || !isCandidate(lost.element)) return null;\n  return {\n    element: lost.element,\n    position: lost.position,\n    anchors: lost.anchors.filter((anchor) => !(container && container.contains(anchor.element))),\n  };\n}\n\n/** A layer's surface (or its first tabbable element), for the last-resort fallbacks. */\nfunction getLayerTargets(layer: LayerRecord | null): HTMLElement[] {\n  if (!layer) return [];\n  const targets: HTMLElement[] = [];\n  for (const el of layer.getElements()) {\n    if (!el) continue;\n    targets.push(el);\n    const first = getFirstTabbable(el);\n    if (first) targets.push(first);\n  }\n  return targets;\n}\n\nfunction isAfterPoint(el: Element, point: DomPoint): boolean {\n  const { ref, placement } = point;\n  if (el === ref) return placement === 'before';\n  const follows = (ref.compareDocumentPosition(el) & FOLLOWING) !== 0;\n  return placement === 'before' ? follows : follows && !ref.contains(el);\n}\n\n/**\n * Where to look once the recorded element is gone (or cannot take focus): its nearest ancestor\n * still in the document, and the point where the element used to be. `null` when its whole overlay\n * (the portal wrapper) was removed: that spot means nothing on the page.\n */\nfunction resolvePoint(position: DomPosition): { root: Element; point: DomPoint } | null {\n  const { path } = position;\n  const index = path.findIndex((el) => el.isConnected);\n  if (index === -1) return null;\n  if (index === 0) {\n    const root = path[0].parentElement;\n    return root ? { root, point: { ref: path[0], placement: 'after' } } : null;\n  }\n  if (path.slice(0, index).some((el) => el.matches(PORTAL_SELECTOR))) return null;\n  const root = path[index];\n  const next = position.next[index - 1];\n  if (next && next.parentElement === root) {\n    return { root, point: { ref: next, placement: 'before' } };\n  }\n  const previous = position.previous[index - 1];\n  if (previous && previous.parentElement === root) {\n    return { root, point: { ref: previous, placement: 'after' } };\n  }\n  return { root, point: { ref: root, placement: 'before' } };\n}\n\n/**\n * Tabbable elements near a recorded position, nearest first. In the innermost surviving ancestor\n * that holds a valid one: the first after the old spot (where Tab would have gone from there),\n * else the last before it; then the same one level up. The search stops at the element's overlay\n * (its portal wrapper) and never reaches behind an open modal.\n */\nfunction getNearbyTargets(\n  position: DomPosition,\n  container: HTMLElement | null | undefined,\n): HTMLElement[] {\n  const resolved = resolvePoint(position);\n  if (!resolved) return [];\n  const { root, point } = resolved;\n  const body = root.ownerDocument.body;\n  const levels: Element[] = [];\n  for (let level: Element | null = root; level; level = level.parentElement) {\n    if (isInsideOtherOpenModal(level)) break;\n    levels.push(level);\n    if (level === body || level.matches(PORTAL_SELECTOR)) break;\n  }\n  if (levels.length === 0) return [];\n  const candidates = getTabbableElements(levels[levels.length - 1])\n    .filter((el) => !(container && container.contains(el)) && isValidTarget(el))\n    .sort((a, b) => ((a.compareDocumentPosition(b) & FOLLOWING) !== 0 ? -1 : 1));\n  const targets: HTMLElement[] = [];\n  for (const level of levels) {\n    const inLevel = candidates.filter((el) => level.contains(el) && !targets.includes(el));\n    const after = inLevel.find((el) => isAfterPoint(el, point));\n    const before = inLevel.filter((el) => !isAfterPoint(el, point)).pop();\n    if (after) targets.push(after);\n    if (before) targets.push(before);\n  }\n  return targets;\n}\n\n/**\n * Whether focus was lost to `<body>` from an element inside `container`: the focus tracker's record\n * of the element that lost it ({@link getLostFocus}) lies in the container (its recorded path holds\n * it), also when the element has been removed since.\n */\nfunction isFocusLostFromInside(container: HTMLElement | null | undefined): boolean {\n  if (!container) return false;\n  const lost = getLostFocus();\n  if (!lost) return false;\n  if (lost.position.path.includes(container)) return true;\n  // Lost from a layer opened from the surface: the overlays that held it are anchored inside.\n  return lost.anchors.some((anchor) => anchor.position.path.includes(container));\n}\n\n/**\n * Whether `active` is in a layer opened from the surface (portaled outside it): a descendant layer\n * of the surface's layer (`layerId`), or an open layer whose tree holds it and whose anchor (its\n * trigger) is inside the surface. The toast region counts as inside every layer, never here.\n */\nfunction isInLayerOpenedFrom(\n  active: Element,\n  container: HTMLElement | null | undefined,\n  layerId: string | undefined,\n): boolean {\n  if (!container || active.closest(ALLOW_OUTSIDE_SELECTOR)) return false;\n  return getOpenLayers().some((layer) => {\n    if (layer.id === layerId || !isInsideLayerTree(layer.id, active)) return false;\n    if (layerId !== undefined && isDescendantLayer(layer.id, layerId)) return true;\n    const anchor = layer.getAnchor();\n    return !!anchor && container.contains(anchor);\n  });\n}\n\n/**\n * Whether the restore acts for this close: always while focus is inside the surface; otherwise\n * never for a hover close (`isClosingByHover`, asked only then), and with `onlyIfFocusInside` only\n * when focus was lost to `<body>`. With `requireFocusInside`, also while focus is in a layer opened\n * from the surface, from `<body>` only when focus was lost there from inside the surface (or from\n * such a layer), and never from anywhere else.\n */\nfunction shouldRestore(options: UseRestoreFocusOptions, isHoverClose: () => boolean): boolean {\n  if (typeof document === 'undefined') return false;\n  const active = document.activeElement;\n  const onBody = !active || active === document.body || active === document.documentElement;\n  if (!onBody && options.container?.contains(active)) return true;\n  if (options.requireFocusInside) {\n    if (!onBody) return isInLayerOpenedFrom(active, options.container, options.layerId);\n    return isFocusLostFromInside(options.container) && !isHoverClose();\n  }\n  if (!onBody && options.onlyIfFocusInside) return false;\n  return !isHoverClose();\n}\n\n/**\n * Where to go when the opener was removed or can no longer take focus, nearest first: the tabbable\n * element next to where it was, else the trigger of the overlay it was in (a menu item's menu\n * button), else the element next to that trigger.\n */\nfunction* getReplacementTargets(\n  opener: OpenerRecord,\n  container: HTMLElement | null | undefined,\n): Generator<HTMLElement> {\n  yield* getNearbyTargets(opener.position, container);\n  for (const anchor of opener.anchors) yield anchor.element;\n  for (const anchor of opener.anchors) yield* getNearbyTargets(anchor.position, container);\n}\n\n/** Restore targets in order of preference, computed lazily (the later ones cost more). */\nfunction* restoreCandidates(\n  latest: Latest,\n  opener: OpenerRecord | null,\n): Generator<HTMLElement | null | undefined> {\n  const { options, parentLayerId } = latest;\n  yield options.finalFocusRef?.current;\n  yield opener?.element;\n  yield options.triggerRef?.current;\n  yield options.fallback?.();\n  const replacements = opener ? getReplacementTargets(opener, options.container) : null;\n  const parentLayer = parentLayerId === null ? null : getLayer(parentLayerId);\n  const outsideParent: HTMLElement[] = [];\n  if (parentLayer) {\n    // The surface was rendered inside a layer that stays open (a confirm Dialog in a Drawer): the\n    // opener's replacement inside that layer (the next row after a delete) comes before the\n    // layer's surface, so where the surface sits in the React tree does not change the result.\n    for (const target of replacements ?? []) {\n      if (isInsideLayerTree(parentLayer.id, target)) yield target;\n      else outsideParent.push(target);\n    }\n    yield* getLayerTargets(parentLayer);\n    yield* outsideParent;\n  } else if (replacements) {\n    yield* replacements;\n  }\n  // Still nothing: into the modal that stays open, never onto the inert page behind it.\n  yield* getLayerTargets(getTopmostLayer((layer) => layer.kind === 'modal'));\n}\n\nfunction restore(latest: Latest, opener: OpenerRecord | null): void {\n  const container = latest.options.container;\n  for (const candidate of restoreCandidates(latest, opener)) {\n    if (container && candidate && container.contains(candidate)) continue;\n    if (isValidTarget(candidate) && focusElement(candidate, { preventScroll: true })) return;\n  }\n}\n\n/**\n * Returns focus to where it came from when a surface closes (dialogs, drawers, popovers, menus,\n * the DatePicker calendar, TeachingPopover).\n *\n * - **Capture**: when `enabled` flips to `true`, the opener is captured in an insertion effect —\n *   before React applies `autoFocus` inside the new surface — preferring `triggerRef.current` and\n *   ignoring `<body>` and elements inside `container`. When that finds nothing (a surface that\n *   mounts open, before the refs of its commit are attached), it is captured again in the layout\n *   phase of the same commit. Its place in the document and the triggers of the overlays it sits\n *   in are recorded with it. When focus is already on `<body>` because\n *   the focused element was removed earlier in the same commit (a menu item in a popover that\n *   closes as the dialog it opens appears, the popover coming first in the tree), a document\n *   focus tracker supplies that element with its recorded place and overlay triggers. The tracker\n *   runs while any instance of the hook is mounted, and it forgets an element the user moved focus\n *   away from on purpose.\n * - **Restore** when `enabled` flips to `false` (layout phase) and when the component unmounts\n *   while enabled. The unmount restore runs in a microtask and is cancelled if the same instance\n *   mounts again, so React StrictMode's simulated unmount does not pull focus out of a surface\n *   that just opened.\n * - **Targets**, first valid wins:\n *   1. `finalFocusRef` → the captured opener → `triggerRef` → `fallback()`.\n *   2. When the opener was removed or cannot take focus, its replacement, nearest first: the\n *      tabbable element next to where it was (in the innermost surviving ancestor that holds one,\n *      the next one — the next row's action after a delete — else the previous one; then the same\n *      one level up), else the trigger of the overlay it was in (a menu item's menu button), else\n *      the element next to that trigger. When the surface is rendered inside another open layer\n *      (its parent layer, from `DismissLayerContext`: a confirm Dialog in a Drawer's content),\n *      only the replacements inside that layer's tree are tried here.\n *   3. The parent layer's surface, then the replacements outside the parent layer.\n *   4. The surface of the modal layer that stays open.\n *\n *   So a confirm Dialog rendered in a Drawer's content and one rendered next to the Drawer both\n *   return focus to the adjacent row, not to the Drawer's panel. A target is valid when it is\n *   connected, focusable, not inside `[inert]` or `[aria-hidden=\"true\"]`, and not cut off behind\n *   another open modal layer — so focus never lands on the inert page behind a Drawer that stays\n *   open, and is not dropped on `<body>` while a valid target exists. Focus uses `preventScroll`.\n * - `onlyIfFocusInside` (popovers): restores only when focus is inside the surface or was lost to\n *   `<body>`.\n * - `requireFocusInside` (surfaces that do not trap focus: a non-modal Dialog or Drawer, an inline\n *   Drawer): restores only when focus is inside the surface or in a layer opened from it (a\n *   descendant layer of `layerId`, or a layer anchored inside the surface), or was lost to\n *   `<body>` from an element in either; a close from code while focus is on `<body>` or on the\n *   page moves nothing.\n * - `isHoverClose`: a close by the hover intent restores only when focus is inside the surface, so\n *   a hover close never moves focus from `<body>` or from where the user put it. The same holds for\n *   a surface opened from inside one that closes by hover (a submenu, a hover card in a hover\n *   card): every mounted instance is known to the others through the focus tracker's record.\n */\nexport function useRestoreFocus(options: UseRestoreFocusOptions): void {\n  const parentLayerId = React.useContext(DismissLayerContext);\n  const latestRef = useRef<Latest>({ options, parentLayerId });\n  const capturedRef = useRef<OpenerRecord | null>(null);\n  const insertionEnabledRef = useRef(false);\n  const layoutEnabledRef = useRef(false);\n  const scheduledRef = useRef<object | null>(null);\n  const entryRef = useRef<SurfaceEntry | null>(null);\n  const { enabled } = options;\n\n  // Track focus while mounted, so an opener removed in the commit that opens the surface is known.\n  // And be known to the other instances: a surface closing by hover takes along the surfaces opened\n  // from inside it, whose closes are then hover closes too.\n  useLayoutEffect(() => {\n    const release = retainFocusTracker();\n    const entry: SurfaceEntry = {\n      isHoverClose: () => latestRef.current.options.isHoverClose?.() === true,\n      getContainer: () => latestRef.current.options.container ?? null,\n      getOpener: () =>\n        capturedRef.current?.element ?? latestRef.current.options.triggerRef?.current ?? null,\n    };\n    entryRef.current = entry;\n    const surfaces = getSurfaceEntries();\n    surfaces.add(entry);\n    return () => {\n      release();\n      // Kept to the end of the commit: a surface opened from inside this one, closing along with\n      // it, still asks about it.\n      queueMicrotask(() => surfaces.delete(entry));\n    };\n  }, []);\n\n  // Mutation phase: record the latest options and capture the opener when `enabled` turns on,\n  // before autoFocus (layout phase) or a focus trap's initial focus moves focus into the surface.\n  useInsertionEffect(() => {\n    latestRef.current = { options, parentLayerId };\n    const wasEnabled = insertionEnabledRef.current;\n    insertionEnabledRef.current = options.enabled;\n    if (options.enabled && !wasEnabled) capturedRef.current = captureOpener(options);\n  });\n\n  // `enabled` false → true with nothing captured: capture again in the layout phase. A surface\n  // that mounts open (an inline Drawer with `defaultOpen`) captured before the refs of this commit\n  // were attached, so its trigger was not known yet.\n  // `enabled` true → false: restore in the layout phase (after every cleanup of this commit, so a\n  // modal's isolation is already gone).\n  useLayoutEffect(() => {\n    const wasEnabled = layoutEnabledRef.current;\n    layoutEnabledRef.current = enabled;\n    if (enabled && !wasEnabled && !capturedRef.current) {\n      capturedRef.current = captureOpener(latestRef.current.options);\n    }\n    if (!wasEnabled || enabled) return;\n    const latest = latestRef.current;\n    const captured = capturedRef.current;\n    const entry = entryRef.current;\n    // Decided before the opener is dropped: a hover close is also recognised through it.\n    const acts = shouldRestore(latest.options, () => isHoverCloseOf(entry, latest.options));\n    capturedRef.current = null;\n    if (acts) restore(latest, captured);\n  }, [enabled]);\n\n  // Unmount while enabled: restore in a microtask, cancelled by a remount of this instance.\n  useLayoutEffect(() => {\n    const latest = latestRef;\n    const captured = capturedRef;\n    const scheduled = scheduledRef;\n    const entryHolder = entryRef;\n    scheduled.current = null;\n    return () => {\n      const snapshot = latest.current;\n      if (!snapshot.options.enabled) return;\n      // Decide now, while the surface is still in the document.\n      const entry = entryHolder.current;\n      if (!shouldRestore(snapshot.options, () => isHoverCloseOf(entry, snapshot.options))) return;\n      const token = {};\n      scheduled.current = token;\n      const opener = captured.current;\n      queueMicrotask(() => {\n        if (scheduled.current !== token) return;\n        scheduled.current = null;\n        const active = typeof document === 'undefined' ? null : document.activeElement;\n        const container = snapshot.options.container;\n        // Focus placed elsewhere in the meantime (another surface opened) wins.\n        if (\n          active &&\n          active !== document.body &&\n          active !== document.documentElement &&\n          !(container && container.contains(active))\n        ) {\n          return;\n        }\n        restore(snapshot, opener);\n      });\n    };\n  }, []);\n}\n"],"mappings":"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"}

package/dist/hooks/useRestoreFocus.mjs

@@ -1,16 +1,16 @@
 "use client";
 import { getGlobalRegistry as e } from "../lib/globalRegistry.mjs";
 import { focusElement as t, getFirstTabbable as n, getTabbableElements as r, isFocusable as i } from "../lib/focus.mjs";
-import { compareLayers as a, getLayer as o, getOpenLayers as s, getTopmostLayer as c, isInsideLayerTree as l, isInsideOtherOpenModal as u, subscribeLayers as d } from "../lib/layers.mjs";
-import { DismissLayerContext as f } from "./useDismiss.mjs";
-import * as p from "react";
-import { useInsertionEffect as m, useLayoutEffect as h, useRef as g } from "react";
+import { compareLayers as a, getLayer as o, getOpenLayers as s, getTopmostLayer as c, isDescendantLayer as l, isInsideLayerTree as u, isInsideOtherOpenModal as d, subscribeLayers as f } from "../lib/layers.mjs";
+import { DismissLayerContext as p } from "./useDismiss.mjs";
+import * as m from "react";
+import { useInsertionEffect as h, useLayoutEffect as g, useRef as _ } from "react";
 //#region src/hooks/useRestoreFocus.ts
-var _ = 4, v = "[data-wave-portal]";
-function y(e) {
-	return !e || !e.isConnected || !i(e) || e.closest("[aria-hidden=\"true\"]") ? !1 : !u(e);
-}
+var v = 4, y = "[data-wave-portal]";
 function b(e) {
+	return !e || !e.isConnected || !i(e) || e.closest("[aria-hidden=\"true\"]") ? !1 : !d(e);
+}
+function x(e) {
 	let t = {
 		path: [],
 		next: [],
@@ -19,48 +19,48 @@ function b(e) {
 	for (let r = e; r && (t.path.push(r), t.next.push(r.nextElementSibling), t.previous.push(r.previousElementSibling), r !== n); r = r.parentElement);
 	return t;
 }
-function x(e, t) {
+function S(e, t) {
 	if (e.closest("[data-wave-focus-trap-allow]")) return [];
-	let n = s().filter((t) => l(t.id, e)).sort((e, t) => a(t, e)), r = [];
+	let n = s().filter((t) => u(t.id, e)).sort((e, t) => a(t, e)), r = [];
 	for (let i of n) {
 		let n = i.getAnchor();
 		!n || n === e || t && t.contains(n) || r.some((e) => e.element === n) || r.push({
 			element: n,
-			position: b(n)
+			position: x(n)
 		});
 	}
 	return r;
 }
-function S() {
-	let e = T();
+function C() {
+	let e = E();
 	return e.surfaces ??= /* @__PURE__ */ new Set(), e.surfaces;
 }
-function C(e, t = /* @__PURE__ */ new Set()) {
+function w(e, t = /* @__PURE__ */ new Set()) {
 	if (t.has(e)) return !1;
 	if (t.add(e), e.isHoverClose()) return !0;
 	let n = e.getOpener();
 	if (!n) return !1;
-	for (let r of S()) {
+	for (let r of C()) {
 		let i = r === e ? null : r.getContainer();
-		if (i && i.contains(n) && C(r, t)) return !0;
+		if (i && i.contains(n) && w(r, t)) return !0;
 	}
 	return !1;
 }
-function w(e, t) {
-	return e ? C(e) : t.isHoverClose?.() === !0;
+function T(e, t) {
+	return e ? w(e) : t.isHoverClose?.() === !0;
 }
-function T() {
+function E() {
 	return e("restoreFocusTracker", () => ({
 		users: 0,
 		last: null,
 		uninstall: null
 	}));
 }
-var E = 1;
-function D(e) {
-	return !!e && e.nodeType === E;
+var D = 1;
+function O(e) {
+	return !!e && e.nodeType === D;
 }
-function O(e, t) {
+function k(e, t) {
 	let n = t.ownerDocument;
 	if (t === n.body || t === n.documentElement) {
 		e.last = null;
@@ -68,36 +68,36 @@ function O(e, t) {
 	}
 	e.last = {
 		element: t,
-		position: b(t),
-		anchors: x(t, null)
+		position: x(t),
+		anchors: S(t, null)
 	};
 }
-function k(e) {
+function A(e) {
 	let t = e.last;
 	if (!t || !t.element.isConnected) return;
-	let n = x(t.element, null);
+	let n = S(t.element, null);
 	for (let e of t.anchors) n.some((t) => t.element === e.element) || n.push(e);
 	e.last = {
 		element: t.element,
-		position: b(t.element),
+		position: x(t.element),
 		anchors: n
 	};
 }
-function A() {
+function j() {
 	if (typeof document > "u") return () => {};
-	let e = T();
+	let e = E();
 	if (e.users += 1, !e.uninstall) {
 		let t = document, n = (t) => {
-			D(t.target) && O(e, t.target);
+			O(t.target) && k(e, t.target);
 		}, r = (t) => {
 			let n = t.target;
-			!t.relatedTarget && D(n) && queueMicrotask(() => {
+			!t.relatedTarget && O(n) && queueMicrotask(() => {
 				e.last?.element === n && n.isConnected && i(n) && n.ownerDocument.activeElement !== n && (e.last = null);
 			});
 		};
 		t.addEventListener("focusin", n, !0), t.addEventListener("focusout", r, !0);
-		let a = d(() => k(e));
-		D(t.activeElement) && O(e, t.activeElement), e.uninstall = () => {
+		let a = f(() => A(e));
+		O(t.activeElement) && k(e, t.activeElement), e.uninstall = () => {
 			t.removeEventListener("focusin", n, !0), t.removeEventListener("focusout", r, !0), a(), e.last = null;
 		};
 	}
@@ -106,28 +106,28 @@ function A() {
 		t && (t = !1, e.users = Math.max(0, e.users - 1), !(e.users > 0) && (e.uninstall?.(), e.uninstall = null));
 	};
 }
-function j() {
-	let e = T().last;
+function M() {
+	let e = E().last;
 	if (!e) return null;
 	let { element: t } = e;
 	return t.ownerDocument.activeElement === t || t.isConnected && i(t) ? null : e;
 }
-function M(e) {
+function N(e) {
 	if (typeof document > "u") return null;
 	let { container: t, triggerRef: n } = e, r = (e) => !!e && e !== e.ownerDocument.body && e !== e.ownerDocument.documentElement && !(t && t.contains(e)), i = n?.current, a = document.activeElement, o = null;
 	if (r(i) ? o = i : r(a) && (o = a), o) return {
 		element: o,
-		position: b(o),
-		anchors: x(o, t)
+		position: x(o),
+		anchors: S(o, t)
 	};
-	let s = j();
+	let s = M();
 	return !s || !r(s.element) ? null : {
 		element: s.element,
 		position: s.position,
 		anchors: s.anchors.filter((e) => !(t && t.contains(e.element)))
 	};
 }
-function N(e) {
+function P(e) {
 	if (!e) return [];
 	let t = [];
 	for (let r of e.getElements()) {
@@ -138,13 +138,13 @@ function N(e) {
 	}
 	return t;
 }
-function P(e, t) {
+function F(e, t) {
 	let { ref: n, placement: r } = t;
 	if (e === n) return r === "before";
-	let i = (n.compareDocumentPosition(e) & _) !== 0;
+	let i = (n.compareDocumentPosition(e) & v) !== 0;
 	return r === "before" ? i : i && !n.contains(e);
 }
-function F(e) {
+function I(e) {
 	let { path: t } = e, n = t.findIndex((e) => e.isConnected);
 	if (n === -1) return null;
 	if (n === 0) {
@@ -157,7 +157,7 @@ function F(e) {
 			}
 		} : null;
 	}
-	if (t.slice(0, n).some((e) => e.matches(v))) return null;
+	if (t.slice(0, n).some((e) => e.matches(y))) return null;
 	let r = t[n], i = e.next[n - 1];
 	if (i && i.parentElement === r) return {
 		root: r,
@@ -181,78 +181,91 @@ function F(e) {
 		}
 	};
 }
-function I(e, t) {
-	let n = F(e);
+function L(e, t) {
+	let n = I(e);
 	if (!n) return [];
 	let { root: i, point: a } = n, o = i.ownerDocument.body, s = [];
-	for (let e = i; e && !(u(e) || (s.push(e), e === o || e.matches(v))); e = e.parentElement);
+	for (let e = i; e && !(d(e) || (s.push(e), e === o || e.matches(y))); e = e.parentElement);
 	if (s.length === 0) return [];
-	let c = r(s[s.length - 1]).filter((e) => !(t && t.contains(e)) && y(e)).sort((e, t) => (e.compareDocumentPosition(t) & _) === 0 ? 1 : -1), l = [];
+	let c = r(s[s.length - 1]).filter((e) => !(t && t.contains(e)) && b(e)).sort((e, t) => (e.compareDocumentPosition(t) & v) === 0 ? 1 : -1), l = [];
 	for (let e of s) {
-		let t = c.filter((t) => e.contains(t) && !l.includes(t)), n = t.find((e) => P(e, a)), r = t.filter((e) => !P(e, a)).pop();
+		let t = c.filter((t) => e.contains(t) && !l.includes(t)), n = t.find((e) => F(e, a)), r = t.filter((e) => !F(e, a)).pop();
 		n && l.push(n), r && l.push(r);
 	}
 	return l;
 }
-function L(e, t) {
+function R(e) {
+	if (!e) return !1;
+	let t = M();
+	return t ? t.position.path.includes(e) ? !0 : t.anchors.some((t) => t.position.path.includes(e)) : !1;
+}
+function z(e, t, n) {
+	return !t || e.closest("[data-wave-focus-trap-allow]") ? !1 : s().some((r) => {
+		if (r.id === n || !u(r.id, e)) return !1;
+		if (n !== void 0 && l(r.id, n)) return !0;
+		let i = r.getAnchor();
+		return !!i && t.contains(i);
+	});
+}
+function B(e, t) {
 	if (typeof document > "u") return !1;
 	let n = document.activeElement, r = !n || n === document.body || n === document.documentElement;
-	return !r && e.container?.contains(n) ? !0 : !r && e.onlyIfFocusInside ? !1 : !t();
+	return !r && e.container?.contains(n) ? !0 : e.requireFocusInside ? r ? R(e.container) && !t() : z(n, e.container, e.layerId) : !r && e.onlyIfFocusInside ? !1 : !t();
 }
-function* R(e, t) {
-	yield* I(e.position, t);
+function* V(e, t) {
+	yield* L(e.position, t);
 	for (let t of e.anchors) yield t.element;
-	for (let n of e.anchors) yield* I(n.position, t);
+	for (let n of e.anchors) yield* L(n.position, t);
 }
-function* z(e, t) {
+function* H(e, t) {
 	let { options: n, parentLayerId: r } = e;
 	yield n.finalFocusRef?.current, yield t?.element, yield n.triggerRef?.current, yield n.fallback?.();
-	let i = t ? R(t, n.container) : null, a = r === null ? null : o(r), s = [];
+	let i = t ? V(t, n.container) : null, a = r === null ? null : o(r), s = [];
 	if (a) {
-		for (let e of i ?? []) l(a.id, e) ? yield e : s.push(e);
-		yield* N(a), yield* s;
+		for (let e of i ?? []) u(a.id, e) ? yield e : s.push(e);
+		yield* P(a), yield* s;
 	} else i && (yield* i);
-	yield* N(c((e) => e.kind === "modal"));
+	yield* P(c((e) => e.kind === "modal"));
 }
-function B(e, n) {
+function U(e, n) {
 	let r = e.options.container;
-	for (let i of z(e, n)) if (!(r && i && r.contains(i)) && y(i) && t(i, { preventScroll: !0 })) return;
+	for (let i of H(e, n)) if (!(r && i && r.contains(i)) && b(i) && t(i, { preventScroll: !0 })) return;
 }
-function V(e) {
-	let t = p.useContext(f), n = g({
+function W(e) {
+	let t = m.useContext(p), n = _({
 		options: e,
 		parentLayerId: t
-	}), r = g(null), i = g(!1), a = g(!1), o = g(null), s = g(null), { enabled: c } = e;
-	h(() => {
-		let e = A(), t = {
+	}), r = _(null), i = _(!1), a = _(!1), o = _(null), s = _(null), { enabled: c } = e;
+	g(() => {
+		let e = j(), t = {
 			isHoverClose: () => n.current.options.isHoverClose?.() === !0,
 			getContainer: () => n.current.options.container ?? null,
 			getOpener: () => r.current?.element ?? n.current.options.triggerRef?.current ?? null
 		};
 		s.current = t;
-		let i = S();
+		let i = C();
 		return i.add(t), () => {
 			e(), queueMicrotask(() => i.delete(t));
 		};
-	}, []), m(() => {
+	}, []), h(() => {
 		n.current = {
 			options: e,
 			parentLayerId: t
 		};
 		let a = i.current;
-		i.current = e.enabled, e.enabled && !a && (r.current = M(e));
-	}), h(() => {
+		i.current = e.enabled, e.enabled && !a && (r.current = N(e));
+	}), g(() => {
 		let e = a.current;
-		if (a.current = c, !e || c) return;
-		let t = n.current, i = r.current, o = s.current, l = L(t.options, () => w(o, t.options));
-		r.current = null, l && B(t, i);
-	}, [c]), h(() => {
+		if (a.current = c, c && !e && !r.current && (r.current = N(n.current.options)), !e || c) return;
+		let t = n.current, i = r.current, o = s.current, l = B(t.options, () => T(o, t.options));
+		r.current = null, l && U(t, i);
+	}, [c]), g(() => {
 		let e = n, t = r, i = o, a = s;
 		return i.current = null, () => {
 			let n = e.current;
 			if (!n.options.enabled) return;
 			let r = a.current;
-			if (!L(n.options, () => w(r, n.options))) return;
+			if (!B(n.options, () => T(r, n.options))) return;
 			let o = {};
 			i.current = o;
 			let s = t.current;
@@ -260,12 +273,12 @@ function V(e) {
 				if (i.current !== o) return;
 				i.current = null;
 				let e = typeof document > "u" ? null : document.activeElement, t = n.options.container;
-				(!e || e === document.body || e === document.documentElement || t && t.contains(e)) && B(n, s);
+				(!e || e === document.body || e === document.documentElement || t && t.contains(e)) && U(n, s);
 			});
 		};
 	}, []);
 }
 //#endregion
-export { V as useRestoreFocus };
+export { W as useRestoreFocus };
 
 //# sourceMappingURL=useRestoreFocus.mjs.map