@pgcorp/ui-kit 0.13.0 → 0.14.0

package/dist/src/components/shared/data-display/_internal/richDocumentValidation.js

@@ -0,0 +1,192 @@
+//#region src/components/shared/data-display/_internal/richDocumentValidation.ts
+var e = 1, t = 1e4, n = 32, r = 1048576, i = class extends TypeError {
+	constructor(e, t, n) {
+		super(`SRichDocument [${e}] at ${t}: ${n}`), this.name = "SRichDocumentContractError", this.code = e, this.path = t;
+	}
+};
+function a() {
+	return {
+		ancestors: /* @__PURE__ */ new Set(),
+		actionIds: /* @__PURE__ */ new Set(),
+		footnoteDefinitions: /* @__PURE__ */ new Map(),
+		footnoteReferences: /* @__PURE__ */ new Map(),
+		footnoteBacklinks: /* @__PURE__ */ new Map(),
+		anchors: /* @__PURE__ */ new Map(),
+		anchorReferences: /* @__PURE__ */ new Map(),
+		accessibilityReferences: /* @__PURE__ */ new Map(),
+		nodeCount: 0
+	};
+}
+function o(e, n, r) {
+	r > 32 && s("limit_exceeded", e, "maximum depth is 32"), n.nodeCount += 1, n.nodeCount > 1e4 && s("limit_exceeded", e, `maximum node count is ${t}`);
+}
+function s(e, t, n) {
+	throw new i(e, t, n);
+}
+function c(e, t, n) {
+	n.ancestors.has(e) && s("cyclic_value", t, "cyclic values are not allowed"), n.ancestors.add(e);
+}
+function l(e, t, n) {
+	(typeof e != "object" || !e || Array.isArray(e) || Object.getPrototypeOf(e) !== Object.prototype) && s("invalid_type", t, "expected a plain object"), c(e, t, n);
+	let r = {};
+	for (let n of Reflect.ownKeys(e)) {
+		typeof n != "string" && s("unknown_field", t, "symbol fields are not allowed");
+		let i = Object.getOwnPropertyDescriptor(e, n);
+		(!i?.enumerable || !("value" in i)) && s("invalid_structure", `${t}.${n}`, "expected an enumerable data property"), Object.defineProperty(r, n, {
+			value: i.value,
+			enumerable: !0
+		});
+	}
+	return r;
+}
+function u(e, t) {
+	t.ancestors.delete(e);
+}
+function d(e, t, n) {
+	let r = Object.keys(e).filter((e) => !n.has(e));
+	r.length > 0 && s("unknown_field", `${t}.${r[0]}`, "field is not part of the closed contract");
+}
+function f(e, t, n, r) {
+	Array.isArray(e) || s("invalid_type", t, "expected an array"), c(e, t, n), e.length < r.minimum && s("invalid_value", t, `expected at least ${r.minimum} items`), e.length > r.maximum && s("limit_exceeded", t, `maximum is ${r.maximum} items`);
+	let i = [];
+	for (let n of Reflect.ownKeys(e)) n !== "length" && (typeof n != "string" || !/^(0|[1-9]\d*)$/u.test(n) || Number(n) >= e.length) && s("unknown_field", t, `array field ${String(n)} is not allowed`);
+	for (let n = 0; n < e.length; n += 1) {
+		let r = Object.getOwnPropertyDescriptor(e, String(n));
+		(!r?.enumerable || !("value" in r)) && s("invalid_structure", `${t}[${n}]`, "sparse arrays and accessors are not allowed"), i.push(r.value);
+	}
+	return i;
+}
+function p(e, t, n = {}) {
+	typeof e != "string" && s("invalid_type", t, "expected a string");
+	let r = n.maximum ?? 1048576;
+	return !n.allowEmpty && e.length === 0 && s("invalid_value", t, "expected a non-empty string"), e.length > r && s("limit_exceeded", t, `maximum length is ${r}`), n.stable && e !== e.trim() && s("invalid_value", t, "surrounding whitespace is not allowed"), e;
+}
+function m(e, t) {
+	return e === void 0 ? void 0 : p(e, t);
+}
+function h(e, t) {
+	let n = p(e, t);
+	return n.trim().length === 0 && s("invalid_value", t, "an accessible label must contain non-whitespace content"), n;
+}
+function g(e, t) {
+	return e === void 0 ? void 0 : h(e, t);
+}
+function _(e, t) {
+	return v(e, t, 128);
+}
+function v(e, t, n = 256) {
+	let r = p(e, t, {
+		stable: !0,
+		maximum: n
+	});
+	return /\s|[\u0000-\u001F\u007F]|[\uD800-\uDBFF](?![\uDC00-\uDFFF])|(?<![\uD800-\uDBFF])[\uDC00-\uDFFF]/u.test(r) && s("invalid_value", t, "identifiers must contain well-formed Unicode without whitespace or controls"), r;
+}
+var y = [
+	"anchorId",
+	"title",
+	"lang",
+	"direction",
+	"accessibleLabel",
+	"labelledBy",
+	"describedBy"
+], b = /* @__PURE__ */ new Set(/* @__PURE__ */ "en-gb-oed.i-ami.i-bnn.i-default.i-enochian.i-hak.i-klingon.i-lux.i-mingo.i-navajo.i-pwn.i-tao.i-tay.i-tsu.sgn-be-fr.sgn-be-nl.sgn-ch-de.art-lojban.cel-gaulish.no-bok.no-nyn.zh-guoyu.zh-hakka.zh-min.zh-min-nan.zh-xiang".split("."));
+function x(e, t) {
+	if (b.has(e.toLowerCase()) || /^x(?:-[A-Za-z0-9]{1,8})+$/iu.test(e)) return;
+	let n = /^(?:[A-Za-z]{2,3}(?:-[A-Za-z]{3}){0,3}|[A-Za-z]{4}|[A-Za-z]{5,8})(?:-[A-Za-z]{4})?(?:-(?:[A-Za-z]{2}|\d{3}))?((?:-(?:[A-Za-z0-9]{5,8}|\d[A-Za-z0-9]{3}))*)((?:-[0-9A-WYZa-wyz](?:-[A-Za-z0-9]{2,8})+)*)(?:-x(?:-[A-Za-z0-9]{1,8})+)?$/u.exec(e);
+	n === null && s("invalid_value", t, "expected a well-formed BCP47 language tag");
+	let r = (n[1] ?? "").toLowerCase().split("-").filter((e) => e.length > 0), i = [...(n[2] ?? "").matchAll(/-([0-9A-WYZa-wyz])(?=-)/gu)].map((e) => e[1]?.toLowerCase());
+	(new Set(r).size !== r.length || new Set(i).size !== i.length) && s("invalid_value", t, "language variants and extension singletons must be unique");
+}
+function S(e, n, r) {
+	let i = f(e, n, r, {
+		minimum: 1,
+		maximum: t
+	});
+	try {
+		let e = i.map((e, t) => v(e, `${n}[${t}]`)), t = /* @__PURE__ */ new Set();
+		for (let [r, i] of e.entries()) t.has(i) && s("duplicate_id", `${n}[${r}]`, `duplicate reference ${JSON.stringify(i)}`), t.add(i);
+		return Object.freeze(e);
+	} finally {
+		u(e, r);
+	}
+}
+function C(e, t, n, r = !0) {
+	let i = r && e.anchorId !== void 0 ? v(e.anchorId, `${t}.anchorId`) : void 0;
+	i !== void 0 && E(n.anchors, i, `${t}.anchorId`, "document anchor");
+	let a = m(e.title, `${t}.title`), o = m(e.lang, `${t}.lang`);
+	o !== void 0 && x(o, `${t}.lang`);
+	let s = e.direction === void 0 ? void 0 : k(e.direction, `${t}.direction`, /* @__PURE__ */ new Set([
+		"ltr",
+		"rtl",
+		"auto"
+	])), c = g(e.accessibleLabel, `${t}.accessibleLabel`), l = e.labelledBy === void 0 ? void 0 : S(e.labelledBy, `${t}.labelledBy`, n), u = e.describedBy === void 0 ? void 0 : S(e.describedBy, `${t}.describedBy`, n);
+	for (let [e, r] of [["labelledBy", l], ["describedBy", u]]) r?.forEach((r, i) => n.accessibilityReferences.set(`${t}.${e}[${i}]`, r));
+	return Object.freeze({
+		...i === void 0 ? {} : { anchorId: i },
+		...a === void 0 ? {} : { title: a },
+		...o === void 0 ? {} : { lang: o },
+		...s === void 0 ? {} : { direction: s },
+		...c === void 0 ? {} : { accessibleLabel: c },
+		...l === void 0 ? {} : { labelledBy: l },
+		...u === void 0 ? {} : { describedBy: u }
+	});
+}
+function w(e, t) {
+	return JSON.stringify([e, t]);
+}
+function T(e, t, n, r) {
+	let i = _(e.id, `${t}.id`), a = e.occurrenceId === void 0 ? void 0 : v(e.occurrenceId, `${t}.occurrenceId`), o = `${t}.${a === void 0 ? "id" : "occurrenceId"}`, c = w(i, a ?? i), l = r === "footnoteReference" ? n.footnoteReferences : n.footnoteBacklinks, u = l.get(c);
+	return u !== void 0 && s("duplicate_id", o, `duplicate ${r} occurrence; first declared at ${u.path}`), l.set(c, {
+		id: i,
+		occurrenceId: a ?? i,
+		path: t,
+		occurrencePath: o
+	}), {
+		id: i,
+		...a === void 0 ? {} : { occurrenceId: a }
+	};
+}
+function E(e, t, n, r) {
+	let i = e.get(t);
+	i !== void 0 && s("duplicate_id", n, `duplicate ${r} ID ${JSON.stringify(t)}; first declared at ${i}`), e.set(t, n);
+}
+function D(e, t) {
+	return typeof e != "boolean" && s("invalid_type", t, "expected a boolean"), e;
+}
+function O(e, t, n, r) {
+	return (!Number.isSafeInteger(e) || typeof e != "number") && s("invalid_type", t, "expected a safe integer"), (e < n || e > r) && s("invalid_value", t, `expected ${n}..${r}`), e;
+}
+function k(e, t, n) {
+	return (typeof e != "string" || !n.has(e)) && s("invalid_value", t, `expected one of ${[...n].join(", ")}`), e;
+}
+function A(e, t, n) {
+	let r = p(e, t, {
+		stable: !0,
+		maximum: 8192
+	});
+	(/\s|[\u0000-\u001F\u007F]/u.test(r) || r.includes("\\")) && s("unsafe_url", t, "whitespace, control characters, and backslashes are not allowed"), r.startsWith("//") && s("unsafe_url", t, "scheme-relative URLs are not allowed");
+	let i = /^([A-Za-z][A-Za-z0-9+.-]*):/u.exec(r)?.[1]?.toLowerCase();
+	if (i === void 0) return n === "resource" && r.startsWith("#") && s("unsafe_url", t, "fragment-only resource URLs are not allowed"), r;
+	(n === "link" ? /* @__PURE__ */ new Set([
+		"http",
+		"https",
+		"mailto",
+		"tel",
+		"irc",
+		"ircs",
+		"xmpp"
+	]) : /* @__PURE__ */ new Set([
+		"http",
+		"https",
+		"blob"
+	])).has(i) || s("unsafe_url", t, `protocol ${i}: is not allowed for ${n}`);
+	let a;
+	try {
+		a = new URL(r);
+	} catch {
+		s("unsafe_url", t, "URL syntax is invalid");
+	}
+	return (i === "http" || i === "https") && (a.username.length > 0 || a.password.length > 0) && s("unsafe_url", t, "URL credentials are not allowed"), r;
+}
+//#endregion
+export { y as SEMANTIC_METADATA_FIELDS, i as SRichDocumentContractError, n as S_RICH_DOCUMENT_MAX_DEPTH, t as S_RICH_DOCUMENT_MAX_NODES, r as S_RICH_DOCUMENT_MAX_TEXT_LENGTH, e as S_RICH_DOCUMENT_VERSION, d as assertFields, o as consumeRichNode, a as createValidationContext, c as enter, s as fail, w as footnoteOccurrenceKey, u as leave, f as readArray, D as readBoolean, k as readEnum, _ as readFootnoteId, T as readFootnoteOccurrence, v as readIdentity, S as readIdentityArray, O as readInteger, h as readLabel, g as readOptionalLabel, m as readOptionalString, l as readRecord, C as readSemanticMetadata, p as readString, E as registerUniqueFootnote, A as validateUrl };

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

@@ -0,0 +1,27 @@
+import { ComputedRef, InjectionKey } from 'vue';
+import { STableRowState } from '../table';
+export type STableSectionKind = 'head' | 'body' | 'foot';
+export type STableRowMode = 'registry' | 'passive';
+export type STableRowPresentation = 'default' | 'details' | 'status';
+export type STableCellPresentation = 'default' | 'control' | 'details';
+export interface STableRowContext {
+    readonly state: ComputedRef<STableRowState>;
+    readonly selected: ComputedRef<boolean>;
+}
+export declare const tableSectionKey: InjectionKey<ComputedRef<STableSectionKind>>;
+export declare const tableRowKey: InjectionKey<STableRowContext>;
+interface STableSemanticMetadata {
+    readonly domId?: string;
+    readonly focusTarget: boolean;
+    readonly title?: string;
+    readonly language?: string;
+    readonly direction?: 'ltr' | 'rtl' | 'auto';
+    readonly ariaLabel?: string;
+    readonly ariaLabelledby?: string;
+    readonly ariaDescribedby?: string;
+}
+/** Checks semantic metadata shared by native table owners without opening an attrs escape. */
+export declare function validateTableMetadata(owner: string, metadata: STableSemanticMetadata): void;
+/** Validates an explicit DOM IDREF list without repairing whitespace or identities. */
+export declare function validateTableIdReferences(owner: string, coordinate: string, value: string | undefined): string | undefined;
+export {};

package/dist/src/components/shared/data-display/_internal/tableFoundation.js

@@ -0,0 +1,16 @@
+import { validateBoolean as e, validateDomId as t, validateDomIdReferences as n, validateExactString as r, validateNonEmptyString as i } from "../../../../internal/runtimeContract.js";
+//#region src/components/shared/data-display/_internal/tableFoundation.ts
+var a = Symbol("STable.section"), o = Symbol("STable.row");
+function s(n, a) {
+	if (e(n, "focusTarget", a.focusTarget), a.domId !== void 0 && t(n, "domId", a.domId), a.title !== void 0 && typeof a.title != "string") throw TypeError(`${n}: title must be a string.`);
+	a.language !== void 0 && i(n, "language", a.language), a.ariaLabel !== void 0 && i(n, "ariaLabel", a.ariaLabel), c(n, "ariaLabelledby", a.ariaLabelledby), c(n, "ariaDescribedby", a.ariaDescribedby), a.direction !== void 0 && r(n, "direction", a.direction, [
+		"ltr",
+		"rtl",
+		"auto"
+	]);
+}
+function c(e, t, r) {
+	if (r !== void 0) return n(e, t, r);
+}
+//#endregion
+export { o as tableRowKey, a as tableSectionKey, c as validateTableIdReferences, s as validateTableMetadata };

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

@@ -1,226 +1,9 @@
-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;
-}
+import { SRichDocumentModel, SRichDocumentResource, SRichDocumentV1 } from './_internal/richDocumentTypes';
+export { S_RICH_DOCUMENT_VERSION, S_RICH_DOCUMENT_MAX_NODES, S_RICH_DOCUMENT_MAX_DEPTH, S_RICH_DOCUMENT_MAX_TEXT_LENGTH, SRichDocumentContractError, type SRichDocumentContractErrorCode } from './_internal/richDocumentValidation';
+export type * from './_internal/richDocumentTypes';
 /** 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 {};