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

package/dist/superdoc.es.js

@@ -1,7 +1,7 @@
 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 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 { 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-Cq8trPVC.es.js";
 import { t as import_eventemitter3 } from "./chunks/eventemitter3-DEIiXiH2.es.js";
 import { t as v4 } from "./chunks/uuid-H0Xcmmhy.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";
@@ -258,7 +258,7 @@ var v_click_outside_default = {
 var DEFAULT_ENDPOINT = "https://ingest.superdoc.dev/v1/collect";
 function getSuperdocVersion() {
 	try {
-		return "2.30.0-next.4";
+		return "2.30.0-next.9";
 	} catch {
 		return "unknown";
 	}
@@ -6828,6 +6828,18 @@ function resolveDocxExportPolicies(input = {}) {
 		contentControls: requested?.contentControls ?? "preserve"
 	};
 }
+new TextEncoder();
+function normalizeCommentIdentity(value) {
+	if (value === null) return null;
+	if (typeof value !== "object" || Array.isArray(value) || !("providerId" in value) || !("userId" in value) || !xmlIdentityString(value.providerId) || !xmlIdentityString(value.userId)) throw new TypeError("commentIdentity requires XML-safe non-empty providerId and userId strings.");
+	return {
+		providerId: value.providerId,
+		userId: value.userId
+	};
+}
+function xmlIdentityString(value) {
+	return typeof value === "string" && value.trim().length > 0 && !/[^\u0009\u000A\u000D\u0020-\uD7FF\uE000-\uFFFD\u{10000}-\u{10FFFF}]/u.test(value);
+}
 //#endregion
 //#region ../document-api/src/permission-ranges/permission-ranges.ts
 function editorKey(editor) {
@@ -8008,6 +8020,7 @@ var useCommentsStore = defineStore("comments", () => {
 	});
 	const debounceTimers = {};
 	const trackedChangeResolutionSnapshots = /* @__PURE__ */ new WeakMap();
+	let cachedTrackedChangeBatchIdentityIndex = null;
 	const isBenchmarkCommentsDebugEnabled = () => {
 		if (typeof window === "undefined") return false;
 		return "__labsSuperDocV2BenchmarkDebug" in window;
@@ -8089,6 +8102,7 @@ var useCommentsStore = defineStore("comments", () => {
 	const isV2EditorActive = (superdoc) => superdoc?.activeEditor?.editorVersion === 2 || v2CommentsAdapter.value !== null;
 	const v2TrackedChangesAdapter = shallowRef$1(null);
 	const setV2TrackedChangesAdapter = (adapter) => {
+		cachedTrackedChangeBatchIdentityIndex = null;
 		v2TrackedChangesAdapter.value = isV2TrackedChangesAdapter(adapter) ? adapter : null;
 	};
 	const getV2TrackedChangesAdapter = (superdoc) => {
@@ -8212,7 +8226,7 @@ var useCommentsStore = defineStore("comments", () => {
 	* Called when a tracked change is updated. Creates a new comment if necessary,
 	* or updates an existing tracked-change comment.
 	*/
-	const handleTrackedChangeUpdate = ({ superdoc, params, broadcastChanges = true, trackedChangeIdentityIndex = null }) => {
+	const handleTrackedChangeUpdate = ({ superdoc, params, broadcastChanges = true, trackedChangeIdentityIndex = null, preserveDraft = false }) => {
 		const span = startInteractionSpan("store.trackedChanges.handleUpdate", "store-reconciliation", {
 			event: params?.event ?? null,
 			changeId: params?.changeId ?? null,
@@ -8237,8 +8251,10 @@ var useCommentsStore = defineStore("comments", () => {
 			const normalizedTrackedChangeLabel = typeof trackedChangeLabel === "string" && trackedChangeLabel.length > 0 ? trackedChangeLabel : null;
 			const normalizedTrackedChangeDetailLines = normalizeTrackedChangeDetailLines(trackedChangeDetailLines);
 			const normalizedTrackedChangeImagePreview = normalizeTrackedChangeImagePreview(trackedChangeImagePreview);
+			const hasDraft = preserveDraft && (pendingComment.value !== null || currentCommentText.value !== "" || currentCommentMentions.value.length > 0);
 			const comment = getPendingComment({
 				documentId,
+				...hasDraft ? { commentText: "" } : {},
 				commentId: normalizedChangeId ?? void 0,
 				trackedChange: true,
 				trackedChangeText,
@@ -8393,7 +8409,8 @@ var useCommentsStore = defineStore("comments", () => {
 				addHydratedComment({
 					superdoc: requireHost(superdoc, "handleTrackedChangeUpdate"),
 					comment,
-					broadcastChanges
+					broadcastChanges,
+					preserveDraft: hasDraft
 				});
 				trackedChangeIdentityIndex?.add(comment);
 			} else if (event === "update") {
@@ -8623,7 +8640,7 @@ var useCommentsStore = defineStore("comments", () => {
 	/**
 	* Add a new comment to the document
 	*/
-	const addCommentInternal = ({ superdoc, comment, skipEditorUpdate = false, broadcastChanges = true, isHydration = false }) => {
+	const addCommentInternal = ({ superdoc, comment, skipEditorUpdate = false, broadcastChanges = true, isHydration = false, preserveDraft = false }) => {
 		if (commentsAreReadOnly() && !isHydration) return readOnlyMutationOutcome();
 		const v2Adapter = !skipEditorUpdate && !isHydration ? getV2CommentsAdapter(superdoc) : null;
 		if (v2Adapter && !comment.trackedChange) {
@@ -8702,23 +8719,25 @@ var useCommentsStore = defineStore("comments", () => {
 				};
 			});
 		}
-		let parentComment = commentsList.value.find((c) => c.commentId === activeComment.value);
+		const activeId = activeComment.value;
+		const parent = toRaw$2(commentsList.value).find((c) => unref(c.commentId) === activeId);
+		let parentComment = parent ? reactive(parent) : void 0;
 		if (!parentComment) parentComment = comment;
 		const newComment = useComment(comment.getValues());
-		if (pendingComment.value) newComment.setText({
-			text: currentCommentText.value,
-			suppressUpdate: true
-		});
-		else newComment.setText({
-			text: comment.commentText,
+		const text = pendingComment.value && !preserveDraft ? currentCommentText.value : comment.commentText;
+		if (text === "") {
+			newComment.commentText = "";
+			newComment.mentions = [];
+		} else newComment.setText({
+			text,
 			suppressUpdate: true
 		});
-		newComment.selection.source = pendingComment.value?.selection?.source ?? newComment.selection.source;
+		if (!preserveDraft) newComment.selection.source = pendingComment.value?.selection?.source ?? newComment.selection.source;
 		if (parentComment) newComment.isInternal = parentComment.isInternal;
 		if (!superdoc.config.isInternal) newComment.isInternal = false;
 		commentsList.value.push(newComment);
-		const hadPendingComment = !!pendingComment.value;
-		removePendingComment(superdoc);
+		const hadPendingComment = !preserveDraft && !!pendingComment.value;
+		if (!preserveDraft) removePendingComment(superdoc);
 		if (hadPendingComment) {
 			activeComment.value = newComment.commentId;
 			setActiveFloatingCommentInstance(newComment.commentId);
@@ -8746,12 +8765,13 @@ var useCommentsStore = defineStore("comments", () => {
 		skipEditorUpdate,
 		broadcastChanges
 	});
-	const addHydratedComment = ({ superdoc, comment, skipEditorUpdate = false, broadcastChanges = true }) => addCommentInternal({
+	const addHydratedComment = ({ superdoc, comment, skipEditorUpdate = false, broadcastChanges = true, preserveDraft = false }) => addCommentInternal({
 		superdoc,
 		comment,
 		skipEditorUpdate,
 		broadcastChanges,
-		isHydration: true
+		isHydration: true,
+		preserveDraft
 	});
 	const deleteComment = ({ commentId: commentIdToDelete, superdoc }) => {
 		if (commentsAreReadOnly()) return Promise.resolve(readOnlyMutationOutcome());
@@ -9476,6 +9496,11 @@ var useCommentsStore = defineStore("comments", () => {
 	/** Keep one mounted review window plus rows whose interaction is still live. */
 	const boundReviewPresentationRows = ({ documentId, visibleIds }) => {
 		const currentRows = commentsList.value;
+		if (currentRows.every((row) => {
+			if (!belongsToTrackedChangeSyncDocument(row, documentId)) return true;
+			const id = normalizeCommentId(row.commentId);
+			return Boolean(id && visibleIds.has(id));
+		})) return;
 		const identityIdsByRow = /* @__PURE__ */ new Map();
 		const identityIdsFor = (row) => {
 			let ids = identityIdsByRow.get(row);
@@ -9692,7 +9717,8 @@ var useCommentsStore = defineStore("comments", () => {
 				preparedParams,
 				preparedPresentation: preparedReview?.presentation ?? null,
 				previousPreparedPresentation,
-				pruneStale: false
+				pruneStale: false,
+				preserveDraft: true
 			});
 			reconcileCommentsFromV2({
 				superdoc,
@@ -10438,6 +10464,10 @@ var useCommentsStore = defineStore("comments", () => {
 		const byIdentityAlias = /* @__PURE__ */ new Map();
 		const aliasesByRow = /* @__PURE__ */ new Map();
 		const indexedRows = /* @__PURE__ */ new Set();
+		const indexedIdentities = [];
+		let building = true;
+		let reusable = true;
+		let reused = false;
 		let aliasLookups = 0;
 		let candidateVisits = 0;
 		let rowAliasBuilds = 0;
@@ -10461,6 +10491,7 @@ var useCommentsStore = defineStore("comments", () => {
 			index.set(alias, bucket);
 		};
 		const add = (comment) => {
+			if (!building) reusable = false;
 			if (!comment?.trackedChange) return;
 			if (documentId && !belongsToTrackedChangeSyncDocument(comment, documentId)) return;
 			indexedRows.add(comment);
@@ -10472,19 +10503,49 @@ var useCommentsStore = defineStore("comments", () => {
 			rowAliasBuilds += 1;
 			aliasesByRow.set(comment, aliases);
 			aliases.forEach((alias) => addAlias(byIdentityAlias, alias, comment));
+			if (building) indexedIdentities.push({
+				row: comment,
+				aliases,
+				canonicalId: normalizeCommentId(comment.trackedChangeCanonicalId)
+			});
 		};
 		commentsList.value.forEach(add);
+		building = false;
 		return {
+			inUse: false,
 			add,
 			aliasesFor,
-			work: () => ({
-				trackedRowsIndexed: indexedRows.size,
-				invalidatedIdMembershipChecks: 0,
-				incomingAliasLookups: aliasLookups,
-				candidateVisits,
-				rowAliasBuilds,
-				rowAliasCacheHits
-			}),
+			isCurrent: () => {
+				if (!reusable) return false;
+				let index = 0;
+				for (const row of commentsList.value) {
+					if (!row?.trackedChange || documentId && !belongsToTrackedChangeSyncDocument(row, documentId)) continue;
+					const previous = indexedIdentities[index++];
+					if (!previous || previous.row !== row || previous.canonicalId !== normalizeCommentId(row.trackedChangeCanonicalId)) return false;
+					const aliases = getCommentAliasIds(row);
+					rowAliasBuilds += 1;
+					if (aliases.length !== previous.aliases.length || aliases.some((alias, i) => alias !== previous.aliases[i])) return false;
+				}
+				reused = index === indexedIdentities.length;
+				return reused;
+			},
+			work: () => {
+				const result = {
+					trackedRowsIndexed: indexedRows.size,
+					invalidatedIdMembershipChecks: 0,
+					incomingAliasLookups: aliasLookups,
+					candidateVisits,
+					rowAliasBuilds,
+					rowAliasCacheHits,
+					indexReused: Number(reused)
+				};
+				aliasLookups = 0;
+				candidateVisits = 0;
+				rowAliasBuilds = 0;
+				rowAliasCacheHits = 0;
+				reused = false;
+				return result;
+			},
 			candidates({ changeId, importedId, anchorKey, canonicalId, positionAliases = [] } = {}) {
 				const out = /* @__PURE__ */ new Set();
 				const include = (value) => {
@@ -10507,7 +10568,30 @@ var useCommentsStore = defineStore("comments", () => {
 			}
 		};
 	};
-	const reconcileTrackedChangesFromV2 = ({ superdoc, adapter, documentId, items, pruneStale = true, preparedParams = null, preparedPresentation = null, previousPreparedPresentation = null, liveIds: suppliedLiveIds = null, liveAnchorKeys: suppliedLiveAnchorKeys = null, hydrationGeneration } = {}) => withInteractionSpan("store.trackedChanges.reconcile", "store-reconciliation", {
+	const getTrackedChangeBatchIdentityIndex = (documentId) => {
+		const cached = cachedTrackedChangeBatchIdentityIndex;
+		if (cached?.documentId === documentId && !cached.index.inUse) {
+			cached.index.inUse = true;
+			let current = false;
+			try {
+				current = cached.index.isCurrent() && cachedTrackedChangeBatchIdentityIndex === cached;
+			} finally {
+				if (!current) {
+					cached.index.inUse = false;
+					if (cachedTrackedChangeBatchIdentityIndex === cached) cachedTrackedChangeBatchIdentityIndex = null;
+				}
+			}
+			if (current) return cached.index;
+		}
+		const index = createTrackedChangeBatchIdentityIndex(documentId);
+		index.inUse = true;
+		cachedTrackedChangeBatchIdentityIndex = {
+			documentId,
+			index
+		};
+		return index;
+	};
+	const reconcileTrackedChangesFromV2 = ({ superdoc, adapter, documentId, items, pruneStale = true, preparedParams = null, preserveDraft = false, preparedPresentation = null, previousPreparedPresentation = null, liveIds: suppliedLiveIds = null, liveAnchorKeys: suppliedLiveAnchorKeys = null, hydrationGeneration } = {}) => withInteractionSpan("store.trackedChanges.reconcile", "store-reconciliation", {
 		documentId: documentId ?? null,
 		itemCount: Array.isArray(items) ? items.length : null,
 		pruneStale,
@@ -10519,13 +10603,15 @@ var useCommentsStore = defineStore("comments", () => {
 		const liveAnchorKeys = suppliedLiveAnchorKeys instanceof Set ? suppliedLiveAnchorKeys : /* @__PURE__ */ new Set();
 		const liveIds = suppliedLiveIds instanceof Set ? suppliedLiveIds : /* @__PURE__ */ new Set();
 		let appliedCount = 0;
-		const trackedChangeIdentityIndex = createTrackedChangeBatchIdentityIndex(effectiveDocumentId == null ? null : String(effectiveDocumentId));
+		const trackedChangeIdentityIndex = getTrackedChangeBatchIdentityIndex(effectiveDocumentId == null ? null : String(effectiveDocumentId));
 		const identitySpan = startInteractionSpan("store.trackedChanges.batchIdentity", "store-reconciliation", { itemCount: items.length });
-		const paramsList = Array.isArray(preparedParams) ? preparedParams : items.map((item) => adapter.mapV2TrackedChangeToCommentParams(item));
-		const previousCoordinate = previousPreparedPresentation?.coordinate;
-		const coordinate = preparedPresentation?.coordinate;
-		const retainUnchangedRows = !pruneStale && previousCoordinate && coordinate && coordinate.documentEpoch === preparedPresentation.epoch && coordinate.documentEpoch === previousPreparedPresentation.epoch && coordinate.documentEpoch === previousCoordinate.documentEpoch && typeof coordinate.mountId === "string" && coordinate.mountId.length > 0 && coordinate.mountId === previousCoordinate.mountId && preparedPresentation.baseVersion === previousPreparedPresentation.version && preparedPresentation.version === preparedPresentation.baseVersion + 1 && coordinate.reviewVersion === preparedPresentation.version && previousCoordinate.reviewVersion === previousPreparedPresentation.version && Number.isSafeInteger(coordinate.commitSequence) && Number.isSafeInteger(previousCoordinate.commitSequence) && coordinate.commitSequence >= previousCoordinate.commitSequence;
+		let enteredBatch = false;
 		try {
+			const paramsList = Array.isArray(preparedParams) ? preparedParams : items.map((item) => adapter.mapV2TrackedChangeToCommentParams(item));
+			const previousCoordinate = previousPreparedPresentation?.coordinate;
+			const coordinate = preparedPresentation?.coordinate;
+			const retainUnchangedRows = !pruneStale && previousCoordinate && coordinate && coordinate.documentEpoch === preparedPresentation.epoch && coordinate.documentEpoch === previousPreparedPresentation.epoch && coordinate.documentEpoch === previousCoordinate.documentEpoch && typeof coordinate.mountId === "string" && coordinate.mountId.length > 0 && coordinate.mountId === previousCoordinate.mountId && preparedPresentation.baseVersion === previousPreparedPresentation.version && preparedPresentation.version === preparedPresentation.baseVersion + 1 && coordinate.reviewVersion === preparedPresentation.version && previousCoordinate.reviewVersion === previousPreparedPresentation.version && Number.isSafeInteger(coordinate.commitSequence) && Number.isSafeInteger(previousCoordinate.commitSequence) && coordinate.commitSequence >= previousCoordinate.commitSequence;
+			enteredBatch = true;
 			for (const params of paramsList) {
 				if (!params) continue;
 				let retainUnchangedRow = false;
@@ -10560,12 +10646,15 @@ var useCommentsStore = defineStore("comments", () => {
 					superdoc,
 					params,
 					broadcastChanges: false,
-					trackedChangeIdentityIndex
+					trackedChangeIdentityIndex,
+					preserveDraft
 				});
 				appliedCount += 1;
 			}
 		} finally {
-			endInteractionSpan(identitySpan, trackedChangeIdentityIndex.work());
+			const work = trackedChangeIdentityIndex.work();
+			trackedChangeIdentityIndex.inUse = false;
+			if (enteredBatch) endInteractionSpan(identitySpan, work);
 		}
 		if (!effectiveDocumentId || !pruneStale) {
 			if (effectiveDocumentId) compactDuplicateBodyTrackedChangeComments(String(effectiveDocumentId));
@@ -14104,18 +14193,42 @@ var FloatingComments_default = /* @__PURE__ */ _plugin_vue_export_helper_default
 		const { activeComment, activeFloatingCommentInstanceId, editorCommentPositions, pendingComment, editingCommentId, instantSidebarAlignmentTargetY, instantSidebarAlignmentThreadId, instantSidebarAlignmentInstanceId } = storeToRefs(piniaCommentsStore);
 		const { activeZoom } = storeToRefs(superdocStore);
 		const committedPresentation = computed$1(() => commentsStore.committedReviewPresentations?.[String(props.currentDocument?.id)] ?? null);
+		const committedInstanceCache = /* @__PURE__ */ new Map();
+		let committedInstanceCacheOwner = "";
+		const sameReviewInstance = (cached, next) => {
+			const before = Object.entries(cached).filter(([key]) => key !== "comment" && key !== "rowVersion");
+			const after = Object.entries(next);
+			if (before.length !== after.length) return false;
+			const previous = new Map(before);
+			return after.every(([key, value]) => previous.has(key) && (key === "positionEntry" ? JSON.stringify(previous.get(key)) === JSON.stringify(value) : Object.is(previous.get(key), value)));
+		};
 		const committedInstances = computed$1(() => {
 			const presentation = committedPresentation.value;
 			if (!presentation) return null;
 			const rows = new Map(commentsStore.commentsList.filter((row) => String(row.fileId) === String(props.currentDocument?.id)).map((row) => [String(row.commentId), row]));
-			return presentation.instances.flatMap((instance) => {
+			const owner = `${presentation.epoch}\u0000${presentation.coordinate?.mountId ?? ""}`;
+			if (owner !== committedInstanceCacheOwner) {
+				committedInstanceCache.clear();
+				committedInstanceCacheOwner = owner;
+			}
+			const live = /* @__PURE__ */ new Set();
+			const instances = presentation.instances.flatMap((instance) => {
 				const comment = instance.rowId === "pending" ? pendingComment.value : rows.get(instance.rowId);
-				return comment ? [{
+				if (!comment) return [];
+				const rowVersion = presentation.rowVersions[instance.rowId] ?? 0;
+				live.add(instance.id);
+				const cached = committedInstanceCache.get(instance.id);
+				if (cached && cached.comment === comment && cached.rowVersion === rowVersion && sameReviewInstance(cached, instance)) return [cached];
+				const merged = {
 					...instance,
 					comment,
-					rowVersion: presentation.rowVersions[instance.rowId] ?? 0
-				}] : [];
+					rowVersion
+				};
+				committedInstanceCache.set(instance.id, merged);
+				return [merged];
 			});
+			for (const id of committedInstanceCache.keys()) if (!live.has(id)) committedInstanceCache.delete(id);
+			return instances;
 		});
 		const floatingCommentInstances = computed$1(() => {
 			if (committedInstances.value) return committedInstances.value.filter((instance) => instance.rowId !== "pending");
@@ -14531,6 +14644,18 @@ var FloatingComments_default = /* @__PURE__ */ _plugin_vue_export_helper_default
 				scheduleDeferredRemeasure(() => allPositions.value.map((pos) => pos.id));
 			});
 		};
+		const resizeHandlers = /* @__PURE__ */ new Map();
+		const resizeHandlerFor = (id) => {
+			let handler = resizeHandlers.get(id);
+			if (!handler) {
+				handler = () => {
+					const position = allPositions.value.find((candidate) => candidate.id === id);
+					if (position) handleResize(position);
+				};
+				resizeHandlers.set(id, handler);
+			}
+			return handler;
+		};
 		const setInstantLayoutTransitionsDisabled = (disabled) => {
 			if (!disabled && directDecisionContinuityTargetId.value != null) return;
 			disableInstantLayoutTransitions.value = disabled;
@@ -14935,6 +15060,7 @@ var FloatingComments_default = /* @__PURE__ */ _plugin_vue_export_helper_default
 				visibilityChanged = true;
 			}
 			if (visibilityChanged) visibleIds.value = newVisible;
+			for (const id of resizeHandlers.keys()) if (!currentIds.has(id)) resizeHandlers.delete(id);
 			for (const id of prevPositionIds) if (!currentIds.has(id)) delete _heightsCache[id];
 			const setChanged = prevPositionIds.size !== currentIds.size || [...prevPositionIds].some((id) => !currentIds.has(id));
 			const orderChanged = renderedPositionOrder.length !== positionOrder.length || renderedPositionOrder.some((id, index) => id !== positionOrder[index]);
@@ -15027,12 +15153,13 @@ var FloatingComments_default = /* @__PURE__ */ _plugin_vue_export_helper_default
 					style: normalizeStyle({
 						top: (pos.isOffscreenReviewCard && !committedPresentation.value ? pos.top - sidebarOffsetY.value : pos.top) + "px",
 						height: pos.height + "px",
-						transition: committedPresentation.value || disableInstantLayoutTransitions.value ? "none" : void 0
+						transition: committedPresentation.value || disableInstantLayoutTransitions.value ? "none" : void 0,
+						visibility: pos.instanceRef?.provisional ? "hidden" : void 0
 					})
 				}, [shouldRenderDialog(pos) ? (openBlock(), createBlock(CommentDialog_default, {
 					key: pos.id + commentsRenderKey.value,
 					onReady: handleDialog,
-					onResize: ($event) => handleResize(pos),
+					onResize: resizeHandlerFor(pos.id),
 					class: "floating-comment",
 					parent: __props.parent,
 					comment: pos.commentRef,
@@ -15052,7 +15179,7 @@ var FloatingComments_default = /* @__PURE__ */ _plugin_vue_export_helper_default
 			}), 128))], 4)], 36);
 		};
 	}
-}), [["__scopeId", "data-v-df897b8d"]]);
+}), [["__scopeId", "data-v-1070f5a1"]]);
 //#endregion
 //#region src/components/CommentsLayer/PdfCommentsLayer.vue?vue&type=script&setup=true&lang.ts
 var _hoisted_1$22 = {
@@ -15777,6 +15904,21 @@ function useCommentSmallScreen({ commentsModuleConfig, superdocRoot, layers }) {
 	};
 }
 //#endregion
+//#region src/composables/use-comment-sidebar.ts
+function useCommentSidebar({ documentKey, enabled, hasContent }) {
+	const reserved = ref(false);
+	watch$1(documentKey, () => {
+		reserved.value = false;
+	}, { flush: "sync" });
+	watch$1(() => enabled.value && hasContent.value, (visible) => {
+		if (visible) reserved.value = true;
+	}, {
+		immediate: true,
+		flush: "sync"
+	});
+	return computed$1(() => enabled.value && (hasContent.value || reserved.value));
+}
+//#endregion
 //#region src/composables/use-compact-comment-popover.ts
 var POPOVER_WIDTH_PX = 320;
 var SAFE_MARGIN_PX = 12;
@@ -20655,7 +20797,7 @@ var SuperDoc_default = /* @__PURE__ */ _plugin_vue_export_helper_default(/* @__P
 			if (commentsConfig.highlightHoverColor) vars["--sd-comments-highlight-hover"] = commentsConfig.highlightHoverColor;
 			const activeTrackChangeColors = {
 				...commentsConfig.trackChangeHighlightColors || {},
-				...commentsConfig.trackChangeActiveHighlightColors || {}
+				...commentsConfig.trackChangeActiveHighlightColors
 			};
 			if (activeTrackChangeColors.insertBorder) vars["--sd-tracked-changes-insert-border"] = activeTrackChangeColors.insertBorder;
 			if (activeTrackChangeColors.insertBackground) vars["--sd-tracked-changes-insert-background"] = activeTrackChangeColors.insertBackground;
@@ -21635,7 +21777,7 @@ var SuperDoc_default = /* @__PURE__ */ _plugin_vue_export_helper_default(/* @__P
 		const publishV2PendingPositionEntry = (entry) => {
 			if (!entry) return;
 			handleEditorLocationsUpdate({
-				...editorCommentPositions.value ?? {},
+				...editorCommentPositions.value,
 				pending: entry
 			});
 		};
@@ -22174,7 +22316,7 @@ var SuperDoc_default = /* @__PURE__ */ _plugin_vue_export_helper_default(/* @__P
 				documentLoading: proxy.$superdoc.uiConfig.loading.enabled,
 				linkPopoverResolver: getHyperlinkActivationHandler(),
 				layoutEngineOptions: useLayoutEngine ? {
-					...proxy.$superdoc.config.layoutEngineOptions || {},
+					...proxy.$superdoc.config.layoutEngineOptions,
 					proofing: resolvedProofingConfig.value,
 					debugLabel: proxy.$superdoc.config.layoutEngineOptions?.debugLabel ?? doc.name ?? doc.id,
 					zoom: (activeZoom.value ?? 100) / 100,
@@ -22437,11 +22579,16 @@ var SuperDoc_default = /* @__PURE__ */ _plugin_vue_export_helper_default(/* @__P
 			if (layout !== "auto") return true;
 			return !isCompactCommentsMode.value;
 		});
-		const showCommentsSidebar = computed$1(() => {
+		const sidebarEnabled = computed$1(() => {
 			if (isV2Mode.value && !v2GeometryAvailable.value && !v2ReviewSidebarUnlocked.value && !hasPdfFloatingComments.value) return false;
 			if (!shouldRenderCommentsInViewing.value) return false;
 			if (!shouldUseSidebarComments.value) return false;
-			return pendingComment.value || (floatingComments.value.length > 0 || hasOpenTrackedChanges.value) && isReady.value && layers.value && isCommentsEnabled.value && !isCommentsListVisible.value;
+			return Boolean(pendingComment.value || isReady.value && layers.value && isCommentsEnabled.value && !isCommentsListVisible.value);
+		});
+		const showCommentsSidebar = useCommentSidebar({
+			documentKey: computed$1(() => JSON.stringify(documents.value.map((document) => document.id))),
+			enabled: sidebarEnabled,
+			hasContent: computed$1(() => Boolean(pendingComment.value || floatingComments.value.length || hasOpenTrackedChanges.value))
 		});
 		const activeCompactComment = computed$1(() => {
 			if (showCommentsSidebar.value) return null;
@@ -23065,7 +23212,7 @@ var SuperDoc_default = /* @__PURE__ */ _plugin_vue_export_helper_default(/* @__P
 				ref_key: "superdocRoot",
 				ref: superdocRoot,
 				class: normalizeClass(["superdoc", {
-					"superdoc--with-sidebar": showCommentsSidebar.value,
+					"superdoc--with-sidebar": unref(showCommentsSidebar),
 					"superdoc--web-layout": unref(proxy).$superdoc.config.viewOptions?.layout === "web",
 					"superdoc--contained": unref(proxy).$superdoc.config.contained,
 					"high-contrast": unref(isHighContrastMode)
@@ -23213,7 +23360,7 @@ var SuperDoc_default = /* @__PURE__ */ _plugin_vue_export_helper_default(/* @__P
 						onAnchorActivate: handleHighlightClick
 					})) : createCommentVNode("", true)
 				])], 512),
-				showCommentsSidebar.value ? (openBlock(), createElementBlock("div", {
+				unref(showCommentsSidebar) ? (openBlock(), createElementBlock("div", {
 					key: 0,
 					ref_key: "rightSidebarRef",
 					ref: rightSidebarRef,
@@ -23236,7 +23383,7 @@ var SuperDoc_default = /* @__PURE__ */ _plugin_vue_export_helper_default(/* @__P
 			], 46, _hoisted_1$17);
 		};
 	}
-}), [["__scopeId", "data-v-7c932add"]]);
+}), [["__scopeId", "data-v-451ab88f"]]);
 //#endregion
 //#region src/core/create-app.ts
 var PINIA_DEVTOOLS_SETUP_EVENT = "devtools-plugin:setup";
@@ -24915,7 +25062,8 @@ function normalizeSuperDocUser(user) {
 	if (!user || typeof user !== "object") return { ...DEFAULT_SUPERDOC_USER };
 	return {
 		...DEFAULT_SUPERDOC_USER,
-		...user
+		...user,
+		...user.commentIdentity !== void 0 ? { commentIdentity: normalizeCommentIdentity(user.commentIdentity) } : {}
 	};
 }
 //#endregion
@@ -25434,6 +25582,7 @@ function normalizeUiConfig(config = {}) {
 * Keeping policy separate means an application can disable the built-in
 * comments UI without losing the rules enforced by its custom UI.
 */
+var isAutocapitalize = (value) => value === "off" || value === "sentences" || value === "words" || value === "characters";
 var isCommentInteractionLevel = (value) => value === "read" || value === "write" || value === "resolve";
 /**
 * Resolve the effective interaction policy.
@@ -25453,14 +25602,26 @@ function normalizeInteractionConfig(config = {}) {
 	const canonicalLevel = interactionComments.level;
 	const hasCanonicalLevel = isCommentInteractionLevel(canonicalLevel);
 	const level = hasCanonicalLevel ? canonicalLevel : legacyReadOnly ? "read" : legacyAllowResolve ? "resolve" : "write";
+	const interactionWritingAssistance = isPlainObject$1(interaction.writingAssistance) ? interaction.writingAssistance : {};
+	const autocorrect = interactionWritingAssistance.autocorrect === true;
+	const autocapitalize = isAutocapitalize(interactionWritingAssistance.autocapitalize) ? interactionWritingAssistance.autocapitalize : "off";
+	const spellcheck = interactionWritingAssistance.spellcheck === true;
 	const canonicalAllowDecisions = interactionTrackedChanges.allowDecisions;
+	const interactionTouch = isPlainObject$1(interaction.touch) ? interaction.touch : {};
 	return {
 		comments: {
 			level,
 			readOnly: hasCanonicalLevel ? level === "read" : legacyReadOnly,
 			allowResolve: hasCanonicalLevel ? level === "resolve" : legacyAllowResolve
 		},
-		trackedChanges: { allowDecisions: typeof canonicalAllowDecisions === "boolean" ? canonicalAllowDecisions : !legacyReadOnly }
+		trackedChanges: { allowDecisions: typeof canonicalAllowDecisions === "boolean" ? canonicalAllowDecisions : !legacyReadOnly },
+		touch: { gestures: interactionTouch.gestures === true },
+		writingAssistance: {
+			enabled: autocorrect || autocapitalize !== "off" || spellcheck,
+			autocorrect,
+			autocapitalize,
+			spellcheck
+		}
 	};
 }
 //#endregion
@@ -31967,7 +32128,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 commandState?.reason !== "document-readonly";
+	if (name === "fontFamily" || name === "fontSize") return commandState?.reason !== "document-readonly" && commandState?.reason !== "deleted-text-formatting-unsupported";
 	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;
@@ -32001,6 +32162,7 @@ var RESERVED_TOOLBAR_ITEM_NAMES = /* @__PURE__ */ new Set([
 * proof lane, and behavior tests resolve against a real object.
 */
 var BuiltInToolbar = class extends import_eventemitter3.default {
+	#formattingRefusalTooltips;
 	#imagePicker;
 	#groupItems;
 	#highlightOptions;
@@ -32032,6 +32194,7 @@ var BuiltInToolbar = class extends import_eventemitter3.default {
 			showPageNumberButton: false
 		};
 		this.toolbarItems = [];
+		this.#formattingRefusalTooltips = /* @__PURE__ */ new WeakMap();
 		this.overflowItems = [];
 		this.pendingSelectionCapture = void 0;
 		this.#imagePicker = null;
@@ -32492,6 +32655,13 @@ var BuiltInToolbar = class extends import_eventemitter3.default {
 		const commandId = resolveBuiltInItemCommandId(name);
 		if (!commandId) return false;
 		const commandState = this.snapshot?.commands?.[commandId];
+		if (commandState?.reason === "deleted-text-formatting-unsupported") {
+			if (!this.#formattingRefusalTooltips.has(item)) this.#formattingRefusalTooltips.set(item, item.tooltip.value);
+			item.tooltip.value = "Select kept text, or accept or reject the deletion before formatting.";
+		} else if (this.#formattingRefusalTooltips.has(item)) {
+			item.tooltip.value = this.#formattingRefusalTooltips.get(item);
+			this.#formattingRefusalTooltips.delete(item);
+		}
 		if ((name === "list" || name === "numberedlist") && item.attributes.value.ariaBusy !== Boolean(commandState?.pending)) item.attributes.value = {
 			...item.attributes.value,
 			ariaBusy: Boolean(commandState?.pending)
@@ -33012,6 +33182,7 @@ function runtimeUserOf(user) {
 	const text = (value) => typeof value === "string" && value ? value : void 0;
 	return {
 		name: text(user.name) ?? "",
+		...user.commentIdentity !== void 0 ? { commentIdentity: user.commentIdentity ? { ...user.commentIdentity } : null } : {},
 		...text(user.id) ? { id: text(user.id) } : {},
 		...text(user.email) ? { email: text(user.email) } : {},
 		...text(user.initials) ? { initials: text(user.initials) } : {}
@@ -33258,6 +33429,7 @@ var SuperDoc = class extends import_eventemitter3.default {
 		if (!config.selector) throw new Error("SuperDoc: selector is required");
 		const container = typeof config.selector === "string" ? document.querySelector(config.selector) : config.selector;
 		if (!(container instanceof HTMLElement)) throw new Error("SuperDoc: selector must be a valid CSS selector string or DOM element");
+		const user = normalizeSuperDocUser(config.user);
 		this.#diagnostics = createInteractionHistory(this, config, () => this.version, container);
 		this.#surfaceManager = new SurfaceManager({ getModuleConfig: () => this.#surfacesConfig });
 		this.#contentControlClickRoot = container;
@@ -33267,7 +33439,10 @@ var SuperDoc = class extends import_eventemitter3.default {
 		container.addEventListener("keydown", this.#handleContentControlKeyDown, true);
 		container.addEventListener("click", this.#handleContentControlClick, true);
 		this.#onConfig("content-control:active-change", config.onContentControlActiveChange);
-		this.#init(config, container);
+		this.#init({
+			...config,
+			user
+		}, container);
 		this.#contentControlEventBridgeReady = true;
 		if (this.listenerCount("content-control:active-change") > 0) this.ui;
 	}
@@ -33320,7 +33495,6 @@ var SuperDoc = class extends import_eventemitter3.default {
 		}
 		this.editorVersion = 2;
 		this.#validateLegacyConfig();
-		this.config.user = normalizeSuperDocUser(this.config.user);
 		if (!this.config.layoutEngineOptions.virtualization) this.config.layoutEngineOptions.virtualization = {
 			enabled: true,
 			window: 5,
@@ -33346,7 +33520,7 @@ var SuperDoc = class extends import_eventemitter3.default {
 		}
 		this.userColorMap = /* @__PURE__ */ new Map();
 		this.colorIndex = 0;
-		this.version = "2.30.0-next.4";
+		this.version = "2.30.0-next.9";
 		this.#log("🦋 [superdoc] Using SuperDoc version:", this.version);
 		this.superdocId = config.superdocId || v4();
 		this.colors = this.config.colors ?? [];
@@ -34219,10 +34393,15 @@ var SuperDoc = class extends import_eventemitter3.default {
 		this.#requireReady("setUser");
 		const name = typeof user?.name === "string" ? user.name.trim() : "";
 		if (!name) return Promise.reject(/* @__PURE__ */ new TypeError("SuperDoc.setUser requires a non-empty user name."));
-		const next = normalizeSuperDocUser({
-			...user,
-			name
-		});
+		let next;
+		try {
+			next = normalizeSuperDocUser({
+				...user,
+				name
+			});
+		} catch (error) {
+			return Promise.reject(error);
+		}
 		const applied = this.#userSwitch.then(() => this.#applyUser(next));
 		this.#userSwitch = applied.catch(() => {});
 		return applied;
@@ -34236,7 +34415,7 @@ var SuperDoc = class extends import_eventemitter3.default {
 			"email",
 			"image",
 			"initials"
-		].every((key) => (current[key] ?? null) === (next[key] ?? null))) return;
+		].every((key) => (current[key] ?? null) === (next[key] ?? null)) && current.commentIdentity === void 0 === (next.commentIdentity === void 0) && (current.commentIdentity?.providerId ?? null) === (next.commentIdentity?.providerId ?? null) && (current.commentIdentity?.userId ?? null) === (next.commentIdentity?.userId ?? null)) return;
 		const runtimes = this.#editorRuntimeRegistry.getAll();
 		const results = await Promise.allSettled(runtimes.map((runtime) => runtime.setUser?.(runtimeUserOf(next))));
 		const failure = results.find((result) => result.status === "rejected");