@pgcorp/ui-kit 0.13.0 → 0.14.0

package/dist/src/internal/layerStack.js

@@ -1,82 +1,158 @@
-import { isFocusableElement as e } from "./focusNavigation.js";
+import { createAggregateError as e } from "./es2020.js";
+import { isFocusableElement as t } 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 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) => {
+	if (e.parent !== void 0) {
+		if (e.parent === null) return null;
+		let t = n.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) => {
+	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) => {
+	let t = e.parentId;
+	for (; t;) {
+		let e = n.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;
+}, p = (e) => {
+	if (!l()) return;
 	if (e.key === "Escape") {
-		(n.dismissOnEscape?.() ?? !0) && (e.preventDefault(), e.stopPropagation(), n.requestDismiss("escape", e));
+		let t = d(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 = n.length - 1; e >= 0; --e) if (n[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 (!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 (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) => {
 	queueMicrotask(() => {
-		if (t.restoreTarget?.isConnected && e(t.restoreTarget)) {
-			t.restoreTarget.focus();
-			return;
+		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 });
+				return;
+			}
 		}
-		s()?.root()?.focus();
+		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;
+	return {
+		cancel: () => {
+			i = !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 });
+			});
+		}
+	};
+}, T = (e, t) => {
+	let r = e.parentId;
+	for (; r;) {
+		if (r === t.id) return !0;
+		r = n.find((e) => e.id === r)?.parentId ?? null;
+	}
+	return !1;
+}, 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();
 };
-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 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 = {
+		...t,
+		id: Symbol(t.kind),
+		parentId: i,
+		eventBoundary: t.eventBoundary ?? (t.modal ? void 0 : a?.eventBoundary),
+		restoreTarget: t.restoreTarget ?? null,
+		tier: u,
+		zIndex: d,
+		registered: !0,
+		focusHandoff: null
+	};
+	return n.push(p), o += 1, p.modal && y(), _(), {
+		id: p.id,
+		zIndex: p.zIndex,
+		focusScope: () => f(p),
+		isTopmost: () => p.registered && l() === p,
+		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;
+		},
+		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)));
+			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);
+			}
+			o += 1;
+			let f = o;
+			v();
+			let m = [];
+			for (let e of [...l].reverse()) try {
+				e.onRetire?.();
+			} catch (e) {
+				m.push(e);
 			}
-			a.modal && g(), m(), e && r && _(a);
+			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");
 		}
 	};
 }
 //#endregion
-export { v as registerLayer };
+export { D 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/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/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";

package/dist/src/internal/ownedAttrs.js

@@ -4,6 +4,11 @@ function t(e) {
 	return Object.freeze(e);
 }
 var n = Object.freeze({
+	STableFrame: t({}),
+	SRichImage: t({}),
+	STableSection: t({}),
+	STableRow: t({}),
+	STableCell: t({}),
 	SAppShell: t({}),
 	SDockRegion: t({}),
 	SResizeHandle: t({ "data-test-id": "data" }),
@@ -24,6 +29,7 @@ var n = Object.freeze({
 	SCloudChromeRow: t({}),
 	SCollapsiblePanel: t({ "data-testid": "data" }),
 	SDrawer: t({}),
+	SOverlayHost: t({}),
 	SFormGrid: t({}),
 	SFormGridItem: t({}),
 	SLeftSidebar: t({}),
@@ -163,7 +169,6 @@ var n = Object.freeze({
 		"aria-label": "string",
 		"data-s-app-shell-brand-passive": "data",
 		"data-testid": "data",
-		download: "string-or-boolean",
 		title: "string"
 	}),
 	SListbox: t({
@@ -185,7 +190,9 @@ var n = Object.freeze({
 		"data-testid": "data"
 	}),
 	STextarea: t({
+		"aria-controls": "string",
 		"aria-describedby": "string",
+		"aria-haspopup": "aria-haspopup",
 		"aria-label": "string",
 		"data-testid": "data",
 		autocomplete: "string",

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

@@ -17,6 +17,8 @@ export declare function validateBoolean(owner: string, coordinate: string, value
  * Validates an HTML DOM id: a non-empty string without ASCII whitespace.
  */
 export declare function validateDomId(owner: string, coordinate: string, value: unknown): string;
+/** Validates an explicit single-space DOM IDREF list without rewriting input identities. */
+export declare function validateDomIdReferences(owner: string, coordinate: string, value: unknown): string;
 /**
  * Возвращает generated DOM id только при отсутствии явного значения и валидирует обе ветки.
  * Returns a generated DOM id only when the explicit value is absent and validates both branches.

package/dist/src/internal/runtimeContract.js

@@ -26,23 +26,28 @@ function o(n, r, i) {
 	let a = t(i);
 	throw TypeError(`${n}: ${r} должен быть непустым DOM id без ASCII-пробелов; получено ${a}. / ${n}: ${r} must be a non-empty DOM id without ASCII whitespace; received ${a}.`);
 }
-function s(e, t, n, r) {
+function s(e, t, n) {
+	let r = i(e, t, n);
+	for (let [n, i] of r.split(" ").entries()) o(e, `${t}[${n}]`, i);
+	return r;
+}
+function c(e, t, n, r) {
 	return n === void 0 ? o(e, `generated ${t}`, r) : o(e, t, n);
 }
-function c(e, n, i, a) {
+function l(e, n, i, a) {
 	if (r(e, n, a), typeof i == "string" && a.includes(i)) return i;
 	let o = `[${a.map((e) => JSON.stringify(e)).join(", ")}]`, s = t(i);
 	throw TypeError(`${e}: ${n} должен быть одним из ${o}; получено ${s}. / ${e}: ${n} must be one of ${o}; received ${s}.`);
 }
-function l(e, r, i, a) {
+function u(e, r, i, a) {
 	if (n(e, r, a, !1), typeof i == "number" && Number.isFinite(i) && i >= a.minimum && i <= a.maximum) return i;
 	let o = t(i);
 	throw TypeError(`${e}: ${r} должен быть конечным числом в диапазоне [${a.minimum}, ${a.maximum}]; получено ${o}. / ${e}: ${r} must be a finite number in the inclusive range [${a.minimum}, ${a.maximum}]; received ${o}.`);
 }
-function u(e, r, i, a) {
+function d(e, r, i, a) {
 	if (n(e, r, a, !0), typeof i == "number" && Number.isInteger(i) && i >= a.minimum && i <= a.maximum) return i;
 	let o = t(i);
 	throw TypeError(`${e}: ${r} должен быть целым числом в диапазоне [${a.minimum}, ${a.maximum}]; получено ${o}. / ${e}: ${r} must be an integer in the inclusive range [${a.minimum}, ${a.maximum}]; received ${o}.`);
 }
 //#endregion
-export { s as resolveOptionalDomId, a as validateBoolean, u as validateBoundedInteger, l as validateBoundedNumber, o as validateDomId, c as validateExactString, i as validateNonEmptyString };
+export { c as resolveOptionalDomId, a as validateBoolean, d as validateBoundedInteger, u as validateBoundedNumber, o as validateDomId, s as validateDomIdReferences, l as validateExactString, i as validateNonEmptyString };

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

@@ -1,4 +1,5 @@
 import { Ref } from 'vue';
+import { SMenuLayerApi } from '../components/shared/_internal/SMenuLayer.vue';
 export type MenuAnchor = {
     type: 'element';
     element: HTMLElement;
@@ -9,14 +10,16 @@ export type MenuAnchor = {
     x: number;
     y: number;
 };
-export type MenuCloseReason = 'escape' | 'outside' | 'programmatic' | 'selection' | 'trigger';
+export type MenuCloseReason = 'escape' | 'outside' | 'programmatic' | 'selection' | 'trigger' | 'tab';
 /** Управляет общей lifecycle/focus границей menu поверх canonical floating geometry. / Owns menu lifecycle and focus over canonical floating geometry. */
-export declare function useMenuLayer(layerRef: Ref<HTMLElement | null>, options?: {
-    onDismiss?: (reason: 'escape' | 'outside') => void;
-    onRequestDismiss?: (reason: 'escape' | 'outside') => void;
+export declare function useMenuLayer(layerApiRef: Ref<SMenuLayerApi | null>, options?: {
+    onDismiss?: (reason: 'escape' | 'outside' | 'tab') => void;
+    onRequestDismiss?: (reason: 'escape' | 'outside' | 'tab') => void;
+    onRetire?: () => void;
 }): {
     isOpen: Ref<boolean, boolean>;
     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>;
     open: (nextAnchor: MenuAnchor, focusTarget?: HTMLElement | null) => Promise<void>;
     close: (reason?: MenuCloseReason) => void;