superdoc 2.18.0-next.10 → 2.18.0-next.11

package/dist/superdoc.cjs

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_rolldown_runtime = require("./chunks/rolldown-runtime-74VwNCz7.cjs");
 const require_blank_docx = require("./chunks/blank-docx-BuFAbRjs.cjs");
-const require_create_super_doc_ui = require("./chunks/create-super-doc-ui-D9JWPXRh.cjs");
+const require_create_super_doc_ui = require("./chunks/create-super-doc-ui-BwM3I7-G.cjs");
 const require_eventemitter3 = require("./chunks/eventemitter3-C_TAnXOl.cjs");
 const require_uuid = require("./chunks/uuid-BhG0ngwk.cjs");
 const require_jszip = require("./chunks/jszip-D8mAFF-r.cjs");
@@ -316,7 +316,7 @@ var shuffleArray = (array) => {
 var DEFAULT_ENDPOINT = "https://ingest.superdoc.dev/v1/collect";
 function getSuperdocVersion() {
 	try {
-		return "2.18.0-next.10";
+		return "2.18.0-next.11";
 	} catch {
 		return "unknown";
 	}
@@ -22372,7 +22372,7 @@ var SuperDoc_default = /*#__PURE__*/ require__plugin_vue_export_helper._plugin_v
 			if (!payload) return;
 			clearV2EditorFailure(payload.documentId ?? null);
 			clearV2MutationRejectionNotifications(payload.documentId ?? null);
-			const { host, mount, documentId, capabilities, editCommands, bindEditShortcuts, bindSessionShortcuts, commentsAdapter, trackedChangesAdapter, contextMenu, documentApi, documentMutationReadiness, documentApiUnavailableReason, pageMetrics, pageLayout, pageFurniture, presence, lock, collaborationProvider, fonts, replaceFile, upgradeToCollaboration, documentOpenToken } = payload;
+			const { host, mount, documentId, capabilities, editCommands, bindEditShortcuts, bindSessionShortcuts, commentsAdapter, trackedChangesAdapter, contextMenu, documentApi, documentMutationReadiness, documentApiUnavailableReason, pageMetrics, pageLayout, pageFurniture, presence, lock, connection, collaborationProvider, fonts, replaceFile, upgradeToCollaboration, documentOpenToken } = payload;
 			documentOpenTelemetry?.trackDocumentOpen(documentOpenToken ?? null, documentId ?? null);
 			const saveV2Bytes = createV2SaveQueue(async (saveOptions = {}) => {
 				if (!host || typeof host.save !== "function") throw new Error("v2-editor: save unavailable");
@@ -22649,6 +22649,7 @@ var SuperDoc_default = /*#__PURE__*/ require__plugin_vue_export_helper._plugin_v
 				pageFurniture: pageFurniture ?? null,
 				presence: presence ?? null,
 				lock: lock ?? null,
+				connection: connection ?? null,
 				provider: collaborationProvider ?? null,
 				reviewWindow: {
 					getDiagnostics: () => v2ReviewWindowController.getDiagnostics(),
@@ -24494,7 +24495,7 @@ var SuperDoc_default = /*#__PURE__*/ require__plugin_vue_export_helper._plugin_v
 			], 38);
 		};
 	}
-}, [["__scopeId", "data-v-4efb0cab"]]);
+}, [["__scopeId", "data-v-9da02d58"]]);
 //#endregion
 //#region src/core/create-app.js
 var PINIA_DEVTOOLS_SETUP_EVENT = "devtools-plugin:setup";
@@ -45370,6 +45371,14 @@ function contentControlSelectionKey(selection) {
 		return null;
 	}
 }
+function deriveCollaborationConnectionKind(snapshot, hasSyncedBefore) {
+	switch (snapshot.state) {
+		case "failed": return "failed";
+		case "degraded": return snapshot.detail === "reconnecting" ? "reconnecting" : "lost";
+		case "synced": return hasSyncedBefore ? "recovered" : "initial";
+		default: return hasSyncedBefore ? "reconnecting" : "initial";
+	}
+}
 function isV2ActiveEditorFacade(editor) {
 	return Boolean(editor && typeof editor === "object" && editor.editorVersion === 2);
 }
@@ -45437,6 +45446,12 @@ var SuperDoc = class extends require_eventemitter3.import_eventemitter3.default
 	#v2AwarenessUnsub;
 	/** Unsubscribe handle for the v2 root-doc lock observer. */
 	#v2LockUnsub;
+	/** Unsubscribe handle for the v2 collaboration connection observer. */
+	#v2ConnectionUnsub;
+	/** Latest `collaboration-connection-change` payload, for late readers. */
+	#v2ConnectionState;
+	/** Whether the current collaboration room has completed a sync at least once. */
+	#v2ConnectionHasSynced;
 	/** Lock state captured before a local → v2 collaboration promotion remount. */
 	#pendingV2LockSeed;
 	#mountWrapper;
@@ -45528,6 +45543,9 @@ var SuperDoc = class extends require_eventemitter3.import_eventemitter3.default
 		this.#abortUpgrade = null;
 		this.#v2AwarenessUnsub = null;
 		this.#v2LockUnsub = null;
+		this.#v2ConnectionUnsub = null;
+		this.#v2ConnectionState = null;
+		this.#v2ConnectionHasSynced = false;
 		this.#pendingV2LockSeed = null;
 		this.#mountWrapper = null;
 		this.#contentControlClickRoot = null;
@@ -45726,7 +45744,7 @@ var SuperDoc = class extends require_eventemitter3.import_eventemitter3.default
 		this.config.colors = shuffleArray(this.config.colors);
 		this.userColorMap = /* @__PURE__ */ new Map();
 		this.colorIndex = 0;
-		this.version = "2.18.0-next.10";
+		this.version = "2.18.0-next.11";
 		this.#log("🦋 [superdoc] Using SuperDoc version:", this.version);
 		this.superdocId = config.superdocId || require_uuid.v4();
 		this.colors = this.config.colors ?? [];
@@ -45828,7 +45846,7 @@ var SuperDoc = class extends require_eventemitter3.import_eventemitter3.default
 		return this.#diagnostics;
 	}
 	emit(event, ...args) {
-		if (event === "exception" || event === "document-replaced" || event === "ready" || event === "active-editor-change" || event === "collaboration-ready" || event === "locked") require_create_super_doc_ui.recordInteraction(this, event, () => args[0]);
+		if (event === "exception" || event === "document-replaced" || event === "ready" || event === "active-editor-change" || event === "collaboration-ready" || event === "collaboration-connection-change" || event === "locked") require_create_super_doc_ui.recordInteraction(this, event, () => args[0]);
 		return super.emit(event, ...args);
 	}
 	on(event, fn, context) {
@@ -46070,6 +46088,7 @@ var SuperDoc = class extends require_eventemitter3.import_eventemitter3.default
 		this.#onConfig("pdf:document-ready", this.config.onPdfDocumentReady);
 		this.#onConfig("sidebar-toggle", this.config.onSidebarToggle);
 		this.#onConfig("collaboration-ready", this.config.onCollaborationReady);
+		this.#onConfig("collaboration-connection-change", this.config.onCollaborationConnectionChange);
 		this.on("collaboration-ready", (payload) => this.#startV2CollaborationEventBridge(payload?.editor ?? null));
 		this.#onConfig("editor-update", this.config.onEditorUpdate);
 		this.#onConfig("tracked-changes:bulk-decision", this.config.onTrackedChangesBulkDecision);
@@ -46160,12 +46179,59 @@ var SuperDoc = class extends require_eventemitter3.import_eventemitter3.default
 			} catch {}
 			this.#v2LockUnsub = null;
 		}
+		if (this.#v2ConnectionUnsub) {
+			try {
+				this.#v2ConnectionUnsub();
+			} catch {}
+			this.#v2ConnectionUnsub = null;
+		}
 	}
 	#startV2CollaborationEventBridge(editor) {
 		this.#stopV2CollaborationEventBridge();
 		if (!isV2ActiveEditorFacade(editor)) return;
 		this.#startV2AwarenessBridge(editor);
 		this.#startV2LockBridge(editor);
+		this.#startV2ConnectionBridge(editor);
+	}
+	#startV2ConnectionBridge(editor) {
+		const connection = editor.connection;
+		if (!connection || typeof connection.subscribe !== "function") return;
+		const { documentId } = connection;
+		if (this.#v2ConnectionState?.documentId !== documentId) {
+			this.#v2ConnectionState = null;
+			this.#v2ConnectionHasSynced = false;
+		}
+		const publish = (snapshot) => {
+			if (this.#destroyed) return;
+			const previous = this.#v2ConnectionState;
+			if (previous && previous.state === snapshot.state && previous.detail === (snapshot.detail ?? null)) return;
+			const payload = {
+				documentId,
+				state: snapshot.state,
+				previousState: previous?.state ?? null,
+				kind: deriveCollaborationConnectionKind(snapshot, this.#v2ConnectionHasSynced),
+				detail: snapshot.detail ?? null,
+				superdoc: this
+			};
+			this.#v2ConnectionState = payload;
+			if (snapshot.state === "synced") this.#v2ConnectionHasSynced = true;
+			this.emit("collaboration-connection-change", payload);
+		};
+		try {
+			const initialSnapshot = connection.getSnapshot?.();
+			if (initialSnapshot) publish(initialSnapshot);
+			this.#v2ConnectionUnsub = connection.subscribe(publish);
+		} catch (err) {
+			console.warn("[SuperDoc] v2 connection bridge failed to subscribe", err);
+		}
+	}
+	/**
+	* Latest v2 collaboration connection change, or `null` when no v2
+	* collaboration session has reported one. Same payload as the
+	* `collaboration-connection-change` event.
+	*/
+	getCollaborationConnectionState() {
+		return this.#v2ConnectionState;
 	}
 	#startV2AwarenessBridge(editor) {
 		const presence = editor.presence;

package/dist/superdoc.es.js

@@ -1,6 +1,6 @@
 import { i as __toESM$2 } from "./chunks/rolldown-runtime-0pSA04fp.es.js";
 import { t as blank_default } from "./chunks/blank-docx-DzQccOlW.es.js";
-import { a as getV2TrackedChangeMutationImpact, c as createInteractionHistory, i as applyV2CommentInvalidationFromMutation, l as recordInteraction, o as DOM_CLASS_NAMES, s as closeInteractionHistory, t as createSuperDocUI } from "./chunks/create-super-doc-ui-qTSa0PbD.es.js";
+import { a as getV2TrackedChangeMutationImpact, c as createInteractionHistory, i as applyV2CommentInvalidationFromMutation, l as recordInteraction, o as DOM_CLASS_NAMES, s as closeInteractionHistory, t as createSuperDocUI } from "./chunks/create-super-doc-ui-Ci7OxbXV.es.js";
 import { t as import_eventemitter3 } from "./chunks/eventemitter3-DEIiXiH2.es.js";
 import { t as v4 } from "./chunks/uuid-H0Xcmmhy.es.js";
 import { a as init_dist$1, i as global, n as init_dist$2, o as Buffer, r as process$1, s as init_dist, t as require_jszip_min } from "./chunks/jszip-BzJ3CyxR.es.js";
@@ -315,7 +315,7 @@ var shuffleArray = (array) => {
 var DEFAULT_ENDPOINT = "https://ingest.superdoc.dev/v1/collect";
 function getSuperdocVersion() {
 	try {
-		return "2.18.0-next.10";
+		return "2.18.0-next.11";
 	} catch {
 		return "unknown";
 	}
@@ -22332,7 +22332,7 @@ var SuperDoc_default = /*#__PURE__*/ _plugin_vue_export_helper_default({
 			if (!payload) return;
 			clearV2EditorFailure(payload.documentId ?? null);
 			clearV2MutationRejectionNotifications(payload.documentId ?? null);
-			const { host, mount, documentId, capabilities, editCommands, bindEditShortcuts, bindSessionShortcuts, commentsAdapter, trackedChangesAdapter, contextMenu, documentApi, documentMutationReadiness, documentApiUnavailableReason, pageMetrics, pageLayout, pageFurniture, presence, lock, collaborationProvider, fonts, replaceFile, upgradeToCollaboration, documentOpenToken } = payload;
+			const { host, mount, documentId, capabilities, editCommands, bindEditShortcuts, bindSessionShortcuts, commentsAdapter, trackedChangesAdapter, contextMenu, documentApi, documentMutationReadiness, documentApiUnavailableReason, pageMetrics, pageLayout, pageFurniture, presence, lock, connection, collaborationProvider, fonts, replaceFile, upgradeToCollaboration, documentOpenToken } = payload;
 			documentOpenTelemetry?.trackDocumentOpen(documentOpenToken ?? null, documentId ?? null);
 			const saveV2Bytes = createV2SaveQueue(async (saveOptions = {}) => {
 				if (!host || typeof host.save !== "function") throw new Error("v2-editor: save unavailable");
@@ -22609,6 +22609,7 @@ var SuperDoc_default = /*#__PURE__*/ _plugin_vue_export_helper_default({
 				pageFurniture: pageFurniture ?? null,
 				presence: presence ?? null,
 				lock: lock ?? null,
+				connection: connection ?? null,
 				provider: collaborationProvider ?? null,
 				reviewWindow: {
 					getDiagnostics: () => v2ReviewWindowController.getDiagnostics(),
@@ -24454,7 +24455,7 @@ var SuperDoc_default = /*#__PURE__*/ _plugin_vue_export_helper_default({
 			], 38);
 		};
 	}
-}, [["__scopeId", "data-v-4efb0cab"]]);
+}, [["__scopeId", "data-v-9da02d58"]]);
 //#endregion
 //#region src/core/create-app.js
 var PINIA_DEVTOOLS_SETUP_EVENT = "devtools-plugin:setup";
@@ -45301,6 +45302,14 @@ function contentControlSelectionKey(selection) {
 		return null;
 	}
 }
+function deriveCollaborationConnectionKind(snapshot, hasSyncedBefore) {
+	switch (snapshot.state) {
+		case "failed": return "failed";
+		case "degraded": return snapshot.detail === "reconnecting" ? "reconnecting" : "lost";
+		case "synced": return hasSyncedBefore ? "recovered" : "initial";
+		default: return hasSyncedBefore ? "reconnecting" : "initial";
+	}
+}
 function isV2ActiveEditorFacade(editor) {
 	return Boolean(editor && typeof editor === "object" && editor.editorVersion === 2);
 }
@@ -45368,6 +45377,12 @@ var SuperDoc = class extends import_eventemitter3.default {
 	#v2AwarenessUnsub;
 	/** Unsubscribe handle for the v2 root-doc lock observer. */
 	#v2LockUnsub;
+	/** Unsubscribe handle for the v2 collaboration connection observer. */
+	#v2ConnectionUnsub;
+	/** Latest `collaboration-connection-change` payload, for late readers. */
+	#v2ConnectionState;
+	/** Whether the current collaboration room has completed a sync at least once. */
+	#v2ConnectionHasSynced;
 	/** Lock state captured before a local → v2 collaboration promotion remount. */
 	#pendingV2LockSeed;
 	#mountWrapper;
@@ -45459,6 +45474,9 @@ var SuperDoc = class extends import_eventemitter3.default {
 		this.#abortUpgrade = null;
 		this.#v2AwarenessUnsub = null;
 		this.#v2LockUnsub = null;
+		this.#v2ConnectionUnsub = null;
+		this.#v2ConnectionState = null;
+		this.#v2ConnectionHasSynced = false;
 		this.#pendingV2LockSeed = null;
 		this.#mountWrapper = null;
 		this.#contentControlClickRoot = null;
@@ -45657,7 +45675,7 @@ var SuperDoc = class extends import_eventemitter3.default {
 		this.config.colors = shuffleArray(this.config.colors);
 		this.userColorMap = /* @__PURE__ */ new Map();
 		this.colorIndex = 0;
-		this.version = "2.18.0-next.10";
+		this.version = "2.18.0-next.11";
 		this.#log("🦋 [superdoc] Using SuperDoc version:", this.version);
 		this.superdocId = config.superdocId || v4();
 		this.colors = this.config.colors ?? [];
@@ -45759,7 +45777,7 @@ var SuperDoc = class extends import_eventemitter3.default {
 		return this.#diagnostics;
 	}
 	emit(event, ...args) {
-		if (event === "exception" || event === "document-replaced" || event === "ready" || event === "active-editor-change" || event === "collaboration-ready" || event === "locked") recordInteraction(this, event, () => args[0]);
+		if (event === "exception" || event === "document-replaced" || event === "ready" || event === "active-editor-change" || event === "collaboration-ready" || event === "collaboration-connection-change" || event === "locked") recordInteraction(this, event, () => args[0]);
 		return super.emit(event, ...args);
 	}
 	on(event, fn, context) {
@@ -46001,6 +46019,7 @@ var SuperDoc = class extends import_eventemitter3.default {
 		this.#onConfig("pdf:document-ready", this.config.onPdfDocumentReady);
 		this.#onConfig("sidebar-toggle", this.config.onSidebarToggle);
 		this.#onConfig("collaboration-ready", this.config.onCollaborationReady);
+		this.#onConfig("collaboration-connection-change", this.config.onCollaborationConnectionChange);
 		this.on("collaboration-ready", (payload) => this.#startV2CollaborationEventBridge(payload?.editor ?? null));
 		this.#onConfig("editor-update", this.config.onEditorUpdate);
 		this.#onConfig("tracked-changes:bulk-decision", this.config.onTrackedChangesBulkDecision);
@@ -46091,12 +46110,59 @@ var SuperDoc = class extends import_eventemitter3.default {
 			} catch {}
 			this.#v2LockUnsub = null;
 		}
+		if (this.#v2ConnectionUnsub) {
+			try {
+				this.#v2ConnectionUnsub();
+			} catch {}
+			this.#v2ConnectionUnsub = null;
+		}
 	}
 	#startV2CollaborationEventBridge(editor) {
 		this.#stopV2CollaborationEventBridge();
 		if (!isV2ActiveEditorFacade(editor)) return;
 		this.#startV2AwarenessBridge(editor);
 		this.#startV2LockBridge(editor);
+		this.#startV2ConnectionBridge(editor);
+	}
+	#startV2ConnectionBridge(editor) {
+		const connection = editor.connection;
+		if (!connection || typeof connection.subscribe !== "function") return;
+		const { documentId } = connection;
+		if (this.#v2ConnectionState?.documentId !== documentId) {
+			this.#v2ConnectionState = null;
+			this.#v2ConnectionHasSynced = false;
+		}
+		const publish = (snapshot) => {
+			if (this.#destroyed) return;
+			const previous = this.#v2ConnectionState;
+			if (previous && previous.state === snapshot.state && previous.detail === (snapshot.detail ?? null)) return;
+			const payload = {
+				documentId,
+				state: snapshot.state,
+				previousState: previous?.state ?? null,
+				kind: deriveCollaborationConnectionKind(snapshot, this.#v2ConnectionHasSynced),
+				detail: snapshot.detail ?? null,
+				superdoc: this
+			};
+			this.#v2ConnectionState = payload;
+			if (snapshot.state === "synced") this.#v2ConnectionHasSynced = true;
+			this.emit("collaboration-connection-change", payload);
+		};
+		try {
+			const initialSnapshot = connection.getSnapshot?.();
+			if (initialSnapshot) publish(initialSnapshot);
+			this.#v2ConnectionUnsub = connection.subscribe(publish);
+		} catch (err) {
+			console.warn("[SuperDoc] v2 connection bridge failed to subscribe", err);
+		}
+	}
+	/**
+	* Latest v2 collaboration connection change, or `null` when no v2
+	* collaboration session has reported one. Same payload as the
+	* `collaboration-connection-change` event.
+	*/
+	getCollaborationConnectionState() {
+		return this.#v2ConnectionState;
 	}
 	#startV2AwarenessBridge(editor) {
 		const presence = editor.presence;