@pgcorp/ui-kit 0.10.0 → 0.10.1

package/dist/src/components/shared/_internal/STreeNode.vue_vue_type_script_setup_true_lang.js

@@ -0,0 +1,410 @@
+import { Check as e, ChevronDown as t, ChevronRight as n, Minus as r } from "../../icons/sputnigUiIcons.js";
+import { useUiKitLocale as i } from "../../../composables/useUiKitLocale.js";
+import { PassiveContentBoundary as a, useInteractiveLeafRegistration as o } from "../../../internal/passiveContentContract.js";
+import { TREE_ACTION_CONTEXT_KEY as s, TREE_RUNTIME_KEY as ee, TreeActionRegistrationStore as te } from "./treeRuntime.js";
+import ne from "../controls/SButton.vue.js";
+import { selectionKeyToken as re } from "./useSelectionRoving.js";
+import ie from "../controls/SCheckbox.vue.js";
+import { Fragment as c, computed as l, createBlock as u, createCommentVNode as d, createElementBlock as f, createElementVNode as p, createSlots as ae, createVNode as m, defineComponent as oe, guardReactiveProps as h, h as se, inject as ce, mergeProps as g, normalizeClass as _, normalizeProps as v, normalizeStyle as le, onBeforeUnmount as ue, onMounted as de, openBlock as y, provide as fe, ref as pe, renderList as me, renderSlot as b, resolveComponent as he, resolveDynamicComponent as ge, toDisplayString as _e, unref as x, useSlots as ve, withCtx as S, withModifiers as C } from "vue";
+//#region src/components/shared/_internal/STreeNode.vue?vue&type=script&setup=true&lang.ts
+var ye = [
+	"id",
+	"tabindex",
+	"aria-level",
+	"aria-posinset",
+	"aria-setsize",
+	"aria-expanded",
+	"aria-selected",
+	"aria-checked",
+	"aria-disabled"
+], be = { class: "s-tree-node-hitbox py-0.5 transition-colors duration-[var(--s-motion-fast)] hover:bg-surface-100 dark:hover:bg-surface-800" }, xe = {
+	key: 0,
+	class: "s-tree-node-selection-rail",
+	"aria-hidden": "false"
+}, Se = { class: "s-tree-node__primary" }, Ce = { class: "s-tree-node__header" }, we = { class: "s-tree-node__center" }, Te = { class: "s-tree-node__trailing s-tree-node-right" }, Ee = { class: "s-tree-node__meta" }, De = {
+	key: 0,
+	class: "s-tree-node-actions__persistent"
+}, Oe = {
+	key: 1,
+	class: "s-tree-node-actions__transient"
+}, ke = {
+	key: 3,
+	class: "s-tree-node s-tree-node__layout w-full flex-grow"
+}, Ae = { class: "s-tree-node__primary" }, je = { class: "s-tree-node__header" }, Me = { class: "s-tree-node__title" }, Ne = { class: "s-tree-node__center" }, Pe = { class: "s-tree-node__trailing s-tree-node-right" }, Fe = { class: "s-tree-node__meta" }, Ie = {
+	key: 0,
+	class: "s-tree-node-actions__persistent"
+}, Le = {
+	key: 1,
+	class: "s-tree-node-actions__transient"
+}, Re = {
+	key: 0,
+	class: "s-tree-node-children",
+	role: "group"
+}, w = /*@__PURE__*/ oe({
+	name: "STreeNode",
+	__name: "STreeNode",
+	props: {
+		node: {},
+		level: {},
+		parentKey: {},
+		position: {},
+		setSize: {}
+	},
+	setup(w) {
+		o({ owner: "STreeNode" });
+		let T = w, { t: E } = i(), D = ve();
+		function ze(e) {
+			if (e) return e;
+			throw Error("STreeNode must be rendered inside STree");
+		}
+		let O = ze(ce(ee)), k = pe(null), A = pe(null), j = new te(() => A.value), M = {
+			owner: "STreeNode",
+			region: "passive row content",
+			guidance: "Передайте действия через persistent-actions или actions slot. / Put actions in the persistent-actions or actions slot."
+		}, N = oe({
+			name: "STreeActionRegion",
+			inheritAttrs: !1,
+			props: {
+				context: {
+					type: Object,
+					required: !0
+				},
+				setElement: {
+					type: Function,
+					required: !0
+				}
+			},
+			setup(e, { attrs: t, slots: n }) {
+				return fe(s, e.context), () => se("div", {
+					...t,
+					ref: e.setElement
+				}, n.default?.());
+			}
+		});
+		function P(e) {
+			if (e === null || e instanceof HTMLElement) {
+				A.value = e;
+				return;
+			}
+			throw Error("STree action region ref must resolve to an HTMLElement");
+		}
+		let F = l(() => O.model.key(T.node)), I = l(() => O.model.label(T.node)), L = l(() => O.model.children(T.node)), R = l(() => O.model.icon(T.node)), z = l(() => O.selection.value), B = l(() => O.multipleKeys(T.node)), V = l(() => L.value.length > 0), H = l(() => O.expanded.value.has(F.value)), U = l(() => O.model.disabled(T.node)), W = l(() => U.value || z.value.mode === "multiple" && B.value.length === 0), G = l(() => z.value.mode === "none" ? !1 : z.value.mode === "single" ? z.value.key === F.value : B.value.length > 0 && B.value.every((e) => z.value.mode === "multiple" && z.value.keys.has(e))), K = l(() => z.value.mode !== "multiple" || B.value.length === 0 || G.value ? !1 : B.value.some((e) => z.value.mode === "multiple" && z.value.keys.has(e))), q = l(() => O.selectionRail.value === "visible" && z.value.mode === "multiple"), Be = l(() => !!(D["persistent-actions"] || D.actions)), Ve = l(() => z.value.mode === "single" || z.value.mode === "multiple" || V.value && O.expandControl.value === "row"), He = l(() => O.activeKey.value === F.value), Ue = l(() => `s-tree-item-${re("STree", F.value, "rendered node key")}`), We = l(() => O.density.value === "compact" ? `${T.level * .85 + .25}rem` : `${T.level === 0 ? 1 : T.level * 1.5}rem`), Ge = l(() => E(H.value ? "tree.collapseNode" : "tree.expandNode", { label: I.value })), Ke = l(() => E(G.value || K.value ? "tree.deselectNode" : "tree.selectNode", { label: I.value })), qe = l(() => K.value ? "mixed" : G.value), Je = l(() => K.value ? "mixed" : G.value);
+		function J() {
+			O.toggleNode(T.node);
+		}
+		function Y() {
+			W.value || (z.value.mode === "multiple" ? O.checkNode(T.node) : z.value.mode === "single" && O.selectNode(T.node));
+		}
+		function Ye(e) {
+			if (O.expandControl.value === "row" && V.value) {
+				J();
+				return;
+			}
+			if (z.value.mode === "multiple" && V.value) {
+				J();
+				return;
+			}
+			z.value.mode === "single" && O.selectNode(T.node), V.value || O.activateNode(T.node, e);
+		}
+		function Xe() {
+			O.activeKey.value = F.value, k.value?.focus({ preventScroll: !0 }), !U.value && Ye("pointer");
+		}
+		function Ze(e) {
+			return e.target instanceof Element ? e.target : null;
+		}
+		function X(e) {
+			let t = Ze(e);
+			return !!(t && A.value?.contains(t));
+		}
+		function Qe(e) {
+			e.composedPath().find((e) => e instanceof HTMLElement && e.getAttribute("role") === "treeitem") === k.value && (X(e) || Xe());
+		}
+		function Z() {
+			O.activeKey.value = F.value, k.value?.focus({ preventScroll: !0 });
+		}
+		function $e() {
+			Z(), J();
+		}
+		function et() {
+			Z(), Y();
+		}
+		let Q = l(() => ({
+			node: T.node,
+			key: F.value,
+			isSelected: G.value,
+			isPartiallySelected: K.value,
+			isExpanded: H.value,
+			hasChildren: V.value,
+			toggle: J,
+			select: Y,
+			level: T.level,
+			density: O.density.value,
+			actionsLayout: O.actionsLayout.value,
+			expandControl: O.expandControl.value,
+			selectionRail: O.selectionRail.value,
+			rowVariant: O.rowVariant.value
+		}));
+		function $() {
+			let e = k.value;
+			if (!e) throw Error("STreeNode registration requires a mounted treeitem element");
+			return {
+				key: F.value,
+				parentKey: T.parentKey,
+				node: T.node,
+				element: e,
+				activate: Ye,
+				select: Y,
+				toggle: J,
+				expanded: () => H.value,
+				hasChildren: () => V.value,
+				disabled: () => U.value
+			};
+		}
+		function tt() {
+			j.orderedEnabled()[0]?.focus({ preventScroll: !0 });
+		}
+		function nt(e) {
+			let t = j.orderedEnabled(), n = j.actionForTarget(e.target), r = n ? t.indexOf(n) : -1;
+			if (e.key === "Escape") {
+				e.preventDefault(), e.stopPropagation(), Z();
+				return;
+			}
+			if (e.key === "Tab") {
+				e.preventDefault(), e.stopPropagation();
+				let n = t[r + (e.shiftKey ? -1 : 1)];
+				n ? n.focus({ preventScroll: !0 }) : Z();
+				return;
+			}
+			[
+				"ArrowLeft",
+				"ArrowRight",
+				"ArrowUp",
+				"ArrowDown",
+				"Home",
+				"End"
+			].includes(e.key) && (e.preventDefault(), e.stopPropagation(), t[e.key === "Home" ? 0 : e.key === "End" ? t.length - 1 : r + (e.key === "ArrowLeft" || e.key === "ArrowUp" ? -1 : 1)]?.focus({ preventScroll: !0 }));
+		}
+		function rt(e) {
+			if (X(e)) {
+				j.actionForTarget(e.target) && nt(e);
+				return;
+			}
+			if (e.target === k.value) {
+				if (e.key === "F2" && j.orderedEnabled().length > 0) {
+					e.preventDefault(), tt();
+					return;
+				}
+				O.handleItemKeydown($(), e);
+			}
+		}
+		return de(() => {
+			O.register($());
+		}), ue(() => {
+			O.unregister(F.value);
+		}), (i, o) => {
+			let s = he("STreeNode", !0);
+			return y(), f("li", {
+				id: Ue.value,
+				ref_key: "itemEl",
+				ref: k,
+				class: _(["s-tree-node-wrapper", {
+					"s-tree-node-wrapper--has-children": V.value,
+					"s-tree-node-wrapper--expanded": H.value,
+					"s-tree-node-wrapper--with-selection-rail": q.value,
+					"s-tree-node-wrapper--compact": x(O).density.value === "compact",
+					"s-tree-node-wrapper--overlay-actions": x(O).actionsLayout.value === "overlay",
+					"s-tree-node-wrapper--row-table": x(O).rowVariant.value === "table"
+				}]),
+				role: "treeitem",
+				tabindex: He.value ? 0 : -1,
+				"aria-level": T.level + 1,
+				"aria-posinset": T.position,
+				"aria-setsize": T.setSize,
+				"aria-expanded": V.value ? H.value : void 0,
+				"aria-selected": z.value.mode === "single" ? G.value : void 0,
+				"aria-checked": z.value.mode === "multiple" ? Je.value : void 0,
+				"aria-disabled": U.value || void 0,
+				onFocus: o[4] ||= (e) => x(O).activeKey.value = F.value,
+				onClick: Qe,
+				onKeydown: rt
+			}, [p("div", be, [p("div", {
+				class: _(["s-tree-node-row px-4 flex items-center", {
+					"s-tree-node-row--with-selection-rail": q.value,
+					"s-tree-node-row--rail-selected": q.value && G.value,
+					"s-tree-node-row--rail-partial": q.value && K.value
+				}]),
+				style: le({ paddingLeft: q.value ? void 0 : We.value })
+			}, [q.value ? (y(), f("div", xe, [m(ne, {
+				appearance: "ghost",
+				size: "sm",
+				"icon-only": "",
+				"leading-icon": G.value ? x(e) : K.value ? x(r) : void 0,
+				"data-tree-selection-control": "",
+				"data-state": G.value ? "selected" : K.value ? "partial" : "unselected",
+				"aria-label": Ke.value,
+				pressed: qe.value,
+				disabled: W.value,
+				tabindex: "-1",
+				onPointerdown: o[0] ||= C(() => {}, ["prevent"]),
+				onClick: C(et, ["stop"])
+			}, null, 8, [
+				"leading-icon",
+				"data-state",
+				"aria-label",
+				"pressed",
+				"disabled"
+			])])) : d("", !0), p("div", {
+				class: _(["s-tree-node-content-shell", {
+					"s-tree-node-content-shell--has-children": V.value,
+					"s-tree-node-content-shell--expanded": H.value
+				}]),
+				style: le({ paddingLeft: q.value ? We.value : void 0 })
+			}, [
+				x(O).expandControl.value === "button" ? (y(), f("div", {
+					key: 0,
+					class: _(["s-tree-node-toggle-slot shrink-0", {
+						"s-tree-node-toggle-slot--has-children": V.value,
+						"s-tree-node-toggle-slot--expanded": H.value
+					}])
+				}, [V.value ? (y(), u(ne, {
+					key: 0,
+					appearance: "ghost",
+					size: "xs",
+					"icon-only": "",
+					"leading-icon": H.value ? x(t) : x(n),
+					"aria-label": Ge.value,
+					tabindex: "-1",
+					onPointerdown: o[1] ||= C(() => {}, ["prevent"]),
+					onClick: C($e, ["stop"])
+				}, null, 8, ["leading-icon", "aria-label"])) : d("", !0)], 2)) : d("", !0),
+				z.value.mode === "multiple" && !q.value ? (y(), u(ie, {
+					key: 1,
+					"model-value": G.value,
+					indeterminate: K.value,
+					disabled: W.value,
+					"aria-label": Ke.value,
+					tabindex: "-1",
+					onPointerdown: o[2] ||= C(() => {}, ["prevent"]),
+					onClick: o[3] ||= C(() => {}, ["stop"]),
+					"onUpdate:modelValue": et
+				}, null, 8, [
+					"model-value",
+					"indeterminate",
+					"disabled",
+					"aria-label"
+				])) : d("", !0),
+				Ve.value ? (y(), f(c, { key: 2 }, [p("div", {
+					class: _(["s-tree-node s-tree-node__layout w-full cursor-pointer flex-grow", {
+						"s-tree-node--selected": G.value && z.value.mode === "single",
+						"s-tree-node--rail-selected": q.value && G.value,
+						"s-tree-node--rail-partial": q.value && K.value,
+						"s-tree-node--row-expand": x(O).expandControl.value === "row" && V.value,
+						"s-tree-node--disabled": U.value
+					}]),
+					role: "presentation"
+				}, [
+					p("div", Se, [m(x(a), { contract: M }, {
+						default: S(() => [b(i.$slots, "col-left", v(h(Q.value)), () => [p("div", Ce, [R.value ? (y(), u(ge(R.value), {
+							key: 0,
+							class: "s-tree-node__icon"
+						})) : d("", !0), p("span", { class: _(["s-tree-node__title", { "text-primary-800 dark:text-primary-200": G.value }]) }, _e(I.value), 3)])])]),
+						_: 3
+					})]),
+					p("div", we, [m(x(a), { contract: M }, {
+						default: S(() => [b(i.$slots, "col-center", v(h(Q.value)))]),
+						_: 3
+					})]),
+					p("div", Te, [p("div", Ee, [m(x(a), { contract: M }, {
+						default: S(() => [b(i.$slots, "meta", v(h(Q.value)))]),
+						_: 3
+					})])])
+				], 2), Be.value ? (y(), u(x(N), {
+					key: 0,
+					context: x(j),
+					"set-element": P,
+					class: _(["s-tree-node-actions s-tree-node-actions--standalone", { "s-tree-node-actions--has-persistent": !!i.$slots["persistent-actions"] }]),
+					role: "group",
+					"aria-label": `Действия: ${I.value}. F2 — войти, Escape — вернуться`
+				}, {
+					default: S(() => [i.$slots["persistent-actions"] ? (y(), f("div", De, [b(i.$slots, "persistent-actions", v(h(Q.value)))])) : d("", !0), i.$slots.actions ? (y(), f("div", Oe, [b(i.$slots, "actions", v(h(Q.value)))])) : d("", !0)]),
+					_: 3
+				}, 8, [
+					"context",
+					"class",
+					"aria-label"
+				])) : d("", !0)], 64)) : (y(), f("div", ke, [
+					p("div", Ae, [m(x(a), { contract: M }, {
+						default: S(() => [b(i.$slots, "col-left", v(h(Q.value)), () => [p("div", je, [R.value ? (y(), u(ge(R.value), {
+							key: 0,
+							class: "s-tree-node__icon"
+						})) : d("", !0), p("span", Me, _e(I.value), 1)])])]),
+						_: 3
+					})]),
+					p("div", Ne, [m(x(a), { contract: M }, {
+						default: S(() => [b(i.$slots, "col-center", v(h(Q.value)))]),
+						_: 3
+					})]),
+					p("div", Pe, [p("div", Fe, [m(x(a), { contract: M }, {
+						default: S(() => [b(i.$slots, "meta", v(h(Q.value)))]),
+						_: 3
+					})]), Be.value ? (y(), u(x(N), {
+						key: 0,
+						context: x(j),
+						"set-element": P,
+						class: _(["s-tree-node-actions", { "s-tree-node-actions--has-persistent": !!i.$slots["persistent-actions"] }]),
+						role: "group",
+						"aria-label": `Действия: ${I.value}. F2 — войти, Escape — вернуться`
+					}, {
+						default: S(() => [i.$slots["persistent-actions"] ? (y(), f("div", Ie, [b(i.$slots, "persistent-actions", v(h(Q.value)))])) : d("", !0), i.$slots.actions ? (y(), f("div", Le, [b(i.$slots, "actions", v(h(Q.value)))])) : d("", !0)]),
+						_: 3
+					}, 8, [
+						"context",
+						"class",
+						"aria-label"
+					])) : d("", !0)])
+				]))
+			], 6)], 6)]), H.value && V.value ? (y(), f("ul", Re, [(y(!0), f(c, null, me(L.value, (e, t) => (y(), u(s, {
+				key: x(O).model.key(e),
+				node: e,
+				level: T.level + 1,
+				"parent-key": F.value,
+				position: t + 1,
+				"set-size": L.value.length
+			}, ae({ _: 2 }, [
+				i.$slots["col-left"] ? {
+					name: "col-left",
+					fn: S((e) => [b(i.$slots, "col-left", g({ ref_for: !0 }, e))]),
+					key: "0"
+				} : void 0,
+				i.$slots["col-center"] ? {
+					name: "col-center",
+					fn: S((e) => [b(i.$slots, "col-center", g({ ref_for: !0 }, e))]),
+					key: "1"
+				} : void 0,
+				i.$slots.meta ? {
+					name: "meta",
+					fn: S((e) => [b(i.$slots, "meta", g({ ref_for: !0 }, e))]),
+					key: "2"
+				} : void 0,
+				i.$slots["persistent-actions"] ? {
+					name: "persistent-actions",
+					fn: S((e) => [b(i.$slots, "persistent-actions", g({ ref_for: !0 }, e))]),
+					key: "3"
+				} : void 0,
+				i.$slots.actions ? {
+					name: "actions",
+					fn: S((e) => [b(i.$slots, "actions", g({ ref_for: !0 }, e))]),
+					key: "4"
+				} : void 0
+			]), 1032, [
+				"node",
+				"level",
+				"parent-key",
+				"position",
+				"set-size"
+			]))), 128))])) : d("", !0)], 42, ye);
+		};
+	}
+});
+//#endregion
+export { w as default };

package/dist/src/components/shared/_internal/dialogSurface.d.ts

@@ -0,0 +1,29 @@
+export type DialogSurfaceModalSize = 'sm' | 'md' | 'lg' | 'xl' | '2xl' | '3xl' | 'wide' | 'full';
+export type DialogSurfaceDrawerSize = 'sm' | 'md' | 'lg';
+export type DialogSurfaceDrawerPlacement = 'right' | 'bottom';
+export type DialogSurfaceTone = 'default' | 'subtle';
+export type DialogSurfaceScrollBehavior = 'page' | 'body';
+export interface ModalDialogSurfacePresentation {
+    kind: 'modal';
+    size: DialogSurfaceModalSize;
+    fullscreen: boolean;
+    surface: DialogSurfaceTone;
+    scrollBehavior: DialogSurfaceScrollBehavior;
+}
+export interface DrawerDialogSurfacePresentation {
+    kind: 'drawer';
+    size: DialogSurfaceDrawerSize;
+    placement: DialogSurfaceDrawerPlacement;
+    mobileFullScreen: boolean;
+}
+export type DialogSurfacePresentation = ModalDialogSurfacePresentation | DrawerDialogSurfacePresentation;
+export type DialogSurfaceContractErrorCode = 'invalid-presentation' | 'invalid-size' | 'invalid-surface' | 'invalid-scroll-behavior';
+export declare class DialogSurfaceContractError extends Error {
+    readonly code: DialogSurfaceContractErrorCode;
+    constructor(code: DialogSurfaceContractErrorCode, message: string);
+}
+/**
+ * Проверяет закрытый discriminated contract приватной dialog surface без fallback-веток.
+ * Validates the private dialog surface discriminated contract without fallback branches.
+ */
+export declare function assertDialogSurfacePresentation(presentation: DialogSurfacePresentation): asserts presentation is DialogSurfacePresentation;

package/dist/src/components/shared/_internal/dialogSurface.js

@@ -0,0 +1,52 @@
+//#region src/components/shared/_internal/dialogSurface.ts
+var e = class extends Error {
+	constructor(e, t) {
+		super(t), this.name = "DialogSurfaceContractError", this.code = e;
+	}
+}, t = /* @__PURE__ */ new Set([
+	"kind",
+	"size",
+	"fullscreen",
+	"surface",
+	"scrollBehavior"
+]), n = /* @__PURE__ */ new Set([
+	"kind",
+	"size",
+	"placement",
+	"mobileFullScreen"
+]), r = /* @__PURE__ */ new Set([
+	"sm",
+	"md",
+	"lg",
+	"xl",
+	"2xl",
+	"3xl",
+	"wide",
+	"full"
+]), i = /* @__PURE__ */ new Set([
+	"sm",
+	"md",
+	"lg"
+]), a = /* @__PURE__ */ new Set(["right", "bottom"]), o = /* @__PURE__ */ new Set(["default", "subtle"]), s = /* @__PURE__ */ new Set(["page", "body"]), c = (t, n, r) => {
+	let i = Object.keys(t).find((e) => !r.has(e));
+	if (i) throw new e("invalid-presentation", `SDialogSurface presentation kind="${n}" содержит недопустимое поле ${i}`);
+};
+function l(l) {
+	let u = l;
+	if (u.kind === "modal") {
+		if (c(u, "modal", t), !r.has(u.size)) throw new e("invalid-size", `Недопустимый размер SModal: ${String(u.size)}`);
+		if (typeof u.fullscreen != "boolean") throw new e("invalid-presentation", "SModal presentation требует boolean fullscreen");
+		if (!o.has(u.surface)) throw new e("invalid-surface", `Недопустимая поверхность SModal: ${String(u.surface)}`);
+		if (!s.has(u.scrollBehavior)) throw new e("invalid-scroll-behavior", `Недопустимый scroll behavior SModal: ${String(u.scrollBehavior)}`);
+		return;
+	}
+	if (u.kind === "drawer") {
+		if (c(u, "drawer", n), !i.has(u.size)) throw new e("invalid-size", `Недопустимый размер SDrawer: ${String(u.size)}`);
+		if (!a.has(u.placement)) throw new e("invalid-presentation", `Недопустимое размещение SDrawer: ${String(u.placement)}`);
+		if (typeof u.mobileFullScreen != "boolean") throw new e("invalid-presentation", "SDrawer presentation требует boolean mobileFullScreen");
+		return;
+	}
+	throw new e("invalid-presentation", `Неизвестный kind SDialogSurface: ${String(u.kind)}`);
+}
+//#endregion
+export { e as DialogSurfaceContractError, l as assertDialogSurfacePresentation };

package/dist/src/components/shared/_internal/focusTrap.d.ts

@@ -0,0 +1,2 @@
+import { Ref } from 'vue';
+export declare function trapFocusInsidePanel(event: KeyboardEvent, panelRef: Ref<HTMLElement | null>, isOpen: boolean): void;

package/dist/src/components/shared/_internal/focusTrap.js

@@ -0,0 +1,20 @@
+import { getFocusableElements as e } from "../../../internal/focusNavigation.js";
+//#region src/components/shared/_internal/focusTrap.ts
+function t(t, n, r) {
+	if (t.key !== "Tab" || !r) return;
+	let i = n.value;
+	if (!i) return;
+	let a = e(i, { requireLayout: !0 });
+	if (a.length === 0) {
+		t.preventDefault(), i.focus();
+		return;
+	}
+	let o = a[0], s = a[a.length - 1], c = document.activeElement, l = c === i || !i.contains(c);
+	if (t.shiftKey) {
+		(c === o || l) && (t.preventDefault(), s?.focus());
+		return;
+	}
+	(c === s || l) && (t.preventDefault(), o?.focus());
+}
+//#endregion
+export { t as trapFocusInsidePanel };

package/dist/src/components/shared/_internal/listboxContext.d.ts

@@ -0,0 +1,13 @@
+import { InjectionKey } from 'vue';
+export interface ListboxOptionRegistration {
+    token: string;
+    element: HTMLElement;
+    activate: () => void;
+    disabled: () => boolean;
+    label: () => string;
+    selected: () => boolean;
+}
+export interface ListboxContext {
+    register: (registration: ListboxOptionRegistration) => () => void;
+}
+export declare const listboxContextKey: InjectionKey<ListboxContext>;

package/dist/src/components/shared/_internal/listboxContext.js

@@ -0,0 +1,4 @@
+//#region src/components/shared/_internal/listboxContext.ts
+var e = Symbol("s-listbox-context");
+//#endregion
+export { e as listboxContextKey };

package/dist/src/components/shared/_internal/markerContract.d.ts

@@ -0,0 +1,12 @@
+export declare const S_MARKER_TONES: readonly ["surface", "primary", "success", "blue", "sky", "indigo", "emerald", "green", "teal", "amber", "orange", "rose", "pink", "fuchsia", "cyan", "lime"];
+export type SMarkerTone = typeof S_MARKER_TONES[number];
+export type SMarker = {
+    tone: SMarkerTone;
+} | {
+    tone: 'custom';
+    color: `#${string}`;
+};
+export type SCustomMarker = Extract<SMarker, {
+    tone: 'custom';
+}>;
+export declare function createCustomMarker(color: string): SCustomMarker;

package/dist/src/components/shared/_internal/markerContract.js

@@ -0,0 +1,28 @@
+//#region src/components/shared/_internal/markerContract.ts
+var e = [
+	"surface",
+	"primary",
+	"success",
+	"blue",
+	"sky",
+	"indigo",
+	"emerald",
+	"green",
+	"teal",
+	"amber",
+	"orange",
+	"rose",
+	"pink",
+	"fuchsia",
+	"cyan",
+	"lime"
+];
+function t(e) {
+	if (!/^#[\da-f]{6}$/iu.test(e)) throw Error("SMarker: custom color must be a six-digit hex value");
+	return {
+		tone: "custom",
+		color: e
+	};
+}
+//#endregion
+export { e as S_MARKER_TONES, t as createCustomMarker };

package/dist/src/components/shared/_internal/menuContext.d.ts

@@ -0,0 +1,19 @@
+import { InjectionKey, Ref } from 'vue';
+export type MenuDensity = 'compact' | 'comfortable';
+export interface MenuItemRegistration {
+    readonly entryId: string;
+    readonly label: () => string;
+    readonly hasSubmenu: () => boolean;
+    readonly element: () => HTMLElement;
+    readonly setTabStop: (active: boolean) => void;
+    readonly focus: () => void;
+    readonly isFocused: () => boolean;
+    readonly ownsEventTarget: (target: EventTarget | null) => boolean;
+    readonly activate: (event: KeyboardEvent) => void;
+}
+export interface MenuContext {
+    density: Readonly<Ref<MenuDensity>>;
+    register: (registration: MenuItemRegistration) => () => void;
+}
+export declare const menuContextKey: InjectionKey<MenuContext>;
+export declare const menuDepthKey: InjectionKey<number>;

package/dist/src/components/shared/_internal/menuContext.js

@@ -0,0 +1,4 @@
+//#region src/components/shared/_internal/menuContext.ts
+var e = Symbol("s-menu-context"), t = Symbol("s-menu-depth");
+//#endregion
+export { e as menuContextKey, t as menuDepthKey };

package/dist/src/components/shared/_internal/selectionContract.d.ts

@@ -0,0 +1,53 @@
+import { SMarker } from './markerContract';
+import { SelectionKey } from './useSelectionRoving';
+/** Одна типизированная option общего selection owner. / One typed option of the shared selection owner. */
+export interface SelectionOption<TKey extends SelectionKey = SelectionKey> {
+    value: TKey;
+    label: string;
+    title?: string;
+    marker?: SMarker;
+    disabled?: boolean;
+}
+/** Группа options с собственной стабильной identity. / An option group with its own stable identity. */
+export interface SelectionOptionGroup<TKey extends SelectionKey = SelectionKey> {
+    groupId: string;
+    label: string;
+    options: readonly SelectionOption<TKey>[];
+}
+export type SelectionEntry<TKey extends SelectionKey = SelectionKey> = SelectionOption<TKey> | SelectionOptionGroup<TKey>;
+export type SelectionMode = 'single' | 'multiple';
+export type SelectionModelValue<TKey extends SelectionKey, TMode extends SelectionMode> = TMode extends 'multiple' ? readonly TKey[] : TKey | null;
+export interface ResolvedSelectionOption<TKey extends SelectionKey> {
+    option: SelectionOption<TKey>;
+    token: string;
+    coordinate: string;
+}
+export type ResolvedSelectionEntry<TKey extends SelectionKey> = {
+    kind: 'option';
+    record: ResolvedSelectionOption<TKey>;
+    token: string;
+} | {
+    kind: 'group';
+    groupId: string;
+    label: string;
+    records: readonly ResolvedSelectionOption<TKey>[];
+    token: string;
+};
+export interface ResolvedSelectionInventory<TKey extends SelectionKey> {
+    entries: readonly ResolvedSelectionEntry<TKey>[];
+    options: readonly ResolvedSelectionOption<TKey>[];
+    optionsByToken: ReadonlyMap<string, ResolvedSelectionOption<TKey>>;
+}
+/** Проверяет optional selection text без coercion. / Validates optional selection text without coercion. */
+export declare function validateOptionalSelectionString(owner: string, coordinate: string, value: unknown): string | undefined;
+/** Проверяет exact marker payload на selection boundary. / Validates an exact marker payload at a selection boundary. */
+export declare function validateSelectionMarker(owner: string, coordinate: string, marker: SMarker | undefined): SMarker | undefined;
+/**
+ * Проверяет весь inventory и возвращает новый типизированный контейнер без непроверенных полей.
+ * Validates the complete inventory and returns a new typed container without unchecked fields.
+ */
+export declare function resolveSelectionInventory<TKey extends SelectionKey>(owner: string, value: readonly SelectionEntry<TKey>[]): ResolvedSelectionInventory<TKey>;
+/** Проверяет controlled model относительно точного inventory. / Validates the controlled model against the exact inventory. */
+export declare function validateSelectionModel<TKey extends SelectionKey>(owner: string, mode: SelectionMode, modelValue: TKey | null | readonly TKey[] | undefined, inventory: ResolvedSelectionInventory<TKey>): ReadonlySet<string>;
+/** Narrowing helper for the exact multiple-selection model branch. */
+export declare function isSelectionModelList<TKey extends SelectionKey>(value: TKey | null | readonly TKey[]): value is readonly TKey[];