@pgcorp/ui-kit 0.10.0 → 0.10.1

package/dist/src/internal/ownedAttrs.js

@@ -0,0 +1,334 @@
+import { useAttrs as e } from "vue";
+//#region src/internal/ownedAttrs.ts
+function t(e) {
+	return Object.freeze(e);
+}
+var n = Object.freeze({
+	SAppShell: t({}),
+	SDockRegion: t({}),
+	SResizeHandle: t({ "data-test-id": "data" }),
+	SSideMenuButton: t({ "data-testid": "data" }),
+	SSideMenuRail: t({ "data-testid": "data" }),
+	SStack: t({}),
+	SStatusBarShell: t({}),
+	SWorkbenchLayout: t({}),
+	SWorkbenchPanelShell: t({}),
+	SKanbanCard: t({ "data-testid": "data" }),
+	SKanbanLane: t({}),
+	STree: t({ "data-testid": "data" }),
+	SCloudChrome: t({
+		"data-chat-chrome-drop-zone": "data",
+		"data-testid": "data"
+	}),
+	SCloudChromeEmpty: t({}),
+	SCloudChromeRow: t({}),
+	SCollapsiblePanel: t({ "data-testid": "data" }),
+	SDrawer: t({}),
+	SFormGrid: t({}),
+	SFormGridItem: t({}),
+	SLeftSidebar: t({}),
+	SModal: t({ "data-testid": "data" }),
+	SPageHeader: t({}),
+	SUiKitLocaleProvider: t({}),
+	SPanel: t({ "data-testid": "data" }),
+	SPopover: t({
+		id: "string",
+		"aria-label": "string",
+		"data-testid": "data",
+		onClick: "listener"
+	}),
+	SSidebarGroup: t({}),
+	SSidebarSection: t({}),
+	SButton: t({
+		"aria-controls": "string",
+		"aria-describedby": "string",
+		"aria-current": "aria-current",
+		"aria-expanded": "aria-boolean",
+		"aria-haspopup": "aria-haspopup",
+		"aria-hidden": "aria-boolean",
+		"aria-keyshortcuts": "string",
+		"aria-label": "string",
+		"aria-pressed": "aria-pressed",
+		"aria-selected": "aria-boolean",
+		"data-s-popover-trigger": "data",
+		"data-s-drag-handle": "data",
+		"data-sidebar-section-toggle": "data",
+		"data-state": "data",
+		"data-test": "data",
+		"data-testid": "data",
+		"data-tree-selection-control": "data",
+		autofocus: "boolean-attribute",
+		id: "string",
+		onClick: "listener",
+		onFocusin: "listener",
+		onFocusout: "listener",
+		onKeydown: "listener",
+		onMousedown: "listener",
+		onPointercancel: "listener",
+		onPointerdown: "listener",
+		onPointerenter: "listener",
+		onPointerleave: "listener",
+		onPointerup: "listener",
+		role: "string",
+		tabindex: "string-or-number",
+		title: "string"
+	}),
+	SCheckbox: t({
+		"aria-label": "string",
+		"aria-describedby": "string",
+		"data-testid": "data",
+		onClick: "listener",
+		onPointerdown: "listener",
+		tabindex: "string-or-number"
+	}),
+	SSwitch: t({
+		"aria-label": "string",
+		"aria-describedby": "string",
+		onClick: "listener",
+		onPointerdown: "listener",
+		tabindex: "string-or-number"
+	}),
+	SCheckboxGroup: t({
+		"aria-describedby": "string",
+		"data-testid": "data"
+	}),
+	SChoiceCards: t({
+		"aria-describedby": "string",
+		"data-testid": "data"
+	}),
+	SColorSelect: t({ "aria-label": "string" }),
+	SCombobox: t({
+		"aria-describedby": "string",
+		"aria-label": "string"
+	}),
+	SDragHandle: t({ "data-testid": "data" }),
+	SContextMenu: t({}),
+	SContextToggleButton: t({}),
+	SField: t({}),
+	SFieldGroup: t({
+		"aria-describedby": "string",
+		"data-testid": "data"
+	}),
+	SFieldLabel: t({
+		"aria-label": "string",
+		"data-testid": "data"
+	}),
+	SDropdownMenu: t({
+		"aria-label": "string",
+		"data-testid": "data",
+		id: "string",
+		title: "string"
+	}),
+	SInputText: t({
+		"aria-activedescendant": "string",
+		"aria-autocomplete": "string",
+		"aria-controls": "string",
+		"aria-describedby": "string",
+		"aria-expanded": "aria-boolean",
+		"aria-haspopup": "aria-haspopup",
+		"aria-invalid": "aria-boolean",
+		"aria-label": "string",
+		"data-testid": "data",
+		autocomplete: "string",
+		inputmode: "input-mode",
+		list: "string",
+		max: "string-or-number",
+		min: "string-or-number",
+		onBlur: "listener",
+		onClick: "listener",
+		onFocus: "listener",
+		onKeydown: "listener",
+		onKeyup: "listener",
+		pattern: "string",
+		role: "string",
+		step: "string-or-number",
+		title: "string"
+	}),
+	SRange: t({
+		"aria-describedby": "string",
+		"aria-label": "string",
+		"data-testid": "data",
+		onBlur: "listener",
+		onFocus: "listener"
+	}),
+	SInlineTokenEditor: t({
+		"aria-describedby": "string",
+		"aria-label": "string",
+		"aria-labelledby": "string",
+		"data-testid": "data",
+		autocomplete: "string"
+	}),
+	SInteractiveSurface: t({}),
+	SLink: t({
+		"aria-label": "string",
+		"data-s-app-shell-brand-passive": "data",
+		"data-testid": "data",
+		download: "string-or-boolean",
+		title: "string"
+	}),
+	SListbox: t({
+		"aria-describedby": "string",
+		"data-testid": "data"
+	}),
+	SMarker: t({}),
+	SMenuSurface: t({ id: "string" }),
+	SSegmentedControl: t({
+		"aria-describedby": "string",
+		"data-testid": "data"
+	}),
+	SSelect: t({
+		"aria-describedby": "string",
+		"aria-label": "string",
+		"data-task-mapping-internal-value": "data",
+		"data-task-mapping-kind": "data",
+		"data-test": "data",
+		"data-testid": "data"
+	}),
+	STextarea: t({
+		"aria-describedby": "string",
+		"aria-label": "string",
+		"data-testid": "data",
+		autocomplete: "string",
+		onBlur: "listener"
+	}),
+	SActionList: t({}),
+	SActionListItem: t({
+		"data-testid": "data",
+		role: "string"
+	}),
+	SActionCard: t({
+		"data-testid": "data",
+		onFocusout: "listener"
+	}),
+	SBadge: t({
+		"data-testid": "data",
+		title: "string"
+	}),
+	SChip: t({
+		"aria-label": "string",
+		title: "string"
+	}),
+	SCodeBlock: t({
+		"aria-label": "string",
+		"data-testid": "data"
+	}),
+	SCodeEditor: t({
+		"aria-label": "string",
+		"aria-labelledby": "string",
+		autofocus: "boolean-attribute"
+	}),
+	SCodeWorkspaceEditor: t({}),
+	SDiffViewer: t({}),
+	SRichDocument: t({}),
+	SScrollViewport: t({ "data-testid": "data" }),
+	SCodeSearchPanel: t({}),
+	SCopyField: t({}),
+	SDocBlock: t({}),
+	SEmptyState: t({}),
+	SExpandableText: t({ "data-testid": "data" }),
+	SJsonTree: t({}),
+	SKeyValueGrid: t({}),
+	SLinkedSystemsList: t({}),
+	SMessage: t({ "data-testid": "data" }),
+	SMetricCard: t({}),
+	SChart: t({}),
+	SProgressBar: t({}),
+	SProgressIndicator: t({}),
+	SSectionHeader: t({}),
+	SStatus: t({}),
+	STable: t({}),
+	SControlledToastViewport: t({}),
+	SToastContainer: t({}),
+	STooltip: t({}),
+	STooltipAnchor: t({
+		"aria-describedby": "string",
+		"data-testid": "data",
+		id: "string"
+	}),
+	STooltipTarget: t({ "data-testid": "data" }),
+	SVirtualList: t({}),
+	SAsyncState: t({}),
+	SDataGrid: t({}),
+	SSqlEditor: t({}),
+	SGraphViewport: t({}),
+	SBottomNav: t({}),
+	SBreadcrumbs: t({ "aria-label": "string" }),
+	SCatalogNavigator: t({ "aria-label": "string" }),
+	STab: t({
+		"aria-label": "string",
+		"data-terminal-id": "data",
+		"data-testid": "data",
+		onDblclick: "listener",
+		onMousedown: "listener",
+		title: "string"
+	}),
+	STabList: t({ "aria-label": "string" }),
+	STabPanel: t({
+		"data-terminal-id": "data",
+		"data-testid": "data"
+	}),
+	STabPanels: t({}),
+	STabs: t({ "aria-label": "string" }),
+	SWizardSteps: t({ "data-wizard-owner": "data" }),
+	SPersonaProjectPicker: t({}),
+	SPersonaRunWorkbench: t({})
+});
+function r(...e) {
+	let t = e.flatMap((e) => e?.trim().split(/\s+/).filter(Boolean) ?? []);
+	return t.length > 0 ? [...new Set(t)].join(" ") : void 0;
+}
+function i(e) {
+	return typeof e == "function" || Array.isArray(e) && e.length > 0 && e.every((e) => typeof e == "function");
+}
+function a(e, t) {
+	return t == null ? !0 : e === "listener" ? i(t) : e === "string" ? typeof t == "string" : e === "aria-boolean" ? typeof t == "boolean" || t === "true" || t === "false" : e === "aria-current" ? typeof t == "boolean" || [
+		"page",
+		"step",
+		"location",
+		"date",
+		"time"
+	].includes(String(t)) : e === "aria-haspopup" ? typeof t == "boolean" || [
+		"menu",
+		"listbox",
+		"tree",
+		"grid",
+		"dialog"
+	].includes(String(t)) : e === "aria-pressed" ? typeof t == "boolean" || t === "mixed" : e === "input-mode" ? [
+		"none",
+		"text",
+		"decimal",
+		"numeric",
+		"tel",
+		"search",
+		"email",
+		"url"
+	].includes(String(t)) : e === "string-or-boolean" || e === "boolean-attribute" ? typeof t == "string" || typeof t == "boolean" : e === "string-or-number" ? typeof t == "string" || typeof t == "number" : typeof t == "string" || typeof t == "number" || typeof t == "boolean";
+}
+function o(e, t, n) {
+	return /* @__PURE__ */ Error(`${e}: ${n} на границе ${t}. / ${n} at the ${t} boundary.`);
+}
+function s(t) {
+	let r = e(), i = n[t.component], s = () => {
+		for (let [e, n] of Object.entries(r)) {
+			if (e === "class" || e === "style") throw o(t.component, t.owner, `raw "${e}" запрещён; атрибут "${e}" не объявлен в exact owned-attrs schema; используйте типизированные props/tokens UI-kit или consumer layout wrapper. Raw "${e}" is forbidden and is not declared by the exact owned-attrs schema; use typed UI-kit props/tokens or a consumer layout wrapper`);
+			let r = i[e] ?? (e.startsWith("data-") && e.length > 5 ? "data" : void 0);
+			if (!r) throw o(t.component, t.owner, `атрибут "${e}" не объявлен в exact owned-attrs schema; используйте типизированные props/emits/tokens UI-kit или consumer layout wrapper. Attribute "${e}" is not declared by the exact owned-attrs schema; use typed UI-kit props/emits/tokens or a consumer layout wrapper`);
+			if (!a(r, n)) throw o(t.component, t.owner, `атрибут "${e}" имеет недопустимый runtime-тип ${typeof n}; ожидается ${r}. Attribute "${e}" has invalid runtime type ${typeof n}; expected ${r}`);
+		}
+	};
+	return {
+		bindings: () => (s(), Object.fromEntries(Object.entries(r))),
+		reject: (e) => {
+			let n = Object.keys(r);
+			if (n.length !== 0) throw Error(`${t.component}: attrs ${n.map((e) => `"${e}"`).join(", ")} не имеют владельца (${e}). Attributes ${n.map((e) => `"${e}"`).join(", ")} have no owner (${e}).`);
+		},
+		string: (e) => {
+			if (i[e] !== "string") throw o(t.component, t.owner, `атрибут "${e}" не объявлен строковым. Attribute "${e}" is not declared as a string`);
+			s();
+			let n = r[e];
+			if (n != null) return n;
+		}
+	};
+}
+//#endregion
+export { r as mergeIdReferences, n as ownedAttributeSchemas, s as useOwnedAttrs };

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

@@ -0,0 +1,44 @@
+import { PropType } from 'vue';
+export interface PassiveContentContract {
+    /** Имя компонента-владельца для точной runtime-диагностики. / Owner name used in precise runtime diagnostics. */
+    owner: string;
+    /** Имя пассивной области публичного slot contract. / Name of the passive public slot region. */
+    region: string;
+    /** Отключает запрет, когда поверхность семантически не интерактивна. / Disables the guard while the surface is semantically passive. */
+    active?: () => boolean;
+    /** Подсказка о правильном sibling API владельца. / Guidance to the owner's sibling API. */
+    guidance?: string;
+}
+export interface InteractiveLeafContract {
+    /** Канонический leaf owner интерактивного поведения. / Canonical leaf owner of the interactive behavior. */
+    owner: string;
+    /** Учитывает leaf только когда он действительно интерактивен. / Counts the leaf only while it is actually interactive. */
+    active?: () => boolean;
+}
+/**
+ * Ограничивает typed passive-content contract точным slot-поддеревом без дополнительного DOM-узла.
+ * Scopes a typed passive-content contract to the exact slot subtree without adding a DOM node.
+ */
+export declare const PassiveContentBoundary: import('vue').DefineComponent<import('vue').ExtractPropTypes<{
+    contract: {
+        type: PropType<PassiveContentContract>;
+        required: true;
+    };
+}>, () => import('vue').VNode<import('vue').RendererNode, import('vue').RendererElement, {
+    [key: string]: any;
+}>[] | undefined, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<{
+    contract: {
+        type: PropType<PassiveContentContract>;
+        required: true;
+    };
+}>> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
+/**
+ * Создаёт typed registration boundary для пассивного slot-контента без DOM-инспекции.
+ * Creates a typed registration boundary for passive slot content without DOM inspection.
+ */
+export declare function usePassiveContentContract(contract: PassiveContentContract): void;
+/**
+ * Регистрирует UI-kit leaf во всех родительских passive boundaries.
+ * Registers a UI-kit leaf with every parent passive boundary.
+ */
+export declare function useInteractiveLeafRegistration(contract: InteractiveLeafContract): void;

package/dist/src/internal/passiveContentContract.js

@@ -0,0 +1,52 @@
+import { defineComponent as e, inject as t, onBeforeUnmount as n, provide as r, watchEffect as i } from "vue";
+//#region src/internal/passiveContentContract.ts
+var a = Symbol("passiveContentBoundary"), o = e({
+	name: "PassiveContentBoundary",
+	props: { contract: {
+		type: Object,
+		required: !0
+	} },
+	setup(e, { slots: t }) {
+		return c(e.contract), () => t.default?.();
+	}
+});
+function s(e, t) {
+	let n = e.guidance ? ` ${e.guidance}` : "";
+	return /* @__PURE__ */ Error(`${e.owner}: ${e.region} не допускает интерактивный leaf ${t.owner}; интерактивное действие должно быть sibling-узлом. / ${e.owner}: ${e.region} does not allow the interactive leaf ${t.owner}; render the interactive action as a sibling.${n}`);
+}
+function c(e) {
+	let o = t(a, null), c = /* @__PURE__ */ new Map(), l = () => {
+		if (e.active?.() === !1) return;
+		let t = [...c.values()].find((e) => e.active?.() !== !1);
+		if (t) throw s(e, t);
+	};
+	r(a, {
+		register: (t) => {
+			if (c.has(t.id)) throw Error(`${e.owner}: duplicate interactive leaf registration from ${t.owner}`);
+			c.set(t.id, t);
+			let n;
+			try {
+				l(), n = o?.register(t);
+			} catch (e) {
+				throw c.delete(t.id), n?.(), e;
+			}
+			return () => {
+				c.delete(t.id), n?.();
+			};
+		},
+		assert: l
+	}), i(l), n(() => c.clear());
+}
+function l(e) {
+	let r = t(a, null);
+	if (!r) return;
+	let o = {
+		...e,
+		id: Symbol(e.owner)
+	}, s = r.register(o);
+	i(() => {
+		e.active?.() !== !1 && r.assert();
+	}), n(s);
+}
+//#endregion
+export { o as PassiveContentBoundary, l as useInteractiveLeafRegistration, c as usePassiveContentContract };

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

@@ -0,0 +1,43 @@
+declare const PILL_KINDS: readonly ["badge", "chip"];
+declare const PILL_SEVERITIES: readonly ["primary", "secondary", "success", "info", "warn", "danger", "contrast"];
+declare const PILL_SIZES: readonly ["xs", "sm", "md"];
+declare const PILL_MAX_WIDTHS: readonly ["none", "sm", "md"];
+declare const PILL_ICON_MOTIONS: readonly ["static", "spin"];
+export type PillSurfaceKind = typeof PILL_KINDS[number];
+export type PillSurfaceSeverity = typeof PILL_SEVERITIES[number];
+export type PillSurfaceSize = typeof PILL_SIZES[number];
+export type PillSurfaceMaxWidth = typeof PILL_MAX_WIDTHS[number];
+export type PillSurfaceIconMotion = typeof PILL_ICON_MOTIONS[number];
+export declare const PILL_ICON_CLASS = "s-pill-icon inline-flex h-[var(--s-pill-icon-size)] w-[var(--s-pill-icon-size)] shrink-0 items-center justify-center";
+export declare const PILL_ICON_GRAPHIC_CLASS = "s-pill-icon-graphic h-full w-full";
+export declare const PILL_ICON_SPIN_CLASS = "animate-spin";
+export declare const PILL_LABEL_CLASS = "s-pill-label min-w-0";
+export declare const PILL_LABEL_TRUNCATE_CLASS = "overflow-hidden text-ellipsis whitespace-nowrap";
+export interface PillSurfaceContract {
+    kind: PillSurfaceKind;
+    severity: PillSurfaceSeverity;
+    size: PillSurfaceSize;
+    dot: boolean;
+    closable: boolean;
+    disabled: boolean;
+    truncate: boolean;
+    maxWidth: PillSurfaceMaxWidth;
+    iconMotion: PillSurfaceIconMotion;
+}
+export interface PillSurfaceBindings {
+    'data-s-pill-surface': PillSurfaceKind;
+    'data-s-tone': PillSurfaceSeverity;
+    'data-s-pill-size': PillSurfaceSize;
+    'data-s-pill-dot'?: 'true';
+    'data-s-pill-closable'?: 'true';
+    'data-s-pill-disabled'?: 'true';
+    'data-s-pill-truncate'?: 'true';
+    'data-s-pill-max-width'?: Exclude<PillSurfaceMaxWidth, 'none'>;
+    'data-s-pill-icon-motion'?: Exclude<PillSurfaceIconMotion, 'static'>;
+}
+/**
+ * Создаёт exact bindings единого pill/feedback presentation owner.
+ * Creates exact bindings for the canonical pill/feedback presentation owner.
+ */
+export declare function resolvePillSurfaceBindings(owner: 'SBadge' | 'SChip', contract: PillSurfaceContract): PillSurfaceBindings;
+export {};

package/dist/src/internal/pillSurface.js

@@ -0,0 +1,38 @@
+import { validateBoolean as e, validateExactString as t } from "./runtimeContract.js";
+import { resolveSemanticToneBinding as n } from "./semanticTone.js";
+//#region src/internal/pillSurface.ts
+var r = ["badge", "chip"], i = [
+	"primary",
+	"secondary",
+	"success",
+	"info",
+	"warn",
+	"danger",
+	"contrast"
+], a = [
+	"xs",
+	"sm",
+	"md"
+], o = [
+	"none",
+	"sm",
+	"md"
+], s = ["static", "spin"], c = "s-pill-icon inline-flex h-[var(--s-pill-icon-size)] w-[var(--s-pill-icon-size)] shrink-0 items-center justify-center", l = "s-pill-icon-graphic h-full w-full", u = "animate-spin", d = "s-pill-label min-w-0", f = "overflow-hidden text-ellipsis whitespace-nowrap";
+function p(c, l) {
+	let u = t(c, "pill kind", l.kind, r), d = n(c, "severity", l.severity, i), f = t(c, "size", l.size, a), p = t(c, "maxWidth", l.maxWidth, o), m = t(c, "iconMotion", l.iconMotion, s), h = e(c, "dot", l.dot), g = e(c, "closable", l.closable), _ = e(c, "disabled", l.disabled), v = e(c, "truncate", l.truncate);
+	if (u === "chip" && h) throw TypeError("SChip: dot presentation не поддерживается. / SChip: dot presentation is not supported.");
+	if (u === "badge" && g) throw TypeError("SBadge: closable presentation не поддерживается. / SBadge: closable presentation is not supported.");
+	return {
+		"data-s-pill-surface": u,
+		...d,
+		"data-s-pill-size": f,
+		...h ? { "data-s-pill-dot": "true" } : {},
+		...g ? { "data-s-pill-closable": "true" } : {},
+		..._ ? { "data-s-pill-disabled": "true" } : {},
+		...v ? { "data-s-pill-truncate": "true" } : {},
+		...p === "none" ? {} : { "data-s-pill-max-width": p },
+		...m === "static" ? {} : { "data-s-pill-icon-motion": m }
+	};
+}
+//#endregion
+export { c as PILL_ICON_CLASS, l as PILL_ICON_GRAPHIC_CLASS, u as PILL_ICON_SPIN_CLASS, d as PILL_LABEL_CLASS, f as PILL_LABEL_TRUNCATE_CLASS, p as resolvePillSurfaceBindings };

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

@@ -0,0 +1,12 @@
+export type PointerInteractionCursor = 'col-resize' | 'row-resize';
+export interface PointerInteractionLeaseOptions {
+    cursor: PointerInteractionCursor;
+}
+export interface PointerInteractionLease {
+    release: () => void;
+}
+/**
+ * Захватывает общий cursor/user-select контракт на время pointer-взаимодействия.
+ * Acquires the shared cursor/user-select contract for one pointer interaction.
+ */
+export declare function acquirePointerInteractionLease(options: PointerInteractionLeaseOptions): PointerInteractionLease;

package/dist/src/internal/pointerInteractionLease.js

@@ -0,0 +1,31 @@
+import { lastItem as e } from "./es2020.js";
+//#region src/internal/pointerInteractionLease.ts
+var t = [], n = null, r = "", i = "", a = () => {
+	let r = e(t);
+	n && r && (n.style.cursor = r.cursor, n.style.userSelect = "none");
+}, o = () => {
+	n && (n.style.cursor = r, n.style.userSelect = i, n = null, r = "", i = "");
+};
+function s(e) {
+	if (typeof document > "u") throw Error("pointerInteractionLease: document недоступен вне браузерного runtime");
+	let s = document.body;
+	if (t.length === 0) n = s, r = s.style.cursor, i = s.style.userSelect;
+	else if (n !== s) throw Error("pointerInteractionLease: document.body изменился во время активного interaction");
+	let c = {
+		id: Symbol("pointer-interaction"),
+		cursor: e.cursor
+	}, l = !0;
+	return t.push(c), a(), { release: () => {
+		if (!l) return;
+		l = !1;
+		let e = t.findIndex((e) => e.id === c.id);
+		if (e < 0) throw Error("pointerInteractionLease: активный lease отсутствует в реестре");
+		if (t.splice(e, 1), t.length === 0) {
+			o();
+			return;
+		}
+		a();
+	} };
+}
+//#endregion
+export { s as acquirePointerInteractionLease };

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

@@ -0,0 +1,39 @@
+export interface BoundedNumberDomain {
+    minimum: number;
+    maximum: number;
+}
+/**
+ * Проверяет непустую строку без trim/coercion и возвращает исходное значение.
+ * Validates a non-empty string without trimming/coercion and returns the original value.
+ */
+export declare function validateNonEmptyString(owner: string, coordinate: string, value: unknown): string;
+/**
+ * Проверяет boolean без truthy/falsy coercion.
+ * Validates a boolean without truthy/falsy coercion.
+ */
+export declare function validateBoolean(owner: string, coordinate: string, value: unknown): boolean;
+/**
+ * Проверяет DOM id по HTML-контракту: непустая строка без ASCII whitespace.
+ * Validates an HTML DOM id: a non-empty string without ASCII whitespace.
+ */
+export declare function validateDomId(owner: string, coordinate: string, value: unknown): string;
+/**
+ * Возвращает generated DOM id только при отсутствии явного значения и валидирует обе ветки.
+ * Returns a generated DOM id only when the explicit value is absent and validates both branches.
+ */
+export declare function resolveOptionalDomId(owner: string, coordinate: string, value: unknown, generatedValue: unknown): string;
+/**
+ * Проверяет exact string enum и сохраняет его literal union в return type.
+ * Validates an exact string enum and preserves its literal union in the return type.
+ */
+export declare function validateExactString<const Allowed extends readonly string[]>(owner: string, coordinate: string, value: unknown, allowed: Allowed): Allowed[number];
+/**
+ * Проверяет конечное число в inclusive domain без coercion.
+ * Validates a finite number in an inclusive domain without coercion.
+ */
+export declare function validateBoundedNumber(owner: string, coordinate: string, value: unknown, domain: BoundedNumberDomain): number;
+/**
+ * Проверяет целое число в inclusive domain без coercion.
+ * Validates an integer in an inclusive domain without coercion.
+ */
+export declare function validateBoundedInteger(owner: string, coordinate: string, value: unknown, domain: BoundedNumberDomain): number;

package/dist/src/internal/runtimeContract.js

@@ -0,0 +1,48 @@
+//#region src/internal/runtimeContract.ts
+var e = /[\t\n\f\r ]/u;
+function t(e) {
+	return typeof e == "string" ? JSON.stringify(e) : typeof e == "number" ? `number(${String(e)})` : typeof e == "bigint" ? `bigint(${String(e)})` : typeof e == "boolean" ? `boolean(${String(e)})` : e === void 0 ? "undefined" : typeof e == "symbol" ? `symbol(${e.description ?? ""})` : typeof e == "function" ? "function" : e === null ? "null" : Array.isArray(e) ? "array" : "object";
+}
+function n(e, n, r, i) {
+	let a = Number.isFinite(r.minimum) && Number.isFinite(r.maximum), o = !i || Number.isInteger(r.minimum) && Number.isInteger(r.maximum);
+	if (!(a && o && r.minimum <= r.maximum)) throw TypeError(i ? `runtimeContract: границы domain для ${e}.${n} должны быть целыми числами, где minimum <= maximum; получено minimum=${t(r.minimum)}, maximum=${t(r.maximum)}. / runtimeContract: domain bounds for ${e}.${n} must be integers with minimum <= maximum; received minimum=${t(r.minimum)}, maximum=${t(r.maximum)}.` : `runtimeContract: границы domain для ${e}.${n} должны быть конечными числами, где minimum <= maximum; получено minimum=${t(r.minimum)}, maximum=${t(r.maximum)}. / runtimeContract: domain bounds for ${e}.${n} must be finite numbers with minimum <= maximum; received minimum=${t(r.minimum)}, maximum=${t(r.maximum)}.`);
+}
+function r(e, t, n) {
+	let r = new Set(n);
+	if (!(n.length > 0 && r.size === n.length && n.every((e) => e.trim().length > 0))) throw TypeError(`runtimeContract: domain для ${e}.${t} должен содержать непустой уникальный список строк. / runtimeContract: domain for ${e}.${t} must contain a non-empty unique string list.`);
+}
+function i(e, n, r) {
+	if (typeof r == "string" && r.trim().length > 0) return r;
+	let i = t(r);
+	throw TypeError(`${e}: ${n} должен быть непустой строкой; получено ${i}. / ${e}: ${n} must be a non-empty string; received ${i}.`);
+}
+function a(e, n, r) {
+	if (typeof r == "boolean") return r;
+	let i = t(r);
+	throw TypeError(`${e}: ${n} должен быть boolean; получено ${i}. / ${e}: ${n} must be a boolean; received ${i}.`);
+}
+function o(n, r, i) {
+	if (typeof i == "string" && i.length > 0 && !e.test(i)) return i;
+	let a = t(i);
+	throw TypeError(`${n}: ${r} должен быть непустым DOM id без ASCII-пробелов; получено ${a}. / ${n}: ${r} must be a non-empty DOM id without ASCII whitespace; received ${a}.`);
+}
+function s(e, t, n, r) {
+	return n === void 0 ? o(e, `generated ${t}`, r) : o(e, t, n);
+}
+function c(e, n, i, a) {
+	if (r(e, n, a), typeof i == "string" && a.includes(i)) return i;
+	let o = `[${a.map((e) => JSON.stringify(e)).join(", ")}]`, s = t(i);
+	throw TypeError(`${e}: ${n} должен быть одним из ${o}; получено ${s}. / ${e}: ${n} must be one of ${o}; received ${s}.`);
+}
+function l(e, r, i, a) {
+	if (n(e, r, a, !1), typeof i == "number" && Number.isFinite(i) && i >= a.minimum && i <= a.maximum) return i;
+	let o = t(i);
+	throw TypeError(`${e}: ${r} должен быть конечным числом в диапазоне [${a.minimum}, ${a.maximum}]; получено ${o}. / ${e}: ${r} must be a finite number in the inclusive range [${a.minimum}, ${a.maximum}]; received ${o}.`);
+}
+function u(e, r, i, a) {
+	if (n(e, r, a, !0), typeof i == "number" && Number.isInteger(i) && i >= a.minimum && i <= a.maximum) return i;
+	let o = t(i);
+	throw TypeError(`${e}: ${r} должен быть целым числом в диапазоне [${a.minimum}, ${a.maximum}]; получено ${o}. / ${e}: ${r} must be an integer in the inclusive range [${a.minimum}, ${a.maximum}]; received ${o}.`);
+}
+//#endregion
+export { s as resolveOptionalDomId, a as validateBoolean, u as validateBoundedInteger, l as validateBoundedNumber, o as validateDomId, c as validateExactString, i as validateNonEmptyString };