focus-trap headless API

interface FocusTrapHandle {
  /** Idempotent. Removes the container's keydown listener and the
   *  document's focusin reclaim listener, and restores focus per the
   *  `returnFocus` rule. */
  release(): void;
}

interface FocusTrapOptions {
  /** Element to focus on trap; default first tabbable, else the container
   *  itself (given tabindex="-1" if it has none). */
  readonly initialFocus?: () => HTMLElement | null;
  /** Element to restore on release; default the element focused at trap
   *  time. Restored only if the candidate still has a callable `focus`
   *  function (not merely `isConnected`). Returning `null` explicitly opts
   *  OUT of restoration entirely; only an absent option (or a `undefined`
   *  return) falls back to the previously-focused element. */
  readonly returnFocus?: () => HTMLElement | null;
}

declare function isFocusEscaped(container: MinimalContainerLike, active: unknown): boolean;

declare function queryTabbable(container: MinimalContainerLike): MinimalTabbableLike[];

declare function resolveFocusReturnTarget(candidate: unknown): MinimalTabbableLike | null;

declare function resolveInitialFocusTarget(container: MinimalContainerLike): MinimalTabbableLike;

declare function resolveTabTarget(tabbable: readonly MinimalTabbableLike[], active: unknown, backwards: boolean): MinimalTabbableLike | null;

export declare const TABBABLE_SELECTOR: "a[href],button:not([disabled]),input:not([disabled]),select:not([disabled]),textarea:not([disabled]),[tabindex]:not([tabindex=\"-1\"])";

declare function trapFocus(container: HTMLElement, options?: FocusTrapOptions): FocusTrapHandle;