superdoc 2.4.0-next.3 → 2.4.0-next.5

package/dist/superdoc.cjs

@@ -4,9 +4,9 @@ const require_blank_docx = require("./chunks/blank-docx-DP8RUPW-.cjs");
 const require_eventemitter3 = require("./chunks/eventemitter3-DqY4aSMf.cjs");
 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-BHMQEL2y.cjs");
+const require_create_super_doc_ui = require("./chunks/create-super-doc-ui-sMXbYzhs.cjs");
+const require__plugin_vue_export_helper = require("./chunks/_plugin-vue_export-helper-CZ1Nl59K.cjs");
+const require_constants = require("./chunks/constants-D7TNtyJd.cjs");
 let vue = require("vue");
 vue = require_rolldown_runtime.__toESM(vue);
 require("y-websocket");
@@ -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) => {
@@ -14570,7 +14760,7 @@ function usePasswordPrompt({ getSurfaceManager, getPasswordPromptConfig, onUnhan
 				})
 			});
 		} else {
-			const PasswordPromptSurface = (await Promise.resolve().then(() => require("./chunks/PasswordPromptSurface-BUUVC2ee.cjs"))).default;
+			const PasswordPromptSurface = (await Promise.resolve().then(() => require("./chunks/PasswordPromptSurface-Bu5xHm91.cjs"))).default;
 			const surfaceId = `password-prompt-${doc.id}`;
 			handle = manager.open({
 				id: surfaceId,
@@ -15219,7 +15409,7 @@ function useFindReplace({ getSurfaceManager, getActiveEditor, activeEditorRef, g
 			} else {
 				let FindReplaceSurface;
 				try {
-					FindReplaceSurface = (await Promise.resolve().then(() => require("./chunks/FindReplaceSurface-Dx0llWqP.cjs"))).default;
+					FindReplaceSurface = (await Promise.resolve().then(() => require("./chunks/FindReplaceSurface-C-I4GcRE.cjs"))).default;
 				} catch {
 					opening = false;
 					return;
@@ -17915,7 +18105,7 @@ var _sfc_main$20 = {
 	__name: "SuperDoc",
 	emits: ["selection-update"],
 	setup(__props, { emit: __emit }) {
-		const PdfViewer = (0, vue.defineAsyncComponent)(() => Promise.resolve().then(() => require("./chunks/PdfViewer-qpvzwYMz.cjs")));
+		const PdfViewer = (0, vue.defineAsyncComponent)(() => Promise.resolve().then(() => require("./chunks/PdfViewer-D4eD2dV1.cjs")));
 		const getDocumentLoadPassword = (doc) => doc.password ?? proxy.$superdoc.config.password;
 		const resolveDocumentV2Collaboration = (doc) => {
 			const rawConfig = doc?.v2Collaboration;
@@ -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 = {
@@ -38821,6 +39026,11 @@ var BuiltInToolbar = class extends require_eventemitter3.import_eventemitter3.de
 function createBuiltInToolbar(config) {
 	return new BuiltInToolbar(config);
 }
+var STRUCTURED_CONTENT_FRAME_SELECTOR = [
+	"[data-sdt-type=\"structuredContent\"][data-sdt-id]",
+	"[data-sdt-type=\"structuredContent\"][data-sdt-container-id]",
+	"[data-sdt-container-type=\"structuredContent\"][data-sdt-container-id]"
+].join(", ");
 var DEFAULT_AWARENESS_PALETTE = Object.freeze([
 	"#FF6B6B",
 	"#4ECDC4",
@@ -38908,6 +39118,33 @@ function onCollaborationProviderSynced(provider, onSynced) {
 	if (isCollaborationProviderSynced(provider)) finish();
 	return cleanup;
 }
+function getClickedContentControlId(event, root) {
+	const path = event.composedPath();
+	if (!path.includes(root)) return null;
+	const control = path.find((target$1) => target$1 instanceof HTMLElement && target$1.matches(STRUCTURED_CONTENT_FRAME_SELECTOR));
+	if (!control) return null;
+	const onBlockLabel = path.some((target$1) => target$1 instanceof HTMLElement && target$1.classList.contains(require_create_super_doc_ui.DOM_CLASS_NAMES.BLOCK_SDT_LABEL));
+	const containerId = control.getAttribute("data-sdt-container-id")?.trim() || null;
+	const sdtId = control.getAttribute("data-sdt-id")?.trim() || null;
+	return onBlockLabel ? containerId ?? sdtId : sdtId ?? containerId;
+}
+function getContentControlItems(result) {
+	if (!result || typeof result !== "object") return [];
+	const items = result.items;
+	return Array.isArray(items) ? items : [];
+}
+function toSdtRef(item) {
+	if (!item || typeof item.id !== "string" || item.kind !== "inline" && item.kind !== "block" || typeof item.controlType !== "string") return null;
+	const tag = item.properties?.tag;
+	const alias = item.properties?.alias;
+	return {
+		id: item.id,
+		controlType: item.controlType,
+		scope: item.kind,
+		...typeof tag === "string" && tag ? { tag } : {},
+		...typeof alias === "string" && alias ? { alias } : {}
+	};
+}
 function isV2ActiveEditorFacade(editor) {
 	return Boolean(editor && typeof editor === "object" && editor.editorVersion === 2);
 }
@@ -38961,6 +39198,10 @@ var SuperDoc = class extends require_eventemitter3.import_eventemitter3.default
 	#v2LockUnsub = null;
 	#pendingV2LockSeed = null;
 	#mountWrapper = null;
+	#contentControlClickRoot = null;
+	#handleContentControlClick = (event) => {
+		this.#emitContentControlClick(event);
+	};
 	#ui = null;
 	#uiConfig = normalizeUiConfig({});
 	get uiConfig() {
@@ -39044,8 +39285,28 @@ var SuperDoc = class extends require_eventemitter3.import_eventemitter3.default
 		const container = typeof config.selector === "string" ? document.querySelector(config.selector) : config.selector;
 		if (!(container instanceof HTMLElement)) throw new Error("SuperDoc: selector must be a valid CSS selector string or DOM element");
 		this.#surfaceManager = new SurfaceManager({ getModuleConfig: () => this.#surfacesConfig });
+		this.#contentControlClickRoot = container;
+		container.addEventListener("click", this.#handleContentControlClick, true);
 		this.#init(config, container);
 	}
+	async #emitContentControlClick(event) {
+		const root = this.#contentControlClickRoot;
+		if (!root) return;
+		const id = getClickedContentControlId(event, root);
+		const list = this.activeEditor?.doc?.contentControls?.list;
+		if (!id || typeof list !== "function") return;
+		try {
+			const result = await list();
+			if (this.#destroyed) return;
+			const target$1 = toSdtRef(getContentControlItems(result).find((item) => item.id === id));
+			if (target$1) this.emit("content-control:click", {
+				target: target$1,
+				source: "pointer"
+			});
+		} catch {
+			return;
+		}
+	}
 	async #init(config, container) {
 		this.config = {
 			...this.config,
@@ -39092,7 +39353,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.5";
 		this.#log("🦋 [superdoc] Using SuperDoc version:", this.version);
 		this.superdocId = config.superdocId || require_uuid.v4_default();
 		this.colors = this.config.colors ?? [];
@@ -40620,6 +40881,8 @@ var SuperDoc = class extends require_eventemitter3.import_eventemitter3.default
 	}
 	destroy() {
 		this.#destroyed = true;
+		this.#contentControlClickRoot?.removeEventListener("click", this.#handleContentControlClick, true);
+		this.#contentControlClickRoot = null;
 		if (this.#abortUpgrade) {
 			this.#abortUpgrade();
 			this.#abortUpgrade = null;