superdoc 2.0.0-next.24 → 2.0.0-next.26

package/dist/superdoc.cjs

@@ -6,7 +6,7 @@ const require_uuid = require("./chunks/uuid-CFp0WGVU.cjs");
 const require_jszip = require("./chunks/jszip-BdUBlUeG.cjs");
 const require__plugin_vue_export_helper = require("./chunks/_plugin-vue_export-helper-BTwbGDKw.cjs");
 const require_constants = require("./chunks/constants-sbCZ2O_A.cjs");
-const require_create_super_doc_ui = require("./chunks/create-super-doc-ui-DbFtp705.cjs");
+const require_create_super_doc_ui = require("./chunks/create-super-doc-ui-CHZKlLiH.cjs");
 let vue = require("vue");
 vue = require_rolldown_runtime.__toESM(vue);
 require("y-websocket");
@@ -1736,7 +1736,13 @@ function useSelection(params) {
 	};
 }
 const DOCUMENT_EDITOR_SELECTION_SOURCE = "document-editor";
+const COMMENT_RECONCILIATION_TOKEN = Symbol("comment-reconciliation");
 var getCommentIds = (comment) => [comment?.commentId, comment?.importedId].filter((id) => id != null).map((id) => String(id));
+var readOnlyMutationOutcome = () => ({
+	ok: false,
+	reason: "read-only-document"
+});
+var commentsAreReadOnly = (superdoc) => superdoc?.commentsStore?.getConfig?.readOnly === true || superdoc?.config?.modules?.comments?.readOnly === true;
 function getThreadDescendants(superdoc, rootComment) {
 	const store = superdoc?.commentsStore;
 	if (!store) return [];
@@ -1816,7 +1822,9 @@ function useComment(params) {
 	const resolvedByEmail = (0, vue.ref)(params.resolvedByEmail || null);
 	const resolvedByName = (0, vue.ref)(params.resolvedByName || null);
 	const trackedChangeDecision = (0, vue.ref)(params.trackedChangeDecision || null);
-	const resolveComment = ({ id, email, name, superdoc, decision }) => {
+	const resolveComment = ({ id, email, name, superdoc, decision, reconciliationToken }) => {
+		const isCanonicalReconciliation = reconciliationToken === COMMENT_RECONCILIATION_TOKEN;
+		if (commentsAreReadOnly(superdoc) && !isCanonicalReconciliation) return readOnlyMutationOutcome();
 		if (resolvedTime.value) return;
 		resolvedTime.value = Date.now();
 		resolvedById.value = id ?? null;
@@ -1854,6 +1862,7 @@ function useComment(params) {
 		});
 	};
 	const setIsInternal = ({ isInternal: newIsInternal, superdoc }) => {
+		if (commentsAreReadOnly(superdoc)) return readOnlyMutationOutcome();
 		const previousValue = isInternal.value;
 		if (previousValue === newIsInternal) return;
 		isInternal.value = newIsInternal;
@@ -1882,6 +1891,7 @@ function useComment(params) {
 		});
 	};
 	const setText = ({ text, superdoc, suppressUpdate }) => {
+		if (!suppressUpdate && commentsAreReadOnly(superdoc)) return readOnlyMutationOutcome();
 		commentText.value = text;
 		mentions.value = extractMentions(text);
 		if (suppressUpdate) return;
@@ -2863,6 +2873,11 @@ const useCommentsStore = defineStore("comments", () => {
 		allowResolve: true,
 		showResolved: false
 	});
+	const readOnlyMutationOutcome$1 = () => ({
+		ok: false,
+		reason: "read-only-document"
+	});
+	const commentsAreReadOnly$1 = () => commentsConfig.readOnly === true;
 	const viewingVisibility = (0, vue.reactive)({
 		documentMode: "editing",
 		commentsVisible: false,
@@ -2871,6 +2886,8 @@ const useCommentsStore = defineStore("comments", () => {
 	const isDebugging = false;
 	const debounceTimers = {};
 	const trackedChangeResolutionSnapshots = /* @__PURE__ */ new WeakMap();
+	const importedTrackedChangeBootstrapTasks = /* @__PURE__ */ new Map();
+	let importedTrackedChangeBootstrapGeneration = 0;
 	const isPreviewCommentsDebugEnabled = () => {
 		if (typeof window === "undefined") return false;
 		return "__labsSuperDocV2PreviewDebug" in window;
@@ -3310,7 +3327,7 @@ const useCommentsStore = defineStore("comments", () => {
 		}
 		activeEditor?.commands?.setActiveComment({ commentId: activeComment.value });
 	};
-	const handleTrackedChangeUpdate = ({ superdoc, params, broadcastChanges = true }) => {
+	const handleTrackedChangeUpdate = ({ superdoc, params, broadcastChanges = true, documentState = void 0 }) => {
 		const span = startInteractionSpan("store.trackedChanges.handleUpdate", "store-reconciliation", {
 			event: params?.event ?? null,
 			changeId: params?.changeId ?? null,
@@ -3325,7 +3342,8 @@ const useCommentsStore = defineStore("comments", () => {
 			const normalizedDocumentId = documentId != null ? String(documentId) : null;
 			if (!(trackedChangeDisplayType === "tableInsert" || trackedChangeDisplayType === "tableDelete") && normalizedChangeId) {
 				const effectiveDocumentId = normalizedDocumentId ?? (superdoc?.activeEditor?.options?.documentId != null ? String(superdoc.activeEditor.options.documentId) : null);
-				const docState = (effectiveDocumentId ? superdocStore.getDocument(effectiveDocumentId)?.getEditor?.() : null)?.state ?? superdoc?.activeEditor?.state ?? null;
+				const docEditor = effectiveDocumentId ? superdocStore.getDocument(effectiveDocumentId)?.getEditor?.() : null;
+				const docState = documentState !== void 0 ? documentState : docEditor?.state ?? superdoc?.activeEditor?.state ?? null;
 				if (docState) {
 					const { ranges: tableRanges, ids: structuralIds } = computeTrackedTableSummaryForState(docState);
 					const ranges = trackChangesHelpers.getTrackChanges(docState, normalizedChangeId);
@@ -3459,7 +3477,7 @@ const useCommentsStore = defineStore("comments", () => {
 					});
 					return;
 				}
-				addComment({
+				addHydratedComment({
 					superdoc,
 					comment,
 					broadcastChanges
@@ -3481,7 +3499,10 @@ const useCommentsStore = defineStore("comments", () => {
 					decision: params.decision ?? null,
 					superdoc
 				};
-				if (existingTrackedChange && !existingTrackedChange.resolvedTime) existingTrackedChange.resolveComment(resolveArgs);
+				if (existingTrackedChange && !existingTrackedChange.resolvedTime) existingTrackedChange.resolveComment({
+					...resolveArgs,
+					reconciliationToken: COMMENT_RECONCILIATION_TOKEN
+				});
 			}
 		} finally {
 			endInteractionSpan(span);
@@ -3716,8 +3737,9 @@ const useCommentsStore = defineStore("comments", () => {
 		if (isV2EditorActive(superdoc)) return;
 		superdoc?.activeEditor?.commands?.removeComment({ commentId: "pending" });
 	};
-	const addComment = ({ superdoc, comment, skipEditorUpdate = false, broadcastChanges = true }) => {
-		const v2Adapter = !skipEditorUpdate ? getV2CommentsAdapter(superdoc) : null;
+	const addCommentInternal = ({ superdoc, comment, skipEditorUpdate = false, broadcastChanges = true, isHydration = false }) => {
+		if (commentsAreReadOnly$1() && !isHydration) return readOnlyMutationOutcome$1();
+		const v2Adapter = !skipEditorUpdate && !isHydration ? getV2CommentsAdapter(superdoc) : null;
 		if (v2Adapter && !comment.trackedChange) {
 			const text = normalizeV2CommentDraftText(pendingComment.value ? currentCommentText.value : comment.commentText);
 			const target = pendingComment.value ? pendingV2CommentTarget.value : null;
@@ -3802,7 +3824,21 @@ const useCommentsStore = defineStore("comments", () => {
 			comment: newComment
 		};
 	};
+	const addComment = ({ superdoc, comment, skipEditorUpdate = false, broadcastChanges = true }) => addCommentInternal({
+		superdoc,
+		comment,
+		skipEditorUpdate,
+		broadcastChanges
+	});
+	const addHydratedComment = ({ superdoc, comment, skipEditorUpdate = false, broadcastChanges = true }) => addCommentInternal({
+		superdoc,
+		comment,
+		skipEditorUpdate,
+		broadcastChanges,
+		isHydration: true
+	});
 	const deleteComment = ({ commentId: commentIdToDelete, superdoc }) => {
+		if (commentsAreReadOnly$1()) return Promise.resolve(readOnlyMutationOutcome$1());
 		const commentIndex = commentsList.value.findIndex((c) => c.commentId === commentIdToDelete);
 		const comment = commentsList.value[commentIndex];
 		if (!comment) return Promise.resolve({
@@ -3991,6 +4027,7 @@ const useCommentsStore = defineStore("comments", () => {
 		};
 	};
 	const replyCommentV2 = async ({ superdoc, parentCommentId, text } = {}) => {
+		if (commentsAreReadOnly$1()) return readOnlyMutationOutcome$1();
 		const v2Adapter = getV2CommentsAdapter(superdoc);
 		if (!v2Adapter) return {
 			ok: false,
@@ -4025,6 +4062,7 @@ const useCommentsStore = defineStore("comments", () => {
 		});
 	};
 	const editCommentV2 = async ({ superdoc, commentId, text } = {}) => {
+		if (commentsAreReadOnly$1()) return readOnlyMutationOutcome$1();
 		const v2Adapter = getV2CommentsAdapter(superdoc);
 		if (!v2Adapter) return {
 			ok: false,
@@ -4073,6 +4111,7 @@ const useCommentsStore = defineStore("comments", () => {
 		});
 	};
 	const resolveCommentV2 = async ({ superdoc, commentId } = {}) => {
+		if (commentsAreReadOnly$1()) return readOnlyMutationOutcome$1();
 		const v2Adapter = getV2CommentsAdapter(superdoc);
 		if (!v2Adapter) return {
 			ok: false,
@@ -4119,6 +4158,7 @@ const useCommentsStore = defineStore("comments", () => {
 		return result;
 	};
 	const reopenCommentV2 = async ({ superdoc, commentId } = {}) => {
+		if (commentsAreReadOnly$1()) return readOnlyMutationOutcome$1();
 		const v2Adapter = getV2CommentsAdapter(superdoc);
 		if (!v2Adapter) return {
 			ok: false,
@@ -4341,21 +4381,139 @@ const useCommentsStore = defineStore("comments", () => {
 		if (typeof creatorName !== "string") return null;
 		return creatorName.replace(/\s*\(imported\)\s*$/u, "").trim() || null;
 	};
-	const bootstrapImportedTrackedChangeComments = (editor, superdoc) => {
-		if (!editor || !superdoc) return;
-		createCommentForTrackChanges(editor, superdoc);
+	const readMountedEditorSnapshot = (editor) => {
+		if (!editor) return null;
+		try {
+			if (editor.isDestroyed === true) return null;
+			const view = editor.view;
+			if (!view || view.isDestroyed === true || view.destroyed === true) return null;
+			const state = view.state;
+			if (!state) return null;
+			return {
+				view,
+				state
+			};
+		} catch {
+			return null;
+		}
+	};
+	const normalizeBootstrapDocumentId = (documentId) => documentId !== void 0 && documentId !== null && String(documentId).length > 0 ? String(documentId) : null;
+	const cancelImportedTrackedChangeBootstrap = (documentId) => {
+		const normalizedDocumentId = normalizeBootstrapDocumentId(documentId);
+		const entries = normalizedDocumentId ? [[normalizedDocumentId, importedTrackedChangeBootstrapTasks.get(normalizedDocumentId)]] : Array.from(importedTrackedChangeBootstrapTasks.entries());
+		let canceled = 0;
+		for (const [taskDocumentId, task] of entries) {
+			if (!task) continue;
+			importedTrackedChangeBootstrapTasks.delete(taskDocumentId);
+			if (task.timeoutHandle !== null && task.timeoutHandle !== void 0) clearTimeout(task.timeoutHandle);
+			canceled += 1;
+		}
+		return canceled;
+	};
+	const captureImportedTrackedChangeBootstrapSnapshot = (editor) => {
+		const mountedEditor = readMountedEditorSnapshot(editor);
+		if (!mountedEditor) return null;
+		let trackedChanges = [];
+		try {
+			trackedChanges = trackChangesHelpers.getTrackChanges(mountedEditor.state) ?? [];
+		} catch {
+			return null;
+		}
+		const enumerateStructuralChanges = trackChangesHelpers?.enumerateStructuralRowChanges;
+		let structuralChanges = [];
+		if (typeof enumerateStructuralChanges === "function") try {
+			structuralChanges = enumerateStructuralChanges(mountedEditor.state) ?? [];
+		} catch {
+			structuralChanges = [];
+		}
+		let storySnapshots = [];
+		if (typeof getTrackedChangeIndex === "function") try {
+			storySnapshots = getTrackedChangeIndex(editor)?.getAll?.() ?? [];
+		} catch {
+			storySnapshots = [];
+		}
+		return {
+			...mountedEditor,
+			trackedChanges,
+			structuralChanges,
+			storySnapshots
+		};
+	};
+	const bootstrapImportedTrackedChangeComments = (editor, superdoc, snapshot = null) => {
+		if (!editor || !superdoc) return false;
+		const captured = snapshot ?? captureImportedTrackedChangeBootstrapSnapshot(editor);
+		if (!captured) return false;
+		createCommentForTrackChanges(editor, superdoc, captured.trackedChanges, {
+			editorState: captured.state,
+			editorView: captured.view
+		});
 		syncStoryTrackedChangeComments({
 			superdoc,
-			editor
+			editor,
+			snapshots: captured.storySnapshots,
+			documentState: captured.state,
+			resolveFromEditor: false
 		});
 		syncStructuralTrackedChangeComments({
 			superdoc,
-			editor
+			editor,
+			structuralChanges: captured.structuralChanges
 		});
+		return true;
+	};
+	const isCurrentImportedTrackedChangeBootstrap = (task) => {
+		if (!task) return false;
+		if (importedTrackedChangeBootstrapTasks.get(task.documentId) !== task) return false;
+		try {
+			const editorDocumentId = task.editor?.options?.documentId;
+			if (editorDocumentId != null && String(editorDocumentId) !== task.documentId) return false;
+			const mountedDocument = superdocStore.getDocument(task.documentId);
+			if (!mountedDocument) return false;
+			if (mountedDocument.getEditor?.() !== task.editor) return false;
+		} catch {
+			return false;
+		}
+		return true;
+	};
+	const runImportedTrackedChangeBootstrap = (task) => {
+		if (!isCurrentImportedTrackedChangeBootstrap(task)) {
+			if (importedTrackedChangeBootstrapTasks.get(task?.documentId) === task) importedTrackedChangeBootstrapTasks.delete(task.documentId);
+			return false;
+		}
+		const snapshot = captureImportedTrackedChangeBootstrapSnapshot(task.editor);
+		if (!snapshot || !isCurrentImportedTrackedChangeBootstrap(task)) {
+			if (importedTrackedChangeBootstrapTasks.get(task.documentId) === task) importedTrackedChangeBootstrapTasks.delete(task.documentId);
+			return false;
+		}
+		try {
+			return bootstrapImportedTrackedChangeComments(task.editor, task.superdoc, snapshot);
+		} finally {
+			if (importedTrackedChangeBootstrapTasks.get(task.documentId) === task) importedTrackedChangeBootstrapTasks.delete(task.documentId);
+		}
+	};
+	const scheduleImportedTrackedChangeBootstrap = ({ editor, superdoc, documentId, defer = true }) => {
+		const normalizedDocumentId = normalizeBootstrapDocumentId(documentId);
+		if (!normalizedDocumentId || !editor || !superdoc) return false;
+		cancelImportedTrackedChangeBootstrap(normalizedDocumentId);
+		const task = {
+			documentId: normalizedDocumentId,
+			editor,
+			superdoc,
+			generation: ++importedTrackedChangeBootstrapGeneration,
+			timeoutHandle: null
+		};
+		importedTrackedChangeBootstrapTasks.set(normalizedDocumentId, task);
+		if (!defer) return runImportedTrackedChangeBootstrap(task);
+		task.timeoutHandle = setTimeout(() => {
+			task.timeoutHandle = null;
+			runImportedTrackedChangeBootstrap(task);
+		}, 0);
+		return true;
 	};
 	function removeCommentsForDocument(documentId) {
 		const activeDocumentId = documentId != null ? String(documentId) : null;
 		if (!activeDocumentId) return;
+		cancelImportedTrackedChangeBootstrap(activeDocumentId);
 		const removedComments = commentsList.value.filter((comment) => belongsToDocument(comment, activeDocumentId, { allowSingleDocumentMismatch: true }));
 		if (!removedComments.length) return;
 		const removedAliasIds = /* @__PURE__ */ new Set();
@@ -4386,7 +4544,7 @@ const useCommentsStore = defineStore("comments", () => {
 			if (!htmlContent && !comment.trackedChange) return;
 			const creatorName = normalizeImportedCreatorName(comment.creatorName);
 			const importedName = creatorName ? `${creatorName} (imported)` : null;
-			addComment({
+			addHydratedComment({
 				superdoc,
 				comment: useComment({
 					fileId: documentId,
@@ -4423,16 +4581,29 @@ const useCommentsStore = defineStore("comments", () => {
 			});
 		});
 		if (replacedFile) {
-			bootstrapImportedTrackedChangeComments(editor, superdoc);
+			scheduleImportedTrackedChangeBootstrap({
+				editor,
+				superdoc,
+				documentId,
+				defer: false
+			});
 			return;
 		}
-		setTimeout(() => {
-			bootstrapImportedTrackedChangeComments(editor, superdoc);
-		}, 0);
+		scheduleImportedTrackedChangeBootstrap({
+			editor,
+			superdoc,
+			documentId
+		});
 	};
 	const createCommentForTrackChanges = (editor, superdoc, trackedChangesOverride = null, options = {}) => {
-		const { reopenResolved = false, refreshExisting = false, broadcastChanges = true } = options;
-		const trackedChanges = trackedChangesOverride ?? trackChangesHelpers.getTrackChanges(editor.state);
+		const { reopenResolved = false, refreshExisting = false, broadcastChanges = true, editorState: editorStateOverride = null, editorView: editorViewOverride = null } = options;
+		const mountedEditor = editorStateOverride ? {
+			state: editorStateOverride,
+			view: editorViewOverride
+		} : readMountedEditorSnapshot(editor);
+		if (!mountedEditor?.state) return;
+		const editorState = mountedEditor.state;
+		const trackedChanges = trackedChangesOverride ?? trackChangesHelpers.getTrackChanges(editorState);
 		const groupedChanges = groupChanges(trackedChanges);
 		const activeDocumentId = editor?.options?.documentId != null ? String(editor.options.documentId) : null;
 		if (!activeDocumentId) return;
@@ -4477,7 +4648,7 @@ const useCommentsStore = defineStore("comments", () => {
 				event: existingTrackedChange ? "update" : "add",
 				marks,
 				nodes: [],
-				newEditorState: editor.state,
+				newEditorState: editorState,
 				documentId,
 				trackedChangesForId: changesByIdMap.get(id) || []
 			});
@@ -4490,7 +4661,8 @@ const useCommentsStore = defineStore("comments", () => {
 				handleTrackedChangeUpdate({
 					superdoc,
 					params,
-					broadcastChanges
+					broadcastChanges,
+					documentState: editorState
 				});
 				if (!existingTrackedChange) {
 					skipIds.add(normalizedId);
@@ -4499,9 +4671,15 @@ const useCommentsStore = defineStore("comments", () => {
 				}
 			}
 		});
-		const { tr } = editor.view.state;
+		const editorView = mountedEditor.view;
+		try {
+			if (!editorView || editor.view !== editorView || editorView.isDestroyed === true || editorView.destroyed === true) return;
+		} catch {
+			return;
+		}
+		const { tr } = editorState;
 		tr.setMeta(CommentsPluginKey, { type: "force" });
-		editor.view.dispatch(tr);
+		editorView.dispatch(tr);
 	};
 	const pruneSuppressedInlineTableComments = ({ suppressedIds, activeDocumentId, superdoc = null, broadcastChanges = true }) => {
 		if (!(suppressedIds instanceof Set) || !suppressedIds.size || !activeDocumentId) return;
@@ -4874,6 +5052,10 @@ const useCommentsStore = defineStore("comments", () => {
 		return reconcilePromise;
 	};
 	const decideTrackedChangeFromSidebar = ({ superdoc, comment, decision }) => {
+		if (commentsAreReadOnly$1()) return {
+			ok: false,
+			reason: "read-only-document"
+		};
 		if (!comment?.trackedChange) return { ok: false };
 		const v2Adapter = getV2TrackedChangesAdapter(superdoc);
 		if (v2Adapter) {
@@ -5218,46 +5400,52 @@ const useCommentsStore = defineStore("comments", () => {
 		if (!superdoc || !editor) return;
 		const activeDocumentId = editor?.options?.documentId != null ? String(editor.options.documentId) : null;
 		if (!activeDocumentId) return;
-		const trackedChanges = trackChangesHelpers.getTrackChanges(editor.state);
+		const captured = captureImportedTrackedChangeBootstrapSnapshot(editor);
+		if (!captured) return;
+		const trackedChanges = captured.trackedChanges;
 		const liveTrackedChangeIds = /* @__PURE__ */ new Set();
 		trackedChanges.forEach((change) => {
 			const id = change?.mark?.attrs?.id;
 			if (id == null) return;
 			liveTrackedChangeIds.add(String(id));
 		});
-		const trackedChangeIndex = typeof getTrackedChangeIndex === "function" ? getTrackedChangeIndex(editor) : null;
-		let storySnapshots = [];
-		try {
-			storySnapshots = trackedChangeIndex?.getAll?.() ?? [];
-		} catch {}
+		const storySnapshots = captured.storySnapshots;
 		pruneStaleTrackedChangeComments(liveTrackedChangeIds, new Set(storySnapshots.map((snapshot) => snapshot?.anchorKey).filter((anchorKey) => typeof anchorKey === "string" && anchorKey.length > 0)), activeDocumentId, superdoc, { broadcastChanges });
 		createCommentForTrackChanges(editor, superdoc, trackedChanges, {
 			reopenResolved: true,
 			refreshExisting: true,
-			broadcastChanges
+			broadcastChanges,
+			editorState: captured.state,
+			editorView: captured.view
 		});
 		syncStoryTrackedChangeComments({
 			superdoc,
 			editor,
 			broadcastChanges,
-			snapshots: storySnapshots
+			snapshots: storySnapshots,
+			documentState: captured.state
 		});
 		syncStructuralTrackedChangeComments({
 			superdoc,
 			editor,
-			broadcastChanges
+			broadcastChanges,
+			structuralChanges: captured.structuralChanges
 		});
 	};
-	const syncStructuralTrackedChangeComments = ({ superdoc, editor, broadcastChanges = true }) => {
+	const syncStructuralTrackedChangeComments = ({ superdoc, editor, broadcastChanges = true, structuralChanges: structuralChangesOverride = null }) => {
 		const activeDocumentId = editor?.options?.documentId != null ? String(editor.options.documentId) : null;
 		if (!activeDocumentId) return;
 		const enumerate = trackChangesHelpers?.enumerateStructuralRowChanges;
 		if (typeof enumerate !== "function") return;
-		let structuralChanges = [];
-		try {
-			structuralChanges = enumerate(editor.state) ?? [];
-		} catch {
-			structuralChanges = [];
+		let structuralChanges = structuralChangesOverride;
+		if (!Array.isArray(structuralChanges)) {
+			const mountedEditor = readMountedEditorSnapshot(editor);
+			if (!mountedEditor) return;
+			try {
+				structuralChanges = enumerate(mountedEditor.state) ?? [];
+			} catch {
+				structuralChanges = [];
+			}
 		}
 		for (const structural of structuralChanges) {
 			if (!structural?.decidable || !structural?.wholeTable) continue;
@@ -5304,13 +5492,19 @@ const useCommentsStore = defineStore("comments", () => {
 			});
 		}
 	};
-	const syncStoryTrackedChangeComments = ({ superdoc, editor, broadcastChanges = true, snapshots = null }) => {
+	const syncStoryTrackedChangeComments = ({ superdoc, editor, broadcastChanges = true, snapshots = null, documentState = void 0, resolveFromEditor = true }) => {
 		const activeDocumentId = editor?.options?.documentId != null ? String(editor.options.documentId) : null;
 		if (!activeDocumentId) return;
 		let resolvedSnapshots = snapshots;
 		if (!Array.isArray(resolvedSnapshots)) {
 			if (typeof getTrackedChangeIndex !== "function") return;
-			const index = getTrackedChangeIndex(editor);
+			if (!readMountedEditorSnapshot(editor)) return;
+			let index = null;
+			try {
+				index = getTrackedChangeIndex(editor);
+			} catch {
+				return;
+			}
 			if (!index) return;
 			try {
 				resolvedSnapshots = index.getAll();
@@ -5325,7 +5519,9 @@ const useCommentsStore = defineStore("comments", () => {
 				editor,
 				snapshot,
 				documentId: activeDocumentId,
-				broadcastChanges
+				broadcastChanges,
+				documentState,
+				resolveFromEditor
 			});
 		}
 	};
@@ -5342,7 +5538,7 @@ const useCommentsStore = defineStore("comments", () => {
 		if (snapshot.type === "delete") return true;
 		return snapshot.type === "structural" && snapshot.subtype === "table-delete";
 	};
-	const buildStoryTrackedChangeParams = ({ editor, snapshot, documentId, event }) => {
+	const buildStoryTrackedChangeParams = ({ editor, snapshot, documentId, event, resolveFromEditor = true }) => {
 		const trackedChangeType = getStoryTrackedChangeType(snapshot);
 		const trackedChangeDisplayType = getStoryTrackedChangeDisplayType(snapshot);
 		const fallbackParams = {
@@ -5366,7 +5562,7 @@ const useCommentsStore = defineStore("comments", () => {
 			trackedChangeStoryLabel: snapshot.storyLabel,
 			trackedChangeAnchorKey: snapshot.anchorKey
 		};
-		if (typeof resolveTrackedChangeInStory !== "function") return fallbackParams;
+		if (!resolveFromEditor || typeof resolveTrackedChangeInStory !== "function") return fallbackParams;
 		let resolvedChange = null;
 		try {
 			resolvedChange = resolveTrackedChangeInStory(editor, {
@@ -5403,7 +5599,7 @@ const useCommentsStore = defineStore("comments", () => {
 		resolvedParams.trackedChangeAnchorKey = snapshot.anchorKey;
 		return resolvedParams;
 	};
-	const upsertStoryTrackedChangeComment = ({ superdoc, editor, snapshot, documentId, broadcastChanges }) => {
+	const upsertStoryTrackedChangeComment = ({ superdoc, editor, snapshot, documentId, broadcastChanges, documentState, resolveFromEditor }) => {
 		if (!snapshot?.runtimeRef?.rawId) return;
 		const existingComment = commentsList.value.find((comment) => {
 			if (!comment?.trackedChange) return false;
@@ -5418,9 +5614,11 @@ const useCommentsStore = defineStore("comments", () => {
 				editor,
 				snapshot,
 				documentId,
-				event: existingComment ? "update" : "add"
+				event: existingComment ? "update" : "add",
+				resolveFromEditor
 			}),
-			broadcastChanges
+			broadcastChanges,
+			documentState
 		});
 		if (existingComment) {
 			existingComment.trackedChangeStory = snapshot.story;
@@ -5736,9 +5934,11 @@ const useCommentsStore = defineStore("comments", () => {
 		getPendingComment,
 		showAddComment,
 		addComment,
+		addHydratedComment,
 		cancelComment,
 		deleteComment,
 		removePendingComment,
+		cancelImportedTrackedChangeBootstrap,
 		removeCommentsForDocument,
 		processLoadedDocxComments,
 		translateCommentsForExport,
@@ -6368,7 +6568,9 @@ var _sfc_main$34 = {
 				key: "delete"
 			}
 		});
+		const reviewMutationsVisible = (0, vue.computed)(() => props.config.readOnly !== true);
 		const generallyAllowed = (0, vue.computed)(() => {
+			if (!reviewMutationsVisible.value) return false;
 			if (!props.comment) return false;
 			if (props.comment.resolvedTime) return false;
 			if (commentsStore.pendingComment) return false;
@@ -6377,6 +6579,7 @@ var _sfc_main$34 = {
 		});
 		const allowResolve = (0, vue.computed)(() => {
 			if (!generallyAllowed.value) return false;
+			if (!props.comment.trackedChange && props.config.allowResolve === false) return false;
 			if (props.comment.parentCommentId) return false;
 			if (props.comment.trackedChangeParentId) return false;
 			const context = {
@@ -6399,6 +6602,8 @@ var _sfc_main$34 = {
 			else return isAllowed(PERMISSIONS.REJECT_OTHER, role, isInternal, context);
 		});
 		const allowReopen = (0, vue.computed)(() => {
+			if (!reviewMutationsVisible.value) return false;
+			if (props.config.allowResolve === false) return false;
 			if (!props.reopenSupported) return false;
 			if (!props.comment) return false;
 			if (!props.comment.resolvedTime) return false;
@@ -6423,11 +6628,12 @@ var _sfc_main$34 = {
 			return true;
 		});
 		const getOverflowOptions = (0, vue.computed)(() => {
-			if (!generallyAllowed.value) return false;
+			if (!reviewMutationsVisible.value) return [];
+			if (!generallyAllowed.value) return [];
 			if (props.writeDisabledReason) return [];
 			const allowedOptions = [];
 			const options = /* @__PURE__ */ new Set();
-			if (!props.config.readOnly && isCommentOwnedByCurrentUser(props.comment)) options.add("edit");
+			if (isCommentOwnedByCurrentUser(props.comment)) options.add("edit");
 			const isOwnComment$1 = isCommentOwnedByCurrentUser(props.comment);
 			const context = {
 				comment: props.comment,
@@ -6440,18 +6646,25 @@ var _sfc_main$34 = {
 			return allowedOptions;
 		});
 		const handleResolve = () => {
+			if (!reviewMutationsVisible.value) return;
+			if (!props.comment?.trackedChange && props.config.allowResolve === false) return;
 			if (props.resolveDisabledReason) return;
 			emit("resolve");
 		};
 		const handleReject = () => {
+			if (!reviewMutationsVisible.value) return;
 			if (props.rejectDisabledReason) return;
 			emit("reject");
 		};
 		const handleReopen = () => {
+			if (!reviewMutationsVisible.value || props.config.allowResolve === false) return;
 			if (props.reopenDisabledReason) return;
 			emit("reopen");
 		};
-		const handleSelect = (value) => emit("overflow-select", value);
+		const handleSelect = (value) => {
+			if (!reviewMutationsVisible.value) return;
+			emit("overflow-select", value);
+		};
 		const isImported = (0, vue.computed)(() => {
 			if (!(props.comment.origin != null || !!props.comment.importedAuthor?.name)) return false;
 			if (isCommentOwnedByCurrentUser(props.comment)) return false;
@@ -6477,6 +6690,7 @@ var _sfc_main$34 = {
 				allowResolve.value ? ((0, vue.openBlock)(), (0, vue.createElementBlock)("div", {
 					key: 0,
 					class: (0, vue.normalizeClass)(["overflow-menu__icon", { "sd-is-disabled": Boolean(__props.resolveDisabledReason) }]),
+					"data-comment-action": "resolve",
 					"data-disabled-reason": __props.resolveDisabledReason || null,
 					"aria-disabled": Boolean(__props.resolveDisabledReason),
 					innerHTML: (0, vue.unref)(superdocIcons).markDone,
@@ -6485,6 +6699,7 @@ var _sfc_main$34 = {
 				allowReject.value ? ((0, vue.openBlock)(), (0, vue.createElementBlock)("div", {
 					key: 1,
 					class: (0, vue.normalizeClass)(["overflow-menu__icon", { "sd-is-disabled": Boolean(__props.rejectDisabledReason) }]),
+					"data-comment-action": "reject",
 					"data-disabled-reason": __props.rejectDisabledReason || null,
 					"aria-disabled": Boolean(__props.rejectDisabledReason),
 					innerHTML: (0, vue.unref)(superdocIcons).rejectChange,
@@ -6502,6 +6717,7 @@ var _sfc_main$34 = {
 				}, null, 10, _hoisted_9$3)) : (0, vue.createCommentVNode)("", true),
 				allowOverflow.value ? ((0, vue.openBlock)(), (0, vue.createBlock)(CommentsDropdown_default, {
 					key: 3,
+					"data-comment-action": "overflow",
 					options: getOverflowOptions.value,
 					onSelect: handleSelect,
 					"content-style": { fontFamily: (0, vue.unref)(uiFontFamily) }
@@ -6516,7 +6732,7 @@ var _sfc_main$34 = {
 		};
 	}
 };
-var CommentHeader_default = /* @__PURE__ */ require__plugin_vue_export_helper.__plugin_vue_export_helper_default(_sfc_main$34, [["__scopeId", "data-v-49c3f013"]]);
+var CommentHeader_default = /* @__PURE__ */ require__plugin_vue_export_helper.__plugin_vue_export_helper_default(_sfc_main$34, [["__scopeId", "data-v-359c13bb"]]);
 var _hoisted_1$26 = { class: "input-section" };
 var TEXTAREA_MIN_HEIGHT = 28;
 var TEXTAREA_MAX_HEIGHT = 132;
@@ -6939,8 +7155,14 @@ var _sfc_main$32 = {
 		const showInputSection = (0, vue.computed)(() => {
 			return !getConfig.readOnly && isDialogActive.value && !props.comment.resolvedTime && !isEditingAnyComment.value;
 		});
+		const readOnlyMutationOutcome$1 = () => ({
+			ok: false,
+			reason: "read-only-document"
+		});
+		const commentsAreReadOnly$1 = () => getConfig.value?.readOnly === true;
 		const isReplying = (0, vue.ref)(false);
 		const startReply = () => {
+			if (commentsAreReadOnly$1()) return readOnlyMutationOutcome$1();
 			isReplying.value = true;
 			(0, vue.nextTick)(() => {
 				commentInput.value?.focus?.();
@@ -7042,6 +7264,7 @@ var _sfc_main$32 = {
 			return comments.value.some((c) => c.commentId === editingCommentId.value);
 		});
 		const shouldShowInternalExternal = (0, vue.computed)(() => {
+			if (getConfig.value.readOnly) return false;
 			if (!proxy.$superdoc.config.isInternal) return false;
 			if (isV2Mode.value) return false;
 			return !suppressInternalExternal.value && !props.comment.trackedChange;
@@ -7130,6 +7353,7 @@ var _sfc_main$32 = {
 			isCommentHighlighted.value = false;
 		};
 		const handleAddComment = async () => {
+			if (commentsAreReadOnly$1()) return readOnlyMutationOutcome$1();
 			if (isV2Mode.value && v2CommentsAdapter.value && !isPendingNewComment.value) {
 				const outcome = await commentsStore.replyCommentV2({
 					superdoc: proxy.$superdoc,
@@ -7220,6 +7444,7 @@ var _sfc_main$32 = {
 			return v2WriteCapability.value?.reason ?? "v2-write-unavailable";
 		});
 		const handleReject = async () => {
+			if (commentsAreReadOnly$1()) return readOnlyMutationOutcome$1();
 			const customHandler = proxy.$superdoc.config.onTrackedChangeBubbleReject;
 			if (props.comment.trackedChange) {
 				if (isV2Mode.value) {
@@ -7272,6 +7497,11 @@ var _sfc_main$32 = {
 			});
 		};
 		const handleResolve = async () => {
+			if (commentsAreReadOnly$1()) return readOnlyMutationOutcome$1();
+			if (!props.comment.trackedChange && getConfig.value?.allowResolve === false) return {
+				ok: false,
+				reason: "resolve-disabled"
+			};
 			const customHandler = proxy.$superdoc.config.onTrackedChangeBubbleAccept;
 			if (props.comment.trackedChange && isV2Mode.value) {
 				const outcome = await commentsStore.decideTrackedChangeFromSidebar({
@@ -7324,6 +7554,11 @@ var _sfc_main$32 = {
 			});
 		};
 		const handleReopen = async () => {
+			if (commentsAreReadOnly$1()) return readOnlyMutationOutcome$1();
+			if (getConfig.value?.allowResolve === false) return {
+				ok: false,
+				reason: "resolve-disabled"
+			};
 			if (!isV2Mode.value || !v2CommentsAdapter.value) return;
 			if (!(await commentsStore.reopenCommentV2({
 				superdoc: proxy.$superdoc,
@@ -7336,6 +7571,7 @@ var _sfc_main$32 = {
 			});
 		};
 		const handleOverflowSelect = (value, comment) => {
+			if (commentsAreReadOnly$1()) return readOnlyMutationOutcome$1();
 			switch (value) {
 				case "edit":
 					currentCommentText.value = comment?.commentText?.value ?? comment?.commentText ?? "";
@@ -7356,6 +7592,7 @@ var _sfc_main$32 = {
 			}
 		};
 		const handleCommentUpdate = async (comment) => {
+			if (commentsAreReadOnly$1()) return readOnlyMutationOutcome$1();
 			if (isV2Mode.value && v2CommentsAdapter.value) {
 				const outcome = await commentsStore.editCommentV2({
 					superdoc: proxy.$superdoc,
@@ -7375,6 +7612,7 @@ var _sfc_main$32 = {
 			removePendingComment(proxy.$superdoc);
 		};
 		const handleInternalExternalSelect = (value) => {
+			if (commentsAreReadOnly$1()) return readOnlyMutationOutcome$1();
 			const isPendingComment = !!pendingComment.value;
 			const isInternal$1 = value.toLowerCase() === "internal";
 			if (!isPendingComment) props.comment.setIsInternal({
@@ -7428,6 +7666,13 @@ var _sfc_main$32 = {
 				focusEditInput(commentId);
 			});
 		});
+		(0, vue.watch)(() => getConfig.value?.readOnly === true, (readOnly) => {
+			if (!readOnly) return;
+			isReplying.value = false;
+			if (comments.value.some((comment) => comment.commentId === editingCommentId.value)) editingCommentId.value = null;
+			if (isPendingNewComment.value) cancelComment(proxy.$superdoc);
+			(0, vue.nextTick)(() => emit("resize"));
+		}, { immediate: true });
 		return (_ctx, _cache) => {
 			const _directive_click_outside = (0, vue.resolveDirective)("click-outside");
 			return (0, vue.withDirectives)(((0, vue.openBlock)(), (0, vue.createElementBlock)("div", {
@@ -7644,7 +7889,7 @@ var _sfc_main$32 = {
 		};
 	}
 };
-var CommentDialog_default = /* @__PURE__ */ require__plugin_vue_export_helper.__plugin_vue_export_helper_default(_sfc_main$32, [["__scopeId", "data-v-a2a29e0c"]]);
+var CommentDialog_default = /* @__PURE__ */ require__plugin_vue_export_helper.__plugin_vue_export_helper_default(_sfc_main$32, [["__scopeId", "data-v-67a03ee2"]]);
 var _hoisted_1$24 = { class: "comments-list" };
 var _hoisted_2$19 = { key: 0 };
 var _hoisted_3$15 = [
@@ -13367,7 +13612,7 @@ var _sfc_main$20 = {
 			}
 		});
 		const { getConfig, documentsWithConverations, commentsList, pendingComment, activeComment, skipSelectionUpdate, commentsByDocument, isCommentsListVisible, isFloatingCommentsReady, generalCommentIds, hasSyncedCollaborationComments, editorCommentPositions, hasInitializedLocations, isCommentHighlighted } = storeToRefs(commentsStore);
-		const { showAddComment, handleEditorLocationsUpdate, handleTrackedChangeUpdate, refreshTrackedChangeCommentsByIds, syncTrackedChangePositionsWithDocument, syncTrackedChangeComments, addComment, getComment, resolveCommentPositionEntry, belongsToDocument, COMMENT_EVENTS, requestInstantSidebarAlignment, peekInstantSidebarAlignment, clearInstantSidebarAlignment } = commentsStore;
+		const { showAddComment, handleEditorLocationsUpdate, handleTrackedChangeUpdate, refreshTrackedChangeCommentsByIds, syncTrackedChangePositionsWithDocument, syncTrackedChangeComments, addComment, addHydratedComment, getComment, resolveCommentPositionEntry, belongsToDocument, COMMENT_EVENTS, requestInstantSidebarAlignment, peekInstantSidebarAlignment, clearInstantSidebarAlignment } = commentsStore;
 		const { proxy } = (0, vue.getCurrentInstance)();
 		commentsStore.proxy = proxy;
 		const resolvedEditorIntegration = resolveV2Integration(proxy.$superdoc.config);
@@ -13550,7 +13795,7 @@ var _sfc_main$20 = {
 			const openLinkWorkflow = resolveV2LinkWorkflowOpener();
 			const unbind = bindEditShortcuts({
 				commandRoute: {
-					execute: (commandId, payload) => ui.commands.execute(commandId, payload),
+					executeAsync: (commandId, payload) => ui.commands.executeAsync(commandId, payload),
 					getState: (commandId) => ui.commands.get(commandId).getState()
 				},
 				...openLinkWorkflow ? { openLinkWorkflow } : {}
@@ -14365,6 +14610,7 @@ var _sfc_main$20 = {
 			resetSelection();
 			v2PageMetricsSnapshot.value = null;
 			const clearedDocumentId = payload?.documentId == null ? null : String(payload.documentId);
+			commentsStore.cancelImportedTrackedChangeBootstrap?.(clearedDocumentId ?? void 0);
 			if (clearedDocumentId) v2MountStagesByDocumentId.delete(clearedDocumentId);
 			if (latestV2MountStage && (clearedDocumentId == null || latestV2MountStage.dataset?.superdocV2DocumentId === clearedDocumentId)) latestV2MountStage = null;
 			v2ReviewHydrationController.reset("render-cleared");
@@ -14815,7 +15061,7 @@ var _sfc_main$20 = {
 				const { id, existingComment } = resolveDocumentScopedCommentMatch(commentPayload);
 				if (id && !existingComment) {
 					const commentModel = useComment(commentPayload);
-					addComment({
+					addHydratedComment({
 						superdoc: proxy.$superdoc,
 						comment: commentModel,
 						skipEditorUpdate: true
@@ -14829,7 +15075,7 @@ var _sfc_main$20 = {
 					if (existingComment) applyReplayUpdateToComment(existingComment, commentPayload, resolvedText);
 					else {
 						const commentModel = useComment(normalizeReplayCommentModelPayload(commentPayload));
-						addComment({
+						addHydratedComment({
 							superdoc: proxy.$superdoc,
 							comment: commentModel,
 							skipEditorUpdate: true
@@ -15103,6 +15349,7 @@ var _sfc_main$20 = {
 			handleFormattingMarksShortcut(e);
 		}
 		(0, vue.onBeforeUnmount)(() => {
+			commentsStore.cancelImportedTrackedChangeBootstrap?.();
 			passwordPrompt.destroy();
 			findReplace.destroy();
 			linkPopover.destroy();
@@ -15627,7 +15874,7 @@ var _sfc_main$20 = {
 		};
 	}
 };
-var SuperDoc_default = /* @__PURE__ */ require__plugin_vue_export_helper.__plugin_vue_export_helper_default(_sfc_main$20, [["__scopeId", "data-v-9bcd0709"]]);
+var SuperDoc_default = /* @__PURE__ */ require__plugin_vue_export_helper.__plugin_vue_export_helper_default(_sfc_main$20, [["__scopeId", "data-v-8d8777e2"]]);
 var PINIA_DEVTOOLS_SETUP_EVENT = "devtools-plugin:setup";
 var PINIA_DEVTOOLS_PLUGIN_ID = "dev.esm.pinia";
 var piniaDevtoolsSuppressionState = {
@@ -34196,7 +34443,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.0.0-next.24";
+		this.version = "2.0.0-next.26";
 		this.#log("🦋 [superdoc] Using SuperDoc version:", this.version);
 		this.superdocId = config.superdocId || require_uuid.v4_default();
 		this.colors = this.config.colors ?? [];