@adobe/spectrum-wc-core 0.0.0-snapshot.20260922095923

package/dist/utils/dev-validation.js

@@ -0,0 +1,33 @@
+//#region utils/dev-validation.ts
+function e(e, t, n, r) {
+	var i;
+	(i = window.__swc) != null && i.DEBUG && window.__swc.warn(e, t, n, r);
+}
+function t() {
+	var e;
+	return process.env.NODE_ENV === "production" || typeof window > "u" ? !1 : !!((e = window.__swc) != null && e.DEBUG);
+}
+function n(t, { prop: n, value: r, valid: i, url: a, options: o }) {
+	process.env.NODE_ENV !== "production" && (i.includes(r) || e(t, `<${t.localName}> expects "${n}" to be one of: ${i.join(", ")}. Received "${r}".`, a, {
+		issues: [`${n}="${r}"`],
+		...o
+	}));
+}
+function r(t, n, r, i, a) {
+	process.env.NODE_ENV !== "production" && n && e(t, r, i, a);
+}
+function i(t, n, r, i, a) {
+	process.env.NODE_ENV !== "production" && (!n || n.assignedNodes({ flatten: !0 }).length === 0) && e(t, `<${t.localName}> requires content in the "${r}" slot.`, i, a);
+}
+function a(t, n, r, i, a, o) {
+	if (process.env.NODE_ENV === "production" || !n) return;
+	let s = r.map((e) => e.toUpperCase()), c = r.map((e) => `<${e}>`).join(", ");
+	for (let r of n.assignedElements()) s.includes(r.tagName) || e(t, `<${t.localName}> "${i}" slot received a <${r.tagName.toLowerCase()}> element. Only ${c} elements are allowed.`, a, {
+		issues: [`${i} slot: <${r.tagName.toLowerCase()}>`],
+		...o
+	});
+}
+//#endregion
+export { t as isDebug, a as validateAllowedChildren, n as validateEnum, i as validateRequiredSlot, r as warnIf };
+
+//# sourceMappingURL=dev-validation.js.map

package/dist/utils/dev-validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-validation.js","names":[],"sources":["../../utils/dev-validation.ts"],"sourcesContent":["/**\n * Copyright 2026 Adobe. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\n/**\n * The single place \"warn in development\" lives: the `DEBUG` gate plus the\n * `window.__swc.warn` call. Every public helper below computes its own\n * predicate and message, then defers the actual emit to this primitive, so\n * there is one source of truth for how a warning is gated and dispatched.\n *\n * Note: this deliberately does **not** include the\n * `process.env.NODE_ENV === 'production'` guard. That guard must stay in each\n * public helper so a bundler can dead-code-eliminate the message construction\n * inside that function for production builds; centralizing it here would leave\n * each caller's message-building in the production bundle.\n *\n * @param element - The component instance the warning is attributed to.\n * @param message - The warning message.\n * @param url - Documentation URL for the component.\n * @param options - Passed through to `window.__swc.warn`.\n */\nfunction emitWarning(\n  element: HTMLElement,\n  message: string,\n  url: string,\n  options?: SWCWarningOptions\n): void {\n  if (!window.__swc?.DEBUG) {\n    return;\n  }\n  window.__swc.warn(element, message, url, options);\n}\n\n/**\n * Whether dev-mode validation is active: `false` in production builds and in\n * non-browser (SSR) environments, otherwise mirrors `window.__swc.DEBUG`.\n *\n * Use this to guard the *call site* of a warning whose condition or message is\n * expensive to compute (for example a DOM traversal), so that work is skipped\n * entirely when validation is off:\n *\n * ```ts\n * if (isDebug()) {\n *   this.warnAboutExpensiveThing(); // only traverses the DOM when validation runs\n * }\n * ```\n *\n * For cheap conditions, call `warnIf`/`validateEnum` directly; they already\n * gate internally. This helper exists only to avoid paying call-site argument\n * cost in the expensive cases. It checks `process.env.NODE_ENV` first so a\n * bundler can dead-code-eliminate the guarded block in production, matching the\n * other helpers in this file, and short-circuits when `window` is undefined so\n * it is safe to call during server-side rendering.\n */\nexport function isDebug(): boolean {\n  if (process.env.NODE_ENV === 'production') {\n    return false;\n  }\n  if (typeof window === 'undefined') {\n    return false;\n  }\n  return Boolean(window.__swc?.DEBUG);\n}\n\n/**\n * Warns when `value` is not one of `valid`. Covers union-type/enum property\n * validation (e.g. `variant`, `size`).\n *\n * @param element - The component instance the warning is attributed to.\n * @param check - The enum check to perform.\n * @param check.prop - The property name, for the warning message.\n * @param check.value - The value received.\n * @param check.valid - The allowed values.\n * @param check.url - Documentation URL for the component.\n * @param check.options - Passed through to `window.__swc.warn`.\n */\nexport function validateEnum<T extends string>(\n  element: HTMLElement,\n  {\n    prop,\n    value,\n    valid,\n    url,\n    options,\n  }: {\n    prop: string;\n    value: string;\n    valid: readonly T[];\n    url: string;\n    options?: SWCWarningOptions;\n  }\n): void {\n  if (process.env.NODE_ENV === 'production') {\n    return;\n  }\n  if ((valid as readonly string[]).includes(value)) {\n    return;\n  }\n  emitWarning(\n    element,\n    `<${element.localName}> expects \"${prop}\" to be one of: ${valid.join(', ')}. Received \"${value}\".`,\n    url,\n    { issues: [`${prop}=\"${value}\"`], ...options }\n  );\n}\n\n/**\n * Warns when `condition` is true. The general-purpose validation primitive:\n * covers required properties, conditionally required properties, mutually\n * exclusive/no-effect property combinations, and any component-specific\n * quirk that doesn't fit the other helpers here.\n *\n * @param element - The component instance the warning is attributed to.\n * @param condition - Warn when this is true.\n * @param message - The warning message.\n * @param url - Documentation URL for the component.\n * @param options - Passed through to `window.__swc.warn`.\n */\nexport function warnIf(\n  element: HTMLElement,\n  condition: boolean,\n  message: string,\n  url: string,\n  options?: SWCWarningOptions\n): void {\n  if (process.env.NODE_ENV === 'production') {\n    return;\n  }\n  if (!condition) {\n    return;\n  }\n  emitWarning(element, message, url, options);\n}\n\n/**\n * Warns when a slot has no assigned nodes. Covers required-slot validation.\n *\n * @param element - The component instance the warning is attributed to.\n * @param slot - The slot element to check (`null`/`undefined` counts as empty).\n * @param slotName - The slot's `name` attribute (or `\"default\"`), for the message.\n * @param url - Documentation URL for the component.\n * @param options - Passed through to `window.__swc.warn`.\n */\nexport function validateRequiredSlot(\n  element: HTMLElement,\n  slot: HTMLSlotElement | null | undefined,\n  slotName: string,\n  url: string,\n  options?: SWCWarningOptions\n): void {\n  if (process.env.NODE_ENV === 'production') {\n    return;\n  }\n  const isEmpty = !slot || slot.assignedNodes({ flatten: true }).length === 0;\n  if (!isEmpty) {\n    return;\n  }\n  emitWarning(\n    element,\n    `<${element.localName}> requires content in the \"${slotName}\" slot.`,\n    url,\n    options\n  );\n}\n\n/**\n * Warns for each assigned element in `slot` whose tag name is not in\n * `allowedTagNames`. Covers allowed-children slot validation (e.g. a heading\n * slot that only accepts `<h2>`-`<h6>`).\n *\n * @param element - The component instance the warning is attributed to.\n * @param slot - The slot element to check.\n * @param allowedTagNames - Allowed tag names (case-insensitive, e.g. `['h2', 'h3']`).\n * @param slotName - The slot's `name` attribute (or `\"default\"`), for the message.\n * @param url - Documentation URL for the component.\n * @param options - Passed through to `window.__swc.warn`.\n */\nexport function validateAllowedChildren(\n  element: HTMLElement,\n  slot: HTMLSlotElement | null | undefined,\n  allowedTagNames: readonly string[],\n  slotName: string,\n  url: string,\n  options?: SWCWarningOptions\n): void {\n  if (process.env.NODE_ENV === 'production') {\n    return;\n  }\n  if (!slot) {\n    return;\n  }\n  const allowed = allowedTagNames.map((tag) => tag.toUpperCase());\n  const allowedList = allowedTagNames.map((tag) => `<${tag}>`).join(', ');\n  for (const el of slot.assignedElements()) {\n    if (!allowed.includes(el.tagName)) {\n      emitWarning(\n        element,\n        `<${element.localName}> \"${slotName}\" slot received a <${el.tagName.toLowerCase()}> element. Only ${allowedList} elements are allowed.`,\n        url,\n        {\n          issues: [`${slotName} slot: <${el.tagName.toLowerCase()}>`],\n          ...options,\n        }\n      );\n    }\n  }\n}\n"],"mappings":";AA6BA,SAAS,EACP,GACA,GACA,GACA,GACM;;AACF,EAAA,IAAC,OAAO,UAAA,QAAA,EAAO,SAGnB,OAAO,MAAM,KAAK,GAAS,GAAS,GAAK,EAAQ;;AAwBnD,SAAgB,IAAmB;;AAOjC,QANA,QAAA,IAAA,aAA6B,gBAGzB,OAAO,SAAW,MACb,KAEF,IAAA,IAAQ,OAAO,UAAA,QAAA,EAAO;;AAe/B,SAAgB,EACd,GACA,EACE,SACA,UACA,UACA,QACA,cAQI;AACN,SAAA,IAAA,aAA6B,iBAGxB,EAA4B,SAAS,EAAM,IAGhD,EACE,GACA,IAAI,EAAQ,UAAU,aAAa,EAAK,kBAAkB,EAAM,KAAK,KAAK,CAAC,cAAc,EAAM,KAC/F,GACA;EAAE,QAAQ,CAAC,GAAG,EAAK,IAAI,EAAM,GAAG;EAAE,GAAG;EAAS,CAC/C;;AAeH,SAAgB,EACd,GACA,GACA,GACA,GACA,GACM;AACN,SAAA,IAAA,aAA6B,gBAGxB,KAGL,EAAY,GAAS,GAAS,GAAK,EAAQ;;AAY7C,SAAgB,EACd,GACA,GACA,GACA,GACA,GACM;AACN,SAAA,IAAA,aAA6B,iBAGb,CAAC,KAAQ,EAAK,cAAc,EAAE,SAAS,IAAM,CAAC,CAAC,WAAW,MAI1E,EACE,GACA,IAAI,EAAQ,UAAU,6BAA6B,EAAS,UAC5D,GACA,EACD;;AAeH,SAAgB,EACd,GACA,GACA,GACA,GACA,GACA,GACM;AAIN,KAHA,QAAA,IAAA,aAA6B,gBAGzB,CAAC,EACH;CAEF,IAAM,IAAU,EAAgB,KAAK,MAAQ,EAAI,aAAa,CAAC,EACzD,IAAc,EAAgB,KAAK,MAAQ,IAAI,EAAI,GAAG,CAAC,KAAK,KAAK;AACvE,MAAK,IAAM,KAAM,EAAK,kBAAkB,CACtC,CAAK,EAAQ,SAAS,EAAG,QAAQ,IAC/B,EACE,GACA,IAAI,EAAQ,UAAU,KAAK,EAAS,qBAAqB,EAAG,QAAQ,aAAa,CAAC,kBAAkB,EAAY,yBAChH,GACA;EACE,QAAQ,CAAC,GAAG,EAAS,UAAU,EAAG,QAAQ,aAAa,CAAC,GAAG;EAC3D,GAAG;EACJ,CACF"}

package/dist/utils/dismissible-stack.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Copyright 2026 Adobe. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+/**
+ * Register a dismissible as the topmost entry when it opens. Any existing entry
+ * for the same key is removed first, so re-registering moves the key to the top
+ * and the stack never holds duplicates.
+ */
+export declare function registerDismissible(key: object): void;
+/**
+ * Remove the most-recent entry matching the key when it closes. Idempotent: a
+ * key that is not present is a no-op (safe to call from `disconnectedCallback`).
+ */
+export declare function unregisterDismissible(key: object): void;
+/**
+ * Whether the key is the topmost (most-recently-registered) dismissible.
+ */
+export declare function isTopDismissible(key: object): boolean;

package/dist/utils/dismissible-stack.js

@@ -0,0 +1,16 @@
+//#region utils/dismissible-stack.ts
+var e = [];
+function t(t) {
+	n(t), e.push(t);
+}
+function n(t) {
+	let n = e.lastIndexOf(t);
+	n !== -1 && e.splice(n, 1);
+}
+function r(t) {
+	return e[e.length - 1] === t;
+}
+//#endregion
+export { r as isTopDismissible, t as registerDismissible, n as unregisterDismissible };
+
+//# sourceMappingURL=dismissible-stack.js.map

package/dist/utils/dismissible-stack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dismissible-stack.js","names":[],"sources":["../../utils/dismissible-stack.ts"],"sourcesContent":["/**\n * Copyright 2026 Adobe. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\n/**\n * A LIFO stack of currently-open dismissible top-layer components, used to\n * coordinate Escape handling across mechanisms that don't natively order with\n * each other (e.g. an `popover=\"auto\"` element open while a `<dialog>` is also\n * open).\n *\n * Usage convention for consumers:\n *\n * - `registerDismissible(this)` on open.\n * - `unregisterDismissible(this)` on close and in `disconnectedCallback`.\n * - Check `isTopDismissible(this)` before processing any custom Escape handling.\n *\n * State is module-level and in-memory only; it resets on page reload, which is\n * correct for this coordination use case.\n *\n */\nconst dismissibleStack: object[] = [];\n\n/**\n * Register a dismissible as the topmost entry when it opens. Any existing entry\n * for the same key is removed first, so re-registering moves the key to the top\n * and the stack never holds duplicates.\n */\nexport function registerDismissible(key: object): void {\n  unregisterDismissible(key);\n  dismissibleStack.push(key);\n}\n\n/**\n * Remove the most-recent entry matching the key when it closes. Idempotent: a\n * key that is not present is a no-op (safe to call from `disconnectedCallback`).\n */\nexport function unregisterDismissible(key: object): void {\n  const index = dismissibleStack.lastIndexOf(key);\n  if (index !== -1) {\n    dismissibleStack.splice(index, 1);\n  }\n}\n\n/**\n * Whether the key is the topmost (most-recently-registered) dismissible.\n */\nexport function isTopDismissible(key: object): boolean {\n  // Index access rather than `Array.prototype.at()`: core's TS lib target does\n  // not include `at`. On an empty stack `length - 1` is `-1`, which reads as\n  // `undefined` and never equals a (non-null) key.\n  return dismissibleStack[dismissibleStack.length - 1] === key;\n}\n"],"mappings":";AA4BA,IAAM,IAA6B,EAAE;AAOrC,SAAgB,EAAoB,GAAmB;AAErD,CADA,EAAsB,EAAI,EAC1B,EAAiB,KAAK,EAAI;;AAO5B,SAAgB,EAAsB,GAAmB;CACvD,IAAM,IAAQ,EAAiB,YAAY,EAAI;AAC/C,CAAI,MAAU,MACZ,EAAiB,OAAO,GAAO,EAAE;;AAOrC,SAAgB,EAAiB,GAAsB;AAIrD,QAAO,EAAiB,EAAiB,SAAS,OAAO"}

package/dist/utils/focusable-selectors.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Copyright 2026 Adobe. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+/**
+ * CSS selector strings for matching focusable and tabbable DOM elements
+ * per the HTML specification.
+ *
+ * These selectors use standard HTML focusability rules only — the 1st-gen
+ * custom `[focusable]` attribute selector is intentionally not included,
+ * as native `delegatesFocus` replaces that workaround.
+ */
+/**
+ * Matches elements that can receive focus programmatically (via `.focus()`).
+ *
+ * Includes elements with `tabindex="-1"` which are focusable via script
+ * but not reachable via the Tab key.
+ *
+ * @example
+ * ```typescript
+ * const firstFocusable = shadowRoot.querySelector(focusableSelector);
+ * ```
+ */
+export declare const focusableSelector: string;
+/**
+ * Matches elements reachable via the Tab key.
+ *
+ * This is a subset of {@link focusableSelector} that excludes elements
+ * with `tabindex="-1"` (which are focusable via script but not tabbable).
+ *
+ * @example
+ * ```typescript
+ * const tabbableElements = [...container.querySelectorAll(tabbableSelector)];
+ * ```
+ */
+export declare const tabbableSelector: string;

package/dist/utils/focusable-selectors.js

@@ -0,0 +1,18 @@
+//#region utils/focusable-selectors.ts
+var e = [
+	"input:not([inert]):not([disabled])",
+	"select:not([inert]):not([disabled])",
+	"textarea:not([inert]):not([disabled])",
+	"a[href]:not([inert])",
+	"button:not([inert]):not([disabled])",
+	"[tabindex]:not([inert])",
+	"audio[controls]:not([inert])",
+	"video[controls]:not([inert])",
+	"[contenteditable]:not([contenteditable=\"false\"]):not([inert])",
+	"details>summary:first-of-type:not([inert])",
+	"details:not([inert])"
+].join(","), t = e.split(",").map((e) => e + ":not([tabindex=\"-1\"])").join(",");
+//#endregion
+export { e as focusableSelector, t as tabbableSelector };
+
+//# sourceMappingURL=focusable-selectors.js.map

package/dist/utils/focusable-selectors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"focusable-selectors.js","names":[],"sources":["../../utils/focusable-selectors.ts"],"sourcesContent":["/**\n * Copyright 2026 Adobe. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\n/**\n * CSS selector strings for matching focusable and tabbable DOM elements\n * per the HTML specification.\n *\n * These selectors use standard HTML focusability rules only — the 1st-gen\n * custom `[focusable]` attribute selector is intentionally not included,\n * as native `delegatesFocus` replaces that workaround.\n */\n\n/**\n * Matches elements that can receive focus programmatically (via `.focus()`).\n *\n * Includes elements with `tabindex=\"-1\"` which are focusable via script\n * but not reachable via the Tab key.\n *\n * @example\n * ```typescript\n * const firstFocusable = shadowRoot.querySelector(focusableSelector);\n * ```\n */\nexport const focusableSelector = [\n  'input:not([inert]):not([disabled])',\n  'select:not([inert]):not([disabled])',\n  'textarea:not([inert]):not([disabled])',\n  'a[href]:not([inert])',\n  'button:not([inert]):not([disabled])',\n  '[tabindex]:not([inert])',\n  'audio[controls]:not([inert])',\n  'video[controls]:not([inert])',\n  '[contenteditable]:not([contenteditable=\"false\"]):not([inert])',\n  'details>summary:first-of-type:not([inert])',\n  'details:not([inert])',\n].join(',');\n\n/**\n * Matches elements reachable via the Tab key.\n *\n * This is a subset of {@link focusableSelector} that excludes elements\n * with `tabindex=\"-1\"` (which are focusable via script but not tabbable).\n *\n * @example\n * ```typescript\n * const tabbableElements = [...container.querySelectorAll(tabbableSelector)];\n * ```\n */\nexport const tabbableSelector = focusableSelector\n  .split(',')\n  .map((s) => s + ':not([tabindex=\"-1\"])')\n  .join(',');\n"],"mappings":";AAgCA,IAAa,IAAoB;CAC/B;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD,CAAC,KAAK,IAAI,EAaE,IAAmB,EAC7B,MAAM,IAAI,CACV,KAAK,MAAM,IAAI,0BAAwB,CACvC,KAAK,IAAI"}

package/dist/utils/get-active-element.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Copyright 2026 Adobe. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+/**
+ * Returns the deepest focused element by traversing shadow DOM boundaries.
+ *
+ * `document.activeElement` stops at shadow hosts — this utility follows
+ * `shadowRoot.activeElement` chains to find the leaf-level focused element.
+ *
+ * @param root - The document or shadow root to start traversal from.
+ *               Defaults to `document`.
+ * @returns The deepest focused element, or `null` if nothing is focused.
+ *
+ * @example
+ * ```typescript
+ * // Get the truly focused element across all shadow boundaries
+ * const active = getActiveElement();
+ *
+ * // Start traversal from a specific root
+ * const active = getActiveElement(el.getRootNode() as Document);
+ * ```
+ */
+export declare function getActiveElement(root?: Document | ShadowRoot): HTMLElement | null;

package/dist/utils/get-active-element.js

@@ -0,0 +1,11 @@
+//#region utils/get-active-element.ts
+function e(e = document) {
+	var t;
+	let n = e.activeElement;
+	for (; !(n == null || (t = n.shadowRoot) == null) && t.activeElement;) n = n.shadowRoot.activeElement;
+	return n;
+}
+//#endregion
+export { e as getActiveElement };
+
+//# sourceMappingURL=get-active-element.js.map

package/dist/utils/get-active-element.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-active-element.js","names":[],"sources":["../../utils/get-active-element.ts"],"sourcesContent":["/**\n * Copyright 2026 Adobe. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\n/**\n * Returns the deepest focused element by traversing shadow DOM boundaries.\n *\n * `document.activeElement` stops at shadow hosts — this utility follows\n * `shadowRoot.activeElement` chains to find the leaf-level focused element.\n *\n * @param root - The document or shadow root to start traversal from.\n *               Defaults to `document`.\n * @returns The deepest focused element, or `null` if nothing is focused.\n *\n * @example\n * ```typescript\n * // Get the truly focused element across all shadow boundaries\n * const active = getActiveElement();\n *\n * // Start traversal from a specific root\n * const active = getActiveElement(el.getRootNode() as Document);\n * ```\n */\nexport function getActiveElement(\n  root: Document | ShadowRoot = document\n): HTMLElement | null {\n  let current = root.activeElement as HTMLElement | null;\n  while (current?.shadowRoot?.activeElement) {\n    current = current.shadowRoot.activeElement as HTMLElement;\n  }\n  return current;\n}\n"],"mappings":";AA+BA,SAAgB,EACd,IAA8B,UACV;;CACpB,IAAI,IAAU,EAAK;AACnB,QAAA,OAAA,SAAA,IAAO,EAAS,eAAA,SAAA,EAAY,eAC1B,KAAU,EAAQ,WAAW;AAE/B,QAAO"}

package/dist/utils/get-label-from-slot.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Copyright 2026 Adobe. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+export declare const getLabelFromSlot: (label: string, slotEl: HTMLSlotElement) => string | null;

package/dist/utils/get-label-from-slot.js

@@ -0,0 +1,10 @@
+//#region utils/get-label-from-slot.ts
+var e = (e, t) => {
+	if (e) return null;
+	let n = t.assignedNodes().reduce((e, t) => t.textContent ? e + t.textContent : e, "");
+	return n ? n.trim() : null;
+};
+//#endregion
+export { e as getLabelFromSlot };
+
+//# sourceMappingURL=get-label-from-slot.js.map

package/dist/utils/get-label-from-slot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-label-from-slot.js","names":[],"sources":["../../utils/get-label-from-slot.ts"],"sourcesContent":["/**\n * Copyright 2026 Adobe. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nexport const getLabelFromSlot = (\n  label: string,\n  slotEl: HTMLSlotElement\n): string | null => {\n  if (label) {\n    return null;\n  }\n  const textContent = slotEl\n    .assignedNodes()\n    .reduce((accumulator: string, node: Node) => {\n      if (node.textContent) {\n        return accumulator + node.textContent;\n      } else {\n        return accumulator;\n      }\n    }, '');\n  if (textContent) {\n    return textContent.trim();\n  } else {\n    return null;\n  }\n};\n"],"mappings":";AAYA,IAAa,KACX,GACA,MACkB;AAClB,KAAI,EACF,QAAO;CAET,IAAM,IAAc,EACjB,eAAe,CACf,QAAQ,GAAqB,MACxB,EAAK,cACA,IAAc,EAAK,cAEnB,GAER,GAAG;AAIN,QAHE,IACK,EAAY,MAAM,GAElB"}

package/dist/utils/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Copyright 2026 Adobe. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+export { physicalSide } from './actual-placement.js';
+export { capitalize } from './capitalize.js';
+export { deepContains } from './deep-contains.js';
+export { isDebug, validateAllowedChildren, validateEnum, validateRequiredSlot, warnIf, } from './dev-validation.js';
+export { isTopDismissible, registerDismissible, unregisterDismissible, } from './dismissible-stack.js';
+export { getActiveElement } from './get-active-element.js';
+export { focusableSelector, tabbableSelector } from './focusable-selectors.js';
+export { getLabelFromSlot } from './get-label-from-slot.js';
+export { isFocusVisibleInTree } from './is-focus-visible-in-tree.js';
+export { resolveTrigger, type ResolvedTrigger, type ResolveTriggerOptions, } from './resolve-trigger.js';
+export { hasActiveTransition, maxTransitionDurationMs, runAfterTransition, } from './transition.js';

package/dist/utils/index.js

@@ -0,0 +1,12 @@
+import { physicalSide as e } from "./actual-placement.js";
+import { capitalize as t } from "./capitalize.js";
+import { deepContains as n } from "./deep-contains.js";
+import { isDebug as r, validateAllowedChildren as i, validateEnum as a, validateRequiredSlot as o, warnIf as s } from "./dev-validation.js";
+import { isTopDismissible as c, registerDismissible as l, unregisterDismissible as u } from "./dismissible-stack.js";
+import { getActiveElement as d } from "./get-active-element.js";
+import { focusableSelector as f, tabbableSelector as p } from "./focusable-selectors.js";
+import { getLabelFromSlot as m } from "./get-label-from-slot.js";
+import { isFocusVisibleInTree as h } from "./is-focus-visible-in-tree.js";
+import { resolveTrigger as g } from "./resolve-trigger.js";
+import { hasActiveTransition as _, maxTransitionDurationMs as v, runAfterTransition as y } from "./transition.js";
+export { t as capitalize, n as deepContains, f as focusableSelector, d as getActiveElement, m as getLabelFromSlot, _ as hasActiveTransition, r as isDebug, h as isFocusVisibleInTree, c as isTopDismissible, v as maxTransitionDurationMs, e as physicalSide, l as registerDismissible, g as resolveTrigger, y as runAfterTransition, p as tabbableSelector, u as unregisterDismissible, i as validateAllowedChildren, a as validateEnum, o as validateRequiredSlot, s as warnIf };

package/dist/utils/is-focus-visible-in-tree.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Copyright 2026 Adobe. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+/**
+ * Returns whether the deepest focused element in a tree is matched by
+ * `:focus-visible` (i.e. the platform would show a focus ring).
+ *
+ * Traverses shadow DOM boundaries via {@link getActiveElement} before testing
+ * the pseudo-class, so it reports the truly focused element rather than stopping
+ * at a shadow host.
+ *
+ * @param root - The document or shadow root to start traversal from. Pass a
+ *               component's root node (`el.getRootNode()`) to scope the check to
+ *               that tree. Defaults to `document`.
+ * @returns `true` if the active element matches `:focus-visible`, otherwise `false`.
+ *
+ * @example
+ * ```typescript
+ * // Inside a component, mirror focus-visible state to a reactive property.
+ * this.focused = isFocusVisibleInTree(
+ *   this.getRootNode() as Document | ShadowRoot
+ * );
+ * ```
+ */
+export declare function isFocusVisibleInTree(root?: Document | ShadowRoot): boolean;

package/dist/utils/is-focus-visible-in-tree.js

@@ -0,0 +1,11 @@
+import { getActiveElement as e } from "./get-active-element.js";
+//#region utils/is-focus-visible-in-tree.ts
+function t(t = document) {
+	var n;
+	let r = e(t);
+	return (n = r == null ? void 0 : r.matches(":focus-visible")) == null ? !1 : n;
+}
+//#endregion
+export { t as isFocusVisibleInTree };
+
+//# sourceMappingURL=is-focus-visible-in-tree.js.map

package/dist/utils/is-focus-visible-in-tree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-focus-visible-in-tree.js","names":[],"sources":["../../utils/is-focus-visible-in-tree.ts"],"sourcesContent":["/**\n * Copyright 2026 Adobe. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nimport { getActiveElement } from './get-active-element.js';\n\n/**\n * Returns whether the deepest focused element in a tree is matched by\n * `:focus-visible` (i.e. the platform would show a focus ring).\n *\n * Traverses shadow DOM boundaries via {@link getActiveElement} before testing\n * the pseudo-class, so it reports the truly focused element rather than stopping\n * at a shadow host.\n *\n * @param root - The document or shadow root to start traversal from. Pass a\n *               component's root node (`el.getRootNode()`) to scope the check to\n *               that tree. Defaults to `document`.\n * @returns `true` if the active element matches `:focus-visible`, otherwise `false`.\n *\n * @example\n * ```typescript\n * // Inside a component, mirror focus-visible state to a reactive property.\n * this.focused = isFocusVisibleInTree(\n *   this.getRootNode() as Document | ShadowRoot\n * );\n * ```\n */\nexport function isFocusVisibleInTree(\n  root: Document | ShadowRoot = document\n): boolean {\n  const active = getActiveElement(root);\n  return active?.matches(':focus-visible') ?? false;\n}\n"],"mappings":";;AAmCA,SAAgB,EACd,IAA8B,UACrB;;CACT,IAAM,IAAS,EAAiB,EAAK;AACrC,SAAA,IAAA,KAAA,OAAA,KAAA,IAAO,EAAQ,QAAQ,iBAAiB,KAAA,OAAI,KAAJ"}

package/dist/utils/resolve-trigger.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Copyright 2026 Adobe. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+/**
+ * Options for {@link resolveTrigger}.
+ */
+export interface ResolveTriggerOptions {
+    /** ID of the trigger element in the host's tree root. */
+    for?: string;
+    /** Direct trigger reference; overrides `for` when set. */
+    triggerElement?: HTMLElement | null;
+}
+/**
+ * The resolved trigger and the element that should receive ARIA wiring.
+ *
+ * `trigger` is the element used for positioning. `interactiveElement` is the
+ * AT-facing focusable element: the inner `<button>` of an open-shadow SWC
+ * component when present, otherwise the trigger itself.
+ */
+export interface ResolvedTrigger {
+    trigger: HTMLElement | null;
+    interactiveElement: HTMLElement | null;
+}
+/**
+ * Resolve the trigger for a popover-like host and discover the AT-facing inner
+ * button across shadow boundaries.
+ *
+ * Resolution order: a direct `triggerElement` reference wins; otherwise `for`
+ * is resolved by ID within the host's tree root (`getRootNode().getElementById`,
+ * strictly same-root). When the resolved trigger exposes an open shadow root,
+ * its inner `<button>` becomes the `interactiveElement` that receives ARIA;
+ * otherwise ARIA is wired on the trigger itself.
+ */
+export declare function resolveTrigger(host: HTMLElement, options: ResolveTriggerOptions): ResolvedTrigger;

package/dist/utils/resolve-trigger.js

@@ -0,0 +1,23 @@
+//#region utils/resolve-trigger.ts
+function e(e, t) {
+	var n, r, i;
+	let a = (n = t.triggerElement) == null ? null : n;
+	if (!a && t.for) {
+		var o, s;
+		let n = e.getRootNode();
+		a = (o = (s = n.getElementById) == null ? void 0 : s.call(n, t.for)) == null ? null : o;
+	}
+	if (!a) return {
+		trigger: null,
+		interactiveElement: null
+	};
+	let c = (r = (i = a.shadowRoot) == null ? void 0 : i.querySelector("button")) == null ? null : r;
+	return {
+		trigger: a,
+		interactiveElement: c == null ? a : c
+	};
+}
+//#endregion
+export { e as resolveTrigger };
+
+//# sourceMappingURL=resolve-trigger.js.map

package/dist/utils/resolve-trigger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-trigger.js","names":[],"sources":["../../utils/resolve-trigger.ts"],"sourcesContent":["/**\n * Copyright 2026 Adobe. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\n/**\n * Options for {@link resolveTrigger}.\n */\nexport interface ResolveTriggerOptions {\n  /** ID of the trigger element in the host's tree root. */\n  for?: string;\n  /** Direct trigger reference; overrides `for` when set. */\n  triggerElement?: HTMLElement | null;\n}\n\n/**\n * The resolved trigger and the element that should receive ARIA wiring.\n *\n * `trigger` is the element used for positioning. `interactiveElement` is the\n * AT-facing focusable element: the inner `<button>` of an open-shadow SWC\n * component when present, otherwise the trigger itself.\n */\nexport interface ResolvedTrigger {\n  trigger: HTMLElement | null;\n  interactiveElement: HTMLElement | null;\n}\n\n/**\n * Resolve the trigger for a popover-like host and discover the AT-facing inner\n * button across shadow boundaries.\n *\n * Resolution order: a direct `triggerElement` reference wins; otherwise `for`\n * is resolved by ID within the host's tree root (`getRootNode().getElementById`,\n * strictly same-root). When the resolved trigger exposes an open shadow root,\n * its inner `<button>` becomes the `interactiveElement` that receives ARIA;\n * otherwise ARIA is wired on the trigger itself.\n */\nexport function resolveTrigger(\n  host: HTMLElement,\n  options: ResolveTriggerOptions\n): ResolvedTrigger {\n  let trigger: HTMLElement | null = options.triggerElement ?? null;\n\n  if (!trigger && options.for) {\n    // `getRootNode()` returns the Document or the host's ShadowRoot; both expose\n    // `getElementById`, keeping resolution strictly within the same tree root.\n    const root = host.getRootNode() as Document | ShadowRoot;\n    trigger = root.getElementById?.(options.for) ?? null;\n  }\n\n  if (!trigger) {\n    return { trigger: null, interactiveElement: null };\n  }\n\n  // Inner-button discovery: for a gen2 component trigger with an open shadow\n  // root, wire ARIA on the AT-facing inner <button>. Closed-shadow or native\n  // triggers fall back to the trigger host itself.\n  const innerButton = trigger.shadowRoot?.querySelector('button') ?? null;\n\n  return { trigger, interactiveElement: innerButton ?? trigger };\n}\n"],"mappings":";AA4CA,SAAgB,EACd,GACA,GACiB;;CACjB,IAAI,KAAA,IAA8B,EAAQ,mBAAA,OAAkB,OAAlB;AAE1C,KAAI,CAAC,KAAW,EAAQ,KAAK;;EAG3B,IAAM,IAAO,EAAK,aAAa;AAC/B,OAAA,KAAA,IAAU,EAAK,mBAAA,OAAA,KAAA,IAAA,EAAA,KAAA,GAAiB,EAAQ,IAAI,KAAA,OAAI,OAAJ;;AAG9C,KAAI,CAAC,EACH,QAAO;EAAE,SAAS;EAAM,oBAAoB;EAAM;CAMpD,IAAM,KAAA,KAAA,IAAc,EAAQ,eAAA,OAAA,KAAA,IAAA,EAAY,cAAc,SAAS,KAAA,OAAI,OAAJ;AAE/D,QAAO;EAAE;EAAS,oBAAoB,KAAA,OAAe,IAAf;EAAwB"}

package/dist/utils/transition.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Copyright 2026 Adobe. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+/**
+ * Whether the element has an active CSS transition: at least one
+ * `transition-duration` entry is non-zero. Returns `false` when no transition
+ * will run (none declared, or reduced motion has zeroed it out), in which case
+ * `transitionend` will not fire and callers should run their completion logic
+ * immediately instead of waiting for it.
+ *
+ * @param element - The element whose computed `transition-duration` is read.
+ */
+export declare function hasActiveTransition(element: Element): boolean;
+/**
+ * The longest `transition-duration` on the element, in milliseconds. Useful as a
+ * fallback timeout for browsers that do not fire `transitionend` for
+ * `transition-behavior: allow-discrete` discrete properties.
+ *
+ * @param element - The element whose computed `transition-duration` is read.
+ */
+export declare function maxTransitionDurationMs(element: Element): number;
+/**
+ * Run `callback` once `element`'s CSS transition settles, or synchronously when
+ * no transition will run (none declared, or reduced motion) since neither
+ * `transitionend` nor `transitioncancel` will fire in that case. A
+ * `transitioncancel` (interrupted transition) settles the callback as promptly
+ * as a normal `transitionend`.
+ *
+ * When `fallback` is `true` (the default) a timer (the longest declared duration
+ * plus a small buffer) also settles the callback, covering browsers that skip
+ * both transition events for `transition-behavior: allow-discrete` properties
+ * (e.g. Firefox). Pass `fallback: false` when no completion-gated work depends on
+ * the callback (e.g. an open transition, where a delayed `transitionend` should
+ * not be pre-empted by the timer). The listeners and the timer are mutually
+ * cancelling, so the callback runs exactly once.
+ *
+ * @param element - The element whose transition completion is awaited.
+ * @param callback - Invoked once when the transition settles.
+ * @returns A cancel function that removes the listeners and clears the timer
+ *   **without** running the callback. Call it to supersede a pending run (for
+ *   example a new open/close cycle) or to clean up on disconnect.
+ */
+export declare function runAfterTransition(element: Element, callback: () => void, { fallback }?: {
+    fallback?: boolean;
+}): () => void;

package/dist/utils/transition.js

@@ -0,0 +1,26 @@
+//#region utils/transition.ts
+function e(e) {
+	return getComputedStyle(e).transitionDuration.split(",").map((e) => {
+		let t = e.trim(), n = parseFloat(t);
+		return Number.isNaN(n) ? 0 : t.endsWith("ms") ? n : n * 1e3;
+	});
+}
+function t(t) {
+	return e(t).some((e) => e > 0);
+}
+function n(t) {
+	return Math.max(0, ...e(t));
+}
+function r(e, r, { fallback: i = !0 } = {}) {
+	if (!t(e)) return r(), () => {};
+	let a = (t) => {
+		t && t.target !== e || (o(), r());
+	}, o = () => {
+		s !== void 0 && clearTimeout(s), e.removeEventListener("transitionend", a), e.removeEventListener("transitioncancel", a);
+	}, s = i ? setTimeout(a, n(e) + 100) : void 0;
+	return e.addEventListener("transitionend", a), e.addEventListener("transitioncancel", a), o;
+}
+//#endregion
+export { t as hasActiveTransition, n as maxTransitionDurationMs, r as runAfterTransition };
+
+//# sourceMappingURL=transition.js.map

package/dist/utils/transition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transition.js","names":[],"sources":["../../utils/transition.ts"],"sourcesContent":["/**\n * Copyright 2026 Adobe. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\n/**\n * Parse an element's computed `transition-duration` into milliseconds per entry.\n * The value is comma-separated when multiple properties transition (for example\n * `\"0.2s, 0.2s, 0s\"`), so each entry is parsed independently rather than reading\n * only the first (which `parseFloat` of the whole string would do).\n */\nfunction transitionDurationsMs(element: Element): number[] {\n  return getComputedStyle(element)\n    .transitionDuration.split(',')\n    .map((entry) => {\n      const trimmed = entry.trim();\n      const value = parseFloat(trimmed);\n      if (Number.isNaN(value)) {\n        return 0;\n      }\n      return trimmed.endsWith('ms') ? value : value * 1000;\n    });\n}\n\n/**\n * Whether the element has an active CSS transition: at least one\n * `transition-duration` entry is non-zero. Returns `false` when no transition\n * will run (none declared, or reduced motion has zeroed it out), in which case\n * `transitionend` will not fire and callers should run their completion logic\n * immediately instead of waiting for it.\n *\n * @param element - The element whose computed `transition-duration` is read.\n */\nexport function hasActiveTransition(element: Element): boolean {\n  return transitionDurationsMs(element).some((ms) => ms > 0);\n}\n\n/**\n * The longest `transition-duration` on the element, in milliseconds. Useful as a\n * fallback timeout for browsers that do not fire `transitionend` for\n * `transition-behavior: allow-discrete` discrete properties.\n *\n * @param element - The element whose computed `transition-duration` is read.\n */\nexport function maxTransitionDurationMs(element: Element): number {\n  return Math.max(0, ...transitionDurationsMs(element));\n}\n\n/**\n * Run `callback` once `element`'s CSS transition settles, or synchronously when\n * no transition will run (none declared, or reduced motion) since neither\n * `transitionend` nor `transitioncancel` will fire in that case. A\n * `transitioncancel` (interrupted transition) settles the callback as promptly\n * as a normal `transitionend`.\n *\n * When `fallback` is `true` (the default) a timer (the longest declared duration\n * plus a small buffer) also settles the callback, covering browsers that skip\n * both transition events for `transition-behavior: allow-discrete` properties\n * (e.g. Firefox). Pass `fallback: false` when no completion-gated work depends on\n * the callback (e.g. an open transition, where a delayed `transitionend` should\n * not be pre-empted by the timer). The listeners and the timer are mutually\n * cancelling, so the callback runs exactly once.\n *\n * @param element - The element whose transition completion is awaited.\n * @param callback - Invoked once when the transition settles.\n * @returns A cancel function that removes the listeners and clears the timer\n *   **without** running the callback. Call it to supersede a pending run (for\n *   example a new open/close cycle) or to clean up on disconnect.\n */\nexport function runAfterTransition(\n  element: Element,\n  callback: () => void,\n  { fallback = true }: { fallback?: boolean } = {}\n): () => void {\n  if (!hasActiveTransition(element)) {\n    callback();\n    return () => {};\n  }\n\n  // `event` is present for the transition events and absent for the fallback\n  // timer. Ignore transitions bubbling up from descendants (e.g. slotted\n  // content) so only the element's own transition settles the callback.\n  const settle = (event?: TransitionEvent): void => {\n    if (event && event.target !== element) {\n      return;\n    }\n    cancel();\n    callback();\n  };\n  const cancel = (): void => {\n    if (timer !== undefined) {\n      clearTimeout(timer);\n    }\n    element.removeEventListener('transitionend', settle as EventListener);\n    element.removeEventListener('transitioncancel', settle as EventListener);\n  };\n\n  const timer = fallback\n    ? setTimeout(settle, maxTransitionDurationMs(element) + 100)\n    : undefined;\n  element.addEventListener('transitionend', settle as EventListener);\n  element.addEventListener('transitioncancel', settle as EventListener);\n\n  return cancel;\n}\n"],"mappings":";AAkBA,SAAS,EAAsB,GAA4B;AACzD,QAAO,iBAAiB,EAAQ,CAC7B,mBAAmB,MAAM,IAAI,CAC7B,KAAK,MAAU;EACd,IAAM,IAAU,EAAM,MAAM,EACtB,IAAQ,WAAW,EAAQ;AAIjC,SAHI,OAAO,MAAM,EAAM,GACd,IAEF,EAAQ,SAAS,KAAK,GAAG,IAAQ,IAAQ;GAChD;;AAYN,SAAgB,EAAoB,GAA2B;AAC7D,QAAO,EAAsB,EAAQ,CAAC,MAAM,MAAO,IAAK,EAAE;;AAU5D,SAAgB,EAAwB,GAA0B;AAChE,QAAO,KAAK,IAAI,GAAG,GAAG,EAAsB,EAAQ,CAAC;;AAwBvD,SAAgB,EACd,GACA,GACA,EAAE,cAAW,OAAiC,EAAE,EACpC;AACZ,KAAI,CAAC,EAAoB,EAAQ,CAE/B,QADA,GAAU,QACG;CAMf,IAAM,KAAU,MAAkC;AAC5C,OAAS,EAAM,WAAW,MAG9B,GAAQ,EACR,GAAU;IAEN,UAAqB;AAKzB,EAJI,MAAU,KAAA,KACZ,aAAa,EAAM,EAErB,EAAQ,oBAAoB,iBAAiB,EAAwB,EACrE,EAAQ,oBAAoB,oBAAoB,EAAwB;IAGpE,IAAQ,IACV,WAAW,GAAQ,EAAwB,EAAQ,GAAG,IAAI,GAC1D,KAAA;AAIJ,QAHA,EAAQ,iBAAiB,iBAAiB,EAAwB,EAClE,EAAQ,iBAAiB,oBAAoB,EAAwB,EAE9D"}