superdoc 2.0.0-next.24 → 2.0.0-next.25

package/dist/superdoc.es.js

@@ -5,7 +5,7 @@ import { t as v4_default } from "./chunks/uuid-B2Sqk-3p.es.js";
 import { a as init_dist, i as global, n as init_dist$1, r as process$1, t as require_jszip_min } from "./chunks/jszip-DzmwAHr3.es.js";
 import { t as __plugin_vue_export_helper_default } from "./chunks/_plugin-vue_export-helper-CInC0bKI.es.js";
 import { n as PDF_TO_CSS_UNITS } from "./chunks/constants-CY3R3_kF.es.js";
-import { a as createV2ReviewMutationReconciler, i as isV2EditableTextMutationEvent, o as getV2TrackedChangeMutationImpact, t as createSuperDocUI } from "./chunks/create-super-doc-ui-BMpP-iB6.es.js";
+import { a as createV2ReviewMutationReconciler, i as isV2EditableTextMutationEvent, o as getV2TrackedChangeMutationImpact, t as createSuperDocUI } from "./chunks/create-super-doc-ui-CBs8xQUw.es.js";
 import * as Vue from "vue";
 import { Fragment, Teleport, Transition, computed, createApp, createBlock, createCommentVNode, createElementBlock, createElementVNode, createTextVNode, createVNode, defineAsyncComponent, defineComponent, getCurrentInstance, h, inject, markRaw, mergeProps, nextTick, normalizeClass, normalizeProps, normalizeStyle, onActivated, onBeforeUnmount, onDeactivated, onMounted, openBlock, reactive, ref, renderList, renderSlot, resolveDirective, resolveDynamicComponent, shallowRef, toDisplayString, toRaw, toRef, unref, useAttrs, vModelText, watch, withCtx, withDirectives, withKeys, withModifiers } from "vue";
 import "y-websocket";
@@ -1733,7 +1733,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 [];
@@ -1813,7 +1819,9 @@ function useComment(params) {
 	const resolvedByEmail = ref(params.resolvedByEmail || null);
 	const resolvedByName = ref(params.resolvedByName || null);
 	const trackedChangeDecision = 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;
@@ -1851,6 +1859,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;
@@ -1879,6 +1888,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;
@@ -2859,6 +2869,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 = reactive({
 		documentMode: "editing",
 		commentsVisible: false,
@@ -2867,6 +2882,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;
@@ -3306,7 +3323,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,
@@ -3321,7 +3338,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);
@@ -3455,7 +3473,7 @@ const useCommentsStore = defineStore("comments", () => {
 					});
 					return;
 				}
-				addComment({
+				addHydratedComment({
 					superdoc,
 					comment,
 					broadcastChanges
@@ -3477,7 +3495,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);
@@ -3712,8 +3733,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;
@@ -3798,7 +3820,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({
@@ -3987,6 +4023,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,
@@ -4021,6 +4058,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,
@@ -4069,6 +4107,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,
@@ -4115,6 +4154,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,
@@ -4337,21 +4377,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();
@@ -4382,7 +4540,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,
@@ -4419,16 +4577,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;
@@ -4473,7 +4644,7 @@ const useCommentsStore = defineStore("comments", () => {
 				event: existingTrackedChange ? "update" : "add",
 				marks,
 				nodes: [],
-				newEditorState: editor.state,
+				newEditorState: editorState,
 				documentId,
 				trackedChangesForId: changesByIdMap.get(id) || []
 			});
@@ -4486,7 +4657,8 @@ const useCommentsStore = defineStore("comments", () => {
 				handleTrackedChangeUpdate({
 					superdoc,
 					params,
-					broadcastChanges
+					broadcastChanges,
+					documentState: editorState
 				});
 				if (!existingTrackedChange) {
 					skipIds.add(normalizedId);
@@ -4495,9 +4667,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;
@@ -4870,6 +5048,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) {
@@ -5214,46 +5396,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;
@@ -5300,13 +5488,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();
@@ -5321,7 +5515,9 @@ const useCommentsStore = defineStore("comments", () => {
 				editor,
 				snapshot,
 				documentId: activeDocumentId,
-				broadcastChanges
+				broadcastChanges,
+				documentState,
+				resolveFromEditor
 			});
 		}
 	};
@@ -5338,7 +5534,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 = {
@@ -5362,7 +5558,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, {
@@ -5399,7 +5595,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;
@@ -5414,9 +5610,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;
@@ -5732,9 +5930,11 @@ const useCommentsStore = defineStore("comments", () => {
 		getPendingComment,
 		showAddComment,
 		addComment,
+		addHydratedComment,
 		cancelComment,
 		deleteComment,
 		removePendingComment,
+		cancelImportedTrackedChangeBootstrap,
 		removeCommentsForDocument,
 		processLoadedDocxComments,
 		translateCommentsForExport,
@@ -6361,7 +6561,9 @@ var CommentHeader_default = /* @__PURE__ */ __plugin_vue_export_helper_default({
 				key: "delete"
 			}
 		});
+		const reviewMutationsVisible = computed(() => props.config.readOnly !== true);
 		const generallyAllowed = computed(() => {
+			if (!reviewMutationsVisible.value) return false;
 			if (!props.comment) return false;
 			if (props.comment.resolvedTime) return false;
 			if (commentsStore.pendingComment) return false;
@@ -6370,6 +6572,7 @@ var CommentHeader_default = /* @__PURE__ */ __plugin_vue_export_helper_default({
 		});
 		const allowResolve = 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 = {
@@ -6392,6 +6595,8 @@ var CommentHeader_default = /* @__PURE__ */ __plugin_vue_export_helper_default({
 			else return isAllowed(PERMISSIONS.REJECT_OTHER, role, isInternal, context);
 		});
 		const allowReopen = 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;
@@ -6416,11 +6621,12 @@ var CommentHeader_default = /* @__PURE__ */ __plugin_vue_export_helper_default({
 			return true;
 		});
 		const getOverflowOptions = 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,
@@ -6433,18 +6639,25 @@ var CommentHeader_default = /* @__PURE__ */ __plugin_vue_export_helper_default({
 			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 = computed(() => {
 			if (!(props.comment.origin != null || !!props.comment.importedAuthor?.name)) return false;
 			if (isCommentOwnedByCurrentUser(props.comment)) return false;
@@ -6470,6 +6683,7 @@ var CommentHeader_default = /* @__PURE__ */ __plugin_vue_export_helper_default({
 				allowResolve.value ? (openBlock(), createElementBlock("div", {
 					key: 0,
 					class: 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: unref(superdocIcons).markDone,
@@ -6478,6 +6692,7 @@ var CommentHeader_default = /* @__PURE__ */ __plugin_vue_export_helper_default({
 				allowReject.value ? (openBlock(), createElementBlock("div", {
 					key: 1,
 					class: 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: unref(superdocIcons).rejectChange,
@@ -6495,6 +6710,7 @@ var CommentHeader_default = /* @__PURE__ */ __plugin_vue_export_helper_default({
 				}, null, 10, _hoisted_9$3)) : createCommentVNode("", true),
 				allowOverflow.value ? (openBlock(), createBlock(CommentsDropdown_default, {
 					key: 3,
+					"data-comment-action": "overflow",
 					options: getOverflowOptions.value,
 					onSelect: handleSelect,
 					"content-style": { fontFamily: unref(uiFontFamily) }
@@ -6508,7 +6724,7 @@ var CommentHeader_default = /* @__PURE__ */ __plugin_vue_export_helper_default({
 			], 2)]);
 		};
 	}
-}, [["__scopeId", "data-v-49c3f013"]]);
+}, [["__scopeId", "data-v-359c13bb"]]);
 var _hoisted_1$26 = { class: "input-section" };
 var TEXTAREA_MIN_HEIGHT = 28;
 var TEXTAREA_MAX_HEIGHT = 132;
@@ -6930,8 +7146,14 @@ var CommentDialog_default = /* @__PURE__ */ __plugin_vue_export_helper_default({
 		const showInputSection = 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 = ref(false);
 		const startReply = () => {
+			if (commentsAreReadOnly$1()) return readOnlyMutationOutcome$1();
 			isReplying.value = true;
 			nextTick(() => {
 				commentInput.value?.focus?.();
@@ -7033,6 +7255,7 @@ var CommentDialog_default = /* @__PURE__ */ __plugin_vue_export_helper_default({
 			return comments.value.some((c) => c.commentId === editingCommentId.value);
 		});
 		const shouldShowInternalExternal = 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;
@@ -7121,6 +7344,7 @@ var CommentDialog_default = /* @__PURE__ */ __plugin_vue_export_helper_default({
 			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,
@@ -7211,6 +7435,7 @@ var CommentDialog_default = /* @__PURE__ */ __plugin_vue_export_helper_default({
 			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) {
@@ -7263,6 +7488,11 @@ var CommentDialog_default = /* @__PURE__ */ __plugin_vue_export_helper_default({
 			});
 		};
 		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({
@@ -7315,6 +7545,11 @@ var CommentDialog_default = /* @__PURE__ */ __plugin_vue_export_helper_default({
 			});
 		};
 		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,
@@ -7327,6 +7562,7 @@ var CommentDialog_default = /* @__PURE__ */ __plugin_vue_export_helper_default({
 			});
 		};
 		const handleOverflowSelect = (value, comment) => {
+			if (commentsAreReadOnly$1()) return readOnlyMutationOutcome$1();
 			switch (value) {
 				case "edit":
 					currentCommentText.value = comment?.commentText?.value ?? comment?.commentText ?? "";
@@ -7347,6 +7583,7 @@ var CommentDialog_default = /* @__PURE__ */ __plugin_vue_export_helper_default({
 			}
 		};
 		const handleCommentUpdate = async (comment) => {
+			if (commentsAreReadOnly$1()) return readOnlyMutationOutcome$1();
 			if (isV2Mode.value && v2CommentsAdapter.value) {
 				const outcome = await commentsStore.editCommentV2({
 					superdoc: proxy.$superdoc,
@@ -7366,6 +7603,7 @@ var CommentDialog_default = /* @__PURE__ */ __plugin_vue_export_helper_default({
 			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({
@@ -7419,6 +7657,13 @@ var CommentDialog_default = /* @__PURE__ */ __plugin_vue_export_helper_default({
 				focusEditInput(commentId);
 			});
 		});
+		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);
+			nextTick(() => emit("resize"));
+		}, { immediate: true });
 		return (_ctx, _cache) => {
 			const _directive_click_outside = resolveDirective("click-outside");
 			return withDirectives((openBlock(), createElementBlock("div", {
@@ -7634,7 +7879,7 @@ var CommentDialog_default = /* @__PURE__ */ __plugin_vue_export_helper_default({
 			], 64))], 14, _hoisted_1$25)), [[_directive_click_outside, handleClickOutside]]);
 		};
 	}
-}, [["__scopeId", "data-v-a2a29e0c"]]);
+}, [["__scopeId", "data-v-67a03ee2"]]);
 var _hoisted_1$24 = { class: "comments-list" };
 var _hoisted_2$19 = { key: 0 };
 var _hoisted_3$15 = [
@@ -13109,7 +13354,7 @@ var SuperDoc_default = /* @__PURE__ */ __plugin_vue_export_helper_default({
 			}
 		});
 		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 } = getCurrentInstance();
 		commentsStore.proxy = proxy;
 		const resolvedEditorIntegration = resolveV2Integration(proxy.$superdoc.config);
@@ -13292,7 +13537,7 @@ var SuperDoc_default = /* @__PURE__ */ __plugin_vue_export_helper_default({
 			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 } : {}
@@ -14107,6 +14352,7 @@ var SuperDoc_default = /* @__PURE__ */ __plugin_vue_export_helper_default({
 			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");
@@ -14557,7 +14803,7 @@ var SuperDoc_default = /* @__PURE__ */ __plugin_vue_export_helper_default({
 				const { id, existingComment } = resolveDocumentScopedCommentMatch(commentPayload);
 				if (id && !existingComment) {
 					const commentModel = useComment(commentPayload);
-					addComment({
+					addHydratedComment({
 						superdoc: proxy.$superdoc,
 						comment: commentModel,
 						skipEditorUpdate: true
@@ -14571,7 +14817,7 @@ var SuperDoc_default = /* @__PURE__ */ __plugin_vue_export_helper_default({
 					if (existingComment) applyReplayUpdateToComment(existingComment, commentPayload, resolvedText);
 					else {
 						const commentModel = useComment(normalizeReplayCommentModelPayload(commentPayload));
-						addComment({
+						addHydratedComment({
 							superdoc: proxy.$superdoc,
 							comment: commentModel,
 							skipEditorUpdate: true
@@ -14845,6 +15091,7 @@ var SuperDoc_default = /* @__PURE__ */ __plugin_vue_export_helper_default({
 			handleFormattingMarksShortcut(e);
 		}
 		onBeforeUnmount(() => {
+			commentsStore.cancelImportedTrackedChangeBootstrap?.();
 			passwordPrompt.destroy();
 			findReplace.destroy();
 			linkPopover.destroy();
@@ -15368,7 +15615,7 @@ var SuperDoc_default = /* @__PURE__ */ __plugin_vue_export_helper_default({
 			], 38);
 		};
 	}
-}, [["__scopeId", "data-v-9bcd0709"]]);
+}, [["__scopeId", "data-v-8d8777e2"]]);
 var PINIA_DEVTOOLS_SETUP_EVENT = "devtools-plugin:setup";
 var PINIA_DEVTOOLS_PLUGIN_ID = "dev.esm.pinia";
 var piniaDevtoolsSuppressionState = {
@@ -33914,7 +34161,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.0.0-next.24";
+		this.version = "2.0.0-next.25";
 		this.#log("🦋 [superdoc] Using SuperDoc version:", this.version);
 		this.superdocId = config.superdocId || v4_default();
 		this.colors = this.config.colors ?? [];