doxum 0.1.1

package/dist/integration.js

@@ -0,0 +1,14 @@
+import { i as readWith, t as createDependencyTracker } from "./dependency-BdEMyquf.js";
+//#region core/src/integration.ts
+const track = (runtime, selector) => {
+	const dependencies = createDependencyTracker();
+	const value = readWith(runtime, selector, dependencies);
+	return Object.freeze({
+		value,
+		targets: dependencies.snapshot()
+	});
+};
+//#endregion
+export { track };
+
+//# sourceMappingURL=integration.js.map

package/dist/integration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration.js","names":[],"sources":["../core/src/integration.ts"],"sourcesContent":["import type { DocumentSchema, ImpactTarget } from './schema';\nimport type { DocumentReader } from './access/reader';\nimport type { DocumentRuntime } from './runtime/contract';\nimport { createDependencyTracker } from './access/dependency';\nimport { readWith } from './runtime/access';\n\nexport type TrackedSelection<TValue> = {\n  readonly value: TValue;\n  readonly targets: readonly ImpactTarget<unknown>[];\n};\n\n// Framework adapters receive one immutable result instead of coordinating a\n// mutable collector with the reader's scoped lifetime themselves.\nexport const track = <TSchema extends DocumentSchema, TValue>(\n  runtime: DocumentRuntime<TSchema>,\n  selector: (read: DocumentReader<TSchema>) => TValue\n): TrackedSelection<TValue> => {\n  const dependencies = createDependencyTracker();\n  const value = readWith(runtime, selector, dependencies);\n  return Object.freeze({ value, targets: dependencies.snapshot() });\n};\n"],"mappings":";;AAaA,MAAa,SACX,SACA,aAC6B;CAC7B,MAAM,eAAe,yBAAyB;CAC9C,MAAM,QAAQ,SAAS,SAAS,UAAU,aAAa;AACvD,QAAO,OAAO,OAAO;EAAE;EAAO,SAAS,aAAa,UAAU;EAAE,CAAC"}

package/dist/react.cjs

@@ -0,0 +1,99 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_integration = require("./integration.cjs");
+let doxum = require("doxum");
+let react = require("react");
+//#region react/src/hooks.ts
+const objectIs = (previous, next) => Object.is(previous, next);
+const sameTargets = (left, right) => {
+	if (left.length !== right.length) return false;
+	for (let index = 0; index < left.length; index += 1) if (!doxum.target.same(left[index], right[index])) return false;
+	return true;
+};
+function useDocumentSelector(runtime, selector, options) {
+	const equality = options?.isEqual ?? objectIs;
+	const cache = (0, react.useRef)(void 0);
+	const serverCache = (0, react.useRef)(void 0);
+	const read = (0, react.useCallback)(() => {
+		const selection = require_integration.track(runtime, selector);
+		const next = selection.value;
+		const previous = cache.current;
+		const targets = selection.targets;
+		if (previous && previous.runtime === runtime && equality(previous.value, next)) {
+			cache.current = {
+				runtime,
+				value: previous.value,
+				targets
+			};
+			return previous.value;
+		}
+		cache.current = {
+			runtime,
+			value: next,
+			targets
+		};
+		return next;
+	}, [
+		equality,
+		runtime,
+		selector
+	]);
+	const subscribe = (0, react.useCallback)((listener) => {
+		let targets = cache.current?.targets ?? [];
+		let unsubscribe = () => void 0;
+		const install = () => {
+			if (targets.length === 0) return () => void 0;
+			return runtime.subscribe(targets.length === 1 ? targets[0] : targets, onCommit);
+		};
+		const onCommit = () => {
+			const previous = cache.current;
+			const next = read();
+			const nextTargets = cache.current?.targets ?? [];
+			if (!sameTargets(targets, nextTargets)) {
+				unsubscribe();
+				targets = nextTargets;
+				unsubscribe = install();
+			}
+			if (previous && previous.value !== next) listener();
+		};
+		unsubscribe = install();
+		return () => unsubscribe();
+	}, [read, runtime]);
+	const server = options?.server;
+	return (0, react.useSyncExternalStore)(subscribe, read, (0, react.useCallback)(() => {
+		const previous = serverCache.current;
+		if (previous && previous.source === server) return previous.value;
+		const value = server ? server() : read();
+		serverCache.current = {
+			source: server,
+			value
+		};
+		return value;
+	}, [read, server]));
+}
+function useReadable(readable) {
+	const subscribe = (0, react.useCallback)((listener) => readable.subscribe(listener), [readable]);
+	const read = (0, react.useCallback)(() => readable.current(), [readable]);
+	return (0, react.useSyncExternalStore)(subscribe, read, read);
+}
+function useHistory(history) {
+	const subscribe = (0, react.useCallback)((listener) => history.subscribe(listener), [history]);
+	const read = (0, react.useCallback)(() => history.current(), [history]);
+	const state = (0, react.useSyncExternalStore)(subscribe, read, read);
+	const undo = (0, react.useCallback)(() => history.undo(), [history]);
+	const redo = (0, react.useCallback)(() => history.redo(), [history]);
+	return (0, react.useMemo)(() => ({
+		...state,
+		undo,
+		redo
+	}), [
+		redo,
+		state,
+		undo
+	]);
+}
+//#endregion
+exports.useDocumentSelector = useDocumentSelector;
+exports.useHistory = useHistory;
+exports.useReadable = useReadable;
+
+//# sourceMappingURL=react.cjs.map

package/dist/react.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.cjs","names":["target","track"],"sources":["../react/src/hooks.ts"],"sourcesContent":["import type {\n  DocumentRuntime,\n  DocumentSchema,\n  DocumentSelector,\n  HistoryState,\n  ImpactTarget,\n  LocalHistory,\n  OperationResult,\n  Readable,\n} from 'doxum';\nimport { target } from 'doxum';\nimport { track } from 'doxum/integration';\nimport { useCallback, useMemo, useRef, useSyncExternalStore } from 'react';\n\nexport type DocumentSelectorOptions<TResult> = {\n  readonly isEqual?: (previous: TResult, next: TResult) => boolean;\n  readonly server?: () => TResult;\n};\n\ntype SelectorCache<TSchema extends DocumentSchema, TResult> = {\n  readonly runtime: DocumentRuntime<TSchema>;\n  readonly value: TResult;\n  readonly targets: readonly ImpactTarget<unknown>[];\n};\n\nconst objectIs = <T>(previous: T, next: T): boolean => Object.is(previous, next);\nconst sameTargets = (\n  left: readonly ImpactTarget<unknown>[],\n  right: readonly ImpactTarget<unknown>[]\n): boolean => {\n  if (left.length !== right.length) return false;\n  for (let index = 0; index < left.length; index += 1)\n    if (!target.same(left[index], right[index])) return false;\n  return true;\n};\n\nexport function useDocumentSelector<TSchema extends DocumentSchema, TResult>(\n  runtime: DocumentRuntime<TSchema>,\n  selector: DocumentSelector<TSchema, TResult>,\n  options?: DocumentSelectorOptions<TResult>\n): TResult {\n  const equality = options?.isEqual ?? objectIs;\n  const cache = useRef<SelectorCache<TSchema, TResult> | undefined>(undefined);\n  const serverCache = useRef<\n    { readonly source: (() => TResult) | undefined; readonly value: TResult } | undefined\n  >(undefined);\n\n  const read = useCallback((): TResult => {\n    const selection = track(runtime, selector);\n    const next = selection.value;\n    const previous = cache.current;\n\n    // Keep the prior reference for semantic equality on the same runtime. This\n    // is what makes inline selectors safe with useSyncExternalStore.\n    const targets = selection.targets;\n    if (previous && previous.runtime === runtime && equality(previous.value, next)) {\n      cache.current = { runtime, value: previous.value, targets };\n      return previous.value;\n    }\n\n    cache.current = { runtime, value: next, targets };\n    return next;\n  }, [equality, runtime, selector]);\n\n  const subscribe = useCallback(\n    (listener: () => void) => {\n      let targets = cache.current?.targets ?? [];\n      let unsubscribe: () => void = () => undefined;\n      const install = () => {\n        if (targets.length === 0) return () => undefined;\n        return runtime.subscribe(\n          targets.length === 1\n            ? targets[0]\n            : (targets as [ImpactTarget<unknown>, ...ImpactTarget<unknown>[]]),\n          onCommit\n        );\n      };\n      const onCommit = () => {\n        const previous = cache.current;\n        const next = read();\n        const nextTargets = cache.current?.targets ?? [];\n        if (!sameTargets(targets, nextTargets)) {\n          unsubscribe();\n          targets = nextTargets;\n          unsubscribe = install();\n        }\n        if (previous && previous.value !== next) listener();\n      };\n      unsubscribe = install();\n      return () => unsubscribe();\n    },\n    [read, runtime]\n  );\n\n  const server = options?.server;\n  const readServer = useCallback((): TResult => {\n    const previous = serverCache.current;\n    if (previous && previous.source === server) return previous.value;\n    const value = server ? server() : read();\n    serverCache.current = { source: server, value };\n    return value;\n  }, [read, server]);\n\n  return useSyncExternalStore(subscribe, read, readServer);\n}\n\nexport function useReadable<T>(readable: Readable<T>): T {\n  const subscribe = useCallback((listener: () => void) => readable.subscribe(listener), [readable]);\n  const read = useCallback(() => readable.current(), [readable]);\n  return useSyncExternalStore(subscribe, read, read);\n}\n\nexport function useHistory<TCommit>(history: LocalHistory<TCommit>): HistoryState & {\n  undo(): OperationResult<TCommit>;\n  redo(): OperationResult<TCommit>;\n} {\n  const subscribe = useCallback((listener: () => void) => history.subscribe(listener), [history]);\n  const read = useCallback(() => history.current(), [history]);\n  const state = useSyncExternalStore(subscribe, read, read);\n  const undo = useCallback(() => history.undo(), [history]);\n  const redo = useCallback(() => history.redo(), [history]);\n\n  return useMemo(() => ({ ...state, undo, redo }), [redo, state, undo]);\n}\n"],"mappings":";;;;;AAyBA,MAAM,YAAe,UAAa,SAAqB,OAAO,GAAG,UAAU,KAAK;AAChF,MAAM,eACJ,MACA,UACY;AACZ,KAAI,KAAK,WAAW,MAAM,OAAQ,QAAO;AACzC,MAAK,IAAI,QAAQ,GAAG,QAAQ,KAAK,QAAQ,SAAS,EAChD,KAAI,CAACA,MAAAA,OAAO,KAAK,KAAK,QAAQ,MAAM,OAAO,CAAE,QAAO;AACtD,QAAO;;AAGT,SAAgB,oBACd,SACA,UACA,SACS;CACT,MAAM,WAAW,SAAS,WAAW;CACrC,MAAM,SAAA,GAAA,MAAA,QAA4D,KAAA,EAAU;CAC5E,MAAM,eAAA,GAAA,MAAA,QAEJ,KAAA,EAAU;CAEZ,MAAM,QAAA,GAAA,MAAA,mBAAkC;EACtC,MAAM,YAAYC,oBAAAA,MAAM,SAAS,SAAS;EAC1C,MAAM,OAAO,UAAU;EACvB,MAAM,WAAW,MAAM;EAIvB,MAAM,UAAU,UAAU;AAC1B,MAAI,YAAY,SAAS,YAAY,WAAW,SAAS,SAAS,OAAO,KAAK,EAAE;AAC9E,SAAM,UAAU;IAAE;IAAS,OAAO,SAAS;IAAO;IAAS;AAC3D,UAAO,SAAS;;AAGlB,QAAM,UAAU;GAAE;GAAS,OAAO;GAAM;GAAS;AACjD,SAAO;IACN;EAAC;EAAU;EAAS;EAAS,CAAC;CAEjC,MAAM,aAAA,GAAA,MAAA,cACH,aAAyB;EACxB,IAAI,UAAU,MAAM,SAAS,WAAW,EAAE;EAC1C,IAAI,oBAAgC,KAAA;EACpC,MAAM,gBAAgB;AACpB,OAAI,QAAQ,WAAW,EAAG,cAAa,KAAA;AACvC,UAAO,QAAQ,UACb,QAAQ,WAAW,IACf,QAAQ,KACP,SACL,SACD;;EAEH,MAAM,iBAAiB;GACrB,MAAM,WAAW,MAAM;GACvB,MAAM,OAAO,MAAM;GACnB,MAAM,cAAc,MAAM,SAAS,WAAW,EAAE;AAChD,OAAI,CAAC,YAAY,SAAS,YAAY,EAAE;AACtC,iBAAa;AACb,cAAU;AACV,kBAAc,SAAS;;AAEzB,OAAI,YAAY,SAAS,UAAU,KAAM,WAAU;;AAErD,gBAAc,SAAS;AACvB,eAAa,aAAa;IAE5B,CAAC,MAAM,QAAQ,CAChB;CAED,MAAM,SAAS,SAAS;AASxB,SAAA,GAAA,MAAA,sBAA4B,WAAW,OAAA,GAAA,MAAA,mBARO;EAC5C,MAAM,WAAW,YAAY;AAC7B,MAAI,YAAY,SAAS,WAAW,OAAQ,QAAO,SAAS;EAC5D,MAAM,QAAQ,SAAS,QAAQ,GAAG,MAAM;AACxC,cAAY,UAAU;GAAE,QAAQ;GAAQ;GAAO;AAC/C,SAAO;IACN,CAAC,MAAM,OAAO,CAEsC,CAAC;;AAG1D,SAAgB,YAAe,UAA0B;CACvD,MAAM,aAAA,GAAA,MAAA,cAAyB,aAAyB,SAAS,UAAU,SAAS,EAAE,CAAC,SAAS,CAAC;CACjG,MAAM,QAAA,GAAA,MAAA,mBAAyB,SAAS,SAAS,EAAE,CAAC,SAAS,CAAC;AAC9D,SAAA,GAAA,MAAA,sBAA4B,WAAW,MAAM,KAAK;;AAGpD,SAAgB,WAAoB,SAGlC;CACA,MAAM,aAAA,GAAA,MAAA,cAAyB,aAAyB,QAAQ,UAAU,SAAS,EAAE,CAAC,QAAQ,CAAC;CAC/F,MAAM,QAAA,GAAA,MAAA,mBAAyB,QAAQ,SAAS,EAAE,CAAC,QAAQ,CAAC;CAC5D,MAAM,SAAA,GAAA,MAAA,sBAA6B,WAAW,MAAM,KAAK;CACzD,MAAM,QAAA,GAAA,MAAA,mBAAyB,QAAQ,MAAM,EAAE,CAAC,QAAQ,CAAC;CACzD,MAAM,QAAA,GAAA,MAAA,mBAAyB,QAAQ,MAAM,EAAE,CAAC,QAAQ,CAAC;AAEzD,SAAA,GAAA,MAAA,gBAAsB;EAAE,GAAG;EAAO;EAAM;EAAM,GAAG;EAAC;EAAM;EAAO;EAAK,CAAC"}

package/dist/react.d.cts

@@ -0,0 +1,16 @@
+import { DocumentRuntime, DocumentSchema, DocumentSelector, HistoryState, LocalHistory, OperationResult, Readable } from "doxum";
+
+//#region react/src/hooks.d.ts
+type DocumentSelectorOptions<TResult> = {
+  readonly isEqual?: (previous: TResult, next: TResult) => boolean;
+  readonly server?: () => TResult;
+};
+declare function useDocumentSelector<TSchema extends DocumentSchema, TResult>(runtime: DocumentRuntime<TSchema>, selector: DocumentSelector<TSchema, TResult>, options?: DocumentSelectorOptions<TResult>): TResult;
+declare function useReadable<T>(readable: Readable<T>): T;
+declare function useHistory<TCommit>(history: LocalHistory<TCommit>): HistoryState & {
+  undo(): OperationResult<TCommit>;
+  redo(): OperationResult<TCommit>;
+};
+//#endregion
+export { type DocumentSelectorOptions, useDocumentSelector, useHistory, useReadable };
+//# sourceMappingURL=react.d.cts.map

package/dist/react.d.ts

@@ -0,0 +1,16 @@
+import { DocumentRuntime, DocumentSchema, DocumentSelector, HistoryState, LocalHistory, OperationResult, Readable } from "doxum";
+
+//#region react/src/hooks.d.ts
+type DocumentSelectorOptions<TResult> = {
+  readonly isEqual?: (previous: TResult, next: TResult) => boolean;
+  readonly server?: () => TResult;
+};
+declare function useDocumentSelector<TSchema extends DocumentSchema, TResult>(runtime: DocumentRuntime<TSchema>, selector: DocumentSelector<TSchema, TResult>, options?: DocumentSelectorOptions<TResult>): TResult;
+declare function useReadable<T>(readable: Readable<T>): T;
+declare function useHistory<TCommit>(history: LocalHistory<TCommit>): HistoryState & {
+  undo(): OperationResult<TCommit>;
+  redo(): OperationResult<TCommit>;
+};
+//#endregion
+export { type DocumentSelectorOptions, useDocumentSelector, useHistory, useReadable };
+//# sourceMappingURL=react.d.ts.map

package/dist/react.js

@@ -0,0 +1,96 @@
+import { track } from "./integration.js";
+import { target } from "doxum";
+import { useCallback, useMemo, useRef, useSyncExternalStore } from "react";
+//#region react/src/hooks.ts
+const objectIs = (previous, next) => Object.is(previous, next);
+const sameTargets = (left, right) => {
+	if (left.length !== right.length) return false;
+	for (let index = 0; index < left.length; index += 1) if (!target.same(left[index], right[index])) return false;
+	return true;
+};
+function useDocumentSelector(runtime, selector, options) {
+	const equality = options?.isEqual ?? objectIs;
+	const cache = useRef(void 0);
+	const serverCache = useRef(void 0);
+	const read = useCallback(() => {
+		const selection = track(runtime, selector);
+		const next = selection.value;
+		const previous = cache.current;
+		const targets = selection.targets;
+		if (previous && previous.runtime === runtime && equality(previous.value, next)) {
+			cache.current = {
+				runtime,
+				value: previous.value,
+				targets
+			};
+			return previous.value;
+		}
+		cache.current = {
+			runtime,
+			value: next,
+			targets
+		};
+		return next;
+	}, [
+		equality,
+		runtime,
+		selector
+	]);
+	const subscribe = useCallback((listener) => {
+		let targets = cache.current?.targets ?? [];
+		let unsubscribe = () => void 0;
+		const install = () => {
+			if (targets.length === 0) return () => void 0;
+			return runtime.subscribe(targets.length === 1 ? targets[0] : targets, onCommit);
+		};
+		const onCommit = () => {
+			const previous = cache.current;
+			const next = read();
+			const nextTargets = cache.current?.targets ?? [];
+			if (!sameTargets(targets, nextTargets)) {
+				unsubscribe();
+				targets = nextTargets;
+				unsubscribe = install();
+			}
+			if (previous && previous.value !== next) listener();
+		};
+		unsubscribe = install();
+		return () => unsubscribe();
+	}, [read, runtime]);
+	const server = options?.server;
+	return useSyncExternalStore(subscribe, read, useCallback(() => {
+		const previous = serverCache.current;
+		if (previous && previous.source === server) return previous.value;
+		const value = server ? server() : read();
+		serverCache.current = {
+			source: server,
+			value
+		};
+		return value;
+	}, [read, server]));
+}
+function useReadable(readable) {
+	const subscribe = useCallback((listener) => readable.subscribe(listener), [readable]);
+	const read = useCallback(() => readable.current(), [readable]);
+	return useSyncExternalStore(subscribe, read, read);
+}
+function useHistory(history) {
+	const subscribe = useCallback((listener) => history.subscribe(listener), [history]);
+	const read = useCallback(() => history.current(), [history]);
+	const state = useSyncExternalStore(subscribe, read, read);
+	const undo = useCallback(() => history.undo(), [history]);
+	const redo = useCallback(() => history.redo(), [history]);
+	return useMemo(() => ({
+		...state,
+		undo,
+		redo
+	}), [
+		redo,
+		state,
+		undo
+	]);
+}
+//#endregion
+export { useDocumentSelector, useHistory, useReadable };
+
+//# sourceMappingURL=react.js.map

package/dist/react.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.js","names":[],"sources":["../react/src/hooks.ts"],"sourcesContent":["import type {\n  DocumentRuntime,\n  DocumentSchema,\n  DocumentSelector,\n  HistoryState,\n  ImpactTarget,\n  LocalHistory,\n  OperationResult,\n  Readable,\n} from 'doxum';\nimport { target } from 'doxum';\nimport { track } from 'doxum/integration';\nimport { useCallback, useMemo, useRef, useSyncExternalStore } from 'react';\n\nexport type DocumentSelectorOptions<TResult> = {\n  readonly isEqual?: (previous: TResult, next: TResult) => boolean;\n  readonly server?: () => TResult;\n};\n\ntype SelectorCache<TSchema extends DocumentSchema, TResult> = {\n  readonly runtime: DocumentRuntime<TSchema>;\n  readonly value: TResult;\n  readonly targets: readonly ImpactTarget<unknown>[];\n};\n\nconst objectIs = <T>(previous: T, next: T): boolean => Object.is(previous, next);\nconst sameTargets = (\n  left: readonly ImpactTarget<unknown>[],\n  right: readonly ImpactTarget<unknown>[]\n): boolean => {\n  if (left.length !== right.length) return false;\n  for (let index = 0; index < left.length; index += 1)\n    if (!target.same(left[index], right[index])) return false;\n  return true;\n};\n\nexport function useDocumentSelector<TSchema extends DocumentSchema, TResult>(\n  runtime: DocumentRuntime<TSchema>,\n  selector: DocumentSelector<TSchema, TResult>,\n  options?: DocumentSelectorOptions<TResult>\n): TResult {\n  const equality = options?.isEqual ?? objectIs;\n  const cache = useRef<SelectorCache<TSchema, TResult> | undefined>(undefined);\n  const serverCache = useRef<\n    { readonly source: (() => TResult) | undefined; readonly value: TResult } | undefined\n  >(undefined);\n\n  const read = useCallback((): TResult => {\n    const selection = track(runtime, selector);\n    const next = selection.value;\n    const previous = cache.current;\n\n    // Keep the prior reference for semantic equality on the same runtime. This\n    // is what makes inline selectors safe with useSyncExternalStore.\n    const targets = selection.targets;\n    if (previous && previous.runtime === runtime && equality(previous.value, next)) {\n      cache.current = { runtime, value: previous.value, targets };\n      return previous.value;\n    }\n\n    cache.current = { runtime, value: next, targets };\n    return next;\n  }, [equality, runtime, selector]);\n\n  const subscribe = useCallback(\n    (listener: () => void) => {\n      let targets = cache.current?.targets ?? [];\n      let unsubscribe: () => void = () => undefined;\n      const install = () => {\n        if (targets.length === 0) return () => undefined;\n        return runtime.subscribe(\n          targets.length === 1\n            ? targets[0]\n            : (targets as [ImpactTarget<unknown>, ...ImpactTarget<unknown>[]]),\n          onCommit\n        );\n      };\n      const onCommit = () => {\n        const previous = cache.current;\n        const next = read();\n        const nextTargets = cache.current?.targets ?? [];\n        if (!sameTargets(targets, nextTargets)) {\n          unsubscribe();\n          targets = nextTargets;\n          unsubscribe = install();\n        }\n        if (previous && previous.value !== next) listener();\n      };\n      unsubscribe = install();\n      return () => unsubscribe();\n    },\n    [read, runtime]\n  );\n\n  const server = options?.server;\n  const readServer = useCallback((): TResult => {\n    const previous = serverCache.current;\n    if (previous && previous.source === server) return previous.value;\n    const value = server ? server() : read();\n    serverCache.current = { source: server, value };\n    return value;\n  }, [read, server]);\n\n  return useSyncExternalStore(subscribe, read, readServer);\n}\n\nexport function useReadable<T>(readable: Readable<T>): T {\n  const subscribe = useCallback((listener: () => void) => readable.subscribe(listener), [readable]);\n  const read = useCallback(() => readable.current(), [readable]);\n  return useSyncExternalStore(subscribe, read, read);\n}\n\nexport function useHistory<TCommit>(history: LocalHistory<TCommit>): HistoryState & {\n  undo(): OperationResult<TCommit>;\n  redo(): OperationResult<TCommit>;\n} {\n  const subscribe = useCallback((listener: () => void) => history.subscribe(listener), [history]);\n  const read = useCallback(() => history.current(), [history]);\n  const state = useSyncExternalStore(subscribe, read, read);\n  const undo = useCallback(() => history.undo(), [history]);\n  const redo = useCallback(() => history.redo(), [history]);\n\n  return useMemo(() => ({ ...state, undo, redo }), [redo, state, undo]);\n}\n"],"mappings":";;;;AAyBA,MAAM,YAAe,UAAa,SAAqB,OAAO,GAAG,UAAU,KAAK;AAChF,MAAM,eACJ,MACA,UACY;AACZ,KAAI,KAAK,WAAW,MAAM,OAAQ,QAAO;AACzC,MAAK,IAAI,QAAQ,GAAG,QAAQ,KAAK,QAAQ,SAAS,EAChD,KAAI,CAAC,OAAO,KAAK,KAAK,QAAQ,MAAM,OAAO,CAAE,QAAO;AACtD,QAAO;;AAGT,SAAgB,oBACd,SACA,UACA,SACS;CACT,MAAM,WAAW,SAAS,WAAW;CACrC,MAAM,QAAQ,OAAoD,KAAA,EAAU;CAC5E,MAAM,cAAc,OAElB,KAAA,EAAU;CAEZ,MAAM,OAAO,kBAA2B;EACtC,MAAM,YAAY,MAAM,SAAS,SAAS;EAC1C,MAAM,OAAO,UAAU;EACvB,MAAM,WAAW,MAAM;EAIvB,MAAM,UAAU,UAAU;AAC1B,MAAI,YAAY,SAAS,YAAY,WAAW,SAAS,SAAS,OAAO,KAAK,EAAE;AAC9E,SAAM,UAAU;IAAE;IAAS,OAAO,SAAS;IAAO;IAAS;AAC3D,UAAO,SAAS;;AAGlB,QAAM,UAAU;GAAE;GAAS,OAAO;GAAM;GAAS;AACjD,SAAO;IACN;EAAC;EAAU;EAAS;EAAS,CAAC;CAEjC,MAAM,YAAY,aACf,aAAyB;EACxB,IAAI,UAAU,MAAM,SAAS,WAAW,EAAE;EAC1C,IAAI,oBAAgC,KAAA;EACpC,MAAM,gBAAgB;AACpB,OAAI,QAAQ,WAAW,EAAG,cAAa,KAAA;AACvC,UAAO,QAAQ,UACb,QAAQ,WAAW,IACf,QAAQ,KACP,SACL,SACD;;EAEH,MAAM,iBAAiB;GACrB,MAAM,WAAW,MAAM;GACvB,MAAM,OAAO,MAAM;GACnB,MAAM,cAAc,MAAM,SAAS,WAAW,EAAE;AAChD,OAAI,CAAC,YAAY,SAAS,YAAY,EAAE;AACtC,iBAAa;AACb,cAAU;AACV,kBAAc,SAAS;;AAEzB,OAAI,YAAY,SAAS,UAAU,KAAM,WAAU;;AAErD,gBAAc,SAAS;AACvB,eAAa,aAAa;IAE5B,CAAC,MAAM,QAAQ,CAChB;CAED,MAAM,SAAS,SAAS;AASxB,QAAO,qBAAqB,WAAW,MARpB,kBAA2B;EAC5C,MAAM,WAAW,YAAY;AAC7B,MAAI,YAAY,SAAS,WAAW,OAAQ,QAAO,SAAS;EAC5D,MAAM,QAAQ,SAAS,QAAQ,GAAG,MAAM;AACxC,cAAY,UAAU;GAAE,QAAQ;GAAQ;GAAO;AAC/C,SAAO;IACN,CAAC,MAAM,OAAO,CAEsC,CAAC;;AAG1D,SAAgB,YAAe,UAA0B;CACvD,MAAM,YAAY,aAAa,aAAyB,SAAS,UAAU,SAAS,EAAE,CAAC,SAAS,CAAC;CACjG,MAAM,OAAO,kBAAkB,SAAS,SAAS,EAAE,CAAC,SAAS,CAAC;AAC9D,QAAO,qBAAqB,WAAW,MAAM,KAAK;;AAGpD,SAAgB,WAAoB,SAGlC;CACA,MAAM,YAAY,aAAa,aAAyB,QAAQ,UAAU,SAAS,EAAE,CAAC,QAAQ,CAAC;CAC/F,MAAM,OAAO,kBAAkB,QAAQ,SAAS,EAAE,CAAC,QAAQ,CAAC;CAC5D,MAAM,QAAQ,qBAAqB,WAAW,MAAM,KAAK;CACzD,MAAM,OAAO,kBAAkB,QAAQ,MAAM,EAAE,CAAC,QAAQ,CAAC;CACzD,MAAM,OAAO,kBAAkB,QAAQ,MAAM,EAAE,CAAC,QAAQ,CAAC;AAEzD,QAAO,eAAe;EAAE,GAAG;EAAO;EAAM;EAAM,GAAG;EAAC;EAAM;EAAO;EAAK,CAAC"}

package/package.json

@@ -0,0 +1,89 @@
+{
+  "name": "doxum",
+  "version": "0.1.1",
+  "private": false,
+  "license": "MIT",
+  "description": "Doxum is a typed runtime for complex mutable documents.",
+  "type": "module",
+  "keywords": [
+    "document",
+    "state",
+    "runtime",
+    "typescript"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Isrowan/doxum.git"
+  },
+  "homepage": "https://github.com/Isrowan/doxum#readme",
+  "bugs": {
+    "url": "https://github.com/Isrowan/doxum/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./integration": {
+      "types": "./dist/integration.d.ts",
+      "import": "./dist/integration.js",
+      "require": "./dist/integration.cjs"
+    },
+    "./react": {
+      "types": "./dist/react.d.ts",
+      "import": "./dist/react.js",
+      "require": "./dist/react.cjs"
+    }
+  },
+  "peerDependencies": {
+    "react": ">=18"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    }
+  },
+  "files": [
+    "dist",
+    "skills"
+  ],
+  "sideEffects": false,
+  "devDependencies": {
+    "@eslint/js": "^9.35.0",
+    "eslint": "^9.35.0",
+    "prettier": "^3.6.2",
+    "rimraf": "^6.1.3",
+    "tsdown": "^0.21.1",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.43.0",
+    "vitest": "^4.0.16",
+    "@types/react": "^19.2.5",
+    "@types/react-dom": "^19.2.3",
+    "@types/react-test-renderer": "^19.1.0",
+    "react": "19.2.4",
+    "react-dom": "19.2.4",
+    "react-test-renderer": "19.2.4"
+  },
+  "scripts": {
+    "build": "tsdown --config tsdown.config.ts",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run --config vitest.config.ts",
+    "check": "pnpm run format:check && pnpm run lint && pnpm run typecheck && pnpm run test",
+    "bench": "vitest bench --config vitest.bench.config.ts",
+    "profile": "node --expose-gc --import tsx core/bench/profile.ts",
+    "format": "prettier --write --ignore-unknown .",
+    "format:check": "prettier --check --ignore-unknown .",
+    "lint": "eslint .",
+    "clean": "pnpm -r exec rimraf dist",
+    "release": "node scripts/release.mjs",
+    "release:resume": "node scripts/release.mjs --resume"
+  }
+}

package/skills/doxum-runtime/SKILL.md

@@ -0,0 +1,51 @@
+---
+name: doxum-runtime
+description: 'Use doxum and doxum/react to design, build, or review Doxum document runtime code. Apply for schemas, mutations, operations, views, subscriptions, and React integration.'
+---
+
+# Doxum Runtime
+
+Use this skill when a task creates, modifies, reviews, or explains Doxum code.
+It applies to `doxum`, `doxum/react`, and application code that uses
+Doxum's schema, runtime, transaction, operation, impact, projection, or React
+APIs. Do not apply it to unrelated TypeScript or React work merely because the
+application happens to contain a Doxum runtime.
+
+## Read the right reference
+
+- Start with [the English guide](references/guide.en.md) for English requests
+  or [中文指南](references/guide.zh-CN.md) for Chinese requests. They are
+  equivalent task-oriented introductions.
+- Read [the English patterns](references/patterns.en.md) or
+  [中文模式参考](references/patterns.zh-CN.md) when implementing schema models,
+  transactions, replay, selectors, views, or React code.
+- Read [the English invariants](references/invariants.en.md) or
+  [中文不变量](references/invariants.zh-CN.md) before changing mutation,
+  addressing, impact, notification, history, tree, or derived-view behavior.
+
+## Required Doxum decisions
+
+- Treat `createDocument` as the only write authority for canonical document
+  state. Application writes use `runtime.update`; replayed external operations
+  use `runtime.apply`.
+- A transaction is synchronous and atomic. Do not retain a transaction reader
+  or writer after its callback returns, and do not introduce another writable
+  state cache.
+- Use the runtime's schema selectors, anchors, addresses, and `target` APIs.
+  Do not add local path parsers, duplicate impact-target helpers, or manually
+  synchronize derived data.
+- Handle expected mutation failure from the returned `rejected` result and its
+  `MutationIssue` values. Use `tx.report` or `tx.reject` with
+  `DocumentDiagnostic` for application validation. A thrown callback error
+  rolls back and is rethrown.
+- A committed result with `observerErrors` is still committed. Do not retry its
+  write as if canonical state had been rolled back.
+- Keep `core` framework-neutral. React code belongs behind `doxum/react` and
+  must not make `core` import UI concepts.
+- Doxum does not define persistence, synchronization, authorization, or
+  conflict resolution. Keep those policies in the application boundary before
+  `apply` or `replace`.
+
+When public behavior or lifecycle semantics change, update the README and
+architecture guide and add focused tests for rollback, inverse history, impact
+or subscription behavior, and performance-sensitive collection or tree paths.

package/skills/doxum-runtime/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: 'Doxum Runtime'
+  short_description: 'Build, modify, and review Doxum runtime code safely.'
+  default_prompt: 'Use $doxum-runtime to implement this Doxum feature while preserving its runtime invariants.'