@pgcorp/ui-kit 0.9.0 → 0.10.1

package/dist/src/components/shared/data-display/diff.js

@@ -0,0 +1,266 @@
+import { validateBoundedInteger as e, validateExactString as t, validateNonEmptyString as n } from "../../../internal/runtimeContract.js";
+import { validateCodeEditorLanguage as r } from "../../../internal/codeEditorContract.js";
+import { computeDiffModel as i } from "../../../internal/diffEngine.js";
+//#region src/components/shared/data-display/diff.ts
+var a = 3, o = 100, s = /* @__PURE__ */ new Set([
+	"text",
+	"label",
+	"revision",
+	"language"
+]), c = /* @__PURE__ */ new Set(["contextLines"]), l = /* @__PURE__ */ new Set([
+	"before",
+	"after",
+	"lines",
+	"hunks",
+	"gaps",
+	"summary"
+]), u = /* @__PURE__ */ new Set([
+	"lineCount",
+	"label",
+	"revision",
+	"language"
+]), d = /* @__PURE__ */ new Set([
+	"id",
+	"kind",
+	"before",
+	"after"
+]), f = /* @__PURE__ */ new Set([
+	"lineNumber",
+	"text",
+	"lineBreak"
+]), p = /* @__PURE__ */ new Set([
+	"id",
+	"lineStart",
+	"lineEnd",
+	"beforeStart",
+	"beforeLineCount",
+	"afterStart",
+	"afterLineCount"
+]), m = /* @__PURE__ */ new Set([
+	"id",
+	"lineStart",
+	"lineEnd",
+	"beforeStart",
+	"afterStart",
+	"lineCount"
+]), h = /* @__PURE__ */ new Set([
+	"beforeLineCount",
+	"afterLineCount",
+	"unchangedLineCount",
+	"removedLineCount",
+	"addedLineCount",
+	"changedLineCount"
+]), g = [
+	"unchanged",
+	"removed",
+	"added"
+], _ = [
+	"lf",
+	"crlf",
+	"none"
+];
+function v(e, t, n, r) {
+	if (typeof n != "object" || !n || Array.isArray(n) || Object.getPrototypeOf(n) !== Object.prototype) throw TypeError(`${e}: ${t} должен быть plain object. / ${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}: неизвестные поля ${a.map((e) => JSON.stringify(e)).join(", ")}. / ${e}.${t}: unknown fields ${a.map((e) => JSON.stringify(e)).join(", ")}.`);
+	return i;
+}
+function y(e, t, r) {
+	let i = n(e, t, r);
+	if (i !== i.trim()) throw TypeError(`${e}: ${t} не должен содержать окружающие пробелы. / ${e}: ${t} must not contain surrounding whitespace.`);
+	return i;
+}
+function b(e, t, n) {
+	if (typeof n == "string") return y(e, t, n);
+	if (typeof n == "number" && Number.isSafeInteger(n) && n >= 0) return n;
+	throw TypeError(`${e}: ${t} должен быть непустой строкой или неотрицательным safe integer. / ${e}: ${t} must be a non-empty string or non-negative safe integer.`);
+}
+function x(e, t, n) {
+	let i = r(`${e}.${t}`, n);
+	return Object.freeze(i);
+}
+function S(e, t, r) {
+	let i = v(e, t, r, s);
+	if (typeof i.text != "string") throw TypeError(`${e}: ${t}.text должен быть string. / ${e}: ${t}.text must be a string.`);
+	return Object.freeze({
+		text: i.text,
+		...i.label === void 0 ? {} : { label: n(e, `${t}.label`, i.label) },
+		...i.revision === void 0 ? {} : { revision: b(e, `${t}.revision`, i.revision) },
+		...i.language === void 0 ? {} : { language: x(e, `${t}.language`, i.language) }
+	});
+}
+function C(t, n) {
+	let r = n === void 0 ? {} : v(t, "options", n, c);
+	return Object.freeze({ contextLines: e(t, "options.contextLines", r.contextLines ?? 3, {
+		minimum: 0,
+		maximum: 100
+	}) });
+}
+function w(t, r, i) {
+	let a = v(t, r, i, u);
+	return Object.freeze({
+		lineCount: e(t, `${r}.lineCount`, a.lineCount, {
+			minimum: 0,
+			maximum: 2 ** 53 - 1
+		}),
+		...a.label === void 0 ? {} : { label: n(t, `${r}.label`, a.label) },
+		...a.revision === void 0 ? {} : { revision: b(t, `${r}.revision`, a.revision) },
+		...a.language === void 0 ? {} : { language: x(t, `${r}.language`, a.language) }
+	});
+}
+function T(n, r, i, a) {
+	let o = v(n, r, i, f);
+	if (typeof o.text != "string") throw TypeError(`${n}: ${r}.text должен быть string. / ${n}: ${r}.text must be a string.`);
+	return Object.freeze({
+		lineNumber: e(n, `${r}.lineNumber`, o.lineNumber, {
+			minimum: 1,
+			maximum: a
+		}),
+		text: o.text,
+		lineBreak: t(n, `${r}.lineBreak`, o.lineBreak, _)
+	});
+}
+function E(e, n, r, i, a) {
+	let o = v(e, n, r, d), s = t(e, `${n}.kind`, o.kind, g), c = o.before === void 0 ? void 0 : T(e, `${n}.before`, o.before, i), l = o.after === void 0 ? void 0 : T(e, `${n}.after`, o.after, a);
+	if (s === "unchanged" && (c === void 0 || l === void 0)) throw TypeError(`${e}: ${n} unchanged line требует обе стороны. / unchanged line requires both sides.`);
+	if (s === "removed" && (c === void 0 || l !== void 0)) throw TypeError(`${e}: ${n} removed line требует только before. / removed line requires before only.`);
+	if (s === "added" && (c !== void 0 || l === void 0)) throw TypeError(`${e}: ${n} added line требует только after. / added line requires after only.`);
+	if (s === "unchanged" && c !== void 0 && l !== void 0 && (c.text !== l.text || c.lineBreak !== l.lineBreak)) throw TypeError(`${e}: ${n} unchanged line содержит разные стороны. / unchanged line contains different sides.`);
+	return Object.freeze({
+		id: y(e, `${n}.id`, o.id),
+		kind: s,
+		...c === void 0 ? {} : { before: c },
+		...l === void 0 ? {} : { after: l }
+	});
+}
+function D(t, n, r, i, a, o) {
+	let s = v(t, n, r, p), c = e(t, `${n}.lineStart`, s.lineStart, {
+		minimum: 0,
+		maximum: i
+	}), l = e(t, `${n}.lineEnd`, s.lineEnd, {
+		minimum: c + 1,
+		maximum: i
+	});
+	return Object.freeze({
+		id: y(t, `${n}.id`, s.id),
+		lineStart: c,
+		lineEnd: l,
+		beforeStart: e(t, `${n}.beforeStart`, s.beforeStart, {
+			minimum: 1,
+			maximum: a + 1
+		}),
+		beforeLineCount: e(t, `${n}.beforeLineCount`, s.beforeLineCount, {
+			minimum: 0,
+			maximum: a
+		}),
+		afterStart: e(t, `${n}.afterStart`, s.afterStart, {
+			minimum: 1,
+			maximum: o + 1
+		}),
+		afterLineCount: e(t, `${n}.afterLineCount`, s.afterLineCount, {
+			minimum: 0,
+			maximum: o
+		})
+	});
+}
+function O(t, n, r, i, a, o) {
+	let s = v(t, n, r, m), c = e(t, `${n}.lineStart`, s.lineStart, {
+		minimum: 0,
+		maximum: i
+	}), l = e(t, `${n}.lineEnd`, s.lineEnd, {
+		minimum: c + 1,
+		maximum: i
+	}), u = l - c;
+	return Object.freeze({
+		id: y(t, `${n}.id`, s.id),
+		lineStart: c,
+		lineEnd: l,
+		beforeStart: e(t, `${n}.beforeStart`, s.beforeStart, {
+			minimum: 1,
+			maximum: a
+		}),
+		afterStart: e(t, `${n}.afterStart`, s.afterStart, {
+			minimum: 1,
+			maximum: o
+		}),
+		lineCount: e(t, `${n}.lineCount`, s.lineCount, {
+			minimum: u,
+			maximum: u
+		})
+	});
+}
+function k(t, n) {
+	let r = v(t, "summary", n, h), i = (n) => e(t, `summary.${n}`, r[n], {
+		minimum: 0,
+		maximum: 2 ** 53 - 1
+	});
+	return Object.freeze({
+		beforeLineCount: i("beforeLineCount"),
+		afterLineCount: i("afterLineCount"),
+		unchangedLineCount: i("unchangedLineCount"),
+		removedLineCount: i("removedLineCount"),
+		addedLineCount: i("addedLineCount"),
+		changedLineCount: i("changedLineCount")
+	});
+}
+function A(e, t) {
+	let n = v(e, "result", t, l), r = w(e, "result.before", n.before), i = w(e, "result.after", n.after);
+	if (!Array.isArray(n.lines) || !Array.isArray(n.hunks) || !Array.isArray(n.gaps)) throw TypeError(`${e}: result lines/hunks/gaps должны быть arrays. / result lines/hunks/gaps must be arrays.`);
+	let a = n.lines.map((t, n) => E(e, `result.lines[${n}]`, t, r.lineCount, i.lineCount)), o = 1, s = 1, c = [], u = [], d = {
+		unchanged: 0,
+		removed: 0,
+		added: 0
+	};
+	for (let [t, n] of a.entries()) {
+		if (n.before !== void 0 && n.before.lineNumber !== o) throw RangeError(`${e}: result.lines[${t}].before.lineNumber нарушает последовательность.`);
+		if (n.after !== void 0 && n.after.lineNumber !== s) throw RangeError(`${e}: result.lines[${t}].after.lineNumber нарушает последовательность.`);
+		n.before !== void 0 && (c.push(n.before), o += 1), n.after !== void 0 && (u.push(n.after), s += 1), d[n.kind] += 1;
+	}
+	if (o - 1 !== r.lineCount || s - 1 !== i.lineCount) throw RangeError(`${e}: result line inventory не соответствует source snapshots.`);
+	for (let [t, n] of [["before", c], ["after", u]]) {
+		let r = n.findIndex((e, t) => t < n.length - 1 && e.lineBreak === "none");
+		if (r !== -1) throw RangeError(`${e}: result ${t} line ${r + 1} теряет межстрочный terminator.`);
+	}
+	let f = n.hunks.map((t, n) => D(e, `result.hunks[${n}]`, t, a.length, r.lineCount, i.lineCount)), p = n.gaps.map((t, n) => O(e, `result.gaps[${n}]`, t, a.length, r.lineCount, i.lineCount));
+	for (let [t, n] of f.entries()) if (!a.slice(n.lineStart, n.lineEnd).some((e) => e.kind !== "unchanged")) throw RangeError(`${e}: result.hunks[${t}] не содержит changed line.`);
+	for (let [t, n] of p.entries()) if (a.slice(n.lineStart, n.lineEnd).some((e) => e.kind !== "unchanged")) throw RangeError(`${e}: result.gaps[${t}] содержит changed line.`);
+	let m = /* @__PURE__ */ new Set();
+	for (let t of [...f, ...p]) {
+		if (m.has(t.id)) throw RangeError(`${e}: duplicate result segment id ${JSON.stringify(t.id)}.`);
+		m.add(t.id);
+	}
+	if (d.removed + d.added === 0) {
+		if (f.length !== 0 || p.length !== 0) throw RangeError(`${e}: unchanged result не должен содержать hunks/gaps.`);
+	} else {
+		let t = [...f.map((e) => ({
+			kind: "hunk",
+			value: e
+		})), ...p.map((e) => ({
+			kind: "gap",
+			value: e
+		}))].sort((e, t) => e.value.lineStart - t.value.lineStart), n = 0;
+		for (let r of t) {
+			if (r.value.lineStart !== n) throw RangeError(`${e}: result hunks/gaps не образуют exact partition lines.`);
+			n = r.value.lineEnd;
+			let t = a.slice(r.value.lineStart, r.value.lineEnd), i = t.filter((e) => e.before !== void 0).length, o = t.filter((e) => e.after !== void 0).length, s = a.slice(0, r.value.lineStart).filter((e) => e.before !== void 0).length + 1, c = a.slice(0, r.value.lineStart).filter((e) => e.after !== void 0).length + 1;
+			if (r.value.beforeStart !== s || r.value.afterStart !== c || r.kind === "hunk" && (r.value.beforeLineCount !== i || r.value.afterLineCount !== o)) throw RangeError(`${e}: result segment coordinates не соответствуют lines.`);
+		}
+		if (n !== a.length) throw RangeError(`${e}: result hunks/gaps не покрывают lines полностью.`);
+	}
+	let h = k(e, n.summary);
+	if (h.beforeLineCount !== r.lineCount || h.afterLineCount !== i.lineCount || h.unchangedLineCount !== d.unchanged || h.removedLineCount !== d.removed || h.addedLineCount !== d.added || h.changedLineCount !== d.removed + d.added) throw RangeError(`${e}: result.summary не соответствует lines/source snapshots.`);
+	return Object.freeze({
+		before: r,
+		after: i,
+		lines: Object.freeze(a),
+		hunks: Object.freeze(f),
+		gaps: Object.freeze(p),
+		summary: h
+	});
+}
+function j(e, t, n) {
+	let r = S("computeDiff", "before", e), a = S("computeDiff", "after", t), o = C("computeDiff", n);
+	return i(r, a, o);
+}
+//#endregion
+export { a as S_DIFF_DEFAULT_CONTEXT_LINES, o as S_DIFF_MAX_CONTEXT_LINES, j as computeDiff, C as validateDiffComputationOptions, A as validateDiffResult, S as validateDiffSource };

package/dist/src/components/shared/data-display/json.d.ts

@@ -0,0 +1,19 @@
+/** JSON scalar according to the JSON data model. / JSON-скаляр по модели данных JSON. */
+export type JsonScalar = string | number | boolean | null;
+/** JSON object with recursively exact values. / JSON-объект с рекурсивно точными значениями. */
+export type JsonObject = {
+    readonly [key: string]: JsonValue;
+};
+/** JSON array with recursively exact values. / JSON-массив с рекурсивно точными значениями. */
+export type JsonArray = readonly JsonValue[];
+/** Value representable by JSON without coercion or omission. / Значение, представимое JSON без преобразования или пропуска. */
+export type JsonValue = JsonScalar | JsonObject | JsonArray;
+/** Escapes one RFC 6901 reference token. / Экранирует один reference token по RFC 6901. */
+export declare function escapeJsonPointerToken(token: string): string;
+/** Appends a reference token to an RFC 6901 JSON Pointer. / Добавляет reference token к JSON Pointer по RFC 6901. */
+export declare function appendJsonPointer(pointer: string, token: string): string;
+/**
+ * Verifies that a runtime value is exact JSON without JSON.stringify coercions.
+ * Проверяет, что runtime-значение является точным JSON без преобразований JSON.stringify.
+ */
+export declare function assertJsonValue(value: unknown, component?: string): asserts value is JsonValue;

package/dist/src/components/shared/data-display/json.js

@@ -0,0 +1,60 @@
+//#region src/components/shared/data-display/json.ts
+function e(e) {
+	return e.replace(/~/gu, "~0").replace(/\//gu, "~1");
+}
+function t(t, n) {
+	return `${t}/${e(n)}`;
+}
+function n(e) {
+	return `JSON Pointer ${JSON.stringify(e)}`;
+}
+function r(e, t, r) {
+	return `${e}: unsupported ${typeof t} value at ${n(r)}`;
+}
+function i(e, r, i, a) {
+	let s = Reflect.ownKeys(e);
+	if (s.some((e) => typeof e == "symbol")) throw TypeError(`${r}: symbol properties are not representable at ${n(i)}`);
+	for (let a of s) {
+		if (typeof a != "string") throw TypeError(`${r}: symbol properties are not representable at ${n(i)}`);
+		if (a === "length") continue;
+		let o = Number(a);
+		if (!Number.isInteger(o) || o < 0 || String(o) !== a || o >= e.length) throw TypeError(`${r}: non-JSON array property at ${n(t(i, a))}`);
+	}
+	for (let s = 0; s < e.length; s += 1) {
+		let c = t(i, String(s)), l = Object.getOwnPropertyDescriptor(e, String(s));
+		if (!l) throw TypeError(`${r}: sparse array item at ${n(c)}`);
+		if ("get" in l || "set" in l) throw TypeError(`${r}: accessor property at ${n(c)}`);
+		o(l.value, r, c, a);
+	}
+}
+function a(e, r, i, a) {
+	let s = Object.getPrototypeOf(e);
+	if (s !== Object.prototype && s !== null) throw TypeError(`${r}: expected a plain JSON object at ${n(i)}`);
+	let c = Reflect.ownKeys(e);
+	if (c.some((e) => typeof e == "symbol")) throw TypeError(`${r}: symbol properties are not representable at ${n(i)}`);
+	for (let s of c) {
+		if (typeof s != "string") throw TypeError(`${r}: symbol properties are not representable at ${n(i)}`);
+		let c = t(i, s), l = Object.getOwnPropertyDescriptor(e, s);
+		if (!l) throw TypeError(`${r}: unavailable property at ${n(c)}`);
+		if (!l.enumerable) throw TypeError(`${r}: non-enumerable property at ${n(c)}`);
+		if ("get" in l || "set" in l) throw TypeError(`${r}: accessor property at ${n(c)}`);
+		o(l.value, r, c, a);
+	}
+}
+function o(e, t, o, s) {
+	if (e !== null && typeof e != "string" && typeof e != "boolean") {
+		if (typeof e == "number") {
+			if (!Number.isFinite(e)) throw TypeError(`${t}: expected a finite number at ${n(o)}`);
+			if (Object.is(e, -0)) throw TypeError(`${t}: negative zero is not exactly representable at ${n(o)}`);
+			return;
+		}
+		if (typeof e != "object") throw TypeError(r(t, e, o));
+		if (s.has(e)) throw TypeError(`${t}: cyclic reference at ${n(o)}`);
+		s.add(e), Array.isArray(e) ? i(e, t, o, s) : a(e, t, o, s), s.delete(e);
+	}
+}
+function s(e, t = "JSON value") {
+	o(e, t, "", /* @__PURE__ */ new Set());
+}
+//#endregion
+export { t as appendJsonPointer, s as assertJsonValue, e as escapeJsonPointerToken };

package/dist/src/components/shared/data-display/richDocument.d.ts

@@ -0,0 +1,226 @@
+export declare const S_RICH_DOCUMENT_VERSION: 1;
+export declare const S_RICH_DOCUMENT_MAX_NODES = 10000;
+export declare const S_RICH_DOCUMENT_MAX_DEPTH = 32;
+export declare const S_RICH_DOCUMENT_MAX_TEXT_LENGTH = 1048576;
+export type SRichDocumentContractErrorCode = 'cyclic_value' | 'duplicate_id' | 'invalid_structure' | 'invalid_type' | 'invalid_value' | 'limit_exceeded' | 'missing_resource' | 'unknown_field' | 'unknown_node_type' | 'unsafe_url' | 'unsupported_version';
+/** Typed contract failure with a stable machine code and exact source coordinate. */
+export declare class SRichDocumentContractError extends TypeError {
+    readonly code: SRichDocumentContractErrorCode;
+    readonly path: string;
+    constructor(code: SRichDocumentContractErrorCode, path: string, detail: string);
+}
+export interface SRichTextNode {
+    readonly type: 'text';
+    readonly value: string;
+}
+export interface SRichStrongNode {
+    readonly type: 'strong';
+    readonly children: readonly SRichInlineNode[];
+}
+export interface SRichEmphasisNode {
+    readonly type: 'emphasis';
+    readonly children: readonly SRichInlineNode[];
+}
+export interface SRichDeletionNode {
+    readonly type: 'deletion';
+    readonly children: readonly SRichInlineNode[];
+}
+export interface SRichKeyboardNode {
+    readonly type: 'keyboard';
+    readonly value: string;
+}
+export interface SRichSuperscriptNode {
+    readonly type: 'superscript';
+    readonly children: readonly SRichInlineNode[];
+}
+export interface SRichSubscriptNode {
+    readonly type: 'subscript';
+    readonly children: readonly SRichInlineNode[];
+}
+export interface SRichFootnoteReferenceNode {
+    readonly type: 'footnoteReference';
+    readonly id: string;
+    readonly label: string;
+    readonly marker?: string;
+}
+export interface SRichFootnoteBacklinkNode {
+    readonly type: 'footnoteBacklink';
+    readonly id: string;
+    readonly label: string;
+    readonly marker?: string;
+}
+export interface SRichInlineCodeNode {
+    readonly type: 'inlineCode';
+    readonly code: string;
+}
+export interface SRichLinkNode {
+    readonly type: 'link';
+    readonly href: string;
+    readonly title?: string;
+    readonly current?: boolean;
+    readonly children: readonly SRichInlineNode[];
+}
+export interface SRichMathInlineNode {
+    readonly type: 'mathInline';
+    readonly source: string;
+}
+/** Closed inline content union. Raw HTML, VNodes, callbacks, and trust flags are intentionally absent. */
+export type SRichInlineNode = SRichTextNode | SRichStrongNode | SRichEmphasisNode | SRichDeletionNode | SRichKeyboardNode | SRichSuperscriptNode | SRichSubscriptNode | SRichFootnoteReferenceNode | SRichFootnoteBacklinkNode | SRichInlineCodeNode | SRichLinkNode | SRichMathInlineNode;
+export interface SRichParagraphNode {
+    readonly type: 'paragraph';
+    readonly children: readonly SRichInlineNode[];
+}
+export interface SRichHeadingNode {
+    readonly type: 'heading';
+    readonly level: 1 | 2 | 3 | 4 | 5 | 6;
+    readonly children: readonly SRichInlineNode[];
+}
+export interface SRichListItemNode {
+    readonly type: 'listItem';
+    readonly checked?: boolean;
+    readonly checkboxLabel?: string;
+    readonly children: readonly SRichBlockNode[];
+}
+export interface SRichListNode {
+    readonly type: 'list';
+    readonly ordered: boolean;
+    readonly start?: number;
+    readonly children: readonly SRichListItemNode[];
+}
+export interface SRichQuoteNode {
+    readonly type: 'quote';
+    readonly children: readonly SRichBlockNode[];
+}
+export interface SRichDisclosureNode {
+    readonly type: 'disclosure';
+    readonly summary: string;
+    readonly open?: boolean;
+    readonly children: readonly SRichBlockNode[];
+}
+export interface SRichFootnoteDefinitionNode {
+    readonly type: 'footnoteDefinition';
+    readonly id: string;
+    readonly label: string;
+    readonly children: readonly SRichBlockNode[];
+}
+export interface SRichDividerNode {
+    readonly type: 'divider';
+}
+export interface SRichImageNode {
+    readonly type: 'image';
+    readonly resourceId: string;
+    readonly caption?: readonly SRichInlineNode[];
+}
+export interface SRichResourceNode {
+    readonly type: 'resource';
+    readonly resourceId: string;
+    readonly label: string;
+    readonly description?: string;
+}
+export interface SRichCodeBlockNode {
+    readonly type: 'codeBlock';
+    readonly code: string;
+    readonly language?: string;
+    readonly label?: string;
+    readonly showLineNumbers?: boolean;
+}
+export interface SRichMathBlockNode {
+    readonly type: 'mathBlock';
+    readonly source: string;
+    readonly label?: string;
+}
+export type SRichTableAlignment = 'left' | 'center' | 'right';
+export type SRichTableHeaderPresentation = 'visible' | 'assistive';
+export interface SRichTableColumn {
+    readonly id: string;
+    readonly header: string;
+    readonly headerPresentation?: SRichTableHeaderPresentation;
+    readonly align?: SRichTableAlignment;
+}
+export interface SRichTableCell {
+    readonly children: readonly SRichInlineNode[];
+}
+export interface SRichTableRow {
+    readonly id: string;
+    readonly cells: readonly SRichTableCell[];
+}
+export interface SRichTableNode {
+    readonly type: 'table';
+    readonly label: string;
+    readonly columns: readonly SRichTableColumn[];
+    readonly rows: readonly SRichTableRow[];
+}
+export type SRichCalloutTone = 'neutral' | 'information' | 'success' | 'warning' | 'danger';
+export interface SRichCalloutNode {
+    readonly type: 'callout';
+    readonly tone: SRichCalloutTone;
+    readonly title?: string;
+    readonly children: readonly SRichBlockNode[];
+}
+export type SRichActionAppearance = 'primary' | 'secondary' | 'danger';
+export interface SRichActionNode {
+    readonly type: 'action';
+    readonly id: string;
+    readonly label: string;
+    readonly appearance?: SRichActionAppearance;
+    readonly disabled?: boolean;
+}
+export interface SRichActionGroupNode {
+    readonly type: 'actionGroup';
+    readonly label?: string;
+    readonly actions: readonly SRichActionNode[];
+}
+/** Closed block content union accepted by the renderer. */
+export type SRichBlockNode = SRichParagraphNode | SRichHeadingNode | SRichListNode | SRichQuoteNode | SRichDisclosureNode | SRichFootnoteDefinitionNode | SRichDividerNode | SRichImageNode | SRichResourceNode | SRichCodeBlockNode | SRichMathBlockNode | SRichTableNode | SRichCalloutNode | SRichActionGroupNode;
+export type SRichDocumentNode = SRichInlineNode | SRichBlockNode | SRichListItemNode | SRichActionNode;
+/** Versioned, serializable rich-document input. */
+export interface SRichDocumentV1 {
+    readonly version: typeof S_RICH_DOCUMENT_VERSION;
+    readonly id: string;
+    readonly nodes: readonly SRichBlockNode[];
+}
+interface SRichDocumentResourceBase {
+    readonly id: string;
+    readonly url: string;
+    readonly title?: string;
+}
+export interface SRichDocumentImageResource extends SRichDocumentResourceBase {
+    readonly kind: 'image';
+    readonly alt: string;
+}
+export interface SRichDocumentFileResource extends SRichDocumentResourceBase {
+    readonly kind: 'file';
+    readonly label: string;
+    readonly mediaType?: string;
+    readonly byteSize?: number;
+}
+/** Consumer-owned resource descriptor resolved independently from the document AST. */
+export type SRichDocumentResource = SRichDocumentImageResource | SRichDocumentFileResource;
+/** Fully validated renderer input with resource references resolved by stable IDs. */
+export interface SRichDocumentModel {
+    readonly document: SRichDocumentV1;
+    readonly resources: readonly SRichDocumentResource[];
+}
+export interface SRichDocumentLinkActivate {
+    readonly documentId: string;
+    readonly path: string;
+    readonly href: string;
+    readonly title?: string;
+}
+export interface SRichDocumentResourceActivate {
+    readonly documentId: string;
+    readonly path: string;
+    readonly resourceId: string;
+}
+export interface SRichDocumentActionIntent {
+    readonly documentId: string;
+    readonly path: string;
+    readonly actionId: string;
+}
+/** Validates, clones, and freezes a closed V1 document before rendering. */
+export declare function validateRichDocument(value: unknown): SRichDocumentV1;
+/** Validates and freezes consumer-owned resource records under the resource URL policy. */
+export declare function validateRichDocumentResources(value: unknown): readonly SRichDocumentResource[];
+/** Validates the document and resources as one referentially complete renderer model. */
+export declare function validateRichDocumentModel(document: unknown, resources: unknown): SRichDocumentModel;
+export {};