@pgcorp/ui-kit 0.9.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 };