@pgcorp/ui-kit 0.14.0 → 0.15.0

package/dist/src/internal/layerStack.js

@@ -1,158 +1,365 @@
 import { createAggregateError as e } from "./es2020.js";
-import { isFocusableElement as t } from "./focusNavigation.js";
+import { flatTreeContains as t } from "./flatTree.js";
+import { nativeFocusedElement as n } from "./nativeFocus.js";
+import { acquireNativeDialog as r } from "./viewportModality.js";
+import { isFocusableElement as i, isProgrammaticallyFocusableElement as a } from "./focusNavigation.js";
 //#region src/internal/layerStack.ts
-var n = [], r = !1, i = 0, a = "", o = 0, s = (e, t) => e.root()?.contains(t) || e.anchor?.()?.contains(t) ? !0 : e.branches?.().some((e) => e.contains(t)) ?? !1, c = (e) => {
+var o = [], s = !1, c = !1, l = 0, u = "", d = 0, f = null, p = null, m = 0, h = /* @__PURE__ */ new Set(), g = /* @__PURE__ */ new WeakMap(), _ = null, v = t, y = (e, t) => {
+	let n = e.root();
+	return n && v(n, t) ? !0 : e.branches?.().some((e) => v(e, t)) ?? !1;
+}, b = (e, t) => {
+	let n = e.anchor?.();
+	return y(e, t) || !!(n && v(n, t));
+}, x = (e, t) => {
+	let n = e.dismissalRoots?.();
+	if (!n) return b(e, t);
+	let r = e.anchor?.();
+	return n.some((e) => v(e, t)) || (e.branches?.().some((e) => v(e, t)) ?? !1) || !!(r && v(r, t));
+}, S = (e) => e.lost || !e.target.isConnected || e.programmatic && e.target instanceof HTMLElement && !a(e.target), C = (e) => {
+	e.active = !1, h.delete(e), K();
+}, w = (e) => e.target instanceof Element && (!e.target.isConnected || E(e.modalityLoss) || e.programmatic && e.target instanceof HTMLElement && !a(e.target)), T = (e) => (e.releasingHost || e.hostReleased) && e.programmatic && e.releaseBoundary?.isConnected === !0 && e.releaseBoundary.hasAttribute("inert") && w(e), E = (e) => e !== null && e.mutation.isCurrent() && e.target.isConnected && v(e.mutation.boundary, e.target), D = (e) => T(e) || E(e.modalityLoss), O = (e) => {
+	if (!e.active || !e.settling) return;
+	e.settling = !1;
+	let t = n();
+	t !== e.target && (t === document.body && D(e) || C(e));
+}, k = (e) => {
+	if (!e.active || e.focusRevision !== m) return !1;
+	let t = n();
+	return t === e.target ? !0 : t !== document.body || !w(e) ? !1 : e.source ? !0 : D(e);
+}, A = (e, t) => [...e.encounters].every((e) => e === t || e.registered && Q(t, e)), j = (e, t) => {
+	_ = {
+		request: e,
+		target: t
+	};
+	try {
+		t.focus({ preventScroll: !0 });
+	} finally {
+		_ = null;
+	}
+};
+function M(e = {}) {
+	if (typeof document > "u" || typeof window > "u") return null;
+	if (e.releaseBoundary !== void 0 && e.releaseBoundary !== null && (!(e.releaseBoundary instanceof HTMLElement) || !e.releaseBoundary.isConnected || e.releaseBoundary.ownerDocument !== document)) throw TypeError("layerStack: focus release boundary must be a connected same-document HTMLElement");
+	let t = n(), r = f, i = r !== null && r.revision === d && r.focusRevision === m && (t === r.activeAtClose || t === document.body && (r.activeAtClose instanceof HTMLElement && !r.activeAtClose.isConnected || E(r.retirementLoss))), s = (t && t !== document.body ? [...o].reverse().find((e) => y(e, t)) ?? null : null) ?? (i ? r.entry : null);
+	if (t === document.body && p && !s) return null;
+	let c = i ? r.activeAtClose : t, l = c instanceof HTMLElement ? c : null;
+	if (s?.kind === "menu") {
+		l = s.restoreTarget;
+		let e = s.parentId;
+		for (; l && e;) {
+			let t = o.find((t) => t.id === e);
+			if (!t || t.kind !== "menu" || !y(t, l)) break;
+			l = t.restoreTarget, e = t.parentId;
+		}
+	}
+	let u = Object.freeze({
+		restoreTarget: l,
+		acquireHost: (e) => {
+			_.active && !k(_) && C(_);
+			let t = _.releaseBoundary, r = _.active && _.target instanceof Node && n() === _.target && t?.isConnected === !0 && v(t, _.target);
+			_.releasingHost = r;
+			try {
+				let n = e();
+				return _.hostReleased = r && t?.hasAttribute("inert") === !0, n;
+			} finally {
+				_.releasingHost = !1;
+			}
+		},
+		cancel: () => C(_)
+	}), _ = {
+		token: u,
+		source: s,
+		target: c,
+		programmatic: c instanceof HTMLElement && a(c),
+		releaseBoundary: e.releaseBoundary ?? null,
+		encounters: /* @__PURE__ */ new Set(),
+		focusRevision: m,
+		pendingRestore: i ? r : null,
+		claimant: null,
+		active: !0,
+		settling: !1,
+		releasingHost: !1,
+		hostReleased: !1,
+		modalityLoss: null
+	};
+	return g.set(u, _), h.add(_), W(), u;
+}
+var N = (e) => {
+	let t = e && e !== document.body ? [...o].reverse().find((t) => y(t, e)) : void 0;
+	p = e && t ? {
+		target: e,
+		entry: t,
+		programmatic: e instanceof HTMLElement && a(e),
+		lost: !1,
+		settling: !1
+	} : null;
+}, P = () => {
+	let e = n();
+	if (e === document.body) {
+		let e = p !== null && S(p), t = [...h].filter((t) => D(t) || e && t.source === p?.entry);
+		if (e || t.length > 0) {
+			e && p && (p.lost = !0);
+			for (let e of [...h]) t.includes(e) || C(e);
+			return;
+		}
+	}
+	m += 1;
+	for (let t of [...h]) {
+		let n = _;
+		n && t.pendingRestore === n.request && t.source === n.request.entry && e === n.target && e === t.token.restoreTarget ? (t.target = e, t.programmatic = e instanceof HTMLElement && a(e), t.focusRevision = m) : C(t);
+	}
+	N(e);
+}, F = (e) => {
+	if (p !== e || !e.settling) return;
+	e.settling = !1;
+	let t = n();
+	if (t !== e.target) {
+		if (t === document.body && S(e)) {
+			e.lost = !0;
+			return;
+		}
+		p = null, m += 1;
+		for (let e of [...h]) C(e);
+	}
+}, I = (e) => {
+	let t = e.composedPath().find((e) => e instanceof Element);
+	for (let e of h) e.source || e.target !== t || n() === e.target || D(e) || e.settling || (e.settling = !0, queueMicrotask(() => O(e)));
+	let r = p;
+	if (r && n() !== r.target && e.composedPath().find((e) => e instanceof Element) === r.target) {
+		if (S(r)) {
+			r.lost = !0;
+			return;
+		}
+		r.settling || (r.settling = !0, queueMicrotask(() => F(r)));
+	}
+}, ee = (e) => {
 	if (e.parent !== void 0) {
 		if (e.parent === null) return null;
-		let t = n.find((t) => t.id === e.parent?.id);
+		let t = o.find((t) => t.id === e.parent?.id);
 		if (!t?.registered || !t.root()?.isConnected) throw TypeError("layerStack: explicit parent must be a live connected layer registration");
 		return t.id;
 	}
 	let t = e.anchor?.() ?? e.restoreTarget ?? (typeof document < "u" && document.activeElement instanceof HTMLElement ? document.activeElement : null);
-	return t ? [...n].reverse().find((e) => s(e, t))?.id ?? null : null;
-}, l = () => n[n.length - 1], u = (e, t) => {
+	return t ? [...o].reverse().find((e) => b(e, t))?.id ?? null : null;
+}, L = () => o[o.length - 1], te = (e, t) => {
 	if (!e.eventBoundary) return !0;
 	let n = e.eventBoundary();
-	return n?.isConnected ? t.composedPath().some((t) => t instanceof Node && (n.contains(t) || s(e, t))) : !1;
-}, d = (e) => {
-	let t = [...n].reverse().find((e) => e.modal);
-	return [...n].reverse().find((n) => (!t || n === t || T(n, t)) && u(n, e));
-}, f = (e) => {
+	return n?.isConnected ? t.composedPath().some((t) => t instanceof Node && (n.contains(t) || b(e, t))) : !1;
+}, R = (e) => {
+	let t = [...o].reverse().find((e) => e.modal);
+	return [...o].reverse().find((n) => (!t || n === t || Q(n, t)) && te(n, e));
+}, z = (e) => {
 	let t = e.parentId;
 	for (; t;) {
-		let e = n.find((e) => e.id === t);
+		let e = o.find((e) => e.id === t);
 		if (!e) break;
 		if (e.modal || e.trapFocus) return e.root() ?? document;
 		t = e.parentId;
 	}
 	return document;
-}, p = (e) => {
-	if (!l()) return;
+}, B = (e) => {
+	if (!L()) return;
 	if (e.key === "Escape") {
-		let t = d(e);
+		let t = R(e);
 		if (!t) return;
 		(t.dismissOnEscape?.() ?? !0) && (e.preventDefault(), e.stopPropagation(), t.requestDismiss("escape", e));
 		return;
 	}
 	if (e.key !== "Tab") return;
 	let t = -1;
-	for (let e = n.length - 1; e >= 0; --e) if (n[e]?.trapFocus) {
+	for (let e = o.length - 1; e >= 0; --e) if (o[e]?.trapFocus) {
 		t = e;
 		break;
 	}
 	if (t < 0) return;
-	let r = n[t];
-	r && (n.slice(t + 1).some((e) => T(e, r) && (e.blocksParentFocusTrap ?? !0)) || r.trapFocus?.(e));
-}, m = (e, t) => {
-	let r = d(e);
-	if (!r) return;
-	let i = e.target;
-	if (i instanceof Node && s(r, i)) return;
-	let a = x();
-	t === "outside-pointer" && a && i instanceof Node && !s(a, i) && !n.some((e) => T(e, a) && s(e, i)) && e.preventDefault(), (r.dismissOnOutsidePointer?.() ?? !0) && r.requestDismiss(t, e);
-}, h = (e) => {
-	m(e, "outside-pointer");
-}, g = (e) => {
-	m(e, "outside-contextmenu");
-}, _ = () => {
-	r || typeof window > "u" || typeof document > "u" || (r = !0, window.addEventListener("keydown", p, !0), document.addEventListener("pointerdown", h, !0), document.addEventListener("contextmenu", g, !0));
-}, v = () => {
-	!r || n.length > 0 || typeof window > "u" || typeof document > "u" || (r = !1, window.removeEventListener("keydown", p, !0), document.removeEventListener("pointerdown", h, !0), document.removeEventListener("contextmenu", g, !0));
-}, y = () => {
-	typeof document < "u" && (i === 0 && (a = document.body.style.overflow, document.body.style.overflow = "hidden"), i += 1);
-}, b = () => {
-	typeof document < "u" && (i = Math.max(0, i - 1), i === 0 && (document.body.style.overflow = a));
-}, x = () => [...n].reverse().find((e) => e.modal), S = (e, t) => {
-	let r = x();
-	return r ? s(r, e) || n.some((t) => T(t, r) && s(t, e)) : t.contains(e);
-}, C = (e, n, r) => {
+	let n = o[t];
+	n && (o.slice(t + 1).some((e) => Q(e, n) && (e.blocksParentFocusTrap ?? !0)) || n.trapFocus?.(e));
+}, V = (e, t) => {
+	let n = R(e);
+	if (!n) return;
+	let r = e.target;
+	if (r instanceof Node && x(n, r)) return;
+	let i = Y();
+	t === "outside-pointer" && i && r instanceof Node && !x(i, r) && !o.some((e) => Q(e, i) && x(e, r)) && e.preventDefault(), (n.dismissOnOutsidePointer?.() ?? !0) && n.requestDismiss(t, e);
+}, H = (e) => {
+	V(e, "outside-pointer");
+}, U = (e) => {
+	V(e, "outside-contextmenu");
+}, W = () => {
+	typeof window > "u" || typeof document > "u" || c || (c = !0, document.addEventListener("focusin", P, !0), document.addEventListener("focusout", I, !0));
+}, G = () => {
+	typeof window < "u" && typeof document < "u" && (s || (s = !0, window.addEventListener("keydown", B, !0), document.addEventListener("pointerdown", H, !0), document.addEventListener("contextmenu", U, !0)), W());
+}, K = () => {
+	o.length > 0 || typeof window > "u" || typeof document > "u" || (s && (s = !1, window.removeEventListener("keydown", B, !0), document.removeEventListener("pointerdown", H, !0), document.removeEventListener("contextmenu", U, !0)), !(!c || f || h.size > 0) && (c = !1, document.removeEventListener("focusin", P, !0), document.removeEventListener("focusout", I, !0), p = null));
+}, q = () => {
+	typeof document < "u" && (l === 0 && (u = document.body.style.overflow, document.body.style.overflow = "hidden"), l += 1);
+}, J = () => {
+	typeof document < "u" && (l = Math.max(0, l - 1), l === 0 && (document.body.style.overflow = u));
+}, Y = () => [...o].reverse().find((e) => e.modal), X = (e) => {
+	let t = e.nativeDialog;
+	if (!t) return;
+	let n = t.portal();
+	if (e.root() !== t.subject || !n?.isConnected || n.ownerDocument !== t.subject.ownerDocument || n.parentElement !== t.subject) throw TypeError("layerStack: viewport dialog requires its exact connected direct native portal");
+	e.nativeCycle?.refresh();
+}, Z = (e, t) => {
+	let n = Y();
+	return n ? b(n, e) || o.some((t) => Q(t, n) && b(t, e)) : v(t, e);
+}, ne = (e, t, r, i, o, s) => {
+	let c = {
+		entry: e,
+		activeAtClose: t,
+		revision: r,
+		focusRevision: i,
+		lostFocus: o,
+		retirementLoss: s
+	};
+	f = c;
+	for (let t of h) t.source === e && t.focusRevision === i && (t.pendingRestore = c);
 	queueMicrotask(() => {
-		if (o !== r) return;
-		let i = document.activeElement, a = n instanceof HTMLElement && !n.isConnected && i === document.body;
-		if (i !== n && !a) return;
-		if (e.restoreTarget?.isConnected && t(e.restoreTarget)) {
-			let t = f(e);
-			if (S(e.restoreTarget, t)) {
-				e.restoreTarget.focus({ preventScroll: !0 });
+		if (f === c) try {
+			if (f = null, d !== r || m !== i || o && !S(o)) return;
+			let l = n(), u = t instanceof HTMLElement && !t.isConnected && l === document.body, p = l === document.body && E(s);
+			if (l !== t && !u && !p) return;
+			if (e.restoreTarget?.isConnected && a(e.restoreTarget)) {
+				let t = z(e);
+				if (Z(e.restoreTarget, t)) {
+					j(c, e.restoreTarget);
+					return;
+				}
+			}
+			let h = z(e), g = [
+				Y()?.root(),
+				h,
+				L()?.root()
+			];
+			for (let e of g) if (e instanceof HTMLElement && e.isConnected && a(e) && Z(e, h)) {
+				j(c, e);
 				return;
 			}
+		} finally {
+			K();
 		}
-		let s = f(e), c = x()?.root();
-		c?.isConnected ? c.focus({ preventScroll: !0 }) : s instanceof HTMLElement && s.isConnected ? s.focus({ preventScroll: !0 }) : l()?.root()?.focus({ preventScroll: !0 });
 	});
-}, w = (e, n) => {
-	let r = document.activeElement, i = !1;
+}, re = (e, t) => {
+	let n = document.activeElement, r = !1;
 	return {
 		cancel: () => {
-			i = !0;
+			r = !0;
 		},
 		commit: (a) => {
 			queueMicrotask(() => {
-				if (i || o !== a || !e.isConnected || !t(e) || !(n instanceof Node) || !n.isConnected || !n.contains(e)) return;
-				let s = document.activeElement, c = r instanceof HTMLElement && !r.isConnected && s === document.body;
-				(s === r || c) && S(e, n) && e.focus({ preventScroll: !0 });
+				if (r || d !== a || !e.isConnected || !i(e) || !(t instanceof Node) || !t.isConnected || !t.contains(e)) return;
+				let o = document.activeElement, s = n instanceof HTMLElement && !n.isConnected && o === document.body;
+				(o === n || s) && Z(e, t) && e.focus({ preventScroll: !0 });
 			});
 		}
 	};
-}, T = (e, t) => {
-	let r = e.parentId;
-	for (; r;) {
-		if (r === t.id) return !0;
-		r = n.find((e) => e.id === r)?.parentId ?? null;
+}, Q = (e, t) => {
+	let n = e.parentId;
+	for (; n;) {
+		if (n === t.id) return !0;
+		n = o.find((e) => e.id === n)?.parentId ?? null;
 	}
 	return !1;
-}, E = (e) => {
+}, $ = (e) => {
 	if (!e.registered) return;
 	e.focusHandoff?.cancel(), e.focusHandoff = null, e.registered = !1;
-	let t = n.indexOf(e);
-	t >= 0 && n.splice(t, 1), e.modal && b();
+	let t = o.indexOf(e);
+	t >= 0 && o.splice(t, 1), e.modal && J();
 };
-function D(t) {
-	let r = l(), i = c(t), a = n.find((e) => e.id === i), u = t.kind === "dialog" || t.modal || r?.tier === "overlay" ? "overlay" : "floating", d = r && r.tier === u ? `calc(${r.zIndex} + var(--s-layer-overlay-step))` : u === "overlay" ? "var(--s-layer-root-overlay-backdrop)" : "var(--s-layer-root-floating)", p = {
+function ie(t) {
+	let i = t.focusAdmission ? g.get(t.focusAdmission) : void 0;
+	if (t.focusAdmission && !i) throw TypeError("layerStack: focus admission must be captured by this owner");
+	if (i?.claimant) throw TypeError("layerStack: focus admission already belongs to another registration");
+	let s = L(), c = ee(t), l = o.find((e) => e.id === c), u = t.kind === "dialog" || t.modal || s?.tier === "overlay" ? "overlay" : "floating", _ = s && s.tier === u ? `calc(${s.zIndex} + var(--s-layer-overlay-step))` : u === "overlay" ? "var(--s-layer-root-overlay-backdrop)" : "var(--s-layer-root-floating)", x = {
 		...t,
 		id: Symbol(t.kind),
-		parentId: i,
-		eventBoundary: t.eventBoundary ?? (t.modal ? void 0 : a?.eventBoundary),
+		parentId: c,
+		eventBoundary: t.eventBoundary ?? (t.modal ? void 0 : l?.eventBoundary),
 		restoreTarget: t.restoreTarget ?? null,
 		tier: u,
-		zIndex: d,
+		zIndex: _,
 		registered: !0,
-		focusHandoff: null
+		focusHandoff: null,
+		nativeCycle: null
 	};
-	return n.push(p), o += 1, p.modal && y(), _(), {
-		id: p.id,
-		zIndex: p.zIndex,
-		focusScope: () => f(p),
-		isTopmost: () => p.registered && l() === p,
+	o.push(x), d += 1;
+	for (let e of h) e.encounters.add(x);
+	if (i && (i.claimant = x, A(i, x) || C(i)), f = null, x.modal && q(), G(), x.nativeDialog) try {
+		X(x), i?.active && !k(i) && C(i), x.nativeCycle = r(x.nativeDialog.subject, (e) => {
+			i?.active && i.target instanceof Element && n() === i.target && v(e.boundary, i.target) && (i.modalityLoss = {
+				target: i.target,
+				mutation: e
+			});
+		}, () => {
+			i && C(i);
+		});
+	} catch (e) {
+		throw $(x), i && C(i), K(), e;
+	}
+	let w = n();
+	return w && y(x, w) && N(w), {
+		id: x.id,
+		zIndex: x.zIndex,
+		focusScope: () => z(x),
+		isTopmost: () => x.registered && L() === x,
+		refreshModality: () => {
+			x.registered && X(x);
+		},
+		containsFocusTarget: (e) => x.registered && (b(x, e) || o.some((t) => t.registered && Q(t, x) && b(t, e))),
+		captureOwnedFocusLoss: (e) => {
+			let t = p;
+			if (!x.registered || !t || t.entry !== x || t.target !== e) return null;
+			let r = d, i = m;
+			return { isCurrentUnavailable: () => x.registered && d === r && m === i && p === t && n() === document.body && S(t) };
+		},
+		claimFocus: (e) => {
+			if (!i || !i.active) return !1;
+			if (i.claimant !== x) throw TypeError("layerStack: focus admission claimant does not match its registration");
+			return !x.registered || L() !== x || !A(i, x) || !e.isConnected || e.ownerDocument !== document || !y(x, e) || !Z(e, z(x)) || !a(e) || !k(i) ? (C(i), !1) : (C(i), e.focus({ preventScroll: !!x.eventBoundary }), n() === e);
+		},
 		handoffFocus: (e) => {
-			if (!p.registered) throw Error("layerStack: focus handoff requires a live registration");
-			p.focusHandoff?.cancel();
-			let t = w(e, f(p));
-			return p.focusHandoff = t, t.cancel;
+			if (!x.registered) throw Error("layerStack: focus handoff requires a live registration");
+			x.focusHandoff?.cancel();
+			let t = re(e, z(x));
+			return x.focusHandoff = t, t.cancel;
 		},
-		unregister: ({ restoreFocus: t = !1, retireDescendants: r = !1, commitFocusHandoff: i = !1 } = {}) => {
-			if (!p.registered) return;
-			let a = i ? p.focusHandoff : null;
-			a && (p.focusHandoff = null);
-			let c = n.findIndex((e) => e.id === p.id), l = r ? n.filter((e) => T(e, p)) : [], u = typeof document < "u" ? document.activeElement : null, d = u instanceof Node && (s(p, u) || l.some((e) => s(e, u)));
+		unregister: ({ restoreFocus: t = !1, retireDescendants: r = !1, commitFocusHandoff: a = !1 } = {}) => {
+			if (!x.registered) return;
+			let s = a ? x.focusHandoff : null;
+			s && (x.focusHandoff = null);
+			let c = o.findIndex((e) => e.id === x.id), l = r ? o.filter((e) => Q(e, x)) : [], u = [x, ...l];
+			p?.settling && u.some((e) => e.nativeCycle !== null) && u.some((e) => e.id === p?.entry.id) && F(p);
+			let g = f, _ = g?.entry.restoreTarget, v = g?.revision === d && g.focusRevision === m && _ != null && [x, ...l].some((e) => y(e, _)) ? g : null;
+			f = null;
+			let w = n(), T = w instanceof Node && (b(x, w) || l.some((e) => b(e, w))), E = typeof document < "u" && w === document.body && p !== null && [x, ...l].some((e) => e.id === p?.entry.id) && (S(p) || p.settling) ? p : null, D = v?.focusRevision ?? m, O = i?.active === !0 && i.claimant === x && A(i, x) && k(i);
 			if (c >= 0) {
-				let e = p.root();
-				for (let t of n.slice(c + 1)) t.parentId === p.id && (t.parentId = p.parentId), e?.contains(t.restoreTarget) && (t.restoreTarget = p.restoreTarget);
-				for (let e of [...l].reverse()) E(e);
-				E(p);
+				let e = x.root();
+				for (let t of o.slice(c + 1)) t.parentId === x.id && (t.parentId = x.parentId), e?.contains(t.restoreTarget) && (t.restoreTarget = x.restoreTarget);
+				for (let e of [...l].reverse()) $(e);
+				$(x);
+			}
+			d += 1;
+			let j = d, M = null, N = [];
+			for (let e of [...l].reverse().concat(x)) try {
+				e.nativeCycle?.close((t) => {
+					T && w instanceof Element && y(e, w) && (M = {
+						target: w,
+						mutation: t
+					});
+				});
+			} catch (e) {
+				N.push(e);
 			}
-			o += 1;
-			let f = o;
-			v();
-			let m = [];
+			for (let e of [...h]) (e.claimant === x || e.source !== x || !t || l.length > 0) && C(e);
 			for (let e of [...l].reverse()) try {
 				e.onRetire?.();
 			} catch (e) {
-				m.push(e);
+				N.push(e);
 			}
-			if (a && m.length === 0 ? a.commit(f) : a?.cancel(), !a && t && d && C(p, u, f), m.length > 0) throw e(m, "layerStack: owner retirement failed");
+			if (s && N.length === 0 ? s.commit(j) : s?.cancel(), !s && t && N.length === 0 && d === j && (T || E || v || O) && ne(x, v ? v.activeAtClose : w, j, D, v?.lostFocus ?? E, v?.retirementLoss ?? M), K(), N.length > 0) throw e(N, "layerStack: owner retirement failed");
 		}
 	};
 }
 //#endregion
-export { D as registerLayer };
+export { M as captureLayerFocusAdmission, ie as registerLayer };

package/dist/src/internal/nativeFocus.d.ts

@@ -0,0 +1,4 @@
+/** Reads actual native focus owners through exposed shadow-root focus chains without eligibility or modality policy. */
+export declare const nativeFocusChain: () => Element[];
+/** Returns the exposed native leaf, retaining opaque shadow hosts as the actual observable boundary. */
+export declare const nativeFocusedElement: () => Element | null;

package/dist/src/internal/nativeFocus.js

@@ -0,0 +1,12 @@
+//#region src/internal/nativeFocus.ts
+var e = () => {
+	if (typeof document > "u") return [];
+	let e = [], t = document.activeElement;
+	for (; t;) e.push(t), t = t.shadowRoot?.activeElement ?? null;
+	return e;
+}, t = () => {
+	let t = e();
+	return t[t.length - 1] ?? null;
+};
+//#endregion
+export { e as nativeFocusChain, t as nativeFocusedElement };

package/dist/src/internal/overlayPortal.d.ts

@@ -0,0 +1,17 @@
+import { ComputedRef, Ref } from 'vue';
+/** Exact native dialog portal ownership; initial focus admission does not control this lifetime. */
+export interface OverlayPortalContext {
+    readonly scope: Readonly<Ref<'document' | 'native'>>;
+    readonly subject: Readonly<Ref<HTMLDialogElement | null>>;
+    readonly target: Readonly<Ref<HTMLElement | null>>;
+    readonly admitted: Readonly<Ref<boolean>>;
+}
+/** Provides one viewport cycle; contained owners preserve the inherited viewport context. */
+export declare function provideOverlayPortal(context: OverlayPortalContext): void;
+/** Returns the logical native owner, or undefined for an unscoped document surface. */
+export declare function useOverlayPortal(): OverlayPortalContext | undefined;
+/**
+ * Unscoped layers use body. Scoped pending/retired layers have no target; a connected
+ * portal outside its exact same-document native subject is a contract error.
+ */
+export declare function useOverlayPortalTarget(): ComputedRef<HTMLElement | 'body' | null>;

package/dist/src/internal/overlayPortal.js

@@ -0,0 +1,23 @@
+import { flatTreeContains as e } from "./flatTree.js";
+import { computed as t, inject as n, provide as r } from "vue";
+//#region src/internal/overlayPortal.ts
+var i = Symbol("ui-kit-overlay-portal");
+function a(e) {
+	r(i, e);
+}
+function o() {
+	return n(i, void 0);
+}
+function s() {
+	let n = o();
+	return t(() => {
+		if (!n || n.scope.value === "document") return "body";
+		if (!n.admitted.value) return null;
+		let t = n.subject.value, r = n.target.value;
+		if (!t || !r || !t.isConnected || !r.isConnected) return null;
+		if (t.ownerDocument !== r.ownerDocument || !e(t, r)) throw TypeError("ui-kit overlay portal: connected target must belong to its exact same-document native dialog");
+		return t.open ? r : null;
+	});
+}
+//#endregion
+export { a as provideOverlayPortal, o as useOverlayPortal, s as useOverlayPortalTarget };

package/dist/src/internal/semanticSizing.d.ts

@@ -1,5 +1,5 @@
 declare const SCROLLABLE_VIEWPORT_MAX_BLOCK_SIZES: readonly ["none", "sm", "md", "lg"];
-declare const SCROLL_VIEWPORT_BLOCK_SIZES: readonly ["sm", "md", "lg", "fill"];
+declare const SCROLL_VIEWPORT_BLOCK_SIZES: readonly ["sm", "md", "lg", "fill", "content"];
 declare const EXPANDED_CONTENT_MAX_BLOCK_SIZES: readonly ["sm", "md", "lg"];
 declare const TABLE_COLUMN_INLINE_SIZES: readonly ["auto", "content", "2xs", "xs", "sm", "md", "lg", "xl", "fill"];
 declare const TABLE_COLUMN_MIN_INLINE_SIZES: readonly ["2xs", "xs", "sm", "md", "lg", "xl"];
@@ -8,7 +8,7 @@ declare const TABLE_COLUMN_MIN_INLINE_SIZES: readonly ["2xs", "xs", "sm", "md",
  * Maximum block size for a scroll viewport; none preserves natural flow.
  */
 export type ScrollableViewportMaxBlockSize = typeof SCROLLABLE_VIEWPORT_MAX_BLOCK_SIZES[number];
-/** Фиксированная semantic block-size рабочей scroll-области. / Fixed semantic block size of a scroll workspace. */
+/** Semantic block-size scroll-области; content сохраняет естественный flow. / Semantic scroll size; content preserves natural flow. */
 export type ScrollViewportBlockSize = typeof SCROLL_VIEWPORT_BLOCK_SIZES[number];
 /**
  * Максимальный block-size раскрытого текстового content region.

package/dist/src/internal/semanticSizing.js

@@ -9,7 +9,8 @@ var t = [
 	"sm",
 	"md",
 	"lg",
-	"fill"
+	"fill",
+	"content"
 ], r = [
 	"sm",
 	"md",

package/dist/src/internal/useMenuLayer.d.ts

@@ -18,6 +18,7 @@ export declare function useMenuLayer(layerApiRef: Ref<SMenuLayerApi | null>, opt
     onRetire?: () => void;
 }): {
     isOpen: Ref<boolean, boolean>;
+    portalTarget: import('vue').ComputedRef<HTMLElement | "body" | null>;
     position: Ref<import('../composables/useFloatingPosition').FloatingCoordinates, import('../composables/useFloatingPosition').FloatingCoordinates>;
     availableSize: Ref<import('../composables/useFloatingPosition').FloatingAvailableSize | null, import('../composables/useFloatingPosition').FloatingAvailableSize | null>;
     zIndex: Ref<string, string>;