superdoc 2.28.0-next.13 → 2.28.0-next.14

package/dist/chunks/{create-super-doc-ui-B6Va_J_0.es.js → create-super-doc-ui-BRahDsch.es.js}

@@ -5774,6 +5774,43 @@ function mutationCommittedEventChangedDocument(event) {
 	if (receipt && typeof receipt === "object" && receipt.status === "NO_OP") return false;
 	return true;
 }
+function readTxId(value) {
+	return typeof value === "string" && value.length > 0 ? value : null;
+}
+function documentChangeScope(stories) {
+	return Array.isArray(stories) && stories.length > 0 ? {
+		kind: "known",
+		stories
+	} : { kind: "unknown" };
+}
+function documentChangeFromHostEvent(event) {
+	if (event.type === "collaboration:remote-changed") return {
+		cause: "remote",
+		changeTag: null,
+		txId: null,
+		scope: { kind: "unknown" }
+	};
+	if (event.type !== "mutation:committed") return null;
+	if (event.origin === "history") {
+		const result = isPlainObject(event.result) ? event.result : null;
+		if (!result || result.noop === true) return null;
+		const history = isPlainObject(result.history) ? result.history : null;
+		return {
+			cause: event.direction === "redo" ? "redo" : "undo",
+			changeTag: null,
+			txId: readTxId(history?.txId),
+			scope: documentChangeScope(result.affectedStories)
+		};
+	}
+	if (!mutationCommittedEventChangedDocument(event)) return null;
+	const receipt = isPlainObject(event.receipt) ? event.receipt : {};
+	return {
+		cause: event.cause === "user" ? "user" : "api",
+		changeTag: typeof receipt.changeTag === "string" ? receipt.changeTag : null,
+		txId: readTxId(receipt.txId),
+		scope: documentChangeScope(receipt.affectedStories)
+	};
+}
 function commandResultSucceeded(result) {
 	if (result === false) return false;
 	if (result && typeof result === "object" && result.success === false) return false;
@@ -10195,6 +10232,25 @@ function createSuperDocUI(options) {
 	state = computeState("initial");
 	lastOptimisticInlineSelectionSignature = selectionInlineValueSignature(state.selection);
 	let scheduleActiveSearchRefresh = () => {};
+	const documentChangeListeners = /* @__PURE__ */ new Set();
+	let documentChangeEpoch = 0;
+	let documentChangeSeq = 0;
+	const startDocumentChangeEpoch = () => {
+		documentChangeEpoch += 1;
+		documentChangeSeq = 0;
+	};
+	const publishDocumentChange = (event) => {
+		if (documentChangeListeners.size === 0) return;
+		const facts = documentChangeFromHostEvent(event);
+		if (!facts) return;
+		documentChangeSeq += 1;
+		const change = {
+			documentEpoch: `document-${documentChangeEpoch}`,
+			seq: documentChangeSeq,
+			...facts
+		};
+		for (const listener of Array.from(documentChangeListeners)) safeCall(() => listener(change), void 0);
+	};
 	const syncHostEventsSubscription = () => {
 		const host = getEditor()?.host;
 		const events = host?.events;
@@ -10213,6 +10269,8 @@ function createSuperDocUI(options) {
 		try {
 			const off = hostMethod(next, "subscribe")?.((event) => {
 				const type = event?.type;
+				if (type === "collaboration:document-replaced") startDocumentChangeEpoch();
+				publishDocumentChange(event);
 				const isStandaloneDocumentMutation = type === "document:mutated" && event.hasCommitEvent !== true;
 				if (type === "collaboration:document-replaced" || isStandaloneDocumentMutation || type === "mutation:committed" && mutationCommittedEventChangedDocument(event) || type === "collaboration:remote-changed") {
 					for (const [commandId, optimistic] of optimisticInlineToggles) if (optimistic.settled || type === "collaboration:document-replaced") optimisticInlineToggles.delete(commandId);
@@ -13764,8 +13822,14 @@ function createSuperDocUI(options) {
 			} catch {
 				return;
 			}
+		},
+		onChange: (listener) => {
+			if (disposed) return () => {};
+			documentChangeListeners.add(listener);
+			return () => documentChangeListeners.delete(listener);
 		}
 	};
+	documentResetHooks.push(startDocumentChangeEpoch);
 	const resolveVisibleHost = () => {
 		if (typeof HTMLElement === "undefined") return null;
 		const mountContainer = (getEditor()?.mount)?.container;
@@ -15246,6 +15310,11 @@ function createSuperDocUI(options) {
 		const scopeUnsubs = [];
 		return {
 			decorations: createDecorationsHandle((handle) => scopeUnsubs.push(() => handle.dispose())),
+			document: { onChange: (listener) => {
+				const unsub = documentHandle.onChange(listener);
+				scopeUnsubs.push(unsub);
+				return unsub;
+			} },
 			select: (selector, equality) => {
 				const sub = select(selector, equality);
 				return {
@@ -15332,6 +15401,7 @@ function createSuperDocUI(options) {
 		painterCaptureEpoch += 1;
 		painterCommandDoc = null;
 		painterModeListeners.clear();
+		documentChangeListeners.clear();
 		searchRequestGeneration += 1;
 		customCommands.clear();
 	};

package/dist/chunks/{create-super-doc-ui-8dttPeGi.cjs → create-super-doc-ui-CFlvn2wr.cjs}

@@ -5775,6 +5775,43 @@ function mutationCommittedEventChangedDocument(event) {
 	if (receipt && typeof receipt === "object" && receipt.status === "NO_OP") return false;
 	return true;
 }
+function readTxId(value) {
+	return typeof value === "string" && value.length > 0 ? value : null;
+}
+function documentChangeScope(stories) {
+	return Array.isArray(stories) && stories.length > 0 ? {
+		kind: "known",
+		stories
+	} : { kind: "unknown" };
+}
+function documentChangeFromHostEvent(event) {
+	if (event.type === "collaboration:remote-changed") return {
+		cause: "remote",
+		changeTag: null,
+		txId: null,
+		scope: { kind: "unknown" }
+	};
+	if (event.type !== "mutation:committed") return null;
+	if (event.origin === "history") {
+		const result = isPlainObject(event.result) ? event.result : null;
+		if (!result || result.noop === true) return null;
+		const history = isPlainObject(result.history) ? result.history : null;
+		return {
+			cause: event.direction === "redo" ? "redo" : "undo",
+			changeTag: null,
+			txId: readTxId(history?.txId),
+			scope: documentChangeScope(result.affectedStories)
+		};
+	}
+	if (!mutationCommittedEventChangedDocument(event)) return null;
+	const receipt = isPlainObject(event.receipt) ? event.receipt : {};
+	return {
+		cause: event.cause === "user" ? "user" : "api",
+		changeTag: typeof receipt.changeTag === "string" ? receipt.changeTag : null,
+		txId: readTxId(receipt.txId),
+		scope: documentChangeScope(receipt.affectedStories)
+	};
+}
 function commandResultSucceeded(result) {
 	if (result === false) return false;
 	if (result && typeof result === "object" && result.success === false) return false;
@@ -10196,6 +10233,25 @@ function createSuperDocUI(options) {
 	state = computeState("initial");
 	lastOptimisticInlineSelectionSignature = selectionInlineValueSignature(state.selection);
 	let scheduleActiveSearchRefresh = () => {};
+	const documentChangeListeners = /* @__PURE__ */ new Set();
+	let documentChangeEpoch = 0;
+	let documentChangeSeq = 0;
+	const startDocumentChangeEpoch = () => {
+		documentChangeEpoch += 1;
+		documentChangeSeq = 0;
+	};
+	const publishDocumentChange = (event) => {
+		if (documentChangeListeners.size === 0) return;
+		const facts = documentChangeFromHostEvent(event);
+		if (!facts) return;
+		documentChangeSeq += 1;
+		const change = {
+			documentEpoch: `document-${documentChangeEpoch}`,
+			seq: documentChangeSeq,
+			...facts
+		};
+		for (const listener of Array.from(documentChangeListeners)) safeCall(() => listener(change), void 0);
+	};
 	const syncHostEventsSubscription = () => {
 		const host = getEditor()?.host;
 		const events = host?.events;
@@ -10214,6 +10270,8 @@ function createSuperDocUI(options) {
 		try {
 			const off = hostMethod(next, "subscribe")?.((event) => {
 				const type = event?.type;
+				if (type === "collaboration:document-replaced") startDocumentChangeEpoch();
+				publishDocumentChange(event);
 				const isStandaloneDocumentMutation = type === "document:mutated" && event.hasCommitEvent !== true;
 				if (type === "collaboration:document-replaced" || isStandaloneDocumentMutation || type === "mutation:committed" && mutationCommittedEventChangedDocument(event) || type === "collaboration:remote-changed") {
 					for (const [commandId, optimistic] of optimisticInlineToggles) if (optimistic.settled || type === "collaboration:document-replaced") optimisticInlineToggles.delete(commandId);
@@ -13765,8 +13823,14 @@ function createSuperDocUI(options) {
 			} catch {
 				return;
 			}
+		},
+		onChange: (listener) => {
+			if (disposed) return () => {};
+			documentChangeListeners.add(listener);
+			return () => documentChangeListeners.delete(listener);
 		}
 	};
+	documentResetHooks.push(startDocumentChangeEpoch);
 	const resolveVisibleHost = () => {
 		if (typeof HTMLElement === "undefined") return null;
 		const mountContainer = (getEditor()?.mount)?.container;
@@ -15247,6 +15311,11 @@ function createSuperDocUI(options) {
 		const scopeUnsubs = [];
 		return {
 			decorations: createDecorationsHandle((handle) => scopeUnsubs.push(() => handle.dispose())),
+			document: { onChange: (listener) => {
+				const unsub = documentHandle.onChange(listener);
+				scopeUnsubs.push(unsub);
+				return unsub;
+			} },
 			select: (selector, equality) => {
 				const sub = select(selector, equality);
 				return {
@@ -15333,6 +15402,7 @@ function createSuperDocUI(options) {
 		painterCaptureEpoch += 1;
 		painterCommandDoc = null;
 		painterModeListeners.clear();
+		documentChangeListeners.clear();
 		searchRequestGeneration += 1;
 		customCommands.clear();
 	};

package/dist/collaboration-upgrade-engine.cjs

@@ -19,7 +19,7 @@ var COLLABORATION_UPGRADE_ENGINE_MINIMUM_NODE_MAJOR = 20;
 var PRIVATE_ENGINE_INFO = (0, _superdoc_docx_engine_collaboration_upgrade_engine.getCollaborationUpgradeEngineInfo)();
 var ENGINE_INFO = Object.freeze({
 	...PRIVATE_ENGINE_INFO,
-	superdocVersion: "2.28.0-next.13",
+	superdocVersion: "2.28.0-next.14",
 	roomSchemaVersion: Object.freeze({ ...PRIVATE_ENGINE_INFO.roomSchemaVersion }),
 	supportedBundleVersions: SUPPORTED_COLLABORATION_UPGRADE_BUNDLE_VERSIONS,
 	supportedV1ReaderContractVersions: SUPPORTED_V1_READER_CONTRACT_VERSIONS

package/dist/collaboration-upgrade-engine.es.js

@@ -18,7 +18,7 @@ var COLLABORATION_UPGRADE_ENGINE_MINIMUM_NODE_MAJOR = 20;
 var PRIVATE_ENGINE_INFO = getCollaborationUpgradeEngineInfo$1();
 var ENGINE_INFO = Object.freeze({
 	...PRIVATE_ENGINE_INFO,
-	superdocVersion: "2.28.0-next.13",
+	superdocVersion: "2.28.0-next.14",
 	roomSchemaVersion: Object.freeze({ ...PRIVATE_ENGINE_INFO.roomSchemaVersion }),
 	supportedBundleVersions: SUPPORTED_COLLABORATION_UPGRADE_BUNDLE_VERSIONS,
 	supportedV1ReaderContractVersions: SUPPORTED_V1_READER_CONTRACT_VERSIONS

package/dist/public/ui-react.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-8dttPeGi.cjs");
+const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-CFlvn2wr.cjs");
 const require_slice_source = require("../chunks/slice-source-CFaqq0Vo.cjs");
 let react = require("react");
 let use_sync_external_store_shim = require("use-sync-external-store/shim");

package/dist/public/ui-react.es.js

@@ -1,4 +1,4 @@
-import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-B6Va_J_0.es.js";
+import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-BRahDsch.es.js";
 import { t as toSliceSource } from "../chunks/slice-source-gfOhG2MW.es.js";
 import { createContext, createElement, useCallback, useContext, useEffect, useRef, useState } from "react";
 import { useSyncExternalStore } from "use-sync-external-store/shim";

package/dist/public/ui-vue.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-8dttPeGi.cjs");
+const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-CFlvn2wr.cjs");
 const require_slice_source = require("../chunks/slice-source-CFaqq0Vo.cjs");
 let superdoc_entry_vue = require("vue");
 //#region src/public/ui/vue.ts

package/dist/public/ui-vue.es.js

@@ -1,4 +1,4 @@
-import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-B6Va_J_0.es.js";
+import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-BRahDsch.es.js";
 import { t as toSliceSource } from "../chunks/slice-source-gfOhG2MW.es.js";
 import { computed, inject, onScopeDispose, provide, shallowRef, toRaw, toValue, watch } from "vue";
 //#region src/public/ui/vue.ts

package/dist/public/ui.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-8dttPeGi.cjs");
+const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-CFlvn2wr.cjs");
 //#region ../document-api/src/types/receipt.ts
 /** Read a known failure.details.reason without assuming every failure has one. */
 function getDocumentApiRejectionReason(details) {

package/dist/public/ui.es.js

@@ -1,4 +1,4 @@
-import { p as shallowEqual, s as BUILT_IN_COMMAND_IDS, t as createSuperDocUI } from "../chunks/create-super-doc-ui-B6Va_J_0.es.js";
+import { p as shallowEqual, s as BUILT_IN_COMMAND_IDS, t as createSuperDocUI } from "../chunks/create-super-doc-ui-BRahDsch.es.js";
 //#region ../document-api/src/types/receipt.ts
 /** Read a known failure.details.reason without assuming every failure has one. */
 function getDocumentApiRejectionReason(details) {