superdoc 2.4.0-next.2 → 2.4.0-next.3

package/dist/superdoc.cjs

@@ -6,7 +6,7 @@ const require_uuid = require("./chunks/uuid-CFp0WGVU.cjs");
 const require_jszip = require("./chunks/jszip-Cs9JBLlJ.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-DXdWuTzm.cjs");
+const require_create_super_doc_ui = require("./chunks/create-super-doc-ui-BHMQEL2y.cjs");
 let vue = require("vue");
 vue = require_rolldown_runtime.__toESM(vue);
 require("y-websocket");
@@ -6728,8 +6728,17 @@ const useCommentsStore = defineStore("comments", () => {
 		return viewingVisibility.commentsVisible || viewingVisibility.trackChangesVisible;
 	});
 	const v2CommentsAdapter = (0, vue.shallowRef)(null);
+	const v2CommentSyncGenerations = /* @__PURE__ */ new WeakMap();
+	const commentSyncGeneration = (adapter) => v2CommentSyncGenerations.get(adapter) ?? 0;
+	const supersedeCommentSyncGeneration = (adapter) => {
+		if (!adapter || typeof adapter !== "object" && typeof adapter !== "function") return 0;
+		const next = commentSyncGeneration(adapter) + 1;
+		v2CommentSyncGenerations.set(adapter, next);
+		return next;
+	};
 	const setV2CommentsAdapter = (adapter) => {
 		v2CommentsAdapter.value = adapter ?? null;
+		if (adapter && !v2CommentSyncGenerations.has(adapter)) v2CommentSyncGenerations.set(adapter, 0);
 	};
 	const getV2CommentsAdapter = (superdoc) => {
 		const fromFacade = superdoc?.activeEditor?.v2Comments ?? null;
@@ -6738,14 +6747,27 @@ const useCommentsStore = defineStore("comments", () => {
 	};
 	const isV2EditorActive = (superdoc) => superdoc?.activeEditor?.editorVersion === 2 || v2CommentsAdapter.value !== null;
 	const v2TrackedChangesAdapter = (0, vue.shallowRef)(null);
+	const v2TrackedChangeSyncGenerations = /* @__PURE__ */ new WeakMap();
+	const trackedChangeSyncGeneration = (adapter) => v2TrackedChangeSyncGenerations.get(adapter) ?? 0;
+	const supersedeTrackedChangeSyncGeneration = (adapter) => {
+		if (!adapter || typeof adapter !== "object" && typeof adapter !== "function") return 0;
+		const next = trackedChangeSyncGeneration(adapter) + 1;
+		v2TrackedChangeSyncGenerations.set(adapter, next);
+		return next;
+	};
 	const setV2TrackedChangesAdapter = (adapter) => {
 		v2TrackedChangesAdapter.value = adapter ?? null;
+		if (adapter && !v2TrackedChangeSyncGenerations.has(adapter)) v2TrackedChangeSyncGenerations.set(adapter, 0);
 	};
 	const getV2TrackedChangesAdapter = (superdoc) => {
 		const fromFacade = superdoc?.activeEditor?.v2TrackedChanges ?? null;
 		if (fromFacade) return fromFacade;
 		return v2TrackedChangesAdapter.value;
 	};
+	const supersedeV2ReviewHydration = ({ commentsAdapter, trackedChangesAdapter } = {}) => ({
+		commentsGeneration: supersedeCommentSyncGeneration(commentsAdapter ?? v2CommentsAdapter.value),
+		trackedChangesGeneration: supersedeTrackedChangeSyncGeneration(trackedChangesAdapter ?? v2TrackedChangesAdapter.value)
+	});
 	const init = (config = {}) => {
 		const updatedConfig = {
 			...commentsConfig,
@@ -7201,7 +7223,7 @@ const useCommentsStore = defineStore("comments", () => {
 		}
 		activeEditor?.commands?.setActiveComment({ commentId: activeComment.value });
 	};
-	const handleTrackedChangeUpdate = ({ superdoc, params, broadcastChanges = true, documentState = void 0 }) => {
+	const handleTrackedChangeUpdate = ({ superdoc, params, broadcastChanges = true, documentState = void 0, trackedChangeIdentityIndex = null }) => {
 		const span = startInteractionSpan("store.trackedChanges.handleUpdate", "store-reconciliation", {
 			event: params?.event ?? null,
 			changeId: params?.changeId ?? null,
@@ -7304,6 +7326,17 @@ const useCommentsStore = defineStore("comments", () => {
 					if (normalizedAnchorKey && commentAnchorKey) return commentAnchorKey === normalizedAnchorKey;
 					return false;
 				};
+				if (trackedChangeIdentityIndex) {
+					const candidates = trackedChangeIdentityIndex.candidates({
+						changeId: normalizedChangeId,
+						importedId: normalizedImportedId,
+						anchorKey: normalizedAnchorKey,
+						canonicalId: normalizedTrackedChangeCanonicalId,
+						positionAliases: normalizedTrackedChangePositionAliases
+					});
+					for (const trackedComment of candidates) if (matchesId(trackedComment) && (!normalizedDocumentId || belongsToTrackedChangeSyncDocument(trackedComment, normalizedDocumentId))) return trackedComment;
+					return null;
+				}
 				if (normalizedDocumentId) return commentsList.value.find((trackedComment) => matchesId(trackedComment) && belongsToTrackedChangeSyncDocument(trackedComment, normalizedDocumentId));
 				return commentsList.value.find(matchesId);
 			};
@@ -7372,6 +7405,7 @@ const useCommentsStore = defineStore("comments", () => {
 				const existing = findTrackedChangeById();
 				if (existing) {
 					if (!updateExistingTrackedChange(existing)) return;
+					trackedChangeIdentityIndex?.add(existing);
 					emitTrackedChangeEvent({
 						type: COMMENT_EVENTS.UPDATE,
 						comment: getCommentEventPayload(existing)
@@ -7383,10 +7417,12 @@ const useCommentsStore = defineStore("comments", () => {
 					comment,
 					broadcastChanges
 				});
+				trackedChangeIdentityIndex?.add(comment);
 			} else if (event === "update") {
 				const existingTrackedChange = findTrackedChangeById();
 				if (!existingTrackedChange) return;
 				if (!updateExistingTrackedChange(existingTrackedChange)) return;
+				trackedChangeIdentityIndex?.add(existingTrackedChange);
 				emitTrackedChangeEvent({
 					type: COMMENT_EVENTS.UPDATE,
 					comment: getCommentEventPayload(existingTrackedChange)
@@ -8200,15 +8236,24 @@ const useCommentsStore = defineStore("comments", () => {
 			trackedItems: preparedParams.length
 		};
 	});
-	const hydrateCommentsFromV2 = async ({ superdoc, adapter, documentId } = {}) => withInteractionSpan("store.comments.hydrateFromV2", "comments-list", { documentId: documentId ?? null }, async () => {
+	const hydrateCommentsFromV2 = async ({ superdoc, adapter, documentId, signal, hydrationGeneration } = {}) => withInteractionSpan("store.comments.hydrateFromV2", "comments-list", { documentId: documentId ?? null }, async () => {
 		const effectiveAdapter = adapter ?? getV2CommentsAdapter(superdoc);
 		if (!effectiveAdapter || typeof effectiveAdapter.refresh !== "function") return {
 			ok: false,
 			reason: "adapter-missing"
 		};
+		if (signal?.aborted) return {
+			ok: false,
+			reason: "review-hydration-superseded",
+			lateResultDropped: false
+		};
+		const syncGeneration = commentSyncGeneration(effectiveAdapter);
 		let result;
 		try {
-			result = await effectiveAdapter.refresh();
+			const refreshOptions = {};
+			if (signal) refreshOptions.signal = signal;
+			if (typeof hydrationGeneration === "number") refreshOptions.hydrationGeneration = hydrationGeneration;
+			result = Object.keys(refreshOptions).length > 0 ? await effectiveAdapter.refresh(refreshOptions) : await effectiveAdapter.refresh();
 		} catch (err) {
 			return {
 				ok: false,
@@ -8220,21 +8265,35 @@ const useCommentsStore = defineStore("comments", () => {
 			ok: false,
 			reason: "adapter-stale"
 		};
+		if (signal?.aborted || commentSyncGeneration(effectiveAdapter) !== syncGeneration) return {
+			ok: false,
+			reason: "review-hydration-superseded",
+			lateResultDropped: true
+		};
 		if (!result?.ok) return result;
+		if (signal?.aborted || commentSyncGeneration(effectiveAdapter) !== syncGeneration) return {
+			ok: false,
+			reason: "review-hydration-superseded",
+			lateResultDropped: true
+		};
 		reconcileCommentsFromV2({
 			superdoc,
 			adapter: effectiveAdapter,
 			documentId,
-			items: result.items ?? []
+			items: result.items ?? [],
+			hydrationGeneration
 		});
 		return {
 			ok: true,
-			items: result.items ?? []
+			items: result.items ?? [],
+			reconciled: true,
+			...typeof hydrationGeneration === "number" ? { hydrationGeneration } : {}
 		};
 	});
-	const reconcileCommentsFromV2 = ({ superdoc, adapter, documentId, items, preparedInputs = null } = {}) => withInteractionSpan("store.comments.reconcile", "store-reconciliation", {
+	const reconcileCommentsFromV2 = ({ superdoc, adapter, documentId, items, preparedInputs = null, hydrationGeneration } = {}) => withInteractionSpan("store.comments.reconcile", "store-reconciliation", {
 		documentId: documentId ?? null,
-		itemCount: Array.isArray(items) ? items.length : null
+		itemCount: Array.isArray(items) ? items.length : null,
+		hydrationGeneration: hydrationGeneration ?? null
 	}, () => {
 		if (!adapter || !Array.isArray(items)) return { added: null };
 		if (!isCurrentV2CommentsAdapter(adapter)) return {
@@ -9008,7 +9067,7 @@ const useCommentsStore = defineStore("comments", () => {
 		let removed = false;
 		const targetIndex = targetComment ? commentsList.value.indexOf(targetComment) : -1;
 		const targetIds = targetComment?.trackedChange ? collectTrackedChangeDecisionIds(targetComment) : /* @__PURE__ */ new Set();
-		if (targetIndex >= 0 && belongsToTrackedChangeSyncDocument(targetComment, normalizedDocumentId) && Array.from(normalizedDecidedIds).some((id) => targetIds.has(id))) {
+		if (targetIndex >= 0 && belongsToTrackedChangeSyncDocument(targetComment, normalizedDocumentId) && Array.from(targetIds).some((id) => normalizedDecidedIds.has(id))) {
 			targetIds.forEach((id) => removedIds.add(id));
 			commentsList.value.splice(targetIndex, 1);
 			removed = true;
@@ -9016,7 +9075,7 @@ const useCommentsStore = defineStore("comments", () => {
 			if (!comment?.trackedChange) return true;
 			if (!belongsToTrackedChangeSyncDocument(comment, normalizedDocumentId)) return true;
 			const ids = collectTrackedChangeDecisionIds(comment);
-			if (!Array.from(normalizedDecidedIds).some((id) => ids.has(id))) return true;
+			if (!Array.from(ids).some((id) => normalizedDecidedIds.has(id))) return true;
 			removed = true;
 			ids.forEach((id) => removedIds.add(id));
 			return false;
@@ -9032,6 +9091,31 @@ const useCommentsStore = defineStore("comments", () => {
 			removedIds
 		};
 	};
+	const clearAllResolvedTrackedChangeRows = ({ adapter, documentId } = {}) => {
+		const normalizedDocumentId = normalizeCommentId(documentId);
+		if (!adapter || !normalizedDocumentId) return {
+			removed: 0,
+			removedIds: /* @__PURE__ */ new Set()
+		};
+		supersedeTrackedChangeSyncGeneration(adapter);
+		const removedIds = /* @__PURE__ */ new Set();
+		const activeId = normalizeCommentId(activeComment.value);
+		let activeWasRemoved = false;
+		const next = commentsList.value.filter((comment) => {
+			if (!comment?.trackedChange || !belongsToTrackedChangeSyncDocument(comment, normalizedDocumentId)) return true;
+			const aliases = collectTrackedChangeDecisionIds(comment);
+			aliases.forEach((id) => removedIds.add(id));
+			if (activeId && aliases.has(activeId)) activeWasRemoved = true;
+			return false;
+		});
+		const removed = commentsList.value.length - next.length;
+		if (removed > 0) commentsList.value = next;
+		if (activeWasRemoved) clearActiveCommentSelection();
+		return {
+			removed,
+			removedIds
+		};
+	};
 	const clearV2ActiveTrackedChangeTarget = (adapter, decidedId) => {
 		if (!decidedId || typeof adapter?.clearActiveTrackedChangeTargetIfMatches !== "function") return;
 		try {
@@ -9242,7 +9326,7 @@ const useCommentsStore = defineStore("comments", () => {
 			success: Boolean(command(id))
 		};
 	};
-	const hydrateTrackedChangesFromV2 = async ({ superdoc, adapter, documentId, trackedChangesListMode = "all", refreshReason, blocking } = {}) => withInteractionSpan("store.trackedChanges.hydrateFromV2", "tracked-change-list", {
+	const hydrateTrackedChangesFromV2 = async ({ superdoc, adapter, documentId, trackedChangesListMode = "all", refreshReason, blocking, signal, hydrationGeneration } = {}) => withInteractionSpan("store.trackedChanges.hydrateFromV2", "tracked-change-list", {
 		documentId: documentId ?? null,
 		trackedChangesListMode,
 		refreshReason: refreshReason ?? null,
@@ -9253,11 +9337,19 @@ const useCommentsStore = defineStore("comments", () => {
 			ok: false,
 			reason: "adapter-missing"
 		};
+		const syncGeneration = trackedChangeSyncGeneration(effectiveAdapter);
+		if (signal?.aborted) return {
+			ok: false,
+			reason: "review-hydration-superseded",
+			lateResultDropped: false
+		};
 		let result;
 		try {
 			const listOptions = { mode: trackedChangesListMode };
 			if (refreshReason != null) listOptions.refreshReason = refreshReason;
 			if (typeof blocking === "boolean") listOptions.blocking = blocking;
+			if (signal) listOptions.signal = signal;
+			if (typeof hydrationGeneration === "number") listOptions.hydrationGeneration = hydrationGeneration;
 			result = await effectiveAdapter.listTrackedChanges(listOptions);
 		} catch (err) {
 			return {
@@ -9270,18 +9362,36 @@ const useCommentsStore = defineStore("comments", () => {
 			ok: false,
 			reason: "adapter-stale"
 		};
+		if (trackedChangeSyncGeneration(effectiveAdapter) !== syncGeneration) return {
+			ok: false,
+			reason: "review-hydration-superseded",
+			lateResultDropped: true
+		};
+		if (signal?.aborted) return {
+			ok: false,
+			reason: "review-hydration-superseded",
+			lateResultDropped: true
+		};
 		if (!result?.ok) return result;
 		const pruneStale = !(trackedChangesListMode === "startup-page" || trackedChangesListMode === "interaction-prime" || trackedChangesListMode === "visible-window") && result.visibleWindowSource == null && result.complete === true && result.sourceCoverageComplete === true;
+		if (signal?.aborted || trackedChangeSyncGeneration(effectiveAdapter) !== syncGeneration) return {
+			ok: false,
+			reason: "review-hydration-superseded",
+			lateResultDropped: true
+		};
 		reconcileTrackedChangesFromV2({
 			superdoc,
 			adapter: effectiveAdapter,
 			documentId,
 			items: result.items ?? [],
-			pruneStale
+			pruneStale,
+			hydrationGeneration
 		});
 		const hydrationResult = {
 			ok: true,
-			items: result.items ?? []
+			items: result.items ?? [],
+			reconciled: true,
+			...typeof hydrationGeneration === "number" ? { hydrationGeneration } : {}
 		};
 		if (typeof result.complete === "boolean") hydrationResult.complete = result.complete;
 		if (typeof result.sourceCoverageComplete === "boolean") hydrationResult.sourceCoverageComplete = result.sourceCoverageComplete;
@@ -9292,11 +9402,14 @@ const useCommentsStore = defineStore("comments", () => {
 		if (typeof result.refreshReason === "string") hydrationResult.refreshReason = result.refreshReason;
 		if (typeof result.blocking === "boolean") hydrationResult.blocking = result.blocking;
 		if (typeof result.pageCount === "number") hydrationResult.pageCount = result.pageCount;
+		if (typeof result.pagesStarted === "number") hydrationResult.pagesStarted = result.pagesStarted;
+		if (typeof result.pagesCompleted === "number") hydrationResult.pagesCompleted = result.pagesCompleted;
+		if (typeof result.pagesSkippedAfterAbort === "number") hydrationResult.pagesSkippedAfterAbort = result.pagesSkippedAfterAbort;
 		if (typeof result.totalItems === "number") hydrationResult.totalItems = result.totalItems;
 		if (typeof result.coalesced === "boolean") hydrationResult.coalesced = result.coalesced;
 		return hydrationResult;
 	});
-	const reconcileTrackedChangeMutationFromV2 = async ({ superdoc, adapter, documentId, upsertIds = [], removedIds = [] } = {}) => {
+	const reconcileTrackedChangeMutationFromV2 = async ({ superdoc, adapter, documentId, upsertIds = [], removedIds = [], allResolved } = {}) => {
 		const effectiveAdapter = adapter ?? getV2TrackedChangesAdapter(superdoc);
 		if (!effectiveAdapter) return {
 			ok: false,
@@ -9307,6 +9420,26 @@ const useCommentsStore = defineStore("comments", () => {
 			reason: "adapter-stale"
 		};
 		const effectiveDocumentId = documentId ?? effectiveAdapter.documentId ?? superdoc?.activeEditor?.documentId ?? null;
+		if (allResolved && effectiveDocumentId == null) return {
+			ok: false,
+			reason: "document-id-missing"
+		};
+		if (allResolved) return {
+			ok: true,
+			items: [],
+			resolvedIds: [],
+			unresolvedIds: [],
+			allResolved: true,
+			removedRows: withInteractionSpan("store.trackedChanges.allResolved", "store-reconciliation", {
+				documentId: String(effectiveDocumentId),
+				logicalTargetCount: allResolved.logicalTargetCount ?? null,
+				physicalCarrierCount: allResolved.physicalCarrierCount ?? null
+			}, () => clearAllResolvedTrackedChangeRows({
+				adapter: effectiveAdapter,
+				documentId: effectiveDocumentId
+			})).removed
+		};
+		const syncGeneration = trackedChangeSyncGeneration(effectiveAdapter);
 		const normalizedRemovedIds = new Set(Array.from(removedIds ?? []).map((id) => normalizeCommentId(id)).filter(Boolean));
 		const normalizedUpsertIds = [...new Set(Array.from(upsertIds ?? []).map((id) => normalizeCommentId(id)).filter(Boolean))];
 		if (normalizedRemovedIds.size > 0 && normalizedUpsertIds.length === 0 && effectiveDocumentId != null) pruneDecidedTrackedChangeRow({
@@ -9345,6 +9478,10 @@ const useCommentsStore = defineStore("comments", () => {
 			ok: false,
 			reason: "adapter-stale"
 		};
+		if (trackedChangeSyncGeneration(effectiveAdapter) !== syncGeneration) return {
+			ok: false,
+			reason: "generation-stale"
+		};
 		const resolvedIds = [];
 		const unresolvedIds = [];
 		const items = [];
@@ -9371,35 +9508,105 @@ const useCommentsStore = defineStore("comments", () => {
 			failures: reads.map(({ result }) => result).filter((result) => !result?.ok)
 		};
 	};
-	const reconcileTrackedChangesFromV2 = ({ superdoc, adapter, documentId, items, pruneStale = true, preparedParams = null } = {}) => withInteractionSpan("store.trackedChanges.reconcile", "store-reconciliation", {
+	const createTrackedChangeBatchIdentityIndex = (documentId) => {
+		const byIdentityAlias = /* @__PURE__ */ new Map();
+		const indexedRows = /* @__PURE__ */ new Set();
+		let aliasLookups = 0;
+		let candidateVisits = 0;
+		const addAlias = (index, value, comment) => {
+			const alias = normalizeCommentId(value);
+			if (!alias) return;
+			const bucket = index.get(alias) ?? /* @__PURE__ */ new Set();
+			bucket.add(comment);
+			index.set(alias, bucket);
+		};
+		const add = (comment) => {
+			if (!comment?.trackedChange) return;
+			if (documentId && !belongsToTrackedChangeSyncDocument(comment, documentId)) return;
+			indexedRows.add(comment);
+			addAlias(byIdentityAlias, comment.commentId, comment);
+			addAlias(byIdentityAlias, comment.importedId, comment);
+			addAlias(byIdentityAlias, comment.trackedChangeCanonicalId, comment);
+			addAlias(byIdentityAlias, comment.trackedChangeAnchorKey, comment);
+			getCommentAliasIds(comment).forEach((alias) => addAlias(byIdentityAlias, alias, comment));
+		};
+		commentsList.value.forEach(add);
+		return {
+			add,
+			work: () => ({
+				trackedRowsIndexed: indexedRows.size,
+				invalidatedIdMembershipChecks: 0,
+				incomingAliasLookups: aliasLookups,
+				candidateVisits
+			}),
+			candidates({ changeId, importedId, anchorKey, canonicalId, positionAliases = [] } = {}) {
+				const out = /* @__PURE__ */ new Set();
+				const include = (value) => {
+					const alias = normalizeCommentId(value);
+					if (!alias) return;
+					aliasLookups += 1;
+					const bucket = byIdentityAlias.get(alias);
+					if (!bucket) return;
+					candidateVisits += bucket.size;
+					bucket.forEach((comment) => out.add(comment));
+				};
+				new Set([
+					changeId,
+					importedId,
+					canonicalId,
+					anchorKey,
+					...positionAliases
+				]).forEach(include);
+				return out;
+			}
+		};
+	};
+	const reconcileTrackedChangesFromV2 = ({ superdoc, adapter, documentId, items, pruneStale = true, preparedParams = null, hydrationGeneration } = {}) => withInteractionSpan("store.trackedChanges.reconcile", "store-reconciliation", {
 		documentId: documentId ?? null,
 		itemCount: Array.isArray(items) ? items.length : null,
-		pruneStale
+		pruneStale,
+		hydrationGeneration: hydrationGeneration ?? null
 	}, () => {
 		if (!adapter || !Array.isArray(items)) return;
 		if (!isCurrentV2TrackedChangesAdapter(adapter)) return;
 		const effectiveDocumentId = documentId ?? adapter.documentId ?? superdoc?.activeEditor?.documentId ?? null;
 		const liveAnchorKeys = /* @__PURE__ */ new Set();
 		const liveIds = /* @__PURE__ */ new Set();
+		const trackedChangeIdentityIndex = createTrackedChangeBatchIdentityIndex(effectiveDocumentId == null ? null : String(effectiveDocumentId));
+		const identitySpan = startInteractionSpan("store.trackedChanges.batchIdentity", "store-reconciliation", { itemCount: items.length });
 		const paramsList = Array.isArray(preparedParams) ? preparedParams : items.map((item) => adapter.mapV2TrackedChangeToCommentParams(item));
-		for (const params of paramsList) {
-			if (!params) continue;
-			if (params.event === "omit") {
+		try {
+			for (const params of paramsList) {
+				if (!params) continue;
+				if (params.event === "omit") {
+					if (params.changeId != null) liveIds.add(String(params.changeId));
+					continue;
+				}
+				if (effectiveDocumentId && params.documentId == null) params.documentId = effectiveDocumentId;
 				if (params.changeId != null) liveIds.add(String(params.changeId));
-				continue;
+				if (params.trackedChangeAnchorKey != null) liveAnchorKeys.add(String(params.trackedChangeAnchorKey));
+				handleTrackedChangeUpdate({
+					superdoc,
+					params,
+					broadcastChanges: false,
+					trackedChangeIdentityIndex
+				});
 			}
-			if (effectiveDocumentId && params.documentId == null) params.documentId = effectiveDocumentId;
-			if (params.changeId != null) liveIds.add(String(params.changeId));
-			if (params.trackedChangeAnchorKey != null) liveAnchorKeys.add(String(params.trackedChangeAnchorKey));
-			handleTrackedChangeUpdate({
-				superdoc,
-				params,
-				broadcastChanges: false
-			});
+		} finally {
+			endInteractionSpan(identitySpan, trackedChangeIdentityIndex.work());
 		}
 		if (!effectiveDocumentId || !pruneStale) return;
 		pruneStaleTrackedChangeComments(liveIds, liveAnchorKeys, String(effectiveDocumentId), superdoc, { broadcastChanges: false });
 	});
+	const getV2TrackedChangeRowCount = (documentId = null) => {
+		const normalizedDocumentId = documentId == null ? null : String(documentId);
+		return commentsList.value.filter((comment) => {
+			if (comment?.trackedChange !== true) return false;
+			if (normalizedDocumentId == null) return true;
+			const rowDocumentId = comment?.documentId ?? comment?.fileId ?? null;
+			return rowDocumentId != null && String(rowDocumentId) === normalizedDocumentId;
+		}).length;
+	};
 	const syncTrackedChangeComments = ({ superdoc, editor, broadcastChanges = true }) => {
 		if (!superdoc || !editor) return;
 		const activeDocumentId = editor?.options?.documentId != null ? String(editor.options.documentId) : null;
@@ -9966,6 +10173,7 @@ const useCommentsStore = defineStore("comments", () => {
 		getV2CommentsAdapter,
 		hydrateCommentsFromV2,
 		applyReviewSnapshotFromV2,
+		supersedeV2ReviewHydration,
 		reconcileCommentsFromV2,
 		isV2EditorActive,
 		replyCommentV2,
@@ -9975,6 +10183,7 @@ const useCommentsStore = defineStore("comments", () => {
 		v2TrackedChangesAdapter,
 		setV2TrackedChangesAdapter,
 		getV2TrackedChangesAdapter,
+		getV2TrackedChangeRowCount,
 		hydrateTrackedChangesFromV2,
 		reconcileTrackedChangeMutationFromV2,
 		reconcileTrackedChangesFromV2,
@@ -18940,6 +19149,23 @@ var _sfc_main$20 = {
 		const onV2HostEvent = (document$1, event) => {
 			if (!event) return;
 			const documentId = document$1?.id ?? null;
+			if (event.type === "review-mutation:started") {
+				const activeEditor = proxy.$superdoc?.activeEditor ?? null;
+				commentsStore.supersedeV2ReviewHydration?.({
+					commentsAdapter: activeEditor?.v2Comments ?? null,
+					trackedChangesAdapter: activeEditor?.v2TrackedChanges ?? null
+				});
+				v2ReviewHydrationController.beginMutation(event.reviewMutation);
+				return;
+			}
+			if (event.type === "review-mutation:aborted") {
+				v2ReviewHydrationController.settleMutation(event.reviewMutation?.token, {
+					outcome: "aborted",
+					resumeDomains: ["comments", "trackedChanges"],
+					trackedRowCount: commentsStore.getV2TrackedChangeRowCount?.(documentId) ?? null
+				});
+				return;
+			}
 			if (event.type === "reviewTarget:changed") {
 				syncSidebarActiveCommentFromV2ReviewTarget(event.next);
 				return;
@@ -18958,6 +19184,11 @@ var _sfc_main$20 = {
 				return;
 			}
 			if (event.type === "mutation:rejected") {
+				if (event.reviewMutation?.token) v2ReviewHydrationController.settleMutation(event.reviewMutation.token, {
+					outcome: "rejected",
+					resumeDomains: ["comments", "trackedChanges"],
+					trackedRowCount: commentsStore.getV2TrackedChangeRowCount?.(documentId) ?? null
+				});
 				maybeNotifyV2AuthorRequired(documentId, event);
 				return;
 			}
@@ -18973,7 +19204,22 @@ var _sfc_main$20 = {
 			const readiness = (proxy.$superdoc?.activeEditor ?? null)?.documentMutationReadiness ?? null;
 			const receipt = event.origin === "history" ? null : event.receipt;
 			const canWaitForExactPaint = reviewImpact && typeof receipt?.txId === "string" && receipt.txId.length > 0 && typeof readiness?.whenPainted === "function";
-			v2ReviewMutationReconciler.enqueueAfterPaint(reviewImpact, canWaitForExactPaint ? () => readiness.whenPainted.call(readiness, receipt) : null);
+			const reconciliation = v2ReviewMutationReconciler.enqueueAfterPaint(reviewImpact, canWaitForExactPaint ? () => readiness.whenPainted.call(readiness, receipt) : null);
+			if (event.reviewMutation?.token) {
+				const reviewMutation = event.reviewMutation;
+				const allResolved = Boolean(reviewImpact?.allResolved ?? event.trackedChangeAllResolved);
+				const settleReviewMutation = (reconciled) => {
+					const reconciledAllResolved = allResolved && reconciled === true;
+					v2ReviewHydrationController.settleMutation(reviewMutation.token, {
+						outcome: "committed",
+						allResolved: reconciledAllResolved,
+						resumeDomains: reconciledAllResolved ? ["comments"] : ["comments", "trackedChanges"],
+						trackedRowCount: commentsStore.getV2TrackedChangeRowCount?.(documentId) ?? null
+					});
+				};
+				Promise.resolve(reconciliation).then(settleReviewMutation, () => settleReviewMutation(false));
+				return;
+			}
 			if (reviewImpact?.reconcileMode === "authoritative" && reviewImpact.upsertIds.size > 0) {
 				hydrateV2CommentRowsFromHost();
 				return;
@@ -20109,7 +20355,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-d75089d2"]]);
+var SuperDoc_default = /* @__PURE__ */ require__plugin_vue_export_helper.__plugin_vue_export_helper_default(_sfc_main$20, [["__scopeId", "data-v-e489229f"]]);
 var PINIA_DEVTOOLS_SETUP_EVENT = "devtools-plugin:setup";
 var PINIA_DEVTOOLS_PLUGIN_ID = "dev.esm.pinia";
 var piniaDevtoolsSuppressionState = {
@@ -38846,7 +39092,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.4.0-next.2";
+		this.version = "2.4.0-next.3";
 		this.#log("🦋 [superdoc] Using SuperDoc version:", this.version);
 		this.superdocId = config.superdocId || require_uuid.v4_default();
 		this.colors = this.config.colors ?? [];
@@ -39728,8 +39974,8 @@ var SuperDoc = class extends require_eventemitter3.import_eventemitter3.default
 			},
 			{
 				feature: "shell.tracked-change-sidebar.bulk",
-				status: "not-shipped",
-				reason: "bulk-tracked-change-decisions-omitted: acceptAll/rejectAll are matrix-disabled by default in the v2 host"
+				status: "supported",
+				reason: "SD-4039/SD-4040: the shipped v2 command posture exposes all-story Accept All and Reject All through the canonical doc.trackChanges.decide({ target: { kind: 'all' } }) mutation"
 			},
 			{
 				feature: "shell.tracked-change-sidebar.non-body",