superdoc 2.0.0-next.27 → 2.0.0-next.29

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-Dvl3EZsv.es.js";
+import { a as createV2ReviewMutationReconciler, i as isV2EditableTextMutationEvent, o as getV2TrackedChangeMutationImpact, t as createSuperDocUI } from "./chunks/create-super-doc-ui-BKVf2uCM.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";
@@ -144,19 +144,50 @@ function compareVersions(version1, version2) {
 	}
 	return 0;
 }
+var registries = /* @__PURE__ */ new WeakMap();
+function ownerDocumentFor(el) {
+	return el.ownerDocument ?? document;
+}
+function unregister(el, ownerDocument) {
+	const registry = registries.get(ownerDocument);
+	registry?.bindings.delete(el);
+	if (registry && registry.bindings.size === 0) {
+		ownerDocument.removeEventListener("click", registry.listener);
+		registries.delete(ownerDocument);
+	}
+}
+function register(el, binding) {
+	const ownerDocument = ownerDocumentFor(el);
+	if (el.__clickOutsideDocument && el.__clickOutsideDocument !== ownerDocument) unregister(el, el.__clickOutsideDocument);
+	let registry = registries.get(ownerDocument);
+	if (!registry) {
+		const bindings = /* @__PURE__ */ new Map();
+		const listener = (event) => {
+			const path = typeof event.composedPath === "function" ? event.composedPath() : null;
+			for (const [element, currentBinding] of bindings) if (!(path?.includes(element) ?? element.contains(event.target))) currentBinding.value?.(event);
+		};
+		registry = {
+			bindings,
+			listener
+		};
+		registries.set(ownerDocument, registry);
+		ownerDocument.addEventListener("click", listener);
+	}
+	registry.bindings.set(el, binding);
+	el.__clickOutsideHandler = registry.listener;
+	el.__clickOutsideDocument = ownerDocument;
+}
 var v_click_outside_default = {
 	mounted(el, binding) {
-		const clickOutsideHandler = (event) => {
-			if (!el.contains(event.target)) binding.value?.(event);
-		};
-		document.addEventListener("click", clickOutsideHandler);
-		el.__clickOutsideHandler = clickOutsideHandler;
+		register(el, binding);
+	},
+	updated(el, binding) {
+		register(el, binding);
 	},
 	unmounted(el) {
-		if (el.__clickOutsideHandler) {
-			document.removeEventListener("click", el.__clickOutsideHandler);
-			delete el.__clickOutsideHandler;
-		}
+		unregister(el, el.__clickOutsideDocument ?? ownerDocumentFor(el));
+		delete el.__clickOutsideHandler;
+		delete el.__clickOutsideDocument;
 	}
 };
 function hasUser(entry) {
@@ -2517,7 +2548,7 @@ var aggregateRectBounds = (rects) => {
 };
 var groupRectsByPage = (rects) => {
 	const groupedRects = /* @__PURE__ */ new Map();
-	rects.forEach((rect) => {
+	(Array.isArray(rects) ? rects : []).forEach((rect) => {
 		const pageIndex = toFinitePageIndex(rect?.pageIndex);
 		if (pageIndex == null) return;
 		const pageRects = groupedRects.get(pageIndex);
@@ -2544,31 +2575,40 @@ var resolveSelectionPageIndex = (comment) => {
 };
 var buildSingleFloatingCommentInstance = ({ id, threadId, comment, positionKey, positionEntry }) => {
 	const geometryPageIndex = toFinitePageIndex(positionEntry?.pageIndex);
-	const pageIndex = geometryPageIndex != null ? geometryPageIndex : resolveSelectionPageIndex(comment);
+	const fallbackPageIndex = comment?.trackedChange ? null : resolveSelectionPageIndex(comment);
 	return {
 		id,
 		threadId,
 		comment,
 		positionKey,
 		positionEntry: positionEntry ?? null,
-		pageIndex,
+		pageIndex: geometryPageIndex ?? fallbackPageIndex,
 		isPrimary: true
 	};
 };
-var buildRepeatedHeaderFooterInstances = ({ comment, positionKey, positionEntry }) => {
+var buildRepeatedHeaderFooterInstances = ({ comment, positionKey, positionEntry, primaryInstanceId }) => {
 	const rectGroups = groupRectsByPage(positionEntry?.rects);
 	if (rectGroups.length < 2) return [];
-	const primaryPageIndex = toFinitePageIndex(positionEntry?.pageIndex) ?? rectGroups[0]?.pageIndex ?? null;
-	return rectGroups.map(({ pageIndex, rects }) => {
+	const renderableGroups = rectGroups.map(({ pageIndex, rects }) => {
 		const bounds = aggregateRectBounds(rects);
-		if (!bounds) return null;
+		return bounds ? {
+			pageIndex,
+			rects,
+			bounds
+		} : null;
+	}).filter(Boolean);
+	if (renderableGroups.length < 2) return [];
+	const geometryPageIndex = toFinitePageIndex(positionEntry?.pageIndex);
+	const primaryPageIndex = renderableGroups.some(({ pageIndex }) => pageIndex === geometryPageIndex) ? geometryPageIndex : renderableGroups[0]?.pageIndex ?? null;
+	return renderableGroups.map(({ pageIndex, rects, bounds }) => {
+		const isPrimary = pageIndex === primaryPageIndex;
 		return {
-			id: buildPageScopedInstanceId(positionKey, pageIndex),
+			id: isPrimary ? primaryInstanceId : buildPageScopedInstanceId(primaryInstanceId, pageIndex),
 			threadId: comment?.commentId ?? positionKey,
 			comment,
 			positionKey,
 			pageIndex,
-			isPrimary: pageIndex === primaryPageIndex,
+			isPrimary,
 			positionEntry: {
 				...positionEntry,
 				pageIndex,
@@ -2576,7 +2616,7 @@ var buildRepeatedHeaderFooterInstances = ({ comment, positionKey, positionEntry
 				bounds
 			}
 		};
-	}).filter(Boolean);
+	});
 };
 const buildFloatingCommentInstances = ({ comment, positionKey, positionEntry, fallbackId }) => {
 	const instanceId = comment?.trackedChange && comment?.trackedChangeCanonicalId && positionKey && fallbackId && String(positionKey) !== String(fallbackId) ? fallbackId : positionKey ?? fallbackId;
@@ -2585,7 +2625,8 @@ const buildFloatingCommentInstances = ({ comment, positionKey, positionEntry, fa
 		const repeatedInstances = buildRepeatedHeaderFooterInstances({
 			comment,
 			positionKey,
-			positionEntry
+			positionEntry,
+			primaryInstanceId: instanceId
 		});
 		if (repeatedInstances.length > 0) return repeatedInstances;
 	}
@@ -2759,6 +2800,79 @@ const trackedChangeThreadParentIdForComment = (comment) => {
 	if (comment?.trackedChangeParentId != null && hasLegacyTrackedChangeThreadSignal(comment)) return comment.trackedChangeParentId;
 	return null;
 };
+const buildTrackedChangeThreadIndex = (allComments, previous = /* @__PURE__ */ new Map()) => {
+	const childrenByParentId = /* @__PURE__ */ new Map();
+	const anchoredRootsByTrackedChangeId = /* @__PURE__ */ new Map();
+	const commentsById = /* @__PURE__ */ new Map();
+	const sourceIndex = /* @__PURE__ */ new Map();
+	const append = (map, key, value) => {
+		const existing = map.get(key);
+		if (existing) existing.push(value);
+		else map.set(key, [value]);
+	};
+	allComments.forEach((comment, index) => {
+		sourceIndex.set(comment, index);
+		append(commentsById, comment.commentId, comment);
+		new Set([comment.parentCommentId, comment.threadingParentCommentId].filter((id) => id != null).map((id) => String(id))).forEach((parentId) => append(childrenByParentId, parentId, comment));
+		const trackedChangeThreadParentId = trackedChangeThreadParentIdForComment(comment);
+		if (trackedChangeThreadParentId != null && !comment.parentCommentId) append(anchoredRootsByTrackedChangeId, String(trackedChangeThreadParentId), comment);
+	});
+	const next = /* @__PURE__ */ new Map();
+	for (const parentComment of allComments) {
+		if (!parentComment?.trackedChange || parentComment.commentId == null) continue;
+		const trackedChangeId = parentComment.commentId;
+		const threadIds = new Set([trackedChangeId]);
+		const queue = [];
+		const seed = typeof trackedChangeId === "string" ? [...childrenByParentId.get(trackedChangeId) ?? [], ...anchoredRootsByTrackedChangeId.get(trackedChangeId) ?? []] : [];
+		for (const comment of seed) {
+			const id = comment.commentId;
+			if (id === trackedChangeId || threadIds.has(id)) continue;
+			threadIds.add(id);
+			queue.push(id);
+		}
+		for (let index = 0; index < queue.length; index += 1) {
+			const parentId = queue[index];
+			for (const comment of typeof parentId === "string" ? childrenByParentId.get(parentId) ?? [] : []) {
+				const id = comment.commentId;
+				if (threadIds.has(id)) continue;
+				threadIds.add(id);
+				queue.push(id);
+			}
+		}
+		const members = [...threadIds].flatMap((id) => commentsById.get(id) ?? []).sort((left, right) => (sourceIndex.get(left) ?? 0) - (sourceIndex.get(right) ?? 0));
+		members.sort((left, right) => {
+			if (left === parentComment) return -1;
+			if (right === parentComment) return 1;
+			return Number(left.createdTime) - Number(right.createdTime);
+		});
+		const prior = previous.get(trackedChangeId);
+		const stable = prior?.length === members.length && members.every((comment, index) => prior[index] === comment) ? prior : members;
+		next.set(trackedChangeId, stable);
+	}
+	return next;
+};
+const buildTrackedChangeDecisionLinkIndex = (allComments, previous = /* @__PURE__ */ new Map()) => {
+	const grouped = /* @__PURE__ */ new Map();
+	for (const comment of allComments) {
+		const ids = new Set([
+			comment.parentCommentId,
+			comment.threadingParentCommentId,
+			comment.trackedChangeParentId,
+			comment.trackedChangeThreadParentId
+		].filter((id) => id != null).map((id) => String(id)));
+		for (const id of ids) {
+			const existing = grouped.get(id);
+			if (existing) existing.push(comment);
+			else grouped.set(id, [comment]);
+		}
+	}
+	const next = /* @__PURE__ */ new Map();
+	for (const [id, comments] of grouped) {
+		const prior = previous.get(id);
+		next.set(id, prior?.length === comments.length && comments.every((comment, index) => prior[index] === comment) ? prior : comments);
+	}
+	return next;
+};
 var Editor = class {
 	constructor() {
 		throw new Error("SuperDoc v2 beta: v1 editor-backed comment import paths are not available.");
@@ -2919,6 +3033,22 @@ const useCommentsStore = defineStore("comments", () => {
 	const suppressInternalExternal = ref(true);
 	const currentCommentText = ref("");
 	const commentsList = ref([]);
+	let priorTrackedChangeThreadIndex = /* @__PURE__ */ new Map();
+	const trackedChangeThreadIndex = computed(() => {
+		const next = buildTrackedChangeThreadIndex(commentsList.value, priorTrackedChangeThreadIndex);
+		priorTrackedChangeThreadIndex = next;
+		return next;
+	});
+	const getTrackedChangeThread = (parentComment) => {
+		const id = parentComment?.commentId ?? null;
+		return (id != null ? trackedChangeThreadIndex.value.get(id) : null) ?? [parentComment].filter(Boolean);
+	};
+	let priorTrackedChangeDecisionLinkIndex = /* @__PURE__ */ new Map();
+	const trackedChangeDecisionLinkIndex = computed(() => {
+		const next = buildTrackedChangeDecisionLinkIndex(commentsList.value, priorTrackedChangeDecisionLinkIndex);
+		priorTrackedChangeDecisionLinkIndex = next;
+		return next;
+	});
 	const isCommentsListVisible = ref(false);
 	const editorCommentIds = ref([]);
 	const editorCommentPositions = ref({});
@@ -3705,6 +3835,7 @@ const useCommentsStore = defineStore("comments", () => {
 		};
 	};
 	const getGroupedComments = computed(() => buildGroupedComments(compareByCreatedTime));
+	const hasOpenTrackedChanges = computed(() => getGroupedComments.value?.parentComments.some((comment) => comment.trackedChange && !comment.resolvedTime) ?? false);
 	const getCommentsByPosition = computed(() => buildGroupedComments(compareByPosition));
 	const hasOverlapId = (id) => overlappedIds.includes(id);
 	const documentsWithConverations = computed(() => {
@@ -4890,7 +5021,7 @@ const useCommentsStore = defineStore("comments", () => {
 			superdoc
 		};
 		let resolvedCount = 0;
-		commentsList.value.forEach((linkedComment) => {
+		getTrackedChangeDecisionLinks(comment).forEach((linkedComment) => {
 			if (!linkedComment || linkedComment === comment) return;
 			if (linkedComment.resolvedTime) return;
 			if (![
@@ -4918,6 +5049,16 @@ const useCommentsStore = defineStore("comments", () => {
 		}
 		return trackedChangeIds;
 	};
+	const getTrackedChangeDecisionLinks = (comment) => {
+		const linked = [];
+		const seen = /* @__PURE__ */ new Set();
+		for (const id of collectTrackedChangeDecisionIds(comment)) for (const candidate of trackedChangeDecisionLinkIndex.value.get(String(id)) ?? []) {
+			if (seen.has(candidate)) continue;
+			seen.add(candidate);
+			linked.push(candidate);
+		}
+		return linked;
+	};
 	const collectTrackedChangeEntityIdsFromReceipt = (receipt) => {
 		const record = receipt && typeof receipt === "object" ? receipt : null;
 		if (!record?.success) return /* @__PURE__ */ new Set();
@@ -4949,7 +5090,7 @@ const useCommentsStore = defineStore("comments", () => {
 		const trackedChangeIds = collectTrackedChangeDecisionIds(comment);
 		if (!trackedChangeIds.size) return 0;
 		let detachedCount = 0;
-		commentsList.value.forEach((linkedComment) => {
+		getTrackedChangeDecisionLinks(comment).forEach((linkedComment) => {
 			if (!linkedComment || linkedComment === comment) return;
 			const trackedChangeParentId = normalizeCommentId(linkedComment.trackedChangeParentId);
 			const trackedChangeThreadParentId = normalizeCommentId(linkedComment.trackedChangeThreadParentId);
@@ -4965,7 +5106,7 @@ const useCommentsStore = defineStore("comments", () => {
 		});
 		return detachedCount;
 	};
-	const pruneDecidedTrackedChangeRow = ({ superdoc, decidedId, decidedIds, documentId } = {}) => {
+	const pruneDecidedTrackedChangeRow = ({ superdoc, comment: targetComment, decidedId, decidedIds, documentId } = {}) => {
 		const normalizedDecidedIds = new Set((Array.isArray(decidedIds) || decidedIds instanceof Set ? Array.from(decidedIds) : [decidedId]).map((id) => normalizeCommentId(id)).filter(Boolean));
 		const normalizedDocumentId = normalizeCommentId(documentId);
 		if (!normalizedDecidedIds.size || !normalizedDocumentId) return {
@@ -4974,7 +5115,13 @@ const useCommentsStore = defineStore("comments", () => {
 		};
 		const removedIds = /* @__PURE__ */ new Set();
 		let removed = false;
-		commentsList.value = commentsList.value.filter((comment) => {
+		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))) {
+			targetIds.forEach((id) => removedIds.add(id));
+			commentsList.value.splice(targetIndex, 1);
+			removed = true;
+		} else commentsList.value = commentsList.value.filter((comment) => {
 			if (!comment?.trackedChange) return true;
 			if (!belongsToTrackedChangeSyncDocument(comment, normalizedDocumentId)) return true;
 			const ids = collectTrackedChangeDecisionIds(comment);
@@ -5010,6 +5157,25 @@ const useCommentsStore = defineStore("comments", () => {
 			adapter.clearActiveTrackedChangeTargetIfMatches(decidedId);
 		} catch {}
 	};
+	const waitForTrackedDecisionCanonicalPaint = async ({ superdoc, receipt } = {}) => {
+		const readiness = superdoc?.activeEditor?.documentMutationReadiness;
+		if (receipt?.success !== true || typeof receipt?.txId !== "string" || !receipt.txId || typeof readiness?.whenPainted !== "function") return;
+		try {
+			await readiness.whenPainted(receipt);
+			const requestFrame = globalThis.requestAnimationFrame;
+			if (typeof requestFrame === "function") await new Promise((resolve) => {
+				let settled = false;
+				const finish = () => {
+					if (settled) return;
+					settled = true;
+					clearTimeout(fallback);
+					resolve();
+				};
+				const fallback = setTimeout(finish, 250);
+				requestFrame(() => requestFrame(() => setTimeout(finish, 0)));
+			});
+		} catch {}
+	};
 	const tracePostDecisionBackgroundReconcile = (superdoc, event, payload = {}) => {
 		const record = {
 			event,
@@ -5161,7 +5327,7 @@ const useCommentsStore = defineStore("comments", () => {
 							adapter: v2Adapter,
 							documentId: effectiveDocumentId,
 							items: listResult.items ?? [],
-							pruneStale: listResult.complete !== false && listResult.sourceCoverageComplete !== false
+							pruneStale: listResult.complete === true && listResult.sourceCoverageComplete === true
 						});
 						const liveIds = new Set((listResult.items ?? []).map((item) => item && item.id != null ? String(item.id) : null).filter(Boolean));
 						if (!(decidedId != null && liveIds.has(decidedId))) {
@@ -5205,6 +5371,17 @@ const useCommentsStore = defineStore("comments", () => {
 						};
 					};
 					if (!reliableDecidedIds.size || !effectiveDocumentId) return runBlockingPostDecisionReconcile();
+					reliableDecidedIds.forEach((id$1) => clearV2ActiveTrackedChangeTarget(v2Adapter, id$1));
+					schedulePostDecisionBackgroundReconcile({
+						superdoc,
+						trackedChangesAdapter: v2Adapter,
+						commentsAdapter: getV2CommentsAdapter(superdoc),
+						documentId: effectiveDocumentId
+					});
+					await waitForTrackedDecisionCanonicalPaint({
+						superdoc,
+						receipt: outcome.receipt
+					});
 					resolveLinkedCommentsForTrackedChangeDecision({
 						superdoc,
 						comment,
@@ -5216,17 +5393,11 @@ const useCommentsStore = defineStore("comments", () => {
 					});
 					pruneDecidedTrackedChangeRow({
 						superdoc,
+						comment,
 						decidedIds: reliableDecidedIds,
 						documentId: effectiveDocumentId
 					});
 					if (wasActiveBeforeDecide) clearActiveCommentSelection();
-					reliableDecidedIds.forEach((id$1) => clearV2ActiveTrackedChangeTarget(v2Adapter, id$1));
-					schedulePostDecisionBackgroundReconcile({
-						superdoc,
-						trackedChangesAdapter: v2Adapter,
-						commentsAdapter: getV2CommentsAdapter(superdoc),
-						documentId: effectiveDocumentId
-					});
 					return {
 						ok: true,
 						success: true
@@ -5295,7 +5466,7 @@ const useCommentsStore = defineStore("comments", () => {
 			reason: "adapter-stale"
 		};
 		if (!result?.ok) return result;
-		const pruneStale = !(trackedChangesListMode === "startup-page" || trackedChangesListMode === "interaction-prime" || trackedChangesListMode === "visible-window") && result.visibleWindowSource == null && result.complete !== false && result.sourceCoverageComplete !== false;
+		const pruneStale = !(trackedChangesListMode === "startup-page" || trackedChangesListMode === "interaction-prime" || trackedChangesListMode === "visible-window") && result.visibleWindowSource == null && result.complete === true && result.sourceCoverageComplete === true;
 		reconcileTrackedChangesFromV2({
 			superdoc,
 			adapter: effectiveAdapter,
@@ -5332,12 +5503,12 @@ const useCommentsStore = defineStore("comments", () => {
 		};
 		const effectiveDocumentId = documentId ?? effectiveAdapter.documentId ?? superdoc?.activeEditor?.documentId ?? null;
 		const normalizedRemovedIds = new Set(Array.from(removedIds ?? []).map((id) => normalizeCommentId(id)).filter(Boolean));
-		if (normalizedRemovedIds.size > 0 && effectiveDocumentId != null) pruneDecidedTrackedChangeRow({
+		const normalizedUpsertIds = [...new Set(Array.from(upsertIds ?? []).map((id) => normalizeCommentId(id)).filter(Boolean))];
+		if (normalizedRemovedIds.size > 0 && normalizedUpsertIds.length === 0 && effectiveDocumentId != null) pruneDecidedTrackedChangeRow({
 			superdoc,
 			decidedIds: normalizedRemovedIds,
 			documentId: effectiveDocumentId
 		});
-		const normalizedUpsertIds = [...new Set(Array.from(upsertIds ?? []).map((id) => normalizeCommentId(id)).filter(Boolean))];
 		if (normalizedUpsertIds.length === 0) return {
 			ok: true,
 			items: [],
@@ -5808,6 +5979,7 @@ const useCommentsStore = defineStore("comments", () => {
 	const getFloatingComments = computed(() => {
 		return getGroupedComments.value?.parentComments.filter((c) => !c.resolvedTime).filter((c) => {
 			if (!isEditorBackedComment(c)) return true;
+			if (isTrackedChangeThread(c)) return true;
 			return Boolean(resolveCommentPositionEntry(c).entry);
 		}).filter((c) => !isInlineTrackedChangeInsideTrackedTable(c));
 	});
@@ -5940,10 +6112,12 @@ const useCommentsStore = defineStore("comments", () => {
 		getConfig,
 		documentsWithConverations,
 		getGroupedComments,
+		hasOpenTrackedChanges,
 		getCommentsByPosition,
 		getFloatingComments,
 		getFloatingCommentInstances,
 		getCommentAliasIds,
+		getTrackedChangeThread,
 		getCommentPositionKey,
 		getCommentPosition,
 		getCommentAnchoredText,
@@ -6851,30 +7025,6 @@ var CommentInput_default = /* @__PURE__ */ __plugin_vue_export_helper_default({
 		};
 	}
 }, [["__scopeId", "data-v-cc54b489"]]);
-const collectTrackedChangeThread = (parentComment, allComments) => {
-	const trackedChangeId = parentComment.commentId;
-	const threadIds = new Set([trackedChangeId]);
-	const queue = [];
-	allComments.forEach((comment) => {
-		if (comment.commentId === trackedChangeId) return;
-		const isDirectChild = [comment.parentCommentId, comment.threadingParentCommentId].filter((id) => id != null).map((id) => String(id)).includes(trackedChangeId);
-		const isTrackedChangeThreadRoot = String(trackedChangeThreadParentIdForComment(comment) ?? "") === trackedChangeId && !comment.parentCommentId;
-		if (isDirectChild || isTrackedChangeThreadRoot) {
-			threadIds.add(comment.commentId);
-			queue.push(comment.commentId);
-		}
-	});
-	for (let i = 0; i < queue.length; i += 1) {
-		const parentId = queue[i];
-		allComments.forEach((comment) => {
-			if ([comment.parentCommentId, comment.threadingParentCommentId].filter((id) => id != null).map((id) => String(id)).includes(parentId) && !threadIds.has(comment.commentId)) {
-				threadIds.add(comment.commentId);
-				queue.push(comment.commentId);
-			}
-		});
-	}
-	return allComments.filter((comment) => threadIds.has(comment.commentId));
-};
 var _hoisted_1$25 = [
 	"data-comment-instance-id",
 	"data-comment-thread-id",
@@ -6962,12 +7112,19 @@ var _hoisted_44 = {
 	class: "comment-separator"
 };
 var _hoisted_45 = {
+	key: 2,
+	class: "tracked-change-decision-alert",
+	role: "alert"
+};
+var _hoisted_46 = { class: "tracked-change-decision-alert__message" };
+var _hoisted_47 = ["disabled", "data-disabled-reason"];
+var _hoisted_48 = {
 	key: 1,
 	class: "reply-expanded"
 };
-var _hoisted_46 = { class: "reply-input-wrapper" };
-var _hoisted_47 = { class: "reply-actions" };
-var _hoisted_48 = ["disabled", "data-disabled-reason"];
+var _hoisted_49 = { class: "reply-input-wrapper" };
+var _hoisted_50 = { class: "reply-actions" };
+var _hoisted_51 = ["disabled", "data-disabled-reason"];
 var CLICK_OUTSIDE_HIT_TOLERANCE_PX = 3;
 var TRACKED_CHANGE_PREVIEW_MAX_PX = 90;
 var CommentDialog_default = /* @__PURE__ */ __plugin_vue_export_helper_default({
@@ -7019,6 +7176,7 @@ var CommentDialog_default = /* @__PURE__ */ __plugin_vue_export_helper_default({
 		const isInternal = ref(true);
 		const commentInput = ref(null);
 		const editCommentInputs = ref(/* @__PURE__ */ new Map());
+		const trackedChangeDecisionFailure = ref(null);
 		const CLICK_OUTSIDE_HIT_SAMPLE_OFFSETS = [
 			[0, 0],
 			[-CLICK_OUTSIDE_HIT_TOLERANCE_PX, 0],
@@ -7186,8 +7344,13 @@ var CommentDialog_default = /* @__PURE__ */ __plugin_vue_export_helper_default({
 		});
 		const commentsAreReadOnly$1 = () => getConfig.value?.readOnly === true;
 		const isReplying = ref(false);
+		const isSubmittingReply = ref(false);
 		const startReply = () => {
 			if (commentsAreReadOnly$1()) return readOnlyMutationOutcome$1();
+			if (isV2WriteDisabled.value) return {
+				ok: false,
+				reason: v2WriteCapability.value?.reason ?? "v2-write-unavailable"
+			};
 			isReplying.value = true;
 			nextTick(() => {
 				commentInput.value?.focus?.();
@@ -7196,12 +7359,12 @@ var CommentDialog_default = /* @__PURE__ */ __plugin_vue_export_helper_default({
 		};
 		const comments = computed(() => {
 			const parentComment = props.comment;
-			const allComments = commentsStore.commentsList;
-			return (parentComment.trackedChange ? collectTrackedChangeThread(parentComment, allComments) : allComments.filter((comment) => {
+			if (parentComment.trackedChange) return commentsStore.getTrackedChangeThread(parentComment);
+			return commentsStore.commentsList.filter((comment) => {
 				const isThreadedComment = comment.parentCommentId === parentComment.commentId;
 				const isThisComment = comment.commentId === parentComment.commentId;
 				return isThreadedComment || isThisComment;
-			})).sort((a, b) => {
+			}).sort((a, b) => {
 				if (a.commentId === parentComment.commentId) return -1;
 				if (b.commentId === parentComment.commentId) return 1;
 				return a.createdTime - b.createdTime;
@@ -7379,20 +7542,33 @@ var CommentDialog_default = /* @__PURE__ */ __plugin_vue_export_helper_default({
 		};
 		const handleAddComment = async () => {
 			if (commentsAreReadOnly$1()) return readOnlyMutationOutcome$1();
+			if (isV2WriteDisabled.value) return {
+				ok: false,
+				reason: v2WriteCapability.value?.reason ?? "v2-write-unavailable"
+			};
 			if (isV2Mode.value && v2CommentsAdapter.value && !isPendingNewComment.value) {
-				const outcome = await commentsStore.replyCommentV2({
-					superdoc: proxy.$superdoc,
-					parentCommentId: getV2ExistingReplyParentId(props.comment),
-					text: currentCommentText.value
-				});
-				if (!outcome?.ok) {
+				if (isSubmittingReply.value) return {
+					ok: false,
+					reason: "reply-submit-in-flight"
+				};
+				isSubmittingReply.value = true;
+				try {
+					const outcome = await commentsStore.replyCommentV2({
+						superdoc: proxy.$superdoc,
+						parentCommentId: getV2ExistingReplyParentId(props.comment),
+						text: currentCommentText.value
+					});
+					if (!outcome?.ok) {
+						nextTick(() => emit("resize"));
+						return outcome;
+					}
+					isReplying.value = false;
+					currentCommentText.value = "";
 					nextTick(() => emit("resize"));
 					return outcome;
+				} finally {
+					isSubmittingReply.value = false;
 				}
-				isReplying.value = false;
-				currentCommentText.value = "";
-				nextTick(() => emit("resize"));
-				return outcome;
 			}
 			const options = {
 				documentId: props.comment.fileId,
@@ -7418,7 +7594,14 @@ var CommentDialog_default = /* @__PURE__ */ __plugin_vue_export_helper_default({
 		const v2TrackedChangesAdapter = computed(() => isV2Mode.value ? proxy.$superdoc?.activeEditor?.v2TrackedChanges ?? null : null);
 		const v2WriteCapability = computed(() => {
 			if (!v2CommentsAdapter.value) return null;
-			return v2CommentsAdapter.value.getCapabilityState?.() ?? null;
+			const documentMode = commentsStore.viewingVisibility.documentMode;
+			const capability = v2CommentsAdapter.value.getCapabilityState?.() ?? null;
+			if (documentMode === "viewing") return {
+				...capability ?? {},
+				canWrite: false,
+				reason: "review-surface-read-only"
+			};
+			return capability;
 		});
 		const isV2WriteDisabled = computed(() => {
 			if (!isV2Mode.value) return false;
@@ -7426,6 +7609,11 @@ var CommentDialog_default = /* @__PURE__ */ __plugin_vue_export_helper_default({
 			if (!cap) return false;
 			return cap.canWrite === false;
 		});
+		const v2ReplyDisabledReason = computed(() => {
+			if (isSubmittingReply.value) return "reply-submit-in-flight";
+			if (!isV2WriteDisabled.value) return null;
+			return v2WriteCapability.value?.reason ?? "v2-write-unavailable";
+		});
 		const v2TrackedChangeCapability = computed(() => {
 			if (!v2TrackedChangesAdapter.value) return null;
 			const documentMode = commentsStore.viewingVisibility.documentMode;
@@ -7468,6 +7656,35 @@ var CommentDialog_default = /* @__PURE__ */ __plugin_vue_export_helper_default({
 			if (!isV2WriteDisabled.value) return null;
 			return v2WriteCapability.value?.reason ?? "v2-write-unavailable";
 		});
+		const reportTrackedChangeDecisionFailure = (decision, outcome) => {
+			trackedChangeDecisionFailure.value = {
+				decision,
+				reason: outcome?.reason ?? null
+			};
+			nextTick(() => emit("resize"));
+		};
+		const clearTrackedChangeDecisionFailure = () => {
+			if (!trackedChangeDecisionFailure.value) return;
+			trackedChangeDecisionFailure.value = null;
+			nextTick(() => emit("resize"));
+		};
+		const trackedChangeDecisionFailureMessage = computed(() => {
+			const failure = trackedChangeDecisionFailure.value;
+			if (!failure) return null;
+			const action = failure.decision === "reject" ? "reject" : "accept";
+			if (failure.reason === "stale-catalog") return `Couldn't ${action} this change because the review list is stale.`;
+			return `Couldn't ${action} this change.`;
+		});
+		const retryTrackedChangeDecision = () => {
+			const failure = trackedChangeDecisionFailure.value;
+			if (!failure) return;
+			trackedChangeDecisionFailure.value = null;
+			if (failure.decision === "reject") {
+				handleReject();
+				return;
+			}
+			handleResolve();
+		};
 		const handleReject = async () => {
 			if (commentsAreReadOnly$1()) return readOnlyMutationOutcome$1();
 			const customHandler = proxy.$superdoc.config.onTrackedChangeBubbleReject;
@@ -7478,7 +7695,11 @@ var CommentDialog_default = /* @__PURE__ */ __plugin_vue_export_helper_default({
 						comment: props.comment,
 						decision: "reject"
 					});
-					if (!outcome?.ok || outcome.success === false) return;
+					if (!outcome?.ok || outcome.success === false) {
+						reportTrackedChangeDecisionFailure("reject", outcome);
+						return;
+					}
+					clearTrackedChangeDecisionFailure();
 					if (typeof customHandler === "function") customHandler(props.comment, proxy.$superdoc.activeEditor);
 					nextTick(() => {
 						commentsStore.lastUpdate = /* @__PURE__ */ new Date();
@@ -7534,7 +7755,11 @@ var CommentDialog_default = /* @__PURE__ */ __plugin_vue_export_helper_default({
 					comment: props.comment,
 					decision: "accept"
 				});
-				if (!outcome?.ok || outcome.success === false) return;
+				if (!outcome?.ok || outcome.success === false) {
+					reportTrackedChangeDecisionFailure("accept", outcome);
+					return;
+				}
+				clearTrackedChangeDecisionFailure();
 				if (typeof customHandler === "function") customHandler(props.comment, proxy.$superdoc.activeEditor);
 				nextTick(() => {
 					commentsStore.lastUpdate = /* @__PURE__ */ new Date();
@@ -7698,6 +7923,11 @@ var CommentDialog_default = /* @__PURE__ */ __plugin_vue_export_helper_default({
 			if (isPendingNewComment.value) cancelComment(proxy.$superdoc);
 			nextTick(() => emit("resize"));
 		}, { immediate: true });
+		watch(isV2WriteDisabled, (isDisabled) => {
+			if (!isDisabled) return;
+			isReplying.value = false;
+			nextTick(() => emit("resize"));
+		});
 		return (_ctx, _cache) => {
 			const _directive_click_outside = resolveDirective("click-outside");
 			return withDirectives((openBlock(), createElementBlock("div", {
@@ -7886,11 +8116,19 @@ var CommentDialog_default = /* @__PURE__ */ __plugin_vue_export_helper_default({
 						showSeparator.value(index) ? (openBlock(), createElementBlock("div", _hoisted_44)) : createCommentVNode("", true)
 					]);
 				}), 128)),
-				showInputSection.value && !unref(getConfig).readOnly ? (openBlock(), createElementBlock(Fragment, { key: 2 }, [!isReplying.value ? (openBlock(), createElementBlock("div", {
+				trackedChangeDecisionFailure.value ? (openBlock(), createElementBlock("div", _hoisted_45, [createElementVNode("span", _hoisted_46, toDisplayString(trackedChangeDecisionFailureMessage.value), 1), createElementVNode("button", {
+					type: "button",
+					class: "sd-button tracked-change-decision-alert__retry",
+					onClick: withModifiers(retryTrackedChangeDecision, ["stop", "prevent"])
+				}, " Retry ")])) : createCommentVNode("", true),
+				showInputSection.value && !unref(getConfig).readOnly ? (openBlock(), createElementBlock(Fragment, { key: 3 }, [!isReplying.value ? (openBlock(), createElementBlock("button", {
 					key: 0,
-					class: "reply-pill",
-					onClick: withModifiers(startReply, ["stop", "prevent"])
-				}, "Reply or add others with @")) : (openBlock(), createElementBlock("div", _hoisted_45, [createElementVNode("div", _hoisted_46, [createVNode(CommentInput_default, {
+					type: "button",
+					class: normalizeClass(["reply-pill", { "sd-is-disabled": isV2WriteDisabled.value }]),
+					onClick: withModifiers(startReply, ["stop", "prevent"]),
+					disabled: isV2WriteDisabled.value,
+					"data-disabled-reason": isV2WriteDisabled.value ? v2WriteCapability.value?.reason ?? null : null
+				}, " Reply or add others with @ ", 10, _hoisted_47)) : (openBlock(), createElementBlock("div", _hoisted_48, [createElementVNode("div", _hoisted_49, [createVNode(CommentInput_default, {
 					ref_key: "commentInput",
 					ref: commentInput,
 					users: usersFiltered.value,
@@ -7901,19 +8139,19 @@ var CommentDialog_default = /* @__PURE__ */ __plugin_vue_export_helper_default({
 					"users",
 					"config",
 					"comment"
-				])]), createElementVNode("div", _hoisted_47, [createElementVNode("button", {
+				])]), createElementVNode("div", _hoisted_50, [createElementVNode("button", {
 					class: "sd-button reply-btn-cancel",
 					onClick: withModifiers(handleCancel, ["stop", "prevent"])
 				}, "Cancel"), createElementVNode("button", {
-					class: normalizeClass(["sd-button primary reply-btn-primary", { "sd-is-disabled": !hasTextContent.value || isV2WriteDisabled.value }]),
+					class: normalizeClass(["sd-button primary reply-btn-primary", { "sd-is-disabled": !hasTextContent.value || isV2WriteDisabled.value || isSubmittingReply.value }]),
 					onClick: withModifiers(handleAddComment, ["stop", "prevent"]),
-					disabled: !hasTextContent.value || isV2WriteDisabled.value,
-					"data-disabled-reason": isV2WriteDisabled.value ? v2WriteCapability.value?.reason ?? null : null
-				}, " Reply ", 10, _hoisted_48)])]))], 64)) : createCommentVNode("", true)
+					disabled: !hasTextContent.value || isV2WriteDisabled.value || isSubmittingReply.value,
+					"data-disabled-reason": v2ReplyDisabledReason.value
+				}, " Reply ", 10, _hoisted_51)])]))], 64)) : createCommentVNode("", true)
 			], 64))], 14, _hoisted_1$25)), [[_directive_click_outside, handleClickOutside]]);
 		};
 	}
-}, [["__scopeId", "data-v-67a03ee2"]]);
+}, [["__scopeId", "data-v-74340036"]]);
 var _hoisted_1$24 = { class: "comments-list" };
 var _hoisted_2$19 = { key: 0 };
 var _hoisted_3$15 = [
@@ -8256,12 +8494,12 @@ const resolvePersistentReviewCardTop = ({ comment, anchorTop, anchorBottom, card
 	if ((Number.isFinite(anchorBottom) ? anchorBottom : anchorTop) < viewportTop) return Math.min(anchorTop, viewportTop - cardHeight - 1);
 	return anchorTop;
 };
-const shouldMountFloatingCommentDialog = ({ id, visibleIds, activeCommentInstanceId, comment }) => {
+const shouldMountFloatingCommentDialog = ({ id, visibleIds, activeCommentInstanceId }) => {
 	if (!id) return false;
 	if (id === "pending") return true;
 	if (activeCommentInstanceId != null && String(id) === String(activeCommentInstanceId)) return true;
 	if (visibleIds?.has?.(id)) return true;
-	return isPersistentReviewSidebarItem(comment);
+	return false;
 };
 const resolveRemovedReviewCardContinuityTarget = ({ previousIds, currentIds, removedId }) => {
 	if (!Array.isArray(previousIds) || !(currentIds instanceof Set) || !removedId) return null;
@@ -8342,6 +8580,7 @@ var FloatingComments_default = /* @__PURE__ */ __plugin_vue_export_helper_defaul
 		const commentsRenderKey = ref(0);
 		const sidebarOffsetY = ref(0);
 		const disableInstantLayoutTransitions = ref(false);
+		const viewportRevision = ref(0);
 		const isPendingThread = (commentOrId) => {
 			const pendingId = pendingComment.value?.commentId;
 			if (!pendingId) return false;
@@ -8351,10 +8590,27 @@ var FloatingComments_default = /* @__PURE__ */ __plugin_vue_export_helper_defaul
 		const getThreadId = (comment) => {
 			return comment?.commentId ?? comment?.importedId ?? null;
 		};
+		const floatingInstanceIndex = computed(() => {
+			const byId = /* @__PURE__ */ new Map();
+			const byThreadId = /* @__PURE__ */ new Map();
+			for (const instance of floatingCommentInstances.value) {
+				if (instance?.id != null) byId.set(String(instance.id), instance);
+				const threadId = getThreadId(instance?.comment);
+				if (threadId == null) continue;
+				const key = String(threadId);
+				const threadInstances = byThreadId.get(key) ?? [];
+				threadInstances.push(instance);
+				byThreadId.set(key, threadInstances);
+			}
+			return {
+				byId,
+				byThreadId
+			};
+		});
 		const resolveFloatingInstanceId = (threadId, preferredInstanceId = null) => {
 			if (threadId == null) return null;
 			const normalizedThreadId = String(threadId);
-			const matchingInstances = floatingCommentInstances.value.filter((instance) => String(getThreadId(instance.comment)) === normalizedThreadId);
+			const matchingInstances = floatingInstanceIndex.value.byThreadId.get(normalizedThreadId) ?? [];
 			if (!matchingInstances.length) return null;
 			if (preferredInstanceId != null) {
 				const preferredInstance = matchingInstances.find((instance) => String(instance.id) === String(preferredInstanceId));
@@ -8377,6 +8633,14 @@ var FloatingComments_default = /* @__PURE__ */ __plugin_vue_export_helper_defaul
 		const placeholderRefs = ref({});
 		let observer = null;
 		const observedElements = /* @__PURE__ */ new Set();
+		let viewportFrame = null;
+		const refreshViewportWindow = () => {
+			if (viewportFrame != null) return;
+			viewportFrame = requestAnimationFrame(() => {
+				viewportFrame = null;
+				viewportRevision.value += 1;
+			});
+		};
 		const getAnchorTop = (instance) => {
 			if (props.currentDocument.type === "application/pdf") {
 				const zoom = (activeZoom.value ?? 100) / 100;
@@ -8394,6 +8658,24 @@ var FloatingComments_default = /* @__PURE__ */ __plugin_vue_export_helper_defaul
 			const bottom = instance?.positionEntry?.bounds?.bottom;
 			return Number.isFinite(bottom) ? bottom : anchorTop;
 		};
+		const geometryBearingInstances = computed(() => {
+			const positioned = [];
+			for (const instance of floatingCommentInstances.value) {
+				const id = instance?.id;
+				const threadId = getThreadId(instance?.comment);
+				const anchorTop = getAnchorTop(instance);
+				if (id == null || threadId == null || !Number.isFinite(anchorTop)) continue;
+				const top = normalizeFloatingAnchorTop(anchorTop, instance.comment);
+				positioned.push({
+					id,
+					threadId,
+					instance,
+					top,
+					anchorBottom: getAnchorBottom(instance, top)
+				});
+			}
+			return positioned;
+		});
 		const getPendingAnchorTop = () => {
 			const positionEntry = editorCommentPositions.value["pending"];
 			if (typeof positionEntry?.bounds?.top === "number" && !isNaN(positionEntry.bounds.top)) return positionEntry.bounds.top;
@@ -8427,27 +8709,72 @@ var FloatingComments_default = /* @__PURE__ */ __plugin_vue_export_helper_defaul
 			return resolveFloatingInstanceId(instantSidebarAlignmentThreadId.value, instantSidebarAlignmentInstanceId.value);
 		});
 		const allPositions = computed(() => {
-			const instances = floatingCommentInstances.value;
+			viewportRevision.value;
+			const positionedInstances = geometryBearingInstances.value;
 			const hasPending = pendingComment.value && pendingComment.value.fileId === props.currentDocument.id;
-			if (!instances.length && !hasPending) return [];
+			if (!positionedInstances.length && !floatingCommentInstances.value.length && !hasPending) return [];
 			const positions = [];
-			for (const instance of instances) {
-				const key = instance?.id;
-				const anchorTop = getAnchorTop(instance);
-				const threadId = getThreadId(instance?.comment);
-				if (!key || !threadId || typeof anchorTop !== "number" || isNaN(anchorTop)) continue;
-				const top = normalizeFloatingAnchorTop(anchorTop, instance.comment);
+			const viewportRange = getFloatingViewportRange() ?? {
+				top: 0,
+				bottom: Math.max(0, props.parent?.clientHeight || window.innerHeight || 0)
+			};
+			const renderTop = viewportRange.top - OBSERVER_MARGIN;
+			const renderBottom = viewportRange.bottom + OBSERVER_MARGIN;
+			const activeKey = hasPending ? "pending" : activeCommentInstanceId.value;
+			const positionIds = /* @__PURE__ */ new Set();
+			const pushPosition = ({ id, threadId, instance, top, anchorBottom, hasAnchorGeometry }) => {
+				const key = String(id);
+				if (positionIds.has(key)) return;
+				positionIds.add(key);
 				positions.push({
-					id: key,
+					id,
 					threadId,
 					pageIndex: instance?.pageIndex ?? null,
 					anchorTop: top,
-					anchorBottom: getAnchorBottom(instance, top),
+					anchorBottom,
+					hasAnchorGeometry,
 					top,
-					height: measuredHeights.value[key] || ESTIMATED_HEIGHT,
+					height: measuredHeights.value[id] || ESTIMATED_HEIGHT,
 					commentRef: instance.comment,
 					instanceRef: instance
 				});
+			};
+			for (const positioned of positionedInstances) {
+				const { id, threadId, instance, top, anchorBottom } = positioned;
+				const isActive = activeKey != null && String(id) === String(activeKey);
+				const isEditing = editingCommentId.value != null && String(threadId) === String(editingCommentId.value);
+				if (!isActive && !isEditing && (anchorBottom < renderTop || top > renderBottom)) continue;
+				pushPosition({
+					id,
+					threadId,
+					instance,
+					top,
+					anchorBottom,
+					hasAnchorGeometry: true
+				});
+			}
+			const transitionalInstances = [];
+			if (activeKey && activeKey !== "pending") {
+				const activeInstance = floatingInstanceIndex.value.byId.get(String(activeKey));
+				if (activeInstance) transitionalInstances.push(activeInstance);
+			}
+			if (editingCommentId.value != null) {
+				const editingInstances = floatingInstanceIndex.value.byThreadId.get(String(editingCommentId.value)) ?? [];
+				const editingInstance = editingInstances.find((instance) => instance.isPrimary) ?? editingInstances[0];
+				if (editingInstance) transitionalInstances.push(editingInstance);
+			}
+			for (const instance of transitionalInstances) {
+				const id = instance.id;
+				const threadId = getThreadId(instance.comment);
+				if (id == null || threadId == null || positionIds.has(String(id))) continue;
+				pushPosition({
+					id,
+					threadId,
+					instance,
+					top: viewportRange.top,
+					anchorBottom: viewportRange.top,
+					hasAnchorGeometry: false
+				});
 			}
 			if (hasPending) {
 				const pendingTop = getPendingAnchorTop();
@@ -8455,17 +8782,17 @@ var FloatingComments_default = /* @__PURE__ */ __plugin_vue_export_helper_defaul
 					id: "pending",
 					anchorTop: pendingTop,
 					anchorBottom: pendingTop,
+					hasAnchorGeometry: true,
 					top: pendingTop,
 					height: measuredHeights.value["pending"] || ESTIMATED_HEIGHT,
 					commentRef: pendingComment.value
 				});
 			}
 			positions.sort((a, b) => a.anchorTop - b.anchorTop);
-			const activeKey = hasPending ? "pending" : activeCommentInstanceId.value;
 			resolveCollisions(positions, activeKey ? positions.findIndex((p) => p.id === activeKey) : -1, 15);
-			const viewportRange = getFloatingViewportRange();
-			if (viewportRange) for (const position of positions) {
-				const persistentReviewTop = resolvePersistentReviewCardTop({
+			for (const position of positions) {
+				if (!position.hasAnchorGeometry) continue;
+				const offscreenTop = resolvePersistentReviewCardTop({
 					comment: position.commentRef,
 					anchorTop: position.anchorTop,
 					anchorBottom: position.anchorBottom,
@@ -8473,21 +8800,13 @@ var FloatingComments_default = /* @__PURE__ */ __plugin_vue_export_helper_defaul
 					viewportTop: viewportRange.top,
 					viewportBottom: viewportRange.bottom
 				});
-				if (persistentReviewTop != null) position.top = persistentReviewTop;
+				if (offscreenTop != null) position.top = offscreenTop;
 			}
 			return positions;
 		});
-		const totalHeight = computed(() => {
-			if (!allPositions.value.length) return 0;
-			let max = 0;
-			for (const p of allPositions.value) {
-				const bottom = p.top + p.height;
-				if (bottom > max) max = bottom;
-			}
-			return max + 50;
-		});
 		const wrapperMinHeight = computed(() => {
-			return totalHeight.value + Math.max(0, sidebarOffsetY.value);
+			viewportRevision.value;
+			return Math.max(0, props.parent?.clientHeight || 0, props.parent?.scrollHeight || 0);
 		});
 		const setupObserver = () => {
 			if (observer) observer.disconnect();
@@ -8594,6 +8913,7 @@ var FloatingComments_default = /* @__PURE__ */ __plugin_vue_export_helper_defaul
 		let continuityAlignmentScheduled = false;
 		let continuityAlignmentGeneration = 0;
 		let continuityTransitionFrame = null;
+		let activeLayoutContinuityFrame = null;
 		const clearDeferredRemeasureTimers = () => {
 			remeasureTimers.forEach(clearTimeout);
 			remeasureTimers = [];
@@ -8765,14 +9085,27 @@ var FloatingComments_default = /* @__PURE__ */ __plugin_vue_export_helper_defaul
 		});
 		let prevPositionIds = /* @__PURE__ */ new Set();
 		let prevActiveAnchorTop = null;
+		let prevActiveLayoutTop = null;
 		watch(allPositions, (positions) => {
 			const activePosition = activeCommentInstanceId.value ? positions.find((position) => position.id === activeCommentInstanceId.value) : null;
 			const activeAnchorTop = typeof activePosition?.anchorTop === "number" && Number.isFinite(activePosition.anchorTop) ? activePosition.anchorTop : null;
-			if (activeAnchorTop != null && prevActiveAnchorTop != null && Math.abs(activeAnchorTop - prevActiveAnchorTop) > 1 && sidebarOffsetY.value !== 0 && !Number.isFinite(instantSidebarAlignmentTargetY.value)) {
+			const activeAnchorMoved = activeAnchorTop != null && prevActiveAnchorTop != null && Math.abs(activeAnchorTop - prevActiveAnchorTop) > 1;
+			const activeLayoutTop = typeof activePosition?.top === "number" && Number.isFinite(activePosition.top) ? activePosition.top : null;
+			const activeLayoutMoved = activeLayoutTop != null && prevActiveLayoutTop != null && Math.abs(activeLayoutTop - prevActiveLayoutTop) > 1;
+			if (activeAnchorMoved && sidebarOffsetY.value !== 0 && !Number.isFinite(instantSidebarAlignmentTargetY.value)) {
 				sidebarOffsetY.value = 0;
 				setInstantLayoutTransitionsDisabled(false);
+			} else if (activeLayoutMoved && sidebarOffsetY.value !== 0 && !Number.isFinite(instantSidebarAlignmentTargetY.value) && !sidebarContinuityAnchor) {
+				setInstantLayoutTransitionsDisabled(true);
+				sidebarOffsetY.value += prevActiveLayoutTop - activeLayoutTop;
+				if (activeLayoutContinuityFrame != null) cancelAnimationFrame(activeLayoutContinuityFrame);
+				activeLayoutContinuityFrame = requestAnimationFrame(() => {
+					activeLayoutContinuityFrame = null;
+					if (!sidebarContinuityAnchor && !Number.isFinite(instantSidebarAlignmentTargetY.value)) setInstantLayoutTransitionsDisabled(false);
+				});
 			}
 			prevActiveAnchorTop = activeAnchorTop;
+			prevActiveLayoutTop = activeLayoutTop;
 			const positionOrder = positions.map((position) => position.id);
 			const currentIds = new Set(positionOrder);
 			if (sidebarContinuityAnchor && !currentIds.has(sidebarContinuityAnchor.key)) {
@@ -8831,12 +9164,24 @@ var FloatingComments_default = /* @__PURE__ */ __plugin_vue_export_helper_defaul
 		});
 		onMounted(() => {
 			setupObserver();
+			props.parent?.addEventListener?.("scroll", refreshViewportWindow, { passive: true });
+			window.addEventListener("resize", refreshViewportWindow, { passive: true });
 			nextTick(observePlaceholders);
 		});
 		onBeforeUnmount(() => {
 			clearDeferredRemeasureTimers();
 			if (scrollTimer) clearTimeout(scrollTimer);
 			clearSidebarContinuityAnchor();
+			if (activeLayoutContinuityFrame != null) {
+				cancelAnimationFrame(activeLayoutContinuityFrame);
+				activeLayoutContinuityFrame = null;
+			}
+			props.parent?.removeEventListener?.("scroll", refreshViewportWindow);
+			window.removeEventListener("resize", refreshViewportWindow);
+			if (viewportFrame != null) {
+				cancelAnimationFrame(viewportFrame);
+				viewportFrame = null;
+			}
 			if (observer) {
 				observer.disconnect();
 				observer = null;
@@ -8897,7 +9242,7 @@ var FloatingComments_default = /* @__PURE__ */ __plugin_vue_export_helper_defaul
 			}), 128))], 4)], 4);
 		};
 	}
-}, [["__scopeId", "data-v-7bf85652"]]);
+}, [["__scopeId", "data-v-e699ceb8"]]);
 var _hoisted_1$22 = {
 	class: "superdoc__pdf-comments-layer pdf-comments-layer",
 	"aria-hidden": "false"
@@ -9421,6 +9766,17 @@ const DRAWING_DIAGNOSTIC_CODES = {
 };
 DRAWING_DIAGNOSTIC_CODES.missingRelationship, DRAWING_DIAGNOSTIC_CODES.unsupportedRelationshipType, DRAWING_DIAGNOSTIC_CODES.unsupportedRelationshipType, DRAWING_DIAGNOSTIC_CODES.imageTooLarge, DRAWING_DIAGNOSTIC_CODES.missingMediaPart, DRAWING_DIAGNOSTIC_CODES.unsupportedObject, DRAWING_DIAGNOSTIC_CODES.vmlUnsupported;
 DRAWING_DIAGNOSTIC_CODES.externalImageDeferred, DRAWING_DIAGNOSTIC_CODES.missingRelationship, DRAWING_DIAGNOSTIC_CODES.missingMediaPart, DRAWING_DIAGNOSTIC_CODES.unsupportedRelationshipType, DRAWING_DIAGNOSTIC_CODES.unsupportedMime, DRAWING_DIAGNOSTIC_CODES.imageTooLarge, DRAWING_DIAGNOSTIC_CODES.unsafeSvg, DRAWING_DIAGNOSTIC_CODES.unsupportedFormat, DRAWING_DIAGNOSTIC_CODES.embeddedObjectNotSupported, DRAWING_DIAGNOSTIC_CODES.unsupportedObject, DRAWING_DIAGNOSTIC_CODES.vmlUnsupported, DRAWING_DIAGNOSTIC_CODES.vmlImageUnsupported, DRAWING_DIAGNOSTIC_CODES.unsupportedGeometryCommand, DRAWING_DIAGNOSTIC_CODES.anchorUnsupported, DRAWING_DIAGNOSTIC_CODES.wrapUnsupported, DRAWING_DIAGNOSTIC_CODES.altContentNoSupportedChoice, DRAWING_DIAGNOSTIC_CODES.groupChildUnsupported;
+Object.freeze([
+	"multiple-sections",
+	"furniture-page-tokens",
+	"non-balanceable-multi-column-sections",
+	"body-anchored-objects",
+	"footnotes",
+	"page-references",
+	"keep-constraints",
+	"tables",
+	"furniture-anchored-objects"
+]);
 var _hoisted_1$20 = { class: "superdoc-html-viewer" };
 var _hoisted_2$17 = { class: "superdoc-html-viewer__document" };
 var _hoisted_3$14 = ["innerHTML"];
@@ -11257,8 +11613,11 @@ function scrollToElement(targetElement, options = {
 	const container = getScrollableParent(targetElement);
 	const containerRect = container.getBoundingClientRect();
 	const offsetTop = targetElement.getBoundingClientRect().top - containerRect.top + container.scrollTop;
+	const scrollPaddingTopValue = window.getComputedStyle(container).scrollPaddingTop?.trim();
+	const resolvedScrollPaddingTop = scrollPaddingTopValue?.endsWith("px") ? Number(scrollPaddingTopValue.slice(0, -2)) : 0;
+	const scrollPaddingTop = Number.isFinite(resolvedScrollPaddingTop) && resolvedScrollPaddingTop >= 0 ? resolvedScrollPaddingTop : 0;
 	container.scrollTo({
-		top: options.block === "start" ? offsetTop : offsetTop - container.clientHeight + targetElement.offsetHeight,
+		top: options.block === "start" ? offsetTop - scrollPaddingTop : offsetTop - container.clientHeight + targetElement.offsetHeight,
 		behavior: options.behavior
 	});
 }
@@ -11504,7 +11863,34 @@ function useLinkPopover({ getSurfaceManager, getActiveEditor, getUi, getResolver
 			tick();
 		});
 	}
-	async function navigateToAnchor(anchorUrl) {
+	async function placeCaretAtHeadingStart(blockId) {
+		const setSelectionTarget = getActiveEditor()?.authoring?.setSelectionTarget;
+		if (typeof setSelectionTarget !== "function") return;
+		const story = {
+			kind: "story",
+			storyType: "body"
+		};
+		const anchor = {
+			kind: "text",
+			blockId,
+			offset: 0,
+			story
+		};
+		const target = {
+			kind: "selection",
+			start: anchor,
+			end: anchor,
+			story
+		};
+		try {
+			await Promise.resolve(setSelectionTarget({
+				target,
+				collapse: "start",
+				focus: true
+			}));
+		} catch {}
+	}
+	async function navigateToAnchor(anchorUrl, { placeCaret = false } = {}) {
 		if (typeof anchorUrl !== "string" || !anchorUrl.startsWith("#")) return;
 		const anchorName = anchorUrl.slice(1);
 		const escapedAnchorName = cssEscape(anchorName);
@@ -11529,6 +11915,7 @@ function useLinkPopover({ getSurfaceManager, getActiveEditor, getUi, getResolver
 		if (story && story.storyType !== "body") return;
 		const blockId = bookmark?.range?.from?.blockId;
 		if (typeof blockId !== "string") return;
+		if (placeCaret) await placeCaretAtHeadingStart(blockId);
 		const mountedParagraph = findPaintedParagraphByParaId(getUi()?.viewport?.getHost?.() ?? null, blockId);
 		if (mountedParagraph) {
 			scrollToElement(mountedParagraph);
@@ -11638,7 +12025,7 @@ function useLinkPopover({ getSurfaceManager, getActiveEditor, getUi, getResolver
 	function openDefaultPopover(ctx) {
 		closeCurrentPopover("replace");
 		if (ctx.isAnchorLink && isTocEntryLinkElement(ctx.element)) {
-			navigateToAnchor(ctx.href);
+			navigateToAnchor(ctx.href, { placeCaret: ctx.documentMode !== "viewing" });
 			return;
 		}
 		if (ctx.documentMode === "viewing") {
@@ -11654,7 +12041,7 @@ function useLinkPopover({ getSurfaceManager, getActiveEditor, getUi, getResolver
 		const closePopover = () => closeCurrentPopover("closed");
 		const goToAnchor = (anchorUrl) => {
 			closePopover();
-			navigateToAnchor(anchorUrl);
+			navigateToAnchor(anchorUrl, { placeCaret: true });
 		};
 		const generation = openGeneration;
 		const openWithHyperlinkTarget = (hyperlinkTarget) => {
@@ -13413,7 +13800,7 @@ var SuperDoc_default = /* @__PURE__ */ __plugin_vue_export_helper_default({
 	__name: "SuperDoc",
 	emits: ["selection-update"],
 	setup(__props, { emit: __emit }) {
-		const PdfViewer = defineAsyncComponent(() => import("./chunks/PdfViewer-XZg0nr8y.es.js"));
+		const PdfViewer = defineAsyncComponent(() => import("./chunks/PdfViewer-CNOtyS-I.es.js"));
 		const getDocumentLoadPassword = (doc) => doc.password ?? proxy.$superdoc.config.password;
 		const resolveDocumentV2Collaboration = (doc) => {
 			const rawConfig = doc?.v2Collaboration;
@@ -13458,7 +13845,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 { getConfig, documentsWithConverations, commentsList, pendingComment, activeComment, skipSelectionUpdate, commentsByDocument, isCommentsListVisible, isFloatingCommentsReady, generalCommentIds, hasSyncedCollaborationComments, editorCommentPositions, hasInitializedLocations, isCommentHighlighted, hasOpenTrackedChanges } = storeToRefs(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;
@@ -13638,18 +14025,19 @@ var SuperDoc_default = /* @__PURE__ */ __plugin_vue_export_helper_default({
 			if (!documentId) return;
 			clearV2CommandShortcutBinding(documentId);
 			if (typeof bindEditShortcuts !== "function") return;
-			const ui = createSuperDocUI({ superdoc: proxy.$superdoc });
+			const fallbackUi = createSuperDocUI({ superdoc: proxy.$superdoc });
+			const resolveUi = () => proxy.$superdoc?.toolbar?.ui ?? fallbackUi;
 			const openLinkWorkflow = resolveV2LinkWorkflowOpener();
 			const unbind = bindEditShortcuts({
 				commandRoute: {
-					executeAsync: (commandId, payload) => ui.commands.executeAsync(commandId, payload),
-					getState: (commandId) => ui.commands.get(commandId).getState()
+					executeAsync: (commandId, payload) => resolveUi().commands.executeAsync(commandId, payload),
+					getState: (commandId) => resolveUi().commands.get(commandId).getState()
 				},
 				...openLinkWorkflow ? { openLinkWorkflow } : {}
 			});
 			v2CommandShortcutBindings.set(documentId, {
 				unbind,
-				ui
+				ui: fallbackUi
 			});
 		};
 		const clearV2SessionShortcutBinding = (documentId) => {
@@ -14473,13 +14861,17 @@ var SuperDoc_default = /* @__PURE__ */ __plugin_vue_export_helper_default({
 			v2RulerReady.value = false;
 		};
 		let v2TypingReviewHydrationTimer = 0;
-		const hydrateV2ReviewRowsFromHost = (options = {}) => {
+		const hydrateV2CommentRowsFromHost = () => {
 			const commentsAdapter = proxy.$superdoc?.activeEditor?.v2Comments ?? null;
-			if (commentsAdapter) commentsStore.hydrateCommentsFromV2?.({
+			if (!commentsAdapter) return;
+			commentsStore.hydrateCommentsFromV2?.({
 				superdoc: proxy.$superdoc,
 				adapter: commentsAdapter,
 				documentId: proxy.$superdoc?.activeEditor?.documentId ?? null
 			});
+		};
+		const hydrateV2ReviewRowsFromHost = (options = {}) => {
+			hydrateV2CommentRowsFromHost();
 			const trackedChangesAdapter = proxy.$superdoc?.activeEditor?.v2TrackedChanges ?? null;
 			if (!trackedChangesAdapter) return;
 			commentsStore.hydrateTrackedChangesFromV2?.({
@@ -14582,6 +14974,10 @@ var SuperDoc_default = /* @__PURE__ */ __plugin_vue_export_helper_default({
 			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);
+			if (reviewImpact?.reconcileMode === "authoritative" && reviewImpact.upsertIds.size > 0) {
+				hydrateV2CommentRowsFromHost();
+				return;
+			}
 			if (isV2EditableTextMutationEvent(event)) {
 				scheduleV2TypingReviewHydration();
 				return;
@@ -15043,7 +15439,7 @@ var SuperDoc_default = /* @__PURE__ */ __plugin_vue_export_helper_default({
 			if (isV2Mode.value && !v2GeometryAvailable.value && !hasPdfFloatingComments.value) return false;
 			if (!shouldRenderCommentsInViewing.value) return false;
 			if (!shouldUseSidebarComments.value) return false;
-			return pendingComment.value || floatingComments.value.length > 0 && isReady.value && layers.value && isCommentsEnabled.value && !isCommentsListVisible.value;
+			return pendingComment.value || (floatingComments.value.length > 0 || hasOpenTrackedChanges.value) && isReady.value && layers.value && isCommentsEnabled.value && !isCommentsListVisible.value;
 		});
 		const activeCompactComment = computed(() => {
 			if (showCommentsSidebar.value) return null;
@@ -15711,7 +16107,7 @@ var SuperDoc_default = /* @__PURE__ */ __plugin_vue_export_helper_default({
 			], 38);
 		};
 	}
-}, [["__scopeId", "data-v-c4ab995e"]]);
+}, [["__scopeId", "data-v-4084bf1b"]]);
 var PINIA_DEVTOOLS_SETUP_EVENT = "devtools-plugin:setup";
 var PINIA_DEVTOOLS_PLUGIN_ID = "dev.esm.pinia";
 var piniaDevtoolsSuppressionState = {
@@ -34257,7 +34653,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.27";
+		this.version = "2.0.0-next.29";
 		this.#log("🦋 [superdoc] Using SuperDoc version:", this.version);
 		this.superdocId = config.superdocId || v4_default();
 		this.colors = this.config.colors ?? [];