@vireocodedev/history 0.2.0 → 0.2.1

package/dist/definitions/createHistoryDefinition.d.ts

@@ -0,0 +1,3 @@
+import { HistoryDefinition, HistoryDefinitionFields, HistoryDefinitionOptions, HistoryObjectForSchema } from './historyDefinition.types';
+import { z } from 'zod';
+export declare function createHistoryDefinition<TSchema extends z.ZodTypeAny>(schema: TSchema, options: HistoryDefinitionOptions<HistoryObjectForSchema<TSchema>>, fields: HistoryDefinitionFields<HistoryObjectForSchema<TSchema>>): HistoryDefinition<HistoryObjectForSchema<TSchema>, TSchema>;

package/dist/definitions/historyDefinition.types.d.ts

@@ -0,0 +1,47 @@
+import { z } from 'zod';
+export type HistoryEntityKey = string | number;
+export type HistoryPathSegment = string | number;
+export type HistoryPath = readonly HistoryPathSegment[];
+export type HistoryChangeType = "added" | "removed" | "updated";
+export type HistoryArrayMode = "set" | "ordered";
+export type HistoryValueSide = "previous" | "current";
+export type HistoryFormatContext<TParent> = {
+    parent: NonNullable<TParent>;
+    side: HistoryValueSide;
+    path: HistoryPath;
+};
+export type HistoryDefinitionOptions<TEntity extends object> = {
+    label: string;
+    key: (value: TEntity) => HistoryEntityKey;
+    format?: (value: TEntity, context: HistoryFormatContext<TEntity>) => string;
+};
+export type HistoryFieldConfig<TValue, TParent> = false | HistoryAtomicFieldConfig<TValue, TParent> | HistoryArrayFieldConfig<TValue, TParent> | HistoryObjectFieldConfig<TValue>;
+export type HistoryAtomicFieldConfig<TValue, TParent> = {
+    kind: "field";
+    label: string;
+    format?: (value: NonNullable<TValue>, context: HistoryFormatContext<TParent>) => string;
+    resolveChange?: (previous: TValue, current: TValue) => HistoryChangeType | null;
+};
+export type HistoryArrayFieldConfig<TValue, TParent> = NonNullable<TValue> extends readonly (infer TItem)[] ? {
+    kind: "array";
+    label: string;
+    /** @default "set" */
+    mode?: HistoryArrayMode;
+    format?: (value: NonNullable<TValue>, context: HistoryFormatContext<TParent>) => string;
+    item: HistoryArrayItemConfig<TItem>;
+} : never;
+export type HistoryArrayItemConfig<TItem> = HistoryAtomicFieldConfig<TItem, TItem> | HistoryArrayFieldConfig<TItem, TItem> | HistoryObjectFieldConfig<TItem>;
+export type HistoryObjectFieldConfig<TValue> = NonNullable<TValue> extends object ? NonNullable<TValue> extends readonly unknown[] ? never : {
+    kind: "object";
+    definition: HistoryDefinition<NonNullable<TValue>>;
+} : never;
+export type HistoryDefinitionFields<TEntity extends object> = {
+    [TKey in keyof TEntity]-?: HistoryFieldConfig<TEntity[TKey], TEntity>;
+};
+export type HistoryDefinition<TEntity extends object, TSchema extends z.ZodTypeAny = z.ZodTypeAny> = {
+    schema: TSchema;
+    options: HistoryDefinitionOptions<TEntity>;
+    fields: HistoryDefinitionFields<TEntity>;
+};
+export type HistoryEntityForDefinition<TDefinition> = TDefinition extends HistoryDefinition<infer TEntity, z.ZodTypeAny> ? TEntity : never;
+export type HistoryObjectForSchema<TSchema extends z.ZodTypeAny> = NonNullable<z.infer<TSchema>> extends object ? NonNullable<z.infer<TSchema>> extends readonly unknown[] ? never : NonNullable<z.infer<TSchema>> : never;

package/dist/diff/createHistoryNodes.d.ts

@@ -0,0 +1,4 @@
+import { HistoryDefinition } from '../definitions/historyDefinition.types';
+import { HistoryEngineOptions, HistoryNode } from './historyNode.types';
+import { z } from 'zod';
+export declare function createHistoryNodes<TEntity extends object, TSchema extends z.ZodTypeAny>(definition: HistoryDefinition<TEntity, TSchema>, previous: NoInfer<TEntity> | null | undefined, current: NoInfer<TEntity> | null | undefined, options?: HistoryEngineOptions): HistoryNode[];

package/dist/diff/historyNode.types.d.ts

@@ -0,0 +1,47 @@
+import { HistoryPath } from '../definitions/historyDefinition.types';
+export type HistoryValue = {
+    raw: unknown;
+    formatted: string;
+};
+export type HistoryFieldRow = {
+    type: "removed";
+    path: HistoryPath;
+    label: string;
+    previous: HistoryValue;
+} | {
+    type: "updated";
+    path: HistoryPath;
+    label: string;
+    previous: HistoryValue;
+    current: HistoryValue;
+} | {
+    type: "added";
+    path: HistoryPath;
+    label: string;
+    current: HistoryValue;
+} | {
+    type: "moved";
+    path: HistoryPath;
+    label: string;
+    previous: HistoryValue;
+    current: HistoryValue;
+} | {
+    type: "unchanged";
+    path: HistoryPath;
+    label: string;
+    current: HistoryValue;
+};
+export type HistoryGroupChangeType = "added" | "updated" | "removed" | "unchanged";
+export type HistoryGroupNode = {
+    type: "group";
+    path: HistoryPath;
+    label: string;
+    value?: HistoryValue;
+    changeType: HistoryGroupChangeType;
+    children: HistoryNode[];
+};
+export type HistoryNode = HistoryFieldRow | HistoryGroupNode;
+export type HistoryEngineOptions = {
+    positionLabel?: string;
+    showUnchanged?: boolean;
+};

package/dist/diff/historyValue.d.ts

@@ -0,0 +1,7 @@
+import { HistoryFormatContext } from '../definitions/historyDefinition.types';
+import { HistoryValue } from './historyNode.types';
+export declare function isHistoryValuePresent(value: unknown): boolean;
+export declare function formatHistoryValue<TParent>(raw: unknown, format: ((value: never, context: HistoryFormatContext<TParent>) => string) | undefined, context: HistoryFormatContext<TParent>): HistoryValue;
+export declare function formatDefaultHistoryValue(value: unknown): string;
+export declare function areHistoryValuesEqual(previous: unknown, current: unknown): boolean;
+export declare function stableStringify(value: unknown): string;

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { createHistoryDefinition } from './definitions/createHistoryDefinition';
+export type { HistoryArrayFieldConfig, HistoryArrayItemConfig, HistoryArrayMode, HistoryAtomicFieldConfig, HistoryChangeType, HistoryDefinition, HistoryDefinitionFields, HistoryDefinitionOptions, HistoryEntityForDefinition, HistoryEntityKey, HistoryFieldConfig, HistoryFormatContext, HistoryObjectFieldConfig, HistoryPath, HistoryPathSegment, HistoryValueSide, } from './definitions/historyDefinition.types';
+export { createHistoryNodes } from './diff/createHistoryNodes';
+export type { HistoryEngineOptions, HistoryFieldRow, HistoryGroupChangeType, HistoryGroupNode, HistoryNode, HistoryValue, } from './diff/historyNode.types';
+export { createHistoryRecordSchema, HistoryActorSchema, HistoryRecordSchema, HistorySnapshotSchema, HistoryTimestampSchema, } from './records/historyRecord';
+export type { HistoryActor, HistoryEntityKind, HistoryRecord, HistoryRecordSchemaOptions, HistorySnapshot, HistoryTimestamp, } from './records/historyRecord';

package/dist/index.js

@@ -0,0 +1,549 @@
+import { z as e } from "zod";
+//#region src/definitions/createHistoryDefinition.ts
+function t(e, t, i) {
+	if (r(e), a(t?.label, "History definition label"), typeof t?.key != "function") throw TypeError("History definition key must be a function.");
+	if (o(t.format, "History definition format"), typeof i != "object" || !i || Array.isArray(i)) throw TypeError("History definition fields must be an object.");
+	return Object.entries(i).forEach(([e, t]) => n(t, `fields.${e}`)), {
+		schema: e,
+		options: t,
+		fields: i
+	};
+}
+function n(e, t) {
+	if (e === !1) return;
+	if (typeof e != "object" || !e || Array.isArray(e)) throw TypeError(`History ${t} must be false or a field configuration object.`);
+	let r = e;
+	switch (r.kind) {
+		case "field":
+			a(r.label, `History ${t} label`), o(r.format, `History ${t} format`), o(r.resolveChange, `History ${t} resolveChange`);
+			return;
+		case "array":
+			if (a(r.label, `History ${t} label`), o(r.format, `History ${t} format`), r.mode !== void 0 && r.mode !== "set" && r.mode !== "ordered") throw TypeError(`History ${t} mode must be "set" or "ordered".`);
+			if (n(r.item, `${t}.item`), r.item === !1) throw TypeError(`History ${t}.item cannot be ignored.`);
+			return;
+		case "object":
+			i(r.definition, `History ${t} definition`);
+			return;
+		default: throw TypeError(`History ${t} has unsupported kind "${String(r.kind)}".`);
+	}
+}
+function r(e) {
+	if (typeof e != "object" || !e || typeof e.parse != "function") throw TypeError("History definition schema must be a Zod schema.");
+}
+function i(e, t) {
+	if (typeof e != "object" || !e) throw TypeError(`${t} must be a history definition.`);
+	let n = e;
+	if (r(n.schema), n.options == null || typeof n.options != "object") throw TypeError(`${t} must include definition options.`);
+	if (a(n.options.label, `${t} label`), typeof n.options.key != "function") throw TypeError(`${t} key must be a function.`);
+	if (n.fields == null || typeof n.fields != "object" || Array.isArray(n.fields)) throw TypeError(`${t} fields must be an object.`);
+}
+function a(e, t) {
+	if (typeof e != "string" || e.trim().length === 0) throw TypeError(`${t} must be a non-empty string.`);
+}
+function o(e, t) {
+	if (e !== void 0 && typeof e != "function") throw TypeError(`${t} must be a function.`);
+}
+//#endregion
+//#region src/diff/historyValue.ts
+function s(e) {
+	return e != null;
+}
+function c(e, t, n) {
+	let r = t == null ? l(e) : t(e, n);
+	if (typeof r != "string") throw TypeError(`History formatter at "${n.path.join(".") || "$root"}" must return a string.`);
+	return {
+		raw: e,
+		formatted: r
+	};
+}
+function l(e) {
+	return typeof e == "string" ? e : typeof e == "number" || typeof e == "boolean" || typeof e == "bigint" ? String(e) : e instanceof Date ? e.toISOString() : p(e);
+}
+function u(e, t) {
+	return Object.is(e, t) ? !0 : typeof e != typeof t || e == null || t == null || typeof e != "object" ? !1 : d(e) === d(t);
+}
+function d(e) {
+	return JSON.stringify(f(e, /* @__PURE__ */ new Set()));
+}
+function f(e, t) {
+	if (e === null) return ["null"];
+	if (e === void 0) return ["undefined"];
+	switch (typeof e) {
+		case "string": return ["string", e];
+		case "boolean": return ["boolean", e];
+		case "bigint": return ["bigint", e.toString()];
+		case "number": return ["number", ee(e)];
+		case "symbol":
+		case "function": throw TypeError(`History values do not support ${typeof e} values.`);
+		case "object": break;
+		default: return ["unknown", String(e)];
+	}
+	if (e instanceof Date) {
+		if (Number.isNaN(e.getTime())) throw TypeError("History values do not support invalid Date values.");
+		return ["date", e.toISOString()];
+	}
+	if (h(e), t.has(e)) throw TypeError("History values must not contain cyclic references.");
+	t.add(e);
+	try {
+		return Array.isArray(e) ? ["array", e.map((e) => f(e, t))] : ["object", Object.entries(e).sort(([e], [t]) => g(e, t)).map(([e, n]) => [e, f(n, t)])];
+	} finally {
+		t.delete(e);
+	}
+}
+function p(e) {
+	return JSON.stringify(m(e, /* @__PURE__ */ new Set()));
+}
+function m(e, t) {
+	if (e == null || typeof e == "string" || typeof e == "boolean") return e;
+	if (typeof e == "number") return Number.isFinite(e) ? e : String(e);
+	if (typeof e == "bigint") return e.toString();
+	if (typeof e == "symbol" || typeof e == "function") throw TypeError(`History values do not support ${typeof e} values.`);
+	if (e instanceof Date) {
+		if (Number.isNaN(e.getTime())) throw TypeError("History values do not support invalid Date values.");
+		return e.toISOString();
+	}
+	if (h(e), t.has(e)) throw TypeError("History values must not contain cyclic references.");
+	t.add(e);
+	try {
+		return Array.isArray(e) ? e.map((e) => m(e, t)) : Object.fromEntries(Object.entries(e).sort(([e], [t]) => g(e, t)).map(([e, n]) => [e, m(n, t)]));
+	} finally {
+		t.delete(e);
+	}
+}
+function ee(e) {
+	return Number.isNaN(e) ? "NaN" : e === Infinity ? "Infinity" : e === -Infinity ? "-Infinity" : Object.is(e, -0) ? "-0" : e;
+}
+function h(e) {
+	if (Array.isArray(e)) return;
+	let t = Object.getPrototypeOf(e);
+	if (t === Object.prototype || t === null) return;
+	let n = e.constructor?.name ?? "unknown";
+	throw TypeError(`History values do not support object type "${n}".`);
+}
+function g(e, t) {
+	return e < t ? -1 : +(e > t);
+}
+//#endregion
+//#region src/diff/createHistoryNodes.ts
+var _ = "Position";
+function v(e, t, n, r = {}) {
+	let i = y(e, b(e, t), b(e, n), [], r);
+	return i == null ? [] : [i];
+}
+function y(e, t, n, r, i = {}, a) {
+	let o = x(e, t, n, r, i);
+	return o.length === 0 && a == null ? null : {
+		type: "group",
+		path: r,
+		label: e.options.label,
+		value: J(e, s(n) ? n : t, r, s(n) ? "current" : "previous"),
+		changeType: a ?? z(o),
+		children: o
+	};
+}
+function b(e, t) {
+	if (s(t)) return e.schema.parse(t);
+}
+function x(e, t, n, r, i) {
+	let a = [], o = [];
+	for (let s of Object.keys(e.fields)) {
+		let c = e.fields[s];
+		if (c === !1) continue;
+		let l = [...r, s], u = S({
+			config: c,
+			previous: G(t, s),
+			current: G(n, s),
+			previousParent: t,
+			currentParent: n,
+			path: l,
+			options: i
+		});
+		if (c.kind === "field") {
+			a.push(...u);
+			continue;
+		}
+		o.push(...u);
+	}
+	return [...R(a), ...R(o)];
+}
+function S(e) {
+	let { config: t } = e;
+	switch (t.kind) {
+		case "field": {
+			let n = te({
+				...e,
+				config: t
+			});
+			return n == null ? [] : [n];
+		}
+		case "array": return D({
+			...e,
+			config: t
+		});
+		case "object": return T({
+			...e,
+			config: t
+		});
+		default: return [];
+	}
+}
+function te(e) {
+	let { config: t, previous: n, current: r, previousParent: i, currentParent: a, path: o, options: s } = e, c = t.resolveChange == null ? W(n, r) : C(t.resolveChange(n, r), o);
+	return c == null ? w({
+		config: t,
+		previous: n,
+		current: r,
+		previousParent: i,
+		currentParent: a,
+		path: o,
+		options: s
+	}) : c === "removed" ? {
+		type: "removed",
+		path: o,
+		label: t.label,
+		previous: K({
+			config: t,
+			value: n,
+			parent: i,
+			side: "previous",
+			path: o,
+			options: s
+		})
+	} : c === "added" ? {
+		type: "added",
+		path: o,
+		label: t.label,
+		current: K({
+			config: t,
+			value: r,
+			parent: a,
+			side: "current",
+			path: o,
+			options: s
+		})
+	} : {
+		type: "updated",
+		path: o,
+		label: t.label,
+		previous: K({
+			config: t,
+			value: n,
+			parent: i,
+			side: "previous",
+			path: o,
+			options: s
+		}),
+		current: K({
+			config: t,
+			value: r,
+			parent: a,
+			side: "current",
+			path: o,
+			options: s
+		})
+	};
+}
+function C(e, t) {
+	if (e === null || e === "added" || e === "removed" || e === "updated") return e;
+	throw TypeError(`History change resolver at "${t.join(".")}" returned unsupported type "${String(e)}".`);
+}
+function w(e) {
+	let { config: t, previous: n, current: r, previousParent: i, currentParent: a, path: o, options: c } = e;
+	if (c.showUnchanged !== !0) return null;
+	let l = s(r) ? r : n;
+	if (!s(l)) return null;
+	let u = s(r) ? a : i, d = s(r) ? "current" : "previous";
+	return {
+		type: "unchanged",
+		path: o,
+		label: t.label,
+		current: K({
+			config: t,
+			value: l,
+			parent: u,
+			side: d,
+			path: o,
+			options: c
+		})
+	};
+}
+function T(e) {
+	let { config: t, previous: n, current: r, path: i, options: a } = e, o = y(t.definition, n, r, i, a, E(n, r));
+	return o == null ? [] : [o];
+}
+function E(e, t) {
+	let n = !s(e), r = !s(t);
+	if (n && !r) return "added";
+	if (!n && r) return "removed";
+}
+function D(e) {
+	let { config: t, previous: n, current: r, previousParent: i, currentParent: a, path: o, options: c } = e, l = Array.isArray(n) ? n : [], u = Array.isArray(r) ? r : [], d = t.mode ?? "set", f = E(n, r), p = d === "ordered" ? k(t, l, u, o, c) : O(t, l, u, o, c);
+	return p.length === 0 && f == null ? [] : [{
+		type: "group",
+		path: o,
+		label: t.label,
+		value: q(t, s(r) ? u : l, s(r) ? a : i, o, s(r) ? "current" : "previous"),
+		changeType: f ?? z(p),
+		children: p
+	}];
+}
+function O(e, t, n, r, i) {
+	let a = I(e, t, r, "previous"), o = I(e, n, r, "current"), s = [], c = [], l = [];
+	for (let [t, n] of o) {
+		let o = a.get(t), l = [...r, t];
+		if (o == null) {
+			s.push(...N(e, n.value, l, i));
+			continue;
+		}
+		c.push(...M({
+			config: e,
+			previous: o.value,
+			current: n.value,
+			path: l,
+			movedRow: null,
+			options: i
+		}));
+	}
+	for (let [t, n] of a) o.has(t) || l.push(...P(e, n.value, [...r, t], i));
+	return R([
+		...s,
+		...c,
+		...l
+	]);
+}
+function k(e, t, n, r, i) {
+	let a = I(e, t, r, "previous"), o = I(e, n, r, "current"), s = new Set(A([...a.keys()].filter((e) => o.has(e)), [...o.keys()].filter((e) => a.has(e)))), c = [], l = [], u = [];
+	for (let [t, n] of o) {
+		let o = a.get(t), u = [...r, t];
+		if (o == null) {
+			c.push(...N(e, n.value, u, i));
+			continue;
+		}
+		let d = s.has(t) ? null : ne(u, o.index, n.index, i);
+		l.push(...M({
+			config: e,
+			previous: o.value,
+			current: n.value,
+			path: u,
+			movedRow: d,
+			options: i
+		}));
+	}
+	for (let [t, n] of a) o.has(t) || u.push(...P(e, n.value, [...r, t], i));
+	return [
+		...R(c),
+		...R(l),
+		...R(u)
+	];
+}
+function A(e, t) {
+	let n = Array.from({ length: e.length + 1 }, () => Array(t.length + 1).fill(0));
+	for (let r = e.length - 1; r >= 0; --r) for (let i = t.length - 1; i >= 0; --i) n[r][i] = j(e[r], t[i]) ? 1 + n[r + 1][i + 1] : Math.max(n[r + 1][i], n[r][i + 1]);
+	let r = [], i = 0, a = 0;
+	for (; i < e.length && a < t.length;) {
+		let o = e[i], s = t[a];
+		if (j(o, s)) {
+			r.push(o), i += 1, a += 1;
+			continue;
+		}
+		n[i + 1][a] > n[i][a + 1] ? i += 1 : a += 1;
+	}
+	return r;
+}
+function j(e, t) {
+	return e === t || typeof e == "number" && typeof t == "number" && Number.isNaN(e) && Number.isNaN(t);
+}
+function M(e) {
+	let { config: t, previous: n, current: r, path: i, movedRow: a, options: o } = e, s = t.item;
+	if (s.kind === "object") {
+		let e = y(s.definition, n, r, i, o);
+		return e == null ? a == null ? [] : [F(s, r, i, a)] : [{
+			...e,
+			children: a == null ? e.children : [a, ...e.children]
+		}];
+	}
+	let c = S({
+		config: s,
+		previous: n,
+		current: r,
+		previousParent: n,
+		currentParent: r,
+		path: i,
+		options: o
+	});
+	return a == null ? c : [a, ...c];
+}
+function N(e, t, n, r) {
+	let i = e.item;
+	if (i.kind === "object") {
+		let e = y(i.definition, void 0, t, n, r, "added");
+		return e == null ? [{
+			type: "added",
+			path: n,
+			label: i.definition.options.label,
+			current: J(i.definition, t, n, "current")
+		}] : [e];
+	}
+	return S({
+		config: i,
+		previous: void 0,
+		current: t,
+		previousParent: void 0,
+		currentParent: t,
+		path: n,
+		options: r
+	});
+}
+function P(e, t, n, r) {
+	let i = e.item;
+	if (i.kind === "object") {
+		let e = y(i.definition, t, void 0, n, r, "removed");
+		return e == null ? [{
+			type: "removed",
+			path: n,
+			label: i.definition.options.label,
+			previous: J(i.definition, t, n, "previous")
+		}] : [e];
+	}
+	return S({
+		config: i,
+		previous: t,
+		current: void 0,
+		previousParent: t,
+		currentParent: void 0,
+		path: n,
+		options: r
+	});
+}
+function F(e, t, n, r) {
+	return {
+		type: "group",
+		path: n,
+		label: e.definition.options.label,
+		value: J(e.definition, t, n, "current"),
+		changeType: "updated",
+		children: [r]
+	};
+}
+function ne(e, t, n, r) {
+	return {
+		type: "moved",
+		path: [...e, "$position"],
+		label: r.positionLabel ?? _,
+		previous: Y(t, String(t + 1)),
+		current: Y(n, String(n + 1))
+	};
+}
+function I(e, t, n, r) {
+	let i = /* @__PURE__ */ new Map();
+	return t.forEach((t, a) => {
+		let o = L(e, t);
+		if (typeof o != "string" && typeof o != "number" || typeof o == "number" && !Number.isFinite(o)) throw TypeError(`History array identity in the ${r} snapshot at "${n.join(".")}" must be a string or finite number.`);
+		if (i.has(o)) throw Error(`Duplicate history array identity "${String(o)}" in the ${r} snapshot at "${n.join(".")}".`);
+		i.set(o, {
+			value: t,
+			index: a
+		});
+	}), i;
+}
+function L(e, t) {
+	let n = e.item;
+	return n.kind === "object" ? n.definition.options.key(t) : typeof t == "string" || typeof t == "number" ? t : d(t);
+}
+function R(e) {
+	return [...e].sort((e, t) => V(e) - V(t));
+}
+function z(e) {
+	return e.some((e) => B(e) !== "unchanged") ? "updated" : "unchanged";
+}
+function B(e) {
+	if (e.type === "group") return e.changeType ?? z(e.children);
+	switch (e.type) {
+		case "added": return "added";
+		case "removed": return "removed";
+		case "updated":
+		case "moved": return "updated";
+		case "unchanged": return "unchanged";
+		default: return "updated";
+	}
+}
+function V(e) {
+	return e.type === "group" && e.changeType != null ? H(e.changeType) : e.type === "group" ? e.children.length === 0 ? 1 : Math.min(...e.children.map(V)) : U(e);
+}
+function H(e) {
+	switch (e) {
+		case "added": return 0;
+		case "updated": return 1;
+		case "removed": return 2;
+		case "unchanged": return 3;
+		default: return 1;
+	}
+}
+function U(e) {
+	switch (e.type) {
+		case "added": return 0;
+		case "updated":
+		case "moved": return 1;
+		case "removed": return 2;
+		case "unchanged": return 3;
+		default: return 1;
+	}
+}
+function W(e, t) {
+	let n = !s(e), r = !s(t);
+	return n && r ? null : n && !r ? "added" : !n && r ? "removed" : u(e, t) ? null : "updated";
+}
+function G(e, t) {
+	if (!(typeof e != "object" || !e)) return e[t];
+}
+function K(e) {
+	let { config: t, value: n, parent: r, side: i, path: a } = e;
+	return c(n, t.format, {
+		parent: r,
+		side: i,
+		path: a
+	});
+}
+function q(e, t, n, r, i) {
+	if (e.format != null) return c(t, e.format, {
+		parent: n,
+		side: i,
+		path: r
+	});
+}
+function J(e, t, n, r) {
+	return e.options.format == null ? Y(t, e.options.label) : c(t, e.options.format, {
+		parent: t,
+		side: r,
+		path: n
+	});
+}
+function Y(e, t) {
+	return {
+		raw: e,
+		formatted: t
+	};
+}
+//#endregion
+//#region src/records/historyRecord.ts
+var X = e.record(e.string(), e.unknown()), Z = e.union([e.number().finite(), e.string().datetime({ offset: !0 })]), Q = e.object({
+	id: e.string().min(1).nullable().optional(),
+	label: e.string().min(1).refine((e) => e.trim().length > 0, "History actor label cannot be blank.")
+});
+function $(t = {}) {
+	let n = t.entityKind ?? e.string().min(1), r = t.snapshot ?? X, i = t.timestamp ?? Z;
+	return e.object({
+		id: e.string().min(1),
+		timestamp: i,
+		actor: Q.nullable(),
+		entity: n,
+		entityId: e.string().min(1),
+		snapshotPrevious: r.nullable(),
+		snapshotCurrent: r.nullable()
+	});
+}
+var re = $();
+//#endregion
+export { Q as HistoryActorSchema, re as HistoryRecordSchema, X as HistorySnapshotSchema, Z as HistoryTimestampSchema, t as createHistoryDefinition, v as createHistoryNodes, $ as createHistoryRecordSchema };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/definitions/createHistoryDefinition.ts","../src/diff/historyValue.ts","../src/diff/createHistoryNodes.ts","../src/records/historyRecord.ts"],"sourcesContent":["import type {\n  HistoryDefinition,\n  HistoryDefinitionFields,\n  HistoryDefinitionOptions,\n  HistoryObjectForSchema,\n} from \"./historyDefinition.types\";\nimport type { z } from \"zod\";\n\nexport function createHistoryDefinition<TSchema extends z.ZodTypeAny>(\n  schema: TSchema,\n  options: HistoryDefinitionOptions<HistoryObjectForSchema<TSchema>>,\n  fields: HistoryDefinitionFields<HistoryObjectForSchema<TSchema>>,\n): HistoryDefinition<HistoryObjectForSchema<TSchema>, TSchema> {\n  assertDefinitionSchema(schema);\n  assertNonEmptyLabel(options?.label, \"History definition label\");\n  if (typeof options?.key !== \"function\") throw new TypeError(\"History definition key must be a function.\");\n  assertOptionalFunction(options.format, \"History definition format\");\n  if (fields == null || typeof fields !== \"object\" || Array.isArray(fields)) {\n    throw new TypeError(\"History definition fields must be an object.\");\n  }\n\n  Object.entries(fields).forEach(([fieldName, config]) => validateFieldConfig(config, `fields.${fieldName}`));\n\n  return { schema, options, fields };\n}\n\nfunction validateFieldConfig(config: unknown, location: string): void {\n  if (config === false) return;\n  if (config == null || typeof config !== \"object\" || Array.isArray(config)) {\n    throw new TypeError(`History ${location} must be false or a field configuration object.`);\n  }\n\n  const record = config as Record<string, unknown>;\n  switch (record.kind) {\n    case \"field\":\n      assertNonEmptyLabel(record.label, `History ${location} label`);\n      assertOptionalFunction(record.format, `History ${location} format`);\n      assertOptionalFunction(record.resolveChange, `History ${location} resolveChange`);\n      return;\n    case \"array\":\n      assertNonEmptyLabel(record.label, `History ${location} label`);\n      assertOptionalFunction(record.format, `History ${location} format`);\n      if (record.mode !== undefined && record.mode !== \"set\" && record.mode !== \"ordered\") {\n        throw new TypeError(`History ${location} mode must be \"set\" or \"ordered\".`);\n      }\n      validateFieldConfig(record.item, `${location}.item`);\n      if (record.item === false) throw new TypeError(`History ${location}.item cannot be ignored.`);\n      return;\n    case \"object\":\n      assertHistoryDefinition(record.definition, `History ${location} definition`);\n      return;\n    default:\n      throw new TypeError(`History ${location} has unsupported kind \"${String(record.kind)}\".`);\n  }\n}\n\nfunction assertDefinitionSchema(schema: unknown): void {\n  if (schema == null || typeof schema !== \"object\" || typeof (schema as { parse?: unknown }).parse !== \"function\") {\n    throw new TypeError(\"History definition schema must be a Zod schema.\");\n  }\n}\n\nfunction assertHistoryDefinition(value: unknown, location: string): void {\n  if (value == null || typeof value !== \"object\") throw new TypeError(`${location} must be a history definition.`);\n  const definition = value as Record<string, unknown>;\n  assertDefinitionSchema(definition.schema);\n  if (definition.options == null || typeof definition.options !== \"object\") {\n    throw new TypeError(`${location} must include definition options.`);\n  }\n  assertNonEmptyLabel((definition.options as Record<string, unknown>).label, `${location} label`);\n  if (typeof (definition.options as Record<string, unknown>).key !== \"function\") {\n    throw new TypeError(`${location} key must be a function.`);\n  }\n  if (definition.fields == null || typeof definition.fields !== \"object\" || Array.isArray(definition.fields)) {\n    throw new TypeError(`${location} fields must be an object.`);\n  }\n}\n\nfunction assertNonEmptyLabel(value: unknown, location: string): asserts value is string {\n  if (typeof value !== \"string\" || value.trim().length === 0)\n    throw new TypeError(`${location} must be a non-empty string.`);\n}\n\nfunction assertOptionalFunction(value: unknown, location: string): void {\n  if (value !== undefined && typeof value !== \"function\") throw new TypeError(`${location} must be a function.`);\n}\n","import type { HistoryFormatContext } from \"../definitions/historyDefinition.types\";\nimport type { HistoryValue } from \"./historyNode.types\";\n\nexport function isHistoryValuePresent(value: unknown): boolean {\n  return value !== null && value !== undefined;\n}\n\nexport function formatHistoryValue<TParent>(\n  raw: unknown,\n  format: ((value: never, context: HistoryFormatContext<TParent>) => string) | undefined,\n  context: HistoryFormatContext<TParent>,\n): HistoryValue {\n  const formatted = format == null ? formatDefaultHistoryValue(raw) : format(raw as never, context);\n\n  if (typeof formatted !== \"string\") {\n    throw new TypeError(`History formatter at \"${context.path.join(\".\") || \"$root\"}\" must return a string.`);\n  }\n\n  return { raw, formatted };\n}\n\nexport function formatDefaultHistoryValue(value: unknown): string {\n  if (typeof value === \"string\") return value;\n  if (typeof value === \"number\" || typeof value === \"boolean\" || typeof value === \"bigint\") return String(value);\n  if (value instanceof Date) return value.toISOString();\n\n  return stringifyHistoryValueForDisplay(value);\n}\n\nexport function areHistoryValuesEqual(previous: unknown, current: unknown): boolean {\n  if (Object.is(previous, current)) return true;\n  if (typeof previous !== typeof current || previous == null || current == null) return false;\n  if (typeof previous !== \"object\") return false;\n\n  return stableStringify(previous) === stableStringify(current);\n}\n\nexport function stableStringify(value: unknown): string {\n  return JSON.stringify(createCanonicalHistoryValue(value, new Set<object>()));\n}\n\ntype CanonicalHistoryValue = readonly [type: string, value?: unknown];\n\nfunction createCanonicalHistoryValue(value: unknown, ancestors: Set<object>): CanonicalHistoryValue {\n  if (value === null) return [\"null\"];\n  if (value === undefined) return [\"undefined\"];\n\n  switch (typeof value) {\n    case \"string\":\n      return [\"string\", value];\n    case \"boolean\":\n      return [\"boolean\", value];\n    case \"bigint\":\n      return [\"bigint\", value.toString()];\n    case \"number\":\n      return [\"number\", serializeNumber(value)];\n    case \"symbol\":\n    case \"function\":\n      throw new TypeError(`History values do not support ${typeof value} values.`);\n    case \"object\":\n      break;\n    default:\n      return [\"unknown\", String(value)];\n  }\n\n  if (value instanceof Date) {\n    if (Number.isNaN(value.getTime())) throw new TypeError(\"History values do not support invalid Date values.\");\n    return [\"date\", value.toISOString()];\n  }\n\n  assertSupportedObject(value);\n  if (ancestors.has(value)) throw new TypeError(\"History values must not contain cyclic references.\");\n\n  ancestors.add(value);\n  try {\n    if (Array.isArray(value)) {\n      return [\"array\", value.map(entry => createCanonicalHistoryValue(entry, ancestors))];\n    }\n\n    return [\n      \"object\",\n      Object.entries(value as Record<string, unknown>)\n        .sort(([leftKey], [rightKey]) => compareKeys(leftKey, rightKey))\n        .map(([key, entryValue]) => [key, createCanonicalHistoryValue(entryValue, ancestors)]),\n    ];\n  } finally {\n    ancestors.delete(value);\n  }\n}\n\nfunction stringifyHistoryValueForDisplay(value: unknown): string {\n  return JSON.stringify(createDisplayHistoryValue(value, new Set<object>()));\n}\n\nfunction createDisplayHistoryValue(value: unknown, ancestors: Set<object>): unknown {\n  if (value == null || typeof value === \"string\" || typeof value === \"boolean\") return value;\n  if (typeof value === \"number\") return Number.isFinite(value) ? value : String(value);\n  if (typeof value === \"bigint\") return value.toString();\n  if (typeof value === \"symbol\" || typeof value === \"function\") {\n    throw new TypeError(`History values do not support ${typeof value} values.`);\n  }\n  if (value instanceof Date) {\n    if (Number.isNaN(value.getTime())) throw new TypeError(\"History values do not support invalid Date values.\");\n    return value.toISOString();\n  }\n\n  assertSupportedObject(value);\n  if (ancestors.has(value)) throw new TypeError(\"History values must not contain cyclic references.\");\n\n  ancestors.add(value);\n  try {\n    if (Array.isArray(value)) return value.map(entry => createDisplayHistoryValue(entry, ancestors));\n\n    return Object.fromEntries(\n      Object.entries(value as Record<string, unknown>)\n        .sort(([leftKey], [rightKey]) => compareKeys(leftKey, rightKey))\n        .map(([key, entryValue]) => [key, createDisplayHistoryValue(entryValue, ancestors)]),\n    );\n  } finally {\n    ancestors.delete(value);\n  }\n}\n\nfunction serializeNumber(value: number): number | string {\n  if (Number.isNaN(value)) return \"NaN\";\n  if (value === Number.POSITIVE_INFINITY) return \"Infinity\";\n  if (value === Number.NEGATIVE_INFINITY) return \"-Infinity\";\n  if (Object.is(value, -0)) return \"-0\";\n  return value;\n}\n\nfunction assertSupportedObject(value: object): void {\n  if (Array.isArray(value)) return;\n  const prototype = Object.getPrototypeOf(value);\n  if (prototype === Object.prototype || prototype === null) return;\n\n  const constructorName = value.constructor?.name ?? \"unknown\";\n  throw new TypeError(`History values do not support object type \"${constructorName}\".`);\n}\n\nfunction compareKeys(left: string, right: string): number {\n  if (left < right) return -1;\n  if (left > right) return 1;\n  return 0;\n}\n","import type {\n  HistoryArrayFieldConfig,\n  HistoryArrayItemConfig,\n  HistoryAtomicFieldConfig,\n  HistoryDefinition,\n  HistoryEntityKey,\n  HistoryFieldConfig,\n  HistoryObjectFieldConfig,\n  HistoryPathSegment,\n} from \"../definitions/historyDefinition.types\";\nimport { areHistoryValuesEqual, formatHistoryValue, isHistoryValuePresent, stableStringify } from \"./historyValue\";\nimport type {\n  HistoryEngineOptions,\n  HistoryFieldRow,\n  HistoryGroupChangeType,\n  HistoryGroupNode,\n  HistoryNode,\n  HistoryValue,\n} from \"./historyNode.types\";\nimport type { z } from \"zod\";\n\nconst DEFAULT_POSITION_LABEL = \"Position\";\n\n// These erased forms are implementation details; consumers use the typed\n// definition/config contracts exported from the package root.\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype InternalHistoryDefinition = HistoryDefinition<any, any>;\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype InternalFieldConfig = HistoryFieldConfig<any, any>;\ntype InternalNonIgnoredFieldConfig = Exclude<InternalFieldConfig, false>;\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype InternalAtomicFieldConfig = HistoryAtomicFieldConfig<any, any>;\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype InternalArrayFieldConfig = HistoryArrayFieldConfig<any, any>;\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype InternalArrayItemConfig = HistoryArrayItemConfig<any>;\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype InternalObjectFieldConfig = HistoryObjectFieldConfig<any>;\n\nexport function createHistoryNodes<TEntity extends object, TSchema extends z.ZodTypeAny>(\n  definition: HistoryDefinition<TEntity, TSchema>,\n  previous: NoInfer<TEntity> | null | undefined,\n  current: NoInfer<TEntity> | null | undefined,\n  options: HistoryEngineOptions = {},\n): HistoryNode[] {\n  const previousParsed = parseOptionalSnapshot(definition, previous);\n  const currentParsed = parseOptionalSnapshot(definition, current);\n\n  const group = createHistoryGroup(definition, previousParsed, currentParsed, [], options);\n\n  return group == null ? [] : [group];\n}\n\nfunction createHistoryGroup(\n  definition: InternalHistoryDefinition,\n  previous: unknown,\n  current: unknown,\n  path: HistoryPathSegment[],\n  options: HistoryEngineOptions = {},\n  changeType?: HistoryGroupChangeType,\n): HistoryGroupNode | null {\n  const children = createFieldNodesForDefinition(definition, previous, current, path, options);\n\n  if (children.length === 0 && changeType == null) {\n    return null;\n  }\n\n  return {\n    type: \"group\",\n    path,\n    label: definition.options.label,\n    value: formatDefinitionValue(\n      definition,\n      isHistoryValuePresent(current) ? current : previous,\n      path,\n      isHistoryValuePresent(current) ? \"current\" : \"previous\",\n    ),\n    changeType: changeType ?? resolveDefaultGroupChangeType(children),\n    children,\n  };\n}\n\nfunction parseOptionalSnapshot(definition: InternalHistoryDefinition, value: unknown): unknown {\n  if (!isHistoryValuePresent(value)) {\n    return undefined;\n  }\n\n  return definition.schema.parse(value);\n}\n\nfunction createFieldNodesForDefinition(\n  definition: InternalHistoryDefinition,\n  previous: unknown,\n  current: unknown,\n  path: HistoryPathSegment[],\n  options: HistoryEngineOptions,\n): HistoryNode[] {\n  const directNodes: HistoryNode[] = [];\n  const nestedNodes: HistoryNode[] = [];\n\n  for (const fieldName of Object.keys(definition.fields)) {\n    const fieldConfig = definition.fields[fieldName] as InternalFieldConfig;\n\n    if (fieldConfig === false) {\n      continue;\n    }\n\n    const fieldPath = [...path, fieldName];\n    const previousValue = getObjectFieldValue(previous, fieldName);\n    const currentValue = getObjectFieldValue(current, fieldName);\n\n    const nodes = createFieldNodes({\n      config: fieldConfig,\n      previous: previousValue,\n      current: currentValue,\n      previousParent: previous,\n      currentParent: current,\n      path: fieldPath,\n      options,\n    });\n\n    if (fieldConfig.kind === \"field\") {\n      directNodes.push(...nodes);\n      continue;\n    }\n\n    nestedNodes.push(...nodes);\n  }\n\n  return [...sortHistoryNodesByChangeType(directNodes), ...sortHistoryNodesByChangeType(nestedNodes)];\n}\n\nfunction createFieldNodes(args: {\n  config: InternalNonIgnoredFieldConfig;\n  previous: unknown;\n  current: unknown;\n  previousParent: unknown;\n  currentParent: unknown;\n  path: HistoryPathSegment[];\n  options: HistoryEngineOptions;\n}): HistoryNode[] {\n  const { config } = args;\n\n  switch (config.kind) {\n    case \"field\": {\n      const row = createAtomicFieldRow({\n        ...args,\n        config,\n      });\n\n      return row == null ? [] : [row];\n    }\n\n    case \"array\": {\n      return createArrayGroup({\n        ...args,\n        config,\n      });\n    }\n\n    case \"object\": {\n      return createObjectGroup({\n        ...args,\n        config,\n      });\n    }\n\n    default: {\n      return [];\n    }\n  }\n}\n\nfunction createAtomicFieldRow(args: {\n  config: InternalAtomicFieldConfig;\n  previous: unknown;\n  current: unknown;\n  previousParent: unknown;\n  currentParent: unknown;\n  path: HistoryPathSegment[];\n  options: HistoryEngineOptions;\n}): HistoryFieldRow | null {\n  const { config, previous, current, previousParent, currentParent, path, options } = args;\n\n  const changeType =\n    config.resolveChange == null\n      ? resolveDefaultFieldChange(previous, current)\n      : validateResolvedChange(config.resolveChange(previous, current), path);\n\n  if (changeType == null) {\n    return createUnchangedFieldRow({\n      config,\n      previous,\n      current,\n      previousParent,\n      currentParent,\n      path,\n      options,\n    });\n  }\n\n  if (changeType === \"removed\") {\n    return {\n      type: \"removed\",\n      path,\n      label: config.label,\n      previous: formatFieldValue({\n        config,\n        value: previous,\n        parent: previousParent,\n        side: \"previous\",\n        path,\n        options,\n      }),\n    };\n  }\n\n  if (changeType === \"added\") {\n    return {\n      type: \"added\",\n      path,\n      label: config.label,\n      current: formatFieldValue({\n        config,\n        value: current,\n        parent: currentParent,\n        side: \"current\",\n        path,\n        options,\n      }),\n    };\n  }\n\n  return {\n    type: \"updated\",\n    path,\n    label: config.label,\n    previous: formatFieldValue({\n      config,\n      value: previous,\n      parent: previousParent,\n      side: \"previous\",\n      path,\n      options,\n    }),\n    current: formatFieldValue({\n      config,\n      value: current,\n      parent: currentParent,\n      side: \"current\",\n      path,\n      options,\n    }),\n  };\n}\n\nfunction validateResolvedChange(\n  value: unknown,\n  path: readonly HistoryPathSegment[],\n): \"added\" | \"removed\" | \"updated\" | null {\n  if (value === null || value === \"added\" || value === \"removed\" || value === \"updated\") return value;\n  throw new TypeError(`History change resolver at \"${path.join(\".\")}\" returned unsupported type \"${String(value)}\".`);\n}\n\nfunction createUnchangedFieldRow(args: {\n  config: InternalAtomicFieldConfig;\n  previous: unknown;\n  current: unknown;\n  previousParent: unknown;\n  currentParent: unknown;\n  path: HistoryPathSegment[];\n  options: HistoryEngineOptions;\n}): HistoryFieldRow | null {\n  const { config, previous, current, previousParent, currentParent, path, options } = args;\n\n  if (options.showUnchanged !== true) {\n    return null;\n  }\n\n  const value = isHistoryValuePresent(current) ? current : previous;\n\n  if (!isHistoryValuePresent(value)) {\n    return null;\n  }\n\n  const parent = isHistoryValuePresent(current) ? currentParent : previousParent;\n  const side = isHistoryValuePresent(current) ? \"current\" : \"previous\";\n\n  return {\n    type: \"unchanged\",\n    path,\n    label: config.label,\n    current: formatFieldValue({\n      config,\n      value,\n      parent,\n      side,\n      path,\n      options,\n    }),\n  };\n}\n\nfunction createObjectGroup(args: {\n  config: InternalObjectFieldConfig;\n  previous: unknown;\n  current: unknown;\n  path: HistoryPathSegment[];\n  options: HistoryEngineOptions;\n}): HistoryNode[] {\n  const { config, previous, current, path, options } = args;\n\n  const group = createHistoryGroup(\n    config.definition,\n    previous,\n    current,\n    path,\n    options,\n    resolveContainerChangeType(previous, current),\n  );\n\n  return group == null ? [] : [group];\n}\n\nfunction resolveContainerChangeType(previous: unknown, current: unknown): HistoryGroupChangeType | undefined {\n  const previousEmpty = !isHistoryValuePresent(previous);\n  const currentEmpty = !isHistoryValuePresent(current);\n\n  if (previousEmpty && !currentEmpty) {\n    return \"added\";\n  }\n\n  if (!previousEmpty && currentEmpty) {\n    return \"removed\";\n  }\n\n  return undefined;\n}\n\nfunction createArrayGroup(args: {\n  config: InternalArrayFieldConfig;\n  previous: unknown;\n  current: unknown;\n  previousParent: unknown;\n  currentParent: unknown;\n  path: HistoryPathSegment[];\n  options: HistoryEngineOptions;\n}): HistoryNode[] {\n  const { config, previous, current, previousParent, currentParent, path, options } = args;\n\n  const previousArray = Array.isArray(previous) ? previous : [];\n  const currentArray = Array.isArray(current) ? current : [];\n\n  const mode = config.mode ?? \"set\";\n  const containerChangeType = resolveContainerChangeType(previous, current);\n\n  const children =\n    mode === \"ordered\"\n      ? createOrderedArrayChildren(config, previousArray, currentArray, path, options)\n      : createSetArrayChildren(config, previousArray, currentArray, path, options);\n\n  if (children.length === 0 && containerChangeType == null) {\n    return [];\n  }\n\n  return [\n    {\n      type: \"group\",\n      path,\n      label: config.label,\n      value: formatArrayValue(\n        config,\n        isHistoryValuePresent(current) ? currentArray : previousArray,\n        isHistoryValuePresent(current) ? currentParent : previousParent,\n        path,\n        isHistoryValuePresent(current) ? \"current\" : \"previous\",\n      ),\n      changeType: containerChangeType ?? resolveDefaultGroupChangeType(children),\n      children,\n    },\n  ];\n}\n\nfunction createSetArrayChildren(\n  config: InternalArrayFieldConfig,\n  previousArray: unknown[],\n  currentArray: unknown[],\n  path: HistoryPathSegment[],\n  options: HistoryEngineOptions,\n): HistoryNode[] {\n  const previousItems = createArrayItemMap(config, previousArray, path, \"previous\");\n  const currentItems = createArrayItemMap(config, currentArray, path, \"current\");\n\n  const addedChildren: HistoryNode[] = [];\n  const updatedChildren: HistoryNode[] = [];\n  const removedChildren: HistoryNode[] = [];\n\n  for (const [key, currentEntry] of currentItems) {\n    const previousEntry = previousItems.get(key);\n    const itemPath = [...path, key];\n\n    if (previousEntry == null) {\n      addedChildren.push(...createAddedArrayItemNodes(config, currentEntry.value, itemPath, options));\n      continue;\n    }\n\n    updatedChildren.push(\n      ...createMatchedArrayItemNodes({\n        config,\n        previous: previousEntry.value,\n        current: currentEntry.value,\n        path: itemPath,\n        movedRow: null,\n        options,\n      }),\n    );\n  }\n\n  for (const [key, previousEntry] of previousItems) {\n    if (currentItems.has(key)) {\n      continue;\n    }\n\n    removedChildren.push(...createRemovedArrayItemNodes(config, previousEntry.value, [...path, key], options));\n  }\n\n  return sortHistoryNodesByChangeType([...addedChildren, ...updatedChildren, ...removedChildren]);\n}\n\nfunction createOrderedArrayChildren(\n  config: InternalArrayFieldConfig,\n  previousArray: unknown[],\n  currentArray: unknown[],\n  path: HistoryPathSegment[],\n  options: HistoryEngineOptions,\n): HistoryNode[] {\n  const previousItems = createArrayItemMap(config, previousArray, path, \"previous\");\n  const currentItems = createArrayItemMap(config, currentArray, path, \"current\");\n  const stableKeys = new Set(\n    findLongestStableKeySequence(\n      [...previousItems.keys()].filter(key => currentItems.has(key)),\n      [...currentItems.keys()].filter(key => previousItems.has(key)),\n    ),\n  );\n\n  const addedChildren: HistoryNode[] = [];\n  const updatedChildren: HistoryNode[] = [];\n  const removedChildren: HistoryNode[] = [];\n\n  for (const [key, currentEntry] of currentItems) {\n    const previousEntry = previousItems.get(key);\n    const itemPath = [...path, key];\n\n    if (previousEntry == null) {\n      addedChildren.push(...createAddedArrayItemNodes(config, currentEntry.value, itemPath, options));\n      continue;\n    }\n\n    const movedRow = stableKeys.has(key)\n      ? null\n      : createMovedRow(itemPath, previousEntry.index, currentEntry.index, options);\n\n    updatedChildren.push(\n      ...createMatchedArrayItemNodes({\n        config,\n        previous: previousEntry.value,\n        current: currentEntry.value,\n        path: itemPath,\n        movedRow,\n        options,\n      }),\n    );\n  }\n\n  for (const [key, previousEntry] of previousItems) {\n    if (currentItems.has(key)) {\n      continue;\n    }\n\n    removedChildren.push(...createRemovedArrayItemNodes(config, previousEntry.value, [...path, key], options));\n  }\n\n  return [\n    ...sortHistoryNodesByChangeType(addedChildren),\n    ...sortHistoryNodesByChangeType(updatedChildren),\n    ...sortHistoryNodesByChangeType(removedChildren),\n  ];\n}\n\nfunction findLongestStableKeySequence(\n  previousKeys: readonly HistoryEntityKey[],\n  currentKeys: readonly HistoryEntityKey[],\n): HistoryEntityKey[] {\n  const lengths = Array.from({ length: previousKeys.length + 1 }, () => Array<number>(currentKeys.length + 1).fill(0));\n\n  for (let previousIndex = previousKeys.length - 1; previousIndex >= 0; previousIndex -= 1) {\n    for (let currentIndex = currentKeys.length - 1; currentIndex >= 0; currentIndex -= 1) {\n      lengths[previousIndex]![currentIndex] = areHistoryKeysEqual(\n        previousKeys[previousIndex],\n        currentKeys[currentIndex],\n      )\n        ? 1 + lengths[previousIndex + 1]![currentIndex + 1]!\n        : Math.max(lengths[previousIndex + 1]![currentIndex]!, lengths[previousIndex]![currentIndex + 1]!);\n    }\n  }\n\n  const stableKeys: HistoryEntityKey[] = [];\n  let previousIndex = 0;\n  let currentIndex = 0;\n\n  while (previousIndex < previousKeys.length && currentIndex < currentKeys.length) {\n    const previousKey = previousKeys[previousIndex]!;\n    const currentKey = currentKeys[currentIndex]!;\n\n    if (areHistoryKeysEqual(previousKey, currentKey)) {\n      stableKeys.push(previousKey);\n      previousIndex += 1;\n      currentIndex += 1;\n      continue;\n    }\n\n    const skipPreviousLength = lengths[previousIndex + 1]![currentIndex]!;\n    const skipCurrentLength = lengths[previousIndex]![currentIndex + 1]!;\n    if (skipPreviousLength > skipCurrentLength) {\n      previousIndex += 1;\n    } else {\n      currentIndex += 1;\n    }\n  }\n\n  return stableKeys;\n}\n\nfunction areHistoryKeysEqual(left: HistoryEntityKey | undefined, right: HistoryEntityKey | undefined): boolean {\n  return (\n    left === right ||\n    (typeof left === \"number\" && typeof right === \"number\" && Number.isNaN(left) && Number.isNaN(right))\n  );\n}\n\nfunction createMatchedArrayItemNodes(args: {\n  config: InternalArrayFieldConfig;\n  previous: unknown;\n  current: unknown;\n  path: HistoryPathSegment[];\n  movedRow: HistoryFieldRow | null;\n  options: HistoryEngineOptions;\n}): HistoryNode[] {\n  const { config, previous, current, path, movedRow, options } = args;\n  const item = config.item as InternalArrayItemConfig;\n\n  if (item.kind === \"object\") {\n    const group = createHistoryGroup(item.definition, previous, current, path, options);\n\n    if (group == null) {\n      return movedRow == null ? [] : [createMovedOnlyGroup(item, current, path, movedRow)];\n    }\n\n    return [\n      {\n        ...group,\n        children: movedRow == null ? group.children : [movedRow, ...group.children],\n      },\n    ];\n  }\n\n  const nodes = createFieldNodes({\n    config: item,\n    previous,\n    current,\n    previousParent: previous,\n    currentParent: current,\n    path,\n    options,\n  });\n\n  return movedRow == null ? nodes : [movedRow, ...nodes];\n}\n\nfunction createAddedArrayItemNodes(\n  config: InternalArrayFieldConfig,\n  current: unknown,\n  path: HistoryPathSegment[],\n  options: HistoryEngineOptions,\n): HistoryNode[] {\n  const item = config.item as InternalArrayItemConfig;\n\n  if (item.kind === \"object\") {\n    const group = createHistoryGroup(item.definition, undefined, current, path, options, \"added\");\n\n    return group == null\n      ? [\n          {\n            type: \"added\",\n            path,\n            label: item.definition.options.label,\n            current: formatDefinitionValue(item.definition, current, path, \"current\"),\n          },\n        ]\n      : [group];\n  }\n\n  return createFieldNodes({\n    config: item,\n    previous: undefined,\n    current,\n    previousParent: undefined,\n    currentParent: current,\n    path,\n    options,\n  });\n}\n\nfunction createRemovedArrayItemNodes(\n  config: InternalArrayFieldConfig,\n  previous: unknown,\n  path: HistoryPathSegment[],\n  options: HistoryEngineOptions,\n): HistoryNode[] {\n  const item = config.item as InternalArrayItemConfig;\n\n  if (item.kind === \"object\") {\n    const group = createHistoryGroup(item.definition, previous, undefined, path, options, \"removed\");\n\n    return group == null\n      ? [\n          {\n            type: \"removed\",\n            path,\n            label: item.definition.options.label,\n            previous: formatDefinitionValue(item.definition, previous, path, \"previous\"),\n          },\n        ]\n      : [group];\n  }\n\n  return createFieldNodes({\n    config: item,\n    previous,\n    current: undefined,\n    previousParent: previous,\n    currentParent: undefined,\n    path,\n    options,\n  });\n}\n\nfunction createMovedOnlyGroup(\n  item: Extract<InternalArrayItemConfig, { kind: \"object\" }>,\n  current: unknown,\n  path: HistoryPathSegment[],\n  movedRow: HistoryFieldRow,\n): HistoryGroupNode {\n  return {\n    type: \"group\",\n    path,\n    label: item.definition.options.label,\n    value: formatDefinitionValue(item.definition, current, path, \"current\"),\n    changeType: \"updated\",\n    children: [movedRow],\n  };\n}\n\nfunction createMovedRow(\n  path: HistoryPathSegment[],\n  previousIndex: number,\n  currentIndex: number,\n  options: HistoryEngineOptions,\n): HistoryFieldRow {\n  return {\n    type: \"moved\",\n    path: [...path, \"$position\"],\n    label: options.positionLabel ?? DEFAULT_POSITION_LABEL,\n    previous: createHistoryValue(previousIndex, String(previousIndex + 1)),\n    current: createHistoryValue(currentIndex, String(currentIndex + 1)),\n  };\n}\n\nfunction createArrayItemMap(\n  config: InternalArrayFieldConfig,\n  array: unknown[],\n  path: readonly HistoryPathSegment[],\n  side: \"previous\" | \"current\",\n): Map<HistoryEntityKey, { value: unknown; index: number }> {\n  const map = new Map<HistoryEntityKey, { value: unknown; index: number }>();\n\n  array.forEach((value, index) => {\n    const key = createArrayItemKey(config, value);\n    if ((typeof key !== \"string\" && typeof key !== \"number\") || (typeof key === \"number\" && !Number.isFinite(key))) {\n      throw new TypeError(\n        `History array identity in the ${side} snapshot at \"${path.join(\".\")}\" must be a string or finite number.`,\n      );\n    }\n    if (map.has(key)) {\n      throw new Error(\n        `Duplicate history array identity \"${String(key)}\" in the ${side} snapshot at \"${path.join(\".\")}\".`,\n      );\n    }\n    map.set(key, { value, index });\n  });\n\n  return map;\n}\n\nfunction createArrayItemKey(config: InternalArrayFieldConfig, value: unknown): HistoryEntityKey {\n  const item = config.item as InternalArrayItemConfig;\n\n  if (item.kind === \"object\") {\n    return item.definition.options.key(value);\n  }\n\n  if (typeof value === \"string\" || typeof value === \"number\") {\n    return value;\n  }\n\n  return stableStringify(value);\n}\n\nfunction sortHistoryNodesByChangeType(nodes: HistoryNode[]): HistoryNode[] {\n  return [...nodes].sort((left, right) => getHistoryNodeChangeOrder(left) - getHistoryNodeChangeOrder(right));\n}\n\nfunction resolveDefaultGroupChangeType(children: HistoryNode[]): HistoryGroupChangeType {\n  const hasChangedChild = children.some(child => getHistoryNodeChangeType(child) !== \"unchanged\");\n\n  return hasChangedChild ? \"updated\" : \"unchanged\";\n}\n\nfunction getHistoryNodeChangeType(node: HistoryNode): HistoryGroupChangeType {\n  if (node.type === \"group\") {\n    return node.changeType ?? resolveDefaultGroupChangeType(node.children);\n  }\n\n  switch (node.type) {\n    case \"added\":\n      return \"added\";\n\n    case \"removed\":\n      return \"removed\";\n\n    case \"updated\":\n    case \"moved\":\n      return \"updated\";\n\n    case \"unchanged\":\n      return \"unchanged\";\n\n    default:\n      return \"updated\";\n  }\n}\n\nfunction getHistoryNodeChangeOrder(node: HistoryNode): number {\n  if (node.type === \"group\" && node.changeType != null) {\n    return getHistoryChangeOrder(node.changeType);\n  }\n\n  if (node.type !== \"group\") {\n    return getHistoryFieldRowChangeOrder(node);\n  }\n\n  if (node.children.length === 0) {\n    return 1;\n  }\n\n  return Math.min(...node.children.map(getHistoryNodeChangeOrder));\n}\n\nfunction getHistoryChangeOrder(changeType: HistoryGroupChangeType): number {\n  switch (changeType) {\n    case \"added\":\n      return 0;\n\n    case \"updated\":\n      return 1;\n\n    case \"removed\":\n      return 2;\n\n    case \"unchanged\":\n      return 3;\n\n    default:\n      return 1;\n  }\n}\n\nfunction getHistoryFieldRowChangeOrder(row: HistoryFieldRow): number {\n  switch (row.type) {\n    case \"added\":\n      return 0;\n\n    case \"updated\":\n    case \"moved\":\n      return 1;\n\n    case \"removed\":\n      return 2;\n\n    case \"unchanged\":\n      return 3;\n\n    default:\n      return 1;\n  }\n}\n\nfunction resolveDefaultFieldChange(previous: unknown, current: unknown): \"added\" | \"removed\" | \"updated\" | null {\n  const previousEmpty = !isHistoryValuePresent(previous);\n  const currentEmpty = !isHistoryValuePresent(current);\n\n  if (previousEmpty && currentEmpty) {\n    return null;\n  }\n\n  if (previousEmpty && !currentEmpty) {\n    return \"added\";\n  }\n\n  if (!previousEmpty && currentEmpty) {\n    return \"removed\";\n  }\n\n  if (areHistoryValuesEqual(previous, current)) {\n    return null;\n  }\n\n  return \"updated\";\n}\n\nfunction getObjectFieldValue(value: unknown, fieldName: string): unknown {\n  if (value == null || typeof value !== \"object\") return undefined;\n  return (value as Record<string, unknown>)[fieldName];\n}\n\nfunction formatFieldValue(args: {\n  config: InternalAtomicFieldConfig;\n  value: unknown;\n  parent: unknown;\n  side: \"previous\" | \"current\";\n  path: HistoryPathSegment[];\n  options: HistoryEngineOptions;\n}): HistoryValue {\n  const { config, value, parent, side, path } = args;\n  return formatHistoryValue(value, config.format, { parent, side, path });\n}\n\nfunction formatArrayValue(\n  config: InternalArrayFieldConfig,\n  value: unknown[],\n  parent: unknown,\n  path: HistoryPathSegment[],\n  side: \"previous\" | \"current\",\n): HistoryValue | undefined {\n  if (config.format == null) return undefined;\n  return formatHistoryValue(value, config.format, { parent, side, path });\n}\n\nfunction formatDefinitionValue(\n  definition: InternalHistoryDefinition,\n  value: unknown,\n  path: HistoryPathSegment[],\n  side: \"previous\" | \"current\",\n): HistoryValue {\n  if (definition.options.format == null) {\n    return createHistoryValue(value, definition.options.label);\n  }\n\n  return formatHistoryValue(value, definition.options.format, { parent: value, side, path });\n}\n\nfunction createHistoryValue(raw: unknown, formatted: string): HistoryValue {\n  return { raw, formatted };\n}\n","import { z } from \"zod\";\n\nexport type HistoryEntityKind = string;\nexport type HistoryTimestamp = number | string;\n\nexport const HistorySnapshotSchema = z.record(z.string(), z.unknown());\nexport type HistorySnapshot = z.infer<typeof HistorySnapshotSchema>;\n\nexport const HistoryTimestampSchema = z.union([z.number().finite(), z.string().datetime({ offset: true })]);\n\nexport const HistoryActorSchema = z.object({\n  id: z.string().min(1).nullable().optional(),\n  label: z\n    .string()\n    .min(1)\n    .refine(label => label.trim().length > 0, \"History actor label cannot be blank.\"),\n});\nexport type HistoryActor = z.infer<typeof HistoryActorSchema>;\n\nexport interface HistoryRecord<\n  TSnapshot extends HistorySnapshot = HistorySnapshot,\n  TEntityKind extends HistoryEntityKind = HistoryEntityKind,\n  TTimestamp extends HistoryTimestamp = HistoryTimestamp,\n> {\n  id: string;\n  timestamp: TTimestamp;\n  actor: HistoryActor | null;\n  entity: TEntityKind;\n  entityId: string;\n  snapshotPrevious: TSnapshot | null;\n  snapshotCurrent: TSnapshot | null;\n}\n\nexport type HistoryRecordSchemaOptions<\n  TEntityKind extends HistoryEntityKind = HistoryEntityKind,\n  TSnapshot extends HistorySnapshot = HistorySnapshot,\n  TTimestamp extends HistoryTimestamp = HistoryTimestamp,\n> = {\n  entityKind?: z.ZodType<TEntityKind>;\n  snapshot?: z.ZodType<TSnapshot>;\n  timestamp?: z.ZodType<TTimestamp>;\n};\n\nexport function createHistoryRecordSchema<\n  TEntityKind extends HistoryEntityKind = HistoryEntityKind,\n  TSnapshot extends HistorySnapshot = HistorySnapshot,\n  TTimestamp extends HistoryTimestamp = HistoryTimestamp,\n>(\n  options: HistoryRecordSchemaOptions<TEntityKind, TSnapshot, TTimestamp> = {},\n): z.ZodType<HistoryRecord<TSnapshot, TEntityKind, TTimestamp>> {\n  const entityKindSchema = options.entityKind ?? (z.string().min(1) as unknown as z.ZodType<TEntityKind>);\n  const snapshotSchema = options.snapshot ?? (HistorySnapshotSchema as z.ZodType<TSnapshot>);\n  const timestampSchema = options.timestamp ?? (HistoryTimestampSchema as unknown as z.ZodType<TTimestamp>);\n\n  return z.object({\n    id: z.string().min(1),\n    timestamp: timestampSchema,\n    actor: HistoryActorSchema.nullable(),\n    entity: entityKindSchema,\n    entityId: z.string().min(1),\n    snapshotPrevious: snapshotSchema.nullable(),\n    snapshotCurrent: snapshotSchema.nullable(),\n  }) as z.ZodType<HistoryRecord<TSnapshot, TEntityKind, TTimestamp>>;\n}\n\nexport const HistoryRecordSchema = createHistoryRecordSchema();\n"],"mappings":";;AAQA,SAAgB,EACd,GACA,GACA,GAC6D;CAG7D,IAFA,EAAuB,CAAM,GAC7B,EAAoB,GAAS,OAAO,0BAA0B,GAC1D,OAAO,GAAS,OAAQ,YAAY,MAAU,UAAU,4CAA4C;CAExG,IADA,EAAuB,EAAQ,QAAQ,2BAA2B,GAC5C,OAAO,KAAW,aAApC,KAAgD,MAAM,QAAQ,CAAM,GACtE,MAAU,UAAU,8CAA8C;CAKpE,OAFA,OAAO,QAAQ,CAAM,CAAC,CAAC,SAAS,CAAC,GAAW,OAAY,EAAoB,GAAQ,UAAU,GAAW,CAAC,GAEnG;EAAE;EAAQ;EAAS;CAAO;AACnC;AAEA,SAAS,EAAoB,GAAiB,GAAwB;CACpE,IAAI,MAAW,IAAO;CACtB,IAAsB,OAAO,KAAW,aAApC,KAAgD,MAAM,QAAQ,CAAM,GACtE,MAAU,UAAU,WAAW,EAAS,gDAAgD;CAG1F,IAAM,IAAS;CACf,QAAQ,EAAO,MAAf;EACE,KAAK;GAGH,AAFA,EAAoB,EAAO,OAAO,WAAW,EAAS,OAAO,GAC7D,EAAuB,EAAO,QAAQ,WAAW,EAAS,QAAQ,GAClE,EAAuB,EAAO,eAAe,WAAW,EAAS,eAAe;GAChF;EACF,KAAK;GAGH,IAFA,EAAoB,EAAO,OAAO,WAAW,EAAS,OAAO,GAC7D,EAAuB,EAAO,QAAQ,WAAW,EAAS,QAAQ,GAC9D,EAAO,SAAS,KAAA,KAAa,EAAO,SAAS,SAAS,EAAO,SAAS,WACxE,MAAU,UAAU,WAAW,EAAS,kCAAkC;GAG5E,IADA,EAAoB,EAAO,MAAM,GAAG,EAAS,MAAM,GAC/C,EAAO,SAAS,IAAO,MAAU,UAAU,WAAW,EAAS,yBAAyB;GAC5F;EACF,KAAK;GACH,EAAwB,EAAO,YAAY,WAAW,EAAS,YAAY;GAC3E;EACF,SACE,MAAU,UAAU,WAAW,EAAS,yBAAyB,OAAO,EAAO,IAAI,EAAE,GAAG;CAC5F;AACF;AAEA,SAAS,EAAuB,GAAuB;CACrD,IAAsB,OAAO,KAAW,aAApC,KAAgD,OAAQ,EAA+B,SAAU,YACnG,MAAU,UAAU,iDAAiD;AAEzE;AAEA,SAAS,EAAwB,GAAgB,GAAwB;CACvE,IAAqB,OAAO,KAAU,aAAlC,GAA4C,MAAU,UAAU,GAAG,EAAS,+BAA+B;CAC/G,IAAM,IAAa;CAEnB,IADA,EAAuB,EAAW,MAAM,GACpC,EAAW,WAAW,QAAQ,OAAO,EAAW,WAAY,UAC9D,MAAU,UAAU,GAAG,EAAS,kCAAkC;CAGpE,IADA,EAAqB,EAAW,QAAoC,OAAO,GAAG,EAAS,OAAO,GAC1F,OAAQ,EAAW,QAAoC,OAAQ,YACjE,MAAU,UAAU,GAAG,EAAS,yBAAyB;CAE3D,IAAI,EAAW,UAAU,QAAQ,OAAO,EAAW,UAAW,YAAY,MAAM,QAAQ,EAAW,MAAM,GACvG,MAAU,UAAU,GAAG,EAAS,2BAA2B;AAE/D;AAEA,SAAS,EAAoB,GAAgB,GAA2C;CACtF,IAAI,OAAO,KAAU,YAAY,EAAM,KAAK,CAAC,CAAC,WAAW,GACvD,MAAU,UAAU,GAAG,EAAS,6BAA6B;AACjE;AAEA,SAAS,EAAuB,GAAgB,GAAwB;CACtE,IAAI,MAAU,KAAA,KAAa,OAAO,KAAU,YAAY,MAAU,UAAU,GAAG,EAAS,qBAAqB;AAC/G;;;AClFA,SAAgB,EAAsB,GAAyB;CAC7D,OAAO,KAAU;AACnB;AAEA,SAAgB,EACd,GACA,GACA,GACc;CACd,IAAM,IAAY,KAAU,OAAO,EAA0B,CAAG,IAAI,EAAO,GAAc,CAAO;CAEhG,IAAI,OAAO,KAAc,UACvB,MAAU,UAAU,yBAAyB,EAAQ,KAAK,KAAK,GAAG,KAAK,QAAQ,wBAAwB;CAGzG,OAAO;EAAE;EAAK;CAAU;AAC1B;AAEA,SAAgB,EAA0B,GAAwB;CAKhE,OAJI,OAAO,KAAU,WAAiB,IAClC,OAAO,KAAU,YAAY,OAAO,KAAU,aAAa,OAAO,KAAU,WAAiB,OAAO,CAAK,IACzG,aAAiB,OAAa,EAAM,YAAY,IAE7C,EAAgC,CAAK;AAC9C;AAEA,SAAgB,EAAsB,GAAmB,GAA2B;CAKlF,OAJI,OAAO,GAAG,GAAU,CAAO,IAAU,KACrC,OAAO,KAAa,OAAO,KAAW,KAAY,QAAQ,KAAW,QACrE,OAAO,KAAa,WAAiB,KAElC,EAAgB,CAAQ,MAAM,EAAgB,CAAO;AAC9D;AAEA,SAAgB,EAAgB,GAAwB;CACtD,OAAO,KAAK,UAAU,EAA4B,mBAAO,IAAI,IAAY,CAAC,CAAC;AAC7E;AAIA,SAAS,EAA4B,GAAgB,GAA+C;CAClG,IAAI,MAAU,MAAM,OAAO,CAAC,MAAM;CAClC,IAAI,MAAU,KAAA,GAAW,OAAO,CAAC,WAAW;CAE5C,QAAQ,OAAO,GAAf;EACE,KAAK,UACH,OAAO,CAAC,UAAU,CAAK;EACzB,KAAK,WACH,OAAO,CAAC,WAAW,CAAK;EAC1B,KAAK,UACH,OAAO,CAAC,UAAU,EAAM,SAAS,CAAC;EACpC,KAAK,UACH,OAAO,CAAC,UAAU,GAAgB,CAAK,CAAC;EAC1C,KAAK;EACL,KAAK,YACH,MAAU,UAAU,iCAAiC,OAAO,EAAM,SAAS;EAC7E,KAAK,UACH;EACF,SACE,OAAO,CAAC,WAAW,OAAO,CAAK,CAAC;CACpC;CAEA,IAAI,aAAiB,MAAM;EACzB,IAAI,OAAO,MAAM,EAAM,QAAQ,CAAC,GAAG,MAAU,UAAU,oDAAoD;EAC3G,OAAO,CAAC,QAAQ,EAAM,YAAY,CAAC;CACrC;CAGA,IADA,EAAsB,CAAK,GACvB,EAAU,IAAI,CAAK,GAAG,MAAU,UAAU,oDAAoD;CAElG,EAAU,IAAI,CAAK;CACnB,IAAI;EAKF,OAJI,MAAM,QAAQ,CAAK,IACd,CAAC,SAAS,EAAM,KAAI,MAAS,EAA4B,GAAO,CAAS,CAAC,CAAC,IAG7E,CACL,UACA,OAAO,QAAQ,CAAgC,CAAC,CAC7C,MAAM,CAAC,IAAU,CAAC,OAAc,EAAY,GAAS,CAAQ,CAAC,CAAC,CAC/D,KAAK,CAAC,GAAK,OAAgB,CAAC,GAAK,EAA4B,GAAY,CAAS,CAAC,CAAC,CACzF;CACF,UAAU;EACR,EAAU,OAAO,CAAK;CACxB;AACF;AAEA,SAAS,EAAgC,GAAwB;CAC/D,OAAO,KAAK,UAAU,EAA0B,mBAAO,IAAI,IAAY,CAAC,CAAC;AAC3E;AAEA,SAAS,EAA0B,GAAgB,GAAiC;CAClF,IAAI,KAAS,QAAQ,OAAO,KAAU,YAAY,OAAO,KAAU,WAAW,OAAO;CACrF,IAAI,OAAO,KAAU,UAAU,OAAO,OAAO,SAAS,CAAK,IAAI,IAAQ,OAAO,CAAK;CACnF,IAAI,OAAO,KAAU,UAAU,OAAO,EAAM,SAAS;CACrD,IAAI,OAAO,KAAU,YAAY,OAAO,KAAU,YAChD,MAAU,UAAU,iCAAiC,OAAO,EAAM,SAAS;CAE7E,IAAI,aAAiB,MAAM;EACzB,IAAI,OAAO,MAAM,EAAM,QAAQ,CAAC,GAAG,MAAU,UAAU,oDAAoD;EAC3G,OAAO,EAAM,YAAY;CAC3B;CAGA,IADA,EAAsB,CAAK,GACvB,EAAU,IAAI,CAAK,GAAG,MAAU,UAAU,oDAAoD;CAElG,EAAU,IAAI,CAAK;CACnB,IAAI;EAGF,OAFI,MAAM,QAAQ,CAAK,IAAU,EAAM,KAAI,MAAS,EAA0B,GAAO,CAAS,CAAC,IAExF,OAAO,YACZ,OAAO,QAAQ,CAAgC,CAAC,CAC7C,MAAM,CAAC,IAAU,CAAC,OAAc,EAAY,GAAS,CAAQ,CAAC,CAAC,CAC/D,KAAK,CAAC,GAAK,OAAgB,CAAC,GAAK,EAA0B,GAAY,CAAS,CAAC,CAAC,CACvF;CACF,UAAU;EACR,EAAU,OAAO,CAAK;CACxB;AACF;AAEA,SAAS,GAAgB,GAAgC;CAKvD,OAJI,OAAO,MAAM,CAAK,IAAU,QAC5B,MAAU,WAAiC,aAC3C,MAAU,YAAiC,cAC3C,OAAO,GAAG,GAAO,EAAE,IAAU,OAC1B;AACT;AAEA,SAAS,EAAsB,GAAqB;CAClD,IAAI,MAAM,QAAQ,CAAK,GAAG;CAC1B,IAAM,IAAY,OAAO,eAAe,CAAK;CAC7C,IAAI,MAAc,OAAO,aAAa,MAAc,MAAM;CAE1D,IAAM,IAAkB,EAAM,aAAa,QAAQ;CACnD,MAAU,UAAU,8CAA8C,EAAgB,GAAG;AACvF;AAEA,SAAS,EAAY,GAAc,GAAuB;CAGxD,OAFI,IAAO,IAAc,KACzB,EAAI,IAAO;AAEb;;;AC3HA,IAAM,IAAyB;AAkB/B,SAAgB,EACd,GACA,GACA,GACA,IAAgC,CAAC,GAClB;CAIf,IAAM,IAAQ,EAAmB,GAHV,EAAsB,GAAY,CAGZ,GAFvB,EAAsB,GAAY,CAEK,GAAe,CAAC,GAAG,CAAO;CAEvF,OAAO,KAAS,OAAO,CAAC,IAAI,CAAC,CAAK;AACpC;AAEA,SAAS,EACP,GACA,GACA,GACA,GACA,IAAgC,CAAC,GACjC,GACyB;CACzB,IAAM,IAAW,EAA8B,GAAY,GAAU,GAAS,GAAM,CAAO;CAM3F,OAJI,EAAS,WAAW,KAAK,KAAc,OAClC,OAGF;EACL,MAAM;EACN;EACA,OAAO,EAAW,QAAQ;EAC1B,OAAO,EACL,GACA,EAAsB,CAAO,IAAI,IAAU,GAC3C,GACA,EAAsB,CAAO,IAAI,YAAY,UAC/C;EACA,YAAY,KAAc,EAA8B,CAAQ;EAChE;CACF;AACF;AAEA,SAAS,EAAsB,GAAuC,GAAyB;CACxF,MAAsB,CAAK,GAIhC,OAAO,EAAW,OAAO,MAAM,CAAK;AACtC;AAEA,SAAS,EACP,GACA,GACA,GACA,GACA,GACe;CACf,IAAM,IAA6B,CAAC,GAC9B,IAA6B,CAAC;CAEpC,KAAK,IAAM,KAAa,OAAO,KAAK,EAAW,MAAM,GAAG;EACtD,IAAM,IAAc,EAAW,OAAO;EAEtC,IAAI,MAAgB,IAClB;EAGF,IAAM,IAAY,CAAC,GAAG,GAAM,CAAS,GAI/B,IAAQ,EAAiB;GAC7B,QAAQ;GACR,UALoB,EAAoB,GAAU,CAKxC;GACV,SALmB,EAAoB,GAAS,CAKvC;GACT,gBAAgB;GAChB,eAAe;GACf,MAAM;GACN;EACF,CAAC;EAED,IAAI,EAAY,SAAS,SAAS;GAChC,EAAY,KAAK,GAAG,CAAK;GACzB;EACF;EAEA,EAAY,KAAK,GAAG,CAAK;CAC3B;CAEA,OAAO,CAAC,GAAG,EAA6B,CAAW,GAAG,GAAG,EAA6B,CAAW,CAAC;AACpG;AAEA,SAAS,EAAiB,GAQR;CAChB,IAAM,EAAE,cAAW;CAEnB,QAAQ,EAAO,MAAf;EACE,KAAK,SAAS;GACZ,IAAM,IAAM,GAAqB;IAC/B,GAAG;IACH;GACF,CAAC;GAED,OAAO,KAAO,OAAO,CAAC,IAAI,CAAC,CAAG;EAChC;EAEA,KAAK,SACH,OAAO,EAAiB;GACtB,GAAG;GACH;EACF,CAAC;EAGH,KAAK,UACH,OAAO,EAAkB;GACvB,GAAG;GACH;EACF,CAAC;EAGH,SACE,OAAO,CAAC;CAEZ;AACF;AAEA,SAAS,GAAqB,GAQH;CACzB,IAAM,EAAE,WAAQ,aAAU,YAAS,mBAAgB,kBAAe,SAAM,eAAY,GAE9E,IACJ,EAAO,iBAAiB,OACpB,EAA0B,GAAU,CAAO,IAC3C,EAAuB,EAAO,cAAc,GAAU,CAAO,GAAG,CAAI;CA8C1E,OA5CI,KAAc,OACT,EAAwB;EAC7B;EACA;EACA;EACA;EACA;EACA;EACA;CACF,CAAC,IAGC,MAAe,YACV;EACL,MAAM;EACN;EACA,OAAO,EAAO;EACd,UAAU,EAAiB;GACzB;GACA,OAAO;GACP,QAAQ;GACR,MAAM;GACN;GACA;EACF,CAAC;CACH,IAGE,MAAe,UACV;EACL,MAAM;EACN;EACA,OAAO,EAAO;EACd,SAAS,EAAiB;GACxB;GACA,OAAO;GACP,QAAQ;GACR,MAAM;GACN;GACA;EACF,CAAC;CACH,IAGK;EACL,MAAM;EACN;EACA,OAAO,EAAO;EACd,UAAU,EAAiB;GACzB;GACA,OAAO;GACP,QAAQ;GACR,MAAM;GACN;GACA;EACF,CAAC;EACD,SAAS,EAAiB;GACxB;GACA,OAAO;GACP,QAAQ;GACR,MAAM;GACN;GACA;EACF,CAAC;CACH;AACF;AAEA,SAAS,EACP,GACA,GACwC;CACxC,IAAI,MAAU,QAAQ,MAAU,WAAW,MAAU,aAAa,MAAU,WAAW,OAAO;CAC9F,MAAU,UAAU,+BAA+B,EAAK,KAAK,GAAG,EAAE,+BAA+B,OAAO,CAAK,EAAE,GAAG;AACpH;AAEA,SAAS,EAAwB,GAQN;CACzB,IAAM,EAAE,WAAQ,aAAU,YAAS,mBAAgB,kBAAe,SAAM,eAAY;CAEpF,IAAI,EAAQ,kBAAkB,IAC5B,OAAO;CAGT,IAAM,IAAQ,EAAsB,CAAO,IAAI,IAAU;CAEzD,IAAI,CAAC,EAAsB,CAAK,GAC9B,OAAO;CAGT,IAAM,IAAS,EAAsB,CAAO,IAAI,IAAgB,GAC1D,IAAO,EAAsB,CAAO,IAAI,YAAY;CAE1D,OAAO;EACL,MAAM;EACN;EACA,OAAO,EAAO;EACd,SAAS,EAAiB;GACxB;GACA;GACA;GACA;GACA;GACA;EACF,CAAC;CACH;AACF;AAEA,SAAS,EAAkB,GAMT;CAChB,IAAM,EAAE,WAAQ,aAAU,YAAS,SAAM,eAAY,GAE/C,IAAQ,EACZ,EAAO,YACP,GACA,GACA,GACA,GACA,EAA2B,GAAU,CAAO,CAC9C;CAEA,OAAO,KAAS,OAAO,CAAC,IAAI,CAAC,CAAK;AACpC;AAEA,SAAS,EAA2B,GAAmB,GAAsD;CAC3G,IAAM,IAAgB,CAAC,EAAsB,CAAQ,GAC/C,IAAe,CAAC,EAAsB,CAAO;CAEnD,IAAI,KAAiB,CAAC,GACpB,OAAO;CAGT,IAAI,CAAC,KAAiB,GACpB,OAAO;AAIX;AAEA,SAAS,EAAiB,GAQR;CAChB,IAAM,EAAE,WAAQ,aAAU,YAAS,mBAAgB,kBAAe,SAAM,eAAY,GAE9E,IAAgB,MAAM,QAAQ,CAAQ,IAAI,IAAW,CAAC,GACtD,IAAe,MAAM,QAAQ,CAAO,IAAI,IAAU,CAAC,GAEnD,IAAO,EAAO,QAAQ,OACtB,IAAsB,EAA2B,GAAU,CAAO,GAElE,IACJ,MAAS,YACL,EAA2B,GAAQ,GAAe,GAAc,GAAM,CAAO,IAC7E,EAAuB,GAAQ,GAAe,GAAc,GAAM,CAAO;CAM/E,OAJI,EAAS,WAAW,KAAK,KAAuB,OAC3C,CAAC,IAGH,CACL;EACE,MAAM;EACN;EACA,OAAO,EAAO;EACd,OAAO,EACL,GACA,EAAsB,CAAO,IAAI,IAAe,GAChD,EAAsB,CAAO,IAAI,IAAgB,GACjD,GACA,EAAsB,CAAO,IAAI,YAAY,UAC/C;EACA,YAAY,KAAuB,EAA8B,CAAQ;EACzE;CACF,CACF;AACF;AAEA,SAAS,EACP,GACA,GACA,GACA,GACA,GACe;CACf,IAAM,IAAgB,EAAmB,GAAQ,GAAe,GAAM,UAAU,GAC1E,IAAe,EAAmB,GAAQ,GAAc,GAAM,SAAS,GAEvE,IAA+B,CAAC,GAChC,IAAiC,CAAC,GAClC,IAAiC,CAAC;CAExC,KAAK,IAAM,CAAC,GAAK,MAAiB,GAAc;EAC9C,IAAM,IAAgB,EAAc,IAAI,CAAG,GACrC,IAAW,CAAC,GAAG,GAAM,CAAG;EAE9B,IAAI,KAAiB,MAAM;GACzB,EAAc,KAAK,GAAG,EAA0B,GAAQ,EAAa,OAAO,GAAU,CAAO,CAAC;GAC9F;EACF;EAEA,EAAgB,KACd,GAAG,EAA4B;GAC7B;GACA,UAAU,EAAc;GACxB,SAAS,EAAa;GACtB,MAAM;GACN,UAAU;GACV;EACF,CAAC,CACH;CACF;CAEA,KAAK,IAAM,CAAC,GAAK,MAAkB,GAC7B,EAAa,IAAI,CAAG,KAIxB,EAAgB,KAAK,GAAG,EAA4B,GAAQ,EAAc,OAAO,CAAC,GAAG,GAAM,CAAG,GAAG,CAAO,CAAC;CAG3G,OAAO,EAA6B;EAAC,GAAG;EAAe,GAAG;EAAiB,GAAG;CAAe,CAAC;AAChG;AAEA,SAAS,EACP,GACA,GACA,GACA,GACA,GACe;CACf,IAAM,IAAgB,EAAmB,GAAQ,GAAe,GAAM,UAAU,GAC1E,IAAe,EAAmB,GAAQ,GAAc,GAAM,SAAS,GACvE,IAAa,IAAI,IACrB,EACE,CAAC,GAAG,EAAc,KAAK,CAAC,CAAC,CAAC,QAAO,MAAO,EAAa,IAAI,CAAG,CAAC,GAC7D,CAAC,GAAG,EAAa,KAAK,CAAC,CAAC,CAAC,QAAO,MAAO,EAAc,IAAI,CAAG,CAAC,CAC/D,CACF,GAEM,IAA+B,CAAC,GAChC,IAAiC,CAAC,GAClC,IAAiC,CAAC;CAExC,KAAK,IAAM,CAAC,GAAK,MAAiB,GAAc;EAC9C,IAAM,IAAgB,EAAc,IAAI,CAAG,GACrC,IAAW,CAAC,GAAG,GAAM,CAAG;EAE9B,IAAI,KAAiB,MAAM;GACzB,EAAc,KAAK,GAAG,EAA0B,GAAQ,EAAa,OAAO,GAAU,CAAO,CAAC;GAC9F;EACF;EAEA,IAAM,IAAW,EAAW,IAAI,CAAG,IAC/B,OACA,GAAe,GAAU,EAAc,OAAO,EAAa,OAAO,CAAO;EAE7E,EAAgB,KACd,GAAG,EAA4B;GAC7B;GACA,UAAU,EAAc;GACxB,SAAS,EAAa;GACtB,MAAM;GACN;GACA;EACF,CAAC,CACH;CACF;CAEA,KAAK,IAAM,CAAC,GAAK,MAAkB,GAC7B,EAAa,IAAI,CAAG,KAIxB,EAAgB,KAAK,GAAG,EAA4B,GAAQ,EAAc,OAAO,CAAC,GAAG,GAAM,CAAG,GAAG,CAAO,CAAC;CAG3G,OAAO;EACL,GAAG,EAA6B,CAAa;EAC7C,GAAG,EAA6B,CAAe;EAC/C,GAAG,EAA6B,CAAe;CACjD;AACF;AAEA,SAAS,EACP,GACA,GACoB;CACpB,IAAM,IAAU,MAAM,KAAK,EAAE,QAAQ,EAAa,SAAS,EAAE,SAAS,MAAc,EAAY,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;CAEnH,KAAK,IAAI,IAAgB,EAAa,SAAS,GAAG,KAAiB,GAAG,KACpE,KAAK,IAAI,IAAe,EAAY,SAAS,GAAG,KAAgB,GAAG,KACjE,EAAQ,EAAc,CAAE,KAAgB,EACtC,EAAa,IACb,EAAY,EACd,IACI,IAAI,EAAQ,IAAgB,EAAE,CAAE,IAAe,KAC/C,KAAK,IAAI,EAAQ,IAAgB,EAAE,CAAE,IAAgB,EAAQ,EAAc,CAAE,IAAe,EAAG;CAIvG,IAAM,IAAiC,CAAC,GACpC,IAAgB,GAChB,IAAe;CAEnB,OAAO,IAAgB,EAAa,UAAU,IAAe,EAAY,SAAQ;EAC/E,IAAM,IAAc,EAAa,IAC3B,IAAa,EAAY;EAE/B,IAAI,EAAoB,GAAa,CAAU,GAAG;GAGhD,AAFA,EAAW,KAAK,CAAW,GAC3B,KAAiB,GACjB,KAAgB;GAChB;EACF;EAIA,AAF2B,EAAQ,IAAgB,EAAE,CAAE,KAC7B,EAAQ,EAAc,CAAE,IAAe,KAE/D,KAAiB,IAEjB,KAAgB;CAEpB;CAEA,OAAO;AACT;AAEA,SAAS,EAAoB,GAAoC,GAA8C;CAC7G,OACE,MAAS,KACR,OAAO,KAAS,YAAY,OAAO,KAAU,YAAY,OAAO,MAAM,CAAI,KAAK,OAAO,MAAM,CAAK;AAEtG;AAEA,SAAS,EAA4B,GAOnB;CAChB,IAAM,EAAE,WAAQ,aAAU,YAAS,SAAM,aAAU,eAAY,GACzD,IAAO,EAAO;CAEpB,IAAI,EAAK,SAAS,UAAU;EAC1B,IAAM,IAAQ,EAAmB,EAAK,YAAY,GAAU,GAAS,GAAM,CAAO;EAMlF,OAJI,KAAS,OACJ,KAAY,OAAO,CAAC,IAAI,CAAC,EAAqB,GAAM,GAAS,GAAM,CAAQ,CAAC,IAG9E,CACL;GACE,GAAG;GACH,UAAU,KAAY,OAAO,EAAM,WAAW,CAAC,GAAU,GAAG,EAAM,QAAQ;EAC5E,CACF;CACF;CAEA,IAAM,IAAQ,EAAiB;EAC7B,QAAQ;EACR;EACA;EACA,gBAAgB;EAChB,eAAe;EACf;EACA;CACF,CAAC;CAED,OAAO,KAAY,OAAO,IAAQ,CAAC,GAAU,GAAG,CAAK;AACvD;AAEA,SAAS,EACP,GACA,GACA,GACA,GACe;CACf,IAAM,IAAO,EAAO;CAEpB,IAAI,EAAK,SAAS,UAAU;EAC1B,IAAM,IAAQ,EAAmB,EAAK,YAAY,KAAA,GAAW,GAAS,GAAM,GAAS,OAAO;EAE5F,OAAO,KAAS,OACZ,CACE;GACE,MAAM;GACN;GACA,OAAO,EAAK,WAAW,QAAQ;GAC/B,SAAS,EAAsB,EAAK,YAAY,GAAS,GAAM,SAAS;EAC1E,CACF,IACA,CAAC,CAAK;CACZ;CAEA,OAAO,EAAiB;EACtB,QAAQ;EACR,UAAU,KAAA;EACV;EACA,gBAAgB,KAAA;EAChB,eAAe;EACf;EACA;CACF,CAAC;AACH;AAEA,SAAS,EACP,GACA,GACA,GACA,GACe;CACf,IAAM,IAAO,EAAO;CAEpB,IAAI,EAAK,SAAS,UAAU;EAC1B,IAAM,IAAQ,EAAmB,EAAK,YAAY,GAAU,KAAA,GAAW,GAAM,GAAS,SAAS;EAE/F,OAAO,KAAS,OACZ,CACE;GACE,MAAM;GACN;GACA,OAAO,EAAK,WAAW,QAAQ;GAC/B,UAAU,EAAsB,EAAK,YAAY,GAAU,GAAM,UAAU;EAC7E,CACF,IACA,CAAC,CAAK;CACZ;CAEA,OAAO,EAAiB;EACtB,QAAQ;EACR;EACA,SAAS,KAAA;EACT,gBAAgB;EAChB,eAAe,KAAA;EACf;EACA;CACF,CAAC;AACH;AAEA,SAAS,EACP,GACA,GACA,GACA,GACkB;CAClB,OAAO;EACL,MAAM;EACN;EACA,OAAO,EAAK,WAAW,QAAQ;EAC/B,OAAO,EAAsB,EAAK,YAAY,GAAS,GAAM,SAAS;EACtE,YAAY;EACZ,UAAU,CAAC,CAAQ;CACrB;AACF;AAEA,SAAS,GACP,GACA,GACA,GACA,GACiB;CACjB,OAAO;EACL,MAAM;EACN,MAAM,CAAC,GAAG,GAAM,WAAW;EAC3B,OAAO,EAAQ,iBAAiB;EAChC,UAAU,EAAmB,GAAe,OAAO,IAAgB,CAAC,CAAC;EACrE,SAAS,EAAmB,GAAc,OAAO,IAAe,CAAC,CAAC;CACpE;AACF;AAEA,SAAS,EACP,GACA,GACA,GACA,GAC0D;CAC1D,IAAM,oBAAM,IAAI,IAAyD;CAiBzE,OAfA,EAAM,SAAS,GAAO,MAAU;EAC9B,IAAM,IAAM,EAAmB,GAAQ,CAAK;EAC5C,IAAK,OAAO,KAAQ,YAAY,OAAO,KAAQ,YAAc,OAAO,KAAQ,YAAY,CAAC,OAAO,SAAS,CAAG,GAC1G,MAAU,UACR,iCAAiC,EAAK,gBAAgB,EAAK,KAAK,GAAG,EAAE,qCACvE;EAEF,IAAI,EAAI,IAAI,CAAG,GACb,MAAU,MACR,qCAAqC,OAAO,CAAG,EAAE,WAAW,EAAK,gBAAgB,EAAK,KAAK,GAAG,EAAE,GAClG;EAEF,EAAI,IAAI,GAAK;GAAE;GAAO;EAAM,CAAC;CAC/B,CAAC,GAEM;AACT;AAEA,SAAS,EAAmB,GAAkC,GAAkC;CAC9F,IAAM,IAAO,EAAO;CAUpB,OARI,EAAK,SAAS,WACT,EAAK,WAAW,QAAQ,IAAI,CAAK,IAGtC,OAAO,KAAU,YAAY,OAAO,KAAU,WACzC,IAGF,EAAgB,CAAK;AAC9B;AAEA,SAAS,EAA6B,GAAqC;CACzE,OAAO,CAAC,GAAG,CAAK,CAAC,CAAC,MAAM,GAAM,MAAU,EAA0B,CAAI,IAAI,EAA0B,CAAK,CAAC;AAC5G;AAEA,SAAS,EAA8B,GAAiD;CAGtF,OAFwB,EAAS,MAAK,MAAS,EAAyB,CAAK,MAAM,WAE5E,IAAkB,YAAY;AACvC;AAEA,SAAS,EAAyB,GAA2C;CAC3E,IAAI,EAAK,SAAS,SAChB,OAAO,EAAK,cAAc,EAA8B,EAAK,QAAQ;CAGvE,QAAQ,EAAK,MAAb;EACE,KAAK,SACH,OAAO;EAET,KAAK,WACH,OAAO;EAET,KAAK;EACL,KAAK,SACH,OAAO;EAET,KAAK,aACH,OAAO;EAET,SACE,OAAO;CACX;AACF;AAEA,SAAS,EAA0B,GAA2B;CAa5D,OAZI,EAAK,SAAS,WAAW,EAAK,cAAc,OACvC,EAAsB,EAAK,UAAU,IAG1C,EAAK,SAAS,UAId,EAAK,SAAS,WAAW,IACpB,IAGF,KAAK,IAAI,GAAG,EAAK,SAAS,IAAI,CAAyB,CAAC,IAPtD,EAA8B,CAAI;AAQ7C;AAEA,SAAS,EAAsB,GAA4C;CACzE,QAAQ,GAAR;EACE,KAAK,SACH,OAAO;EAET,KAAK,WACH,OAAO;EAET,KAAK,WACH,OAAO;EAET,KAAK,aACH,OAAO;EAET,SACE,OAAO;CACX;AACF;AAEA,SAAS,EAA8B,GAA8B;CACnE,QAAQ,EAAI,MAAZ;EACE,KAAK,SACH,OAAO;EAET,KAAK;EACL,KAAK,SACH,OAAO;EAET,KAAK,WACH,OAAO;EAET,KAAK,aACH,OAAO;EAET,SACE,OAAO;CACX;AACF;AAEA,SAAS,EAA0B,GAAmB,GAA0D;CAC9G,IAAM,IAAgB,CAAC,EAAsB,CAAQ,GAC/C,IAAe,CAAC,EAAsB,CAAO;CAkBnD,OAhBI,KAAiB,IACZ,OAGL,KAAiB,CAAC,IACb,UAGL,CAAC,KAAiB,IACb,YAGL,EAAsB,GAAU,CAAO,IAClC,OAGF;AACT;AAEA,SAAS,EAAoB,GAAgB,GAA4B;CACnE,MAAiB,OAAO,KAAU,aAAlC,IACJ,OAAQ,EAAkC;AAC5C;AAEA,SAAS,EAAiB,GAOT;CACf,IAAM,EAAE,WAAQ,UAAO,WAAQ,SAAM,YAAS;CAC9C,OAAO,EAAmB,GAAO,EAAO,QAAQ;EAAE;EAAQ;EAAM;CAAK,CAAC;AACxE;AAEA,SAAS,EACP,GACA,GACA,GACA,GACA,GAC0B;CACtB,MAAO,UAAU,MACrB,OAAO,EAAmB,GAAO,EAAO,QAAQ;EAAE;EAAQ;EAAM;CAAK,CAAC;AACxE;AAEA,SAAS,EACP,GACA,GACA,GACA,GACc;CAKd,OAJI,EAAW,QAAQ,UAAU,OACxB,EAAmB,GAAO,EAAW,QAAQ,KAAK,IAGpD,EAAmB,GAAO,EAAW,QAAQ,QAAQ;EAAE,QAAQ;EAAO;EAAM;CAAK,CAAC;AAC3F;AAEA,SAAS,EAAmB,GAAc,GAAiC;CACzE,OAAO;EAAE;EAAK;CAAU;AAC1B;;;ACp2BA,IAAa,IAAwB,EAAE,OAAO,EAAE,OAAO,GAAG,EAAE,QAAQ,CAAC,GAGxD,IAAyB,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC,OAAO,GAAG,EAAE,OAAO,CAAC,CAAC,SAAS,EAAE,QAAQ,GAAK,CAAC,CAAC,CAAC,GAE7F,IAAqB,EAAE,OAAO;CACzC,IAAI,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS;CAC1C,OAAO,EACJ,OAAO,CAAC,CACR,IAAI,CAAC,CAAC,CACN,QAAO,MAAS,EAAM,KAAK,CAAC,CAAC,SAAS,GAAG,sCAAsC;AACpF,CAAC;AA2BD,SAAgB,EAKd,IAA0E,CAAC,GACb;CAC9D,IAAM,IAAmB,EAAQ,cAAe,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,GAC1D,IAAiB,EAAQ,YAAa,GACtC,IAAkB,EAAQ,aAAc;CAE9C,OAAO,EAAE,OAAO;EACd,IAAI,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC;EACpB,WAAW;EACX,OAAO,EAAmB,SAAS;EACnC,QAAQ;EACR,UAAU,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC;EAC1B,kBAAkB,EAAe,SAAS;EAC1C,iBAAiB,EAAe,SAAS;CAC3C,CAAC;AACH;AAEA,IAAa,KAAsB,EAA0B"}

package/dist/records/historyRecord.d.ts

@@ -0,0 +1,27 @@
+import { z } from 'zod';
+export type HistoryEntityKind = string;
+export type HistoryTimestamp = number | string;
+export declare const HistorySnapshotSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+export type HistorySnapshot = z.infer<typeof HistorySnapshotSchema>;
+export declare const HistoryTimestampSchema: z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>;
+export declare const HistoryActorSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    label: z.ZodString;
+}, z.core.$strip>;
+export type HistoryActor = z.infer<typeof HistoryActorSchema>;
+export interface HistoryRecord<TSnapshot extends HistorySnapshot = HistorySnapshot, TEntityKind extends HistoryEntityKind = HistoryEntityKind, TTimestamp extends HistoryTimestamp = HistoryTimestamp> {
+    id: string;
+    timestamp: TTimestamp;
+    actor: HistoryActor | null;
+    entity: TEntityKind;
+    entityId: string;
+    snapshotPrevious: TSnapshot | null;
+    snapshotCurrent: TSnapshot | null;
+}
+export type HistoryRecordSchemaOptions<TEntityKind extends HistoryEntityKind = HistoryEntityKind, TSnapshot extends HistorySnapshot = HistorySnapshot, TTimestamp extends HistoryTimestamp = HistoryTimestamp> = {
+    entityKind?: z.ZodType<TEntityKind>;
+    snapshot?: z.ZodType<TSnapshot>;
+    timestamp?: z.ZodType<TTimestamp>;
+};
+export declare function createHistoryRecordSchema<TEntityKind extends HistoryEntityKind = HistoryEntityKind, TSnapshot extends HistorySnapshot = HistorySnapshot, TTimestamp extends HistoryTimestamp = HistoryTimestamp>(options?: HistoryRecordSchemaOptions<TEntityKind, TSnapshot, TTimestamp>): z.ZodType<HistoryRecord<TSnapshot, TEntityKind, TTimestamp>>;
+export declare const HistoryRecordSchema: z.ZodType<HistoryRecord<Record<string, unknown>, string, HistoryTimestamp>, unknown, z.core.$ZodTypeInternals<HistoryRecord<Record<string, unknown>, string, HistoryTimestamp>, unknown>>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vireocodedev/history",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Framework-free entity history definitions, diff nodes, and transport-neutral record schemas for the vireocodedev starter product.",
   "type": "module",
   "sideEffects": false,