@pgcorp/ui-kit 0.10.0 → 0.10.1

package/dist/src/theme.d.ts

@@ -0,0 +1,119 @@
+import { UiKitTranslate } from './locales/locale';
+export declare const themeFamilies: readonly ["classic", "pink", "green"];
+export type ThemeFamily = (typeof themeFamilies)[number];
+export declare const themeModes: readonly ["light", "dark"];
+export type ThemeMode = (typeof themeModes)[number];
+export declare const themePreferences: readonly ["light", "dark", "pink-light", "pink-dark", "green-light", "green-dark"];
+export type ThemePreference = (typeof themePreferences)[number];
+export declare const themeIds: readonly ["classic-light", "classic-dark", "pink-light", "pink-dark", "green-light", "green-dark"];
+export type ThemeId = (typeof themeIds)[number];
+export interface StoredThemeState {
+    themeId: ThemeId;
+}
+export interface ThemeVariant {
+    id: ThemeId;
+    family: ThemeFamily;
+    mode: ThemeMode;
+    dataTheme: ThemePreference;
+    browserThemeColor: string;
+    statusBarStyle: 'default' | 'black-translucent';
+    label: string;
+    familyLabel: string;
+    modeLabel: string;
+}
+export declare const defaultThemeId: ThemeId;
+export declare const themeVariants: readonly [{
+    readonly label: string;
+    readonly familyLabel: string;
+    readonly modeLabel: string;
+    readonly id: "classic-light";
+    readonly family: "classic";
+    readonly mode: "light";
+    readonly dataTheme: "light";
+    readonly browserThemeColor: "#f8fafc";
+    readonly statusBarStyle: "default";
+}, {
+    readonly label: string;
+    readonly familyLabel: string;
+    readonly modeLabel: string;
+    readonly id: "classic-dark";
+    readonly family: "classic";
+    readonly mode: "dark";
+    readonly dataTheme: "dark";
+    readonly browserThemeColor: "#020617";
+    readonly statusBarStyle: "black-translucent";
+}, {
+    readonly label: string;
+    readonly familyLabel: string;
+    readonly modeLabel: string;
+    readonly id: "pink-light";
+    readonly family: "pink";
+    readonly mode: "light";
+    readonly dataTheme: "pink-light";
+    readonly browserThemeColor: "#fff6fb";
+    readonly statusBarStyle: "default";
+}, {
+    readonly label: string;
+    readonly familyLabel: string;
+    readonly modeLabel: string;
+    readonly id: "pink-dark";
+    readonly family: "pink";
+    readonly mode: "dark";
+    readonly dataTheme: "pink-dark";
+    readonly browserThemeColor: "#020617";
+    readonly statusBarStyle: "black-translucent";
+}, {
+    readonly label: string;
+    readonly familyLabel: string;
+    readonly modeLabel: string;
+    readonly id: "green-light";
+    readonly family: "green";
+    readonly mode: "light";
+    readonly dataTheme: "green-light";
+    readonly browserThemeColor: "#f5fbf6";
+    readonly statusBarStyle: "default";
+}, {
+    readonly label: string;
+    readonly familyLabel: string;
+    readonly modeLabel: string;
+    readonly id: "green-dark";
+    readonly family: "green";
+    readonly mode: "dark";
+    readonly dataTheme: "green-dark";
+    readonly browserThemeColor: "#04120b";
+    readonly statusBarStyle: "black-translucent";
+}];
+/** Имена browser meta, принадлежащих theme document owner. / Browser meta names owned by the theme document contract. */
+export declare const documentThemeMetaNames: Readonly<{
+    themeColor: "theme-color";
+    appleStatusBar: "apple-mobile-web-app-status-bar-style";
+}>;
+export declare function isThemeFamily(value: unknown): value is ThemeFamily;
+export declare function isThemeMode(value: unknown): value is ThemeMode;
+export declare function isThemePreference(value: unknown): value is ThemePreference;
+export declare function isThemeId(value: unknown): value is ThemeId;
+export declare function getThemeVariant(themeId: ThemeId): ThemeVariant;
+/**
+ * Атомарно применяет canonical theme variant к class, data-theme и browser meta одного документа.
+ * Atomically applies a canonical theme variant to one document's class, data-theme, and browser meta contract.
+ */
+export declare function applyThemeVariantToDocument(targetDocument: Document, candidate: ThemeVariant): void;
+/**
+ * Применяет зарегистрированный ThemeId через единственного document owner.
+ * Applies a registered ThemeId through the single document owner.
+ */
+export declare function applyThemeIdToDocument(targetDocument: Document, themeId: ThemeId): void;
+/**
+ * Временно применяет canonical тему и возвращает идемпотентное точное восстановление document state.
+ * Temporarily applies a canonical theme and returns an idempotent exact document-state restore.
+ */
+export declare function applyScopedThemeIdToDocument(targetDocument: Document, themeId: ThemeId): () => void;
+export declare function getThemeVariantsForFamily(family: ThemeFamily): ThemeVariant[];
+export declare function getThemeModesForFamily(family: ThemeFamily): ThemeMode[];
+export declare function resolveThemeId(family: ThemeFamily, mode: ThemeMode): ThemeId | null;
+export declare function resolveThemePreference(themeId: ThemeId): ThemePreference;
+export declare function getThemeFamilyLabel(family: ThemeFamily, translate?: UiKitTranslate): string;
+export declare function getThemeModeLabel(mode: ThemeMode, translate?: UiKitTranslate): string;
+/** Returns a locale-scoped display label without coupling theme state to one application locale. */
+export declare function getThemeVariantLabel(themeId: ThemeId, translate?: UiKitTranslate): string;
+export declare function resolveLegacyThemeId(value: unknown): ThemeId | null;

package/dist/src/theme.js

@@ -0,0 +1,253 @@
+import { UI_KIT_MESSAGES as e, createUiKitTranslate as t } from "./locales/messages.js";
+//#region src/theme.ts
+var n = [
+	"classic",
+	"pink",
+	"green"
+], r = ["light", "dark"], i = [
+	"light",
+	"dark",
+	"pink-light",
+	"pink-dark",
+	"green-light",
+	"green-dark"
+], a = [
+	"classic-light",
+	"classic-dark",
+	"pink-light",
+	"pink-dark",
+	"green-light",
+	"green-dark"
+], o = "classic-light", s = t(() => e.ru);
+function c(e) {
+	if (e === "classic") return "theme.classic";
+	if (e === "pink") return "theme.pink";
+	if (e === "green") return "theme.green";
+	throw Error(`Неизвестное семейство темы: ${String(e)}`);
+}
+function l(e) {
+	if (e === "light") return "theme.light";
+	if (e === "dark") return "theme.dark";
+	throw Error(`Неизвестный режим темы: ${String(e)}`);
+}
+function u(e, t, n) {
+	let r = n(c(e));
+	return {
+		familyLabel: r,
+		modeLabel: n(l(t)),
+		label: n(t === "light" ? "theme.variantLight" : "theme.variantDark", { family: r })
+	};
+}
+var d = [
+	{
+		id: "classic-light",
+		family: "classic",
+		mode: "light",
+		dataTheme: "light",
+		browserThemeColor: "#f8fafc",
+		statusBarStyle: "default",
+		...u("classic", "light", s)
+	},
+	{
+		id: "classic-dark",
+		family: "classic",
+		mode: "dark",
+		dataTheme: "dark",
+		browserThemeColor: "#020617",
+		statusBarStyle: "black-translucent",
+		...u("classic", "dark", s)
+	},
+	{
+		id: "pink-light",
+		family: "pink",
+		mode: "light",
+		dataTheme: "pink-light",
+		browserThemeColor: "#fff6fb",
+		statusBarStyle: "default",
+		...u("pink", "light", s)
+	},
+	{
+		id: "pink-dark",
+		family: "pink",
+		mode: "dark",
+		dataTheme: "pink-dark",
+		browserThemeColor: "#020617",
+		statusBarStyle: "black-translucent",
+		...u("pink", "dark", s)
+	},
+	{
+		id: "green-light",
+		family: "green",
+		mode: "light",
+		dataTheme: "green-light",
+		browserThemeColor: "#f5fbf6",
+		statusBarStyle: "default",
+		...u("green", "light", s)
+	},
+	{
+		id: "green-dark",
+		family: "green",
+		mode: "dark",
+		dataTheme: "green-dark",
+		browserThemeColor: "#04120b",
+		statusBarStyle: "black-translucent",
+		...u("green", "dark", s)
+	}
+], f = new Map(d.map((e) => [e.id, e])), p = new Set(n), m = new Set(r), h = new Set(i), g = new Set(a), _ = "theme-color", v = "apple-mobile-web-app-status-bar-style", y = Object.freeze({
+	themeColor: _,
+	appleStatusBar: v
+});
+function b(e) {
+	return typeof e == "string" && p.has(e);
+}
+function x(e) {
+	return typeof e == "string" && m.has(e);
+}
+function S(e) {
+	return typeof e == "string" && h.has(e);
+}
+function C(e) {
+	return typeof e == "string" && g.has(e);
+}
+function w(e) {
+	let t = f.get(e);
+	if (t === void 0) throw Error(`Неизвестный идентификатор темы: ${e}`);
+	return t;
+}
+function T(e) {
+	let t = w(e.id), n = [
+		"family",
+		"mode",
+		"dataTheme",
+		"browserThemeColor",
+		"statusBarStyle",
+		"label",
+		"familyLabel",
+		"modeLabel"
+	].filter((n) => e[n] !== t[n]);
+	if (n.length > 0) throw Error(`Theme variant "${e.id}" не совпадает с canonical theme registry: ${n.join(", ")}. Theme variant "${e.id}" does not match the canonical theme registry: ${n.join(", ")}.`);
+	return t;
+}
+function E(e, t) {
+	let n = [...e.head.querySelectorAll(`meta[name="${t}"]`)];
+	if (n.length > 1) throw Error(`UI-kit theme document: для "${t}" найдено ${n.length} meta; ожидается не более одного owner. UI-kit theme document: found ${n.length} meta elements for "${t}"; at most one owner is allowed.`);
+	let r = n[0];
+	if (r === void 0) return null;
+	if (r.tagName !== "META") throw TypeError(`UI-kit theme document: meta owner "${t}" имеет неверный DOM type.`);
+	return r;
+}
+function D(e, t) {
+	let n = e.createElement("meta");
+	return n.name = t, n.dataset.sUiKitThemeMeta = "true", e.head.appendChild(n), n;
+}
+var O = /* @__PURE__ */ new WeakMap();
+function k(e, t) {
+	let n = E(e, t);
+	return {
+		element: n,
+		content: n === null ? null : n.getAttribute("content")
+	};
+}
+function A(e) {
+	let t = e.documentElement.classList.contains("dark"), n = e.documentElement.getAttribute("data-theme");
+	if (n === null && t) throw Error("UI-kit theme scope: class=\"dark\" требует canonical data-theme.");
+	if (n !== null) {
+		if (!S(n)) throw TypeError(`UI-kit theme scope: неизвестный data-theme "${n}".`);
+		let e = d.find((e) => e.dataTheme === n);
+		if (e === void 0 || e.mode === "dark" !== t) throw Error(`UI-kit theme scope: data-theme="${n}" конфликтует с class="dark".`);
+	}
+	return {
+		hadDarkClass: t,
+		dataTheme: n,
+		themeColor: k(e, _),
+		appleStatusBar: k(e, v)
+	};
+}
+function j(e, t, n, r) {
+	let i = E(e, t);
+	if (i !== (n.element === null ? r : n.element)) throw Error(`UI-kit theme scope: meta owner "${t}" был заменён до восстановления.`);
+	if (n.element === null && i.dataset.sUiKitThemeMeta !== "true") throw Error(`UI-kit theme scope: meta owner "${t}" изменён вне canonical scope.`);
+}
+function M(e, t) {
+	if (e.element === null) {
+		t.remove();
+		return;
+	}
+	e.content === null ? e.element.removeAttribute("content") : e.element.content = e.content;
+}
+function N(e) {
+	let t = e.layers[e.layers.length - 1];
+	if (t === void 0) throw Error("UI-kit theme scope: runtime не содержит активного owner.");
+	return t;
+}
+function P(e, t) {
+	let n = w(N(t).themeId), r = e.documentElement;
+	if (r.getAttribute("data-theme") !== n.dataTheme || r.classList.contains("dark") !== (n.mode === "dark")) throw Error(`UI-kit theme scope: active owner ${JSON.stringify(n.id)} был изменён вне canonical scope.`);
+	if (j(e, _, t.snapshot.themeColor, t.themeColor), j(e, v, t.snapshot.appleStatusBar, t.appleStatusBar), t.themeColor.content !== n.browserThemeColor || t.appleStatusBar.content !== n.statusBarStyle) throw Error(`UI-kit theme scope: browser meta active owner ${JSON.stringify(n.id)} изменены вне canonical scope.`);
+}
+function F(e, t) {
+	let n = t.snapshot;
+	e.documentElement.classList.toggle("dark", n.hadDarkClass), n.dataTheme === null ? e.documentElement.removeAttribute("data-theme") : e.documentElement.setAttribute("data-theme", n.dataTheme), M(n.themeColor, t.themeColor), M(n.appleStatusBar, t.appleStatusBar), O.delete(e);
+}
+function I(e, t) {
+	let n = T(t), r = E(e, _), i = E(e, v), a = r === null ? D(e, _) : r, o = i === null ? D(e, v) : i;
+	e.documentElement.classList.toggle("dark", n.mode === "dark"), e.documentElement.dataset.theme = n.dataTheme, a.content = n.browserThemeColor, o.content = n.statusBarStyle;
+}
+function L(e, t) {
+	I(e, w(t));
+}
+function R(e, t) {
+	let n = w(t), r = O.get(e);
+	r !== void 0 && P(e, r);
+	let i = r === void 0 ? A(e) : r.snapshot;
+	L(e, t);
+	let a = E(e, _), o = E(e, v);
+	if (a === null || o === null) throw Error("UI-kit theme scope: canonical applier не создал обязательные browser meta owners.");
+	if (r === void 0) r = {
+		snapshot: i,
+		themeColor: a,
+		appleStatusBar: o,
+		layers: []
+	}, O.set(e, r);
+	else if (r.themeColor !== a || r.appleStatusBar !== o) throw Error("UI-kit theme scope: canonical browser meta owners были заменены при apply.");
+	let s = { themeId: n.id };
+	r.layers.push(s);
+	let c = !0;
+	return () => {
+		if (!c) return;
+		let t = O.get(e);
+		if (t !== r) throw Error("UI-kit theme scope: per-document runtime был заменён до cleanup.");
+		P(e, t);
+		let n = t.layers.indexOf(s);
+		if (n < 0) throw Error("UI-kit theme scope: active owner отсутствует в per-document runtime.");
+		t.layers.splice(n, 1), t.layers.length === 0 ? F(e, t) : L(e, N(t).themeId), c = !1;
+	};
+}
+function z(e) {
+	return d.filter((t) => t.family === e);
+}
+function B(e) {
+	return z(e).map((e) => e.mode);
+}
+function V(e, t) {
+	let n = d.find((n) => n.family === e && n.mode === t);
+	return n === void 0 ? null : n.id;
+}
+function H(e) {
+	return w(e).dataTheme;
+}
+function U(e, t = s) {
+	return t(c(e));
+}
+function W(e, t = s) {
+	return t(l(e));
+}
+function G(e, t = s) {
+	let n = w(e);
+	return u(n.family, n.mode, t).label;
+}
+function K(e) {
+	return e === "light" ? "classic-light" : e === "dark" ? "classic-dark" : e === "pink-dark" ? "pink-dark" : null;
+}
+//#endregion
+export { R as applyScopedThemeIdToDocument, L as applyThemeIdToDocument, I as applyThemeVariantToDocument, o as defaultThemeId, y as documentThemeMetaNames, U as getThemeFamilyLabel, W as getThemeModeLabel, B as getThemeModesForFamily, w as getThemeVariant, G as getThemeVariantLabel, z as getThemeVariantsForFamily, b as isThemeFamily, C as isThemeId, x as isThemeMode, S as isThemePreference, K as resolveLegacyThemeId, V as resolveThemeId, H as resolveThemePreference, n as themeFamilies, a as themeIds, r as themeModes, i as themePreferences, d as themeVariants };

package/dist/src/variants.d.ts

@@ -0,0 +1,4 @@
+export declare const toneVariants: readonly ["primary", "secondary", "success", "info", "warn", "danger", "contrast", "neutral"];
+export type ToneVariant = (typeof toneVariants)[number];
+export declare const sizeVariants: readonly ["sm", "md", "lg"];
+export type SizeVariant = (typeof sizeVariants)[number];

package/dist/src/variants.js

@@ -0,0 +1,17 @@
+//#region src/variants.ts
+var e = [
+	"primary",
+	"secondary",
+	"success",
+	"info",
+	"warn",
+	"danger",
+	"contrast",
+	"neutral"
+], t = [
+	"sm",
+	"md",
+	"lg"
+];
+//#endregion
+export { t as sizeVariants, e as toneVariants };

package/dist/src/workers/diff.worker.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/workers/diffProtocol.d.ts

@@ -0,0 +1,39 @@
+import { SDiffComputationOptions, SDiffResult, SDiffSource } from '../components/shared/data-display/diff';
+export declare const S_DIFF_WORKER_PROTOCOL_VERSION: 1;
+export interface SDiffWorkerComputeRequest {
+    readonly version: typeof S_DIFF_WORKER_PROTOCOL_VERSION;
+    readonly type: 'compute';
+    readonly requestId: string;
+    readonly before: SDiffSource;
+    readonly after: SDiffSource;
+    readonly options: Required<SDiffComputationOptions>;
+}
+export interface SDiffWorkerCancelRequest {
+    readonly version: typeof S_DIFF_WORKER_PROTOCOL_VERSION;
+    readonly type: 'cancel';
+    readonly requestId: string;
+}
+export type SDiffWorkerRequest = SDiffWorkerComputeRequest | SDiffWorkerCancelRequest;
+export interface SDiffWorkerResultResponse {
+    readonly version: typeof S_DIFF_WORKER_PROTOCOL_VERSION;
+    readonly type: 'result';
+    readonly requestId: string;
+    readonly result: SDiffResult;
+}
+export interface SDiffWorkerCancelledResponse {
+    readonly version: typeof S_DIFF_WORKER_PROTOCOL_VERSION;
+    readonly type: 'cancelled';
+    readonly requestId: string;
+}
+export interface SDiffWorkerErrorResponse {
+    readonly version: typeof S_DIFF_WORKER_PROTOCOL_VERSION;
+    readonly type: 'error';
+    readonly requestId: string;
+    readonly error: {
+        readonly name: string;
+        readonly message: string;
+    };
+}
+export type SDiffWorkerResponse = SDiffWorkerResultResponse | SDiffWorkerCancelledResponse | SDiffWorkerErrorResponse;
+export declare function validateDiffWorkerRequest(value: unknown): SDiffWorkerRequest;
+export declare function validateDiffWorkerResponse(value: unknown): SDiffWorkerResponse;

package/dist/src/workers/diffProtocol.js

@@ -0,0 +1,66 @@
+import { validateExactString as e, validateNonEmptyString as t } from "../internal/runtimeContract.js";
+import { validateDiffResult as n } from "../components/shared/data-display/diff.js";
+var r = [
+	"result",
+	"cancelled",
+	"error"
+], i = /* @__PURE__ */ new Set([
+	"version",
+	"type",
+	"requestId",
+	"result"
+]), a = /* @__PURE__ */ new Set([
+	"version",
+	"type",
+	"requestId"
+]), o = /* @__PURE__ */ new Set([
+	"version",
+	"type",
+	"requestId",
+	"error"
+]), s = /* @__PURE__ */ new Set(["name", "message"]);
+function c(e, t, n, r) {
+	if (typeof n != "object" || !n || Array.isArray(n) || Object.getPrototypeOf(n) !== Object.prototype) throw TypeError(`${e}: ${t} must be a plain object.`);
+	let i = n, a = Object.keys(i).filter((e) => !r.has(e));
+	if (a.length > 0) throw TypeError(`${e}.${t}: unknown fields ${a.map((e) => JSON.stringify(e)).join(", ")}.`);
+	return i;
+}
+function l(e, t) {
+	if (t === 1) return t;
+	throw RangeError(`${e}: unsupported diff worker protocol version ${String(t)}.`);
+}
+function u(e, n) {
+	let r = t(e, "requestId", n);
+	if (r === r.trim()) return r;
+	throw TypeError(`${e}: requestId must not contain surrounding whitespace.`);
+}
+function d(d) {
+	let f = c("SDiffWorkerResponse", "message", d, /* @__PURE__ */ new Set([
+		...i,
+		...a,
+		...o
+	])), p = e("SDiffWorkerResponse", "type", f.type, r), m = c("SDiffWorkerResponse", "message", d, p === "result" ? i : p === "error" ? o : a), h = l("SDiffWorkerResponse", m.version), g = u("SDiffWorkerResponse", m.requestId);
+	if (p === "cancelled") return Object.freeze({
+		version: h,
+		type: p,
+		requestId: g
+	});
+	if (p === "result") return Object.freeze({
+		version: h,
+		type: p,
+		requestId: g,
+		result: n("SDiffWorkerResponse", m.result)
+	});
+	let _ = c("SDiffWorkerResponse", "error", m.error, s);
+	return Object.freeze({
+		version: h,
+		type: p,
+		requestId: g,
+		error: Object.freeze({
+			name: t("SDiffWorkerResponse", "error.name", _.name),
+			message: t("SDiffWorkerResponse", "error.message", _.message)
+		})
+	});
+}
+//#endregion
+export { d as validateDiffWorkerResponse };

package/docs/getting-started.md

@@ -5,16 +5,17 @@
 ### Установка
 
 ```bash
-npm install @pgcorp/ui-kit vue pinia vue-router
+npm install @pgcorp/ui-kit @vue/devtools-api vue pinia vue-router
 ```
 
-UI-kit поставляется как Vue 3 SFC/TypeScript package для Vite-based приложений.
-Consumer отвечает за единственные экземпляры `vue`, `pinia` и `vue-router`.
+UI-kit поставляется как собранные Vue 3 ESM-модули и declaration-файлы для
+Vite-based приложений. Consumer отвечает за единственные экземпляры `vue`,
+`pinia`, `@vue/devtools-api` и `vue-router`.
 
 ### Подключение
 
-UI-kit публикует source-SFC и использует Tailwind 4 utilities. Подключите Tailwind
-и package integration entrypoint в корневом CSS приложения:
+UI-kit публикует собранные component-модули и использует Tailwind 4 utilities.
+Подключите Tailwind и package integration entrypoint в корневом CSS приложения:
 
 ```css
 @import "tailwindcss";
@@ -147,17 +148,17 @@ monorepo и без копирования файлов UI-kit. TypeScript и Vue
 ### Installation
 
 ```bash
-npm install @pgcorp/ui-kit vue pinia vue-router
+npm install @pgcorp/ui-kit @vue/devtools-api vue pinia vue-router
 ```
 
-The UI kit is distributed as a Vue 3 SFC/TypeScript package for Vite-based
-applications. The consumer owns the single `vue`, `pinia`, and `vue-router`
-instances.
+The UI kit is distributed as built Vue 3 ESM modules and declaration files for
+Vite-based applications. The consumer owns the single `vue`, `pinia`,
+`@vue/devtools-api`, and `vue-router` instances.
 
 ### Setup
 
-The UI kit publishes source SFCs and uses Tailwind 4 utilities. Import Tailwind
-and the package integration entrypoint from the application's root CSS:
+The UI kit publishes built component modules and uses Tailwind 4 utilities.
+Import Tailwind and the package integration entrypoint from the application's root CSS:
 
 ```css
 @import "tailwindcss";

package/docs/public-api.md

@@ -22,10 +22,11 @@ methods. Внутренний DOM, CSS-классы и private modules не яв
 UI-kit-owned атрибуты `data-s-*` относятся к внутренней presentation boundary и
 не являются стабильными consumer selectors. Произвольные consumer-owned
 `data-*` остаются поддерживаемыми test/tour hooks canonical owner.
-Публичные source-SFC объявляют runtime props и events локально: consumer Vue
-compiler регистрирует их без межфайлового filesystem type resolver.
-Публикуемый production-source компилируется с `target/lib: ES2020`, совпадающим
-с baseline `@vue/tsconfig/tsconfig.dom.json`, и не требует скрытых полифиллов.
+Публичные component-subpaths разрешаются в собранные ESM-модули и declaration-
+файлы. Consumer type checker не компилирует внутренние SFC и не разрешает их
+runtime-зависимости через layout конкретного package manager. Сборка использует
+`target/lib: ES2020`, совпадающий с baseline `@vue/tsconfig/tsconfig.dom.json`,
+и не требует скрытых полифиллов.
 Типы таблицы импортируются из `shared/data-display/table`, типы графиков — из
 `shared/data-display/chart`, типы и чистая функция diff — из
 `shared/data-display/diff`. `SDiffViewer` принимает exact-text snapshots,
@@ -54,8 +55,13 @@ action/dismiss/lifetime intents, position и lifetime types. `SToastContainer`
 `SRichDocumentV1` AST. `shared/data-display/richDocument` экспортирует закрытую
 модель, consumer-owned resource records, typed intents и validators со stable
 error code/path. Link-node поддерживает `current: true` для
-`aria-current="page"`. Raw HTML, VNodes, callbacks и trust flags не входят в
-API.
+`aria-current="page"`; task lists, deletion, keyboard/sup/sub, disclosure и
+scoped footnotes выражаются отдельными serializable nodes. Raw HTML, VNodes,
+callbacks и trust flags не входят в API.
+`SButton.density="compact"` сохраняет semantic size hierarchy с hitbox
+`sm/md/lg = 32/36/40 px` и label typography `12/14/14 px`; тот же
+`density="compact"` у `SInputText` даёт совместимую геометрию поля без
+consumer CSS.
 `shared/data-display/SScrollViewport.vue` владеет accessible scroll region,
 разрешёнными осями, semantic block size, root-only keyboard navigation и
 ResizeObserver lifecycle. `shared/data-display/scrollViewport` экспортирует
@@ -84,10 +90,11 @@ methods. Internal DOM, CSS classes, and private modules are not API.
 UI-kit-owned `data-s-*` attributes belong to the internal presentation boundary
 and are not stable consumer selectors. Arbitrary consumer-owned `data-*`
 attributes remain supported test and tour hooks on the canonical owner.
-Public source SFCs declare runtime props and events locally, so the consumer Vue
-compiler registers them without a cross-file filesystem type resolver.
-Published production source compiles with the `target/lib: ES2020` baseline from
-`@vue/tsconfig/tsconfig.dom.json` and does not require implicit polyfills.
+Public component subpaths resolve to built ESM modules and declaration files.
+Consumer type checkers do not compile internal SFCs or resolve their runtime
+dependencies through a package-manager-specific layout. The build uses the
+`target/lib: ES2020` baseline from `@vue/tsconfig/tsconfig.dom.json` and does not
+require implicit polyfills.
 Table types are imported from `shared/data-display/table`; chart types are
 imported from `shared/data-display/chart`; diff types and its pure computation
 function are imported from `shared/data-display/diff`. `SDiffViewer` accepts
@@ -118,8 +125,13 @@ layout owner.
 only. `shared/data-display/richDocument` exports the closed model,
 consumer-owned resource records, typed intents, and validators with stable
 error code/path diagnostics. Link nodes support `current: true` for
-`aria-current="page"`. Raw HTML, VNodes, callbacks, and trust flags are not part
-of the API.
+`aria-current="page"`; task lists, deletion, keyboard/sup/sub, disclosure, and
+scoped footnotes use dedicated serializable nodes. Raw HTML, VNodes, callbacks,
+and trust flags are not part of the API.
+`SButton.density="compact"` keeps the semantic size hierarchy at
+`sm/md/lg = 32/36/40 px` with `12/14/14 px` label typography. The matching
+`SInputText.density="compact"` exposes the same field geometry without consumer
+CSS.
 `shared/data-display/SScrollViewport.vue` owns the accessible scroll region,
 enabled axes, semantic block size, root-only keyboard navigation, and
 ResizeObserver lifecycle. `shared/data-display/scrollViewport` exports

package/docs/rich-document.md

@@ -94,13 +94,29 @@ The closed model supports:
 
 - paragraph, heading, strong, emphasis, inline code и links с optional
   `current`-состоянием;
-- ordered/unordered lists, quote и divider;
+- deletion, `keyboard`, superscript и subscript inline semantics;
+- ordered/unordered и task lists с inert checked-state и обязательной доступной
+  меткой каждого task checkbox;
+- quote, divider и keyboard-operable `disclosure` с текстовым summary;
+- scoped footnote reference/definition/backlink, где DOM targets вычисляет
+  renderer, а payload передаёт только stable footnote ID;
 - code blocks с optional language, line numbers и label;
 - inline/block math;
 - semantic tables и callouts;
 - image/file resources по ID;
 - action groups с serializable action IDs.
 
+Внутренняя навигация сносок — единственный link-like эффект, которым владеет
+renderer: адреса reference и backlink вычисляются из валидированных ID и
+instance-scoped DOM-префикса. Обычные `link`-узлы остаются управляемыми
+intent-действиями. Task checkbox отображает readonly-состояние документа и не
+эмитит обновления.
+
+Internal footnote navigation is the only link-like effect owned by the renderer:
+reference and backlink URLs are derived from validated IDs and an
+instance-scoped DOM prefix. Ordinary `link` nodes remain controlled intents.
+Task checkboxes are read-only document state and do not emit updates.
+
 ```ts
 const document = {
   version: 1,