superdoc 2.20.0 → 2.20.1-next.10

package/dist/superdoc/src/public/ui/types.d.ts

@@ -163,7 +163,7 @@ export interface FontSizeOption {
 }
 /** Observable enable/active state for a toolbar-style command. */
 export interface CommandState {
-    /** The command can run against the current selection / mode. */
+    /** Availability for a control in the current selection / mode snapshot. */
     enabled: boolean;
     /** Compatibility inverse of `enabled` for demo code that models commands as disabled. */
     disabled?: boolean;
@@ -278,9 +278,10 @@ export type SuperDocUIReceipt = Receipt | SuperDocUIFailureReceipt | PartialLink
  * preserves the public Document API facade result (or a controller-minted
  * failure), including read-only / unsupported failures and mutation effects.
  * `true` is returned for legacy command handlers that do not produce a
- * structured result, or when the host reports only that an async browser
- * operation was scheduled. Use `executeAsync(...)` to await the settled result
- * when the browser Document API / host runs asynchronously.
+ * structured result, including accepted no-ops, or when the host reports only
+ * that an async browser operation was scheduled. Use `executeAsync(...)` to await the settled result
+ * when the browser Document API / host runs asynchronously. A settled `true`
+ * does not guarantee a document mutation, such as Undo with an empty history.
  */
 export type CommandExecutionResult = boolean | SuperDocUIReceipt;
 /**
@@ -333,16 +334,18 @@ export interface CommandHandle<Id extends CommandId = CommandId> {
     observe(listener: (state: CommandState) => void): () => void;
     /**
      * Run the command. Returns the Document API receipt when the host facade
-     * provides one, or `false` for unsupported / disabled commands rather than
-     * throwing. When the browser operation settles asynchronously this returns
-     * the immediate routed result (`true` or a sync receipt); use
+     * provides one, or `false` when routing or current execution prerequisites
+     * are unavailable rather than throwing. When the browser operation settles
+     * asynchronously this returns the immediate routed result (`true` or a sync receipt); use
      * `executeAsync(...)` to await settlement.
      */
     execute(payload?: unknown): CommandExecutionResult;
     /**
      * Run the command and resolve once the routed operation has settled. On
      * browser-backed hosts this includes the post-mutation paint observation
-     * boundary when available.
+     * boundary when available. Selection-dependent commands may refresh stale
+     * selection state before execution. A settled `true` can be an accepted
+     * no-op and does not guarantee a document mutation.
      */
     executeAsync(payload?: unknown): Promise<CommandExecutionResult>;
 }

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-BQBQsjoe.cjs");
+const require_create_super_doc_ui = require("./chunks/create-super-doc-ui-j8Qm5SYa.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-CYxINHh_.cjs");
@@ -316,7 +316,7 @@ var shuffleArray = (array) => {
 var DEFAULT_ENDPOINT = "https://ingest.superdoc.dev/v1/collect";
 function getSuperdocVersion() {
 	try {
-		return "2.20.0";
+		return "2.20.1-next.10";
 	} catch {
 		return "unknown";
 	}
@@ -8923,6 +8923,11 @@ var useCommentsStore = defineStore("comments", () => {
 		}
 		superdoc?.activeEditor?.commands?.removeComment({ commentId: "pending" });
 	};
+	const getV2CreatedComment = ({ outcome, reconciled, documentId }) => {
+		const createdId = normalizeCommentId(outcome?.createdCommentId);
+		if (!createdId) return reconciled?.added ?? null;
+		return commentsList.value.find((row) => String(row.commentId) === createdId && (documentId == null || String(row.fileId) === String(documentId))) ?? null;
+	};
 	/**
 	* Add a new comment to the document
 	*
@@ -8976,20 +8981,25 @@ var useCommentsStore = defineStore("comments", () => {
 					documentId: v2Adapter.documentId,
 					items: outcome.items
 				});
+				const created = getV2CreatedComment({
+					outcome,
+					reconciled,
+					documentId: v2Adapter.documentId
+				});
 				const hadPendingComment = !!pendingComment.value;
 				if (hadPendingComment) removePendingComment(superdoc);
-				const createdId = reconciled?.added?.commentId ?? null;
+				const createdId = created?.commentId ?? null;
 				if (hadPendingComment && createdId) {
 					setActiveComment(superdoc, createdId);
 					setActiveFloatingCommentInstance(createdId);
 				}
 				if (broadcastChanges) superdoc.emit("comments-update", {
 					type: COMMENT_EVENTS.ADD,
-					comment: reconciled?.added?.getValues?.() ?? null
+					comment: created?.getValues?.() ?? null
 				});
 				return {
 					ok: true,
-					comment: reconciled?.added ?? null
+					comment: created
 				};
 			});
 		}
@@ -9548,9 +9558,13 @@ var useCommentsStore = defineStore("comments", () => {
 			eventType: COMMENT_EVENTS.ADD,
 			rejectionFallbackReason: "v2-reply-failed",
 			rejectionEventExtras: parent ? { comment: getCommentEventPayload(parent) } : {},
-			successEventBuilder: ({ reconciled }) => ({
+			successEventBuilder: ({ outcome, reconciled }) => ({
 				type: COMMENT_EVENTS.ADD,
-				comment: reconciled?.added?.getValues?.() ?? null
+				comment: getV2CreatedComment({
+					outcome,
+					reconciled,
+					documentId: v2Adapter.documentId
+				})?.getValues?.() ?? null
 			})
 		});
 	};
@@ -13167,51 +13181,53 @@ 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 = { class: "tracked-change-text is-deleted" };
-var _hoisted_31 = { key: 9 };
-var _hoisted_32 = { class: "tracked-change-text is-inserted" };
-var _hoisted_33 = ["data-track-change-image-preview-role"];
-var _hoisted_34 = ["src", "alt"];
-var _hoisted_35 = {
+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 = {
 	key: 1,
 	class: "card-section comment-body"
 };
-var _hoisted_36 = ["innerHTML"];
-var _hoisted_37 = {
+var _hoisted_38 = ["innerHTML"];
+var _hoisted_39 = {
 	key: 1,
 	class: "comment"
 };
-var _hoisted_38 = {
+var _hoisted_40 = {
 	key: 2,
 	class: "reply-expanded"
 };
-var _hoisted_39 = { class: "reply-input-wrapper" };
-var _hoisted_40 = { class: "reply-actions" };
-var _hoisted_41 = ["onClick"];
-var _hoisted_42 = [
+var _hoisted_41 = { class: "reply-input-wrapper" };
+var _hoisted_42 = { class: "reply-actions" };
+var _hoisted_43 = ["onClick"];
+var _hoisted_44 = [
 	"onClick",
 	"disabled",
 	"data-disabled-reason"
 ];
-var _hoisted_43 = { class: "collapsed-avatars" };
-var _hoisted_44 = {
+var _hoisted_45 = { class: "collapsed-avatars" };
+var _hoisted_46 = {
 	key: 3,
 	class: "comment-separator"
 };
-var _hoisted_45 = {
+var _hoisted_47 = {
 	key: 2,
 	class: "tracked-change-decision-alert",
 	role: "alert"
 };
-var _hoisted_46 = { class: "tracked-change-decision-alert__message" };
-var _hoisted_47 = ["disabled", "data-disabled-reason"];
-var _hoisted_48 = {
+var _hoisted_48 = { class: "tracked-change-decision-alert__message" };
+var _hoisted_49 = ["disabled", "data-disabled-reason"];
+var _hoisted_50 = {
 	key: 1,
 	class: "reply-expanded"
 };
-var _hoisted_49 = { class: "reply-input-wrapper" };
-var _hoisted_50 = { class: "reply-actions" };
-var _hoisted_51 = ["disabled", "data-disabled-reason"];
+var _hoisted_51 = { class: "reply-input-wrapper" };
+var _hoisted_52 = { class: "reply-actions" };
+var _hoisted_53 = ["disabled", "data-disabled-reason"];
 var CLICK_OUTSIDE_HIT_TOLERANCE_PX = 3;
 var TRACKED_CHANGE_PREVIEW_MAX_PX = 90;
 var _sfc_main$34 = {
@@ -14221,8 +14237,8 @@ var _sfc_main$34 = {
 								require__plugin_vue_export_helper.createElementVNode("span", _hoisted_27, "\"" + 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 ? (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 ", -1)), require__plugin_vue_export_helper.createElementVNode("span", _hoisted_30, "\"" + 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_31, [_cache[11] || (_cache[11] = require__plugin_vue_export_helper.createElementVNode("span", { class: "change-type" }, "Added ", -1)), require__plugin_vue_export_helper.createElementVNode("span", _hoisted_32, "\"" + 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: 10,
+							])) : 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", {
+								key: 12,
 								class: "tracked-change-image-preview",
 								"data-track-change-image-preview-role": comment.trackedChangeImagePreview.role ?? void 0
 							}, [require__plugin_vue_export_helper.createElementVNode("img", {
@@ -14232,7 +14248,7 @@ var _sfc_main$34 = {
 								style: require__plugin_vue_export_helper.normalizeStyle(trackedChangeImagePreviewStyle(comment.trackedChangeImagePreview)),
 								loading: "lazy",
 								decoding: "async"
-							}, null, 12, _hoisted_34)], 8, _hoisted_33)) : require__plugin_vue_export_helper.createCommentVNode("", true)], 10, _hoisted_10$3),
+							}, null, 12, _hoisted_36)], 8, _hoisted_35)) : require__plugin_vue_export_helper.createCommentVNode("", true)], 10, _hoisted_10$3),
 							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",
@@ -14244,29 +14260,29 @@ var _sfc_main$34 = {
 								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_35, [
+						!comment.trackedChange ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("div", _hoisted_37, [
 							!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: comment.commentText
-							}, null, 10, _hoisted_36)) : require__plugin_vue_export_helper.unref(isDebugging) && !isEditingThisComment.value(comment) ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("div", _hoisted_37, 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_38, [require__plugin_vue_export_helper.createElementVNode("div", _hoisted_39, [require__plugin_vue_export_helper.createVNode(CommentInput_default, {
+							}, 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, {
 								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_40, [require__plugin_vue_export_helper.createElementVNode("button", {
+							}, null, 8, ["config", "comment"])]), require__plugin_vue_export_helper.createElementVNode("div", _hoisted_42, [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_41), require__plugin_vue_export_helper.createElementVNode("button", {
+							}, "Cancel", 8, _hoisted_43), 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_42)])])),
+							}, " Update ", 10, _hoisted_44)])])),
 							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",
@@ -14278,20 +14294,20 @@ var _sfc_main$34 = {
 								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),
-						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[12] || (_cache[12] = require__plugin_vue_export_helper.createElementVNode("div", { class: "comment-separator" }, null, -1)), require__plugin_vue_export_helper.createElementVNode("div", {
+						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_43, [(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_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) => {
 							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_44)) : 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)
 					]);
 				}), 128)),
-				trackedChangeDecisionFailure.value ? (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("div", _hoisted_45, [require__plugin_vue_export_helper.createElementVNode("span", _hoisted_46, 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_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", {
 					type: "button",
 					class: "sd-button tracked-change-decision-alert__retry",
 					onClick: require__plugin_vue_export_helper.withModifiers(retryTrackedChangeDecision, ["stop", "prevent"])
@@ -14303,7 +14319,7 @@ var _sfc_main$34 = {
 					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_47)) : (require__plugin_vue_export_helper.openBlock(), require__plugin_vue_export_helper.createElementBlock("div", _hoisted_48, [require__plugin_vue_export_helper.createElementVNode("div", _hoisted_49, [require__plugin_vue_export_helper.createVNode(CommentInput_default, {
+				}, " 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, {
 					ref_key: "commentInput",
 					ref: commentInput,
 					users: usersFiltered.value,
@@ -14314,7 +14330,7 @@ var _sfc_main$34 = {
 					"users",
 					"config",
 					"comment"
-				])]), require__plugin_vue_export_helper.createElementVNode("div", _hoisted_50, [require__plugin_vue_export_helper.createElementVNode("button", {
+				])]), require__plugin_vue_export_helper.createElementVNode("div", _hoisted_52, [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", {
@@ -14322,12 +14338,12 @@ var _sfc_main$34 = {
 					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_51)])]))], 64)) : require__plugin_vue_export_helper.createCommentVNode("", true)
+				}, " Reply ", 10, _hoisted_53)])]))], 64)) : require__plugin_vue_export_helper.createCommentVNode("", true)
 			], 64))], 14, _hoisted_1$27)), [[_directive_click_outside, handleClickOutside]]);
 		};
 	}
 };
-var CommentDialog_default = /*#__PURE__*/ require__plugin_vue_export_helper._plugin_vue_export_helper_default(_sfc_main$34, [["__scopeId", "data-v-bc46ac97"]]);
+var CommentDialog_default = /*#__PURE__*/ require__plugin_vue_export_helper._plugin_vue_export_helper_default(_sfc_main$34, [["__scopeId", "data-v-eefd4750"]]);
 //#endregion
 //#region src/components/CommentsLayer/commentsList/ReviewDirectoryListItem.vue
 var _hoisted_1$26 = [
@@ -22176,6 +22192,7 @@ var SuperDoc_default = /*#__PURE__*/ require__plugin_vue_export_helper._plugin_v
 			if (!documentId) return;
 			clearV2CommandShortcutBinding(documentId);
 			if (typeof bindEditShortcuts !== "function") return;
+			getSuperDocUI();
 			const openLinkWorkflow = resolveV2LinkWorkflowOpener();
 			const unbind = bindEditShortcuts({
 				commandRoute: {
@@ -24520,7 +24537,7 @@ var SuperDoc_default = /*#__PURE__*/ require__plugin_vue_export_helper._plugin_v
 			], 38);
 		};
 	}
-}, [["__scopeId", "data-v-7bbf01da"]]);
+}, [["__scopeId", "data-v-e476c448"]]);
 //#endregion
 //#region src/core/create-app.js
 var PINIA_DEVTOOLS_SETUP_EVENT = "devtools-plugin:setup";
@@ -40542,6 +40559,7 @@ var _sfc_main$15 = {
 					ref_key: "popupRef",
 					ref: popupRef,
 					role: "listbox",
+					"data-sd-part": "dropdown-menu",
 					id: listboxId.value,
 					"aria-label": ariaLabel.value,
 					class: require__plugin_vue_export_helper.normalizeClass(["sd-font-combobox__listbox", { "high-contrast": require__plugin_vue_export_helper.unref(isHighContrastMode) }]),
@@ -40571,7 +40589,7 @@ var _sfc_main$15 = {
 		};
 	}
 };
-var ToolbarComboBox_default = /*#__PURE__*/ require__plugin_vue_export_helper._plugin_vue_export_helper_default(_sfc_main$15, [["__scopeId", "data-v-53e0af20"]]);
+var ToolbarComboBox_default = /*#__PURE__*/ require__plugin_vue_export_helper._plugin_vue_export_helper_default(_sfc_main$15, [["__scopeId", "data-v-e288ef9f"]]);
 //#endregion
 //#region src/internal/toolbar/built-in/FontFamilyCombobox.vue
 var _sfc_main$14 = {
@@ -41609,10 +41627,9 @@ var Toolbar_default = /*#__PURE__*/ require__plugin_vue_export_helper._plugin_vu
 		});
 		const showLeftSide = proxy.$toolbar.config?.toolbarGroups?.includes("left");
 		const showRightSide = proxy.$toolbar.config?.toolbarGroups?.includes("right");
-		const excludeButtonsList = proxy.$toolbar.config?.toolbarButtonsExclude || [];
 		const getFilteredItems = (position) => {
 			toolbarStateVersion.value;
-			return proxy.$toolbar.getToolbarItemByGroup(position).filter((item) => !excludeButtonsList.includes(item.name.value));
+			return proxy.$toolbar.getToolbarItemByGroup(position);
 		};
 		const updateCompactSideGroups = () => {
 			compactSideGroups.value = proxy.$toolbar.getAvailableWidth() <= RESPONSIVE_BREAKPOINTS.lg;
@@ -41786,7 +41803,7 @@ var Toolbar_default = /*#__PURE__*/ require__plugin_vue_export_helper._plugin_vu
 			], 32);
 		};
 	}
-}, [["__scopeId", "data-v-9418cc7d"]]);
+}, [["__scopeId", "data-v-0d00bc5b"]]);
 //#endregion
 //#region src/internal/toolbar/built-in/font-options.js
 /**
@@ -43548,6 +43565,35 @@ var getToolbarItemWidth = (item, controlSizes) => {
 	if (item.type === "separator") return controlSizes.get("separator");
 	return controlSizes.get(item.name.value) || controlSizes.get("default");
 };
+var collapseSeparatorRun = (items) => {
+	const result = [];
+	for (const item of items) {
+		if (item.type === "separator") {
+			const previous = result[result.length - 1];
+			if (!previous || previous.type === "separator") continue;
+		}
+		result.push(item);
+	}
+	while (result.length && result[result.length - 1].type === "separator") result.pop();
+	return result;
+};
+var normalizeSeparators = (items) => {
+	const byGroup = /* @__PURE__ */ new Map();
+	for (const item of items) {
+		const group = item.group?.value || "center";
+		if (!byGroup.has(group)) byGroup.set(group, []);
+		byGroup.get(group).push(item);
+	}
+	const kept = /* @__PURE__ */ new Set();
+	for (const groupItems of byGroup.values()) for (const item of collapseSeparatorRun(groupItems)) kept.add(item);
+	return items.filter((item) => kept.has(item));
+};
+var normalizeSeparatorsIgnoringOverflow = (items) => {
+	const overflowTrigger = items.find((item) => item.type === "overflow");
+	const withoutOverflow = items.filter((item) => item !== overflowTrigger);
+	const kept = new Set(normalizeSeparators(withoutOverflow));
+	return items.filter((item) => item === overflowTrigger || kept.has(item));
+};
 /**
 * Set or clear the link item's `href` without disturbing the rest of its
 * attributes. The static configuration (`ariaLabel`, and anything added later)
@@ -43602,7 +43648,7 @@ function hasAiModule(superToolbar) {
 function aiModuleConfig(superToolbar) {
 	return superToolbar.config?.superdoc?.config?.modules?.ai ?? superToolbar.superdoc?.config?.modules?.ai ?? {};
 }
-var makeDefaultItems = ({ superToolbar, toolbarIcons, toolbarTexts, toolbarFonts, hideButtons, availableWidth, role, isDev = false, configuredItemNames, excludedItemNames, additionalItems = [] } = {}) => {
+var makeDefaultItems = ({ superToolbar, toolbarIcons, toolbarTexts, toolbarFonts, hideButtons, availableWidth, role, isDev = false, configuredItemNames, configuredItemOrder, excludedItemNames, additionalItems = [] } = {}) => {
 	const bold = useToolbarItem({
 		type: "button",
 		name: "bold",
@@ -44712,9 +44758,15 @@ var makeDefaultItems = ({ superToolbar, toolbarIcons, toolbarTexts, toolbarFonts
 	}
 	if (configuredItemNames) toolbarItems = toolbarItems.filter((item) => item.name.value === "overflow" || item.isCustomToolbarItem || configuredItemNames.has(item.name.value));
 	if (excludedItemNames?.size) toolbarItems = toolbarItems.filter((item) => !excludedItemNames.has(item.name.value));
+	toolbarItems = normalizeSeparatorsIgnoringOverflow(toolbarItems);
 	const isStickyItem = (item) => stickyItemNames.includes(item.name.value);
 	const overflowTrigger = toolbarItems.find((item) => item.name.value === "overflow");
 	const layoutItems = toolbarItems.filter((item) => item !== overflowTrigger);
+	if (configuredItemOrder) {
+		const orderIndex = new Map(configuredItemOrder.map((name, index) => [name, index]));
+		const rank = (item) => orderIndex.get(item.name.value) ?? Number.MAX_SAFE_INTEGER;
+		layoutItems.sort((a, b) => rank(a) - rank(b));
+	}
 	const partitionItems = (reserveOverflowTrigger) => {
 		const overflowItems = [];
 		const visibleItems = [];
@@ -44756,6 +44808,7 @@ var makeDefaultItems = ({ superToolbar, toolbarIcons, toolbarTexts, toolbarFonts
 		if (insertAt === -1) visibleItems.push(overflowTrigger);
 		else visibleItems.splice(insertAt, 0, overflowTrigger);
 	}
+	visibleItems = normalizeSeparators(visibleItems);
 	return {
 		defaultItems: visibleItems,
 		overflowItems: overflowItems.filter((item) => item.type !== "separator")
@@ -44976,6 +45029,7 @@ var BuiltInToolbar = class extends require_eventemitter3.import_eventemitter3.de
 		responsiveToContainer: false,
 		mode: "docx",
 		excludeItems: [],
+		toolbarButtonsExclude: [],
 		groups: null,
 		customButtons: [],
 		showFormattingMarksButton: false,
@@ -45141,7 +45195,7 @@ var BuiltInToolbar = class extends require_eventemitter3.import_eventemitter3.de
 		const selectedCustomOptions = new Map(this.#getAllToolbarItems().filter((item) => item.isCustomToolbarItem && item.type === "dropdown").map((item) => [item.name.value, item.selectedValue.value]));
 		const hasExplicitGroupComposition = this.config.groups && !Array.isArray(this.config.groups) && Object.keys(this.config.groups).length > 0;
 		const configuredItemNames = hasExplicitGroupComposition ? new Set(Object.values(this.config.groups).flatMap((items) => items)) : null;
-		const excludedItemNames = new Set(this.config.excludeItems);
+		const excludedItemNames = /* @__PURE__ */ new Set([...this.config.excludeItems ?? [], ...this.config.toolbarButtonsExclude ?? []]);
 		const customItems = this.config.customButtons || [];
 		const takenNames = new Set(RESERVED_TOOLBAR_ITEM_NAMES);
 		const customToolbarItems = customItems.map((item, index) => {
@@ -45162,6 +45216,12 @@ var BuiltInToolbar = class extends require_eventemitter3.import_eventemitter3.de
 		}).filter(Boolean);
 		const configuredGroups = hasExplicitGroupComposition ? new Set(Object.keys(this.config.groups)) : null;
 		const layoutCustomItems = configuredGroups ? customToolbarItems.filter((item) => configuredGroups.has(item.group?.value || "center")) : customToolbarItems;
+		let allConfigItems = null;
+		if (hasExplicitGroupComposition) {
+			const groupedItems = Object.values(this.config.groups).flatMap((item) => item);
+			const groupedCustomItems = customToolbarItems.filter((item) => configuredGroups.has(item.group?.value || "center")).map((item) => item.name.value);
+			allConfigItems = [.../* @__PURE__ */ new Set([...groupedItems, ...groupedCustomItems])];
+		}
 		const { defaultItems, overflowItems } = makeDefaultItems({
 			superToolbar: this,
 			toolbarIcons: this.config.icons,
@@ -45172,18 +45232,29 @@ var BuiltInToolbar = class extends require_eventemitter3.import_eventemitter3.de
 			role: this.role,
 			isDev: this.isDev,
 			configuredItemNames,
+			configuredItemOrder: allConfigItems,
 			excludedItemNames,
 			additionalItems: layoutCustomItems
 		});
-		let allConfigItems = [...defaultItems.map((item) => item.name.value), ...overflowItems.map((item) => item.name.value)];
-		if (hasExplicitGroupComposition) {
-			const groupedItems = Object.values(this.config.groups).flatMap((item) => item);
-			const groupedCustomItems = customToolbarItems.filter((item) => configuredGroups.has(item.group?.value || "center")).map((item) => item.name.value);
-			allConfigItems = [.../* @__PURE__ */ new Set([...groupedItems, ...groupedCustomItems])];
-		}
+		if (!hasExplicitGroupComposition) allConfigItems = [...defaultItems.map((item) => item.name.value), ...overflowItems.map((item) => item.name.value)];
 		const configuredOverflowItems = overflowItems.filter((item) => allConfigItems.includes(item.name.value) && !excludedItemNames.has(item.name.value));
 		const visibleItemNames = configuredOverflowItems.length ? [...allConfigItems, "overflow"] : allConfigItems;
 		const filteredItems = defaultItems.filter((item) => visibleItemNames.includes(item.name.value)).filter((item) => !excludedItemNames.has(item.name.value));
+		if (hasExplicitGroupComposition) {
+			const orderIndex = new Map(allConfigItems.map((name, index) => [name, index]));
+			const rank = (item) => orderIndex.get(item.name.value) ?? Number.MAX_SAFE_INTEGER;
+			const overflowTrigger = filteredItems.find((item) => item.name.value === "overflow");
+			const originalIndex = new Map(filteredItems.map((item, index) => [item, index]));
+			const reordered = filteredItems.filter((item) => item !== overflowTrigger);
+			reordered.sort((a, b) => rank(a) - rank(b));
+			if (overflowTrigger) {
+				const triggerOriginalIndex = originalIndex.get(overflowTrigger);
+				const insertAt = reordered.findIndex((item) => originalIndex.get(item) > triggerOriginalIndex);
+				insertAt === -1 ? reordered.push(overflowTrigger) : reordered.splice(insertAt, 0, overflowTrigger);
+			}
+			filteredItems.splice(0, filteredItems.length, ...reordered);
+			configuredOverflowItems.sort((a, b) => rank(a) - rank(b));
+		}
 		if (hasExplicitGroupComposition) {
 			for (const [group, names] of Object.entries(this.config.groups)) for (const item of filteredItems) if (names.includes(item.name.value)) item.group.value = group;
 		}
@@ -46283,7 +46354,7 @@ var SuperDoc = class extends require_eventemitter3.import_eventemitter3.default
 		this.config.colors = shuffleArray(this.config.colors);
 		this.userColorMap = /* @__PURE__ */ new Map();
 		this.colorIndex = 0;
-		this.version = "2.20.0";
+		this.version = "2.20.1-next.10";
 		this.#log("🦋 [superdoc] Using SuperDoc version:", this.version);
 		this.superdocId = config.superdocId || require_uuid.v4();
 		this.colors = this.config.colors ?? [];