@vielzeug/refine 1.5.3 → 1.7.0

package/dist/headless/dialog-focus.d.ts

@@ -1,40 +0,0 @@
-export type DialogFocusControlOptions = {
-    /** Returns the container element (dialog or shadow root) for focus trapping. */
-    getContainer: () => HTMLElement | ShadowRoot | null;
-    /** Returns the CSS selector for the element to focus on open (e.g. `'[autofocus]'`). */
-    getInitialFocusSelector: () => string | undefined;
-    /** Returns whether focus should be restored to the trigger on close. */
-    getReturnFocus: () => boolean | undefined;
-    /** Host element used to resolve `getInitialFocusSelector`. */
-    host: HTMLElement;
-    /** When provided, the trap only intercepts Tab when this returns `true`. */
-    trapEnabled?: () => boolean;
-};
-export type DialogFocusControl = {
-    /** Capture return focus, activate the trap, and apply initial focus. */
-    activate(): void;
-    /** Deactivate the trap and restore focus. */
-    deactivate(): void;
-};
-/**
- * Combines {@link createFocusTrap} and {@link createFocusManager} into a single
- * `activate / deactivate` API suited for modal dialogs and drawers.
- *
- * @example
- * ```ts
- * const focusCtrl = createDialogFocusControl({
- *   getContainer: () => dialog,
- *   getInitialFocusSelector: () => props['initial-focus'].value,
- *   getReturnFocus: () => props['return-focus'].value !== false,
- *   host: el,
- * });
- *
- * // On open:
- * focusCtrl.activate();
- *
- * // On close:
- * focusCtrl.deactivate();
- * ```
- */
-export declare const createDialogFocusControl: (options: DialogFocusControlOptions) => DialogFocusControl;
-//# sourceMappingURL=dialog-focus.d.ts.map

package/dist/headless/dialog-focus.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"dialog-focus.d.ts","sourceRoot":"","sources":["../../src/headless/dialog-focus.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,yBAAyB,GAAG;IACtC,gFAAgF;IAChF,YAAY,EAAE,MAAM,WAAW,GAAG,UAAU,GAAG,IAAI,CAAC;IACpD,wFAAwF;IACxF,uBAAuB,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IAClD,wEAAwE;IACxE,cAAc,EAAE,MAAM,OAAO,GAAG,SAAS,CAAC;IAC1C,8DAA8D;IAC9D,IAAI,EAAE,WAAW,CAAC;IAClB,4EAA4E;IAC5E,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,wEAAwE;IACxE,QAAQ,IAAI,IAAI,CAAC;IACjB,6CAA6C;IAC7C,UAAU,IAAI,IAAI,CAAC;CACpB,CAAC;AAIF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,wBAAwB,GAAI,SAAS,yBAAyB,KAAG,kBAsB7E,CAAC"}

package/dist/headless/dialog-focus.js

@@ -1,22 +0,0 @@
-import { createFocusManager as e } from "./focus.js";
-import { createFocusTrap as t } from "./focus-trap.js";
-//#region src/headless/dialog-focus.ts
-var n = (n) => {
-	let r = t(n.getContainer, { enabled: n.trapEnabled }), i = e({
-		getInitialFocusSelector: n.getInitialFocusSelector,
-		getReturnFocus: n.getReturnFocus,
-		host: n.host
-	});
-	return {
-		activate() {
-			i.captureReturnFocus(), r.activate(), i.applyInitialFocus();
-		},
-		deactivate() {
-			i.cancelInitialFocus(), r.deactivate(), i.restoreFocus();
-		}
-	};
-};
-//#endregion
-export { n as createDialogFocusControl };
-
-//# sourceMappingURL=dialog-focus.js.map

package/dist/headless/dialog-focus.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"dialog-focus.js","names":[],"sources":["../../src/headless/dialog-focus.ts"],"sourcesContent":["import { createFocusManager } from './focus';\nimport { createFocusTrap } from './focus-trap';\n\n// ── Types ─────────────────────────────────────────────────────────────────────\n\nexport type DialogFocusControlOptions = {\n  /** Returns the container element (dialog or shadow root) for focus trapping. */\n  getContainer: () => HTMLElement | ShadowRoot | null;\n  /** Returns the CSS selector for the element to focus on open (e.g. `'[autofocus]'`). */\n  getInitialFocusSelector: () => string | undefined;\n  /** Returns whether focus should be restored to the trigger on close. */\n  getReturnFocus: () => boolean | undefined;\n  /** Host element used to resolve `getInitialFocusSelector`. */\n  host: HTMLElement;\n  /** When provided, the trap only intercepts Tab when this returns `true`. */\n  trapEnabled?: () => boolean;\n};\n\nexport type DialogFocusControl = {\n  /** Capture return focus, activate the trap, and apply initial focus. */\n  activate(): void;\n  /** Deactivate the trap and restore focus. */\n  deactivate(): void;\n};\n\n// ── Factory ───────────────────────────────────────────────────────────────────\n\n/**\n * Combines {@link createFocusTrap} and {@link createFocusManager} into a single\n * `activate / deactivate` API suited for modal dialogs and drawers.\n *\n * @example\n * ```ts\n * const focusCtrl = createDialogFocusControl({\n *   getContainer: () => dialog,\n *   getInitialFocusSelector: () => props['initial-focus'].value,\n *   getReturnFocus: () => props['return-focus'].value !== false,\n *   host: el,\n * });\n *\n * // On open:\n * focusCtrl.activate();\n *\n * // On close:\n * focusCtrl.deactivate();\n * ```\n */\nexport const createDialogFocusControl = (options: DialogFocusControlOptions): DialogFocusControl => {\n  const trap = createFocusTrap(options.getContainer, { enabled: options.trapEnabled });\n\n  const manager = createFocusManager({\n    getInitialFocusSelector: options.getInitialFocusSelector,\n    getReturnFocus: options.getReturnFocus,\n    host: options.host,\n  });\n\n  return {\n    activate() {\n      manager.captureReturnFocus();\n      trap.activate();\n      manager.applyInitialFocus();\n    },\n\n    deactivate() {\n      manager.cancelInitialFocus();\n      trap.deactivate();\n      manager.restoreFocus();\n    },\n  };\n};\n"],"mappings":";;;AA+CA,IAAa,KAA4B,MAA2D;CAClG,IAAM,IAAO,EAAgB,EAAQ,cAAc,EAAE,SAAS,EAAQ,YAAY,CAAC,GAE7E,IAAU,EAAmB;EACjC,yBAAyB,EAAQ;EACjC,gBAAgB,EAAQ;EACxB,MAAM,EAAQ;CAChB,CAAC;CAED,OAAO;EACL,WAAW;GAGT,AAFA,EAAQ,mBAAmB,GAC3B,EAAK,SAAS,GACd,EAAQ,kBAAkB;EAC5B;EAEA,aAAa;GAGX,AAFA,EAAQ,mBAAmB,GAC3B,EAAK,WAAW,GAChB,EAAQ,aAAa;EACvB;CACF;AACF"}

package/dist/headless/focus-trap.cjs

@@ -1,2 +0,0 @@
-var e=[`a[href]`,`area[href]`,`button:not([disabled])`,`details > summary:not([disabled])`,`iframe`,`input:not([disabled])`,`select:not([disabled])`,`textarea:not([disabled])`,`[contenteditable]:not([contenteditable="false"])`,`[tabindex]:not([tabindex="-1"])`,`[role="button"]:not([disabled]):not([aria-disabled="true"])`,`[role="link"]:not([aria-disabled="true"])`,`[role="menuitem"]:not([aria-disabled="true"])`,`[role="menuitemcheckbox"]:not([aria-disabled="true"])`,`[role="menuitemradio"]:not([aria-disabled="true"])`,`[role="option"]:not([aria-disabled="true"])`,`[role="tab"]:not([aria-disabled="true"])`].join(`,`),t=(t,n={})=>{let r=!1,i=()=>{let n=t();return n?Array.from(n.querySelectorAll(e)).filter(e=>!e.closest(`[aria-hidden="true"]`)&&!e.closest(`[hidden]`)&&!e.closest(`[inert]`)):[]},a=e=>{if(!r||n.enabled?.()===!1||e.key!==`Tab`)return;let t=i();if(t.length===0){e.preventDefault();return}let a=t[0],o=t[t.length-1],s=e.target??document.activeElement;e.shiftKey?(s===a||!t.includes(s))&&(e.preventDefault(),o.focus()):(s===o||!t.includes(s))&&(e.preventDefault(),a.focus())},o=()=>{r||(r=!0,document.addEventListener(`keydown`,a,!0))},s=()=>{r&&(r=!1,document.removeEventListener(`keydown`,a,!0))};return n.signal&&!n.signal.aborted&&n.signal.addEventListener(`abort`,s,{once:!0}),{activate:o,get active(){return r},deactivate:s,dispose:s,[Symbol.dispose]:s}};exports.createFocusTrap=t;
-//# sourceMappingURL=focus-trap.cjs.map

package/dist/headless/focus-trap.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"focus-trap.cjs","names":[],"sources":["../../src/headless/focus-trap.ts"],"sourcesContent":["// ── Focus Trap ────────────────────────────────────────────────────────────────\n// Implements the WAI-ARIA modal dialog focus-containment pattern.\n//\n// When active, Tab/Shift-Tab wrap within the container's focusable descendants\n// instead of leaving it. The focusable list is re-queried on every Tab keydown\n// so DOM changes (e.g. lazy-rendered content) are always reflected without a\n// MutationObserver.\n//\n// Usage (inside a ore component):\n// ```ts\n// const trap = createFocusTrap(() => dialogEl);\n// onOpen: () => trap.activate(),\n// onClose: () => trap.deactivate(),\n// ```\n\n// ── Constants ─────────────────────────────────────────────────────────────────\n\n/**\n * CSS selector matching all focusable elements, including:\n * - Native HTML interactive elements\n * - Elements with explicit `tabindex` (covers custom elements that correctly manage focus)\n * - Custom elements using ARIA interactive roles that are inherently focusable\n *   but may not carry a native `tabindex` attribute\n *\n * Note: `[tabindex]:not([tabindex=\"-1\"])` already covers any element that\n * explicitly opts into the tab order. The ARIA role selectors below additionally\n * capture elements that rely on the implicit focusability of their role\n * without a redundant `tabindex=\"0\"` attribute.\n */\nconst FOCUSABLE_SELECTOR = [\n  'a[href]',\n  'area[href]',\n  'button:not([disabled])',\n  'details > summary:not([disabled])',\n  'iframe',\n  'input:not([disabled])',\n  'select:not([disabled])',\n  'textarea:not([disabled])',\n  '[contenteditable]:not([contenteditable=\"false\"])',\n  '[tabindex]:not([tabindex=\"-1\"])',\n  // ARIA interactive roles that should participate in focus order.\n  // These cover custom components that set role but not explicit tabindex.\n  '[role=\"button\"]:not([disabled]):not([aria-disabled=\"true\"])',\n  '[role=\"link\"]:not([aria-disabled=\"true\"])',\n  '[role=\"menuitem\"]:not([aria-disabled=\"true\"])',\n  '[role=\"menuitemcheckbox\"]:not([aria-disabled=\"true\"])',\n  '[role=\"menuitemradio\"]:not([aria-disabled=\"true\"])',\n  '[role=\"option\"]:not([aria-disabled=\"true\"])',\n  '[role=\"tab\"]:not([aria-disabled=\"true\"])',\n  // Note: [role=\"gridcell\"] and [role=\"row\"] are intentionally omitted — they\n  // participate in focus order only when an explicit tabindex is set, which is\n  // already caught by the [tabindex]:not([tabindex=\"-1\"]) selector above.\n].join(',');\n\n// ── Types ─────────────────────────────────────────────────────────────────────\n\nexport type FocusTrapOptions = {\n  /**\n   * When provided, the trap only processes events when this returns `true`.\n   * Useful to pause trapping while an inner dialog is open.\n   */\n  enabled?: () => boolean;\n  /**\n   * Optional `AbortSignal`. When aborted, `deactivate()` is called automatically.\n   * Prevents global `keydown` listener leaks if the component is destroyed while\n   * the trap is still active.\n   */\n  signal?: AbortSignal;\n};\n\nexport type FocusTrap = {\n  [Symbol.dispose](): void;\n  /** Start trapping Tab/Shift-Tab. Safe to call when already active. */\n  activate(): void;\n  /** Whether the trap is currently active. */\n  readonly active: boolean;\n  /** Stop trapping. Safe to call when already inactive. */\n  deactivate(): void;\n  /** Alias for `deactivate()`. Conforms to the monorepo disposal convention. */\n  dispose(): void;\n};\n\n// ── Factory ───────────────────────────────────────────────────────────────────\n\n/**\n * Creates a WAI-ARIA modal focus trap for a container element.\n *\n * When active, Tab wraps from the last focusable child to the first, and\n * Shift-Tab wraps in reverse. The focusable list is re-queried live on each\n * Tab keydown — no MutationObserver required.\n *\n * The container itself is queried lazily via `getContainer()` so it may be\n * `null` at construction time (the typical case when the container is inside\n * an initially-hidden overlay).\n *\n * @example\n * ```ts\n * const trap = createFocusTrap(() => dialogEl);\n *\n * onOpen: () => trap.activate(),\n * onClose: () => trap.deactivate(),\n * ```\n */\nexport const createFocusTrap = (\n  getContainer: () => HTMLElement | ShadowRoot | null,\n  options: FocusTrapOptions = {},\n): FocusTrap => {\n  let _active = false;\n\n  const getFocusable = (): HTMLElement[] => {\n    const container = getContainer();\n\n    if (!container) return [];\n\n    return Array.from(container.querySelectorAll<HTMLElement>(FOCUSABLE_SELECTOR)).filter(\n      // Exclude elements hidden from the accessibility tree or removed from tab order.\n      // aria-hidden=\"true\" and [hidden] have long been standard; [inert] is the\n      // modern successor that browsers honour natively from 2022+.\n      (el) => !el.closest('[aria-hidden=\"true\"]') && !el.closest('[hidden]') && !el.closest('[inert]'),\n    );\n  };\n\n  const handleKeydown = (event: KeyboardEvent): void => {\n    if (!_active) return;\n\n    if (options.enabled?.() === false) return;\n\n    if (event.key !== 'Tab') return;\n\n    const focusable = getFocusable();\n\n    if (focusable.length === 0) {\n      // Prevent focus from escaping the empty container.\n      event.preventDefault();\n\n      return;\n    }\n\n    const first = focusable[0];\n    const last = focusable[focusable.length - 1];\n    // Prefer event.target over document.activeElement: the capture-phase handler\n    // fires before focus has moved in some environments (e.g. jsdom).\n    const current = (event.target as HTMLElement) ?? document.activeElement;\n\n    if (event.shiftKey) {\n      // Shift+Tab from first (or outside) → wrap to last.\n      if (current === first || !focusable.includes(current as HTMLElement)) {\n        event.preventDefault();\n        last.focus();\n      }\n    } else {\n      // Tab from last (or outside) → wrap to first.\n      if (current === last || !focusable.includes(current as HTMLElement)) {\n        event.preventDefault();\n        first.focus();\n      }\n    }\n  };\n\n  const activate = (): void => {\n    if (_active) return;\n\n    _active = true;\n    document.addEventListener('keydown', handleKeydown, true);\n  };\n\n  const deactivate = (): void => {\n    if (!_active) return;\n\n    _active = false;\n    document.removeEventListener('keydown', handleKeydown, true);\n  };\n\n  if (options.signal && !options.signal.aborted) {\n    options.signal.addEventListener('abort', deactivate, { once: true });\n  }\n\n  return {\n    activate,\n    get active() {\n      return _active;\n    },\n    deactivate,\n    dispose: deactivate,\n    [Symbol.dispose]: deactivate,\n  };\n};\n"],"mappings":"AA6BA,IAAM,EAAqB,CACzB,UACA,aACA,yBACA,oCACA,SACA,wBACA,yBACA,2BACA,mDACA,kCAGA,8DACA,4CACA,gDACA,wDACA,qDACA,8CACA,0CAIF,CAAC,CAAC,KAAK,GAAG,EAmDG,GACX,EACA,EAA4B,CAAC,IACf,CACd,IAAI,EAAU,GAER,MAAoC,CACxC,IAAM,EAAY,EAAa,EAI/B,OAFK,EAEE,MAAM,KAAK,EAAU,iBAA8B,CAAkB,CAAC,CAAC,CAAC,OAI5E,GAAO,CAAC,EAAG,QAAQ,sBAAsB,GAAK,CAAC,EAAG,QAAQ,UAAU,GAAK,CAAC,EAAG,QAAQ,SAAS,CACjG,EAPuB,CAAC,CAQ1B,EAEM,EAAiB,GAA+B,CAKpD,GAJI,CAAC,GAED,EAAQ,UAAU,IAAM,IAExB,EAAM,MAAQ,MAAO,OAEzB,IAAM,EAAY,EAAa,EAE/B,GAAI,EAAU,SAAW,EAAG,CAE1B,EAAM,eAAe,EAErB,MACF,CAEA,IAAM,EAAQ,EAAU,GAClB,EAAO,EAAU,EAAU,OAAS,GAGpC,EAAW,EAAM,QAA0B,SAAS,cAEtD,EAAM,UAEJ,IAAY,GAAS,CAAC,EAAU,SAAS,CAAsB,KACjE,EAAM,eAAe,EACrB,EAAK,MAAM,IAIT,IAAY,GAAQ,CAAC,EAAU,SAAS,CAAsB,KAChE,EAAM,eAAe,EACrB,EAAM,MAAM,EAGlB,EAEM,MAAuB,CACvB,IAEJ,EAAU,GACV,SAAS,iBAAiB,UAAW,EAAe,EAAI,EAC1D,EAEM,MAAyB,CACxB,IAEL,EAAU,GACV,SAAS,oBAAoB,UAAW,EAAe,EAAI,EAC7D,EAMA,OAJI,EAAQ,QAAU,CAAC,EAAQ,OAAO,SACpC,EAAQ,OAAO,iBAAiB,QAAS,EAAY,CAAE,KAAM,EAAK,CAAC,EAG9D,CACL,WACA,IAAI,QAAS,CACX,OAAO,CACT,EACA,aACA,QAAS,GACR,OAAO,SAAU,CACpB,CACF"}

package/dist/headless/focus-trap.d.ts

@@ -1,45 +0,0 @@
-export type FocusTrapOptions = {
-    /**
-     * When provided, the trap only processes events when this returns `true`.
-     * Useful to pause trapping while an inner dialog is open.
-     */
-    enabled?: () => boolean;
-    /**
-     * Optional `AbortSignal`. When aborted, `deactivate()` is called automatically.
-     * Prevents global `keydown` listener leaks if the component is destroyed while
-     * the trap is still active.
-     */
-    signal?: AbortSignal;
-};
-export type FocusTrap = {
-    [Symbol.dispose](): void;
-    /** Start trapping Tab/Shift-Tab. Safe to call when already active. */
-    activate(): void;
-    /** Whether the trap is currently active. */
-    readonly active: boolean;
-    /** Stop trapping. Safe to call when already inactive. */
-    deactivate(): void;
-    /** Alias for `deactivate()`. Conforms to the monorepo disposal convention. */
-    dispose(): void;
-};
-/**
- * Creates a WAI-ARIA modal focus trap for a container element.
- *
- * When active, Tab wraps from the last focusable child to the first, and
- * Shift-Tab wraps in reverse. The focusable list is re-queried live on each
- * Tab keydown — no MutationObserver required.
- *
- * The container itself is queried lazily via `getContainer()` so it may be
- * `null` at construction time (the typical case when the container is inside
- * an initially-hidden overlay).
- *
- * @example
- * ```ts
- * const trap = createFocusTrap(() => dialogEl);
- *
- * onOpen: () => trap.activate(),
- * onClose: () => trap.deactivate(),
- * ```
- */
-export declare const createFocusTrap: (getContainer: () => HTMLElement | ShadowRoot | null, options?: FocusTrapOptions) => FocusTrap;
-//# sourceMappingURL=focus-trap.d.ts.map

package/dist/headless/focus-trap.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"focus-trap.d.ts","sourceRoot":"","sources":["../../src/headless/focus-trap.ts"],"names":[],"mappings":"AAwDA,MAAM,MAAM,gBAAgB,GAAG;IAC7B;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC;IACxB;;;;OAIG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACtB,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC;IACzB,sEAAsE;IACtE,QAAQ,IAAI,IAAI,CAAC;IACjB,4CAA4C;IAC5C,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,yDAAyD;IACzD,UAAU,IAAI,IAAI,CAAC;IACnB,8EAA8E;IAC9E,OAAO,IAAI,IAAI,CAAC;CACjB,CAAC;AAIF;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,eAAe,GAC1B,cAAc,MAAM,WAAW,GAAG,UAAU,GAAG,IAAI,EACnD,UAAS,gBAAqB,KAC7B,SAgFF,CAAC"}

package/dist/headless/focus-trap.js

@@ -1,51 +0,0 @@
-//#region src/headless/focus-trap.ts
-var e = [
-	"a[href]",
-	"area[href]",
-	"button:not([disabled])",
-	"details > summary:not([disabled])",
-	"iframe",
-	"input:not([disabled])",
-	"select:not([disabled])",
-	"textarea:not([disabled])",
-	"[contenteditable]:not([contenteditable=\"false\"])",
-	"[tabindex]:not([tabindex=\"-1\"])",
-	"[role=\"button\"]:not([disabled]):not([aria-disabled=\"true\"])",
-	"[role=\"link\"]:not([aria-disabled=\"true\"])",
-	"[role=\"menuitem\"]:not([aria-disabled=\"true\"])",
-	"[role=\"menuitemcheckbox\"]:not([aria-disabled=\"true\"])",
-	"[role=\"menuitemradio\"]:not([aria-disabled=\"true\"])",
-	"[role=\"option\"]:not([aria-disabled=\"true\"])",
-	"[role=\"tab\"]:not([aria-disabled=\"true\"])"
-].join(","), t = (t, n = {}) => {
-	let r = !1, i = () => {
-		let n = t();
-		return n ? Array.from(n.querySelectorAll(e)).filter((e) => !e.closest("[aria-hidden=\"true\"]") && !e.closest("[hidden]") && !e.closest("[inert]")) : [];
-	}, a = (e) => {
-		if (!r || n.enabled?.() === !1 || e.key !== "Tab") return;
-		let t = i();
-		if (t.length === 0) {
-			e.preventDefault();
-			return;
-		}
-		let a = t[0], o = t[t.length - 1], s = e.target ?? document.activeElement;
-		e.shiftKey ? (s === a || !t.includes(s)) && (e.preventDefault(), o.focus()) : (s === o || !t.includes(s)) && (e.preventDefault(), a.focus());
-	}, o = () => {
-		r || (r = !0, document.addEventListener("keydown", a, !0));
-	}, s = () => {
-		r && (r = !1, document.removeEventListener("keydown", a, !0));
-	};
-	return n.signal && !n.signal.aborted && n.signal.addEventListener("abort", s, { once: !0 }), {
-		activate: o,
-		get active() {
-			return r;
-		},
-		deactivate: s,
-		dispose: s,
-		[Symbol.dispose]: s
-	};
-};
-//#endregion
-export { t as createFocusTrap };
-
-//# sourceMappingURL=focus-trap.js.map

package/dist/headless/focus-trap.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"focus-trap.js","names":[],"sources":["../../src/headless/focus-trap.ts"],"sourcesContent":["// ── Focus Trap ────────────────────────────────────────────────────────────────\n// Implements the WAI-ARIA modal dialog focus-containment pattern.\n//\n// When active, Tab/Shift-Tab wrap within the container's focusable descendants\n// instead of leaving it. The focusable list is re-queried on every Tab keydown\n// so DOM changes (e.g. lazy-rendered content) are always reflected without a\n// MutationObserver.\n//\n// Usage (inside a ore component):\n// ```ts\n// const trap = createFocusTrap(() => dialogEl);\n// onOpen: () => trap.activate(),\n// onClose: () => trap.deactivate(),\n// ```\n\n// ── Constants ─────────────────────────────────────────────────────────────────\n\n/**\n * CSS selector matching all focusable elements, including:\n * - Native HTML interactive elements\n * - Elements with explicit `tabindex` (covers custom elements that correctly manage focus)\n * - Custom elements using ARIA interactive roles that are inherently focusable\n *   but may not carry a native `tabindex` attribute\n *\n * Note: `[tabindex]:not([tabindex=\"-1\"])` already covers any element that\n * explicitly opts into the tab order. The ARIA role selectors below additionally\n * capture elements that rely on the implicit focusability of their role\n * without a redundant `tabindex=\"0\"` attribute.\n */\nconst FOCUSABLE_SELECTOR = [\n  'a[href]',\n  'area[href]',\n  'button:not([disabled])',\n  'details > summary:not([disabled])',\n  'iframe',\n  'input:not([disabled])',\n  'select:not([disabled])',\n  'textarea:not([disabled])',\n  '[contenteditable]:not([contenteditable=\"false\"])',\n  '[tabindex]:not([tabindex=\"-1\"])',\n  // ARIA interactive roles that should participate in focus order.\n  // These cover custom components that set role but not explicit tabindex.\n  '[role=\"button\"]:not([disabled]):not([aria-disabled=\"true\"])',\n  '[role=\"link\"]:not([aria-disabled=\"true\"])',\n  '[role=\"menuitem\"]:not([aria-disabled=\"true\"])',\n  '[role=\"menuitemcheckbox\"]:not([aria-disabled=\"true\"])',\n  '[role=\"menuitemradio\"]:not([aria-disabled=\"true\"])',\n  '[role=\"option\"]:not([aria-disabled=\"true\"])',\n  '[role=\"tab\"]:not([aria-disabled=\"true\"])',\n  // Note: [role=\"gridcell\"] and [role=\"row\"] are intentionally omitted — they\n  // participate in focus order only when an explicit tabindex is set, which is\n  // already caught by the [tabindex]:not([tabindex=\"-1\"]) selector above.\n].join(',');\n\n// ── Types ─────────────────────────────────────────────────────────────────────\n\nexport type FocusTrapOptions = {\n  /**\n   * When provided, the trap only processes events when this returns `true`.\n   * Useful to pause trapping while an inner dialog is open.\n   */\n  enabled?: () => boolean;\n  /**\n   * Optional `AbortSignal`. When aborted, `deactivate()` is called automatically.\n   * Prevents global `keydown` listener leaks if the component is destroyed while\n   * the trap is still active.\n   */\n  signal?: AbortSignal;\n};\n\nexport type FocusTrap = {\n  [Symbol.dispose](): void;\n  /** Start trapping Tab/Shift-Tab. Safe to call when already active. */\n  activate(): void;\n  /** Whether the trap is currently active. */\n  readonly active: boolean;\n  /** Stop trapping. Safe to call when already inactive. */\n  deactivate(): void;\n  /** Alias for `deactivate()`. Conforms to the monorepo disposal convention. */\n  dispose(): void;\n};\n\n// ── Factory ───────────────────────────────────────────────────────────────────\n\n/**\n * Creates a WAI-ARIA modal focus trap for a container element.\n *\n * When active, Tab wraps from the last focusable child to the first, and\n * Shift-Tab wraps in reverse. The focusable list is re-queried live on each\n * Tab keydown — no MutationObserver required.\n *\n * The container itself is queried lazily via `getContainer()` so it may be\n * `null` at construction time (the typical case when the container is inside\n * an initially-hidden overlay).\n *\n * @example\n * ```ts\n * const trap = createFocusTrap(() => dialogEl);\n *\n * onOpen: () => trap.activate(),\n * onClose: () => trap.deactivate(),\n * ```\n */\nexport const createFocusTrap = (\n  getContainer: () => HTMLElement | ShadowRoot | null,\n  options: FocusTrapOptions = {},\n): FocusTrap => {\n  let _active = false;\n\n  const getFocusable = (): HTMLElement[] => {\n    const container = getContainer();\n\n    if (!container) return [];\n\n    return Array.from(container.querySelectorAll<HTMLElement>(FOCUSABLE_SELECTOR)).filter(\n      // Exclude elements hidden from the accessibility tree or removed from tab order.\n      // aria-hidden=\"true\" and [hidden] have long been standard; [inert] is the\n      // modern successor that browsers honour natively from 2022+.\n      (el) => !el.closest('[aria-hidden=\"true\"]') && !el.closest('[hidden]') && !el.closest('[inert]'),\n    );\n  };\n\n  const handleKeydown = (event: KeyboardEvent): void => {\n    if (!_active) return;\n\n    if (options.enabled?.() === false) return;\n\n    if (event.key !== 'Tab') return;\n\n    const focusable = getFocusable();\n\n    if (focusable.length === 0) {\n      // Prevent focus from escaping the empty container.\n      event.preventDefault();\n\n      return;\n    }\n\n    const first = focusable[0];\n    const last = focusable[focusable.length - 1];\n    // Prefer event.target over document.activeElement: the capture-phase handler\n    // fires before focus has moved in some environments (e.g. jsdom).\n    const current = (event.target as HTMLElement) ?? document.activeElement;\n\n    if (event.shiftKey) {\n      // Shift+Tab from first (or outside) → wrap to last.\n      if (current === first || !focusable.includes(current as HTMLElement)) {\n        event.preventDefault();\n        last.focus();\n      }\n    } else {\n      // Tab from last (or outside) → wrap to first.\n      if (current === last || !focusable.includes(current as HTMLElement)) {\n        event.preventDefault();\n        first.focus();\n      }\n    }\n  };\n\n  const activate = (): void => {\n    if (_active) return;\n\n    _active = true;\n    document.addEventListener('keydown', handleKeydown, true);\n  };\n\n  const deactivate = (): void => {\n    if (!_active) return;\n\n    _active = false;\n    document.removeEventListener('keydown', handleKeydown, true);\n  };\n\n  if (options.signal && !options.signal.aborted) {\n    options.signal.addEventListener('abort', deactivate, { once: true });\n  }\n\n  return {\n    activate,\n    get active() {\n      return _active;\n    },\n    deactivate,\n    dispose: deactivate,\n    [Symbol.dispose]: deactivate,\n  };\n};\n"],"mappings":";AA6BA,IAAM,IAAqB;CACzB;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CAGA;CACA;CACA;CACA;CACA;CACA;CACA;AAIF,CAAC,CAAC,KAAK,GAAG,GAmDG,KACX,GACA,IAA4B,CAAC,MACf;CACd,IAAI,IAAU,IAER,UAAoC;EACxC,IAAM,IAAY,EAAa;EAI/B,OAFK,IAEE,MAAM,KAAK,EAAU,iBAA8B,CAAkB,CAAC,CAAC,CAAC,QAI5E,MAAO,CAAC,EAAG,QAAQ,wBAAsB,KAAK,CAAC,EAAG,QAAQ,UAAU,KAAK,CAAC,EAAG,QAAQ,SAAS,CACjG,IAPuB,CAAC;CAQ1B,GAEM,KAAiB,MAA+B;EAKpD,IAJI,CAAC,KAED,EAAQ,UAAU,MAAM,MAExB,EAAM,QAAQ,OAAO;EAEzB,IAAM,IAAY,EAAa;EAE/B,IAAI,EAAU,WAAW,GAAG;GAE1B,EAAM,eAAe;GAErB;EACF;EAEA,IAAM,IAAQ,EAAU,IAClB,IAAO,EAAU,EAAU,SAAS,IAGpC,IAAW,EAAM,UAA0B,SAAS;EAE1D,AAAI,EAAM,YAEJ,MAAY,KAAS,CAAC,EAAU,SAAS,CAAsB,OACjE,EAAM,eAAe,GACrB,EAAK,MAAM,MAIT,MAAY,KAAQ,CAAC,EAAU,SAAS,CAAsB,OAChE,EAAM,eAAe,GACrB,EAAM,MAAM;CAGlB,GAEM,UAAuB;EACvB,MAEJ,IAAU,IACV,SAAS,iBAAiB,WAAW,GAAe,EAAI;CAC1D,GAEM,UAAyB;EACxB,MAEL,IAAU,IACV,SAAS,oBAAoB,WAAW,GAAe,EAAI;CAC7D;CAMA,OAJI,EAAQ,UAAU,CAAC,EAAQ,OAAO,WACpC,EAAQ,OAAO,iBAAiB,SAAS,GAAY,EAAE,MAAM,GAAK,CAAC,GAG9D;EACL;EACA,IAAI,SAAS;GACX,OAAO;EACT;EACA;EACA,SAAS;GACR,OAAO,UAAU;CACpB;AACF"}