superdoc 2.29.0-next.9 → 2.30.0-next.4

package/dist/superdoc.es.js

@@ -1,20 +1,20 @@
 import { i as __toESM$2 } from "./chunks/rolldown-runtime-0pSA04fp.es.js";
+import { $ as vModelSelect, A as onActivated, B as renderList, C as isRef$1, D as normalizeClass, E as nextTick, F as openBlock, G as toDisplayString, H as resolveDirective, I as provide$1, J as toRefs, K as toRaw$2, L as reactive, M as onDeactivated, N as onMounted, O as normalizeProps, P as onScopeDispose$1, Q as vModelCheckbox, R as readonly, S as isReactive$1, T as mergeProps, U as resolveDynamicComponent, V as renderSlot, W as shallowRef$1, X as useAttrs, Y as unref, Z as useSlots, _ as getCurrentInstance, a as computed$1, at as withModifiers, b as hasInjectionContext, c as createCommentVNode, ct as isThenable$1, d as createStaticVNode, et as vModelText, f as createTextVNode, g as effectScope, h as defineComponent, i as Transition, it as withKeys, j as onBeforeUnmount, k as normalizeStyle, l as createElementBlock, m as defineAsyncComponent, n as Fragment, nt as withCtx, o as createApp, p as createVNode, q as toRef, r as Teleport, rt as withDirectives, s as createBlock, st as isPlainObject$1, t as _plugin_vue_export_helper_default, tt as watch$1, u as createElementVNode, v as getCurrentScope, w as markRaw, x as inject$1, y as h, z as ref } from "./chunks/_plugin-vue_export-helper-CmkaJDnr.es.js";
 import { t as blank_default } from "./chunks/blank-docx-DzQccOlW.es.js";
-import { C as createInteractionHistory, E as recordInteraction, S as closeInteractionHistory, T as isWorkflowRecordingEnabled, _ as createTrackedChangePermissionResolver, a as registerFirstPartyCommandMutation, b as isPlainObject$1, c as getCommandDescriptor, d as mutationCommittedEventChangedDocument, f as createImageFilePicker, g as PERMISSIONS, h as BUILT_IN_PERMISSION_METHOD, i as readFirstPartyPageNumbers, l as applyV2CommentInvalidationFromMutation, n as executeFirstPartyCommandAsync, o as isRecord, p as resolveImageSrc, r as executeFirstPartyShortcutAsync, t as createSuperDocUI, u as getV2TrackedChangeMutationImpact, v as isAllowed, w as getWorkflowRecording, x as DOM_CLASS_NAMES, y as isSyntheticTrackedChangeCommentLaneItem } from "./chunks/create-super-doc-ui-Bm5kmx0W.es.js";
+import { C as createInteractionHistory, E as recordInteraction, S as closeInteractionHistory, T as isWorkflowRecordingEnabled, _ as isAllowed, a as registerFirstPartyCommandMutation, b as isRecord, c as applyV2CommentInvalidationFromMutation, d as createImageFilePicker, f as resolveImageSrc, g as createTrackedChangePermissionResolver, h as PERMISSIONS, i as readFirstPartyPageNumbers, l as getV2TrackedChangeMutationImpact, m as BUILT_IN_PERMISSION_METHOD, n as executeFirstPartyCommandAsync, r as executeFirstPartyShortcutAsync, s as getCommandDescriptor, t as createSuperDocUI, u as mutationCommittedEventChangedDocument, v as isSyntheticTrackedChangeCommentLaneItem, w as getWorkflowRecording, x as DOM_CLASS_NAMES, y as isStoryLocator } from "./chunks/create-super-doc-ui-CbEDXtpm.es.js";
 import { t as import_eventemitter3 } from "./chunks/eventemitter3-DEIiXiH2.es.js";
 import { t as v4 } from "./chunks/uuid-H0Xcmmhy.es.js";
-import { $ as vModelSelect, A as onActivated, B as renderList, C as isRef$1, D as normalizeClass, E as nextTick, F as openBlock, G as toDisplayString, H as resolveDirective, I as provide$1, J as toRefs, K as toRaw$2, L as reactive, M as onDeactivated, N as onMounted, O as normalizeProps, P as onScopeDispose$1, Q as vModelCheckbox, R as readonly, S as isReactive$1, T as mergeProps, U as resolveDynamicComponent, V as renderSlot, W as shallowRef$1, X as useAttrs, Y as unref, Z as useSlots, _ as getCurrentInstance, a as computed$1, at as withModifiers, b as hasInjectionContext, c as createCommentVNode, d as createStaticVNode, et as vModelText, f as createTextVNode, g as effectScope, h as defineComponent, i as Transition, it as withKeys, j as onBeforeUnmount, k as normalizeStyle, l as createElementBlock, m as defineAsyncComponent, n as Fragment, nt as withCtx, o as createApp, p as createVNode, q as toRef, r as Teleport, rt as withDirectives, s as createBlock, t as _plugin_vue_export_helper_default, tt as watch$1, u as createElementVNode, v as getCurrentScope, w as markRaw, x as inject$1, y as h, z as ref } from "./chunks/_plugin-vue_export-helper-CsJQtMvr.es.js";
 import { a as init_dist$1, i as global, n as init_dist$2, o as Buffer, r as process$1, s as init_dist, t as require_jszip_min } from "./chunks/jszip-BzJ3CyxR.es.js";
 import { t as isFiniteNumber } from "./chunks/is-finite-number-BpL4F38c.es.js";
 import { t as PDF_TO_CSS_UNITS } from "./chunks/constants-BvNs_ybI.es.js";
 import * as Vue from "vue";
 import { Map as Map$1 } from "yjs";
 import Konva from "konva";
-//#region src/core/v2-integration/browser-peer-runtime.js
+//#region src/core/v2-integration/browser-peer-runtime.ts
 var SUPERDOC_V2_BROWSER_RUNTIME_GLOBAL_KEY = "__SUPERDOC_V2_BROWSER_RUNTIME__";
 function readInstalledRuntime(globalObject = globalThis) {
-	const installed = globalObject[SUPERDOC_V2_BROWSER_RUNTIME_GLOBAL_KEY];
-	return installed && typeof installed === "object" ? installed : null;
+	const installed = Reflect.get(globalObject, SUPERDOC_V2_BROWSER_RUNTIME_GLOBAL_KEY);
+	return isPlainObject$1(installed) ? installed : null;
 }
 function installSuperDocV2BrowserRuntime(runtime = {}, globalObject = globalThis) {
 	const installed = readInstalledRuntime(globalObject) ?? {};
@@ -23,7 +23,7 @@ function installSuperDocV2BrowserRuntime(runtime = {}, globalObject = globalThis
 		...runtime,
 		vue: runtime.vue ?? installed.vue ?? Vue
 	};
-	globalObject[SUPERDOC_V2_BROWSER_RUNTIME_GLOBAL_KEY] = nextRuntime;
+	Reflect.set(globalObject, SUPERDOC_V2_BROWSER_RUNTIME_GLOBAL_KEY, nextRuntime);
 	return nextRuntime;
 }
 installSuperDocV2BrowserRuntime();
@@ -258,7 +258,7 @@ var v_click_outside_default = {
 var DEFAULT_ENDPOINT = "https://ingest.superdoc.dev/v1/collect";
 function getSuperdocVersion() {
 	try {
-		return "2.29.0-next.9";
+		return "2.30.0-next.4";
 	} catch {
 		return "unknown";
 	}
@@ -5838,6 +5838,11 @@ function useCheckboxField(field) {
 	}) : itemoptions) };
 }
 //#endregion
+//#region src/core/collaboration/collaboration-comment-map.ts
+function createCollaborationCommentMap(entries) {
+	return new Map$1(entries);
+}
+//#endregion
 //#region src/core/collaboration/collaboration-comments.ts
 var readComment = (event) => {
 	const { comment } = event;
@@ -5846,14 +5851,14 @@ var readComment = (event) => {
 };
 var addYComment = (yArray, ydoc, event, user) => {
 	const comment = readComment(event);
-	const yComment = new Map$1(Object.entries(comment));
+	const yComment = createCollaborationCommentMap(Object.entries(comment));
 	ydoc.transact(() => {
 		yArray.push([yComment]);
 	}, { user });
 };
 var updateYComment = (yArray, ydoc, event, user) => {
 	const comment = readComment(event);
-	const yComment = new Map$1(Object.entries(comment));
+	const yComment = createCollaborationCommentMap(Object.entries(comment));
 	const commentIndex = getCommentIndex(yArray, comment);
 	if (commentIndex === -1) return;
 	ydoc.transact(() => {
@@ -5874,7 +5879,7 @@ var getCommentIndex = (yArray, comment) => {
 //#endregion
 //#region src/core/collaboration/helpers.ts
 var isPropertyBag = (value) => typeof value === "object" && value !== null || typeof value === "function";
-var readCommentsStore = (superdoc) => superdoc["commentsStore"];
+var readCommentsStore$1 = (superdoc) => superdoc["commentsStore"];
 var isV2ReviewRuntimeActive = (superdoc) => superdoc.activeEditor?.editorVersion === 2 || superdoc.editorVersion === 2;
 var commentKey = (comment) => {
 	const key = comment.commentId ?? comment.importedId;
@@ -5893,7 +5898,7 @@ var preserveLocalV2TrackedChangeRows = (superdoc, commentsStore, incomingComment
 };
 var loadCommentsFromYdoc = (superdoc) => {
 	if (!superdoc?.ydoc) return false;
-	const commentsStore = readCommentsStore(superdoc);
+	const commentsStore = readCommentsStore$1(superdoc);
 	if (!commentsStore) return false;
 	const comments = superdoc.ydoc.getArray("comments").toJSON();
 	const seenCommentIdByKey = /* @__PURE__ */ new Map();
@@ -5939,7 +5944,7 @@ var initCollaborationComments = (superdoc) => {
 	const updateCommentsStore = () => loadCommentsFromYdoc(superdoc);
 	const onSuperDocYdocSynced = () => {
 		if (!updateCommentsStore()) setTimeout(updateCommentsStore, 0);
-		const commentsStore = readCommentsStore(superdoc);
+		const commentsStore = readCommentsStore$1(superdoc);
 		if (commentsStore) commentsStore.hasSyncedCollaborationComments = true;
 		const currentProvider = superdoc.provider;
 		if (!currentProvider) throw new TypeError("initCollaborationComments requires superdoc.provider");
@@ -5951,7 +5956,7 @@ var initCollaborationComments = (superdoc) => {
 	provider.on("synced", onSuperDocYdocSynced);
 	if (!updateCommentsStore()) setTimeout(updateCommentsStore, 0);
 	commentsArray.observe((event) => {
-		if (!readCommentsStore(superdoc)) return;
+		if (!readCommentsStore$1(superdoc)) return;
 		const currentUser = superdoc.config.user;
 		const origin = event?.transaction?.origin;
 		const originUser = isPropertyBag(origin) ? origin.user : null;
@@ -6750,6 +6755,124 @@ var useSuperdocStore = defineStore("superdoc", () => {
 	};
 });
 //#endregion
+//#region ../document-api/src/errors.ts
+/**
+* Structured validation error thrown by document-api execute* functions.
+*
+* Consumers should prefer checking `error.code` over `instanceof` for resilience
+* across package boundaries and bundling scenarios.
+*/
+var DocumentApiValidationError = class DocumentApiValidationError extends Error {
+	constructor(code, message, details) {
+		super(message);
+		this.name = "DocumentApiValidationError";
+		this.code = code;
+		this.details = details;
+		Object.setPrototypeOf(this, DocumentApiValidationError.prototype);
+	}
+};
+//#endregion
+//#region ../document-api/src/export/export.types.ts
+/** Canonical tracked-change export modes accepted by every public export surface. */
+var SD_EXPORT_MODES = [
+	"review-preserving",
+	"final",
+	"original"
+];
+/** Default mode for modeful DOCX export. */
+var DEFAULT_SD_EXPORT_MODE = "review-preserving";
+var SD_COMMENT_EXPORT_POLICIES = [
+	"preserve",
+	"resolve",
+	"remove"
+];
+var SD_CONTENT_CONTROL_EXPORT_POLICIES = ["preserve", "flatten"];
+//#endregion
+//#region ../document-api/src/export/export.ts
+/**
+* Export namespace: engine-agnostic public API and adapter contract.
+*
+* Validates the requested mode at the public boundary so an invalid mode fails
+* closed with `INVALID_INPUT` before any document work happens, then delegates
+* byte production and degradation reporting to the engine adapter.
+*/
+function resolveMode$1(input) {
+	if (input != null && !isRecord(input)) throw new DocumentApiValidationError("INVALID_INPUT", "export.toDocx input must be an object.");
+	const raw = input?.mode;
+	if (raw === void 0) return DEFAULT_SD_EXPORT_MODE;
+	if (typeof raw !== "string" || !SD_EXPORT_MODES.includes(raw)) throw new DocumentApiValidationError("INVALID_INPUT", `export.toDocx mode must be one of: ${SD_EXPORT_MODES.join(", ")}.`, {
+		mode: raw,
+		allowedModes: [...SD_EXPORT_MODES]
+	});
+	return raw;
+}
+function resolveDocxExportPolicies(input = {}) {
+	if (!isRecord(input)) throw new DocumentApiValidationError("INVALID_INPUT", "DOCX export input must be an object.");
+	const mode = resolveMode$1(input);
+	const policies = input.policies;
+	if (policies !== void 0 && !isRecord(policies)) throw new DocumentApiValidationError("INVALID_INPUT", "DOCX export policies must be an object.");
+	const allowed = {
+		trackedChanges: SD_EXPORT_MODES,
+		comments: SD_COMMENT_EXPORT_POLICIES,
+		contentControls: SD_CONTENT_CONTROL_EXPORT_POLICIES
+	};
+	for (const [key, value] of Object.entries(policies ?? {})) if (!Object.prototype.hasOwnProperty.call(allowed, key) || value !== void 0 && !allowed[key].includes(value)) throw new DocumentApiValidationError("INVALID_INPUT", `Unsupported DOCX export policy: ${key}.`, {
+		policy: key,
+		value
+	});
+	const requested = policies;
+	if (input.mode !== void 0 && requested?.trackedChanges !== void 0 && mode !== requested.trackedChanges) throw new DocumentApiValidationError("INVALID_INPUT", "mode conflicts with policies.trackedChanges.");
+	return {
+		trackedChanges: requested?.trackedChanges ?? mode,
+		comments: requested?.comments ?? "preserve",
+		contentControls: requested?.contentControls ?? "preserve"
+	};
+}
+//#endregion
+//#region ../document-api/src/permission-ranges/permission-ranges.ts
+function editorKey(editor) {
+	return editor.id?.trim() ? editor.id : editor.email?.trim() || void 0;
+}
+function editorMatches(editor, id) {
+	return Boolean(id.trim()) && (editor.id === id || Boolean(editor.email?.trim() && editor.email.trim().toLowerCase() === id.toLowerCase()));
+}
+/**
+* Resolve a host ID or imported Word email against an explicitly supplied roster.
+* Word receives the email when available; opaque IDs remain host-specific.
+* Duplicate IDs/emails are ambiguous. This does not authenticate a user.
+*/
+function resolvePermissionRangeEditor(editors, id) {
+	const matches = editors.filter((editor) => editorMatches(editor, id));
+	if (matches.length === 0) return {
+		status: "unknown",
+		id
+	};
+	if (matches.length !== 1) return {
+		status: "ambiguous",
+		id
+	};
+	const editor = matches[0];
+	const wordId = editor.email?.trim() || editor.id;
+	if (editors.filter((candidate) => editorMatches(candidate, wordId)).length !== 1) return {
+		status: "ambiguous",
+		id
+	};
+	return {
+		status: "resolved",
+		id,
+		editor: { ...editor },
+		principal: {
+			kind: "editor",
+			id: wordId
+		}
+	};
+}
+/** Enumerate the host roster for an editor picker, including ambiguous entries. */
+function listPermissionRangeEditors(editors) {
+	const ids = new Set(editors.map(editorKey).filter((id) => id !== void 0));
+	return Array.from(ids, (id) => resolvePermissionRangeEditor(editors, id));
+}
+//#endregion
 //#region src/stores/helpers/floating-comment-instances.ts
 var HEADER_FOOTER_TRACKED_CHANGE_STORY_TYPE = "headerFooterPart";
 var toFinitePageIndex = (value) => {
@@ -6890,23 +7013,76 @@ var buildFloatingCommentInstances = ({ comment, positionKey, positionEntry, fall
 	})];
 };
 //#endregion
-//#region src/components/CommentsLayer/tracked-change-threading.js
+//#region src/stores/helpers/comment-document-scope.ts
+var getCommentDocumentId = (comment) => {
+	if (!comment) return null;
+	if (comment.fileId != null) return String(comment.fileId);
+	if (comment.documentId != null) return String(comment.documentId);
+	if (comment.selection?.documentId != null) return String(comment.selection.documentId);
+	return null;
+};
+var createCommentDocumentScope = (readOpenDocuments) => {
+	const getOpenDocuments = () => {
+		const source = readOpenDocuments();
+		const docs = Array.isArray(source) ? source : source?.value;
+		return Array.isArray(docs) ? docs : [];
+	};
+	const getSingleOpenDocumentId = () => {
+		const docs = getOpenDocuments();
+		if (docs.length !== 1) return null;
+		return docs[0]?.id != null ? String(docs[0].id) : null;
+	};
+	const belongsToDocument = (comment, activeDocumentId, options = {}) => {
+		const { allowSingleDocumentMismatch = false } = options;
+		if (!activeDocumentId) return false;
+		const commentDocumentId = getCommentDocumentId(comment);
+		if (commentDocumentId) {
+			if (commentDocumentId === activeDocumentId) return true;
+			const singleOpenDocumentId = getSingleOpenDocumentId();
+			return allowSingleDocumentMismatch && singleOpenDocumentId === activeDocumentId;
+		}
+		return getSingleOpenDocumentId() === activeDocumentId;
+	};
+	const belongsToTrackedChangeSyncDocument = (comment, activeDocumentId) => belongsToDocument(comment, activeDocumentId, { allowSingleDocumentMismatch: true });
+	return {
+		belongsToDocument,
+		belongsToTrackedChangeSyncDocument
+	};
+};
+//#endregion
+//#region src/stores/helpers/pending-selection-snapshot.ts
+var isThenable = (value) => (typeof value === "object" || typeof value === "function") && value !== null && "then" in value && typeof value.then === "function";
+var getPendingSelectionSnapshot = (superdoc, activeSelection) => {
+	if (activeSelection?.source !== "document-editor") return null;
+	const selectionDocumentId = activeSelection?.documentId ?? null;
+	const editorDocumentId = superdoc?.activeEditor?.options?.documentId ?? null;
+	if (!selectionDocumentId || !editorDocumentId || selectionDocumentId !== editorDocumentId) return null;
+	let currentSelection;
+	try {
+		currentSelection = superdoc?.activeEditor?.doc?.selection?.current;
+	} catch {
+		return null;
+	}
+	if (typeof currentSelection !== "function") return null;
+	try {
+		const snapshot = currentSelection();
+		return isThenable(snapshot) ? Promise.resolve(snapshot).catch(() => null) : snapshot;
+	} catch {
+		return null;
+	}
+};
+//#endregion
+//#region src/components/CommentsLayer/tracked-change-threading.ts
 /**
 * Legacy comment payloads predate explicit tracked-change thread provenance.
 * These fields distinguish a true legacy review child from a v2 comment whose
 * anchor merely overlaps tracked content.
-*
-* @param {Record<string, any> | null | undefined} comment
-* @returns {boolean}
 */
 var hasLegacyTrackedChangeThreadSignal = (comment) => Boolean(comment?.trackedChangeLink) || Boolean(comment?.trackedChangeType) || Boolean(comment?.trackedChangeDisplayType) || Boolean(comment?.trackedChangeText) || Boolean(comment?.deletedText) || comment?.trackedChange === true;
 /**
 * Resolve explicit thread provenance first, then the guarded legacy fallback.
 * Spatial-only v2 comments carry neither the explicit field nor a legacy
 * review signal and therefore remain standalone.
-*
-* @param {Record<string, any> | null | undefined} comment
-* @returns {string | number | null}
 */
 var trackedChangeThreadParentIdForComment$1 = (comment) => {
 	if (comment?.trackedChangeThreadParentId != null) return comment.trackedChangeThreadParentId;
@@ -7058,6 +7234,7 @@ var groupCommittedComments = (comments, presentations, isVisible) => {
 	});
 	const grouped = groupComments(comments.filter((row) => !presentations[String(row.fileId)]), isVisible);
 	for (const [documentId, presentation] of Object.entries(presentations)) {
+		if (!presentation) continue;
 		grouped.parentComments.push(...visibleRowsInOrder(documentId, presentation.groupOrder.open));
 		grouped.resolvedComments.push(...visibleRowsInOrder(documentId, presentation.groupOrder.resolved));
 	}
@@ -7185,7 +7362,6 @@ function createDefaultV2Integration() {
 //#region src/helpers/interaction-trace.ts
 var isStartSpan = (value) => typeof value === "function";
 var isEndSpan = (value) => typeof value === "function";
-var isThenable$3 = (value) => (typeof value === "object" || typeof value === "function") && value !== null && "then" in value && typeof value.then === "function";
 function safeTraceCollector() {
 	try {
 		const collector = Reflect.get(globalThis, "__superdocInteractionTrace");
@@ -7216,7 +7392,7 @@ function withInteractionSpan(stage, branch, meta, fn) {
 	if (!span) return fn();
 	try {
 		const result = fn();
-		if (isThenable$3(result)) return result.then((value) => {
+		if (isThenable$1(result)) return result.then((value) => {
 			endInteractionSpan(span);
 			return value;
 		}, (error) => {
@@ -7231,6 +7407,81 @@ function withInteractionSpan(stage, branch, meta, fn) {
 	}
 }
 //#endregion
+//#region src/stores/helpers/tracked-change-decision.ts
+var normalizeTrackedChangeDecisionType = (value) => {
+	const lower = typeof value === "string" ? value.toLowerCase() : "";
+	if (!lower) return null;
+	if (lower === "insert" || lower === "insertion" || lower === "trackinsert" || lower === "tableinsert" || lower === "paragraphsplit") return "insertion";
+	if (lower === "delete" || lower === "deletion" || lower === "trackdelete" || lower === "tabledelete") return "deletion";
+	return lower;
+};
+var trackedChangeDecisionKeepsCommentAnchor = ({ comment, decision } = {}) => {
+	const normalizedDecision = decision === "accept" || decision === "reject" ? decision : null;
+	if (!normalizedDecision) return false;
+	const type = normalizeTrackedChangeDecisionType(comment?.trackedChangeDisplayType) ?? normalizeTrackedChangeDecisionType(comment?.trackedChangeType);
+	return normalizedDecision === "accept" && type === "insertion" || normalizedDecision === "reject" && type === "deletion";
+};
+var collectTrackedChangeDecisionIdsWithAliases = (comment, aliasIds) => {
+	const trackedChangeIds = new Set(aliasIds);
+	if (comment?.trackedChangeCanonicalId != null) trackedChangeIds.add(String(comment.trackedChangeCanonicalId));
+	const anchorKey = comment?.trackedChangeAnchorKey != null ? String(comment.trackedChangeAnchorKey) : null;
+	if (anchorKey) {
+		trackedChangeIds.add(anchorKey);
+		if (anchorKey.startsWith("tc::")) {
+			const rawId = anchorKey.slice(anchorKey.lastIndexOf("::") + 2);
+			if (rawId) trackedChangeIds.add(rawId);
+		}
+	}
+	return trackedChangeIds;
+};
+var collectTrackedChangeEntityIdsFromReceipt = (receipt) => {
+	const record = receipt && typeof receipt === "object" ? receipt : null;
+	if (!record?.success) return /* @__PURE__ */ new Set();
+	const ids = /* @__PURE__ */ new Set();
+	const collect = (entry) => {
+		const ref = entry && typeof entry === "object" ? entry : null;
+		if (ref?.kind !== "entity" || ref.entityType !== "trackedChange") return;
+		if (ref.entityId != null && String(ref.entityId).length > 0) ids.add(String(ref.entityId));
+	};
+	if (Array.isArray(record.removed)) record.removed.forEach(collect);
+	if (Array.isArray(record.invalidatedRefs)) record.invalidatedRefs.forEach(collect);
+	return ids;
+};
+var collectReliableDecidedTrackedChangeIds = (outcome) => {
+	const ids = /* @__PURE__ */ new Set();
+	if (outcome?.decidedId != null && String(outcome.decidedId).length > 0) ids.add(String(outcome.decidedId));
+	if (Array.isArray(outcome?.decidedIds)) outcome.decidedIds.forEach((id) => {
+		if (id != null && String(id).length > 0) ids.add(String(id));
+	});
+	collectTrackedChangeEntityIdsFromReceipt(outcome?.receipt).forEach((id) => ids.add(id));
+	return ids;
+};
+var clearV2ActiveTrackedChangeTarget = (adapter, decidedId) => {
+	if (!decidedId || typeof adapter?.clearActiveTrackedChangeTargetIfMatches !== "function") return;
+	try {
+		adapter.clearActiveTrackedChangeTargetIfMatches(decidedId);
+	} catch {}
+};
+var 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 {}
+};
+//#endregion
 //#region src/stores/helpers/comment-draft-text.ts
 var COMMENT_DRAFT_BR_TAG = /<br(?:\s[^>]*)?\s*\/?>/gi;
 var COMMENT_DRAFT_BLOCK_BOUNDARY = /(?:<\/(?:p|div|li|blockquote|pre|h[1-6])\s*>\s*)+(?:<(?:p|div|li|blockquote|pre|h[1-6])(?:\s[^>]*)?\s*\/?>)+/gi;
@@ -7603,9 +7854,131 @@ var cloneV2TrackedChangeStory = (story) => {
 	};
 };
 //#endregion
-//#region src/stores/comments-store.js
+//#region src/stores/helpers/tracked-change-compaction.ts
+var isPresentId = (id) => Boolean(id);
+var getBodyTrackedChangeIdentityIds = (comment) => {
+	return [normalizeCommentId(comment.commentId), ...!normalizeCommentId(comment.trackedChangeCanonicalId) ? [
+		comment.importedId,
+		comment.trackedChangeAnchorKey,
+		...normalizeTrackedChangePositionAliases(comment.trackedChangePositionAliases)
+	] : []].map((id) => normalizeCommentId(id)).filter(isPresentId);
+};
+var groupBodyTrackedChangeCommentsByIdentity = (comments) => {
+	const parents = comments.map((_, index) => index);
+	const findRoot = (index) => {
+		let root = index;
+		while (parents[root] !== root) root = parents[root];
+		while (parents[index] !== index) {
+			const next = parents[index];
+			parents[index] = root;
+			index = next;
+		}
+		return root;
+	};
+	const join = (left, right) => {
+		const leftRoot = findRoot(left);
+		const rightRoot = findRoot(right);
+		if (leftRoot === rightRoot) return;
+		parents[Math.max(leftRoot, rightRoot)] = Math.min(leftRoot, rightRoot);
+	};
+	const identityOwner = /* @__PURE__ */ new Map();
+	comments.forEach((comment, index) => {
+		getBodyTrackedChangeIdentityIds(comment).forEach((identityId) => {
+			const owner = identityOwner.get(identityId);
+			if (owner === void 0) identityOwner.set(identityId, index);
+			else join(index, owner);
+		});
+	});
+	const groups = /* @__PURE__ */ new Map();
+	comments.forEach((comment, index) => {
+		const root = findRoot(index);
+		const group = groups.get(root) ?? [];
+		group.push(comment);
+		groups.set(root, group);
+	});
+	return groups;
+};
+var mergeDuplicateBodyTrackedChangeComments = (groups) => {
+	const duplicates = /* @__PURE__ */ new Map();
+	groups.forEach(([survivor, ...duplicateRows]) => {
+		if (!survivor || duplicateRows.length === 0) return;
+		const resolvedDuplicate = duplicateRows.find((comment) => comment.resolvedTime != null);
+		if (survivor.resolvedTime == null && resolvedDuplicate) {
+			survivor.resolvedTime = resolvedDuplicate.resolvedTime;
+			survivor.resolvedById = resolvedDuplicate.resolvedById;
+			survivor.resolvedByEmail = resolvedDuplicate.resolvedByEmail;
+			survivor.resolvedByName = resolvedDuplicate.resolvedByName;
+			survivor.trackedChangeDecision = resolvedDuplicate.trackedChangeDecision;
+		}
+		survivor.trackedChangePositionAliases = normalizeTrackedChangePositionAliases([...normalizeTrackedChangePositionAliases(survivor.trackedChangePositionAliases), ...duplicateRows.flatMap((comment) => [
+			comment.commentId,
+			comment.importedId,
+			comment.trackedChangeCanonicalId,
+			...normalizeTrackedChangePositionAliases(comment.trackedChangePositionAliases)
+		])]);
+		duplicateRows.forEach((comment) => duplicates.set(comment, survivor));
+	});
+	return duplicates;
+};
+var createDroppedCommentIdMap = (duplicates) => {
+	const droppedCommentIds = /* @__PURE__ */ new Map();
+	duplicates.forEach((survivor, duplicate) => {
+		const fromId = normalizeCommentId(duplicate.commentId);
+		const toId = normalizeCommentId(survivor.commentId);
+		if (fromId && toId) droppedCommentIds.set(fromId, toId);
+	});
+	return droppedCommentIds;
+};
+//#endregion
+//#region src/stores/helpers/v2-review-adapters.ts
+var COMMENTS_ADAPTER_METHODS = [
+	"setActiveComment",
+	"commitPendingComment",
+	"reply",
+	"edit",
+	"resolve",
+	"reopen",
+	"delete",
+	"mapV2CommentToUseCommentInput"
+];
+var COMMENTS_ADAPTER_OPTIONAL_METHODS = [
+	"getCapabilityState",
+	"captureCurrentSelection",
+	"isPendingCommentCreation",
+	"seedReviewCatalog",
+	"selectVisibleReviewComments"
+];
+var TRACKED_CHANGES_ADAPTER_METHODS = [
+	"accept",
+	"reject",
+	"mapV2TrackedChangeToCommentParams"
+];
+var TRACKED_CHANGES_ADAPTER_OPTIONAL_METHODS = ["clearActiveTrackedChangeTargetIfMatches"];
+var isAdapterDocumentId = (value) => value === void 0 || value === null || typeof value === "string" || typeof value === "number";
+var hasAdapterShape = (value, required, optional) => isPlainObject$1(value) && isAdapterDocumentId(value.documentId) && required.every((member) => typeof value[member] === "function") && optional.every((member) => value[member] === void 0 || typeof value[member] === "function");
+function isV2CommentsAdapter(value) {
+	return hasAdapterShape(value, COMMENTS_ADAPTER_METHODS, COMMENTS_ADAPTER_OPTIONAL_METHODS);
+}
+function isV2TrackedChangesAdapter(value) {
+	return hasAdapterShape(value, TRACKED_CHANGES_ADAPTER_METHODS, TRACKED_CHANGES_ADAPTER_OPTIONAL_METHODS);
+}
+//#endregion
+//#region src/stores/comments-store.ts
+var requireHost = (superdoc, action) => {
+	if (!superdoc) throw new TypeError(`${action} requires superdoc`);
+	return superdoc;
+};
+var PARENT_LINK_FIELDS = [
+	"trackedChangeThreadParentId",
+	"trackedChangeParentId",
+	"threadingParentCommentId",
+	"parentCommentId"
+];
+var isPresent = (value) => Boolean(value);
+var errorDetail = (error) => (error == null ? void 0 : Reflect.get(Object(error), "message")) ?? String(error);
 var useCommentsStore = defineStore("comments", () => {
 	const superdocStore = useSuperdocStore();
+	const findDocument = (documentId) => typeof documentId === "string" ? superdocStore.getDocument(documentId) : void 0;
 	const commentsConfig = reactive({
 		name: "comments",
 		readOnly: false,
@@ -7672,7 +8045,7 @@ var useCommentsStore = defineStore("comments", () => {
 	});
 	const getTrackedChangeThread = (parentComment) => {
 		const id = parentComment?.commentId ?? null;
-		return (id != null ? trackedChangeThreadIndex.value.get(id) : null) ?? [parentComment].filter(Boolean);
+		return (id != null ? trackedChangeThreadIndex.value.get(id) : null) ?? (parentComment ? [parentComment] : []);
 	};
 	let priorTrackedChangeDecisionLinkIndex = /* @__PURE__ */ new Map();
 	const trackedChangeDecisionLinkIndex = computed$1(() => {
@@ -7704,29 +8077,27 @@ var useCommentsStore = defineStore("comments", () => {
 	});
 	const v2CommentsAdapter = shallowRef$1(null);
 	const setV2CommentsAdapter = (adapter) => {
-		if (v2CommentsAdapter.value !== (adapter ?? null)) pendingCommentRequest += 1;
-		v2CommentsAdapter.value = adapter ?? null;
+		const next = isV2CommentsAdapter(adapter) ? adapter : null;
+		if (v2CommentsAdapter.value !== next) pendingCommentRequest += 1;
+		v2CommentsAdapter.value = next;
 	};
 	const getV2CommentsAdapter = (superdoc) => {
-		const fromFacade = superdoc?.activeEditor?.v2Comments ?? null;
-		if (fromFacade) return fromFacade;
+		const fromFacade = superdoc?.activeEditor?.v2Comments;
+		if (isV2CommentsAdapter(fromFacade)) return fromFacade;
 		return v2CommentsAdapter.value;
 	};
 	const isV2EditorActive = (superdoc) => superdoc?.activeEditor?.editorVersion === 2 || v2CommentsAdapter.value !== null;
 	const v2TrackedChangesAdapter = shallowRef$1(null);
 	const setV2TrackedChangesAdapter = (adapter) => {
-		v2TrackedChangesAdapter.value = adapter ?? null;
+		v2TrackedChangesAdapter.value = isV2TrackedChangesAdapter(adapter) ? adapter : null;
 	};
 	const getV2TrackedChangesAdapter = (superdoc) => {
-		const fromFacade = superdoc?.activeEditor?.v2TrackedChanges ?? null;
-		if (fromFacade) return fromFacade;
+		const fromFacade = superdoc?.activeEditor?.v2TrackedChanges;
+		if (isV2TrackedChangesAdapter(fromFacade)) return fromFacade;
 		return v2TrackedChangesAdapter.value;
 	};
 	/**
 	* Initialize the store
-	*
-	* @param {Object} config The comments module config from SuperDoc
-	* @returns {void}
 	*/
 	const init = (config = {}) => {
 		const updatedConfig = {
@@ -7758,12 +8129,17 @@ var useCommentsStore = defineStore("comments", () => {
 		comment.trackedChangeDecision = null;
 	};
 	const getCommentEventPayload = (comment) => typeof comment?.getValues === "function" ? comment.getValues() : { ...comment };
+	const getDeletedCommentChanges = (sources, fileId) => {
+		const commentId = [...sources.map((source) => source?.commentId), ...sources.map((source) => source?.importedId)].map(normalizeCommentId).find(Boolean);
+		return commentId ? [{
+			key: "deleted",
+			commentId,
+			fileId
+		}] : [];
+	};
 	/**
 	* Check if a comment originated from the document editor (or has no explicit source).
 	* Comments without a source are assumed to be editor-backed for backward compatibility.
-	*
-	* @param {Object} comment - The comment to check
-	* @returns {boolean} True if the comment is editor-backed
 	*/
 	const isEditorBackedComment = (comment) => {
 		const source = comment?.selection?.source;
@@ -7797,9 +8173,6 @@ var useCommentsStore = defineStore("comments", () => {
 	}, { deep: false });
 	/**
 	* Get the editor position data for a comment.
-	*
-	* @param {Object | string} commentOrId The comment object or comment ID
-	* @returns {Object | null} The position data from editorCommentPositions
 	*/
 	const getCommentPosition = (commentOrId) => {
 		return resolveCommentPositionEntry(commentOrId).entry ?? null;
@@ -7812,10 +8185,6 @@ var useCommentsStore = defineStore("comments", () => {
 	};
 	/**
 	* Set the active comment or clear all active comments
-	*
-	* @param {Object | undefined | null} superdoc The SuperDoc instance holding the active editor
-	* @param {string | undefined | null} id The comment ID
-	* @returns {void}
 	*/
 	const setActiveComment = (superdoc, id) => {
 		const activeEditor = superdoc?.activeEditor;
@@ -7826,7 +8195,7 @@ var useCommentsStore = defineStore("comments", () => {
 				v2Adapter.setActiveComment(null);
 				return;
 			}
-			activeEditor?.commands?.setActiveComment({ commentId: null });
+			activeEditor?.commands?.setActiveComment?.({ commentId: null });
 			return;
 		}
 		const comment = getComment(id);
@@ -7837,16 +8206,11 @@ var useCommentsStore = defineStore("comments", () => {
 			v2Adapter.setActiveComment(comment.commentId);
 			return;
 		}
-		activeEditor?.commands?.setActiveComment({ commentId: activeComment.value });
+		activeEditor?.commands?.setActiveComment?.({ commentId: activeComment.value });
 	};
 	/**
 	* Called when a tracked change is updated. Creates a new comment if necessary,
 	* or updates an existing tracked-change comment.
-	*
-	* @param {Object} param0
-	* @param {Object} param0.superdoc The SuperDoc instance
-	* @param {Object} param0.params The tracked change params
-	* @returns {void}
 	*/
 	const handleTrackedChangeUpdate = ({ superdoc, params, broadcastChanges = true, trackedChangeIdentityIndex = null }) => {
 		const span = startInteractionSpan("store.trackedChanges.handleUpdate", "store-reconciliation", {
@@ -7875,7 +8239,7 @@ var useCommentsStore = defineStore("comments", () => {
 			const normalizedTrackedChangeImagePreview = normalizeTrackedChangeImagePreview(trackedChangeImagePreview);
 			const comment = getPendingComment({
 				documentId,
-				commentId: changeId,
+				commentId: normalizedChangeId ?? void 0,
 				trackedChange: true,
 				trackedChangeText,
 				trackedChangeType,
@@ -7927,7 +8291,7 @@ var useCommentsStore = defineStore("comments", () => {
 						commentCanonicalId,
 						commentAnchorKey,
 						...commentAliasIds
-					].filter(Boolean).some((id) => incomingAliasIds.has(id))) return true;
+					].some((id) => id != null && incomingAliasIds.has(id))) return true;
 					const hasSyntheticSideIdentity = normalizedTrackedChangeCanonicalId && normalizedTrackedChangeCanonicalId !== normalizedChangeId || commentCanonicalId && commentCanonicalId !== commentId;
 					if (hasCompatibleStory && commentId === normalizedChangeId) return true;
 					if (hasCompatibleStory && !hasSyntheticSideIdentity && (importedId === normalizedChangeId || normalizedImportedId !== void 0 && normalizedImportedId != null && importedId === normalizedImportedId)) return true;
@@ -7951,7 +8315,7 @@ var useCommentsStore = defineStore("comments", () => {
 			};
 			const emitTrackedChangeEvent = (event) => {
 				if (!broadcastChanges) return;
-				syncCommentsToClients(superdoc, event);
+				syncCommentsToClients(requireHost(superdoc, "handleTrackedChangeUpdate"), event);
 				debounceEmit(changeId, event, superdoc);
 			};
 			const setIfChanged = (target, key, value) => {
@@ -7994,8 +8358,9 @@ var useCommentsStore = defineStore("comments", () => {
 						target?.trackedChangeCanonicalId,
 						target?.trackedChangeAnchorKey,
 						...getCommentAliasIds(target)
-					].map((id) => normalizeCommentId(id)).filter(Boolean));
-					fields.trackedChangePositionAliases = normalizedTrackedChangePositionAliases.some((alias) => targetIdentityIds.has(alias)) ? normalizeTrackedChangePositionAliases([...Array.isArray(target?.trackedChangePositionAliases) ? target.trackedChangePositionAliases : [], ...normalizedTrackedChangePositionAliases]) : normalizedTrackedChangePositionAliases;
+					].map((id) => normalizeCommentId(id)).filter(isPresent));
+					const incomingAliases = normalizedTrackedChangePositionAliases ?? [];
+					fields.trackedChangePositionAliases = incomingAliases.some((alias) => targetIdentityIds.has(alias)) ? normalizeTrackedChangePositionAliases([...Array.isArray(target?.trackedChangePositionAliases) ? target.trackedChangePositionAliases : [], ...incomingAliases]) : incomingAliases;
 				}
 				let didChange = false;
 				for (const [key, value] of Object.entries(fields)) didChange = setIfChanged(target, key, value) || didChange;
@@ -8004,7 +8369,7 @@ var useCommentsStore = defineStore("comments", () => {
 					didChange = true;
 				}
 				if (hasCustomAttributes && target && !trackedChangeCustomAttributesEqual(target.customAttributes, normalizedCustomAttributes)) {
-					target.customAttributes = normalizedCustomAttributes;
+					target.customAttributes = normalizedCustomAttributes ?? null;
 					didChange = true;
 				}
 				return applyStoryMetadata(target) || didChange;
@@ -8026,7 +8391,7 @@ var useCommentsStore = defineStore("comments", () => {
 					return;
 				}
 				addHydratedComment({
-					superdoc,
+					superdoc: requireHost(superdoc, "handleTrackedChangeUpdate"),
 					comment,
 					broadcastChanges
 				});
@@ -8046,11 +8411,12 @@ var useCommentsStore = defineStore("comments", () => {
 					id: params.resolvedById ?? superdoc?.user?.id ?? null,
 					email: params.resolvedByEmail ?? superdoc?.user?.email ?? null,
 					name: params.resolvedByName ?? superdoc?.user?.name ?? null,
-					decision: params.decision ?? null,
+					decision: params.decision ?? void 0,
 					superdoc
 				};
 				if (existingTrackedChange && !existingTrackedChange.resolvedTime) existingTrackedChange.resolveComment({
 					...resolveArgs,
+					superdoc: requireHost(superdoc, "handleTrackedChangeUpdate"),
 					reconciliationToken: COMMENT_RECONCILIATION_TOKEN
 				});
 			}
@@ -8075,31 +8441,13 @@ var useCommentsStore = defineStore("comments", () => {
 		instantSidebarAlignmentInstanceId.value = null;
 	};
 	const debounceEmit = (commentId, event, superdoc, delay = 1e3) => {
-		if (debounceTimers[commentId]) clearTimeout(debounceTimers[commentId]);
-		debounceTimers[commentId] = setTimeout(() => {
+		const timerKey = String(commentId);
+		if (debounceTimers[timerKey]) clearTimeout(debounceTimers[timerKey]);
+		debounceTimers[timerKey] = setTimeout(() => {
 			if (superdoc) superdoc.emit("comments-update", event);
-			delete debounceTimers[commentId];
+			delete debounceTimers[timerKey];
 		}, delay);
 	};
-	const getPendingSelectionSnapshot = (superdoc, activeSelection) => {
-		if (activeSelection?.source !== "document-editor") return null;
-		const selectionDocumentId = activeSelection?.documentId ?? null;
-		const editorDocumentId = superdoc?.activeEditor?.options?.documentId ?? null;
-		if (!selectionDocumentId || !editorDocumentId || selectionDocumentId !== editorDocumentId) return null;
-		let currentSelection;
-		try {
-			currentSelection = superdoc?.activeEditor?.doc?.selection?.current;
-		} catch {
-			return null;
-		}
-		if (typeof currentSelection !== "function") return null;
-		try {
-			const snapshot = currentSelection();
-			return typeof snapshot?.then === "function" ? Promise.resolve(snapshot).catch(() => null) : snapshot;
-		} catch {
-			return null;
-		}
-	};
 	const showAddComment = (superdoc, targetClientY = null) => {
 		const request = ++pendingCommentRequest;
 		const editor = superdoc?.activeEditor;
@@ -8109,7 +8457,7 @@ var useCommentsStore = defineStore("comments", () => {
 			if (!ownsRequest()) return;
 			superdoc.emit("comments-update", {
 				type: COMMENT_EVENTS.PENDING,
-				pendingSelection: superdoc?.activeEditor === editor ? snapshot : null
+				pendingSelection: superdoc?.activeEditor === editor && isPlainObject$1(snapshot) ? snapshot : null
 			});
 		};
 		if (v2Adapter) {
@@ -8154,12 +8502,11 @@ var useCommentsStore = defineStore("comments", () => {
 			}).catch((err) => ({
 				ok: false,
 				reason: "selection-capture-failed",
-				detail: err?.message ?? String(err)
+				detail: errorDetail(err)
 			}));
 		}
 		const pendingSelection = getPendingSelectionSnapshot(superdoc, superdocStore.activeSelection);
-		const asyncSnapshot = typeof pendingSelection?.then === "function";
-		if (!asyncSnapshot) emitPending(pendingSelection);
+		if (!isThenable$1(pendingSelection)) emitPending(pendingSelection);
 		const showLegacyPending = (selection) => {
 			selection.selectionBounds = { ...selection.selectionBounds };
 			if (superdocStore.selectionPosition?.source && superdocStore.selectionPosition.source !== "pdf") superdocStore.selectionPosition.source = null;
@@ -8169,7 +8516,7 @@ var useCommentsStore = defineStore("comments", () => {
 				parentCommentId: null
 			});
 			if (!superdoc.config.isInternal) pendingComment.value.isInternal = false;
-			if (superdoc.activeEditor?.commands) superdoc.activeEditor.commands.insertComment({
+			if (superdoc.activeEditor?.commands) superdoc.activeEditor.commands.insertComment?.({
 				...pendingComment.value.getValues(),
 				commentId: "pending",
 				skipEmit: true
@@ -8180,10 +8527,10 @@ var useCommentsStore = defineStore("comments", () => {
 			activeComment.value = pendingComment.value.commentId;
 			return { ok: true };
 		};
-		if (asyncSnapshot) {
+		if (isThenable$1(pendingSelection)) {
 			const selection = { ...superdocStore.activeSelection };
 			selection.selectionBounds = { ...selection.selectionBounds };
-			return pendingSelection.then((snapshot) => {
+			return Promise.resolve(pendingSelection).then((snapshot) => {
 				if (!ownsRequest()) return {
 					ok: false,
 					reason: "pending-comment-superseded"
@@ -8215,12 +8562,6 @@ var useCommentsStore = defineStore("comments", () => {
 	});
 	/**
 	* Get a new pending comment
-	*
-	* @param {Object} param0
-	* @param {Object} [param0.selection] The selection object
-	* @param {string | null} [param0.documentId] The document ID
-	* @param {string | null} [param0.parentCommentId] The parent comment
-	* @returns {ReturnType<typeof useComment>} The new comment object
 	*/
 	const getPendingComment = ({ selection, documentId, parentCommentId, ...options }) => {
 		return _getNewcomment({
@@ -8232,17 +8573,11 @@ var useCommentsStore = defineStore("comments", () => {
 	};
 	/**
 	* Get the new comment object
-	*
-	* @param {Object} param0
-	* @param {Object} param0.selection The selection object
-	* @param {String} param0.documentId The document ID
-	* @param {String} param0.parentCommentId The parent comment ID
-	* @returns {Object} The new comment object
 	*/
 	const _getNewcomment = ({ selection, documentId, parentCommentId, ...options }) => {
 		let activeDocument;
-		if (documentId) activeDocument = superdocStore.getDocument(documentId);
-		else if (selection) activeDocument = superdocStore.getDocument(selection.documentId);
+		if (documentId) activeDocument = findDocument(documentId);
+		else if (selection) activeDocument = findDocument(selection.documentId);
 		if (!activeDocument) activeDocument = superdocStore.documents[0];
 		return useComment({
 			fileId: activeDocument.id,
@@ -8259,8 +8594,6 @@ var useCommentsStore = defineStore("comments", () => {
 	};
 	/**
 	* Remove the pending comment
-	*
-	* @returns {void}
 	*/
 	const resetPendingCommentState = (superdoc, clearViewingSelection = true) => {
 		const hadPending = !!pendingComment.value;
@@ -8276,7 +8609,7 @@ var useCommentsStore = defineStore("comments", () => {
 			} catch {}
 			return;
 		}
-		superdoc?.activeEditor?.commands?.removeComment({ commentId: "pending" });
+		superdoc?.activeEditor?.commands?.removeComment?.({ commentId: "pending" });
 	};
 	const removePendingComment = (superdoc) => {
 		pendingCommentRequest += 1;
@@ -8289,14 +8622,6 @@ var useCommentsStore = defineStore("comments", () => {
 	};
 	/**
 	* Add a new comment to the document
-	*
-	* @param {Object} param0
-	* @param {Object} param0.superdoc The SuperDoc instance
-	* @param {ReturnType<typeof useComment>} param0.comment The comment to add
-	* @param {boolean} [param0.skipEditorUpdate] Skip writing the comment into the editor
-	* @param {boolean} [param0.broadcastChanges] Emit and sync the change
-	* @param {boolean} [param0.isHydration] The comment comes from import or collaboration
-	* @returns {{ ok: boolean, reason?: string, detail?: string, code?: string } | Promise<{ ok: boolean, reason?: string, detail?: string, code?: string }>} The mutation outcome
 	*/
 	const addCommentInternal = ({ superdoc, comment, skipEditorUpdate = false, broadcastChanges = true, isHydration = false }) => {
 		if (commentsAreReadOnly() && !isHydration) return readOnlyMutationOutcome();
@@ -8326,7 +8651,7 @@ var useCommentsStore = defineStore("comments", () => {
 					return {
 						ok: false,
 						reason: "adapter-threw",
-						detail: err?.message ?? String(err)
+						detail: errorDetail(err)
 					};
 				}
 			})().then((outcome) => {
@@ -8398,7 +8723,7 @@ var useCommentsStore = defineStore("comments", () => {
 			activeComment.value = newComment.commentId;
 			setActiveFloatingCommentInstance(newComment.commentId);
 		}
-		if (!skipEditorUpdate && !comment.trackedChange && superdoc.activeEditor?.commands && !comment.parentCommentId) superdoc.activeEditor.commands.insertComment({
+		if (!skipEditorUpdate && !comment.trackedChange && superdoc.activeEditor?.commands && !comment.parentCommentId) superdoc.activeEditor.commands.insertComment?.({
 			...newComment.getValues(),
 			skipEmit: true
 		});
@@ -8446,7 +8771,7 @@ var useCommentsStore = defineStore("comments", () => {
 				return {
 					ok: false,
 					reason: "adapter-threw",
-					detail: err?.message ?? String(err)
+					detail: errorDetail(err)
 				};
 			}
 		})().then((outcome) => {
@@ -8466,16 +8791,16 @@ var useCommentsStore = defineStore("comments", () => {
 				});
 				return outcome;
 			}
-			const removedIds = new Set((Array.isArray(outcome.removedCommentIds) ? outcome.removedCommentIds : []).map(normalizeCommentId).filter(Boolean));
-			if (removedIds.has(normalizeCommentId(commentId))) {
-				if (importedId != null) removedIds.add(normalizeCommentId(importedId));
+			const removedIds = new Set((Array.isArray(outcome.removedCommentIds) ? outcome.removedCommentIds : []).map(normalizeCommentId).filter(isPresent));
+			if (removedIds.has(normalizeCommentId(commentId) ?? "")) {
+				if (importedId != null) removedIds.add(String(importedId));
 				let addedChild = true;
 				while (addedChild) {
 					addedChild = false;
 					for (const row of commentsList.value) {
 						const parentId = normalizeCommentId(row?.parentCommentId);
 						if (!parentId || !removedIds.has(parentId)) continue;
-						for (const alias of [row?.commentId, row?.importedId].map(normalizeCommentId).filter(Boolean)) {
+						for (const alias of [row?.commentId, row?.importedId].map(normalizeCommentId).filter(isPresent)) {
 							if (removedIds.has(alias)) continue;
 							removedIds.add(alias);
 							addedChild = true;
@@ -8483,9 +8808,9 @@ var useCommentsStore = defineStore("comments", () => {
 					}
 				}
 				commentsList.value = commentsList.value.filter((row) => {
-					return ![row?.commentId, row?.importedId].map(normalizeCommentId).filter(Boolean).some((alias) => removedIds.has(alias));
+					return ![row?.commentId, row?.importedId].map(normalizeCommentId).filter(isPresent).some((alias) => removedIds.has(alias));
 				});
-				if (removedIds.has(normalizeCommentId(activeComment.value))) clearActiveCommentSelection();
+				if (removedIds.has(normalizeCommentId(activeComment.value) ?? "")) clearActiveCommentSelection();
 			} else reconcileCommentsFromV2({
 				superdoc,
 				adapter: v2Adapter,
@@ -8493,18 +8818,18 @@ var useCommentsStore = defineStore("comments", () => {
 				items: outcome.items ?? [],
 				pruneStale: outcome.complete !== false
 			});
+			const payload = comment.getValues();
 			superdoc.emit("comments-update", {
 				type: COMMENT_EVENTS.DELETED,
-				comment: comment.getValues(),
-				changes: [{
-					key: "deleted",
+				comment: payload,
+				changes: getDeletedCommentChanges([{
 					commentId,
-					fileId
-				}]
+					importedId
+				}, payload], fileId)
 			});
 			return { ok: true };
 		});
-		superdoc.activeEditor?.commands?.removeComment({
+		superdoc.activeEditor?.commands?.removeComment?.({
 			commentId,
 			importedId
 		});
@@ -8512,14 +8837,14 @@ var useCommentsStore = defineStore("comments", () => {
 		const childCommentIds = commentsList.value.filter((c) => c.parentCommentId === commentId).map((c) => c.commentId || c.importedId);
 		commentsList.value = commentsList.value.filter((c) => !childCommentIds.includes(c.commentId));
 		if (activeComment.value === commentId || childCommentIds.includes(activeComment.value)) clearActiveCommentSelection();
+		const payload = comment.getValues();
 		const event = {
 			type: COMMENT_EVENTS.DELETED,
-			comment: comment.getValues(),
-			changes: [{
-				key: "deleted",
+			comment: payload,
+			changes: getDeletedCommentChanges([{
 				commentId,
-				fileId
-			}]
+				importedId
+			}, payload], fileId)
 		};
 		superdoc.emit("comments-update", event);
 		syncCommentsToClients(superdoc, event);
@@ -8531,7 +8856,7 @@ var useCommentsStore = defineStore("comments", () => {
 	* otherwise keep the source bubble after the document comment is gone.
 	*/
 	const dropCommentsFromMutationImpact = ({ superdoc, documentId, removedIds } = {}) => {
-		const seedIds = new Set([...removedIds instanceof Set ? removedIds : removedIds ?? []].map((id) => normalizeCommentId(id)).filter(Boolean));
+		const seedIds = new Set([...removedIds instanceof Set ? removedIds : removedIds ?? []].map((id) => normalizeCommentId(id)).filter(isPresent));
 		if (!seedIds.size) return {
 			ok: true,
 			removedIds: []
@@ -8555,7 +8880,7 @@ var useCommentsStore = defineStore("comments", () => {
 				if (!isDroppableCommentRow(row)) continue;
 				const aliases = getCommentAliasIds(row);
 				const alreadyDropped = aliases.some((alias) => droppedIds.has(alias));
-				const parentDropped = droppedIds.has(normalizeCommentId(row?.parentCommentId)) || droppedIds.has(normalizeCommentId(row?.threadingParentCommentId));
+				const parentDropped = droppedIds.has(normalizeCommentId(row?.parentCommentId) ?? "") || droppedIds.has(normalizeCommentId(row?.threadingParentCommentId) ?? "");
 				if (!alreadyDropped && !parentDropped) continue;
 				for (const alias of aliases) {
 					if (droppedIds.has(alias)) continue;
@@ -8583,11 +8908,7 @@ var useCommentsStore = defineStore("comments", () => {
 			const event = {
 				type: COMMENT_EVENTS.DELETED,
 				comment: payload,
-				changes: [{
-					key: "deleted",
-					commentId: payload?.commentId,
-					fileId: payload?.fileId
-				}]
+				changes: getDeletedCommentChanges([payload, comment], payload?.fileId)
 			};
 			superdoc?.emit?.("comments-update", event);
 		});
@@ -8609,7 +8930,7 @@ var useCommentsStore = defineStore("comments", () => {
 		const byAlias = /* @__PURE__ */ new Map();
 		const childrenByParentAlias = /* @__PURE__ */ new Map();
 		for (const row of rows) {
-			for (const alias of [row.commentId, row.importedId].map(normalizeCommentId).filter(Boolean)) if (!byAlias.has(alias)) byAlias.set(alias, row);
+			for (const alias of [row.commentId, row.importedId].map(normalizeCommentId).filter(isPresent)) if (!byAlias.has(alias)) byAlias.set(alias, row);
 			const parentId = normalizeCommentId(row.parentCommentId);
 			if (parentId) {
 				const children = childrenByParentAlias.get(parentId) ?? [];
@@ -8636,7 +8957,7 @@ var useCommentsStore = defineStore("comments", () => {
 			if (!row || visited.has(row)) continue;
 			visited.add(row);
 			family.push(row);
-			for (const alias of [row.commentId, row.importedId].map(normalizeCommentId).filter(Boolean)) queue.push(...childrenByParentAlias.get(alias) ?? []);
+			for (const alias of [row.commentId, row.importedId].map(normalizeCommentId).filter(isPresent)) queue.push(...childrenByParentAlias.get(alias) ?? []);
 		}
 		const isResolved = status === "resolved";
 		const resolvedAt = Date.now();
@@ -8659,7 +8980,7 @@ var useCommentsStore = defineStore("comments", () => {
 			outcome = {
 				ok: false,
 				reason: "adapter-threw",
-				detail: err?.message ?? String(err)
+				detail: errorDetail(err)
 			};
 		}
 		if (!isCurrentV2CommentsAdapter(adapter)) return {
@@ -8731,14 +9052,14 @@ var useCommentsStore = defineStore("comments", () => {
 		return (outcome.items ?? []).map((item) => adapter.mapV2CommentToUseCommentInput(item, {
 			fileId,
 			fileType: null
-		})).filter(Boolean);
+		})).filter(isPresent);
 	};
 	const isBlankDirectoryCommentText = (value) => typeof value !== "string" || value.replace(/<[^>]*>/g, "").replace(/&nbsp;/gi, " ").trim().length === 0;
 	const trackedChangeDirectoryComment = (params) => {
 		if (!params || params.event === "omit" || params.changeId == null) return null;
 		return getPendingComment({
 			documentId: params.documentId,
-			commentId: params.changeId,
+			commentId: String(params.changeId),
 			trackedChange: true,
 			trackedChangeText: params.trackedChangeText,
 			trackedChangeType: params.trackedChangeType,
@@ -8785,7 +9106,7 @@ var useCommentsStore = defineStore("comments", () => {
 		const mappedCommentInputs = commentItems.filter((item) => !isSyntheticTrackedChangeCommentLaneItem(item)).map((item) => commentsAdapter.mapV2CommentToUseCommentInput(item, {
 			fileId: documentId,
 			fileType: document?.type ?? null
-		})).filter(Boolean);
+		})).filter(isPresent);
 		const trackedParentBySidecarId = /* @__PURE__ */ new Map();
 		for (const input of mappedCommentInputs) if (input.trackedChange !== true && input.trackedChangeThreadParentId && !input.parentCommentId && isBlankDirectoryCommentText(input.commentText)) trackedParentBySidecarId.set(String(input.commentId), String(input.trackedChangeThreadParentId));
 		const commentRows = mappedCommentInputs.filter((input) => !trackedParentBySidecarId.has(String(input.commentId))).map((input) => {
@@ -8796,7 +9117,7 @@ var useCommentsStore = defineStore("comments", () => {
 			}
 			return useComment(input);
 		});
-		const trackedRows = trackedChangeItems.map((item) => trackedChangesAdapter.mapV2TrackedChangeToCommentParams(item)).map((params) => trackedChangeDirectoryComment(params)).filter(Boolean);
+		const trackedRows = trackedChangeItems.map((item) => trackedChangesAdapter.mapV2TrackedChangeToCommentParams(item)).map((params) => trackedChangeDirectoryComment(params)).filter(isPresent);
 		reviewDirectoryList.value = [...commentRows, ...trackedRows];
 		return {
 			ok: true,
@@ -8877,13 +9198,6 @@ var useCommentsStore = defineStore("comments", () => {
 	*   - successful mutation refreshes from v2 list and reconciles
 	*   - rejection preserves rows and emits a rejected `comments-update` event
 	*   - committed-but-refresh-failed surfaces honestly (no reconcile with `[]`)
-	*
-	* @param {Object} [param0]
-	* @param {Object} [param0.superdoc] The SuperDoc instance.
-	* @param {string | null} [param0.parentCommentId] The comment or tracked-change row being replied to.
-	* @param {string} [param0.text] The reply text.
-	* @param {Array<{ name?: string | null, email?: string | null }>} [param0.mentions] Users mentioned in the reply.
-	* @param {{ kind: 'trackedChange', trackedChangeId: string, story?: unknown, side?: import('./helpers/tracked-change-thread-index.js').TrackedChangeSideGroup }} [param0.trackedChangeTarget] The tracked change a first reply anchors to.
 	*/
 	const replyCommentV2 = async ({ superdoc, parentCommentId, text, mentions = [], trackedChangeTarget } = {}) => {
 		if (commentsAreReadOnly()) return readOnlyMutationOutcome();
@@ -9158,7 +9472,7 @@ var useCommentsStore = defineStore("comments", () => {
 		row?.threadingParentCommentId,
 		row?.trackedChangeParentId,
 		row?.trackedChangeThreadParentId
-	].map((value) => normalizeCommentId(value)).filter(Boolean));
+	].map((value) => normalizeCommentId(value)).filter(isPresent));
 	/** Keep one mounted review window plus rows whose interaction is still live. */
 	const boundReviewPresentationRows = ({ documentId, visibleIds }) => {
 		const currentRows = commentsList.value;
@@ -9179,7 +9493,7 @@ var useCommentsStore = defineStore("comments", () => {
 			pendingComment.value?.commentId,
 			instantSidebarAlignmentThreadId.value,
 			instantSidebarAlignmentInstanceId.value
-		].map((value) => normalizeCommentId(value)).filter(Boolean));
+		].map((value) => normalizeCommentId(value)).filter(isPresent));
 		let changed = true;
 		while (changed) {
 			changed = false;
@@ -9247,7 +9561,8 @@ var useCommentsStore = defineStore("comments", () => {
 		if (preparedReview?.reuseCatalog === true && committedReviewPresentations.value[normalizedDocumentId]) {
 			const previous = committedReviewPresentations.value[normalizedDocumentId];
 			const next = preparedReview.presentation;
-			if (!next || !Number.isSafeInteger(preparedReview.catalogVersion) || preparedReview.catalogVersion < 1 || previous.catalogVersion > preparedReview.catalogVersion || next.catalogVersion !== preparedReview.catalogVersion || previous.coordinate?.documentEpoch !== next.coordinate?.documentEpoch || previous.coordinate?.mountId !== next.coordinate?.mountId || next.coordinate?.reviewVersion <= previous.coordinate?.reviewVersion || next.coordinate?.commitSequence < previous.coordinate?.commitSequence) return {
+			const catalogVersion = preparedReview.catalogVersion ?? NaN;
+			if (!next || !Number.isSafeInteger(catalogVersion) || catalogVersion < 1 || (previous.catalogVersion ?? 0) > catalogVersion || next.catalogVersion !== preparedReview.catalogVersion || previous.coordinate?.documentEpoch !== next.coordinate?.documentEpoch || previous.coordinate?.mountId !== next.coordinate?.mountId || next.coordinate?.reviewVersion <= previous.coordinate?.reviewVersion || next.coordinate?.commitSequence < previous.coordinate?.commitSequence) return {
 				ok: false,
 				reason: "review-catalog-stale"
 			};
@@ -9293,8 +9608,8 @@ var useCommentsStore = defineStore("comments", () => {
 			previousPresentation.updateContext = presentation.updateContext;
 			return {
 				ok: true,
-				commentItems: preparedReview.comments.length,
-				trackedItems: preparedReview.trackedChanges.length
+				commentItems: preparedReview?.comments.length,
+				trackedItems: preparedReview?.trackedChanges.length
 			};
 		}
 		let effectiveCommentItems = commentItems;
@@ -9308,7 +9623,7 @@ var useCommentsStore = defineStore("comments", () => {
 				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;
+			if (!isThenable$1(selected) && selected?.ok === true && Array.isArray(selected.items) && (!Array.isArray(selected.unresolvedIds) || selected.unresolvedIds.length === 0)) effectiveCommentItems = selected.items;
 		}
 		const fileType = (normalizedDocumentId ? superdocStore.getDocument(normalizedDocumentId) : null)?.type ?? null;
 		let preparedInputs;
@@ -9325,16 +9640,16 @@ var useCommentsStore = defineStore("comments", () => {
 			})) : effectiveCommentItems.filter((item) => !isSyntheticTrackedChangeCommentLaneItem(item)).map((item) => commentsAdapter.mapV2CommentToUseCommentInput(item, {
 				fileId: normalizedDocumentId,
 				fileType
-			})).filter(Boolean);
+			})).filter(isPresent);
 			preparedParams = preparedReview ? preparedReview.trackedChanges.map((params) => ({
 				...params,
 				documentId: normalizedDocumentId
-			})) : trackedChangeItems.map((item) => trackedChangesAdapter.mapV2TrackedChangeToCommentParams(item)).filter(Boolean);
+			})) : trackedChangeItems.map((item) => trackedChangesAdapter.mapV2TrackedChangeToCommentParams(item)).filter(isPresent);
 		} catch (error) {
 			return {
 				ok: false,
 				reason: "mapper-failed",
-				detail: error?.message ?? String(error)
+				detail: errorDetail(error)
 			};
 		}
 		if (typeof patch !== "function") return {
@@ -9362,7 +9677,7 @@ var useCommentsStore = defineStore("comments", () => {
 				params?.trackedChangeCanonicalId,
 				params?.trackedChangeAnchorKey
 			])
-		].map((value) => normalizeCommentId(value)).filter(Boolean));
+		].map((value) => normalizeCommentId(value)).filter(isPresent));
 		patch(() => {
 			const previousPreparedPresentation = committedReviewPresentations.value[normalizedDocumentId] ?? null;
 			if (preparedReview?.presentation) committedReviewPresentations.value = {
@@ -9410,7 +9725,7 @@ var useCommentsStore = defineStore("comments", () => {
 		};
 		const effectiveDocumentId = documentId ?? adapter.documentId ?? null;
 		const normalizedEffectiveDocumentId = effectiveDocumentId != null ? String(effectiveDocumentId) : null;
-		const fileType = (effectiveDocumentId ? superdocStore.getDocument(effectiveDocumentId) : null)?.type ?? null;
+		const fileType = (effectiveDocumentId ? findDocument(effectiveDocumentId) : null)?.type ?? null;
 		const isBlankV2CommentText = (value) => {
 			if (typeof value !== "string") return true;
 			return value.replace(/<[^>]*>/g, "").replace(/&nbsp;/gi, " ").trim().length === 0;
@@ -9430,7 +9745,7 @@ var useCommentsStore = defineStore("comments", () => {
 		const candidateInputs = Array.isArray(preparedInputs) ? preparedInputs : items.filter((item) => !isSyntheticTrackedChangeCommentLaneItem(item)).map((item) => adapter.mapV2CommentToUseCommentInput(item, {
 			fileId: effectiveDocumentId,
 			fileType
-		})).filter(Boolean);
+		})).filter(isPresent);
 		for (const input of candidateInputs) {
 			if (isV2TrackedChangeSidecarCommentInput(input)) {
 				trackedChangeSidecarParentByCommentId.set(String(input.commentId), String(input.trackedChangeThreadParentId));
@@ -9483,7 +9798,7 @@ var useCommentsStore = defineStore("comments", () => {
 			existing.mentions = Array.isArray(input.mentions) ? input.mentions : [];
 			existing.isInternal = typeof input.isInternal === "boolean" ? input.isInternal : existing.isInternal;
 			if (typeof input.resolvedTime === "number") {
-				existing.resolvedTime = input.resolvedTimeWasSynthesized === true && typeof existing.resolvedTime === "number" ? existing.resolvedTime : input.resolvedTime;
+				existing.resolvedTime = input.resolvedTimeWasSynthesized === true && typeof existing.resolvedTime === "number" ? existing.resolvedTime : input.resolvedTime ?? null;
 				existing.resolvedByEmail = input.resolvedByEmail ?? null;
 				existing.resolvedByName = input.resolvedByName ?? null;
 			} else {
@@ -9557,7 +9872,7 @@ var useCommentsStore = defineStore("comments", () => {
 			return {
 				ok: false,
 				reason: "comment-read-failed",
-				detail: err?.message ?? String(err)
+				detail: errorDetail(err)
 			};
 		}
 		if (!isCurrentV2CommentsAdapter(adapter)) return {
@@ -9583,8 +9898,6 @@ var useCommentsStore = defineStore("comments", () => {
 	};
 	/**
 	* Cancel the pending comment
-	*
-	* @returns {void}
 	*/
 	const cancelComment = (superdoc) => {
 		removePendingComment(superdoc);
@@ -9594,9 +9907,6 @@ var useCommentsStore = defineStore("comments", () => {
 	*
 	* Replace-file swaps call this before hydrating the replacement so stale
 	* comments never survive long enough to render beside the new content.
-	*
-	* @param {string | null | undefined} documentId
-	* @returns {void}
 	*/
 	function removeCommentsForDocument(documentId) {
 		const activeDocumentId = documentId != null ? String(documentId) : null;
@@ -9623,139 +9933,20 @@ var useCommentsStore = defineStore("comments", () => {
 		const activeCommentId = activeComment.value != null ? String(activeComment.value) : null;
 		if (activeCommentId && removedAliasIds.has(activeCommentId)) clearActiveCommentSelection();
 	}
-	const getCommentDocumentId = (comment) => {
-		if (!comment) return null;
-		if (comment.fileId != null) return String(comment.fileId);
-		if (comment.documentId != null) return String(comment.documentId);
-		if (comment.selection?.documentId != null) return String(comment.selection.documentId);
-		return null;
-	};
-	const getOpenDocuments = () => {
-		const docs = Array.isArray(superdocStore.documents) ? superdocStore.documents : superdocStore.documents?.value;
-		return Array.isArray(docs) ? docs : [];
-	};
-	const getSingleOpenDocumentId = () => {
-		const docs = getOpenDocuments();
-		if (docs.length !== 1) return null;
-		return docs[0]?.id != null ? String(docs[0].id) : null;
-	};
-	const belongsToDocument = (comment, activeDocumentId, options = {}) => {
-		const { allowSingleDocumentMismatch = false } = options;
-		if (!activeDocumentId) return false;
-		const commentDocumentId = getCommentDocumentId(comment);
-		if (commentDocumentId) {
-			if (commentDocumentId === activeDocumentId) return true;
-			const singleOpenDocumentId = getSingleOpenDocumentId();
-			return allowSingleDocumentMismatch && singleOpenDocumentId === activeDocumentId;
-		}
-		return getSingleOpenDocumentId() === activeDocumentId;
-	};
-	const belongsToTrackedChangeSyncDocument = (comment, activeDocumentId) => {
-		return belongsToDocument(comment, activeDocumentId, { allowSingleDocumentMismatch: true });
-	};
-	const normalizeTrackedChangeDecisionType = (value) => {
-		const lower = typeof value === "string" ? value.toLowerCase() : "";
-		if (!lower) return null;
-		if (lower === "insert" || lower === "insertion" || lower === "trackinsert" || lower === "tableinsert" || lower === "paragraphsplit") return "insertion";
-		if (lower === "delete" || lower === "deletion" || lower === "trackdelete" || lower === "tabledelete") return "deletion";
-		return lower;
-	};
-	const trackedChangeDecisionKeepsCommentAnchor = ({ comment, decision } = {}) => {
-		const normalizedDecision = decision === "accept" || decision === "reject" ? decision : null;
-		if (!normalizedDecision) return false;
-		const type = normalizeTrackedChangeDecisionType(comment?.trackedChangeDisplayType) ?? normalizeTrackedChangeDecisionType(comment?.trackedChangeType);
-		return normalizedDecision === "accept" && type === "insertion" || normalizedDecision === "reject" && type === "deletion";
-	};
-	const getBodyTrackedChangeIdentityIds = (comment) => {
-		return [normalizeCommentId(comment.commentId), ...!normalizeCommentId(comment.trackedChangeCanonicalId) ? [
-			comment.importedId,
-			comment.trackedChangeAnchorKey,
-			...normalizeTrackedChangePositionAliases(comment.trackedChangePositionAliases)
-		] : []].map((id) => normalizeCommentId(id)).filter(Boolean);
-	};
-	const groupBodyTrackedChangeCommentsByIdentity = (comments) => {
-		const parents = comments.map((_, index) => index);
-		const findRoot = (index) => {
-			let root = index;
-			while (parents[root] !== root) root = parents[root];
-			while (parents[index] !== index) {
-				const next = parents[index];
-				parents[index] = root;
-				index = next;
-			}
-			return root;
-		};
-		const join = (left, right) => {
-			const leftRoot = findRoot(left);
-			const rightRoot = findRoot(right);
-			if (leftRoot === rightRoot) return;
-			parents[Math.max(leftRoot, rightRoot)] = Math.min(leftRoot, rightRoot);
-		};
-		const identityOwner = /* @__PURE__ */ new Map();
-		comments.forEach((comment, index) => {
-			getBodyTrackedChangeIdentityIds(comment).forEach((identityId) => {
-				const owner = identityOwner.get(identityId);
-				if (owner === void 0) identityOwner.set(identityId, index);
-				else join(index, owner);
-			});
-		});
-		const groups = /* @__PURE__ */ new Map();
-		comments.forEach((comment, index) => {
-			const root = findRoot(index);
-			const group = groups.get(root) ?? [];
-			group.push(comment);
-			groups.set(root, group);
-		});
-		return groups;
-	};
-	const mergeDuplicateBodyTrackedChangeComments = (groups) => {
-		const duplicates = /* @__PURE__ */ new Map();
-		groups.forEach(([survivor, ...duplicateRows]) => {
-			if (!survivor || duplicateRows.length === 0) return;
-			const resolvedDuplicate = duplicateRows.find((comment) => comment.resolvedTime != null);
-			if (survivor.resolvedTime == null && resolvedDuplicate) {
-				survivor.resolvedTime = resolvedDuplicate.resolvedTime;
-				survivor.resolvedById = resolvedDuplicate.resolvedById;
-				survivor.resolvedByEmail = resolvedDuplicate.resolvedByEmail;
-				survivor.resolvedByName = resolvedDuplicate.resolvedByName;
-				survivor.trackedChangeDecision = resolvedDuplicate.trackedChangeDecision;
-			}
-			survivor.trackedChangePositionAliases = normalizeTrackedChangePositionAliases([...normalizeTrackedChangePositionAliases(survivor.trackedChangePositionAliases), ...duplicateRows.flatMap((comment) => [
-				comment.commentId,
-				comment.importedId,
-				comment.trackedChangeCanonicalId,
-				...normalizeTrackedChangePositionAliases(comment.trackedChangePositionAliases)
-			])]);
-			duplicateRows.forEach((comment) => duplicates.set(comment, survivor));
-		});
-		return duplicates;
-	};
-	const createDroppedCommentIdMap = (duplicates) => {
-		const droppedCommentIds = /* @__PURE__ */ new Map();
-		duplicates.forEach((survivor, duplicate) => {
-			const fromId = normalizeCommentId(duplicate.commentId);
-			const toId = normalizeCommentId(survivor.commentId);
-			if (fromId && toId) droppedCommentIds.set(fromId, toId);
-		});
-		return droppedCommentIds;
-	};
+	const { belongsToDocument, belongsToTrackedChangeSyncDocument } = createCommentDocumentScope(() => superdocStore.documents);
 	const remapTrackedChangeReferences = (droppedCommentIds, activeDocumentId) => {
 		const remapSelection = (selection) => {
 			const selectedId = normalizeCommentId(selection.value);
-			if (selectedId && droppedCommentIds.has(selectedId)) selection.value = droppedCommentIds.get(selectedId);
+			const replacementId = selectedId ? droppedCommentIds.get(selectedId) : void 0;
+			if (replacementId) selection.value = replacementId;
 		};
 		remapSelection(activeComment);
 		remapSelection(activeFloatingCommentInstanceId);
 		commentsList.value.forEach((row) => {
 			if (!belongsToTrackedChangeSyncDocument(row, activeDocumentId)) return;
 			const rowIdentityUpdates = {};
-			for (const field of [
-				"trackedChangeThreadParentId",
-				"trackedChangeParentId",
-				"threadingParentCommentId",
-				"parentCommentId"
-			]) {
-				const replacementId = droppedCommentIds.get(normalizeCommentId(row?.[field]));
+			for (const field of PARENT_LINK_FIELDS) {
+				const replacementId = droppedCommentIds.get(normalizeCommentId(row?.[field]) ?? "");
 				if (!replacementId) continue;
 				row[field] = replacementId;
 				rowIdentityUpdates[field] = replacementId;
@@ -9764,9 +9955,7 @@ var useCommentsStore = defineStore("comments", () => {
 		});
 	};
 	const compactDuplicateBodyTrackedChangeComments = (activeDocumentId) => {
-		const candidates = commentsList.value.filter((comment) => isBodyTrackedChangeComment(comment) && belongsToTrackedChangeSyncDocument(comment, activeDocumentId));
-		const groups = groupBodyTrackedChangeCommentsByIdentity(candidates);
-		const duplicates = mergeDuplicateBodyTrackedChangeComments(groups);
+		const duplicates = mergeDuplicateBodyTrackedChangeComments(groupBodyTrackedChangeCommentsByIdentity(commentsList.value.filter((comment) => isBodyTrackedChangeComment(comment) && belongsToTrackedChangeSyncDocument(comment, activeDocumentId))));
 		if (!duplicates.size) return 0;
 		commentsList.value = commentsList.value.filter((comment) => !duplicates.has(comment));
 		remapTrackedChangeReferences(createDroppedCommentIdMap(duplicates), activeDocumentId);
@@ -9778,10 +9967,6 @@ var useCommentsStore = defineStore("comments", () => {
 	*
 	* Pruning is scoped to the active editor document so replay in one document does not
 	* delete tracked-change comments from other open documents.
-	*
-	* @param {Set<string>} liveTrackedChangeIds IDs currently present in editor marks.
-	* @param {string | null} activeDocumentId Document currently being synced.
-	* @returns {void}
 	*/
 	const pruneStaleTrackedChangeComments = (liveTrackedChangeIds, liveTrackedChangeAnchorKeys, activeDocumentId, superdoc = null, { broadcastChanges = true } = {}) => withInteractionSpan("store.trackedChanges.pruneStaleComments", "store-reconciliation", {
 		activeDocumentId: activeDocumentId ?? null,
@@ -9826,7 +10011,7 @@ var useCommentsStore = defineStore("comments", () => {
 				comment: payload
 			};
 			if (broadcastChanges) {
-				syncCommentsToClients(superdoc, event);
+				syncCommentsToClients(requireHost(superdoc, "pruneStaleTrackedChangeComments"), event);
 				superdoc?.emit?.("comments-update", event);
 			}
 		});
@@ -9858,14 +10043,10 @@ var useCommentsStore = defineStore("comments", () => {
 			const event = {
 				type: COMMENT_EVENTS.DELETED,
 				comment: payload,
-				changes: [{
-					key: "deleted",
-					commentId: payload.commentId,
-					fileId: payload.fileId
-				}]
+				changes: getDeletedCommentChanges([payload, comment], payload.fileId)
 			};
 			if (broadcastChanges) {
-				syncCommentsToClients(superdoc, event);
+				syncCommentsToClients(requireHost(superdoc, "pruneStaleTrackedChangeComments"), event);
 				superdoc?.emit?.("comments-update", event);
 			}
 		});
@@ -9888,7 +10069,6 @@ var useCommentsStore = defineStore("comments", () => {
 		const resolveArgs = {
 			email: superdoc?.user?.email ?? null,
 			name: superdoc?.user?.name ?? null,
-			superdoc,
 			reconciliationToken: COMMENT_RECONCILIATION_TOKEN
 		};
 		let resolvedCount = 0;
@@ -9899,27 +10079,18 @@ var useCommentsStore = defineStore("comments", () => {
 				trackedChangeThreadParentIdForComment(linkedComment),
 				linkedComment.threadingParentCommentId,
 				linkedComment.parentCommentId
-			].map((id) => normalizeCommentId(id)).filter(Boolean).some((id) => trackedChangeIds.has(id))) return;
+			].map((id) => normalizeCommentId(id)).filter(isPresent).some((id) => trackedChangeIds.has(id))) return;
 			if (typeof linkedComment.resolveComment === "function") {
-				linkedComment.resolveComment(resolveArgs);
+				linkedComment.resolveComment({
+					...resolveArgs,
+					superdoc: requireHost(superdoc, "resolveLinkedCommentsForTrackedChangeDecision")
+				});
 				resolvedCount += 1;
 			}
 		});
 		return resolvedCount;
 	};
-	const collectTrackedChangeDecisionIds = (comment) => {
-		const trackedChangeIds = new Set(getCommentAliasIds(comment));
-		if (comment?.trackedChangeCanonicalId != null) trackedChangeIds.add(String(comment.trackedChangeCanonicalId));
-		const anchorKey = comment?.trackedChangeAnchorKey != null ? String(comment.trackedChangeAnchorKey) : null;
-		if (anchorKey) {
-			trackedChangeIds.add(anchorKey);
-			if (anchorKey.startsWith("tc::")) {
-				const rawId = anchorKey.slice(anchorKey.lastIndexOf("::") + 2);
-				if (rawId) trackedChangeIds.add(rawId);
-			}
-		}
-		return trackedChangeIds;
-	};
+	const collectTrackedChangeDecisionIds = (comment) => collectTrackedChangeDecisionIdsWithAliases(comment, getCommentAliasIds(comment));
 	const getTrackedChangeDecisionLinks = (comment) => {
 		const linked = [];
 		const seen = /* @__PURE__ */ new Set();
@@ -9930,28 +10101,6 @@ var useCommentsStore = defineStore("comments", () => {
 		}
 		return linked;
 	};
-	const collectTrackedChangeEntityIdsFromReceipt = (receipt) => {
-		const record = receipt && typeof receipt === "object" ? receipt : null;
-		if (!record?.success) return /* @__PURE__ */ new Set();
-		const ids = /* @__PURE__ */ new Set();
-		const collect = (entry) => {
-			const ref = entry && typeof entry === "object" ? entry : null;
-			if (ref?.kind !== "entity" || ref.entityType !== "trackedChange") return;
-			if (ref.entityId != null && String(ref.entityId).length > 0) ids.add(String(ref.entityId));
-		};
-		if (Array.isArray(record.removed)) record.removed.forEach(collect);
-		if (Array.isArray(record.invalidatedRefs)) record.invalidatedRefs.forEach(collect);
-		return ids;
-	};
-	const collectReliableDecidedTrackedChangeIds = (outcome) => {
-		const ids = /* @__PURE__ */ new Set();
-		if (outcome?.decidedId != null && String(outcome.decidedId).length > 0) ids.add(String(outcome.decidedId));
-		if (Array.isArray(outcome?.decidedIds)) outcome.decidedIds.forEach((id) => {
-			if (id != null && String(id).length > 0) ids.add(String(id));
-		});
-		collectTrackedChangeEntityIdsFromReceipt(outcome?.receipt).forEach((id) => ids.add(id));
-		return ids;
-	};
 	const detachLinkedCommentsForTrackedChangeDecision = ({ comment, decision } = {}) => {
 		if (!comment?.trackedChange) return 0;
 		if (!trackedChangeDecisionKeepsCommentAnchor({
@@ -10032,7 +10181,7 @@ var useCommentsStore = defineStore("comments", () => {
 				if (previousCommentId) anchorSourceIds.add(previousCommentId);
 				if (previousCanonicalId) anchorSourceIds.add(previousCanonicalId);
 			}
-			if (comment.trackedChangeAnchorKey == null || anchorSourceIds.has(currentAnchorParts?.rawId)) comment.trackedChangeAnchorKey = toAnchor;
+			if (comment.trackedChangeAnchorKey == null || anchorSourceIds.has(currentAnchorParts?.rawId ?? "")) comment.trackedChangeAnchorKey = toAnchor;
 			comment.trackedChangePositionAliases = normalizeTrackedChangePositionAliases([...Array.isArray(comment.trackedChangePositionAliases) ? comment.trackedChangePositionAliases : [], fromId]);
 			const identitySourceIds = /* @__PURE__ */ new Set([fromId]);
 			if (advancesRemapLineage) {
@@ -10043,33 +10192,28 @@ var useCommentsStore = defineStore("comments", () => {
 				if (row === comment) return;
 				if (!belongsToTrackedChangeSyncDocument(row, normalizedDocumentId)) return;
 				const rowIdentityUpdates = {};
-				for (const field of [
-					"trackedChangeThreadParentId",
-					"trackedChangeParentId",
-					"threadingParentCommentId",
-					"parentCommentId"
-				]) {
-					if (!identitySourceIds.has(normalizeCommentId(row?.[field]))) continue;
+				for (const field of PARENT_LINK_FIELDS) {
+					if (!identitySourceIds.has(normalizeCommentId(row?.[field]) ?? "")) continue;
 					row[field] = toId;
 					rowIdentityUpdates[field] = toId;
 				}
 				if (Object.keys(rowIdentityUpdates).length && typeof row.updateIdentityValues === "function") row.updateIdentityValues(rowIdentityUpdates);
 			});
 			if (Object.keys(commentIdentityUpdates).length && typeof comment.updateIdentityValues === "function") comment.updateIdentityValues(commentIdentityUpdates);
-			const previousEntry = previousPositionEntry ?? [positions[fromId], positions[buildBodyTrackedChangeAnchorKey(fromId)]].find((entry) => entry && positionEntryMatchesTrackedChangeStory(entry, comment));
+			const previousEntry = previousPositionEntry ?? [positions[fromId], positions[String(buildBodyTrackedChangeAnchorKey(fromId))]].find((entry) => entry && positionEntryMatchesTrackedChangeStory(entry, comment));
 			if (previousEntry) {
-				for (const key of [toId, toAnchor]) if (positions[key] === void 0) {
+				for (const key of [toId, String(toAnchor)]) if (positions[key] === void 0) {
 					positions[key] = previousEntry;
 					positionsChanged = true;
 				}
 			}
-			if (identitySourceIds.has(normalizeCommentId(activeComment.value))) activeComment.value = toId;
-			if (identitySourceIds.has(normalizeCommentId(activeFloatingCommentInstanceId.value))) activeFloatingCommentInstanceId.value = toId;
+			if (identitySourceIds.has(normalizeCommentId(activeComment.value) ?? "")) activeComment.value = toId;
+			if (identitySourceIds.has(normalizeCommentId(activeFloatingCommentInstanceId.value) ?? "")) activeFloatingCommentInstanceId.value = toId;
 		}
 		if (positionsChanged) editorCommentPositions.value = { ...positions };
 	};
 	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 normalizedDecidedIds = new Set((Array.isArray(decidedIds) || decidedIds instanceof Set ? Array.from(decidedIds) : [decidedId]).map((id) => normalizeCommentId(id)).filter(isPresent));
 		const normalizedDocumentId = normalizeCommentId(documentId);
 		if (!normalizedDecidedIds.size || !normalizedDocumentId) return {
 			removed: false,
@@ -10127,39 +10271,8 @@ var useCommentsStore = defineStore("comments", () => {
 			removedIds
 		};
 	};
-	const clearV2ActiveTrackedChangeTarget = (adapter, decidedId) => {
-		if (!decidedId || typeof adapter?.clearActiveTrackedChangeTargetIfMatches !== "function") return;
-		try {
-			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 {}
-	};
 	/**
 	* Accept or reject the tracked change behind a sidebar row.
-	*
-	* @param {Object} param0
-	* @param {Object} param0.superdoc The SuperDoc instance.
-	* @param {Object} param0.comment The tracked-change row.
-	* @param {string} param0.decision `'accept'` or `'reject'`.
-	* @returns {{ ok: boolean, success?: boolean, reason?: string } | Promise<{ ok: boolean, success?: boolean, reason?: string }>} The decision outcome.
 	*/
 	const decideTrackedChangeFromSidebar = ({ superdoc, comment, decision }) => {
 		const disabledReason = trackedChangeDecisionDisabledReason(superdoc);
@@ -10187,7 +10300,7 @@ var useCommentsStore = defineStore("comments", () => {
 						return {
 							ok: false,
 							reason: "adapter-threw",
-							detail: err?.message ?? String(err)
+							detail: errorDetail(err)
 						};
 					}
 				})().then(async (outcome) => {
@@ -10240,9 +10353,11 @@ var useCommentsStore = defineStore("comments", () => {
 		if (!activeEditor) return { ok: false };
 		const id = comment.commentId ?? comment.importedId;
 		if (!id) return { ok: false };
-		const story = comment.trackedChangeStory ?? void 0;
+		const rawStory = comment.trackedChangeStory ?? void 0;
+		const story = isStoryLocator(rawStory) ? rawStory : void 0;
 		const documentApi = typeof activeEditor.doc === "object" ? activeEditor.doc : null;
 		if (documentApi?.trackChanges?.decide) try {
+			if (rawStory && !story) throw new TypeError("trackedChangeStory must be a valid StoryLocator");
 			const target = story ? {
 				id,
 				story
@@ -10255,7 +10370,7 @@ var useCommentsStore = defineStore("comments", () => {
 				success: Boolean(receipt?.success)
 			}));
 		} catch (error) {
-			if (story) return {
+			if (rawStory) return {
 				ok: false,
 				error
 			};
@@ -10302,9 +10417,9 @@ var useCommentsStore = defineStore("comments", () => {
 				documentId: effectiveDocumentId
 			})).removed
 		};
-		const normalizedRemovedIds = new Set(Array.from(removedIds ?? []).map((id) => normalizeCommentId(id)).filter(Boolean));
-		const normalizedUpsertIds = [...new Set(Array.from(upsertIds ?? []).map((id) => normalizeCommentId(id)).filter(Boolean))];
-		const remappedSourceIds = new Set((Array.isArray(remappedPairs) ? remappedPairs : []).map((pair) => normalizeCommentId(pair?.from)).filter(Boolean));
+		const normalizedRemovedIds = new Set(Array.from(removedIds ?? []).map((id) => normalizeCommentId(id)).filter(isPresent));
+		const normalizedUpsertIds = [...new Set(Array.from(upsertIds ?? []).map((id) => normalizeCommentId(id)).filter(isPresent))];
+		const remappedSourceIds = new Set((Array.isArray(remappedPairs) ? remappedPairs : []).map((pair) => normalizeCommentId(pair?.from)).filter(isPresent));
 		const locallyRemovedIds = new Set([...normalizedRemovedIds].filter((id) => !remappedSourceIds.has(id)));
 		if (locallyRemovedIds.size > 0 && effectiveDocumentId != null) pruneDecidedTrackedChangeRow({
 			superdoc,
@@ -10414,23 +10529,24 @@ var useCommentsStore = defineStore("comments", () => {
 			for (const params of paramsList) {
 				if (!params) continue;
 				let retainUnchangedRow = false;
+				const anchorParts = parseTrackedChangeAnchorKey(params.trackedChangeAnchorKey);
+				const anchorStoryKey = anchorParts ? normalizeTrackedChangeStoryKey(anchorParts.storyKey) : void 0;
 				if (preparedPresentation) {
 					if (preparedPresentation !== committedReviewPresentations.value[String(effectiveDocumentId)]) continue;
 					if (params.documentId != null && String(params.documentId) !== String(effectiveDocumentId)) continue;
 					const id = normalizeCommentId(params.changeId);
-					const version = preparedPresentation.rowVersions?.[id];
+					const version = preparedPresentation.rowVersions?.[String(id)] ?? NaN;
 					if (!id || !Number.isSafeInteger(version) || version < 1) continue;
 					const existing = [...trackedChangeIdentityIndex.candidates({ changeId: id })].filter((row) => String(row.fileId) === String(effectiveDocumentId) && String(row.commentId) === id);
 					if (existing.length > 1) continue;
 					const row = existing[0];
 					if (row && row.trackedChangeCanonicalId !== params.trackedChangeCanonicalId) {
-						const previousVersion = previousPreparedPresentation?.rowVersions?.[id];
-						if (!row.trackedChange || params.event !== "add" || typeof params.trackedChangeCanonicalId !== "string" || !params.trackedChangeCanonicalId || !Number.isSafeInteger(previousVersion) || previousVersion < 1 || version <= previousVersion || normalizeTrackedChangeStoryKey(getTrackedChangeStoryKey(row)) !== normalizeTrackedChangeStoryKey(parseTrackedChangeAnchorKey(params.trackedChangeAnchorKey)?.storyKey) || row.trackedChangeType !== params.trackedChangeType || row.trackedChangeDisplayType !== params.trackedChangeDisplayType) continue;
+						const previousVersion = previousPreparedPresentation?.rowVersions?.[id] ?? NaN;
+						if (!row.trackedChange || params.event !== "add" || typeof params.trackedChangeCanonicalId !== "string" || !params.trackedChangeCanonicalId || !Number.isSafeInteger(previousVersion) || previousVersion < 1 || version <= previousVersion || normalizeTrackedChangeStoryKey(getTrackedChangeStoryKey(row)) !== anchorStoryKey || row.trackedChangeType !== params.trackedChangeType || row.trackedChangeDisplayType !== params.trackedChangeDisplayType) continue;
 						row.trackedChangeCanonicalId = params.trackedChangeCanonicalId;
-						row.updateIdentityValues?.({ trackedChangeCanonicalId: params.trackedChangeCanonicalId });
 						trackedChangeIdentityIndex.add(row);
 					}
-					retainUnchangedRow = retainUnchangedRows && row?.trackedChange === true && previousPreparedPresentation.rowVersions?.[id] === version && row.trackedChangeCanonicalId === params.trackedChangeCanonicalId && row.trackedChangeType === params.trackedChangeType && row.trackedChangeDisplayType === params.trackedChangeDisplayType && normalizeTrackedChangeStoryKey(getTrackedChangeStoryKey(row)) === normalizeTrackedChangeStoryKey(parseTrackedChangeAnchorKey(params.trackedChangeAnchorKey)?.storyKey) && !row.resolvedTime && !row.resolvedById && !row.resolvedByEmail && !row.resolvedByName;
+					retainUnchangedRow = retainUnchangedRows === true && row?.trackedChange === true && previousPreparedPresentation.rowVersions?.[id] === version && row.trackedChangeCanonicalId === params.trackedChangeCanonicalId && row.trackedChangeType === params.trackedChangeType && row.trackedChangeDisplayType === params.trackedChangeDisplayType && normalizeTrackedChangeStoryKey(getTrackedChangeStoryKey(row)) === anchorStoryKey && !row.resolvedTime && !row.resolvedById && !row.resolvedByEmail && !row.resolvedByName;
 				}
 				if (params.event === "omit") {
 					if (params.changeId != null) liveIds.add(String(params.changeId));
@@ -10471,22 +10587,18 @@ var useCommentsStore = defineStore("comments", () => {
 		return commentsList.value.filter((comment) => {
 			if (comment?.trackedChange !== true) return false;
 			if (normalizedDocumentId == null) return true;
-			const rowDocumentId = comment?.documentId ?? comment?.fileId ?? null;
+			const rowDocumentId = Reflect.get(comment, "documentId") ?? comment?.fileId ?? null;
 			return rowDocumentId != null && String(rowDocumentId) === normalizedDocumentId;
 		}).length;
 	};
 	/**
 	* Triggered when the editor locations are updated
 	* Updates floating comment locations from the editor
-	*
-	* @param {Object} allCommentPositions The collected geometry keyed by comment / tracked-change id
-	* @param {{ retainMissingTrackedChangeGeometry?: boolean, retainedTrackedChangeIds?: Iterable<string> }} options Geometry reconciliation options
-	* @returns {void}
 	*/
 	const handleEditorLocationsUpdate = (allCommentPositions, options = {}) => {
 		if (allCommentPositions == null) return;
 		const retainMissingTrackedChangeGeometry = options?.retainMissingTrackedChangeGeometry === true;
-		const retainedTrackedChangeIds = retainMissingTrackedChangeGeometry && options?.retainedTrackedChangeIds != null ? new Set(Array.from(options.retainedTrackedChangeIds, (id) => normalizeCommentId(id)).filter(Boolean)) : null;
+		const retainedTrackedChangeIds = retainMissingTrackedChangeGeometry && options?.retainedTrackedChangeIds != null ? new Set(Array.from(options.retainedTrackedChangeIds, (id) => normalizeCommentId(id)).filter(isPresent)) : null;
 		const previousPositions = editorCommentPositions.value || {};
 		const normalizedPositions = {};
 		Object.entries(allCommentPositions).forEach(([key, entry]) => {
@@ -10513,7 +10625,7 @@ var useCommentsStore = defineStore("comments", () => {
 			return null;
 		};
 		const writeTrackedChangeAliases = (entry, comment, extraKeys = []) => {
-			const keys = [...aliasesFor(comment), ...extraKeys.map((id) => normalizeCommentId(id)).filter(Boolean)];
+			const keys = [...aliasesFor(comment), ...extraKeys.map((id) => normalizeCommentId(id)).filter(isPresent)];
 			for (const key of new Set(keys)) if (normalizedPositions[key] === void 0) normalizedPositions[key] = entry;
 		};
 		commentsList.value.forEach((comment) => {
@@ -10712,7 +10824,7 @@ var ellipsis_vertical_solid_default = "<svg xmlns=\"http://www.w3.org/2000/svg\"
 //#region ../../shared/common/icons/rotate-left-solid.svg?raw
 var rotate_left_solid_default = "<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 512 512\"><!--!Font Awesome Free 6.7.2 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free Copyright 2025 Fonticons, Inc.--><path d=\"M48.5 224L40 224c-13.3 0-24-10.7-24-24L16 72c0-9.7 5.8-18.5 14.8-22.2s19.3-1.7 26.2 5.2L98.6 96.6c87.6-86.5 228.7-86.2 315.8 1c87.5 87.5 87.5 229.3 0 316.8s-229.3 87.5-316.8 0c-12.5-12.5-12.5-32.8 0-45.3s32.8-12.5 45.3 0c62.5 62.5 163.8 62.5 226.3 0s62.5-163.8 0-226.3c-62.2-62.2-162.7-62.5-225.3-1L185 183c6.9 6.9 8.9 17.2 5.2 26.2s-12.5 14.8-22.2 14.8L48.5 224z\"/></svg>";
 //#endregion
-//#region src/icons.js
+//#region src/icons.ts
 var superdocIcons = {
 	comment: comment_solid_default,
 	caretDown: caret_down_solid_default,
@@ -11074,12 +11186,9 @@ var InternalDropdown_default = /* @__PURE__ */ _plugin_vue_export_helper_default
 	}
 }), [["__scopeId", "data-v-026f5d66"]]);
 //#endregion
-//#region src/components/CommentsLayer/helpers.js
+//#region src/components/CommentsLayer/helpers.ts
 /**
 * Comments helper to format dates from timestamp
-*
-* @param {Number} timestamp The timestamp to format
-* @returns {String} The formatted date
 */
 function formatDate(timestamp) {
 	const date = new Date(timestamp);
@@ -11677,7 +11786,7 @@ var CommentInput_default = /* @__PURE__ */ _plugin_vue_export_helper_default(/*
 	}
 }), [["__scopeId", "data-v-aa97de44"]]);
 //#endregion
-//#region src/internal/toolbar/built-in/url-safety.js
+//#region src/internal/toolbar/built-in/url-safety.ts
 /**
 * Minimal href sanitizer for the built-in link popover.
 *
@@ -11693,8 +11802,6 @@ var DANGEROUS_SCHEME = /^(javascript|data|vbscript):/i;
 var HAS_SCHEME = /^[a-z][a-z0-9+.-]*:/i;
 /**
 * Validate and normalize an href. Returns `{ href }` for safe values, or `null`.
-* @param {string} value
-* @returns {{ href: string }|null}
 */
 function sanitizeHref(value) {
 	if (typeof value !== "string") return null;
@@ -11706,7 +11813,7 @@ function sanitizeHref(value) {
 	return { href: trimmed };
 }
 //#endregion
-//#region src/components/CommentsLayer/comment-urls.js
+//#region src/components/CommentsLayer/comment-urls.ts
 function isAbsoluteWebUrl(value) {
 	if (!/^https?:\/\/[^\s/?#\\]+/i.test(value) || /[\s\\]/u.test(value)) return false;
 	try {
@@ -11730,7 +11837,7 @@ function trimUrlPunctuation(value) {
 	for (const character of value) {
 		const close = closingDelimiter[character];
 		if (close) balance[close] += 1;
-		else if (Object.hasOwn(balance, character)) balance[character] -= 1;
+		else if (Object.prototype.hasOwnProperty.call(balance, character)) balance[character] -= 1;
 	}
 	let end = value.length;
 	while (end > 0) {
@@ -11754,17 +11861,18 @@ function renderCommentHtml(value) {
 	if (typeof document === "undefined") return value;
 	const template = document.createElement("template");
 	template.innerHTML = value;
-	for (const link of template.content.querySelectorAll("a")) {
-		const safe = sanitizeHref(link.getAttribute("href"));
+	for (const link of Array.from(template.content.querySelectorAll("a"))) {
+		const rawHref = link.getAttribute("href");
+		const safe = rawHref === null ? null : sanitizeHref(rawHref);
 		if (safe && (isAbsoluteWebUrl(safe.href) || /^(mailto|tel):\S+$/i.test(safe.href))) configureLink(link, safe.href);
-		else link.replaceWith(...link.childNodes);
+		else link.replaceWith(...Array.from(link.childNodes));
 	}
 	const walker = document.createTreeWalker(template.content, NodeFilter.SHOW_TEXT);
 	const textNodes = [];
-	while (walker.nextNode()) textNodes.push(walker.currentNode);
+	while (walker.nextNode()) if (walker.currentNode instanceof Text) textNodes.push(walker.currentNode);
 	for (const node of textNodes) {
 		if (node.parentElement?.closest("a, script, style, textarea, code, pre")) continue;
-		const text = node.textContent;
+		const text = node.data;
 		const fragment = document.createDocumentFragment();
 		let end = 0;
 		for (const match of text.matchAll(/(^|[\s([{])(https?:\/\/[^\s<>"']+)/gi)) {
@@ -11823,8 +11931,8 @@ var _hoisted_11$3 = {
 	key: 0,
 	class: "card-section comment-body"
 };
-var _hoisted_12$2 = ["data-track-change-semantic-color-key"];
-var _hoisted_13$2 = { key: 0 };
+var _hoisted_12$3 = ["data-track-change-semantic-color-key"];
+var _hoisted_13$3 = { key: 0 };
 var _hoisted_14$2 = { class: "change-type tracked-change-label" };
 var _hoisted_15$2 = {
 	key: 0,
@@ -12998,7 +13106,7 @@ var CommentDialog_default = /* @__PURE__ */ _plugin_vue_export_helper_default(/*
 								"data-track-change-semantic-color-key": comment.semanticColorKey ?? void 0,
 								ref_for: true,
 								ref: index === 0 ? setParentBodyRef : void 0
-							}, [comment.trackedChangeLabel ? (openBlock(), createElementBlock("div", _hoisted_13$2, [createElementVNode("span", _hoisted_14$2, toDisplayString(comment.trackedChangeLabel), 1), comment.trackedChangeDetailLines && comment.trackedChangeDetailLines.length ? (openBlock(), createElementBlock("div", _hoisted_15$2, [(openBlock(true), createElementBlock(Fragment, null, renderList(comment.trackedChangeDetailLines, (line, lineIndex) => {
+							}, [comment.trackedChangeLabel ? (openBlock(), createElementBlock("div", _hoisted_13$3, [createElementVNode("span", _hoisted_14$2, toDisplayString(comment.trackedChangeLabel), 1), comment.trackedChangeDetailLines && comment.trackedChangeDetailLines.length ? (openBlock(), createElementBlock("div", _hoisted_15$2, [(openBlock(true), createElementBlock(Fragment, null, renderList(comment.trackedChangeDetailLines, (line, lineIndex) => {
 								return openBlock(), createElementBlock("div", {
 									key: lineIndex,
 									class: "tracked-change-detail-line"
@@ -13023,7 +13131,7 @@ var CommentDialog_default = /* @__PURE__ */ _plugin_vue_export_helper_default(/*
 								style: normalizeStyle(trackedChangeImagePreviewStyle(comment.trackedChangeImagePreview)),
 								loading: "lazy",
 								decoding: "async"
-							}, null, 12, _hoisted_38)], 8, _hoisted_37)) : createCommentVNode("", true)], 10, _hoisted_12$2),
+							}, null, 12, _hoisted_38)], 8, _hoisted_37)) : createCommentVNode("", true)], 10, _hoisted_12$3),
 							shouldTruncate.value && isTextOverflowing.value && index === 0 ? (openBlock(), createElementBlock("div", {
 								key: 0,
 								class: "show-more-toggle",
@@ -13117,7 +13225,7 @@ var CommentDialog_default = /* @__PURE__ */ _plugin_vue_export_helper_default(/*
 			], 64))], 14, _hoisted_1$26)), [[_directive_click_outside, handleClickOutside]]);
 		};
 	}
-}), [["__scopeId", "data-v-4220ce17"]]);
+}), [["__scopeId", "data-v-c0cc448b"]]);
 //#endregion
 //#region src/components/CommentsLayer/commentsList/ReviewDirectoryListItem.vue?vue&type=script&setup=true&lang.ts
 var _hoisted_1$25 = [
@@ -13445,21 +13553,25 @@ var commentsList_default = /* @__PURE__ */ _plugin_vue_export_helper_default(/*
 	}
 }), [["__scopeId", "data-v-8eca48e1"]]);
 //#endregion
-//#region src/components/CommentsLayer/commentsList/super-comments-list.js
+//#region src/components/CommentsLayer/commentsList/super-comments-list.ts
+var isReviewDirectoryStore = (value) => isPlainObject$1(value) && typeof value.setReviewDirectoryFromV2 === "function" && typeof value.clearReviewDirectory === "function";
+var readCommentsStore = (superdoc) => {
+	const store = superdoc?.["commentsStore"];
+	return isReviewDirectoryStore(store) ? store : void 0;
+};
 /**
 * Comments list renderer (not floating comments)
 *
 * This renders a list of comments into an element, connected to main SuperDoc instance
 */
 var SuperComments = class extends import_eventemitter3.default {
-	element;
-	config = {
-		comments: [],
-		element: null,
-		commentsStore: null
-	};
 	constructor(options, superdoc) {
 		super();
+		this.config = {
+			comments: [],
+			element: null,
+			commentsStore: null
+		};
 		this.config = {
 			...this.config,
 			...options
@@ -13480,7 +13592,7 @@ var SuperComments = class extends import_eventemitter3.default {
 		this.open();
 	}
 	syncDirectory() {
-		const store = this.superdoc?.commentsStore;
+		const store = readCommentsStore(this.superdoc);
 		if (!store) return;
 		const comments = this.directorySnapshots.comments;
 		const trackChanges = this.directorySnapshots.trackChanges;
@@ -13498,12 +13610,14 @@ var SuperComments = class extends import_eventemitter3.default {
 			const acceptDirectorySnapshot = (snapshot) => {
 				if (generation !== this.directoryGeneration) return;
 				if ((snapshot?.listStatus ?? snapshot?.status) !== "ready") {
-					if (this.superdoc?.commentsStore) this.superdoc.commentsStore.isReviewDirectoryLoading = true;
+					const store = readCommentsStore(this.superdoc);
+					if (store) store.isReviewDirectoryLoading = true;
 					return;
 				}
 				const items = Array.isArray(snapshot.items) ? snapshot.items : [];
 				if (this.directoryItemRefs[family] === items) {
-					if (this.superdoc?.commentsStore) this.superdoc.commentsStore.isReviewDirectoryLoading = this.directorySnapshots.comments == null || this.directorySnapshots.trackChanges == null;
+					const store = readCommentsStore(this.superdoc);
+					if (store) store.isReviewDirectoryLoading = this.directorySnapshots.comments == null || this.directorySnapshots.trackChanges == null;
 					return;
 				}
 				this.directoryItemRefs[family] = items;
@@ -13520,15 +13634,16 @@ var SuperComments = class extends import_eventemitter3.default {
 		};
 		const ui = this.superdoc?.ui;
 		if (!ui) return;
-		if (this.superdoc?.commentsStore) {
-			this.superdoc.commentsStore.isReviewDirectoryActive = true;
-			this.superdoc.commentsStore.isReviewDirectoryLoading = true;
+		const store = readCommentsStore(this.superdoc);
+		if (store) {
+			store.isReviewDirectoryActive = true;
+			store.isReviewDirectoryLoading = true;
 		}
 		this.stopDirectoryObservers = [subscribe(ui.comments, "comments"), subscribe(ui.trackChanges, "trackChanges")];
 	}
 	createVueApp() {
 		this.app = createApp(commentsList_default);
-		const parentProvides = this.superdoc?.app?._context?.provides;
+		const parentProvides = this.superdoc?.["app"]?._context?.provides;
 		if (parentProvides && this.app?._context?.provides) Object.setPrototypeOf(this.app._context.provides, parentProvides);
 		if (this.superdoc?.pinia) {
 			setActivePinia(this.superdoc.pinia);
@@ -13552,10 +13667,11 @@ var SuperComments = class extends import_eventemitter3.default {
 			comments: null,
 			trackChanges: null
 		};
-		if (this.superdoc?.commentsStore) {
-			this.superdoc.commentsStore.clearReviewDirectory();
-			this.superdoc.commentsStore.isReviewDirectoryActive = false;
-			this.superdoc.commentsStore.isReviewDirectoryLoading = false;
+		const store = readCommentsStore(this.superdoc);
+		if (store) {
+			store.clearReviewDirectory();
+			store.isReviewDirectoryActive = false;
+			store.isReviewDirectoryLoading = false;
 		}
 		if (this.app) {
 			this.app.unmount();
@@ -13569,7 +13685,7 @@ var SuperComments = class extends import_eventemitter3.default {
 	}
 };
 //#endregion
-//#region src/composables/use-viewport-fit.js
+//#region src/composables/use-viewport-fit.ts
 var CSS_PX_PER_INCH = 96;
 var SIDEBAR_SELECTOR = ".superdoc__right-sidebar";
 var PDF_PAGE_SELECTOR = ".sd-pdf-viewer-page";
@@ -13674,7 +13790,7 @@ function useViewportFit({ getSuperdoc, superdocContainerWidth, isReady, activeZo
 		const root = superdocRoot.value;
 		if (!root?.querySelectorAll) return null;
 		let widest = 0;
-		for (const page of root.querySelectorAll(PDF_PAGE_SELECTOR)) {
+		for (const page of Array.from(root.querySelectorAll(PDF_PAGE_SELECTOR))) {
 			const measured = Number(page.clientWidth) || Number(page.getBoundingClientRect?.().width) || 0;
 			let scaleFactor = NaN;
 			if (typeof window !== "undefined" && typeof window.getComputedStyle === "function") scaleFactor = Number.parseFloat(window.getComputedStyle(page).getPropertyValue("--scale-factor"));
@@ -13876,124 +13992,6 @@ var composeAuthorColorResolver = (config) => {
 	};
 };
 //#endregion
-//#region ../document-api/src/errors.ts
-/**
-* Structured validation error thrown by document-api execute* functions.
-*
-* Consumers should prefer checking `error.code` over `instanceof` for resilience
-* across package boundaries and bundling scenarios.
-*/
-var DocumentApiValidationError = class DocumentApiValidationError extends Error {
-	constructor(code, message, details) {
-		super(message);
-		this.name = "DocumentApiValidationError";
-		this.code = code;
-		this.details = details;
-		Object.setPrototypeOf(this, DocumentApiValidationError.prototype);
-	}
-};
-//#endregion
-//#region ../document-api/src/export/export.types.ts
-/** Canonical tracked-change export modes accepted by every public export surface. */
-var SD_EXPORT_MODES = [
-	"review-preserving",
-	"final",
-	"original"
-];
-/** Default mode for modeful DOCX export. */
-var DEFAULT_SD_EXPORT_MODE = "review-preserving";
-var SD_COMMENT_EXPORT_POLICIES = [
-	"preserve",
-	"resolve",
-	"remove"
-];
-var SD_CONTENT_CONTROL_EXPORT_POLICIES = ["preserve", "flatten"];
-//#endregion
-//#region ../document-api/src/export/export.ts
-/**
-* Export namespace: engine-agnostic public API and adapter contract.
-*
-* Validates the requested mode at the public boundary so an invalid mode fails
-* closed with `INVALID_INPUT` before any document work happens, then delegates
-* byte production and degradation reporting to the engine adapter.
-*/
-function resolveMode$1(input) {
-	if (input != null && !isRecord(input)) throw new DocumentApiValidationError("INVALID_INPUT", "export.toDocx input must be an object.");
-	const raw = input?.mode;
-	if (raw === void 0) return DEFAULT_SD_EXPORT_MODE;
-	if (typeof raw !== "string" || !SD_EXPORT_MODES.includes(raw)) throw new DocumentApiValidationError("INVALID_INPUT", `export.toDocx mode must be one of: ${SD_EXPORT_MODES.join(", ")}.`, {
-		mode: raw,
-		allowedModes: [...SD_EXPORT_MODES]
-	});
-	return raw;
-}
-function resolveDocxExportPolicies(input = {}) {
-	if (!isRecord(input)) throw new DocumentApiValidationError("INVALID_INPUT", "DOCX export input must be an object.");
-	const mode = resolveMode$1(input);
-	const policies = input.policies;
-	if (policies !== void 0 && !isRecord(policies)) throw new DocumentApiValidationError("INVALID_INPUT", "DOCX export policies must be an object.");
-	const allowed = {
-		trackedChanges: SD_EXPORT_MODES,
-		comments: SD_COMMENT_EXPORT_POLICIES,
-		contentControls: SD_CONTENT_CONTROL_EXPORT_POLICIES
-	};
-	for (const [key, value] of Object.entries(policies ?? {})) if (!Object.prototype.hasOwnProperty.call(allowed, key) || value !== void 0 && !allowed[key].includes(value)) throw new DocumentApiValidationError("INVALID_INPUT", `Unsupported DOCX export policy: ${key}.`, {
-		policy: key,
-		value
-	});
-	const requested = policies;
-	if (input.mode !== void 0 && requested?.trackedChanges !== void 0 && mode !== requested.trackedChanges) throw new DocumentApiValidationError("INVALID_INPUT", "mode conflicts with policies.trackedChanges.");
-	return {
-		trackedChanges: requested?.trackedChanges ?? mode,
-		comments: requested?.comments ?? "preserve",
-		contentControls: requested?.contentControls ?? "preserve"
-	};
-}
-//#endregion
-//#region ../document-api/src/permission-ranges/permission-ranges.ts
-function editorKey(editor) {
-	return editor.id?.trim() ? editor.id : editor.email?.trim() || void 0;
-}
-function editorMatches(editor, id) {
-	return Boolean(id.trim()) && (editor.id === id || Boolean(editor.email?.trim() && editor.email.trim().toLowerCase() === id.toLowerCase()));
-}
-/**
-* Resolve a host ID or imported Word email against an explicitly supplied roster.
-* Word receives the email when available; opaque IDs remain host-specific.
-* Duplicate IDs/emails are ambiguous. This does not authenticate a user.
-*/
-function resolvePermissionRangeEditor(editors, id) {
-	const matches = editors.filter((editor) => editorMatches(editor, id));
-	if (matches.length === 0) return {
-		status: "unknown",
-		id
-	};
-	if (matches.length !== 1) return {
-		status: "ambiguous",
-		id
-	};
-	const editor = matches[0];
-	const wordId = editor.email?.trim() || editor.id;
-	if (editors.filter((candidate) => editorMatches(candidate, wordId)).length !== 1) return {
-		status: "ambiguous",
-		id
-	};
-	return {
-		status: "resolved",
-		id,
-		editor: { ...editor },
-		principal: {
-			kind: "editor",
-			id: wordId
-		}
-	};
-}
-/** Enumerate the host roster for an editor picker, including ambiguous entries. */
-function listPermissionRangeEditors(editors) {
-	const ids = new Set(editors.map(editorKey).filter((id) => id !== void 0));
-	return Array.from(ids, (id) => resolvePermissionRangeEditor(editors, id));
-}
-//#endregion
 //#region src/core/superdoc-ui-owner.ts
 var ownerIds = /* @__PURE__ */ new WeakMap();
 function getSuperDocUiOwnerId(superdoc) {
@@ -15054,7 +15052,7 @@ var FloatingComments_default = /* @__PURE__ */ _plugin_vue_export_helper_default
 			}), 128))], 4)], 36);
 		};
 	}
-}), [["__scopeId", "data-v-aaf2c537"]]);
+}), [["__scopeId", "data-v-df897b8d"]]);
 //#endregion
 //#region src/components/CommentsLayer/PdfCommentsLayer.vue?vue&type=script&setup=true&lang.ts
 var _hoisted_1$22 = {
@@ -15187,7 +15185,7 @@ var PdfCommentsLayer_default = /* @__PURE__ */ _plugin_vue_export_helper_default
 			}), 128))]);
 		};
 	}
-}), [["__scopeId", "data-v-86166837"]]);
+}), [["__scopeId", "data-v-e3ae65fa"]]);
 //#endregion
 //#region src/components/Whiteboard/use-whiteboard.ts
 var useWhiteboard = ({ proxy, layers, documents, modules }) => {
@@ -15481,7 +15479,7 @@ var WhiteboardPage_default = /* @__PURE__ */ _plugin_vue_export_helper_default(/
 			}, null, 44, _hoisted_1$21);
 		};
 	}
-}), [["__scopeId", "data-v-f730b33d"]]);
+}), [["__scopeId", "data-v-fdae8749"]]);
 //#endregion
 //#region src/components/Whiteboard/WhiteboardLayer.vue
 var WhiteboardLayer_default = /* @__PURE__ */ _plugin_vue_export_helper_default(/* @__PURE__ */ defineComponent({
@@ -15552,16 +15550,11 @@ var WhiteboardLayer_default = /* @__PURE__ */ _plugin_vue_export_helper_default(
 			}), 128))], 4);
 		};
 	}
-}), [["__scopeId", "data-v-980e1f94"]]);
+}), [["__scopeId", "data-v-800e1970"]]);
 //#endregion
-//#region src/components/CommentsLayer/collect-removed-comment-ids.js
+//#region src/components/CommentsLayer/collect-removed-comment-ids.ts
 /**
 * Expand deleted comment ids through comment and tracked-change descendants.
-*
-* @param {ReadonlyArray<Record<string, any>>} comments
-* @param {ReadonlyArray<string>} targetIds
-* @param {(comment: Record<string, any>) => boolean} [isInScope]
-* @returns {Set<string>}
 */
 var collectRemovedCommentIds = (comments, targetIds, isInScope = () => true) => {
 	const targets = new Set(targetIds.map(String));
@@ -15644,7 +15637,7 @@ function normalizeCommentsUiConfig(commentsConfig) {
 	return normalized;
 }
 //#endregion
-//#region src/composables/use-comment-small-screen.js
+//#region src/composables/use-comment-small-screen.ts
 var SUPERDOC_DOCUMENT_SELECTOR = ".superdoc__document";
 var isValidCompactBreakpoint = (value) => {
 	return isFiniteNumber(value) && value >= 0;
@@ -15724,10 +15717,11 @@ function useCommentSmallScreen({ commentsModuleConfig, superdocRoot, layers }) {
 		}
 		documentWidthTargets = nextTargets;
 		if (!nextTargets.length) return;
-		documentWidthResizeObserver = new ResizeObserverClass(() => {
+		const observer = new ResizeObserverClass(() => {
 			recalculateCompactCommentsMode();
 		});
-		nextTargets.forEach((el) => documentWidthResizeObserver.observe(el));
+		documentWidthResizeObserver = observer;
+		nextTargets.forEach((el) => observer.observe(el));
 	};
 	const getMeasuredDocumentWidth = () => {
 		ensureDocumentWidthObserver();
@@ -15783,7 +15777,7 @@ function useCommentSmallScreen({ commentsModuleConfig, superdocRoot, layers }) {
 	};
 }
 //#endregion
-//#region src/composables/use-compact-comment-popover.js
+//#region src/composables/use-compact-comment-popover.ts
 var POPOVER_WIDTH_PX = 320;
 var SAFE_MARGIN_PX = 12;
 var MIN_BOTTOM_SPACE_PX = 220;
@@ -15813,7 +15807,7 @@ var resolveInteractionAnchor = (lastClickAnchor) => {
 var resolveInlineHighlightAnchorRect = ({ rootEl, comment, pendingComment }) => {
 	if (Boolean(pendingComment?.value && comment?.commentId === pendingComment.value?.commentId)) {
 		const nodes = rootEl.querySelectorAll(COMMENT_HIGHLIGHT_SELECTOR);
-		for (const node of nodes) {
+		for (const node of Array.from(nodes)) {
 			if (!parseCommentIds(node.getAttribute(COMMENT_HIGHLIGHT_DATA_ATTR)).includes("pending")) continue;
 			if (typeof node.getBoundingClientRect !== "function") continue;
 			return node.getBoundingClientRect();
@@ -15823,7 +15817,7 @@ var resolveInlineHighlightAnchorRect = ({ rootEl, comment, pendingComment }) =>
 	if (!anchorId) return null;
 	const safeId = String(anchorId);
 	const highlightNodes = rootEl.querySelectorAll(COMMENT_HIGHLIGHT_SELECTOR);
-	for (const node of highlightNodes) {
+	for (const node of Array.from(highlightNodes)) {
 		if (!parseCommentIds(node.getAttribute(COMMENT_HIGHLIGHT_DATA_ATTR)).includes(safeId)) continue;
 		if (typeof node.getBoundingClientRect !== "function") continue;
 		return node.getBoundingClientRect();
@@ -15908,9 +15902,10 @@ function useCompactCommentPopover({ activeComment, pendingComment, activeCompact
 	};
 	const trackCompactPopoverClickAnchor = (e) => {
 		const root = superdocRoot.value;
-		if (!root || !layers.value?.contains(e.target)) return;
-		const anchorElement = (typeof document.elementsFromPoint === "function" ? document.elementsFromPoint(e.clientX, e.clientY) : []).find((node) => node?.nodeType === 1 && root.contains(node) && node.closest("[data-track-change-id], .superdoc-comment-highlight, .sd-comment-anchor"))?.closest("[data-track-change-id], .superdoc-comment-highlight, .sd-comment-anchor") ?? (e.target?.nodeType === 1 ? e.target.closest("[data-track-change-id], .superdoc-comment-highlight, .sd-comment-anchor") : null);
-		if (clearCompactPopoverIfPdfClickedOutside(root, e.target, anchorElement)) return;
+		const target = e.target instanceof Node ? e.target : null;
+		if (!root || !layers.value?.contains(target)) return;
+		const anchorElement = (typeof document.elementsFromPoint === "function" ? document.elementsFromPoint(e.clientX, e.clientY) : []).find((node) => node?.nodeType === 1 && root.contains(node) && node.closest("[data-track-change-id], .superdoc-comment-highlight, .sd-comment-anchor"))?.closest("[data-track-change-id], .superdoc-comment-highlight, .sd-comment-anchor") ?? (target instanceof Element ? target.closest("[data-track-change-id], .superdoc-comment-highlight, .sd-comment-anchor") : null);
+		if (clearCompactPopoverIfPdfClickedOutside(root, target, anchorElement)) return;
 		if (e.button !== 0 || e.pointerType !== "mouse") return;
 		const anchorRect = anchorElement && typeof anchorElement.getBoundingClientRect === "function" ? anchorElement.getBoundingClientRect() : null;
 		if (!anchorRect) return;
@@ -16144,7 +16139,7 @@ function normalizeHyperlinksConfig(config = {}) {
 	};
 }
 //#endregion
-//#region src/helpers/v2-review-target.js
+//#region src/helpers/v2-review-target.ts
 /**
 * Resolve the comments-store identity for a document-origin v2 review target.
 * Painted review carriers can become interactive before the asynchronous row
@@ -16160,15 +16155,126 @@ function resolveV2ReviewTargetCommentId(target, getComment) {
 	return commentId != null ? String(commentId) : null;
 }
 //#endregion
-//#region src/helpers/v2-mutation-exception.js
+//#region src/helpers/v2-review-geometry-delivery.ts
+function createReviewGeometryDelivery(deliver) {
+	const packets = /* @__PURE__ */ new Map();
+	let stageOwners = /* @__PURE__ */ new WeakMap();
+	let active = null;
+	const documentOf = (current) => current.documentId != null ? String(current.documentId) : current.mountContainer?.dataset.superdocV2DocumentId ?? null;
+	const matches = (documentId, current) => current.mountContainer?.dataset.superdocV2DocumentId === documentId && (current.documentId == null || String(current.documentId) === documentId);
+	const matchesPaint = (packet, current) => typeof packet.payload.paintEpoch !== "number" || packet.payload.paintEpoch === current.epoch;
+	const observe = (current) => {
+		const stage = current.mountContainer;
+		const documentId = documentOf(current);
+		if (!stage || !documentId || !matches(documentId, current)) return;
+		const previousOwner = stageOwners.get(stage);
+		if (previousOwner && previousOwner !== documentId) packets.delete(previousOwner);
+		stageOwners.set(stage, documentId);
+		const packet = packets.get(documentId);
+		if (packet?.stage && packet.stage !== stage) packets.delete(documentId);
+		else if (packet && (!active || active.stage !== stage || active.documentId !== documentId || active.epoch !== current.epoch)) packet.delivered = false;
+		active = {
+			documentId,
+			stage,
+			epoch: current.epoch
+		};
+	};
+	const dispatch = (documentId, packet, current, replay = false) => {
+		if (!current.mountContainer || !matches(documentId, current) || !matchesPaint(packet, current)) return false;
+		if (packet.stage && packet.stage !== current.mountContainer || packet.delivering || packet.delivered && !replay) return false;
+		const wasDelivered = packet.delivered;
+		const previousStage = packet.stage;
+		packet.stage = current.mountContainer;
+		packet.delivered = true;
+		packet.delivering = true;
+		try {
+			deliver(current, packet.payload);
+		} catch (error) {
+			packet.delivered = wasDelivered;
+			packet.stage = previousStage;
+			throw error;
+		} finally {
+			packet.delivering = false;
+		}
+		return true;
+	};
+	const notify = (documentId, payload, current, ready = true) => {
+		if (!payload.reviewGeometry || !Array.isArray(payload.pageIndices)) return false;
+		let key;
+		try {
+			key = JSON.stringify([
+				documentId,
+				payload.documentEpoch,
+				payload.paintEpoch,
+				payload.commitSequence,
+				payload.pageIndices,
+				payload.zoomScale,
+				payload.reviewGeometry
+			]);
+		} catch {
+			return false;
+		}
+		const isCurrent = current != null && matches(documentId, current);
+		if (isCurrent) observe(current);
+		const previous = packets.get(documentId);
+		if (previous && previous.payload.documentEpoch === payload.documentEpoch && typeof previous.payload.paintEpoch === "number" && typeof payload.paintEpoch === "number" && payload.paintEpoch < previous.payload.paintEpoch) return false;
+		if (previous && previous.payload.documentEpoch === payload.documentEpoch && typeof previous.payload.commitSequence === "number" && typeof payload.commitSequence === "number" && payload.commitSequence < previous.payload.commitSequence) return false;
+		if (previous && previous.payload.documentEpoch === payload.documentEpoch && typeof previous.payload.generation === "number" && typeof payload.generation === "number" && payload.generation < previous.payload.generation) return false;
+		if (isCurrent && typeof payload.paintEpoch === "number" && typeof current.epoch === "number" && payload.paintEpoch < current.epoch) return false;
+		if (previous?.key === key) {
+			previous.payload = payload;
+			return isCurrent && ready ? dispatch(documentId, previous, current) : false;
+		}
+		const packet = {
+			payload,
+			key,
+			stage: isCurrent ? current.mountContainer : previous && previous.payload.documentEpoch === payload.documentEpoch ? previous.stage : null,
+			delivered: false,
+			delivering: false
+		};
+		packets.set(documentId, packet);
+		if (!isCurrent || !ready) return false;
+		try {
+			return dispatch(documentId, packet, current);
+		} catch (error) {
+			if (previous) packets.set(documentId, previous);
+			else packets.delete(documentId);
+			throw error;
+		}
+	};
+	return {
+		notify,
+		observe,
+		flush(current) {
+			observe(current);
+			const documentId = documentOf(current);
+			const packet = documentId == null ? null : packets.get(documentId);
+			return documentId && packet ? dispatch(documentId, packet, current) : false;
+		},
+		replay(current) {
+			observe(current);
+			const documentId = documentOf(current);
+			const packet = documentId == null ? null : packets.get(documentId);
+			return documentId && packet ? dispatch(documentId, packet, current, true) : false;
+		},
+		reset() {
+			packets.clear();
+			stageOwners = /* @__PURE__ */ new WeakMap();
+			active = null;
+		}
+	};
+}
+//#endregion
+//#region src/helpers/v2-mutation-exception.ts
 var FAILURE_SOURCES = /* @__PURE__ */ new Set(["shell", "receipt"]);
 var DIAGNOSTIC_CODE = /^[a-zA-Z][a-zA-Z0-9_-]{0,127}$/;
 var COMMAND_KIND = /^[a-z][a-z0-9-]*(?::[a-z][a-z0-9-]*)?$/;
 function createV2MutationRejectionCause(event) {
-	if (!event || typeof event !== "object") return {};
-	const reason = event.reason ?? (event.failureSource === "receipt" ? event.failure?.code : void 0);
+	if (!isPlainObject$1(event)) return {};
+	const failure = isPlainObject$1(event.failure) ? event.failure : void 0;
+	const reason = event.reason ?? (event.failureSource === "receipt" ? failure?.code : void 0);
 	return {
-		...FAILURE_SOURCES.has(event.failureSource) ? { failureSource: event.failureSource } : {},
+		...typeof event.failureSource === "string" && FAILURE_SOURCES.has(event.failureSource) ? { failureSource: event.failureSource } : {},
 		...typeof reason === "string" && DIAGNOSTIC_CODE.test(reason) ? { reason } : {},
 		...typeof event.inputKind === "string" && DIAGNOSTIC_CODE.test(event.inputKind) ? { inputKind: event.inputKind } : {},
 		...typeof event.editableCommandKind === "string" && event.editableCommandKind.length <= 128 && COMMAND_KIND.test(event.editableCommandKind) ? { editableCommandKind: event.editableCommandKind } : {}
@@ -16196,7 +16302,7 @@ function createV2MutationRejectionNotificationGate(matches) {
 	};
 }
 //#endregion
-//#region src/helpers/v2-author-required-rejection.js
+//#region src/helpers/v2-author-required-rejection.ts
 var NO_AUTHOR_SIGNAL = "no-author-configured";
 /** Stable, non-terminal exception code surfaced to consumers. */
 var V2_AUTHOR_REQUIRED_CODE = "author-required";
@@ -16208,15 +16314,11 @@ var V2_AUTHOR_REQUIRED_MESSAGE = "This edit needs an author identity. Set `user.
 function messageHasNoAuthorSignal(message) {
 	return typeof message === "string" && message.includes(NO_AUTHOR_SIGNAL);
 }
-/**
-* @param {any} event - a `v2-host-event` payload.
-* @returns {boolean} true when the rejection means the session needs an author.
-*/
 function isV2AuthorRequiredRejection(event) {
-	if (!event || event.type !== "mutation:rejected") return false;
+	if (!isPlainObject$1(event) || event.type !== "mutation:rejected") return false;
 	if (event.failureSource === "receipt") {
 		const failure = event.failure;
-		if (!failure) return false;
+		if (!isPlainObject$1(failure)) return false;
 		return failure.code === "PRECONDITION_FAILED" && messageHasNoAuthorSignal(failure.message);
 	}
 	if (event.failureSource === "shell") {
@@ -16229,7 +16331,7 @@ function createV2AuthorRequiredNotificationGate() {
 	return createV2MutationRejectionNotificationGate(isV2AuthorRequiredRejection);
 }
 //#endregion
-//#region src/helpers/v2-bulk-decision-event.js
+//#region src/helpers/v2-bulk-decision-event.ts
 function toV2BulkDecisionEvent(documentId, fact) {
 	if (fact?.schemaVersion !== 1 || fact.decision !== "accept" && fact.decision !== "reject") return null;
 	return {
@@ -16241,7 +16343,7 @@ function toV2BulkDecisionEvent(documentId, fact) {
 	};
 }
 //#endregion
-//#region src/helpers/v2-keyboard-edit-rejection.js
+//#region src/helpers/v2-keyboard-edit-rejection.ts
 var EDIT_INPUT_KINDS = /* @__PURE__ */ new Set([
 	"keydown",
 	"beforeinput",
@@ -16291,7 +16393,7 @@ var EDIT_FAILURE_SOURCES = /* @__PURE__ */ new Set(["shell", "receipt"]);
 var V2_EDIT_REJECTED_CODE = "edit-rejected";
 var V2_EDIT_REJECTED_MESSAGE = "This edit couldn’t be completed. Adjust the selection and try again.";
 function isV2KeyboardEditRejection(event) {
-	return Boolean(event && event.type === "mutation:rejected" && event.origin === "document-surface" && EDIT_FAILURE_SOURCES.has(event.failureSource) && EDIT_INPUT_KINDS.has(event.inputKind) && (EDIT_COMMAND_KINDS.has(event.editableCommandKind) || event.editableCommandKind == null && EDIT_INPUT_WITHOUT_COMMAND_KINDS.has(event.inputKind)));
+	return isPlainObject$1(event) && event.type === "mutation:rejected" && event.origin === "document-surface" && EDIT_FAILURE_SOURCES.has(event.failureSource) && EDIT_INPUT_KINDS.has(event.inputKind) && (EDIT_COMMAND_KINDS.has(event.editableCommandKind) || event.editableCommandKind == null && EDIT_INPUT_WITHOUT_COMMAND_KINDS.has(event.inputKind));
 }
 function createV2KeyboardEditRejectionException(documentId, event) {
 	return {
@@ -16305,24 +16407,17 @@ function createV2KeyboardEditRejectionNotificationGate() {
 	return createV2MutationRejectionNotificationGate(isV2KeyboardEditRejection);
 }
 //#endregion
-//#region src/helpers/v2-selection-sync.js
+//#region src/helpers/v2-selection-sync.ts
 /**
 * A logical v2 selection snapshot represents a non-empty range when its anchor
 * and focus point at different block positions. Mirrors the range check the v2
 * shell uses when it emits `v2-selection-changed`.
-*
-* @param {{ anchor?: { blockId?: unknown, blockOffset?: unknown }, focus?: { blockId?: unknown, blockOffset?: unknown } } | null | undefined} snapshot
-* @returns {boolean}
 */
 var isV2RangeSnapshot = (snapshot) => Boolean(snapshot?.anchor && snapshot?.focus && (snapshot.anchor.blockId !== snapshot.focus.blockId || snapshot.anchor.blockOffset !== snapshot.focus.blockOffset));
 /**
 * Detect a real browser text selection whose endpoints are outside the active
 * v2 mount. Editable host selections can have no native DOM range, so an
 * absent range must not count as an outside selection.
-*
-* @param {Selection | null | undefined} selection
-* @param {Node | null | undefined} root
-* @returns {boolean}
 */
 var hasOutsideV2DomRangeSelection = (selection, root) => {
 	if (!selection || selection.rangeCount < 1 || selection.isCollapsed || !root) return false;
@@ -16338,10 +16433,6 @@ var hasOutsideV2DomRangeSelection = (selection, root) => {
 * host snapshot rather than clobber the selection the host just published.
 * Only editable modes use the host snapshot. Viewing mode keeps native DOM
 * selection, and unknown modes should not preserve stale host state.
-*
-* @param {string | null | undefined} documentMode
-* @param {unknown} hostSnapshot
-* @returns {boolean}
 */
 var shouldPreserveHostV2Selection = (documentMode, hostSnapshot) => {
 	if (documentMode !== "editing" && documentMode !== "suggesting") return false;
@@ -16352,10 +16443,6 @@ var shouldPreserveHostV2Selection = (documentMode, hostSnapshot) => {
 * rebuilt. Keep an already-positioned comment affordance during that gap when
 * the host still owns a range; otherwise the button unmounts and remounts on
 * consecutive paint frames, making it blink and intercepting its own click.
-*
-* @param {boolean} hasHostRange
-* @param {{ source?: unknown } | null | undefined} selectionPosition
-* @returns {boolean}
 */
 var shouldRetainV2FloatingSelection = (hasHostRange, selectionPosition) => hasHostRange === true && selectionPosition?.source === "document-editor";
 //#endregion
@@ -16547,7 +16634,7 @@ function usePasswordPrompt({ getSurfaceManager, getPasswordPromptConfig, onUnhan
 				})
 			});
 		} else {
-			const mod = await import("./chunks/PasswordPromptSurface-6mF6Azda.es.js");
+			const mod = await import("./chunks/PasswordPromptSurface-DjV1JgjD.es.js");
 			const surfaceId = `password-prompt-${doc.id}`;
 			handle = manager.open({
 				id: surfaceId,
@@ -16649,9 +16736,6 @@ function createReplaceContinuation(session, { getCurrentSession, applySlice, onS
 }
 //#endregion
 //#region src/composables/use-find-replace.ts
-function isThenable$2(value) {
-	return (typeof value === "object" || typeof value === "function") && value !== null && "then" in value && typeof value.then === "function";
-}
 var DEFAULT_TEXTS = {
 	findPlaceholder: "Find",
 	findAriaLabel: "Find text",
@@ -16826,7 +16910,7 @@ function useFindReplace({ getSurfaceManager, getActiveEditor, activeEditorRef, g
 		try {
 			result = search.replace(replaceText.value);
 		} catch {}
-		if (isThenable$2(result)) Promise.resolve(result).then(finish, finish);
+		if (isThenable$1(result)) Promise.resolve(result).then(finish, finish);
 		else finish();
 	}
 	function replaceAll() {
@@ -16848,7 +16932,7 @@ function useFindReplace({ getSurfaceManager, getActiveEditor, activeEditorRef, g
 		try {
 			result = search.replaceAll(replaceText.value);
 		} catch {}
-		if (isThenable$2(result)) Promise.resolve(result).then(finish, finish);
+		if (isThenable$1(result)) Promise.resolve(result).then(finish, finish);
 		else finish();
 	}
 	function syncFromSearchSession() {
@@ -17210,7 +17294,7 @@ function useFindReplace({ getSurfaceManager, getActiveEditor, activeEditorRef, g
 			} else {
 				let FindReplaceSurface;
 				try {
-					FindReplaceSurface = (await import("./chunks/FindReplaceSurface-BKVHzhQ4.es.js")).default;
+					FindReplaceSurface = (await import("./chunks/FindReplaceSurface-BEnRLpD9.es.js")).default;
 				} catch {
 					opening = false;
 					return;
@@ -17477,7 +17561,7 @@ var plus_solid_default = "<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0
 //#region ../../shared/common/icons/trash-can-solid.svg?raw
 var trash_can_solid_default = "<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 448 512\"><!--!Font Awesome Free 6.7.2 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free Copyright 2025 Fonticons, Inc.--><path d=\"M135.2 17.7C140.6 6.8 151.7 0 163.8 0L284.2 0c12.1 0 23.2 6.8 28.6 17.7L320 32l96 0c17.7 0 32 14.3 32 32s-14.3 32-32 32L32 96C14.3 96 0 81.7 0 64S14.3 32 32 32l96 0 7.2-14.3zM32 128l384 0 0 320c0 35.3-28.7 64-64 64L96 512c-35.3 0-64-28.7-64-64l0-320zm96 64c-8.8 0-16 7.2-16 16l0 224c0 8.8 7.2 16 16 16s16-7.2 16-16l0-224c0-8.8-7.2-16-16-16zm96 0c-8.8 0-16 7.2-16 16l0 224c0 8.8 7.2 16 16 16s16-7.2 16-16l0-224c0-8.8-7.2-16-16-16zm96 0c-8.8 0-16 7.2-16 16l0 224c0 8.8 7.2 16 16 16s16-7.2 16-16l0-224c0-8.8-7.2-16-16-16z\"/></svg>";
 //#endregion
-//#region src/internal/toolbar/built-in/toolbarIcons.js
+//#region src/internal/toolbar/built-in/toolbarIcons.ts
 var toolbarIcons = {
 	undo: rotate_left_solid_default,
 	redo: rotate_right_solid_default,
@@ -17584,11 +17668,11 @@ var _hoisted_8$3 = { class: "input-row url-input-row" };
 var _hoisted_9$2 = ["innerHTML"];
 var _hoisted_10$2 = ["readonly", "onKeydown"];
 var _hoisted_11$2 = ["innerHTML"];
-var _hoisted_12$1 = {
+var _hoisted_12$2 = {
 	key: 0,
 	class: "input-row link-buttons"
 };
-var _hoisted_13$1 = ["disabled"];
+var _hoisted_13$2 = ["disabled"];
 var _hoisted_14$1 = ["innerHTML"];
 var _hoisted_15$1 = ["disabled"];
 var _hoisted_16$1 = {
@@ -17847,7 +17931,7 @@ var LinkInput_default = /* @__PURE__ */ _plugin_vue_export_helper_default(/* @__
 							"data-item": "btn-link-open"
 						}, null, 10, _hoisted_11$2)
 					]),
-					!isViewingMode.value ? (openBlock(), createElementBlock("div", _hoisted_12$1, [isEditing.value ? (openBlock(), createElementBlock("button", {
+					!isViewingMode.value ? (openBlock(), createElementBlock("div", _hoisted_12$2, [isEditing.value ? (openBlock(), createElementBlock("button", {
 						key: 0,
 						class: "remove-btn",
 						onClick: handleRemove,
@@ -17856,7 +17940,7 @@ var LinkInput_default = /* @__PURE__ */ _plugin_vue_export_helper_default(/* @__
 					}, [createElementVNode("div", {
 						class: "remove-btn__icon",
 						innerHTML: unref(toolbarIcons).removeLink
-					}, null, 8, _hoisted_14$1), _cache[6] || (_cache[6] = createTextVNode(" Remove ", -1))], 8, _hoisted_13$1)) : createCommentVNode("", true), createElementVNode("button", {
+					}, null, 8, _hoisted_14$1), _cache[6] || (_cache[6] = createTextVNode(" Remove ", -1))], 8, _hoisted_13$2)) : createCommentVNode("", true), createElementVNode("button", {
 						class: normalizeClass(["sd-submit-btn", { "disable-btn": isDisabled.value }]),
 						onClick: handleSubmit,
 						disabled: isSubmitting.value,
@@ -17870,7 +17954,7 @@ var LinkInput_default = /* @__PURE__ */ _plugin_vue_export_helper_default(/* @__
 	}
 }), [["__scopeId", "data-v-172107e4"]]);
 //#endregion
-//#region src/internal/toolbar/built-in/scroll-helpers.js
+//#region src/internal/toolbar/built-in/scroll-helpers.ts
 function getScrollableParent(element) {
 	let currentElement = element;
 	while (currentElement) {
@@ -17903,7 +17987,6 @@ function scrollToElement(targetElement, options = {
 var FLOATING_SURFACE_ID = "link-popover";
 var RECENT_OUTSIDE_CLOSE_MS = 500;
 var MAX_ANCHOR_NAVIGATION_STEPS = 4;
-var isThenable$1 = (value) => Boolean(value && (typeof value === "object" || typeof value === "function") && "then" in value && typeof value.then === "function");
 function isLinkPopoverDocumentApi(value) {
 	return isPlainObject$1(value) || typeof value === "function";
 }
@@ -18767,6 +18850,7 @@ function createV2EditorRuntimeAdapter(options) {
 	const { id, documentId, root, host, getLegacyEditorProjection, onUnregister } = options;
 	let snapshot = host.getSnapshot();
 	let didDispose = false;
+	let detached = false;
 	let unregistered = false;
 	let mountedFocusHandle = null;
 	let tokenRevision = 0;
@@ -19063,7 +19147,17 @@ function createV2EditorRuntimeAdapter(options) {
 			};
 		}
 	}
+	function releaseHostSubscriptions() {
+		hostUnsubscribe?.();
+		hostUnsubscribe = null;
+		pageMetricsUnsubscribe?.();
+		pageMetricsUnsubscribe = null;
+		selectionUnsubscribe?.();
+		selectionUnsubscribe = null;
+		activeSelectionController = null;
+	}
 	function handleHostSnapshot(next) {
+		if (detached || didDispose) return;
 		snapshot = next;
 		invalidatePositionTokens();
 		syncSelectionSubscription();
@@ -19077,10 +19171,7 @@ function createV2EditorRuntimeAdapter(options) {
 		});
 		if (next.state === "disposed" && !didDispose) {
 			didDispose = true;
-			hostUnsubscribe?.();
-			pageMetricsUnsubscribe?.();
-			selectionUnsubscribe?.();
-			selectionUnsubscribe = null;
+			releaseHostSubscriptions();
 			emit({ type: "disposed" });
 			listeners.clear();
 			if (!unregistered) {
@@ -19227,10 +19318,7 @@ function createV2EditorRuntimeAdapter(options) {
 		await host.dispose();
 		if (!didDispose) {
 			didDispose = true;
-			hostUnsubscribe?.();
-			pageMetricsUnsubscribe?.();
-			selectionUnsubscribe?.();
-			selectionUnsubscribe = null;
+			releaseHostSubscriptions();
 			emit({ type: "disposed" });
 			listeners.clear();
 			if (!unregistered) {
@@ -19309,8 +19397,17 @@ function createV2EditorRuntimeAdapter(options) {
 			}
 		},
 		attachMountHandle(handle) {
+			if (detached || didDispose) return;
 			mountedFocusHandle = handle;
 			syncSelectionSubscription();
+		},
+		detach() {
+			if (detached) return;
+			detached = true;
+			unregistered = true;
+			releaseHostSubscriptions();
+			mountedFocusHandle = null;
+			listeners.clear();
 		}
 	};
 }
@@ -20473,7 +20570,7 @@ var SuperDoc_default = /* @__PURE__ */ _plugin_vue_export_helper_default(/* @__P
 	__name: "SuperDoc",
 	emits: ["selection-update"],
 	setup(__props, { emit: __emit }) {
-		const PdfViewer = defineAsyncComponent(() => import("./chunks/PdfViewer-aOWhUVI7.es.js"));
+		const PdfViewer = defineAsyncComponent(() => import("./chunks/PdfViewer-C2r-K8zC.es.js"));
 		const getDocumentLoadPassword = (doc) => doc.password ?? proxy.$superdoc.config.password;
 		const resolveDocumentV2Collaboration = (doc) => {
 			const rawConfig = doc?.v2Collaboration;
@@ -20587,6 +20684,8 @@ var SuperDoc_default = /* @__PURE__ */ _plugin_vue_export_helper_default(/* @__P
 		const v2ReviewSidebarUnlocked = ref(false);
 		const v2GeometryEpoch = ref(null);
 		let v2GeometryRafHandle = 0;
+		let v2GeometryReplayRafHandle = 0;
+		let v2GeometryReplayGeneration = 0;
 		let v2TrackedChangeRestampRetainPaints = 0;
 		let v2TrackedChangeRestampRetentionReason = null;
 		const activeEditorRef = computed$1(() => proxy.$superdoc.activeEditor);
@@ -20770,6 +20869,7 @@ var SuperDoc_default = /* @__PURE__ */ _plugin_vue_export_helper_default(/* @__P
 			if (document && provider?.sendStateless) document.provider = null;
 			const entry = v2Runtimes.get(documentId);
 			if (!entry) return;
+			entry.adapter.detach();
 			proxy.$superdoc["unregisterEditorRuntime"](entry.runtimeId);
 			v2Runtimes.delete(documentId);
 			const hostRoot = subDocumentRoots.get(documentId);
@@ -21276,7 +21376,7 @@ var SuperDoc_default = /* @__PURE__ */ _plugin_vue_export_helper_default(/* @__P
 		let v2SelectionToolbarRafHandle = 0;
 		let v2SelectionToolbarTimeoutHandle = 0;
 		let v2DomSelectionRafHandle = 0;
-		const buildV2EditorUpdatePayload = ({ editor, sourceEditor, surface = "body", headerId = null, sectionType = null } = {}) => {
+		const buildV2EditorUpdatePayload = ({ editor, sourceEditor, surface = "body", headerId = null, sectionType = null, isRemote = false } = {}) => {
 			const activeEditor = proxy.$superdoc?.activeEditor ?? null;
 			const effectiveEditor = editor ?? sourceEditor ?? activeEditor ?? void 0;
 			return {
@@ -21284,7 +21384,8 @@ var SuperDoc_default = /* @__PURE__ */ _plugin_vue_export_helper_default(/* @__P
 				sourceEditor: sourceEditor ?? effectiveEditor,
 				surface,
 				headerId,
-				sectionType
+				sectionType,
+				isRemote
 			};
 		};
 		const emitV2EditorUpdate = (payload = {}) => {
@@ -21538,6 +21639,7 @@ var SuperDoc_default = /* @__PURE__ */ _plugin_vue_export_helper_default(/* @__P
 				pending: entry
 			});
 		};
+		let scheduleV2GeometryReplay = () => {};
 		const v2GeometryPublisher = resolvedEditorIntegration.createGeometryPublisher({
 			getLayersContainer: () => layers.value ?? null,
 			isCommentsEnabled: () => Boolean(commentsModuleConfig.value) && shouldRenderCommentsInViewing.value,
@@ -21553,7 +21655,8 @@ var SuperDoc_default = /* @__PURE__ */ _plugin_vue_export_helper_default(/* @__P
 					v2ReviewSidebarUnlocked.value = true;
 					v2GeometryEpoch.value = v2GeometryPublisher.getLastEpoch();
 				}
-			}
+			},
+			onCommittedPagePaint: ({ payload }) => scheduleV2GeometryReplay(payload)
 		});
 		const armV2TrackedChangeRestampGeometryRetention = (reason = "tracked-change-restamp") => {
 			v2TrackedChangeRestampRetainPaints = Math.max(v2TrackedChangeRestampRetainPaints, 3);
@@ -21573,20 +21676,53 @@ var SuperDoc_default = /* @__PURE__ */ _plugin_vue_export_helper_default(/* @__P
 			v2TrackedChangeRestampRetentionReason = null;
 		};
 		const resolveV2GeometryPublishOptions = (options) => typeof options === "function" ? options() : options;
+		const isV2GeometryReady = (current) => {
+			if (!current?.mountContainer || !commentsModuleConfig.value || !shouldRenderCommentsInViewing.value) return false;
+			const mount = current.mount;
+			let liveEpoch;
+			try {
+				liveEpoch = mount?.getRenderEpoch?.();
+			} catch {
+				return false;
+			}
+			return v2GeometryPublisher.getLastPayload() === current && v2GeometryPublisher.getLastEpoch() != null && v2GeometryPublisher.getLastEpoch() === current.epoch && (liveEpoch == null || liveEpoch === current.epoch);
+		};
 		const scheduleV2GeometryPublish = (payload, options = void 0) => {
 			v2GeometryRender.value = payload;
 			if (v2GeometryRafHandle && typeof cancelAnimationFrame === "function") cancelAnimationFrame(v2GeometryRafHandle);
+			const publish = () => {
+				const current = v2GeometryRender.value;
+				Promise.resolve(v2GeometryPublisher.publish(current, resolveV2GeometryPublishOptions(options))).then(() => {
+					if (current === v2GeometryRender.value && isV2GeometryReady(current)) v2ReviewGeometryDelivery.flush(current);
+				});
+			};
 			if (typeof requestAnimationFrame !== "function") {
-				v2GeometryPublisher.publish(v2GeometryRender.value, resolveV2GeometryPublishOptions(options));
+				publish();
 				return;
 			}
 			v2GeometryRafHandle = requestAnimationFrame(() => {
 				v2GeometryRafHandle = 0;
-				v2GeometryPublisher.publish(v2GeometryRender.value, resolveV2GeometryPublishOptions(options));
+				publish();
 			});
 		};
+		const v2ReviewGeometryDelivery = createReviewGeometryDelivery((current, packet) => {
+			v2GeometryPublisher.noteCommittedPageWindow?.(packet);
+			scheduleV2GeometryPublish(current);
+		});
+		scheduleV2GeometryReplay = (payload) => {
+			if (!payload || payload !== v2GeometryRender.value) return;
+			const generation = ++v2GeometryReplayGeneration;
+			if (v2GeometryReplayRafHandle && typeof cancelAnimationFrame === "function") cancelAnimationFrame(v2GeometryReplayRafHandle);
+			const replay = () => {
+				v2GeometryReplayRafHandle = 0;
+				if (generation === v2GeometryReplayGeneration && payload === v2GeometryRender.value && isV2GeometryReady(payload)) v2ReviewGeometryDelivery.replay(payload);
+			};
+			if (typeof requestAnimationFrame === "function") v2GeometryReplayRafHandle = requestAnimationFrame(replay);
+			else queueMicrotask(replay);
+		};
 		const onV2Render = (payload) => {
 			if (!payload) return;
+			v2ReviewGeometryDelivery.observe(payload);
 			scheduleV2GeometryPublish(payload, () => takeV2TrackedChangeRestampGeometryRetention());
 			if (v2HasRangeSelection.value) scheduleV2SelectionToolbarStateSync();
 		};
@@ -21619,7 +21755,11 @@ var SuperDoc_default = /* @__PURE__ */ _plugin_vue_export_helper_default(/* @__P
 			cancelScheduledV2SelectionToolbarSync();
 			if (v2GeometryRafHandle && typeof cancelAnimationFrame === "function") cancelAnimationFrame(v2GeometryRafHandle);
 			v2GeometryRafHandle = 0;
+			if (v2GeometryReplayRafHandle && typeof cancelAnimationFrame === "function") cancelAnimationFrame(v2GeometryReplayRafHandle);
+			v2GeometryReplayRafHandle = 0;
+			v2GeometryReplayGeneration++;
 			v2GeometryRender.value = null;
+			v2ReviewGeometryDelivery.reset();
 			v2GeometryEpoch.value = null;
 			v2GeometryAvailable.value = false;
 			v2ReviewSidebarUnlocked.value = false;
@@ -21678,6 +21818,7 @@ var SuperDoc_default = /* @__PURE__ */ _plugin_vue_export_helper_default(/* @__P
 					v2ReviewWindowController.invalidate("collaboration:remote-review-changed");
 					v2ReviewWindowController.refreshCommittedWindow("collaboration:remote-review-changed");
 				}
+				emitV2EditorUpdate({ isRemote: true });
 				return;
 			}
 			if (event.type === "source:complete") {
@@ -21766,14 +21907,15 @@ var SuperDoc_default = /* @__PURE__ */ _plugin_vue_export_helper_default(/* @__P
 			if (!isV2Mode.value) return;
 			if (!v2GeometryPublisher.getLastPayload()) return;
 			if (v2GeometryRafHandle && typeof cancelAnimationFrame === "function") cancelAnimationFrame(v2GeometryRafHandle);
-			if (typeof requestAnimationFrame !== "function") {
-				v2GeometryPublisher.recollect(resolveV2GeometryPublishOptions(options));
-				return;
-			}
-			v2GeometryRafHandle = requestAnimationFrame(() => {
+			const recollect = () => {
 				v2GeometryRafHandle = 0;
-				v2GeometryPublisher.recollect(resolveV2GeometryPublishOptions(options));
-			});
+				const current = v2GeometryRender.value;
+				Promise.resolve(v2GeometryPublisher.recollect(resolveV2GeometryPublishOptions(options))).then(() => {
+					if (current === v2GeometryRender.value && isV2GeometryReady(current)) v2ReviewGeometryDelivery.replay(current);
+				});
+			};
+			if (typeof requestAnimationFrame !== "function") recollect();
+			else v2GeometryRafHandle = requestAnimationFrame(recollect);
 		};
 		const handleV2DocumentModeChange = () => {
 			if (!isV2Mode.value) return;
@@ -22001,13 +22143,17 @@ var SuperDoc_default = /* @__PURE__ */ _plugin_vue_export_helper_default(/* @__P
 						...payload,
 						documentId: doc.id
 					});
-					v2GeometryPublisher.noteCommittedPageWindow?.(payload);
+					if (payload.reviewGeometry && Array.isArray(payload.pageIndices)) {
+						const current = v2GeometryRender.value;
+						v2ReviewGeometryDelivery.notify(String(doc.id), payload, current, isV2GeometryReady(current));
+					} else v2GeometryPublisher.noteCommittedPageWindow?.(payload);
 				},
 				fontAssets: proxy.$superdoc.config.fonts,
 				workerUrls: proxy.$superdoc.config.workerUrls,
 				fieldContext: doc.fieldContext,
 				fieldUpdatePolicy: proxy.$superdoc.config.fieldUpdatePolicy,
 				workerStartupTimeoutMs: proxy.$superdoc.config.workerStartupTimeoutMs,
+				...proxy.$superdoc.config.changes ? { changes: proxy.$superdoc.config.changes } : {},
 				proofing: resolvedProofingConfig.value,
 				isNewFile,
 				password: getDocumentLoadPassword(doc),
@@ -23090,7 +23236,7 @@ var SuperDoc_default = /* @__PURE__ */ _plugin_vue_export_helper_default(/* @__P
 			], 46, _hoisted_1$17);
 		};
 	}
-}), [["__scopeId", "data-v-26bcc2bd"]]);
+}), [["__scopeId", "data-v-7c932add"]]);
 //#endregion
 //#region src/core/create-app.ts
 var PINIA_DEVTOOLS_SETUP_EVENT = "devtools-plugin:setup";
@@ -24571,6 +24717,16 @@ var SurfaceManager = class {
 };
 //#endregion
 //#region src/helpers/deprecation.ts
+/**
+* Deprecation utilities for steering consumers toward the Document API.
+*
+* ProseMirror will be removed in a future major version. These helpers emit
+* one-time console warnings when deprecated properties are accessed on an
+* editor instance handed to consumer callbacks (onEditorCreate, etc.).
+*
+* Internal code continues to use the raw Editor — only the consumer-facing
+* boundary wraps the editor with a Proxy.
+*/
 var MIGRATION_URL = "https://docs.superdoc.dev/guides/migration/document-api";
 var _warned = /* @__PURE__ */ new Set();
 /**
@@ -25873,23 +26029,21 @@ function resolveBuiltInItemCommandId(name) {
 	return resolveToolbarCommandId(name) ?? UNCATALOGED_ITEM_COMMAND_IDS[name] ?? null;
 }
 //#endregion
-//#region src/internal/toolbar/built-in/helpers.js
+//#region src/internal/toolbar/built-in/helpers.ts
 var sanitizeNumber = (value, defaultNumber) => {
-	let sanitized = value.replace(/[^0-9.]/g, "");
-	sanitized = parseFloat(sanitized);
-	if (isNaN(sanitized)) sanitized = defaultNumber;
-	sanitized = parseFloat(sanitized);
-	return sanitized;
-};
-var throttle = (func, wait, options) => {
-	let timeout, args, result;
+	const parsed = parseFloat(String(value ?? "").replace(/[^0-9.]/g, ""));
+	return isNaN(parsed) ? defaultNumber : parsed;
+};
+var throttle = (func, wait, options = {}) => {
+	let timeout;
+	let args;
+	let result;
 	let previous = 0;
-	if (!options) options = {};
 	const later = () => {
 		previous = options.leading === false ? 0 : Date.now();
-		timeout = null;
-		result = func(...args);
-		if (!timeout) args = null;
+		timeout = void 0;
+		if (args) result = func(...args);
+		if (!timeout) args = void 0;
 	};
 	const throttled = (...callArgs) => {
 		const _now = Date.now();
@@ -25899,18 +26053,18 @@ var throttle = (func, wait, options) => {
 		if (remaining <= 0 || remaining > wait) {
 			if (timeout) {
 				clearTimeout(timeout);
-				timeout = null;
+				timeout = void 0;
 			}
 			previous = _now;
 			result = func(...callArgs);
-			if (!timeout) args = null;
+			if (!timeout) args = void 0;
 		} else if (!timeout && options.trailing !== false) timeout = setTimeout(later, remaining);
 		return result;
 	};
 	throttled.cancel = function() {
 		clearTimeout(timeout);
 		previous = 0;
-		timeout = args = null;
+		timeout = args = void 0;
 	};
 	return throttled;
 };
@@ -25962,26 +26116,39 @@ var ToolbarButtonIcon_default = /* @__PURE__ */ _plugin_vue_export_helper_defaul
 var _hoisted_1$15 = [
 	"role",
 	"aria-label",
-	"aria-disabled"
+	"aria-disabled",
+	"aria-busy"
 ];
 var _hoisted_2$11 = ["data-item"];
 var _hoisted_3$10 = ["data-item"];
 var _hoisted_4$8 = {
-	key: 1,
+	key: 0,
+	role: "status",
+	"aria-label": "Applying list",
+	style: { "font-weight": "700" }
+};
+var _hoisted_5$6 = {
+	key: 2,
 	class: "sd-button-label"
 };
-var _hoisted_5$6 = ["data-item", "aria-label"];
-var _hoisted_6$4 = ["innerHTML"];
-var _hoisted_7$2 = { key: 2 };
-var _hoisted_8$2 = ["onKeydown", "id"];
-var _hoisted_9$1 = [
+var _hoisted_6$4 = ["data-item", "aria-label"];
+var _hoisted_7$2 = ["innerHTML"];
+var _hoisted_8$2 = {
+	key: 0,
+	role: "status",
+	"aria-label": "Applying list",
+	style: { "font-weight": "700" }
+};
+var _hoisted_9$1 = { key: 3 };
+var _hoisted_10$1 = ["onKeydown", "id"];
+var _hoisted_11$1 = [
 	"placeholder",
 	"onKeydown",
 	"id",
 	"data-item"
 ];
-var _hoisted_10$1 = ["data-item", "innerHTML"];
-var _hoisted_11$1 = {
+var _hoisted_12$1 = ["data-item", "innerHTML"];
+var _hoisted_13$1 = {
 	"aria-live": "polite",
 	class: "sd-visually-hidden"
 };
@@ -26154,6 +26321,7 @@ var ToolbarButton_default = /* @__PURE__ */ _plugin_vue_export_helper_default(/*
 				role: __props.isOverflowItem ? "menuitem" : "button",
 				"aria-label": unref(attributes).ariaLabel,
 				"aria-disabled": unref(disabled) ? "true" : void 0,
+				"aria-busy": unref(attributes).ariaBusy || void 0,
 				"data-sd-part": "toolbar-item",
 				onClick: handleOuterClick,
 				onKeydown: _cache[9] || (_cache[9] = withKeys(($event) => onEnterKeydown($event), ["enter"])),
@@ -26175,17 +26343,21 @@ var ToolbarButton_default = /* @__PURE__ */ _plugin_vue_export_helper_default(/*
 					class: "sd-toolbar-button__main",
 					"data-item": `btn-${unref(name) || ""}-main`,
 					onClick: _cache[0] || (_cache[0] = ($event) => handleSplitMainClick($event))
-				}, [unref(icon) ? (openBlock(), createBlock(ToolbarButtonIcon_default, {
-					key: 0,
-					color: unref(iconColor),
-					class: "sd-toolbar-icon",
-					icon: unref(icon),
-					name: unref(name)
-				}, null, 8, [
-					"color",
-					"icon",
-					"name"
-				])) : createCommentVNode("", true), unref(label) && !unref(hideLabel) && !unref(inlineTextInputVisible) ? (openBlock(), createElementBlock("div", _hoisted_4$8, toDisplayString(unref(label)), 1)) : createCommentVNode("", true)], 8, _hoisted_3$10)) : createCommentVNode("", true),
+				}, [
+					unref(attributes).ariaBusy && isSplit.value ? (openBlock(), createElementBlock("span", _hoisted_4$8, "…")) : createCommentVNode("", true),
+					unref(icon) ? (openBlock(), createBlock(ToolbarButtonIcon_default, {
+						key: 1,
+						color: unref(iconColor),
+						class: "sd-toolbar-icon",
+						icon: unref(icon),
+						name: unref(name)
+					}, null, 8, [
+						"color",
+						"icon",
+						"name"
+					])) : createCommentVNode("", true),
+					unref(label) && !unref(hideLabel) && !unref(inlineTextInputVisible) ? (openBlock(), createElementBlock("div", _hoisted_5$6, toDisplayString(unref(label)), 1)) : createCommentVNode("", true)
+				], 8, _hoisted_3$10)) : createCommentVNode("", true),
 				isSplit.value ? (openBlock(), createElementBlock("div", {
 					key: 1,
 					class: "sd-toolbar-button__caret",
@@ -26196,9 +26368,10 @@ var ToolbarButton_default = /* @__PURE__ */ _plugin_vue_export_helper_default(/*
 					class: "sd-dropdown-caret",
 					innerHTML: caretIcon.value,
 					style: normalizeStyle({ opacity: unref(disabled) ? .6 : 1 })
-				}, null, 12, _hoisted_6$4)], 8, _hoisted_5$6)) : (openBlock(), createElementBlock(Fragment, { key: 2 }, [
+				}, null, 12, _hoisted_7$2)], 8, _hoisted_6$4)) : (openBlock(), createElementBlock(Fragment, { key: 2 }, [
+					unref(attributes).ariaBusy ? (openBlock(), createElementBlock("span", _hoisted_8$2, "…")) : createCommentVNode("", true),
 					unref(icon) ? (openBlock(), createBlock(ToolbarButtonIcon_default, {
-						key: 0,
+						key: 1,
 						color: unref(iconColor),
 						class: "sd-toolbar-icon",
 						icon: unref(icon),
@@ -26209,10 +26382,10 @@ var ToolbarButton_default = /* @__PURE__ */ _plugin_vue_export_helper_default(/*
 						"name"
 					])) : createCommentVNode("", true),
 					unref(label) && !unref(hideLabel) && (!unref(inlineTextInputVisible) || itemName.value === "fontFamily") ? (openBlock(), createElementBlock("div", {
-						key: 1,
+						key: 2,
 						class: normalizeClass(["sd-button-label", { "sd-visually-hidden": unref(inlineTextInputVisible) && itemName.value === "fontFamily" }])
 					}, toDisplayString(unref(label)), 3)) : createCommentVNode("", true),
-					unref(inlineTextInputVisible) ? (openBlock(), createElementBlock("span", _hoisted_7$2, [unref(name) === "fontSize" ? withDirectives((openBlock(), createElementBlock("input", {
+					unref(inlineTextInputVisible) ? (openBlock(), createElementBlock("span", _hoisted_9$1, [unref(name) === "fontSize" ? withDirectives((openBlock(), createElementBlock("input", {
 						key: 0,
 						"onUpdate:modelValue": _cache[1] || (_cache[1] = ($event) => inlineTextInput.value = $event),
 						onKeydown: [withKeys(withModifiers(handleInlineInputEnter, ["stop", "prevent"]), ["enter"]), _cache[2] || (_cache[2] = withKeys(($event) => handleInlineInputTab($event), ["tab"]))],
@@ -26224,7 +26397,7 @@ var ToolbarButton_default = /* @__PURE__ */ _plugin_vue_export_helper_default(/*
 						autocomplete: "off",
 						ref_key: "inlineInput",
 						ref: inlineInput
-					}, null, 42, _hoisted_8$2)), [[vModelText, inlineTextInput.value]]) : withDirectives((openBlock(), createElementBlock("input", {
+					}, null, 42, _hoisted_10$1)), [[vModelText, inlineTextInput.value]]) : withDirectives((openBlock(), createElementBlock("input", {
 						key: 1,
 						"onUpdate:modelValue": _cache[5] || (_cache[5] = ($event) => inlineTextInput.value = $event),
 						placeholder: unref(label),
@@ -26241,20 +26414,20 @@ var ToolbarButton_default = /* @__PURE__ */ _plugin_vue_export_helper_default(/*
 						autocomplete: "off",
 						ref_key: "inlineInput",
 						ref: inlineInput
-					}, null, 42, _hoisted_9$1)), [[vModelText, inlineTextInput.value]])])) : createCommentVNode("", true),
+					}, null, 42, _hoisted_11$1)), [[vModelText, inlineTextInput.value]])])) : createCommentVNode("", true),
 					unref(hasCaret) ? (openBlock(), createElementBlock("div", {
-						key: 3,
+						key: 4,
 						class: "sd-dropdown-caret",
 						"data-item": `btn-${unref(name) || ""}-toggle`,
 						innerHTML: caretIcon.value,
 						style: normalizeStyle({ opacity: unref(disabled) ? .6 : 1 })
-					}, null, 12, _hoisted_10$1)) : createCommentVNode("", true)
+					}, null, 12, _hoisted_12$1)) : createCommentVNode("", true)
 				], 64)),
-				createElementVNode("div", _hoisted_11$1, toDisplayString(`${unref(attributes).ariaLabel} ${unref(active) ? "selected" : "unset"}`), 1)
+				createElementVNode("div", _hoisted_13$1, toDisplayString(`${unref(attributes).ariaLabel} ${unref(active) ? "selected" : "unset"}`), 1)
 			], 10, _hoisted_2$11)], 46, _hoisted_1$15);
 		};
 	}
-}), [["__scopeId", "data-v-e599674c"]]);
+}), [["__scopeId", "data-v-b49ede12"]]);
 //#endregion
 //#region src/internal/toolbar/built-in/ToolbarSeparator.vue?vue&type=script&setup=true&lang.ts
 var _hoisted_1$14 = {
@@ -26809,24 +26982,11 @@ var OverflowMenu_default = /* @__PURE__ */ _plugin_vue_export_helper_default(/*
 	}
 }), [["__scopeId", "data-v-d2e189fd"]]);
 //#endregion
-//#region src/internal/toolbar/built-in/font-typeahead.js
-/**
-* Pure typeahead/autocomplete helpers for the font comboboxes (family + size).
-*
-* Matching is case-insensitive prefix matching on the logical font labels.
-* Space is a normal query character, so the query is never split on spaces;
-* only the outer whitespace is ignored when comparing.
-*
-* These functions hold no Vue or DOM state so CI can unit-test them in isolation.
-*/
+//#region src/internal/toolbar/built-in/font-typeahead.ts
 var normalize = (value) => String(value ?? "").trim().toLowerCase();
 /**
 * Index of the first label that starts with `query` (case-insensitive).
-* An empty/whitespace query never matches.
-*
-* @param {string} query
-* @param {ReadonlyArray<string>} labels
-* @returns {number} matching index or -1
+* An empty/whitespace query never matches. Returns the matching index or -1.
 */
 var findPrefixMatchIndex = (query, labels) => {
 	const q = normalize(query);
@@ -26840,12 +27000,7 @@ var findPrefixMatchIndex = (query, labels) => {
 * When `autocomplete` is true and a prefix match exists that is longer than the
 * typed query, the completion is shown with the suffix selected so the next
 * keystroke replaces it. When false (deletion) or no match exists, the raw
-* query is shown with the caret at its end.
-*
-* @param {string} query - the user-typed portion
-* @param {ReadonlyArray<string>} labels
-* @param {{ autocomplete?: boolean }} [options]
-* @returns {{ matchIndex: number, display: string, selectionStart: number, selectionEnd: number }}
+* query is shown with the caret at its end. `query` is the user-typed portion.
 */
 var computeTypeahead = (query, labels, { autocomplete = true } = {}) => {
 	const typed = String(query ?? "");
@@ -26897,9 +27052,6 @@ var MAX_FONT_SIZE = 1638;
 * the nearest half point (DOCX/Word support half points such as 10.5), and clamps
 * to the supported range. Returns '' when nothing usable was typed, including
 * negative or sub-minimum values.
-*
-* @param {string} value
-* @returns {string} point size (whole or half), or '' when empty/invalid
 */
 var normalizeCustomFontSize = (value) => {
 	const cleaned = String(value ?? "").replace(/[^0-9.-]/g, "");
@@ -27567,7 +27719,7 @@ var SdTooltip_default = /* @__PURE__ */ _plugin_vue_export_helper_default(/* @__
 		]);
 		const contentStyle = computed$1(() => ({
 			...props.contentStyle,
-			...attrs.style || {},
+			...attrs.style,
 			position: "fixed",
 			top: position.value.top,
 			left: position.value.left,
@@ -27736,7 +27888,7 @@ var SdTooltip_default = /* @__PURE__ */ _plugin_vue_export_helper_default(/* @__
 			}, 8, ["css"])]))], 64);
 		};
 	}
-}), [["__scopeId", "data-v-dfd6f1d1"]]);
+}), [["__scopeId", "data-v-87967ab1"]]);
 //#endregion
 //#region src/internal/toolbar/built-in/ButtonGroup.vue?vue&type=script&setup=true&lang.ts
 var _hoisted_1$11 = [
@@ -28590,7 +28742,7 @@ var Toolbar_default = /* @__PURE__ */ _plugin_vue_export_helper_default(/* @__PU
 	}
 }), [["__scopeId", "data-v-bce7c04a"]]);
 //#endregion
-//#region src/internal/toolbar/built-in/font-options.js
+//#region src/internal/toolbar/built-in/font-options.ts
 /**
 * Normalize a font dropdown option so each row renders in its own typeface.
 *
@@ -28946,7 +29098,7 @@ var StyleButtonsList_default = /* @__PURE__ */ _plugin_vue_export_helper_default
 	}
 }), [["__scopeId", "data-v-539d0995"]]);
 //#endregion
-//#region src/internal/toolbar/built-in/list-style-buttons.js
+//#region src/internal/toolbar/built-in/list-style-buttons.ts
 var bulletStyleButtons = [
 	{
 		key: "disc",
@@ -30257,7 +30409,7 @@ var PageNumberMenu_default = /* @__PURE__ */ _plugin_vue_export_helper_default(/
 							onClick: ($event) => selectTile(tile),
 							onDblclick: applyPageNumbers,
 							onKeydown: onTileKeydown
-						}, [(openBlock(), createElementBlock("svg", _hoisted_5, [_cache[4] || (_cache[4] = createStaticVNode("<rect class=\"sd-page-number-menu__sheet\" x=\"0.75\" y=\"0.75\" width=\"34.5\" height=\"44.5\" rx=\"2.5\" data-v-a6c124c0></rect><rect class=\"sd-page-number-menu__line\" x=\"7\" y=\"14\" width=\"22\" height=\"2\" rx=\"1\" data-v-a6c124c0></rect><rect class=\"sd-page-number-menu__line\" x=\"7\" y=\"19\" width=\"18\" height=\"2\" rx=\"1\" data-v-a6c124c0></rect><rect class=\"sd-page-number-menu__line\" x=\"7\" y=\"24\" width=\"22\" height=\"2\" rx=\"1\" data-v-a6c124c0></rect><rect class=\"sd-page-number-menu__line\" x=\"7\" y=\"29\" width=\"14\" height=\"2\" rx=\"1\" data-v-a6c124c0></rect>", 5)), createElementVNode("rect", {
+						}, [(openBlock(), createElementBlock("svg", _hoisted_5, [_cache[4] || (_cache[4] = createStaticVNode("<rect class=\"sd-page-number-menu__sheet\" x=\"0.75\" y=\"0.75\" width=\"34.5\" height=\"44.5\" rx=\"2.5\" data-v-e3105afd></rect><rect class=\"sd-page-number-menu__line\" x=\"7\" y=\"14\" width=\"22\" height=\"2\" rx=\"1\" data-v-e3105afd></rect><rect class=\"sd-page-number-menu__line\" x=\"7\" y=\"19\" width=\"18\" height=\"2\" rx=\"1\" data-v-e3105afd></rect><rect class=\"sd-page-number-menu__line\" x=\"7\" y=\"24\" width=\"22\" height=\"2\" rx=\"1\" data-v-e3105afd></rect><rect class=\"sd-page-number-menu__line\" x=\"7\" y=\"29\" width=\"14\" height=\"2\" rx=\"1\" data-v-e3105afd></rect>", 5)), createElementVNode("rect", {
 							class: "sd-page-number-menu__chip",
 							x: CHIP_X[tile.alignment],
 							y: CHIP_Y[tile.position],
@@ -30337,23 +30489,21 @@ var PageNumberMenu_default = /* @__PURE__ */ _plugin_vue_export_helper_default(/
 			], 10, _hoisted_1);
 		};
 	}
-}), [["__scopeId", "data-v-a6c124c0"]]);
+}), [["__scopeId", "data-v-e3105afd"]]);
 //#endregion
-//#region src/internal/toolbar/built-in/page-number-feedback.js
+//#region src/internal/toolbar/built-in/page-number-feedback.ts
 var FLASH_CLASS = "sd-page-number-flash";
 var FLASH_MS = 1400;
 var nextFrame = (view) => new Promise((resolve) => {
-	if (typeof view?.requestAnimationFrame === "function") view.requestAnimationFrame(() => resolve());
+	if (typeof view.requestAnimationFrame === "function") view.requestAnimationFrame(() => resolve());
 	else setTimeout(resolve, 16);
 });
 /**
 * Briefly highlight the painted header or footer regions that are on screen,
 * so the user sees where page numbers landed without the caret leaving the
 * body. Regions are read after the repaint that follows the mutation; nothing
-* happens when none is visible or the host is unavailable.
-*
-* @param {HTMLElement | null | undefined} host Document viewport host element.
-* @param {'header' | 'footer'} kind
+* happens when none is visible or the host is unavailable. `host` is the
+* document viewport host element.
 */
 async function flashPageNumberRegions(host, kind) {
 	const view = host?.ownerDocument?.defaultView;
@@ -30361,7 +30511,7 @@ async function flashPageNumberRegions(host, kind) {
 	await nextFrame(view);
 	await nextFrame(view);
 	const viewportHeight = view.innerHeight;
-	const regions = [...host.querySelectorAll(`[data-sd-headerfooter-kind="${kind}"]`)].filter((region) => {
+	const regions = Array.from(host.querySelectorAll(`[data-sd-headerfooter-kind="${kind}"]`)).filter((region) => {
 		const rect = region.getBoundingClientRect();
 		return rect.height > 0 && rect.bottom > 0 && rect.top < viewportHeight;
 	});
@@ -30562,6 +30712,8 @@ var makeDefaultItems = ({ superToolbar, toolbarIcons: configuredIcons, toolbarTe
 		attributes: { ariaLabel: "Bold" }
 	});
 	const fontOptions = (toolbarFonts ?? TOOLBAR_FONTS).map(normalizeFontOption);
+	const isFontOption = (option) => typeof option.label === "string" && typeof option.key === "string";
+	const currentFontOptions = () => fontButton.nestedOptions.value.filter(isFontOption);
 	const fontButton = useToolbarItem({
 		type: "dropdown",
 		name: "fontFamily",
@@ -30588,8 +30740,9 @@ var makeDefaultItems = ({ superToolbar, toolbarIcons: configuredIcons, toolbarTe
 			if (typeof fontFamily !== "string" || !fontFamily) return;
 			const family = fontFamily.split(",")[0];
 			const optionValue = (option) => option.value ?? option.label;
-			const defaultFont = fontOptions.find((option) => optionValue(option) === fontButton.defaultLabel.value);
-			const foundFont = fontOptions.find((option) => optionValue(option) === family);
+			const options = currentFontOptions();
+			const defaultFont = options.find((option) => optionValue(option) === fontButton.defaultLabel.value);
+			const foundFont = options.find((option) => optionValue(option) === family);
 			if (foundFont) {
 				fontButton.label.value = foundFont.label;
 				fontButton.selectedValue.value = foundFont.key;
@@ -30602,7 +30755,7 @@ var makeDefaultItems = ({ superToolbar, toolbarIcons: configuredIcons, toolbarTe
 			}
 		},
 		onDeactivate: () => {
-			const defaultFont = fontOptions.find((option) => (option.value ?? option.label) === fontButton.defaultLabel.value);
+			const defaultFont = currentFontOptions().find((option) => (option.value ?? option.label) === fontButton.defaultLabel.value);
 			fontButton.label.value = defaultFont?.label ?? fontButton.defaultLabel.value;
 			fontButton.selectedValue.value = defaultFont?.key ?? "";
 		}
@@ -31709,7 +31862,7 @@ var makeDefaultItems = ({ superToolbar, toolbarIcons: configuredIcons, toolbarTe
 	};
 };
 //#endregion
-//#region src/internal/toolbar/built-in/general.js
+//#region src/internal/toolbar/built-in/general.ts
 /**
 * Minimal DOM helpers for the built-in toolbar shell.
 *
@@ -31720,8 +31873,6 @@ var makeDefaultItems = ({ superToolbar, toolbarIcons: configuredIcons, toolbarTe
 */
 /**
 * Resolve a toolbar mount target from a selector string or element id.
-* @param {string|HTMLElement|null|undefined} selector
-* @returns {HTMLElement|null}
 */
 var findElementBySelector = (selector) => {
 	if (!selector) return null;
@@ -31761,9 +31912,6 @@ function toSelectedValue(value) {
 function nonEmptyString(value) {
 	return typeof value === "string" && value ? value : void 0;
 }
-function isThenable(value) {
-	return (typeof value === "object" || typeof value === "function") && value !== null && "then" in value && typeof value.then === "function";
-}
 function isToolbarCommandCallback(value) {
 	return typeof value === "function";
 }
@@ -31786,7 +31934,7 @@ function executeCommand(ui, commandId, argument, options = {}) {
 		if (!options.reportUnhandled || settled !== false) return;
 		options.onError?.(/* @__PURE__ */ new Error(`[superdoc toolbar] Command "${commandId}" did not run. Check that it is enabled and has the required input.`));
 	};
-	if (isThenable(result)) Promise.resolve(result).then((settled) => {
+	if (isThenable$1(result)) Promise.resolve(result).then((settled) => {
 		reportFailure(settled);
 		options.onSettled?.();
 	}, (error) => {
@@ -31819,7 +31967,7 @@ var V1_ENABLED_ON_SELECTION_REASON = /* @__PURE__ */ new Set([
 ]);
 var V1_ENABLED_ON_EMPTY_REASON = /* @__PURE__ */ new Set(["list", "numberedlist"]);
 function shouldKeepEnabledForV1ToolbarParity(name, commandState) {
-	if (name === "fontFamily" || name === "fontSize") return true;
+	if (name === "fontFamily" || name === "fontSize") return commandState?.reason !== "document-readonly";
 	if (V1_ENABLED_ON_EMPTY_REASON.has(name) && commandState?.disabled && commandState?.supported !== false && commandState?.reason == null) return true;
 	if (!V1_ENABLED_ON_SELECTION_REASON.has(name)) return false;
 	const reason = commandState?.reason;
@@ -32010,7 +32158,7 @@ var BuiltInToolbar = class extends import_eventemitter3.default {
 			const signature = this.#fontOptionsSignature();
 			if (signature !== this._lastFontOptionsSignature) {
 				this._lastFontOptionsSignature = signature;
-				this.#rebuildToolbarItems();
+				if (!this.#refreshFontFamilyOptions()) this.#rebuildToolbarItems();
 			}
 			this.updateToolbarState();
 		};
@@ -32138,7 +32286,7 @@ var BuiltInToolbar = class extends import_eventemitter3.default {
 								argument: payload.argument,
 								option: payload.option
 							});
-							if (isThenable(result)) return Promise.resolve(result).catch((error) => {
+							if (isThenable$1(result)) return Promise.resolve(result).catch((error) => {
 								this.#emitCommandException(error, config.name);
 								return false;
 							});
@@ -32158,6 +32306,13 @@ var BuiltInToolbar = class extends import_eventemitter3.default {
 		this.#makeToolbarItems();
 		this.emit("toolbar-items-changed");
 	}
+	#refreshFontFamilyOptions() {
+		const items = this.#getAllToolbarItems().filter((item) => item.name.value === "fontFamily");
+		if (!items.length) return false;
+		const options = (this.#resolveToolbarFonts(this.config.fonts) ?? TOOLBAR_FONTS).map(normalizeFontOption);
+		for (const item of items) item.nestedOptions.value = options.map((option) => ({ ...option }));
+		return true;
+	}
 	#fontOptionsSignature() {
 		if (this.config.fonts) return "custom-fonts";
 		const options = this.superdoc?.fonts?.getFontFamilyOptions?.() ?? [];
@@ -32337,6 +32492,10 @@ var BuiltInToolbar = class extends import_eventemitter3.default {
 		const commandId = resolveBuiltInItemCommandId(name);
 		if (!commandId) return false;
 		const commandState = this.snapshot?.commands?.[commandId];
+		if ((name === "list" || name === "numberedlist") && item.attributes.value.ariaBusy !== Boolean(commandState?.pending)) item.attributes.value = {
+			...item.attributes.value,
+			ariaBusy: Boolean(commandState?.pending)
+		};
 		if (shouldKeepEnabledForV1ToolbarParity(name, commandState)) item.setDisabled(false);
 		else item.setDisabled(Boolean(commandState?.disabled));
 		const handlers = {
@@ -32615,7 +32774,7 @@ var BuiltInToolbar = class extends import_eventemitter3.default {
 						ui: this.ui,
 						superdoc: this.superdoc
 					});
-					if (isThenable(result)) Promise.resolve(result).catch((error) => this.#emitCommandException(error, name));
+					if (isThenable$1(result)) Promise.resolve(result).catch((error) => this.#emitCommandException(error, name));
 				}
 				this.updateToolbarState();
 				return;
@@ -32881,6 +33040,7 @@ var SuperDoc = class extends import_eventemitter3.default {
 	#v2ConnectionUnsub;
 	/** Latest `collaboration-connection-change` payload, for late readers. */
 	#v2ConnectionState;
+	#v2ConnectionFailureReported;
 	/** Whether the current collaboration room has completed a sync at least once. */
 	#v2ConnectionHasSynced;
 	/** Lock state captured before a local → v2 collaboration promotion remount. */
@@ -32983,6 +33143,7 @@ var SuperDoc = class extends import_eventemitter3.default {
 		this.#v2LockUnsub = null;
 		this.#v2ConnectionUnsub = null;
 		this.#v2ConnectionState = null;
+		this.#v2ConnectionFailureReported = false;
 		this.#v2ConnectionHasSynced = false;
 		this.#pendingV2LockSeed = null;
 		this.#mountWrapper = null;
@@ -33185,7 +33346,7 @@ var SuperDoc = class extends import_eventemitter3.default {
 		}
 		this.userColorMap = /* @__PURE__ */ new Map();
 		this.colorIndex = 0;
-		this.version = "2.29.0-next.9";
+		this.version = "2.30.0-next.4";
 		this.#log("🦋 [superdoc] Using SuperDoc version:", this.version);
 		this.superdocId = config.superdocId || v4();
 		this.colors = this.config.colors ?? [];
@@ -33604,6 +33765,7 @@ var SuperDoc = class extends import_eventemitter3.default {
 		if (this.#v2ConnectionState?.documentId !== documentId) {
 			this.#v2ConnectionState = null;
 			this.#v2ConnectionHasSynced = false;
+			this.#v2ConnectionFailureReported = false;
 		}
 		const publish = (snapshot) => {
 			if (this.#destroyed) return;
@@ -33618,8 +33780,21 @@ var SuperDoc = class extends import_eventemitter3.default {
 				superdoc: this
 			};
 			this.#v2ConnectionState = payload;
-			if (snapshot.state === "synced") this.#v2ConnectionHasSynced = true;
-			this.emit("collaboration-connection-change", payload);
+			if (snapshot.state === "synced") {
+				this.#v2ConnectionHasSynced = true;
+				this.#v2ConnectionFailureReported = false;
+			}
+			const firstFailure = snapshot.state === "failed" && !this.#v2ConnectionFailureReported;
+			if (firstFailure) this.#v2ConnectionFailureReported = true;
+			const reportFailure = firstFailure && snapshot.detail !== "worker-transport-failed";
+			try {
+				this.emit("collaboration-connection-change", payload);
+			} finally {
+				if (reportFailure) {
+					const exception = createCollaborationException("collaboration-connection-failed", documentId);
+					if (exception) this.emit("exception", exception);
+				}
+			}
 		};
 		try {
 			const initialSnapshot = connection.getSnapshot?.();