superdoc 2.4.0-next.3 → 2.4.0-next.4

package/dist/superdoc.cjs

@@ -6327,6 +6327,7 @@ function createStubReviewHydrationController() {
 		setContext() {},
 		onRenderReadiness() {},
 		hydrateNow() {},
+		reconcileInBackground() {},
 		invalidate() {},
 		reset() {},
 		getDiagnostics() {
@@ -6526,6 +6527,8 @@ var COMMENT_DRAFT_BLOCK_OPEN_TAG = /<(?:p|div|li|blockquote|pre|h[1-6])(?:\s[^>]
 var COMMENT_DRAFT_BLOCK_CLOSE_TAG = /<\/(?:p|div|li|blockquote|pre|h[1-6])\s*>/gi;
 var COMMENT_DRAFT_ANY_TAG = /<\/?[A-Za-z][A-Za-z0-9:-]*(?:\s[^>]*)?\s*\/?>/g;
 var COMMENT_DRAFT_ENTITY = /&(#x[0-9a-fA-F]+|#\d+|[a-zA-Z][a-zA-Z0-9]+);/g;
+var TRACKED_CHANGE_BACKGROUND_RECONCILE_BATCH_SIZE = 50;
+var TRACKED_CHANGE_BACKGROUND_RECONCILE_YIELD_TIMEOUT_MS = 50;
 var COMMENT_DRAFT_NAMED_ENTITIES = {
 	amp: "&",
 	apos: "'",
@@ -6542,6 +6545,13 @@ var shallowEqual = (a, b) => {
 	if (aKeys.length !== bKeys.length) return false;
 	return aKeys.every((key) => Object.prototype.hasOwnProperty.call(b, key) && Object.is(a[key], b[key]));
 };
+var yieldForTrackedChangeBackgroundReconcile = () => new Promise((resolve) => {
+	if (typeof globalThis.requestIdleCallback === "function") {
+		globalThis.requestIdleCallback(resolve, { timeout: TRACKED_CHANGE_BACKGROUND_RECONCILE_YIELD_TIMEOUT_MS });
+		return;
+	}
+	setTimeout(resolve, 0);
+});
 var normalizeTrackedChangeDetailLines = (lines) => {
 	if (!Array.isArray(lines)) return null;
 	const normalized = lines.filter((line) => line && typeof line === "object").map((line) => ({
@@ -8155,7 +8165,7 @@ const useCommentsStore = defineStore("comments", () => {
 		if (!adapter) return false;
 		return v2TrackedChangesAdapter.value === adapter;
 	};
-	const applyReviewSnapshotFromV2 = ({ superdoc, commentsAdapter, trackedChangesAdapter, documentId, commentItems, trackedChangeItems, trackedList, patch } = {}) => withInteractionSpan("store.reviewSnapshot.apply", "store-reconciliation", {
+	const applyReviewSnapshotFromV2 = ({ superdoc, commentsAdapter, trackedChangesAdapter, documentId, commentItems, trackedChangeItems, trackedList, sourceCoverageRevision, evaluatedRevision, patch } = {}) => withInteractionSpan("store.reviewSnapshot.apply", "store-reconciliation", {
 		commentItemCount: Array.isArray(commentItems) ? commentItems.length : null,
 		trackedItemCount: Array.isArray(trackedChangeItems) ? trackedChangeItems.length : null
 	}, () => {
@@ -8193,11 +8203,28 @@ const useCommentsStore = defineStore("comments", () => {
 			ok: false,
 			reason: "adapter-mapper-missing"
 		};
+		let effectiveCommentItems = commentItems;
+		let commentItemsArePartial = false;
+		if (typeof commentsAdapter.seedReviewCatalog === "function") {
+			const seeded = commentsAdapter.seedReviewCatalog(commentItems, {
+				sourceCoverageRevision,
+				evaluatedRevision
+			});
+			if (seeded?.ok !== true) return {
+				ok: false,
+				reason: seeded?.reason ?? "comment-catalog-seed-failed"
+			};
+			const selected = commentsAdapter.selectVisibleReviewComments?.();
+			if (selected?.ok === true && Array.isArray(selected.items) && (!Array.isArray(selected.unresolvedIds) || selected.unresolvedIds.length === 0)) {
+				effectiveCommentItems = selected.items;
+				commentItemsArePartial = true;
+			}
+		}
 		const fileType = (normalizedDocumentId ? superdocStore.getDocument(normalizedDocumentId) : null)?.type ?? null;
 		let preparedInputs;
 		let preparedParams;
 		try {
-			preparedInputs = commentItems.filter((item) => !isSyntheticTrackedChangeCommentLaneItem(item)).map((item) => commentsAdapter.mapV2CommentToUseCommentInput(item, {
+			preparedInputs = effectiveCommentItems.filter((item) => !isSyntheticTrackedChangeCommentLaneItem(item)).map((item) => commentsAdapter.mapV2CommentToUseCommentInput(item, {
 				fileId: normalizedDocumentId,
 				fileType
 			})).filter(Boolean);
@@ -8226,8 +8253,9 @@ const useCommentsStore = defineStore("comments", () => {
 				superdoc,
 				adapter: commentsAdapter,
 				documentId: normalizedDocumentId,
-				items: commentItems,
-				preparedInputs
+				items: effectiveCommentItems,
+				preparedInputs,
+				pruneStale: !commentItemsArePartial
 			});
 		});
 		return {
@@ -8236,12 +8264,19 @@ const useCommentsStore = defineStore("comments", () => {
 			trackedItems: preparedParams.length
 		};
 	});
-	const hydrateCommentsFromV2 = async ({ superdoc, adapter, documentId, signal, hydrationGeneration } = {}) => withInteractionSpan("store.comments.hydrateFromV2", "comments-list", { documentId: documentId ?? null }, async () => {
+	const hydrateCommentsFromV2 = async ({ superdoc, adapter, documentId, trackedChangesListMode = "all", isCurrent, signal, hydrationGeneration } = {}) => withInteractionSpan("store.comments.hydrateFromV2", "comments-list", { documentId: documentId ?? null }, async () => {
 		const effectiveAdapter = adapter ?? getV2CommentsAdapter(superdoc);
-		if (!effectiveAdapter || typeof effectiveAdapter.refresh !== "function") return {
+		const visibleWindow = trackedChangesListMode === "visible-window";
+		const read = visibleWindow ? effectiveAdapter?.selectVisibleReviewComments : effectiveAdapter?.refresh;
+		if (!effectiveAdapter || typeof read !== "function") return {
 			ok: false,
 			reason: "adapter-missing"
 		};
+		const hydrationIsCurrent = () => isCurrent?.() !== false && isCurrentV2CommentsAdapter(effectiveAdapter);
+		if (!hydrationIsCurrent()) return {
+			ok: false,
+			reason: "adapter-stale"
+		};
 		if (signal?.aborted) return {
 			ok: false,
 			reason: "review-hydration-superseded",
@@ -8253,7 +8288,7 @@ const useCommentsStore = defineStore("comments", () => {
 			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();
+			result = Object.keys(refreshOptions).length > 0 ? await read.call(effectiveAdapter, refreshOptions) : await read.call(effectiveAdapter);
 		} catch (err) {
 			return {
 				ok: false,
@@ -8261,7 +8296,7 @@ const useCommentsStore = defineStore("comments", () => {
 				detail: err?.message ?? String(err)
 			};
 		}
-		if (!isCurrentV2CommentsAdapter(effectiveAdapter)) return {
+		if (!hydrationIsCurrent()) return {
 			ok: false,
 			reason: "adapter-stale"
 		};
@@ -8281,16 +8316,18 @@ const useCommentsStore = defineStore("comments", () => {
 			adapter: effectiveAdapter,
 			documentId,
 			items: result.items ?? [],
+			pruneStale: !visibleWindow,
 			hydrationGeneration
 		});
 		return {
 			ok: true,
 			items: result.items ?? [],
 			reconciled: true,
-			...typeof hydrationGeneration === "number" ? { hydrationGeneration } : {}
+			...typeof hydrationGeneration === "number" ? { hydrationGeneration } : {},
+			...result.visibleWindowSource != null ? { visibleWindowSource: result.visibleWindowSource } : {}
 		};
 	});
-	const reconcileCommentsFromV2 = ({ superdoc, adapter, documentId, items, preparedInputs = null, hydrationGeneration } = {}) => withInteractionSpan("store.comments.reconcile", "store-reconciliation", {
+	const reconcileCommentsFromV2 = ({ superdoc, adapter, documentId, items, preparedInputs = null, pruneStale = true, hydrationGeneration } = {}) => withInteractionSpan("store.comments.reconcile", "store-reconciliation", {
 		documentId: documentId ?? null,
 		itemCount: Array.isArray(items) ? items.length : null,
 		hydrationGeneration: hydrationGeneration ?? null
@@ -8408,6 +8445,7 @@ const useCommentsStore = defineStore("comments", () => {
 				seenIncoming.add(cid);
 				nextList.push(existing);
 			}
+			if (!input && !pruneStale) nextList.push(existing);
 		}
 		for (const [cid, input] of incomingByCommentId.entries()) {
 			if (seenIncoming.has(cid)) continue;
@@ -9326,7 +9364,7 @@ const useCommentsStore = defineStore("comments", () => {
 			success: Boolean(command(id))
 		};
 	};
-	const hydrateTrackedChangesFromV2 = async ({ superdoc, adapter, documentId, trackedChangesListMode = "all", refreshReason, blocking, signal, hydrationGeneration } = {}) => withInteractionSpan("store.trackedChanges.hydrateFromV2", "tracked-change-list", {
+	const hydrateTrackedChangesFromV2 = async ({ superdoc, adapter, documentId, trackedChangesListMode = "all", refreshReason, blocking, isCurrent, targetIds, reconciliationBatchSize = TRACKED_CHANGE_BACKGROUND_RECONCILE_BATCH_SIZE, signal, hydrationGeneration } = {}) => withInteractionSpan("store.trackedChanges.hydrateFromV2", "tracked-change-list", {
 		documentId: documentId ?? null,
 		trackedChangesListMode,
 		refreshReason: refreshReason ?? null,
@@ -9337,19 +9375,49 @@ const useCommentsStore = defineStore("comments", () => {
 			ok: false,
 			reason: "adapter-missing"
 		};
+		const hydrationIsCurrent = () => isCurrent?.() !== false && isCurrentV2TrackedChangesAdapter(effectiveAdapter);
+		if (!hydrationIsCurrent()) return {
+			ok: false,
+			reason: "adapter-stale"
+		};
 		const syncGeneration = trackedChangeSyncGeneration(effectiveAdapter);
+		const hydrationCanContinue = () => hydrationIsCurrent() && !signal?.aborted && trackedChangeSyncGeneration(effectiveAdapter) === syncGeneration;
 		if (signal?.aborted) return {
 			ok: false,
 			reason: "review-hydration-superseded",
 			lateResultDropped: false
 		};
+		const incrementalLiveIds = /* @__PURE__ */ new Set();
+		const incrementalLiveAnchorKeys = /* @__PURE__ */ new Set();
+		let incrementalPagesApplied = 0;
+		let incrementalItemsApplied = 0;
 		let result;
 		try {
 			const listOptions = { mode: trackedChangesListMode };
+			if (Array.isArray(targetIds)) listOptions.targetIds = targetIds;
 			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;
+			if (trackedChangesListMode === "background-reconcile") {
+				listOptions.shouldContinue = hydrationCanContinue;
+				listOptions.onPage = async (page) => {
+					if (!hydrationCanContinue()) return;
+					const pageItems = Array.isArray(page?.items) ? page.items : [];
+					if (!reconcileTrackedChangesFromV2({
+						superdoc,
+						adapter: effectiveAdapter,
+						documentId,
+						items: pageItems,
+						pruneStale: false,
+						liveIds: incrementalLiveIds,
+						liveAnchorKeys: incrementalLiveAnchorKeys,
+						hydrationGeneration
+					}) || !hydrationCanContinue()) return;
+					incrementalPagesApplied += 1;
+					incrementalItemsApplied += pageItems.length;
+				};
+			}
 			result = await effectiveAdapter.listTrackedChanges(listOptions);
 		} catch (err) {
 			return {
@@ -9358,7 +9426,7 @@ const useCommentsStore = defineStore("comments", () => {
 				detail: err?.message ?? String(err)
 			};
 		}
-		if (!isCurrentV2TrackedChangesAdapter(effectiveAdapter)) return {
+		if (!hydrationIsCurrent()) return {
 			ok: false,
 			reason: "adapter-stale"
 		};
@@ -9379,7 +9447,35 @@ const useCommentsStore = defineStore("comments", () => {
 			reason: "review-hydration-superseded",
 			lateResultDropped: true
 		};
-		reconcileTrackedChangesFromV2({
+		if (trackedChangesListMode === "background-reconcile") if (incrementalPagesApplied > 0) {
+			if (!hydrationCanContinue()) return {
+				ok: false,
+				reason: "reconciliation-stale"
+			};
+			const effectiveDocumentId = documentId ?? effectiveAdapter.documentId ?? superdoc?.activeEditor?.documentId ?? null;
+			if (pruneStale && effectiveDocumentId) withInteractionSpan("store.trackedChanges.reconcile.finalPrune", "store-reconciliation", {
+				documentId: effectiveDocumentId,
+				liveIds: incrementalLiveIds.size,
+				liveAnchorKeys: incrementalLiveAnchorKeys.size
+			}, () => {
+				if (!hydrationCanContinue()) return;
+				pruneStaleTrackedChangeComments(incrementalLiveIds, incrementalLiveAnchorKeys, String(effectiveDocumentId), superdoc, { broadcastChanges: false });
+			});
+		} else {
+			const reconcileResult = await reconcileTrackedChangesFromV2Incrementally({
+				superdoc,
+				adapter: effectiveAdapter,
+				documentId,
+				items: result.items ?? [],
+				pruneStale,
+				isCurrent: hydrationIsCurrent,
+				batchSize: reconciliationBatchSize,
+				hydrationGeneration
+			});
+			if (!reconcileResult.ok) return reconcileResult;
+			incrementalItemsApplied = reconcileResult.appliedItems;
+		}
+		else reconcileTrackedChangesFromV2({
 			superdoc,
 			adapter: effectiveAdapter,
 			documentId,
@@ -9399,6 +9495,12 @@ const useCommentsStore = defineStore("comments", () => {
 		if (result.visibleWindowFallbackReason != null) hydrationResult.visibleWindowFallbackReason = result.visibleWindowFallbackReason;
 		if (typeof result.visibleTrackedChangeExpectedRows === "number") hydrationResult.visibleTrackedChangeExpectedRows = result.visibleTrackedChangeExpectedRows;
 		if (typeof result.visibleTrackedChangeObservedRows === "number") hydrationResult.visibleTrackedChangeObservedRows = result.visibleTrackedChangeObservedRows;
+		for (const key of [
+			"visibleTrackedChangeRequestedIds",
+			"visibleTrackedChangeSucceededIds",
+			"visibleTrackedChangeFailedIds"
+		]) if (Array.isArray(result[key])) hydrationResult[key] = [...result[key]];
+		if (Array.isArray(result.visibleWindowGetFailures)) hydrationResult.visibleWindowGetFailures = result.visibleWindowGetFailures.map((failure) => ({ ...failure }));
 		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;
@@ -9407,6 +9509,11 @@ const useCommentsStore = defineStore("comments", () => {
 		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;
+		if (typeof result.evaluatedRevision === "string") hydrationResult.evaluatedRevision = result.evaluatedRevision;
+		if (trackedChangesListMode === "background-reconcile") {
+			hydrationResult.incrementalPagesApplied = incrementalPagesApplied;
+			hydrationResult.incrementalItemsApplied = incrementalItemsApplied;
+		}
 		return hydrationResult;
 	});
 	const reconcileTrackedChangeMutationFromV2 = async ({ superdoc, adapter, documentId, upsertIds = [], removedIds = [], allResolved } = {}) => {
@@ -9561,7 +9668,7 @@ const useCommentsStore = defineStore("comments", () => {
 			}
 		};
 	};
-	const reconcileTrackedChangesFromV2 = ({ superdoc, adapter, documentId, items, pruneStale = true, preparedParams = null, hydrationGeneration } = {}) => withInteractionSpan("store.trackedChanges.reconcile", "store-reconciliation", {
+	const reconcileTrackedChangesFromV2 = ({ superdoc, adapter, documentId, items, pruneStale = true, preparedParams = null, liveIds: suppliedLiveIds = null, liveAnchorKeys: suppliedLiveAnchorKeys = null, hydrationGeneration } = {}) => withInteractionSpan("store.trackedChanges.reconcile", "store-reconciliation", {
 		documentId: documentId ?? null,
 		itemCount: Array.isArray(items) ? items.length : null,
 		pruneStale,
@@ -9570,8 +9677,9 @@ const useCommentsStore = defineStore("comments", () => {
 		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 liveAnchorKeys = suppliedLiveAnchorKeys instanceof Set ? suppliedLiveAnchorKeys : /* @__PURE__ */ new Set();
+		const liveIds = suppliedLiveIds instanceof Set ? suppliedLiveIds : /* @__PURE__ */ new Set();
+		let appliedCount = 0;
 		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));
@@ -9591,13 +9699,95 @@ const useCommentsStore = defineStore("comments", () => {
 					broadcastChanges: false,
 					trackedChangeIdentityIndex
 				});
+				appliedCount += 1;
 			}
 		} finally {
 			endInteractionSpan(identitySpan, trackedChangeIdentityIndex.work());
 		}
-		if (!effectiveDocumentId || !pruneStale) return;
+		if (!effectiveDocumentId || !pruneStale) return {
+			liveIds,
+			liveAnchorKeys,
+			appliedCount
+		};
 		pruneStaleTrackedChangeComments(liveIds, liveAnchorKeys, String(effectiveDocumentId), superdoc, { broadcastChanges: false });
+		return {
+			liveIds,
+			liveAnchorKeys,
+			appliedCount
+		};
 	});
+	const reconcileTrackedChangesFromV2Incrementally = async ({ superdoc, adapter, documentId, items, pruneStale, isCurrent, batchSize = TRACKED_CHANGE_BACKGROUND_RECONCILE_BATCH_SIZE, hydrationGeneration } = {}) => {
+		if (!adapter || !Array.isArray(items)) return {
+			ok: false,
+			reason: "reconcile-input-invalid"
+		};
+		const current = () => isCurrent?.() !== false && isCurrentV2TrackedChangesAdapter(adapter);
+		if (!current()) return {
+			ok: false,
+			reason: "reconciliation-stale"
+		};
+		const effectiveBatchSize = Math.max(1, Math.floor(Number(batchSize) || TRACKED_CHANGE_BACKGROUND_RECONCILE_BATCH_SIZE));
+		const effectiveDocumentId = documentId ?? adapter.documentId ?? superdoc?.activeEditor?.documentId ?? null;
+		const liveIds = /* @__PURE__ */ new Set();
+		const liveAnchorKeys = /* @__PURE__ */ new Set();
+		let appliedItems = 0;
+		let batchCount = 0;
+		for (let offset = 0; offset < items.length; offset += effectiveBatchSize) {
+			if (!current()) return {
+				ok: false,
+				reason: "reconciliation-stale",
+				appliedItems,
+				batchCount
+			};
+			const batch = items.slice(offset, offset + effectiveBatchSize);
+			if (!reconcileTrackedChangesFromV2({
+				superdoc,
+				adapter,
+				documentId: effectiveDocumentId,
+				items: batch,
+				pruneStale: false,
+				liveIds,
+				liveAnchorKeys,
+				hydrationGeneration
+			}) || !current()) return {
+				ok: false,
+				reason: "reconciliation-stale",
+				appliedItems,
+				batchCount
+			};
+			appliedItems += batch.length;
+			batchCount += 1;
+			if (offset + effectiveBatchSize < items.length) await yieldForTrackedChangeBackgroundReconcile();
+		}
+		if (!current()) return {
+			ok: false,
+			reason: "reconciliation-stale",
+			appliedItems,
+			batchCount
+		};
+		if (pruneStale && effectiveDocumentId) {
+			withInteractionSpan("store.trackedChanges.reconcile.finalPrune", "store-reconciliation", {
+				documentId: effectiveDocumentId,
+				liveIds: liveIds.size,
+				liveAnchorKeys: liveAnchorKeys.size
+			}, () => {
+				if (!current()) return;
+				pruneStaleTrackedChangeComments(liveIds, liveAnchorKeys, String(effectiveDocumentId), superdoc, { broadcastChanges: false });
+			});
+			if (!current()) return {
+				ok: false,
+				reason: "reconciliation-stale",
+				appliedItems,
+				batchCount
+			};
+		}
+		return {
+			ok: true,
+			appliedItems,
+			batchCount,
+			pruned: Boolean(pruneStale && effectiveDocumentId)
+		};
+	};
 	const getV2TrackedChangeRowCount = (documentId = null) => {
 		const normalizedDocumentId = documentId == null ? null : String(documentId);
 		return commentsList.value.filter((comment) => {
@@ -18227,6 +18417,7 @@ var _sfc_main$20 = {
 		const v2ReviewHydrationController = resolvedEditorIntegration.createReviewHydrationController({
 			hydrateComments: (ctx) => commentsStore.hydrateCommentsFromV2?.(ctx),
 			hydrateTrackedChanges: (ctx) => commentsStore.hydrateTrackedChangesFromV2?.(ctx),
+			primeTrackedChanges: (ctx) => ctx.trackedChangesAdapter?.primeVisibleTrackedChanges?.(ctx.targetIds, ctx.plan),
 			readReviewSnapshot: (ctx) => ctx.trackedChangesAdapter?.readReviewSnapshot?.(ctx.snapshot),
 			validateReviewSnapshot: (_ctx, result) => result?.validate?.() ?? {
 				ok: false,
@@ -18240,6 +18431,8 @@ var _sfc_main$20 = {
 				commentItems: result.comments?.items,
 				trackedChangeItems: result.trackedChanges?.items,
 				trackedList: result.trackedChanges,
+				sourceCoverageRevision: result.sourceCoverageRevision,
+				evaluatedRevision: result.evaluatedRevision,
 				patch: (callback) => commentsStore.$patch(callback)
 			}) ?? {
 				ok: false,
@@ -18917,6 +19110,12 @@ var _sfc_main$20 = {
 					v2ReviewSidebarUnlocked.value = true;
 					v2GeometryEpoch.value = v2GeometryPublisher.getLastEpoch();
 				}
+			},
+			onCommittedPagePaint: (commit) => {
+				v2ReviewHydrationController.onCommittedPagePaint?.({
+					...commit,
+					documentId: commit?.payload?.documentId ?? null
+				});
 			}
 		});
 		const collectV2TrackedChangeRestampIds = (impactOrIds) => {
@@ -19140,7 +19339,7 @@ var _sfc_main$20 = {
 			v2TypingReviewHydrationTimer = setTimeout(attempt, Math.min(V2_TYPING_REVIEW_HYDRATION_IDLE_MS, ceilingRemainingMs));
 		};
 		const v2RemoteReviewHydrationScheduler = createV2RemoteReviewHydrationScheduler({
-			hydrate: () => hydrateV2ReviewRowsFromHost(),
+			hydrate: () => v2ReviewHydrationController.reconcileInBackground?.("remote-review-change"),
 			getActiveDocumentId: () => {
 				const activeEditor = proxy.$superdoc?.activeEditor ?? null;
 				return activeEditor?.documentId ?? activeEditor?.options?.documentId ?? null;
@@ -19393,6 +19592,12 @@ var _sfc_main$20 = {
 				onCommentsUpdate: onEditorCommentsUpdate,
 				onFontsResolved: onFontsResolvedFn,
 				onPageCountKnown: proxy.$superdoc.config.onPageCountKnown ?? null,
+				onReviewWindowPlanned: (payload) => {
+					v2ReviewHydrationController.onReviewWindowPlanned?.({
+						...payload,
+						documentId: doc.id
+					});
+				},
 				fontAssets: proxy.$superdoc.config.fonts,
 				proofing: resolvedProofingConfig.value,
 				isNewFile,
@@ -20355,7 +20560,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-e489229f"]]);
+var SuperDoc_default = /* @__PURE__ */ require__plugin_vue_export_helper.__plugin_vue_export_helper_default(_sfc_main$20, [["__scopeId", "data-v-c3bc8a46"]]);
 var PINIA_DEVTOOLS_SETUP_EVENT = "devtools-plugin:setup";
 var PINIA_DEVTOOLS_PLUGIN_ID = "dev.esm.pinia";
 var piniaDevtoolsSuppressionState = {
@@ -39092,7 +39297,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.3";
+		this.version = "2.4.0-next.4";
 		this.#log("🦋 [superdoc] Using SuperDoc version:", this.version);
 		this.superdocId = config.superdocId || require_uuid.v4_default();
 		this.colors = this.config.colors ?? [];