@pgcorp/ui-kit 0.13.0 → 0.15.0

package/dist/src/internal/layerStack.js

@@ -1,82 +1,365 @@
-import { isFocusableElement as e } from "./focusNavigation.js";
+import { createAggregateError as e } from "./es2020.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 t = [], n = !1, r = 0, i = "", a = (e, t) => e.root()?.contains(t) || e.anchor?.()?.contains(t) ? !0 : e.branches?.().some((e) => e.contains(t)) ?? !1, o = (e) => {
-	let n = e.anchor?.() ?? e.restoreTarget ?? (typeof document < "u" && document.activeElement instanceof HTMLElement ? document.activeElement : null);
-	return n ? [...t].reverse().find((e) => a(e, n))?.id ?? null : null;
-}, s = () => t[t.length - 1], c = (e) => {
-	let n = e.parentId;
-	for (; n;) {
-		let e = t.find((e) => e.id === n);
+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 = 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 ? [...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) || 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 = o.find((e) => e.id === t);
 		if (!e) break;
 		if (e.modal || e.trapFocus) return e.root() ?? document;
-		n = e.parentId;
+		t = e.parentId;
 	}
 	return document;
-}, l = (e) => {
-	let n = s();
-	if (!n) return;
+}, B = (e) => {
+	if (!L()) return;
 	if (e.key === "Escape") {
-		(n.dismissOnEscape?.() ?? !0) && (e.preventDefault(), e.stopPropagation(), n.requestDismiss("escape", 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 r = -1;
-	for (let e = t.length - 1; e >= 0; --e) if (t[e]?.trapFocus) {
-		r = e;
+	let t = -1;
+	for (let e = o.length - 1; e >= 0; --e) if (o[e]?.trapFocus) {
+		t = e;
 		break;
 	}
-	r < 0 || t.slice(r + 1).some((e) => e.blocksParentFocusTrap ?? !0) || t[r]?.trapFocus?.(e);
-}, u = (e, t) => {
-	let n = s();
+	if (t < 0) return;
+	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;
-	r instanceof Node && a(n, r) || (n.dismissOnOutsidePointer?.() ?? !0) && n.requestDismiss(t, e);
-}, d = (e) => {
-	u(e, "outside-pointer");
-}, f = (e) => {
-	u(e, "outside-contextmenu");
-}, p = () => {
-	n || typeof window > "u" || typeof document > "u" || (n = !0, window.addEventListener("keydown", l, !0), document.addEventListener("pointerdown", d, !0), document.addEventListener("contextmenu", f, !0));
-}, m = () => {
-	!n || t.length > 0 || typeof window > "u" || typeof document > "u" || (n = !1, window.removeEventListener("keydown", l, !0), document.removeEventListener("pointerdown", d, !0), document.removeEventListener("contextmenu", f, !0));
-}, h = () => {
-	typeof document < "u" && (r === 0 && (i = document.body.style.overflow, document.body.style.overflow = "hidden"), r += 1);
-}, g = () => {
-	typeof document < "u" && (r = Math.max(0, r - 1), r === 0 && (document.body.style.overflow = i));
-}, _ = (t) => {
+	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 (t.restoreTarget?.isConnected && e(t.restoreTarget)) {
-			t.restoreTarget.focus();
-			return;
+		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();
 		}
-		s()?.root()?.focus();
 	});
+}, re = (e, t) => {
+	let n = document.activeElement, r = !1;
+	return {
+		cancel: () => {
+			r = !0;
+		},
+		commit: (a) => {
+			queueMicrotask(() => {
+				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 });
+			});
+		}
+	};
+}, 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) => {
+	if (!e.registered) return;
+	e.focusHandoff?.cancel(), e.focusHandoff = null, e.registered = !1;
+	let t = o.indexOf(e);
+	t >= 0 && o.splice(t, 1), e.modal && J();
 };
-function v(e) {
-	let n = s(), r = e.modal || n?.tier === "overlay" ? "overlay" : "floating", i = n && n.tier === r ? `calc(${n.zIndex} + var(--s-layer-overlay-step))` : r === "overlay" ? "var(--s-layer-root-overlay-backdrop)" : "var(--s-layer-root-floating)", a = {
-		...e,
-		id: Symbol(e.kind),
-		parentId: o(e),
-		restoreTarget: e.restoreTarget ?? null,
-		tier: r,
-		zIndex: i
-	}, l = !0;
-	return t.push(a), a.modal && h(), p(), {
-		id: a.id,
-		zIndex: a.zIndex,
-		focusScope: () => c(a),
-		unregister: ({ restoreFocus: e = !1 } = {}) => {
-			if (!l) return;
-			l = !1;
-			let n = t.findIndex((e) => e.id === a.id), r = n === t.length - 1;
-			if (n >= 0) {
-				let e = a.root();
-				for (let r of t.slice(n + 1)) r.parentId === a.id && (r.parentId = a.parentId), e?.contains(r.restoreTarget) && (r.restoreTarget = a.restoreTarget);
-				t.splice(n, 1);
+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: c,
+		eventBoundary: t.eventBoundary ?? (t.modal ? void 0 : l?.eventBoundary),
+		restoreTarget: t.restoreTarget ?? null,
+		tier: u,
+		zIndex: _,
+		registered: !0,
+		focusHandoff: null,
+		nativeCycle: null
+	};
+	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 (!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: 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 = 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);
+			}
+			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) {
+				N.push(e);
 			}
-			a.modal && g(), m(), e && r && _(a);
+			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 { v as registerLayer };
+export { M as captureLayerFocusAdmission, ie as registerLayer };

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

@@ -5,6 +5,7 @@ export interface LinkTargetInput {
     readonly to?: unknown;
     readonly target?: unknown;
     readonly rel?: unknown;
+    readonly download?: unknown;
     readonly owner: string;
 }
 export type ResolvedLinkTarget = {
@@ -13,6 +14,7 @@ export type ResolvedLinkTarget = {
         readonly href: string;
         readonly target: LinkBrowsingTarget;
         readonly rel?: string;
+        readonly download?: string;
     };
 } | {
     readonly kind: 'router';
@@ -22,5 +24,9 @@ export type ResolvedLinkTarget = {
         readonly rel?: string;
     };
 };
-/** Validates the sole link-target boundary and secures new browsing contexts. */
+/**
+ * Validates the sole href/router boundary and secures new browsing contexts.
+ * Download is href-only native intent; filenames are preserved and false omits
+ * the attribute. Invalid destinations or download payloads throw TypeError.
+ */
 export declare function resolveLinkTarget(input: LinkTargetInput): ResolvedLinkTarget;

package/dist/src/internal/linkTarget.js

@@ -103,17 +103,21 @@ function f(e, t, n) {
 	return i.has("noopener") || r.push("noopener"), i.has("noreferrer") || r.push("noreferrer"), r.join(" ");
 }
 function p(e) {
-	let t = e.href !== void 0;
-	if (t === (e.to !== void 0)) throw TypeError(`${e.owner}: передайте ровно один target — href или to`);
-	let n = d(e.owner, e.target), r = f(e.owner, e.rel, n);
+	let t = e.href !== void 0, n = e.to !== void 0;
+	if (e.download !== void 0 && (!t || n)) throw TypeError(`${e.owner}: download допускается только с href / download requires an href-only destination`);
+	if (t === n) throw TypeError(`${e.owner}: передайте ровно один target — href или to`);
+	let r = d(e.owner, e.target), i = f(e.owner, e.rel, r);
 	if (t) {
 		if (typeof e.href != "string" || e.href.trim().length === 0 || e.href !== e.href.trim()) throw TypeError(`${e.owner}: href должен быть непустой строкой / href must be a non-empty string`);
+		if (e.download !== void 0 && typeof e.download != "string" && typeof e.download != "boolean") throw TypeError(`${e.owner}: download должен быть строкой или boolean / download must be a string or boolean`);
+		let t = e.download === !0 ? "" : e.download;
 		return {
 			kind: "anchor",
 			bindings: {
 				href: e.href,
-				target: n,
-				...r === void 0 ? {} : { rel: r }
+				target: r,
+				...i === void 0 ? {} : { rel: i },
+				...typeof t == "string" ? { download: t } : {}
 			}
 		};
 	}
@@ -121,8 +125,8 @@ function p(e) {
 		kind: "router",
 		bindings: {
 			to: e.to,
-			target: n,
-			...r === void 0 ? {} : { rel: r }
+			target: r,
+			...i === void 0 ? {} : { rel: i }
 		}
 	};
 	throw TypeError(`${e.owner}: недостижимый router target / unreachable router target`);

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/overlayHost.d.ts

@@ -0,0 +1,18 @@
+import { InjectionKey, Ref } from 'vue';
+/** Logical ancestor visibility controls overlay admission without changing portal geometry or owning consumer content. */
+export declare function useOverlayAdmission(): Readonly<Ref<boolean>>;
+/** Provides parent AND local admission; retained descendants may run while their transient overlays are retired. */
+export declare function provideOverlayAdmission(active: Readonly<Ref<boolean>>): Readonly<Ref<boolean>>;
+/** Private connected host contract shared by scoped overlay owners. / Приватный connected host для scoped overlay owners. */
+export interface OverlayHostContext {
+    readonly root: Readonly<Ref<HTMLElement | null>>;
+    readonly content: Readonly<Ref<HTMLElement | null>>;
+    readonly portal: Readonly<Ref<HTMLElement | null>>;
+    /** Acquire local content inertness; release is idempotent, retirement invokes the callback once. */
+    acquire: (onRetire: () => void) => () => void;
+}
+export declare const overlayHostKey: InjectionKey<OverlayHostContext>;
+/** Resolves the nearest host; required ownership has no global-body fallback. */
+export declare function useOverlayHost(owner: string, required: true): OverlayHostContext;
+export declare function useOverlayHost(owner: string, required: false): OverlayHostContext | undefined;
+export declare function useOverlayHost(owner: string, required: boolean): OverlayHostContext | undefined;

package/dist/src/internal/overlayHost.js

@@ -0,0 +1,18 @@
+import { computed as e, inject as t, provide as n } from "vue";
+//#region src/internal/overlayHost.ts
+var r = Symbol("ui-kit-overlay-admission"), i = e(() => !0);
+function a() {
+	return t(r, i);
+}
+function o(t) {
+	let i = a(), o = e(() => i.value && t.value);
+	return n(r, o), o;
+}
+var s = Symbol("ui-kit-overlay-host");
+function c(e, n) {
+	let r = t(s, void 0);
+	if (n && !r) throw TypeError(`${e}: scope="contained" requires a parent SOverlayHost. / Требуется родительский SOverlayHost.`);
+	return r;
+}
+//#endregion
+export { s as overlayHostKey, o as provideOverlayAdmission, a as useOverlayAdmission, c as useOverlayHost };

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/ownedAttrs.d.ts

@@ -1,13 +1,21 @@
 import { AnchorHTMLAttributes, HTMLAttributes, InputHTMLAttributes, TextareaHTMLAttributes } from 'vue';
 type OwnedAttributeValueKind = 'aria' | 'aria-boolean' | 'aria-current' | 'aria-haspopup' | 'aria-pressed' | 'boolean-attribute' | 'data' | 'input-mode' | 'listener' | 'string' | 'string-or-boolean' | 'string-or-number';
 /**
- * Exact runtime allowlist каждого public owner.
- * Exact runtime allowlist for every public owner.
+ * Exact runtime allowlist каждого зарегистрированного attribute owner.
+ * Exact runtime allowlist for every registered attribute owner.
+ *
+ * Public owners обязаны иметь схему; private compound owners объявляют её при передаче attrs.
+ * Public owners require a schema; private compound owners declare one when forwarding attrs.
  *
  * Пустая схема означает, что компонент не принимает fallthrough attrs: его API целиком выражен props/emits/slots.
  * An empty schema means that the component accepts no fallthrough attrs: props/emits/slots express its entire API.
  */
 export declare const ownedAttributeSchemas: Readonly<{
+    readonly STableFrame: Readonly<{}>;
+    readonly SRichImage: Readonly<{}>;
+    readonly STableSection: Readonly<{}>;
+    readonly STableRow: Readonly<{}>;
+    readonly STableCell: Readonly<{}>;
     readonly SAppShell: Readonly<{}>;
     readonly SDockRegion: Readonly<{}>;
     readonly SResizeHandle: Readonly<{
@@ -40,6 +48,7 @@ export declare const ownedAttributeSchemas: Readonly<{
         readonly 'data-testid': "data";
     }>;
     readonly SDrawer: Readonly<{}>;
+    readonly SOverlayHost: Readonly<{}>;
     readonly SFormGrid: Readonly<{}>;
     readonly SFormGridItem: Readonly<{}>;
     readonly SLeftSidebar: Readonly<{}>;
@@ -187,7 +196,6 @@ export declare const ownedAttributeSchemas: Readonly<{
         readonly 'aria-label': "string";
         readonly 'data-s-app-shell-brand-passive': "data";
         readonly 'data-testid': "data";
-        readonly download: "string-or-boolean";
         readonly title: "string";
     }>;
     readonly SListbox: Readonly<{
@@ -211,7 +219,9 @@ export declare const ownedAttributeSchemas: Readonly<{
         readonly 'data-testid': "data";
     }>;
     readonly STextarea: Readonly<{
+        readonly 'aria-controls': "string";
         readonly 'aria-describedby': "string";
+        readonly 'aria-haspopup': "aria-haspopup";
         readonly 'aria-label': "string";
         readonly 'data-testid': "data";
         readonly autocomplete: "string";