superdoc 2.27.0 → 2.28.0-next.10

package/dist/superdoc.cjs

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_rolldown_runtime = require("./chunks/rolldown-runtime-74VwNCz7.cjs");
 const require_blank_docx = require("./chunks/blank-docx-BuFAbRjs.cjs");
-const require_create_super_doc_ui = require("./chunks/create-super-doc-ui-DpVh2nQH.cjs");
+const require_create_super_doc_ui = require("./chunks/create-super-doc-ui-B4c55pFy.cjs");
 const require_eventemitter3 = require("./chunks/eventemitter3-C_TAnXOl.cjs");
 const require_uuid = require("./chunks/uuid-BhG0ngwk.cjs");
 const require__plugin_vue_export_helper = require("./chunks/_plugin-vue_export-helper-BUdjGKyl.cjs");
@@ -260,7 +260,7 @@ var v_click_outside_default = {
 var DEFAULT_ENDPOINT = "https://ingest.superdoc.dev/v1/collect";
 function getSuperdocVersion() {
 	try {
-		return "2.27.0";
+		return "2.28.0-next.10";
 	} catch {
 		return "unknown";
 	}
@@ -5464,7 +5464,8 @@ function resolveWebsocketFamily(family, candidate) {
 			roomMode,
 			serverUrl,
 			...params ? { params } : {},
-			...token ? { token } : {}
+			...token ? { token } : {},
+			...family === "hocuspocus" && candidate.retry !== void 0 ? { retry: candidate.retry } : {}
 		}
 	};
 }
@@ -7187,16 +7188,6 @@ function createDefaultV2Integration() {
 		return createStubV2Integration();
 	}
 }
-/**
-* Backwards-compatible alias. The v2 branch no longer reads any customer
-* config; the parameter is ignored and retained only so existing call sites do
-* not need to change in lockstep with this internalization.
-*
-* @returns {SuperDocV2Integration}
-*/
-function resolveV2Integration() {
-	return createDefaultV2Integration();
-}
 //#endregion
 //#region src/helpers/interaction-trace.js
 function safeTraceCollector() {
@@ -7755,6 +7746,7 @@ var useCommentsStore = defineStore("comments", () => {
 	const instantSidebarAlignmentInstanceId = require__plugin_vue_export_helper.ref(null);
 	const pendingComment = require__plugin_vue_export_helper.ref(null);
 	const pendingV2CommentTarget = require__plugin_vue_export_helper.shallowRef(null);
+	let pendingCommentRequest = 0;
 	const isViewingMode = require__plugin_vue_export_helper.computed(() => viewingVisibility.documentMode === "viewing");
 	const shouldRenderReviewInViewing = require__plugin_vue_export_helper.computed(() => {
 		if (!isViewingMode.value) return true;
@@ -7762,6 +7754,7 @@ var useCommentsStore = defineStore("comments", () => {
 	});
 	const v2CommentsAdapter = require__plugin_vue_export_helper.shallowRef(null);
 	const setV2CommentsAdapter = (adapter) => {
+		if (v2CommentsAdapter.value !== (adapter ?? null)) pendingCommentRequest += 1;
 		v2CommentsAdapter.value = adapter ?? null;
 	};
 	const getV2CommentsAdapter = (superdoc) => {
@@ -8620,26 +8613,41 @@ var useCommentsStore = defineStore("comments", () => {
 		}
 		if (typeof currentSelection !== "function") return null;
 		try {
-			return currentSelection();
+			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;
 		const v2Adapter = getV2CommentsAdapter(superdoc);
-		const pendingSelection = getPendingSelectionSnapshot(superdoc, superdocStore.activeSelection);
-		const event = {
-			type: COMMENT_EVENTS.PENDING,
-			pendingSelection
+		const ownsRequest = () => pendingCommentRequest === request;
+		const emitPending = (snapshot) => {
+			if (!ownsRequest()) return;
+			superdoc.emit("comments-update", {
+				type: COMMENT_EVENTS.PENDING,
+				pendingSelection: superdoc?.activeEditor === editor ? snapshot : null
+			});
 		};
-		superdoc.emit("comments-update", event);
 		if (v2Adapter) {
 			const cap = v2Adapter.getCapabilityState?.();
 			if (cap && cap.canWrite === false) return {
 				ok: false,
 				reason: cap.reason
 			};
-			return Promise.resolve(v2Adapter.captureCurrentSelection?.()).then((capture) => {
+			return Promise.resolve(v2Adapter.captureCurrentSelection?.({ beforeReady: (snapshot) => {
+				if (superdoc?.activeEditor === editor && getV2CommentsAdapter(superdoc) === v2Adapter) emitPending(snapshot);
+			} })).then((capture) => {
+				if (!ownsRequest()) return {
+					ok: false,
+					reason: "pending-comment-superseded"
+				};
+				if (superdoc?.activeEditor !== editor || getV2CommentsAdapter(superdoc) !== v2Adapter) return {
+					ok: false,
+					reason: "document-replaced"
+				};
 				if (!capture?.ok) return {
 					ok: false,
 					reason: capture?.reason ?? "editing-range-required",
@@ -8668,25 +8676,52 @@ var useCommentsStore = defineStore("comments", () => {
 				detail: err?.message ?? String(err)
 			}));
 		}
-		const selection = { ...superdocStore.activeSelection };
-		selection.selectionBounds = { ...selection.selectionBounds };
-		if (superdocStore.selectionPosition?.source && superdocStore.selectionPosition.source !== "pdf") superdocStore.selectionPosition.source = null;
-		pendingComment.value = getPendingComment({
-			selection,
-			documentId: selection.documentId,
-			parentCommentId: null
-		});
-		if (!superdoc.config.isInternal) pendingComment.value.isInternal = false;
-		if (superdoc.activeEditor?.commands) superdoc.activeEditor.commands.insertComment({
-			...pendingComment.value.getValues(),
-			commentId: "pending",
-			skipEmit: true
-		});
-		if (pendingComment.value.selection.source === "document-editor" && superdocStore.selectionPosition) superdocStore.selectionPosition.source = DOCUMENT_EDITOR_SELECTION_SOURCE;
-		requestInstantSidebarAlignment(targetClientY, "pending");
-		setActiveFloatingCommentInstance(null);
-		activeComment.value = pendingComment.value.commentId;
-		return { ok: true };
+		const pendingSelection = getPendingSelectionSnapshot(superdoc, superdocStore.activeSelection);
+		const asyncSnapshot = typeof pendingSelection?.then === "function";
+		if (!asyncSnapshot) emitPending(pendingSelection);
+		const showLegacyPending = (selection) => {
+			selection.selectionBounds = { ...selection.selectionBounds };
+			if (superdocStore.selectionPosition?.source && superdocStore.selectionPosition.source !== "pdf") superdocStore.selectionPosition.source = null;
+			pendingComment.value = getPendingComment({
+				selection,
+				documentId: selection.documentId,
+				parentCommentId: null
+			});
+			if (!superdoc.config.isInternal) pendingComment.value.isInternal = false;
+			if (superdoc.activeEditor?.commands) superdoc.activeEditor.commands.insertComment({
+				...pendingComment.value.getValues(),
+				commentId: "pending",
+				skipEmit: true
+			});
+			if (pendingComment.value.selection.source === "document-editor" && superdocStore.selectionPosition) superdocStore.selectionPosition.source = DOCUMENT_EDITOR_SELECTION_SOURCE;
+			requestInstantSidebarAlignment(targetClientY, "pending");
+			setActiveFloatingCommentInstance(null);
+			activeComment.value = pendingComment.value.commentId;
+			return { ok: true };
+		};
+		if (asyncSnapshot) {
+			const selection = { ...superdocStore.activeSelection };
+			selection.selectionBounds = { ...selection.selectionBounds };
+			return pendingSelection.then((snapshot) => {
+				if (!ownsRequest()) return {
+					ok: false,
+					reason: "pending-comment-superseded"
+				};
+				emitPending(snapshot);
+				if (!ownsRequest()) return {
+					ok: false,
+					reason: "pending-comment-superseded"
+				};
+				return superdoc?.activeEditor === editor ? showLegacyPending(selection) : {
+					ok: false,
+					reason: "document-replaced"
+				};
+			});
+		}
+		return ownsRequest() ? showLegacyPending({ ...superdocStore.activeSelection }) : {
+			ok: false,
+			reason: "pending-comment-superseded"
+		};
 	};
 	/**
 	* Get the numeric position value for sorting a comment by document order.
@@ -8841,7 +8876,7 @@ var useCommentsStore = defineStore("comments", () => {
 	*
 	* @returns {void}
 	*/
-	const removePendingComment = (superdoc) => {
+	const resetPendingCommentState = (superdoc, clearViewingSelection = true) => {
 		const hadPending = !!pendingComment.value;
 		currentCommentText.value = "";
 		currentCommentMentions.value = [];
@@ -8850,13 +8885,17 @@ var useCommentsStore = defineStore("comments", () => {
 		superdocStore.selectionPosition = null;
 		if (hadPending) clearActiveCommentSelection();
 		if (isV2EditorActive(superdoc)) {
-			if (hadPending && isViewingMode.value) try {
+			if (hadPending && clearViewingSelection && isViewingMode.value) try {
 				superdoc?.activeEditor?.host?.getHandles?.()?.selection?.clear?.();
 			} catch {}
 			return;
 		}
 		superdoc?.activeEditor?.commands?.removeComment({ commentId: "pending" });
 	};
+	const removePendingComment = (superdoc) => {
+		pendingCommentRequest += 1;
+		resetPendingCommentState(superdoc);
+	};
 	const getV2CreatedComment = ({ outcome, reconciled, documentId }) => {
 		const createdId = normalizeCommentId(outcome?.createdCommentId);
 		if (!createdId) return reconciled?.added ?? null;
@@ -8874,6 +8913,7 @@ var useCommentsStore = defineStore("comments", () => {
 		const v2Adapter = !skipEditorUpdate && !isHydration ? getV2CommentsAdapter(superdoc) : null;
 		if (v2Adapter && !comment.trackedChange) {
 			const submittedPendingComment = pendingComment.value;
+			const submittedPendingRequest = pendingCommentRequest;
 			const text = normalizeV2CommentDraftText(submittedPendingComment ? currentCommentText.value : comment.commentText);
 			const mentions = pendingComment.value ? currentCommentMentions.value : comment.mentions ?? [];
 			const target = pendingComment.value ? pendingV2CommentTarget.value : null;
@@ -8922,9 +8962,11 @@ var useCommentsStore = defineStore("comments", () => {
 					documentId: v2Adapter.documentId
 				});
 				const hadPendingComment = submittedPendingComment != null && pendingComment.value?.commentId === submittedPendingComment.commentId;
-				if (hadPendingComment) removePendingComment(superdoc);
+				const ownsSubmittedRequest = pendingCommentRequest === submittedPendingRequest;
+				if (hadPendingComment) if (ownsSubmittedRequest) removePendingComment(superdoc);
+				else resetPendingCommentState(superdoc, false);
 				const createdId = created?.commentId ?? null;
-				if (hadPendingComment && createdId) {
+				if (hadPendingComment && ownsSubmittedRequest && createdId) {
 					setActiveComment(superdoc, createdId);
 					setActiveFloatingCommentInstance(createdId);
 				}
@@ -9021,6 +9063,8 @@ var useCommentsStore = defineStore("comments", () => {
 					rejected: true,
 					comment: comment.getValues(),
 					reason: outcome?.reason ?? "v2-delete-failed",
+					...outcome?.code !== void 0 ? { code: outcome.code } : {},
+					...outcome?.detail !== void 0 ? { detail: outcome.detail } : {},
 					...outcome?.committed ? { committed: true } : {}
 				});
 				return outcome;
@@ -12255,11 +12299,11 @@ function useUiFontFamily() {
 //#region src/components/CommentsLayer/CommentsDropdown.vue
 var _hoisted_1$31 = { class: "comments-dropdown" };
 var _hoisted_2$24 = ["onClick"];
-var _hoisted_3$20 = {
+var _hoisted_3$21 = {
 	key: 0,
 	class: "comments-dropdown__option-icon"
 };
-var _hoisted_4$14 = ["innerHTML"];
+var _hoisted_4$15 = ["innerHTML"];
 var _hoisted_5$11 = { class: "comments-dropdown__option-label" };
 var _sfc_main$38 = {
 	__name: "CommentsDropdown",
@@ -12400,10 +12444,10 @@ var _sfc_main$38 = {
 					key: option.key,
 					class: require__plugin_vue_export_helper.normalizeClass(["comments-dropdown__option", { "sd-disabled": option.disabled }]),
 					onClick: ($event) => onOptionClick(option)
-				}, [hasIcon(option) ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("span", _hoisted_3$20, [option.iconString ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("span", {
+				}, [hasIcon(option) ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("span", _hoisted_3$21, [option.iconString ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("span", {
 					key: 0,
 					innerHTML: option.iconString
-				}, null, 8, _hoisted_4$14)) : (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createBlock(require__plugin_vue_export_helper.unref(OptionIcon), {
+				}, null, 8, _hoisted_4$15)) : (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createBlock(require__plugin_vue_export_helper.unref(OptionIcon), {
 					key: 1,
 					option
 				}, null, 8, ["option"]))])) : require__plugin_vue_export_helper.createCommentVNode("", true), require__plugin_vue_export_helper.createElementVNode("span", _hoisted_5$11, require__plugin_vue_export_helper.toDisplayString(option.label), 1)], 10, _hoisted_2$24);
@@ -12416,8 +12460,8 @@ var CommentsDropdown_default = /*#__PURE__*/ require__plugin_vue_export_helper._
 //#region src/components/CommentsLayer/InternalDropdown.vue
 var _hoisted_1$30 = { class: "sd-comment-option" };
 var _hoisted_2$23 = ["innerHTML"];
-var _hoisted_3$19 = { class: "sd-option-state" };
-var _hoisted_4$13 = ["innerHTML"];
+var _hoisted_3$20 = { class: "sd-option-state" };
+var _hoisted_4$14 = ["innerHTML"];
 var _sfc_main$37 = {
 	__name: "InternalDropdown",
 	props: {
@@ -12490,11 +12534,11 @@ var _sfc_main$37 = {
 						class: "sd-active-icon",
 						innerHTML: activeIcon.value
 					}, null, 8, _hoisted_2$23),
-					require__plugin_vue_export_helper.createElementVNode("div", _hoisted_3$19, require__plugin_vue_export_helper.toDisplayString(getState.value), 1),
+					require__plugin_vue_export_helper.createElementVNode("div", _hoisted_3$20, require__plugin_vue_export_helper.toDisplayString(getState.value), 1),
 					require__plugin_vue_export_helper.createElementVNode("div", {
 						class: "sd-dropdown-caret",
 						innerHTML: require__plugin_vue_export_helper.unref(superdocIcons).caretDown
-					}, null, 8, _hoisted_4$13)
+					}, null, 8, _hoisted_4$14)
 				])]),
 				_: 1
 			}, 8, ["disabled", "content-style"])], 4);
@@ -12653,7 +12697,7 @@ var isAllowed = (permission, role, isInternal, context = {}) => {
 //#region src/components/general/Avatar.vue
 var _hoisted_1$29 = { class: "user-container" };
 var _hoisted_2$22 = ["src"];
-var _hoisted_3$18 = {
+var _hoisted_3$19 = {
 	key: 1,
 	class: "user-bg"
 };
@@ -12678,7 +12722,7 @@ var _sfc_main$36 = {
 				key: 0,
 				class: "user-bg",
 				src: __props.user.image.startsWith("http") ? __props.user.image : `data:image/png;base64,${__props.user.image}`
-			}, null, 8, _hoisted_2$22)) : (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("span", _hoisted_3$18, require__plugin_vue_export_helper.toDisplayString(getInitials(__props.user.name, __props.user.email)), 1))]);
+			}, null, 8, _hoisted_2$22)) : (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("span", _hoisted_3$19, require__plugin_vue_export_helper.toDisplayString(getInitials(__props.user.name, __props.user.email)), 1))]);
 		};
 	}
 };
@@ -12687,8 +12731,8 @@ var Avatar_default = /*#__PURE__*/ require__plugin_vue_export_helper._plugin_vue
 //#region src/components/CommentsLayer/CommentHeader.vue
 var _hoisted_1$28 = { class: "card-section comment-header" };
 var _hoisted_2$21 = { class: "comment-header-left" };
-var _hoisted_3$17 = { class: "user-info" };
-var _hoisted_4$12 = { class: "user-name" };
+var _hoisted_3$18 = { class: "user-info" };
+var _hoisted_4$13 = { class: "user-name" };
 var _hoisted_5$10 = {
 	key: 0,
 	class: "imported-tag"
@@ -12948,7 +12992,7 @@ var _sfc_main$35 = {
 			return require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("div", _hoisted_1$28, [require__plugin_vue_export_helper.createElementVNode("div", _hoisted_2$21, [require__plugin_vue_export_helper.createVNode(Avatar_default, {
 				user: getCurrentUser.value,
 				class: "avatar"
-			}, null, 8, ["user"]), require__plugin_vue_export_helper.createElementVNode("div", _hoisted_3$17, [require__plugin_vue_export_helper.createElementVNode("div", _hoisted_4$12, [require__plugin_vue_export_helper.createTextVNode(require__plugin_vue_export_helper.toDisplayString(getCurrentUser.value.name), 1), isImported.value ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("span", _hoisted_5$10, "IMPORTED")) : require__plugin_vue_export_helper.createCommentVNode("", true)]), props.comment.createdTime ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("div", _hoisted_6$8, require__plugin_vue_export_helper.toDisplayString(require__plugin_vue_export_helper.unref(formatDate)(props.comment.createdTime)), 1)) : require__plugin_vue_export_helper.createCommentVNode("", true)])]), require__plugin_vue_export_helper.createElementVNode("div", { class: require__plugin_vue_export_helper.normalizeClass(["overflow-menu", { "is-visible": props.isActive }]) }, [
+			}, null, 8, ["user"]), require__plugin_vue_export_helper.createElementVNode("div", _hoisted_3$18, [require__plugin_vue_export_helper.createElementVNode("div", _hoisted_4$13, [require__plugin_vue_export_helper.createTextVNode(require__plugin_vue_export_helper.toDisplayString(getCurrentUser.value.name), 1), isImported.value ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("span", _hoisted_5$10, "IMPORTED")) : require__plugin_vue_export_helper.createCommentVNode("", true)]), props.comment.createdTime ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("div", _hoisted_6$8, require__plugin_vue_export_helper.toDisplayString(require__plugin_vue_export_helper.unref(formatDate)(props.comment.createdTime)), 1)) : require__plugin_vue_export_helper.createCommentVNode("", true)])]), require__plugin_vue_export_helper.createElementVNode("div", { class: require__plugin_vue_export_helper.normalizeClass(["overflow-menu", { "is-visible": props.isActive }]) }, [
 				allowResolve.value ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("div", {
 					key: 0,
 					class: require__plugin_vue_export_helper.normalizeClass(["overflow-menu__icon", { "sd-is-disabled": Boolean(__props.resolveDisabledReason) }]),
@@ -12999,12 +13043,12 @@ var CommentHeader_default = /*#__PURE__*/ require__plugin_vue_export_helper._plu
 //#region src/components/CommentsLayer/CommentInput.vue
 var _hoisted_1$27 = { class: "input-section" };
 var _hoisted_2$20 = { class: "comment-composer" };
-var _hoisted_3$16 = [
+var _hoisted_3$17 = [
 	"aria-expanded",
 	"aria-controls",
 	"aria-activedescendant"
 ];
-var _hoisted_4$11 = [
+var _hoisted_4$12 = [
 	"id",
 	"aria-selected",
 	"data-sd-comment-mention-option",
@@ -13194,7 +13238,7 @@ var _sfc_main$34 = {
 				onKeydown,
 				onFocus: _cache[1] || (_cache[1] = ($event) => handleFocusChange(true)),
 				onBlur: _cache[2] || (_cache[2] = ($event) => handleFocusChange(false))
-			}, null, 40, _hoisted_3$16), [[require__plugin_vue_export_helper.vModelText, commentDraft.value]]), mentionListOpen.value ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("div", {
+			}, null, 40, _hoisted_3$17), [[require__plugin_vue_export_helper.vModelText, commentDraft.value]]), mentionListOpen.value ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("div", {
 				key: 0,
 				id: mentionListId,
 				class: "comment-mention-list",
@@ -13210,7 +13254,7 @@ var _sfc_main$34 = {
 					"aria-selected": index === highlightedMentionIndex.value,
 					"data-sd-comment-mention-option": userKey(user),
 					onMousedown: require__plugin_vue_export_helper.withModifiers(($event) => selectMention(user), ["prevent"])
-				}, [require__plugin_vue_export_helper.createElementVNode("span", _hoisted_5$9, require__plugin_vue_export_helper.toDisplayString(displayName(user)), 1), user.email ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("span", _hoisted_6$7, require__plugin_vue_export_helper.toDisplayString(user.email), 1)) : require__plugin_vue_export_helper.createCommentVNode("", true)], 42, _hoisted_4$11);
+				}, [require__plugin_vue_export_helper.createElementVNode("span", _hoisted_5$9, require__plugin_vue_export_helper.toDisplayString(displayName(user)), 1), user.email ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("span", _hoisted_6$7, require__plugin_vue_export_helper.toDisplayString(user.email), 1)) : require__plugin_vue_export_helper.createCommentVNode("", true)], 42, _hoisted_4$12);
 			}), 128))])) : require__plugin_vue_export_helper.createCommentVNode("", true)])], 2)]);
 		};
 	}
@@ -13337,98 +13381,108 @@ var _hoisted_2$19 = {
 	key: 0,
 	class: "existing-internal-input"
 };
-var _hoisted_3$15 = { class: "new-comment-input-wrapper" };
-var _hoisted_4$10 = { class: "reply-actions" };
-var _hoisted_5$8 = ["disabled"];
-var _hoisted_6$6 = {
+var _hoisted_3$16 = { class: "new-comment-input-wrapper" };
+var _hoisted_4$11 = {
+	key: 1,
+	class: "tracked-change-decision-alert",
+	role: "alert"
+};
+var _hoisted_5$8 = { class: "reply-actions" };
+var _hoisted_6$6 = ["disabled"];
+var _hoisted_7$4 = {
 	key: 0,
 	class: "resolved-badge"
 };
-var _hoisted_7$4 = ["innerHTML"];
-var _hoisted_8$4 = {
+var _hoisted_8$4 = ["innerHTML"];
+var _hoisted_9$3 = {
 	key: 1,
 	class: "existing-internal-input"
 };
-var _hoisted_9$3 = {
+var _hoisted_10$3 = {
+	key: 2,
+	class: "tracked-change-decision-alert",
+	role: "alert"
+};
+var _hoisted_11$3 = {
 	key: 0,
 	class: "card-section comment-body"
 };
-var _hoisted_10$3 = ["data-track-change-semantic-color-key"];
-var _hoisted_11$3 = { key: 0 };
-var _hoisted_12$2 = { class: "change-type tracked-change-label" };
-var _hoisted_13$2 = {
+var _hoisted_12$2 = ["data-track-change-semantic-color-key"];
+var _hoisted_13$2 = { key: 0 };
+var _hoisted_14$2 = { class: "change-type tracked-change-label" };
+var _hoisted_15$2 = {
 	key: 0,
 	class: "tracked-change-detail-lines"
 };
-var _hoisted_14$2 = {
+var _hoisted_16$2 = {
 	key: 0,
 	class: "tracked-change-text"
 };
-var _hoisted_15$2 = {
+var _hoisted_17$2 = {
 	key: 1,
 	class: "change-type"
 };
-var _hoisted_16$2 = { class: "change-type" };
-var _hoisted_17$2 = { key: 1 };
-var _hoisted_18$2 = { class: "tracked-change-text is-inserted" };
-var _hoisted_19$1 = { key: 2 };
+var _hoisted_18$2 = { class: "change-type" };
+var _hoisted_19$1 = { key: 1 };
 var _hoisted_20$1 = { class: "tracked-change-text is-inserted" };
-var _hoisted_21$1 = { key: 3 };
-var _hoisted_22$1 = { key: 4 };
-var _hoisted_23$1 = { key: 5 };
-var _hoisted_24 = { key: 6 };
-var _hoisted_25 = { class: "tracked-change-text" };
-var _hoisted_26 = { key: 7 };
-var _hoisted_27 = { class: "tracked-change-text is-deleted" };
-var _hoisted_28 = { class: "tracked-change-text is-inserted" };
-var _hoisted_29 = { key: 8 };
-var _hoisted_30 = { key: 9 };
-var _hoisted_31 = { key: 10 };
-var _hoisted_32 = { class: "tracked-change-text is-deleted" };
-var _hoisted_33 = { key: 11 };
-var _hoisted_34 = { class: "tracked-change-text is-inserted" };
-var _hoisted_35 = ["data-track-change-image-preview-role"];
-var _hoisted_36 = ["src", "alt"];
-var _hoisted_37 = {
+var _hoisted_21$1 = { key: 2 };
+var _hoisted_22$1 = { class: "tracked-change-text is-inserted" };
+var _hoisted_23$1 = { key: 3 };
+var _hoisted_24 = { key: 4 };
+var _hoisted_25 = { key: 5 };
+var _hoisted_26 = { key: 6 };
+var _hoisted_27 = { class: "tracked-change-text" };
+var _hoisted_28 = { key: 7 };
+var _hoisted_29 = { class: "tracked-change-text is-deleted" };
+var _hoisted_30 = { class: "tracked-change-text is-inserted" };
+var _hoisted_31 = { key: 8 };
+var _hoisted_32 = { key: 9 };
+var _hoisted_33 = { key: 10 };
+var _hoisted_34 = { class: "tracked-change-text is-deleted" };
+var _hoisted_35 = { key: 11 };
+var _hoisted_36 = { class: "tracked-change-text is-inserted" };
+var _hoisted_37 = ["data-track-change-image-preview-role"];
+var _hoisted_38 = ["src", "alt"];
+var _hoisted_39 = {
 	key: 1,
 	class: "card-section comment-body"
 };
-var _hoisted_38 = ["innerHTML"];
-var _hoisted_39 = {
+var _hoisted_40 = ["innerHTML"];
+var _hoisted_41 = {
 	key: 1,
 	class: "comment"
 };
-var _hoisted_40 = {
+var _hoisted_42 = {
 	key: 2,
 	class: "reply-expanded"
 };
-var _hoisted_41 = { class: "reply-input-wrapper" };
-var _hoisted_42 = { class: "reply-actions" };
-var _hoisted_43 = ["onClick"];
-var _hoisted_44 = [
+var _hoisted_43 = { class: "reply-input-wrapper" };
+var _hoisted_44 = { class: "reply-actions" };
+var _hoisted_45 = ["onClick"];
+var _hoisted_46 = [
 	"onClick",
 	"disabled",
 	"data-disabled-reason"
 ];
-var _hoisted_45 = { class: "collapsed-avatars" };
-var _hoisted_46 = {
+var _hoisted_47 = { class: "collapsed-avatars" };
+var _hoisted_48 = {
 	key: 3,
 	class: "comment-separator"
 };
-var _hoisted_47 = {
-	key: 2,
+var _hoisted_49 = {
+	key: 3,
 	class: "tracked-change-decision-alert",
 	role: "alert"
 };
-var _hoisted_48 = { class: "tracked-change-decision-alert__message" };
-var _hoisted_49 = ["disabled", "data-disabled-reason"];
-var _hoisted_50 = {
+var _hoisted_50 = { class: "tracked-change-decision-alert__message" };
+var _hoisted_51 = ["disabled", "data-disabled-reason"];
+var _hoisted_52 = {
 	key: 1,
 	class: "reply-expanded"
 };
-var _hoisted_51 = { class: "reply-input-wrapper" };
-var _hoisted_52 = { class: "reply-actions" };
-var _hoisted_53 = ["disabled", "data-disabled-reason"];
+var _hoisted_53 = { class: "reply-input-wrapper" };
+var _hoisted_54 = { class: "reply-actions" };
+var _hoisted_55 = ["disabled", "data-disabled-reason"];
 var commentEditSessions = /* @__PURE__ */ new WeakMap();
 var _sfc_main$33 = {
 	__name: "CommentDialog",
@@ -13508,6 +13562,7 @@ var _sfc_main$33 = {
 			};
 		};
 		const CLICK_OUTSIDE_IGNORED_SELECTORS = [
+			".superdoc__tools [data-id=\"is-tool\"]",
 			".comments-dropdown__option-label",
 			".comments-dropdown__menu",
 			".comments-dropdown__option",
@@ -13681,12 +13736,17 @@ var _sfc_main$33 = {
 		const isReplying = require__plugin_vue_export_helper.ref(false);
 		const isSubmittingReply = require__plugin_vue_export_helper.ref(false);
 		const isSubmittingNewComment = require__plugin_vue_export_helper.ref(false);
+		const commentSaveFailure = require__plugin_vue_export_helper.ref("");
+		const commentSaveFailureMessage = (outcome, hasDraft = true) => {
+			return `Your comment could not be saved${outcome?.detail === "document-mode-read-only" ? " because the document or connection is read-only" : outcome?.code === "PERMISSION_DENIED" ? " because you do not have permission" : ""}.${hasDraft ? " Your draft is still here. Try again or cancel." : " Try again."}`;
+		};
 		const startReply = () => {
 			if (commentsAreReadOnly()) return readOnlyMutationOutcome();
 			if (isV2WriteDisabled.value) return {
 				ok: false,
 				reason: v2WriteCapability.value?.reason ?? "v2-write-unavailable"
 			};
+			commentSaveFailure.value = "";
 			isReplying.value = true;
 			require__plugin_vue_export_helper.nextTick(() => {
 				commentInput.value?.focus?.();
@@ -13936,6 +13996,7 @@ var _sfc_main$33 = {
 					reason: "reply-submit-in-flight"
 				};
 				isSubmittingReply.value = true;
+				commentSaveFailure.value = "";
 				try {
 					const parentCommentId = getV2ExistingReplyParentId(props.comment);
 					const trackedChangeTarget = getV2TrackedChangeCommentTarget(props.comment);
@@ -13947,6 +14008,7 @@ var _sfc_main$33 = {
 						...trackedChangeTarget ? { trackedChangeTarget } : {}
 					});
 					if (!outcome?.ok) {
+						commentSaveFailure.value = commentSaveFailureMessage(outcome);
 						require__plugin_vue_export_helper.nextTick(() => emit("resize"));
 						return outcome;
 					}
@@ -13965,6 +14027,7 @@ var _sfc_main$33 = {
 					reason: "comment-submit-in-flight"
 				};
 				isSubmittingNewComment.value = true;
+				commentSaveFailure.value = "";
 			}
 			const options = {
 				documentId: props.comment.fileId,
@@ -13980,7 +14043,10 @@ var _sfc_main$33 = {
 			Promise.resolve().then(() => addComment({
 				superdoc: proxy.$superdoc,
 				comment
-			})).catch((err) => {
+			})).then((outcome) => {
+				if (isPendingNewComment.value && outcome?.ok === false) commentSaveFailure.value = commentSaveFailureMessage(outcome);
+			}).catch((err) => {
+				commentSaveFailure.value = commentSaveFailureMessage();
 				console.error("[SuperDoc] addComment failed", err);
 			}).finally(() => {
 				isSubmittingNewComment.value = false;
@@ -14018,15 +14084,8 @@ var _sfc_main$33 = {
 		const v2WriteCapability = require__plugin_vue_export_helper.computed(() => {
 			v2CapabilityRevision.value;
 			if (!v2CommentsAdapter.value) return null;
-			const documentMode = commentsStore.viewingVisibility.documentMode;
 			const command = isPendingNewComment.value ? "comments.createFromSelection" : null;
-			const capability = v2CommentsAdapter.value.getCapabilityState?.(command) ?? null;
-			if (documentMode === "viewing" && !isPendingNewComment.value) return {
-				...capability ?? {},
-				canWrite: false,
-				reason: "review-surface-read-only"
-			};
-			return capability;
+			return v2CommentsAdapter.value.getCapabilityState?.(command) ?? null;
 		});
 		const isV2WriteDisabled = require__plugin_vue_export_helper.computed(() => {
 			if (!isV2Mode.value) return false;
@@ -14212,10 +14271,15 @@ var _sfc_main$33 = {
 				});
 				v1TrackedChangeDecisionApplied = Boolean(outcome?.ok) && outcome.success !== false;
 			} else if (isV2Mode.value && v2CommentsAdapter.value) {
-				if (!(await commentsStore.resolveCommentV2({
+				const outcome = await commentsStore.resolveCommentV2({
 					superdoc: proxy.$superdoc,
 					commentId: props.comment.commentId
-				}))?.ok) return;
+				});
+				if (!outcome?.ok) {
+					commentSaveFailure.value = commentSaveFailureMessage(outcome, false);
+					return outcome;
+				}
+				commentSaveFailure.value = "";
 			} else props.comment.resolveComment({
 				id: superdocStore.user.id,
 				email: superdocStore.user.email,
@@ -14244,17 +14308,22 @@ var _sfc_main$33 = {
 				reason: "resolve-disabled"
 			};
 			if (!isV2Mode.value || !v2CommentsAdapter.value) return;
-			if (!(await commentsStore.reopenCommentV2({
+			const outcome = await commentsStore.reopenCommentV2({
 				superdoc: proxy.$superdoc,
 				commentId: props.comment.commentId
-			}))?.ok) return;
+			});
+			if (!outcome?.ok) {
+				commentSaveFailure.value = commentSaveFailureMessage(outcome, false);
+				return outcome;
+			}
+			commentSaveFailure.value = "";
 			require__plugin_vue_export_helper.nextTick(() => {
 				commentsStore.lastUpdate = /* @__PURE__ */ new Date();
 				commentsStore.setActiveComment(proxy.$superdoc, activeComment.value);
 				proxy.$superdoc.focus?.();
 			});
 		};
-		const handleOverflowSelect = (value, comment) => {
+		const handleOverflowSelect = async (value, comment) => {
 			if (commentsAreReadOnly()) return readOnlyMutationOutcome();
 			switch (value) {
 				case "edit":
@@ -14273,10 +14342,13 @@ var _sfc_main$33 = {
 					});
 					break;
 				case "delete":
-					deleteComment({
-						superdoc: proxy.$superdoc,
-						commentId: comment.commentId
-					});
+					{
+						const outcome = await deleteComment({
+							superdoc: proxy.$superdoc,
+							commentId: comment.commentId
+						});
+						commentSaveFailure.value = outcome?.ok ? "" : commentSaveFailureMessage(outcome, false);
+					}
 					break;
 			}
 		};
@@ -14297,8 +14369,12 @@ var _sfc_main$33 = {
 					commentId: comment.commentId,
 					text: draft
 				});
-				if (!outcome?.ok) return outcome;
 				if (session?.owner !== editSessionOwner || commentEditSessions.get(commentsStore) !== session || session.submission !== submission || proxy.$superdoc.activeEditor !== editor || editor.v2Comments !== adapter || adapter.documentId !== documentId || editor.doc !== document || props.comment !== thread || editingCommentId.value !== comment.commentId || currentCommentText.value !== draft) return outcome;
+				if (!outcome?.ok) {
+					commentSaveFailure.value = commentSaveFailureMessage(outcome);
+					return outcome;
+				}
+				commentSaveFailure.value = "";
 				retireOwnEditSession();
 				editingCommentId.value = null;
 				removePendingComment(proxy.$superdoc);
@@ -14330,6 +14406,7 @@ var _sfc_main$33 = {
 			return typeof timestamp === "string" ? new Date(timestamp).getTime() : timestamp;
 		};
 		const handleCancel = (comment) => {
+			commentSaveFailure.value = "";
 			retireOwnEditSession();
 			editingCommentId.value = null;
 			isReplying.value = false;
@@ -14417,7 +14494,7 @@ var _sfc_main$33 = {
 					comment: props.comment,
 					"is-pending-input": true
 				}, null, 8, ["config", "comment"]),
-				require__plugin_vue_export_helper.createElementVNode("div", _hoisted_3$15, [require__plugin_vue_export_helper.createVNode(CommentInput_default, {
+				require__plugin_vue_export_helper.createElementVNode("div", _hoisted_3$16, [require__plugin_vue_export_helper.createVNode(CommentInput_default, {
 					ref_key: "commentInput",
 					ref: commentInput,
 					users: usersFiltered.value,
@@ -14429,26 +14506,28 @@ var _sfc_main$33 = {
 					"config",
 					"comment"
 				])]),
-				require__plugin_vue_export_helper.createElementVNode("div", _hoisted_4$10, [require__plugin_vue_export_helper.createElementVNode("button", {
+				commentSaveFailure.value ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("p", _hoisted_4$11, require__plugin_vue_export_helper.toDisplayString(commentSaveFailure.value), 1)) : require__plugin_vue_export_helper.createCommentVNode("", true),
+				require__plugin_vue_export_helper.createElementVNode("div", _hoisted_5$8, [require__plugin_vue_export_helper.createElementVNode("button", {
 					class: "sd-button reply-btn-cancel",
 					onClick: require__plugin_vue_export_helper.withModifiers(handleCancel, ["stop", "prevent"])
 				}, "Cancel"), require__plugin_vue_export_helper.createElementVNode("button", {
 					class: require__plugin_vue_export_helper.normalizeClass(["sd-button primary reply-btn-primary", { "sd-is-disabled": !hasTextContent.value || isSubmittingNewComment.value }]),
 					onClick: require__plugin_vue_export_helper.withModifiers(handleAddComment, ["stop", "prevent"]),
 					disabled: !hasTextContent.value || isSubmittingNewComment.value
-				}, " Comment ", 10, _hoisted_5$8)])
+				}, " Comment ", 10, _hoisted_6$6)])
 			], 64)) : (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock(require__plugin_vue_export_helper.Fragment, { key: 1 }, [
-				resolvedBadgeLabel.value ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("div", _hoisted_6$6, [require__plugin_vue_export_helper.createElementVNode("span", {
+				resolvedBadgeLabel.value ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("div", _hoisted_7$4, [require__plugin_vue_export_helper.createElementVNode("span", {
 					class: "resolved-badge__icon",
 					innerHTML: require__plugin_vue_export_helper.unref(superdocIcons).markDone
-				}, null, 8, _hoisted_7$4), require__plugin_vue_export_helper.createTextVNode(" " + require__plugin_vue_export_helper.toDisplayString(resolvedBadgeLabel.value), 1)])) : require__plugin_vue_export_helper.createCommentVNode("", true),
-				shouldShowInternalExternal.value ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("div", _hoisted_8$4, [require__plugin_vue_export_helper.createVNode(InternalDropdown_default, {
+				}, null, 8, _hoisted_8$4), require__plugin_vue_export_helper.createTextVNode(" " + require__plugin_vue_export_helper.toDisplayString(resolvedBadgeLabel.value), 1)])) : require__plugin_vue_export_helper.createCommentVNode("", true),
+				shouldShowInternalExternal.value ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("div", _hoisted_9$3, [require__plugin_vue_export_helper.createVNode(InternalDropdown_default, {
 					onClick: _cache[1] || (_cache[1] = require__plugin_vue_export_helper.withModifiers(() => {}, ["stop", "prevent"])),
 					class: "sd-internal-dropdown",
 					"is-disabled": isInternalDropdownDisabled.value,
 					state: __props.comment.isInternal ? "internal" : "external",
 					onSelect: handleInternalExternalSelect
 				}, null, 8, ["is-disabled", "state"])])) : require__plugin_vue_export_helper.createCommentVNode("", true),
+				commentSaveFailure.value ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("p", _hoisted_10$3, require__plugin_vue_export_helper.toDisplayString(commentSaveFailure.value), 1)) : require__plugin_vue_export_helper.createCommentVNode("", true),
 				(require__plugin_vue_export_helper.openBlock(true), require__plugin_vue_export_helper.createElementBlock(require__plugin_vue_export_helper.Fragment, null, require__plugin_vue_export_helper.renderList(visibleComments.value, (comment, index) => {
 					return require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("div", {
 						key: comment.commentId,
@@ -14480,27 +14559,27 @@ var _sfc_main$33 = {
 							"write-disabled-reason",
 							"onOverflowSelect"
 						]),
-						comment.trackedChange ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("div", _hoisted_9$3, [
+						comment.trackedChange ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("div", _hoisted_11$3, [
 							require__plugin_vue_export_helper.createElementVNode("div", {
 								class: require__plugin_vue_export_helper.normalizeClass(["tracked-change", index === 0 ? bodyOverflowClass.value : void 0]),
 								"data-track-change-semantic-color-key": comment.semanticColorKey ?? void 0,
 								ref_for: true,
 								ref: index === 0 ? setParentBodyRef : void 0
-							}, [comment.trackedChangeLabel ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("div", _hoisted_11$3, [require__plugin_vue_export_helper.createElementVNode("span", _hoisted_12$2, require__plugin_vue_export_helper.toDisplayString(comment.trackedChangeLabel), 1), comment.trackedChangeDetailLines && comment.trackedChangeDetailLines.length ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("div", _hoisted_13$2, [(require__plugin_vue_export_helper.openBlock(true), require__plugin_vue_export_helper.createElementBlock(require__plugin_vue_export_helper.Fragment, null, require__plugin_vue_export_helper.renderList(comment.trackedChangeDetailLines, (line, lineIndex) => {
+							}, [comment.trackedChangeLabel ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("div", _hoisted_13$2, [require__plugin_vue_export_helper.createElementVNode("span", _hoisted_14$2, require__plugin_vue_export_helper.toDisplayString(comment.trackedChangeLabel), 1), comment.trackedChangeDetailLines && comment.trackedChangeDetailLines.length ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("div", _hoisted_15$2, [(require__plugin_vue_export_helper.openBlock(true), require__plugin_vue_export_helper.createElementBlock(require__plugin_vue_export_helper.Fragment, null, require__plugin_vue_export_helper.renderList(comment.trackedChangeDetailLines, (line, lineIndex) => {
 								return require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("div", {
 									key: lineIndex,
 									class: "tracked-change-detail-line"
 								}, [
-									line.excerpt ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("span", _hoisted_14$2, "\"" + require__plugin_vue_export_helper.toDisplayString(line.excerpt) + "\"", 1)) : require__plugin_vue_export_helper.createCommentVNode("", true),
-									line.excerpt ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("span", _hoisted_15$2, " — ")) : require__plugin_vue_export_helper.createCommentVNode("", true),
-									require__plugin_vue_export_helper.createElementVNode("span", _hoisted_16$2, require__plugin_vue_export_helper.toDisplayString(line.label), 1)
+									line.excerpt ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("span", _hoisted_16$2, "\"" + require__plugin_vue_export_helper.toDisplayString(line.excerpt) + "\"", 1)) : require__plugin_vue_export_helper.createCommentVNode("", true),
+									line.excerpt ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("span", _hoisted_17$2, " — ")) : require__plugin_vue_export_helper.createCommentVNode("", true),
+									require__plugin_vue_export_helper.createElementVNode("span", _hoisted_18$2, require__plugin_vue_export_helper.toDisplayString(line.label), 1)
 								]);
-							}), 128))])) : require__plugin_vue_export_helper.createCommentVNode("", true)])) : comment.trackedChangeDisplayType === "hyperlinkAdded" ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("div", _hoisted_17$2, [_cache[2] || (_cache[2] = require__plugin_vue_export_helper.createElementVNode("span", { class: "change-type" }, "Added hyperlink ", -1)), require__plugin_vue_export_helper.createElementVNode("span", _hoisted_18$2, "\"" + require__plugin_vue_export_helper.toDisplayString(comment.trackedChangeText) + "\"", 1)])) : comment.trackedChangeDisplayType === "hyperlinkModified" ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("div", _hoisted_19$1, [_cache[3] || (_cache[3] = require__plugin_vue_export_helper.createElementVNode("span", { class: "change-type" }, "Changed hyperlink to ", -1)), require__plugin_vue_export_helper.createElementVNode("span", _hoisted_20$1, "\"" + require__plugin_vue_export_helper.toDisplayString(comment.trackedChangeText) + "\"", 1)])) : comment.trackedChangeDisplayType === "paragraphSplit" ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("div", _hoisted_21$1, [..._cache[4] || (_cache[4] = [require__plugin_vue_export_helper.createElementVNode("span", { class: "change-type" }, "Added new line", -1)])])) : comment.trackedChangeDisplayType === "tableInsert" ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("div", _hoisted_22$1, [..._cache[5] || (_cache[5] = [require__plugin_vue_export_helper.createElementVNode("span", { class: "change-type" }, "Added table", -1)])])) : comment.trackedChangeDisplayType === "tableDelete" ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("div", _hoisted_23$1, [..._cache[6] || (_cache[6] = [require__plugin_vue_export_helper.createElementVNode("span", { class: "change-type" }, "Deleted table", -1)])])) : comment.trackedChangeType === "trackFormat" ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("div", _hoisted_24, [_cache[7] || (_cache[7] = require__plugin_vue_export_helper.createElementVNode("span", { class: "change-type" }, "Format: ", -1)), require__plugin_vue_export_helper.createElementVNode("span", _hoisted_25, require__plugin_vue_export_helper.toDisplayString(comment.trackedChangeText), 1)])) : comment.trackedChangeType === "both" ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("div", _hoisted_26, [
+							}), 128))])) : require__plugin_vue_export_helper.createCommentVNode("", true)])) : comment.trackedChangeDisplayType === "hyperlinkAdded" ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("div", _hoisted_19$1, [_cache[2] || (_cache[2] = require__plugin_vue_export_helper.createElementVNode("span", { class: "change-type" }, "Added hyperlink ", -1)), require__plugin_vue_export_helper.createElementVNode("span", _hoisted_20$1, "\"" + require__plugin_vue_export_helper.toDisplayString(comment.trackedChangeText) + "\"", 1)])) : comment.trackedChangeDisplayType === "hyperlinkModified" ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("div", _hoisted_21$1, [_cache[3] || (_cache[3] = require__plugin_vue_export_helper.createElementVNode("span", { class: "change-type" }, "Changed hyperlink to ", -1)), require__plugin_vue_export_helper.createElementVNode("span", _hoisted_22$1, "\"" + require__plugin_vue_export_helper.toDisplayString(comment.trackedChangeText) + "\"", 1)])) : comment.trackedChangeDisplayType === "paragraphSplit" ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("div", _hoisted_23$1, [..._cache[4] || (_cache[4] = [require__plugin_vue_export_helper.createElementVNode("span", { class: "change-type" }, "Added new line", -1)])])) : comment.trackedChangeDisplayType === "tableInsert" ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("div", _hoisted_24, [..._cache[5] || (_cache[5] = [require__plugin_vue_export_helper.createElementVNode("span", { class: "change-type" }, "Added table", -1)])])) : comment.trackedChangeDisplayType === "tableDelete" ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("div", _hoisted_25, [..._cache[6] || (_cache[6] = [require__plugin_vue_export_helper.createElementVNode("span", { class: "change-type" }, "Deleted table", -1)])])) : comment.trackedChangeType === "trackFormat" ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("div", _hoisted_26, [_cache[7] || (_cache[7] = require__plugin_vue_export_helper.createElementVNode("span", { class: "change-type" }, "Format: ", -1)), require__plugin_vue_export_helper.createElementVNode("span", _hoisted_27, require__plugin_vue_export_helper.toDisplayString(comment.trackedChangeText), 1)])) : comment.trackedChangeType === "both" ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("div", _hoisted_28, [
 								_cache[8] || (_cache[8] = require__plugin_vue_export_helper.createElementVNode("span", { class: "change-type" }, "Replaced ", -1)),
-								require__plugin_vue_export_helper.createElementVNode("span", _hoisted_27, "\"" + require__plugin_vue_export_helper.toDisplayString(comment.deletedText) + "\"", 1),
+								require__plugin_vue_export_helper.createElementVNode("span", _hoisted_29, "\"" + require__plugin_vue_export_helper.toDisplayString(comment.deletedText) + "\"", 1),
 								_cache[9] || (_cache[9] = require__plugin_vue_export_helper.createElementVNode("span", { class: "change-type" }, " with ", -1)),
-								require__plugin_vue_export_helper.createElementVNode("span", _hoisted_28, "\"" + require__plugin_vue_export_helper.toDisplayString(comment.trackedChangeText) + "\"", 1)
-							])) : comment.deletedText && comment.deletedText === "\n" ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("div", _hoisted_29, [..._cache[10] || (_cache[10] = [require__plugin_vue_export_helper.createElementVNode("span", { class: "change-type" }, "Deleted line break", -1)])])) : comment.trackedChangeText && comment.trackedChangeText === "\n" ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("div", _hoisted_30, [..._cache[11] || (_cache[11] = [require__plugin_vue_export_helper.createElementVNode("span", { class: "change-type" }, "Added line break", -1)])])) : comment.deletedText ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("div", _hoisted_31, [_cache[12] || (_cache[12] = require__plugin_vue_export_helper.createElementVNode("span", { class: "change-type" }, "Deleted ", -1)), require__plugin_vue_export_helper.createElementVNode("span", _hoisted_32, "\"" + require__plugin_vue_export_helper.toDisplayString(comment.deletedText) + "\"", 1)])) : comment.trackedChangeText ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("div", _hoisted_33, [_cache[13] || (_cache[13] = require__plugin_vue_export_helper.createElementVNode("span", { class: "change-type" }, "Added ", -1)), require__plugin_vue_export_helper.createElementVNode("span", _hoisted_34, "\"" + require__plugin_vue_export_helper.toDisplayString(comment.trackedChangeText) + "\"", 1)])) : require__plugin_vue_export_helper.createCommentVNode("", true), comment.trackedChangeImagePreview?.src ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("div", {
+								require__plugin_vue_export_helper.createElementVNode("span", _hoisted_30, "\"" + require__plugin_vue_export_helper.toDisplayString(comment.trackedChangeText) + "\"", 1)
+							])) : comment.deletedText && comment.deletedText === "\n" ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("div", _hoisted_31, [..._cache[10] || (_cache[10] = [require__plugin_vue_export_helper.createElementVNode("span", { class: "change-type" }, "Deleted line break", -1)])])) : comment.trackedChangeText && comment.trackedChangeText === "\n" ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("div", _hoisted_32, [..._cache[11] || (_cache[11] = [require__plugin_vue_export_helper.createElementVNode("span", { class: "change-type" }, "Added line break", -1)])])) : comment.deletedText ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("div", _hoisted_33, [_cache[12] || (_cache[12] = require__plugin_vue_export_helper.createElementVNode("span", { class: "change-type" }, "Deleted ", -1)), require__plugin_vue_export_helper.createElementVNode("span", _hoisted_34, "\"" + require__plugin_vue_export_helper.toDisplayString(comment.deletedText) + "\"", 1)])) : comment.trackedChangeText ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("div", _hoisted_35, [_cache[13] || (_cache[13] = require__plugin_vue_export_helper.createElementVNode("span", { class: "change-type" }, "Added ", -1)), require__plugin_vue_export_helper.createElementVNode("span", _hoisted_36, "\"" + require__plugin_vue_export_helper.toDisplayString(comment.trackedChangeText) + "\"", 1)])) : require__plugin_vue_export_helper.createCommentVNode("", true), comment.trackedChangeImagePreview?.src ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("div", {
 								key: 12,
 								class: "tracked-change-image-preview",
 								"data-track-change-image-preview-role": comment.trackedChangeImagePreview.role ?? void 0
@@ -14511,7 +14590,7 @@ var _sfc_main$33 = {
 								style: require__plugin_vue_export_helper.normalizeStyle(trackedChangeImagePreviewStyle(comment.trackedChangeImagePreview)),
 								loading: "lazy",
 								decoding: "async"
-							}, null, 12, _hoisted_36)], 8, _hoisted_35)) : require__plugin_vue_export_helper.createCommentVNode("", true)], 10, _hoisted_10$3),
+							}, null, 12, _hoisted_38)], 8, _hoisted_37)) : require__plugin_vue_export_helper.createCommentVNode("", true)], 10, _hoisted_12$2),
 							shouldTruncate.value && isTextOverflowing.value && index === 0 ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("div", {
 								key: 0,
 								class: "show-more-toggle",
@@ -14523,29 +14602,29 @@ var _sfc_main$33 = {
 								onClick: require__plugin_vue_export_helper.withModifiers(toggleTruncation, ["stop", "prevent"])
 							}, " Show less ")) : require__plugin_vue_export_helper.createCommentVNode("", true)
 						])) : require__plugin_vue_export_helper.createCommentVNode("", true),
-						!comment.trackedChange ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("div", _hoisted_37, [
+						!comment.trackedChange ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("div", _hoisted_39, [
 							!require__plugin_vue_export_helper.unref(isDebugging) && !isEditingThisComment.value(comment) ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("div", {
 								key: 0,
 								class: require__plugin_vue_export_helper.normalizeClass(["comment", index === 0 ? bodyOverflowClass.value : void 0]),
 								ref_for: true,
 								ref: index === 0 ? setParentBodyRef : void 0,
 								innerHTML: renderedCommentTexts.value.get(comment.commentId)
-							}, null, 10, _hoisted_38)) : require__plugin_vue_export_helper.unref(isDebugging) && !isEditingThisComment.value(comment) ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("div", _hoisted_39, require__plugin_vue_export_helper.toDisplayString(require__plugin_vue_export_helper.unref(editorCommentPositions)[comment.importedId !== void 0 ? comment.importedId : comment.commentId]?.bounds), 1)) : (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("div", _hoisted_40, [require__plugin_vue_export_helper.createElementVNode("div", _hoisted_41, [require__plugin_vue_export_helper.createVNode(CommentInput_default, {
+							}, null, 10, _hoisted_40)) : require__plugin_vue_export_helper.unref(isDebugging) && !isEditingThisComment.value(comment) ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("div", _hoisted_41, require__plugin_vue_export_helper.toDisplayString(require__plugin_vue_export_helper.unref(editorCommentPositions)[comment.importedId !== void 0 ? comment.importedId : comment.commentId]?.bounds), 1)) : (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("div", _hoisted_42, [require__plugin_vue_export_helper.createElementVNode("div", _hoisted_43, [require__plugin_vue_export_helper.createVNode(CommentInput_default, {
 								ref_for: true,
 								ref: setEditCommentInputRef(comment.commentId),
 								users: [],
 								config: require__plugin_vue_export_helper.unref(getConfig),
 								"include-header": false,
 								comment
-							}, null, 8, ["config", "comment"])]), require__plugin_vue_export_helper.createElementVNode("div", _hoisted_42, [require__plugin_vue_export_helper.createElementVNode("button", {
+							}, null, 8, ["config", "comment"])]), require__plugin_vue_export_helper.createElementVNode("div", _hoisted_44, [require__plugin_vue_export_helper.createElementVNode("button", {
 								class: "sd-button reply-btn-cancel",
 								onClick: require__plugin_vue_export_helper.withModifiers(($event) => handleCancel(comment), ["stop", "prevent"])
-							}, "Cancel", 8, _hoisted_43), require__plugin_vue_export_helper.createElementVNode("button", {
+							}, "Cancel", 8, _hoisted_45), require__plugin_vue_export_helper.createElementVNode("button", {
 								class: require__plugin_vue_export_helper.normalizeClass(["sd-button primary reply-btn-primary", { "sd-is-disabled": !hasTextContent.value || isV2WriteDisabled.value }]),
 								onClick: require__plugin_vue_export_helper.withModifiers(($event) => handleCommentUpdate(comment), ["stop", "prevent"]),
 								disabled: !hasTextContent.value || isV2WriteDisabled.value,
 								"data-disabled-reason": isV2WriteDisabled.value ? v2WriteCapability.value?.reason ?? null : null
-							}, " Update ", 10, _hoisted_44)])])),
+							}, " Update ", 10, _hoisted_46)])])),
 							shouldTruncate.value && isTextOverflowing.value && index === 0 && !isEditingThisComment.value(comment) ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("div", {
 								key: 3,
 								class: "show-more-toggle",
@@ -14560,29 +14639,29 @@ var _sfc_main$33 = {
 						shouldCollapseThread.value && index === 0 ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock(require__plugin_vue_export_helper.Fragment, { key: 2 }, [_cache[14] || (_cache[14] = require__plugin_vue_export_helper.createElementVNode("div", { class: "comment-separator" }, null, -1)), require__plugin_vue_export_helper.createElementVNode("div", {
 							class: "collapsed-replies",
 							onClick: require__plugin_vue_export_helper.withModifiers(expandThread, ["stop", "prevent"])
-						}, [require__plugin_vue_export_helper.createElementVNode("div", _hoisted_45, [(require__plugin_vue_export_helper.openBlock(true), require__plugin_vue_export_helper.createElementBlock(require__plugin_vue_export_helper.Fragment, null, require__plugin_vue_export_helper.renderList(collapsedReplyAuthors.value, (author) => {
+						}, [require__plugin_vue_export_helper.createElementVNode("div", _hoisted_47, [(require__plugin_vue_export_helper.openBlock(true), require__plugin_vue_export_helper.createElementBlock(require__plugin_vue_export_helper.Fragment, null, require__plugin_vue_export_helper.renderList(collapsedReplyAuthors.value, (author) => {
 							return require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createBlock(Avatar_default, {
 								key: author.email || author.name,
 								user: author,
 								class: "mini-avatar"
 							}, null, 8, ["user"]);
 						}), 128))]), require__plugin_vue_export_helper.createElementVNode("span", null, require__plugin_vue_export_helper.toDisplayString(collapsedReplyCount.value) + " more " + require__plugin_vue_export_helper.toDisplayString(collapsedReplyCount.value === 1 ? "reply" : "replies"), 1)])], 64)) : require__plugin_vue_export_helper.createCommentVNode("", true),
-						showSeparator.value(index) ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("div", _hoisted_46)) : require__plugin_vue_export_helper.createCommentVNode("", true)
+						showSeparator.value(index) ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("div", _hoisted_48)) : require__plugin_vue_export_helper.createCommentVNode("", true)
 					]);
 				}), 128)),
-				trackedChangeDecisionFailure.value ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("div", _hoisted_47, [require__plugin_vue_export_helper.createElementVNode("span", _hoisted_48, require__plugin_vue_export_helper.toDisplayString(trackedChangeDecisionFailureMessage.value), 1), require__plugin_vue_export_helper.createElementVNode("button", {
+				trackedChangeDecisionFailure.value ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("div", _hoisted_49, [require__plugin_vue_export_helper.createElementVNode("span", _hoisted_50, require__plugin_vue_export_helper.toDisplayString(trackedChangeDecisionFailureMessage.value), 1), require__plugin_vue_export_helper.createElementVNode("button", {
 					type: "button",
 					class: "sd-button tracked-change-decision-alert__retry",
 					onClick: require__plugin_vue_export_helper.withModifiers(retryTrackedChangeDecision, ["stop", "prevent"])
 				}, " Retry ")])) : require__plugin_vue_export_helper.createCommentVNode("", true),
-				showInputSection.value && !require__plugin_vue_export_helper.unref(getConfig).readOnly ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock(require__plugin_vue_export_helper.Fragment, { key: 3 }, [!isReplying.value ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("button", {
+				showInputSection.value && !require__plugin_vue_export_helper.unref(getConfig).readOnly ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock(require__plugin_vue_export_helper.Fragment, { key: 4 }, [!isReplying.value ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("button", {
 					key: 0,
 					type: "button",
 					class: require__plugin_vue_export_helper.normalizeClass(["reply-pill", { "sd-is-disabled": isV2WriteDisabled.value }]),
 					onClick: require__plugin_vue_export_helper.withModifiers(startReply, ["stop", "prevent"]),
 					disabled: isV2WriteDisabled.value,
 					"data-disabled-reason": isV2WriteDisabled.value ? v2WriteCapability.value?.reason ?? null : null
-				}, " Reply or add others with @ ", 10, _hoisted_49)) : (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("div", _hoisted_50, [require__plugin_vue_export_helper.createElementVNode("div", _hoisted_51, [require__plugin_vue_export_helper.createVNode(CommentInput_default, {
+				}, " Reply or add others with @ ", 10, _hoisted_51)) : (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("div", _hoisted_52, [require__plugin_vue_export_helper.createElementVNode("div", _hoisted_53, [require__plugin_vue_export_helper.createVNode(CommentInput_default, {
 					ref_key: "commentInput",
 					ref: commentInput,
 					users: usersFiltered.value,
@@ -14593,7 +14672,7 @@ var _sfc_main$33 = {
 					"users",
 					"config",
 					"comment"
-				])]), require__plugin_vue_export_helper.createElementVNode("div", _hoisted_52, [require__plugin_vue_export_helper.createElementVNode("button", {
+				])]), require__plugin_vue_export_helper.createElementVNode("div", _hoisted_54, [require__plugin_vue_export_helper.createElementVNode("button", {
 					class: "sd-button reply-btn-cancel",
 					onClick: require__plugin_vue_export_helper.withModifiers(handleCancel, ["stop", "prevent"])
 				}, "Cancel"), require__plugin_vue_export_helper.createElementVNode("button", {
@@ -14601,12 +14680,12 @@ var _sfc_main$33 = {
 					onClick: require__plugin_vue_export_helper.withModifiers(handleAddComment, ["stop", "prevent"]),
 					disabled: !hasTextContent.value || isV2WriteDisabled.value || isSubmittingReply.value,
 					"data-disabled-reason": v2ReplyDisabledReason.value
-				}, " Reply ", 10, _hoisted_53)])]))], 64)) : require__plugin_vue_export_helper.createCommentVNode("", true)
+				}, " Reply ", 10, _hoisted_55)])]))], 64)) : require__plugin_vue_export_helper.createCommentVNode("", true)
 			], 64))], 14, _hoisted_1$26)), [[_directive_click_outside, handleClickOutside]]);
 		};
 	}
 };
-var CommentDialog_default = /*#__PURE__*/ require__plugin_vue_export_helper._plugin_vue_export_helper_default(_sfc_main$33, [["__scopeId", "data-v-f5016db4"]]);
+var CommentDialog_default = /*#__PURE__*/ require__plugin_vue_export_helper._plugin_vue_export_helper_default(_sfc_main$33, [["__scopeId", "data-v-f8b79c74"]]);
 //#endregion
 //#region src/components/CommentsLayer/commentsList/ReviewDirectoryListItem.vue
 var _hoisted_1$25 = [
@@ -14756,7 +14835,7 @@ var ReviewDirectoryListItem_default = /*#__PURE__*/ require__plugin_vue_export_h
 //#region src/components/CommentsLayer/commentsList/commentsList.vue
 var _hoisted_1$24 = ["aria-busy"];
 var _hoisted_2$18 = { key: 0 };
-var _hoisted_3$14 = { key: 1 };
+var _hoisted_3$15 = { key: 1 };
 var REPEATED_HEADER_FOOTER_STORY_TYPE = "headerFooterPart";
 var _sfc_main$31 = {
 	__name: "commentsList",
@@ -14900,7 +14979,7 @@ var _sfc_main$31 = {
 					"total",
 					"tab-index"
 				]);
-			}), 128))])) : require__plugin_vue_export_helper.createCommentVNode("", true), shouldShowResolvedComments.value ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("div", _hoisted_3$14, [_cache[2] || (_cache[2] = require__plugin_vue_export_helper.createElementVNode("div", { class: "comment-title" }, "Resolved", -1)), (require__plugin_vue_export_helper.openBlock(true), require__plugin_vue_export_helper.createElementBlock(require__plugin_vue_export_helper.Fragment, null, require__plugin_vue_export_helper.renderList(resolvedCommentDisplayItems.value, (item, index) => {
+			}), 128))])) : require__plugin_vue_export_helper.createCommentVNode("", true), shouldShowResolvedComments.value ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("div", _hoisted_3$15, [_cache[2] || (_cache[2] = require__plugin_vue_export_helper.createElementVNode("div", { class: "comment-title" }, "Resolved", -1)), (require__plugin_vue_export_helper.openBlock(true), require__plugin_vue_export_helper.createElementBlock(require__plugin_vue_export_helper.Fragment, null, require__plugin_vue_export_helper.renderList(resolvedCommentDisplayItems.value, (item, index) => {
 				return require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createBlock(ReviewDirectoryListItem_default, {
 					key: item.id,
 					item,
@@ -15331,6 +15410,80 @@ 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 && !require_create_super_doc_ui.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 (!require_create_super_doc_ui.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 && !require_create_super_doc_ui.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;
@@ -19026,11 +19179,11 @@ var _hoisted_2$16 = {
 	key: 1,
 	class: "link-title"
 };
-var _hoisted_3$13 = {
+var _hoisted_3$14 = {
 	key: 2,
 	class: "link-title"
 };
-var _hoisted_4$9 = {
+var _hoisted_4$10 = {
 	key: 3,
 	class: "link-title"
 };
@@ -19289,7 +19442,7 @@ var _sfc_main$26 = {
 		};
 		return (_ctx, _cache) => {
 			return require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("div", { class: require__plugin_vue_export_helper.normalizeClass(["link-input-ctn", { "high-contrast": require__plugin_vue_export_helper.unref(isHighContrastMode) }]) }, [
-				isAnchor.value ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("div", _hoisted_1$20, "Page anchor")) : isViewingMode.value ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("div", _hoisted_2$16, "Link details")) : isEditing.value ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("div", _hoisted_3$13, "Edit link")) : (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("div", _hoisted_4$9, "Add link")),
+				isAnchor.value ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("div", _hoisted_1$20, "Page anchor")) : isViewingMode.value ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("div", _hoisted_2$16, "Link details")) : isEditing.value ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("div", _hoisted_3$14, "Edit link")) : (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("div", _hoisted_4$10, "Add link")),
 				__props.showInput && !isAnchor.value ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("div", _hoisted_5$7, [
 					require__plugin_vue_export_helper.createElementVNode("div", _hoisted_6$5, [_cache[5] || (_cache[5] = require__plugin_vue_export_helper.createElementVNode("div", { class: "input-icon text-input-icon" }, "T", -1)), require__plugin_vue_export_helper.withDirectives(require__plugin_vue_export_helper.createElementVNode("input", {
 						type: "text",
@@ -20090,6 +20243,28 @@ function useLinkPopover({ getSurfaceManager, getActiveEditor, getUi, getActivati
 	};
 }
 //#endregion
+//#region src/core/helpers/resolve-docx-export.ts
+function resolveV2DocxExportOptions(options = {}) {
+	const policies = resolveDocxExportPolicies({ policies: options.policies });
+	if (options.isFinalDoc !== void 0) {
+		if (typeof options.isFinalDoc !== "boolean") throw new DocumentApiValidationError("INVALID_INPUT", "isFinalDoc must be a boolean.");
+		const legacy = options.isFinalDoc ? "final" : "review-preserving";
+		if (options.policies?.trackedChanges !== void 0 && policies.trackedChanges !== legacy) throw new DocumentApiValidationError("INVALID_INPUT", "isFinalDoc conflicts with policies.trackedChanges.");
+		policies.trackedChanges = legacy;
+	}
+	if (options.commentsType !== void 0) {
+		if (options.commentsType !== "external" && options.commentsType !== "clean") throw new DocumentApiValidationError("INVALID_INPUT", "commentsType must be external or clean.");
+		const legacy = options.commentsType === "clean" ? "remove" : "preserve";
+		if (options.policies?.comments !== void 0 && policies.comments !== legacy) throw new DocumentApiValidationError("INVALID_INPUT", "commentsType conflicts with policies.comments.");
+		policies.comments = legacy;
+	}
+	return {
+		mode: policies.trackedChanges,
+		commentExportMode: policies.comments === "remove" ? "strip" : policies.comments,
+		contentControlExportMode: policies.contentControls
+	};
+}
+//#endregion
 //#region src/core/editor-runtime/v2/v2-editor-runtime-adapter.ts
 var DEFAULT_V2_LEGACY_PROJECTION = Object.freeze({
 	editorVersion: 2,
@@ -20729,7 +20904,7 @@ function createV2EditorRuntimeAdapter(options) {
 			save: () => host.save(),
 			exportDocx: (options) => host.save({
 				format: "docx",
-				commentExportMode: options?.commentsType === "clean" ? "strip" : "preserve"
+				...resolveV2DocxExportOptions(options)
 			}),
 			async setZoom(percent) {
 				const result = host.setZoom(percent);
@@ -21390,7 +21565,7 @@ var FOCUSABLE_SELECTOR = [
 //#region src/components/surfaces/SurfaceDialog.vue
 var _hoisted_1$19 = ["aria-labelledby", "aria-label"];
 var _hoisted_2$15 = ["id"];
-var _hoisted_3$12 = { class: "sd-surface-dialog__content" };
+var _hoisted_3$13 = { class: "sd-surface-dialog__content" };
 var _sfc_main$24 = {
 	__name: "SurfaceDialog",
 	props: {
@@ -21522,7 +21697,7 @@ var _sfc_main$24 = {
 				key: 0,
 				id: titleId.value,
 				class: "sd-surface-dialog__title"
-			}, require__plugin_vue_export_helper.toDisplayString(__props.surface.request.title), 9, _hoisted_2$15)) : require__plugin_vue_export_helper.createCommentVNode("", true), require__plugin_vue_export_helper.createElementVNode("div", _hoisted_3$12, [__props.surface.render ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createBlock(SurfaceExternalMount_default, {
+			}, require__plugin_vue_export_helper.toDisplayString(__props.surface.request.title), 9, _hoisted_2$15)) : require__plugin_vue_export_helper.createCommentVNode("", true), require__plugin_vue_export_helper.createElementVNode("div", _hoisted_3$13, [__props.surface.render ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createBlock(SurfaceExternalMount_default, {
 				key: 0,
 				"surface-id": __props.surface.id,
 				mode: "dialog",
@@ -21545,7 +21720,7 @@ var SurfaceDialog_default = /*#__PURE__*/ require__plugin_vue_export_helper._plu
 //#region src/components/surfaces/SurfaceFloating.vue
 var _hoisted_1$18 = ["aria-labelledby", "aria-label"];
 var _hoisted_2$14 = ["id"];
-var _hoisted_3$11 = { class: "sd-surface-floating__content" };
+var _hoisted_3$12 = { class: "sd-surface-floating__content" };
 var _sfc_main$23 = {
 	__name: "SurfaceFloating",
 	props: { surface: {
@@ -21677,7 +21852,7 @@ var _sfc_main$23 = {
 				key: 0,
 				id: titleId.value,
 				class: "sd-surface-floating__title"
-			}, require__plugin_vue_export_helper.toDisplayString(__props.surface.request.title), 9, _hoisted_2$14)) : require__plugin_vue_export_helper.createCommentVNode("", true), require__plugin_vue_export_helper.createElementVNode("div", _hoisted_3$11, [__props.surface.render ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createBlock(SurfaceExternalMount_default, {
+			}, require__plugin_vue_export_helper.toDisplayString(__props.surface.request.title), 9, _hoisted_2$14)) : require__plugin_vue_export_helper.createCommentVNode("", true), require__plugin_vue_export_helper.createElementVNode("div", _hoisted_3$12, [__props.surface.render ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createBlock(SurfaceExternalMount_default, {
 				key: 0,
 				"surface-id": __props.surface.id,
 				mode: "floating",
@@ -21925,8 +22100,8 @@ var SurfaceHost_default = /*#__PURE__*/ require__plugin_vue_export_helper._plugi
 //#region src/SuperDoc.vue
 var _hoisted_1$17 = ["data-superdoc-ui-owner"];
 var _hoisted_2$13 = ["innerHTML"];
-var _hoisted_3$10 = { class: "superdoc__document document" };
-var _hoisted_4$8 = { class: "floating-comments" };
+var _hoisted_3$11 = { class: "superdoc__document document" };
+var _hoisted_4$9 = { class: "floating-comments" };
 var TRACKED_CHANGE_CARRIERS_RESTAMPED_EVENT = "superdoc:v2-tracked-change-carriers-restamped";
 var UNAVAILABLE_COMMAND_RESULT = false;
 var V2_SELECTION_TOOLBAR_SYNC_RETRY_FRAMES = 3;
@@ -21984,7 +22159,7 @@ var SuperDoc_default = /*#__PURE__*/ require__plugin_vue_export_helper._plugin_v
 		const { proxy } = require__plugin_vue_export_helper.getCurrentInstance();
 		commentsStore.proxy = proxy;
 		const documentOpenTelemetry = createDocumentOpenTelemetry(proxy.$superdoc.config);
-		const resolvedEditorIntegration = resolveV2Integration(proxy.$superdoc.config);
+		const resolvedEditorIntegration = createDefaultV2Integration();
 		const V2DocumentEditor = require__plugin_vue_export_helper.markRaw(resolvedEditorIntegration.EditorComponent);
 		const V2Ruler = resolvedEditorIntegration.RulerComponent ? require__plugin_vue_export_helper.markRaw(resolvedEditorIntegration.RulerComponent) : null;
 		const floatingComments = require__plugin_vue_export_helper.computed(() => {
@@ -22130,6 +22305,10 @@ var SuperDoc_default = /*#__PURE__*/ require__plugin_vue_export_helper._plugin_v
 			return layers.value.getBoundingClientRect().top + top * zoom;
 		};
 		const handleCommentToolClick = async () => {
+			if (isV2Mode.value) {
+				cancelScheduledV2DomSelectionSync();
+				if (applyCurrentV2DomSelection()?.ok === false) return;
+			}
 			if ((await showAddComment(proxy.$superdoc, getPendingCommentTargetClientY()))?.ok === false) return;
 			if (!isV2Mode.value) return;
 			const pendingPosition = buildV2PendingPositionEntry();
@@ -22402,10 +22581,9 @@ var SuperDoc_default = /*#__PURE__*/ require__plugin_vue_export_helper._plugin_v
 				return host.save(saveOptions);
 			});
 			const exportV2Docx = async (options = {}) => {
-				const commentExportMode = options?.commentsType === "clean" ? "strip" : "preserve";
 				const bytes = await saveV2Bytes({
 					format: "docx",
-					commentExportMode
+					...resolveV2DocxExportOptions(options)
 				});
 				return new Blob([bytes], { type: DOCX });
 			};
@@ -22680,6 +22858,9 @@ var SuperDoc_default = /*#__PURE__*/ require__plugin_vue_export_helper._plugin_v
 					subscribe: (listener) => v2ReviewWindowController.subscribe?.(listener) ?? (() => void 0)
 				},
 				extensions: createV2ExtensionsFacet(host),
+				get visuals() {
+					return typeof host?.getHostVisuals === "function" ? host.getHostVisuals() : null;
+				},
 				fonts: fonts ?? host?.getFontRuntime?.() ?? null,
 				/**
 				* The v2 active-editor facade explicitly does NOT carry v1 commands /
@@ -22845,7 +23026,7 @@ var SuperDoc_default = /*#__PURE__*/ require__plugin_vue_export_helper._plugin_v
 			const result = handles?.selection?.applyDomSelection?.(selection);
 			if (!result?.ok || result.mode !== "range") {
 				clearV2SelectionToolbarState();
-				return;
+				return { ok: false };
 			}
 			v2DomMirroredRange.value = true;
 			v2HasRangeSelection.value = true;
@@ -23307,7 +23488,8 @@ var SuperDoc_default = /*#__PURE__*/ require__plugin_vue_export_helper._plugin_v
 				return;
 			}
 			const collaborationException = createCollaborationException(reason, documentId);
-			const message = collaborationException?.error.message ?? getV2EditorFailureMessage(reason);
+			const baseMessage = collaborationException?.error.message ?? getV2EditorFailureMessage(reason);
+			const message = reason === "collaboration-config-invalid" && detail ? `${baseMessage} ${detail}` : baseMessage;
 			const workerFailure = payload?.workerFailure && typeof payload.workerFailure === "object" ? payload.workerFailure : null;
 			setV2EditorFailure(documentId, {
 				reason,
@@ -23323,7 +23505,7 @@ var SuperDoc_default = /*#__PURE__*/ require__plugin_vue_export_helper._plugin_v
 			};
 			if (reason === "collaboration-v1-config-unsupported" || reason === "collaboration-room-format-unsupported" || reason === "collaboration-room-format-conflict" || reason === "collaboration-room-corrupt" || reason === "collaboration-v2-room-missing" || reason === "collaboration-v2-room-already-exists" || reason === "collaboration-v2-room-initializing" || reason === "collaboration-v2-room-bootstrap-stalled" || reason === "collaboration-open-intent-invalid" || reason === "collaboration-config-invalid") console.warn(`[SuperDoc] ${message}`, logContext);
 			else console.error(`[SuperDoc] ${message}`, logContext);
-			proxy.$superdoc.emit("exception", collaborationException ?? {
+			proxy.$superdoc.emit("exception", collaborationException && reason !== "collaboration-config-invalid" ? collaborationException : {
 				error: new Error(message),
 				code: reason,
 				...documentId ? { documentId } : {},
@@ -23497,6 +23679,7 @@ var SuperDoc_default = /*#__PURE__*/ require__plugin_vue_export_helper._plugin_v
 					emitCommentPositionsInViewing: isViewingMode() && shouldRenderCommentsInViewing.value,
 					enableCommentsInViewing: isViewingCommentsVisible.value,
 					contentControlsChrome: proxy.$superdoc.uiConfig.contentControls.options.chrome,
+					commentHighlights: proxy.$superdoc.uiConfig.comments.highlights,
 					resolveTrackedChangeColor: composeAuthorColorResolver(proxy.$superdoc.config.modules?.trackChanges?.authorColors)
 				} : void 0,
 				permissionResolver: createTrackedChangePermissionResolver(proxy.$superdoc)
@@ -24405,7 +24588,7 @@ var SuperDoc_default = /*#__PURE__*/ require__plugin_vue_export_helper._plugin_v
 				}, [require__plugin_vue_export_helper.createElementVNode("div", {
 					class: "superdoc__tools-icon",
 					innerHTML: require__plugin_vue_export_helper.unref(superdocIcons).comment
-				}, null, 8, _hoisted_2$13)], 32)], 4)) : require__plugin_vue_export_helper.createCommentVNode("", true), require__plugin_vue_export_helper.createElementVNode("div", _hoisted_3$10, [
+				}, null, 8, _hoisted_2$13)], 32)], 4)) : require__plugin_vue_export_helper.createCommentVNode("", true), require__plugin_vue_export_helper.createElementVNode("div", _hoisted_3$11, [
 					isCommentsEnabled.value ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("div", {
 						key: 0,
 						class: "superdoc__selection-layer selection-layer",
@@ -24533,7 +24716,7 @@ var SuperDoc_default = /*#__PURE__*/ require__plugin_vue_export_helper._plugin_v
 					ref_key: "rightSidebarRef",
 					ref: rightSidebarRef,
 					class: "superdoc__right-sidebar right-sidebar"
-				}, [require__plugin_vue_export_helper.createElementVNode("div", _hoisted_4$8, [require__plugin_vue_export_helper.unref(hasInitializedLocations) && (floatingComments.value.length > 0 || require__plugin_vue_export_helper.unref(pendingComment)) ? (require__plugin_vue_export_helper.openBlock(true), require__plugin_vue_export_helper.createElementBlock(require__plugin_vue_export_helper.Fragment, { key: 0 }, require__plugin_vue_export_helper.renderList(require__plugin_vue_export_helper.unref(documentsWithConverations), (doc) => {
+				}, [require__plugin_vue_export_helper.createElementVNode("div", _hoisted_4$9, [require__plugin_vue_export_helper.unref(hasInitializedLocations) && (floatingComments.value.length > 0 || require__plugin_vue_export_helper.unref(pendingComment)) ? (require__plugin_vue_export_helper.openBlock(true), require__plugin_vue_export_helper.createElementBlock(require__plugin_vue_export_helper.Fragment, { key: 0 }, require__plugin_vue_export_helper.renderList(require__plugin_vue_export_helper.unref(documentsWithConverations), (doc) => {
 					return require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createBlock(FloatingComments_default, {
 						parent: layers.value,
 						"current-document": doc
@@ -24551,7 +24734,7 @@ var SuperDoc_default = /*#__PURE__*/ require__plugin_vue_export_helper._plugin_v
 			], 46, _hoisted_1$17);
 		};
 	}
-}, [["__scopeId", "data-v-143de6c8"]]);
+}, [["__scopeId", "data-v-f2db957f"]]);
 //#endregion
 //#region src/core/create-app.js
 var PINIA_DEVTOOLS_SETUP_EVENT = "devtools-plugin:setup";
@@ -38013,6 +38196,11 @@ var COMMENT_POLICY_FIELDS = Object.freeze([
 	"allowResolve",
 	"permissionResolver"
 ]);
+function withoutSwitches(options) {
+	if (!("panel" in options) && !("highlights" in options)) return options;
+	const { panel: _panel, highlights: _highlights, ...rest } = options;
+	return rest;
+}
 /**
 * Drop policy fields from a presentation options bag.
 */
@@ -38357,8 +38545,9 @@ function normalizeUiConfig(config = {}) {
 			}
 		},
 		comments: {
-			enabled: explicit("comments") ?? (!allDisabled && config.modules?.comments !== false),
-			options: allDisabled ? {} : normalizeCommentsUiConfig(withoutCommentPolicy(options("comments"))) || {}
+			enabled: (explicit("comments") ?? (!allDisabled && config.modules?.comments !== false)) && options("comments").panel !== false,
+			highlights: options("comments").highlights !== false,
+			options: allDisabled ? {} : normalizeCommentsUiConfig(withoutCommentPolicy(withoutSwitches(options("comments")))) || {}
 		},
 		contextMenu: {
 			enabled: explicit("contextMenu") ?? (!allDisabled && config.disableContextMenu !== true),
@@ -39038,8 +39227,8 @@ var _hoisted_1$15 = [
 	"aria-disabled"
 ];
 var _hoisted_2$11 = ["data-item"];
-var _hoisted_3$9 = ["data-item"];
-var _hoisted_4$7 = {
+var _hoisted_3$10 = ["data-item"];
+var _hoisted_4$8 = {
 	key: 1,
 	class: "sd-button-label"
 };
@@ -39260,7 +39449,7 @@ var _sfc_main$19 = {
 					"color",
 					"icon",
 					"name"
-				])) : require__plugin_vue_export_helper.createCommentVNode("", true), require__plugin_vue_export_helper.unref(label) && !require__plugin_vue_export_helper.unref(hideLabel) && !require__plugin_vue_export_helper.unref(inlineTextInputVisible) ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("div", _hoisted_4$7, require__plugin_vue_export_helper.toDisplayString(require__plugin_vue_export_helper.unref(label)), 1)) : require__plugin_vue_export_helper.createCommentVNode("", true)], 8, _hoisted_3$9)) : require__plugin_vue_export_helper.createCommentVNode("", true),
+				])) : require__plugin_vue_export_helper.createCommentVNode("", true), require__plugin_vue_export_helper.unref(label) && !require__plugin_vue_export_helper.unref(hideLabel) && !require__plugin_vue_export_helper.unref(inlineTextInputVisible) ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("div", _hoisted_4$8, require__plugin_vue_export_helper.toDisplayString(require__plugin_vue_export_helper.unref(label)), 1)) : require__plugin_vue_export_helper.createCommentVNode("", true)], 8, _hoisted_3$10)) : require__plugin_vue_export_helper.createCommentVNode("", true),
 				isSplit.value ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("div", {
 					key: 1,
 					class: "sd-toolbar-button__caret",
@@ -39364,8 +39553,8 @@ var ToolbarSeparator_default = /*#__PURE__*/ require__plugin_vue_export_helper._
 //#region src/internal/toolbar/built-in/ToolbarDropdown.vue
 var _hoisted_1$13 = { class: "toolbar-dropdown" };
 var _hoisted_2$10 = ["data-superdoc-ui-owner"];
-var _hoisted_3$8 = ["onClick"];
-var _hoisted_4$6 = {
+var _hoisted_3$9 = ["onClick"];
+var _hoisted_4$7 = {
 	key: 0,
 	class: "toolbar-dropdown-option__icon"
 };
@@ -39754,7 +39943,7 @@ var _sfc_main$17 = {
 					}), [isRenderOption(option) ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createBlock(require__plugin_vue_export_helper.unref(RenderOption), {
 						key: 0,
 						option
-					}, null, 8, ["option"])) : (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock(require__plugin_vue_export_helper.Fragment, { key: 1 }, [hasIcon(option) ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("span", _hoisted_4$6, [require__plugin_vue_export_helper.createVNode(require__plugin_vue_export_helper.unref(OptionIcon), { option }, null, 8, ["option"])])) : require__plugin_vue_export_helper.createCommentVNode("", true), require__plugin_vue_export_helper.createElementVNode("span", _hoisted_5$5, require__plugin_vue_export_helper.toDisplayString(option.label), 1)], 64))], 16, _hoisted_3$8);
+					}, null, 8, ["option"])) : (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock(require__plugin_vue_export_helper.Fragment, { key: 1 }, [hasIcon(option) ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("span", _hoisted_4$7, [require__plugin_vue_export_helper.createVNode(require__plugin_vue_export_helper.unref(OptionIcon), { option }, null, 8, ["option"])])) : require__plugin_vue_export_helper.createCommentVNode("", true), require__plugin_vue_export_helper.createElementVNode("span", _hoisted_5$5, require__plugin_vue_export_helper.toDisplayString(option.label), 1)], 64))], 16, _hoisted_3$9);
 				}), 128))], 16, _hoisted_2$10)) : require__plugin_vue_export_helper.createCommentVNode("", true)]),
 				_: 3
 			})], 8, ["to"]))]);
@@ -39997,12 +40186,12 @@ var _hoisted_2$9 = [
 	"aria-activedescendant",
 	"data-item"
 ];
-var _hoisted_3$7 = [
+var _hoisted_3$8 = [
 	"data-item",
 	"aria-label",
 	"disabled"
 ];
-var _hoisted_4$5 = ["innerHTML"];
+var _hoisted_4$6 = ["innerHTML"];
 var _hoisted_5$4 = [
 	"data-superdoc-ui-owner",
 	"id",
@@ -40470,7 +40659,7 @@ var _sfc_main$15 = {
 				}, [require__plugin_vue_export_helper.createElementVNode("span", {
 					class: "sd-dropdown-caret",
 					innerHTML: caretIcon.value
-				}, null, 8, _hoisted_4$5)], 40, _hoisted_3$7),
+				}, null, 8, _hoisted_4$6)], 40, _hoisted_3$8),
 				(require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createBlock(require__plugin_vue_export_helper.Teleport, { to: "body" }, [isOpen.value ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("div", {
 					key: 0,
 					ref_key: "popupRef",
@@ -40817,8 +41006,8 @@ var _hoisted_1$11 = [
 	"data-item-id"
 ];
 var _hoisted_2$8 = { key: 0 };
-var _hoisted_3$6 = { key: 0 };
-var _hoisted_4$4 = { key: 0 };
+var _hoisted_3$7 = { key: 0 };
+var _hoisted_4$5 = { key: 0 };
 var _hoisted_5$3 = { key: 0 };
 var _hoisted_6$2 = { key: 0 };
 var _sfc_main$11 = {
@@ -41222,7 +41411,7 @@ var _sfc_main$11 = {
 							onTabOut: _cache[1] || (_cache[1] = ($event) => handleFontSizeTabOut($event)),
 							onEditorHandoff: handleEditorHandoff
 						}, null, 8, ["item", "ui-font-family"])]),
-						default: require__plugin_vue_export_helper.withCtx(() => [require__plugin_vue_export_helper.createElementVNode("div", null, [require__plugin_vue_export_helper.createTextVNode(require__plugin_vue_export_helper.toDisplayString(item.tooltip) + " ", 1), item.disabled.value ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("span", _hoisted_3$6, "(disabled)")) : require__plugin_vue_export_helper.createCommentVNode("", true)])]),
+						default: require__plugin_vue_export_helper.withCtx(() => [require__plugin_vue_export_helper.createElementVNode("div", null, [require__plugin_vue_export_helper.createTextVNode(require__plugin_vue_export_helper.toDisplayString(item.tooltip) + " ", 1), item.disabled.value ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("span", _hoisted_3$7, "(disabled)")) : require__plugin_vue_export_helper.createCommentVNode("", true)])]),
 						_: 2
 					}, 1032, ["disabled", "content-style"])) : isDropdown(item) && item.nestedOptions?.value?.length ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createBlock(ToolbarDropdown_default, {
 						key: 3,
@@ -41259,7 +41448,7 @@ var _sfc_main$11 = {
 								"onTextSubmit",
 								"onMainClick"
 							])]),
-							default: require__plugin_vue_export_helper.withCtx(() => [require__plugin_vue_export_helper.createElementVNode("div", null, [require__plugin_vue_export_helper.createTextVNode(require__plugin_vue_export_helper.toDisplayString(item.tooltip) + " ", 1), item.disabled.value ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("span", _hoisted_4$4, "(disabled)")) : require__plugin_vue_export_helper.createCommentVNode("", true)])]),
+							default: require__plugin_vue_export_helper.withCtx(() => [require__plugin_vue_export_helper.createElementVNode("div", null, [require__plugin_vue_export_helper.createTextVNode(require__plugin_vue_export_helper.toDisplayString(item.tooltip) + " ", 1), item.disabled.value ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("span", _hoisted_4$5, "(disabled)")) : require__plugin_vue_export_helper.createCommentVNode("", true)])]),
 							_: 2
 						}, 1032, ["disabled", "content-style"])]),
 						_: 2
@@ -41492,9 +41681,6 @@ var TABLE_ACTION_COMMAND_MAP = {
 	fixTables: "table-fix"
 };
 var TABLE_ACTION_COMMAND_IDS = Object.values(TABLE_ACTION_COMMAND_MAP);
-[.../* @__PURE__ */ new Set([...Object.values(HEADLESS_ITEM_MAP), ...TABLE_ACTION_COMMAND_IDS])];
-var NON_HEADLESS_EXECUTE_ITEM_NAMES = /* @__PURE__ */ new Set(["link"]);
-new Set(Object.keys(HEADLESS_ITEM_MAP).filter((itemName) => !NON_HEADLESS_EXECUTE_ITEM_NAMES.has(itemName)));
 //#endregion
 //#region src/internal/toolbar/built-in/Toolbar.vue
 var _hoisted_1$10 = ["data-superdoc-ui-owner"];
@@ -41627,7 +41813,13 @@ var Toolbar_default = /*#__PURE__*/ require__plugin_vue_export_helper._plugin_vu
 			proxy.$toolbar.pendingSelectionCapture = pendingSelectionCapture;
 		};
 		const handleCommand = ({ item, argument, option }) => {
-			restoreSelection();
+			const commandId = resolveToolbarCommandId(item?.name?.value);
+			if (!(item?.type === "button" && !item.isCustomToolbarItem && [
+				"bold",
+				"italic",
+				"underline",
+				"strikethrough"
+			].includes(commandId) && proxy.$toolbar.snapshot?.commands?.[commandId]?.source === "builtin")) restoreSelection();
 			proxy.$toolbar.emitCommand({
 				item,
 				argument,
@@ -41705,7 +41897,7 @@ var Toolbar_default = /*#__PURE__*/ require__plugin_vue_export_helper._plugin_vu
 			], 40, _hoisted_1$10);
 		};
 	}
-}, [["__scopeId", "data-v-19ce2dae"]]);
+}, [["__scopeId", "data-v-9554df11"]]);
 //#endregion
 //#region src/internal/toolbar/built-in/font-options.js
 /**
@@ -42133,8 +42325,8 @@ var numberedStyleButtons = [
 //#region src/internal/toolbar/built-in/DocumentMode.vue
 var _hoisted_1$7 = ["onClick", "onKeydown"];
 var _hoisted_2$7 = { class: "document-mode-column icon-column" };
-var _hoisted_3$5 = ["innerHTML"];
-var _hoisted_4$3 = { class: "document-mode-column text-column" };
+var _hoisted_3$6 = ["innerHTML"];
+var _hoisted_4$4 = { class: "document-mode-column text-column" };
 var _hoisted_5$2 = { class: "document-mode-type" };
 var _hoisted_6$1 = { class: "document-mode-description" };
 var _sfc_main$7 = {
@@ -42197,7 +42389,7 @@ var _sfc_main$7 = {
 				}, [require__plugin_vue_export_helper.createElementVNode("div", _hoisted_2$7, [require__plugin_vue_export_helper.createElementVNode("div", {
 					class: "icon-column__icon",
 					innerHTML: option.icon
-				}, null, 8, _hoisted_3$5)]), require__plugin_vue_export_helper.createElementVNode("div", _hoisted_4$3, [require__plugin_vue_export_helper.createElementVNode("div", _hoisted_5$2, require__plugin_vue_export_helper.toDisplayString(option.label), 1), require__plugin_vue_export_helper.createElementVNode("div", _hoisted_6$1, require__plugin_vue_export_helper.toDisplayString(option.description), 1)])], 42, _hoisted_1$7);
+				}, null, 8, _hoisted_3$6)]), require__plugin_vue_export_helper.createElementVNode("div", _hoisted_4$4, [require__plugin_vue_export_helper.createElementVNode("div", _hoisted_5$2, require__plugin_vue_export_helper.toDisplayString(option.label), 1), require__plugin_vue_export_helper.createElementVNode("div", _hoisted_6$1, require__plugin_vue_export_helper.toDisplayString(option.description), 1)])], 42, _hoisted_1$7);
 			}), 256))], 2);
 		};
 	}
@@ -42214,6 +42406,12 @@ var _hoisted_2$6 = [
 	"onKeydown",
 	"aria-label"
 ];
+var _hoisted_3$5 = [
+	"title",
+	"aria-label",
+	"onClick"
+];
+var _hoisted_4$3 = ["innerHTML"];
 /**
 * Built-in linked-styles (quick format) dropdown list.
 *
@@ -42221,7 +42419,9 @@ var _hoisted_2$6 = [
 * (`StyleCatalogItem`: `id`, `name`, optional `preview.css`, visibility), passed
 * in via the `styles` array. Selecting a style emits the catalogue item; the
 * toolbar controller normalizes it to a style id and routes the apply through
-* the shared `linked-style` command (`styles.paragraph.setStyle`). The rendered
+* the shared `linked-style` command (`styles.paragraph.setStyle`). Each row also
+* carries an "Update to match selection" action that emits `update` with the
+* item; the toolbar routes it through `ui.styles.updateToMatchSelection`. The rendered
 * control stays faithful to the legacy DOM contract
 * (`data-item="btn-linkedStyles-option"`, keyboard navigation) and makes no
 * v1-only shape assumptions.
@@ -42236,9 +42436,13 @@ var _sfc_main$6 = {
 		selectedOption: {
 			type: String,
 			default: null
+		},
+		updateLabel: {
+			type: String,
+			default: "Update to match selection"
 		}
 	},
-	emits: ["select"],
+	emits: ["select", "update"],
 	setup(__props, { emit: __emit }) {
 		const emit = __emit;
 		const styleRefs = require__plugin_vue_export_helper.ref([]);
@@ -42246,6 +42450,9 @@ var _sfc_main$6 = {
 		const select = (style) => {
 			emit("select", style);
 		};
+		const update = (style) => {
+			emit("update", style);
+		};
 		const moveToNextStyle = (index) => {
 			if (index === styleRefs.value.length - 1) return;
 			const nextItem = styleRefs.value[index + 1];
@@ -42305,12 +42512,23 @@ var _sfc_main$6 = {
 					class: "style-name",
 					"data-item": "btn-linkedStyles-option",
 					style: require__plugin_vue_export_helper.normalizeStyle(previewStyle(style))
-				}, require__plugin_vue_export_helper.toDisplayString(styleLabel(style)), 5)], 42, _hoisted_2$6);
+				}, require__plugin_vue_export_helper.toDisplayString(styleLabel(style)), 5), require__plugin_vue_export_helper.createElementVNode("button", {
+					type: "button",
+					class: "style-update",
+					"data-item": "btn-linkedStyles-update",
+					title: props.updateLabel,
+					"aria-label": `${props.updateLabel}: ${styleLabel(style)}`,
+					onClick: require__plugin_vue_export_helper.withModifiers(($event) => update(style), ["stop"]),
+					onKeydown: _cache[0] || (_cache[0] = require__plugin_vue_export_helper.withModifiers(() => {}, ["stop"]))
+				}, [require__plugin_vue_export_helper.createElementVNode("span", {
+					class: "style-update-icon",
+					innerHTML: require__plugin_vue_export_helper.unref(toolbarIcons).paintbrush
+				}, null, 8, _hoisted_4$3)], 40, _hoisted_3$5)], 42, _hoisted_2$6);
 			}), 128))]);
 		};
 	}
 };
-var LinkedStyle_default = /*#__PURE__*/ require__plugin_vue_export_helper._plugin_vue_export_helper_default(_sfc_main$6, [["__scopeId", "data-v-74c8924b"]]);
+var LinkedStyle_default = /*#__PURE__*/ require__plugin_vue_export_helper._plugin_vue_export_helper_default(_sfc_main$6, [["__scopeId", "data-v-b5a32523"]]);
 //#endregion
 //#region src/internal/toolbar/built-in/AIWriter.vue
 var _hoisted_1$5 = ["placeholder"];
@@ -44516,10 +44734,18 @@ var makeDefaultItems = ({ superToolbar, toolbarIcons, toolbarTexts, toolbarFonts
 						argument: styleId
 					});
 				};
+				const handleUpdate = (style) => {
+					closeDropdown(linkedStyles);
+					const styleId = typeof style === "string" ? style : style?.id ?? null;
+					if (!styleId) return;
+					superToolbar.updateLinkedStyleToMatchSelection?.(styleId);
+				};
 				const activeStyleId = superToolbar.getActiveLinkedStyleId?.() ?? null;
 				return require__plugin_vue_export_helper.h("div", {}, [require__plugin_vue_export_helper.h(LinkedStyle_default, {
 					styles: superToolbar.getLinkedStyleOptions?.() ?? [],
 					onSelect: handleSelect,
+					onUpdate: handleUpdate,
+					updateLabel: toolbarTexts.updateLinkedStyle,
 					selectedOption: activeStyleId
 				})]);
 			}
@@ -44778,7 +45004,8 @@ var toolbarTexts = {
 	documentEditingModeDescription: "Edit document directly",
 	documentSuggestingModeDescription: "Edits become suggestions",
 	documentViewingModeDescription: "View clean version of document only",
-	linkedStyles: "Linked styles"
+	linkedStyles: "Linked styles",
+	updateLinkedStyle: "Update to match selection"
 };
 //#endregion
 //#region src/internal/toolbar/built-in/general.js
@@ -45270,12 +45497,16 @@ var BuiltInToolbar = class extends require_eventemitter3.import_eventemitter3.de
 		return this._linkedStyleOptions.value;
 	}
 	#refreshLinkedStyleOptions() {
-		this.ui?.styles?.getCatalog?.({ includePreview: true });
+		const allStyles = this.ui?.styles?.getCatalog?.({ includePreview: true });
 		const options = (this.ui?.styles?.getCatalog?.({
 			view: "quickGallery",
 			includePreview: true
 		}))?.items ?? this.ui?.styles?.getQuickGallery?.() ?? [];
-		if (options !== this._linkedStyleOptions.value) this._linkedStyleOptions.value = options;
+		const activeStyleId = this.ui?.styles?.getActiveParagraphStyle?.()?.styleId;
+		const activeStyle = activeStyleId && !options.some((style) => style.id === activeStyleId) ? allStyles?.styles?.find((style) => style.id === activeStyleId && (style.type === "paragraph" || style.type === "linked")) : null;
+		const nextOptions = activeStyle ? [activeStyle, ...options] : options;
+		const previousOptions = this._linkedStyleOptions.value;
+		if (nextOptions.length !== previousOptions.length || nextOptions.some((style, index) => style !== previousOptions[index])) this._linkedStyleOptions.value = nextOptions;
 	}
 	/**
 	* The stable style id active across the current selection's paragraph(s), or
@@ -45285,6 +45516,17 @@ var BuiltInToolbar = class extends require_eventemitter3.import_eventemitter3.de
 	getActiveLinkedStyleId() {
 		return this.ui?.styles?.getActiveParagraphStyle?.()?.styleId ?? null;
 	}
+	async updateLinkedStyleToMatchSelection(styleId) {
+		if (!styleId || typeof this.ui?.styles?.updateToMatchSelection !== "function") return null;
+		try {
+			return await this.ui.styles.updateToMatchSelection({ styleId });
+		} catch (error) {
+			this.#emitCommandException(error, "linkedStyles");
+			return null;
+		} finally {
+			this.updateToolbarState();
+		}
+	}
 	/**
 	* Compatibility hook: `SuperDoc` calls this when the active editor changes.
 	* The shared controller already tracks selection/transaction state, so this
@@ -46224,7 +46466,7 @@ var SuperDoc = class extends require_eventemitter3.import_eventemitter3.default
 		}
 		this.userColorMap = /* @__PURE__ */ new Map();
 		this.colorIndex = 0;
-		this.version = "2.27.0";
+		this.version = "2.28.0-next.10";
 		this.#log("🦋 [superdoc] Using SuperDoc version:", this.version);
 		this.superdocId = config.superdocId || require_uuid.v4();
 		this.colors = this.config.colors ?? [];
@@ -46940,7 +47182,8 @@ var SuperDoc = class extends require_eventemitter3.import_eventemitter3.default
 			...syncTimeoutOption,
 			...target.serverUrl ? { serverUrl: target.serverUrl } : {},
 			...target.params ? { params: target.params } : {},
-			...target.token ? { token: target.token } : {}
+			...target.token ? { token: target.token } : {},
+			...target.retry !== void 0 ? { retry: target.retry } : {}
 		};
 		return {
 			providerType: "y-websocket",
@@ -48177,12 +48420,13 @@ var SuperDoc = class extends require_eventemitter3.import_eventemitter3.default
 	* Export the superdoc to a file
 	* @param params - Export configuration
 	*/
-	async export({ exportType = ["docx"], commentsType = "external", exportedName, additionalFiles = [], additionalFileNames = [], isFinalDoc = false, triggerDownload = true, fieldsHighlightColor = null } = {}) {
+	async export({ exportType = ["docx"], commentsType, exportedName, additionalFiles = [], additionalFileNames = [], isFinalDoc, policies, triggerDownload = true, fieldsHighlightColor = null } = {}) {
 		if (!Array.isArray(exportType) || exportType.length !== 1 || exportType[0] !== "docx") throw new TypeError("SuperDoc.export() only supports exportType: [\"docx\"].");
 		const baseFileName = exportedName ? cleanName(exportedName) : cleanName(this.config.title);
 		const docxFiles = await this.exportEditorsToDOCX({
 			commentsType,
 			isFinalDoc,
+			policies,
 			fieldsHighlightColor
 		});
 		const blobsToZip = [...additionalFiles];
@@ -48268,7 +48512,12 @@ var SuperDoc = class extends require_eventemitter3.import_eventemitter3.default
 	* Export editors to DOCX format.
 	* @param [options]
 	*/
-	async exportEditorsToDOCX({ commentsType, isFinalDoc, fieldsHighlightColor } = {}) {
+	async exportEditorsToDOCX({ commentsType, isFinalDoc, policies, fieldsHighlightColor } = {}) {
+		if (policies !== void 0) resolveV2DocxExportOptions({
+			policies,
+			commentsType,
+			isFinalDoc
+		});
 		const uiStoreHydrated = this.config?.modules?.comments !== false;
 		let legacyComments;
 		let legacyCommentsComputed = false;
@@ -48288,7 +48537,13 @@ var SuperDoc = class extends require_eventemitter3.import_eventemitter3.default
 		};
 		this.on("exception", rememberBridgedExportError);
 		try {
-			const docxPromises = this.#requireSuperdocStore("exportEditorsToDOCX").documents.map(async (doc) => {
+			const documents = this.#requireSuperdocStore("exportEditorsToDOCX").documents;
+			if (policies !== void 0 && documents.some((doc) => {
+				if (doc.type !== "application/vnd.openxmlformats-officedocument.wordprocessingml.document") return false;
+				const editor = doc.getEditor?.();
+				return editor?.editorVersion !== 2 || typeof editor.exportDocx !== "function";
+			})) throw new Error("Independent DOCX export policies require a mounted V2 exporter for every document.");
+			const docxPromises = documents.map(async (doc) => {
 				if (!doc || doc.type !== "application/vnd.openxmlformats-officedocument.wordprocessingml.document") return null;
 				const editor = typeof doc.getEditor === "function" ? doc.getEditor() : null;
 				const fallbackDocx = () => {
@@ -48305,6 +48560,7 @@ var SuperDoc = class extends require_eventemitter3.import_eventemitter3.default
 					const exported = await editor.exportDocx(isV2Editor ? {
 						isFinalDoc,
 						commentsType,
+						policies,
 						fieldsHighlightColor
 					} : {
 						isFinalDoc,
@@ -48633,7 +48889,11 @@ function defineSuperDocExtension(extension) {
 	return extension;
 }
 //#endregion
-exports.BlankDOCX = require_blank_docx.blank_default;
+//#region src/public/index.ts
+/** URL to the blank DOCX template. */
+var BlankDOCX = require_blank_docx.blank_default;
+//#endregion
+exports.BlankDOCX = BlankDOCX;
 exports.DOCX = DOCX;
 exports.DocumentLoadError = DocumentLoadError;
 exports.HTML = HTML;