superdoc 2.20.0 → 2.20.1-next.2

package/dist/chunks/{create-super-doc-ui-D5VrP4Dx.es.js → create-super-doc-ui-B4_V1haj.es.js}

@@ -4219,6 +4219,14 @@ function readCollapsedHostTrackChangeId(snapshot) {
 	const focusId = focusVisual?.trackChangeId;
 	return typeof anchorId === "string" && anchorId.length > 0 && anchorId === focusId ? anchorId : null;
 }
+function isNonCollapsedHostSelection(snapshot) {
+	if (!snapshot || typeof snapshot !== "object") return false;
+	const record = snapshot;
+	const anchor = record.anchor;
+	const focus = record.focus;
+	if (typeof anchor?.blockId !== "string" || !anchor.blockId || typeof focus?.blockId !== "string" || !focus.blockId || !Number.isFinite(anchor.blockOffset) || !Number.isFinite(focus.blockOffset)) return false;
+	return anchor.blockId !== focus.blockId || anchor.blockOffset !== focus.blockOffset || Number.isFinite(anchor.trackedBlockOffset) && Number.isFinite(focus.trackedBlockOffset) && anchor.trackedBlockOffset !== focus.trackedBlockOffset;
+}
 var trackedChangeIdContextCache = /* @__PURE__ */ new WeakMap();
 /**
 * Collect the raw source-provenance ids a tracked-change list item exposes,
@@ -6250,7 +6258,7 @@ function createSuperDocUI(options) {
 				}
 				if (pendingPostPaintSelectionRefresh) continue;
 				selectionEpoch += 1;
-				seedCaretSelectionFromHost();
+				refreshSelectionFromHost();
 				recompute(paintCompleted ? "post-paint-selection" : "post-paint-selection-failed");
 			}
 		};
@@ -6647,8 +6655,9 @@ function createSuperDocUI(options) {
 	* effective font resolved from it) on the next recompute, instead of serving
 	* the previous selection until the worker `selection.current` round-trip lands
 	* (SD-3652). Only a resolvable COLLAPSED CARET is seeded - a range's snapshot
-	* cannot be resolved synchronously in worker mode, so ranges defer to the async
-	* read (seeding an empty value would wrongly disable range-only commands). The
+	* cannot be resolved synchronously in worker mode, so a new range starts an
+	* authoritative async read without waiting for the input-idle gate (SD-5394).
+	* Seeding an empty value would wrongly disable range-only commands. The
 	* authoritative async read still overwrites marks/text/review overlap, but
 	* foreground typing defers and coalesces that worker hop through the shared
 	* retry gate. Previous marks are carried forward for toolbar continuity. A
@@ -6656,14 +6665,19 @@ function createSuperDocUI(options) {
 	* same carrier, or while an active typing dispatch advances the same caret by
 	* one code point. Pending work alone never carries review command context.
 	*/
-	const seedCaretSelectionFromHost = (hostSelectionSnapshot) => {
+	const refreshSelectionFromHost = (hostSelectionSnapshot) => {
+		const foreground = foregroundMutationState();
+		if (isNonCollapsedHostSelection(hostSelectionSnapshot) && !(foreground && foreground.active > 0)) {
+			pendingSelectionSeedValidationToken = null;
+			issueAsyncRead("selection", selectionReadToken(), selectionCurrentRun, normalizeSelectionInfo);
+			return;
+		}
 		const host = getHost();
 		const read = host?.readLiveSelectionSyncSnapshot;
 		if (typeof read !== "function") return;
 		const seed = normalizeSelectionInfo(safeCall(() => read.call(host), null));
 		if (!seed || !isCollapsedCaretSnapshot(seed)) return;
 		const token = selectionReadToken();
-		const foreground = foregroundMutationState();
 		const deferAuthoritativeRead = Boolean(foreground && (foreground.active > 0 || foreground.pending > 0));
 		if (!deferAuthoritativeRead) {
 			pendingSelectionSeedValidationToken = null;
@@ -8895,7 +8909,7 @@ function createSuperDocUI(options) {
 			const unsubscribe = next.subscribe((snapshot) => {
 				if (foregroundMutationActive() && caretSelectionNeedsProjectionPaint() && schedulePostPaintSelectionRefresh()) return;
 				selectionEpoch += 1;
-				seedCaretSelectionFromHost(snapshot);
+				refreshSelectionFromHost(snapshot);
 				recompute("host-selection");
 			});
 			if (typeof unsubscribe === "function") detachHostSelection = unsubscribe;

package/dist/chunks/{create-super-doc-ui-BQBQsjoe.cjs → create-super-doc-ui-DFCfYEpW.cjs}

@@ -4220,6 +4220,14 @@ function readCollapsedHostTrackChangeId(snapshot) {
 	const focusId = focusVisual?.trackChangeId;
 	return typeof anchorId === "string" && anchorId.length > 0 && anchorId === focusId ? anchorId : null;
 }
+function isNonCollapsedHostSelection(snapshot) {
+	if (!snapshot || typeof snapshot !== "object") return false;
+	const record = snapshot;
+	const anchor = record.anchor;
+	const focus = record.focus;
+	if (typeof anchor?.blockId !== "string" || !anchor.blockId || typeof focus?.blockId !== "string" || !focus.blockId || !Number.isFinite(anchor.blockOffset) || !Number.isFinite(focus.blockOffset)) return false;
+	return anchor.blockId !== focus.blockId || anchor.blockOffset !== focus.blockOffset || Number.isFinite(anchor.trackedBlockOffset) && Number.isFinite(focus.trackedBlockOffset) && anchor.trackedBlockOffset !== focus.trackedBlockOffset;
+}
 var trackedChangeIdContextCache = /* @__PURE__ */ new WeakMap();
 /**
 * Collect the raw source-provenance ids a tracked-change list item exposes,
@@ -6251,7 +6259,7 @@ function createSuperDocUI(options) {
 				}
 				if (pendingPostPaintSelectionRefresh) continue;
 				selectionEpoch += 1;
-				seedCaretSelectionFromHost();
+				refreshSelectionFromHost();
 				recompute(paintCompleted ? "post-paint-selection" : "post-paint-selection-failed");
 			}
 		};
@@ -6648,8 +6656,9 @@ function createSuperDocUI(options) {
 	* effective font resolved from it) on the next recompute, instead of serving
 	* the previous selection until the worker `selection.current` round-trip lands
 	* (SD-3652). Only a resolvable COLLAPSED CARET is seeded - a range's snapshot
-	* cannot be resolved synchronously in worker mode, so ranges defer to the async
-	* read (seeding an empty value would wrongly disable range-only commands). The
+	* cannot be resolved synchronously in worker mode, so a new range starts an
+	* authoritative async read without waiting for the input-idle gate (SD-5394).
+	* Seeding an empty value would wrongly disable range-only commands. The
 	* authoritative async read still overwrites marks/text/review overlap, but
 	* foreground typing defers and coalesces that worker hop through the shared
 	* retry gate. Previous marks are carried forward for toolbar continuity. A
@@ -6657,14 +6666,19 @@ function createSuperDocUI(options) {
 	* same carrier, or while an active typing dispatch advances the same caret by
 	* one code point. Pending work alone never carries review command context.
 	*/
-	const seedCaretSelectionFromHost = (hostSelectionSnapshot) => {
+	const refreshSelectionFromHost = (hostSelectionSnapshot) => {
+		const foreground = foregroundMutationState();
+		if (isNonCollapsedHostSelection(hostSelectionSnapshot) && !(foreground && foreground.active > 0)) {
+			pendingSelectionSeedValidationToken = null;
+			issueAsyncRead("selection", selectionReadToken(), selectionCurrentRun, normalizeSelectionInfo);
+			return;
+		}
 		const host = getHost();
 		const read = host?.readLiveSelectionSyncSnapshot;
 		if (typeof read !== "function") return;
 		const seed = normalizeSelectionInfo(safeCall(() => read.call(host), null));
 		if (!seed || !isCollapsedCaretSnapshot(seed)) return;
 		const token = selectionReadToken();
-		const foreground = foregroundMutationState();
 		const deferAuthoritativeRead = Boolean(foreground && (foreground.active > 0 || foreground.pending > 0));
 		if (!deferAuthoritativeRead) {
 			pendingSelectionSeedValidationToken = null;
@@ -8896,7 +8910,7 @@ function createSuperDocUI(options) {
 			const unsubscribe = next.subscribe((snapshot) => {
 				if (foregroundMutationActive() && caretSelectionNeedsProjectionPaint() && schedulePostPaintSelectionRefresh()) return;
 				selectionEpoch += 1;
-				seedCaretSelectionFromHost(snapshot);
+				refreshSelectionFromHost(snapshot);
 				recompute("host-selection");
 			});
 			if (typeof unsubscribe === "function") detachHostSelection = unsubscribe;

package/dist/collaboration-upgrade-engine.cjs

@@ -19,7 +19,7 @@ var COLLABORATION_UPGRADE_ENGINE_MINIMUM_NODE_MAJOR = 20;
 var PRIVATE_ENGINE_INFO = (0, _superdoc_docx_engine_collaboration_upgrade_engine.getCollaborationUpgradeEngineInfo)();
 var ENGINE_INFO = Object.freeze({
 	...PRIVATE_ENGINE_INFO,
-	superdocVersion: "2.20.0",
+	superdocVersion: "2.20.1-next.2",
 	roomSchemaVersion: Object.freeze({ ...PRIVATE_ENGINE_INFO.roomSchemaVersion }),
 	supportedBundleVersions: SUPPORTED_COLLABORATION_UPGRADE_BUNDLE_VERSIONS,
 	supportedV1ReaderContractVersions: SUPPORTED_V1_READER_CONTRACT_VERSIONS

package/dist/collaboration-upgrade-engine.es.js

@@ -18,7 +18,7 @@ var COLLABORATION_UPGRADE_ENGINE_MINIMUM_NODE_MAJOR = 20;
 var PRIVATE_ENGINE_INFO = getCollaborationUpgradeEngineInfo$1();
 var ENGINE_INFO = Object.freeze({
 	...PRIVATE_ENGINE_INFO,
-	superdocVersion: "2.20.0",
+	superdocVersion: "2.20.1-next.2",
 	roomSchemaVersion: Object.freeze({ ...PRIVATE_ENGINE_INFO.roomSchemaVersion }),
 	supportedBundleVersions: SUPPORTED_COLLABORATION_UPGRADE_BUNDLE_VERSIONS,
 	supportedV1ReaderContractVersions: SUPPORTED_V1_READER_CONTRACT_VERSIONS

package/dist/public/ui-react.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-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-DFCfYEpW.cjs");
 const require_slice_source = require("../chunks/slice-source-CFaqq0Vo.cjs");
 let react = require("react");
 //#region src/public/ui/react.ts

package/dist/public/ui-react.es.js

@@ -1,4 +1,4 @@
-import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-D5VrP4Dx.es.js";
+import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-B4_V1haj.es.js";
 import { t as toSliceSource } from "../chunks/slice-source-gfOhG2MW.es.js";
 import { createContext, createElement, useCallback, useContext, useEffect, useRef, useState } from "react";
 //#region src/public/ui/react.ts

package/dist/public/ui-vue.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-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-DFCfYEpW.cjs");
 const require_slice_source = require("../chunks/slice-source-CFaqq0Vo.cjs");
 let superdoc_entry_vue = require("vue");
 //#region src/public/ui/vue.ts

package/dist/public/ui-vue.es.js

@@ -1,4 +1,4 @@
-import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-D5VrP4Dx.es.js";
+import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-B4_V1haj.es.js";
 import { t as toSliceSource } from "../chunks/slice-source-gfOhG2MW.es.js";
 import { computed, inject, onScopeDispose, provide, shallowRef, toRaw, toValue, watch } from "vue";
 //#region src/public/ui/vue.ts

package/dist/public/ui.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-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-DFCfYEpW.cjs");
 exports.BUILT_IN_COMMAND_IDS = require_create_super_doc_ui.BUILT_IN_COMMAND_IDS;
 exports.createSuperDocUI = require_create_super_doc_ui.createSuperDocUI;
 exports.shallowEqual = require_create_super_doc_ui.shallowEqual;

package/dist/public/ui.es.js

@@ -1,2 +1,2 @@
-import { a as BUILT_IN_COMMAND_IDS, t as createSuperDocUI, u as shallowEqual } from "../chunks/create-super-doc-ui-D5VrP4Dx.es.js";
+import { a as BUILT_IN_COMMAND_IDS, t as createSuperDocUI, u as shallowEqual } from "../chunks/create-super-doc-ui-B4_V1haj.es.js";
 export { BUILT_IN_COMMAND_IDS, createSuperDocUI, shallowEqual };

package/dist/style.css

@@ -2340,34 +2340,34 @@ img[data-v-c95b2073] {
   pointer-events: auto;
 }
 
-.superdoc[data-v-7bbf01da] {
+.superdoc[data-v-e476c448] {
   display: flex;
   position: relative;
 }
-.right-sidebar[data-v-7bbf01da] {
+.right-sidebar[data-v-e476c448] {
   min-width: 320px;
   height: 100%;
 }
-.floating-comments[data-v-7bbf01da] {
+.floating-comments[data-v-e476c448] {
   min-width: 300px;
   width: 300px;
   height: 100%;
   overflow: visible;
 }
-.superdoc__layers[data-v-7bbf01da] {
+.superdoc__layers[data-v-e476c448] {
   height: 100%;
   position: relative;
   box-sizing: border-box;
 }
-.superdoc__document[data-v-7bbf01da] {
+.superdoc__document[data-v-e476c448] {
   width: 100%;
   position: relative;
 }
-.superdoc__sub-document[data-v-7bbf01da] {
+.superdoc__sub-document[data-v-e476c448] {
   width: 100%;
   position: relative;
 }
-.superdoc__selection-layer[data-v-7bbf01da] {
+.superdoc__selection-layer[data-v-e476c448] {
   position: absolute;
   min-width: 100%;
   min-height: 100%;
@@ -2378,13 +2378,13 @@ img[data-v-c95b2073] {
 /* SD-3497: PDF whiteboard overlay sits above the rendered PDF canvas but below
    the PDF comment anchors (z-index 6 in PdfCommentsLayer) so anchors stay
    clickable, and below the selection layer (z-index 10). */
-.superdoc__whiteboard-layer[data-v-7bbf01da] {
+.superdoc__whiteboard-layer[data-v-e476c448] {
   z-index: 4;
 }
-.superdoc__temp-selection[data-v-7bbf01da] {
+.superdoc__temp-selection[data-v-e476c448] {
   position: absolute;
 }
-.superdoc__right-sidebar[data-v-7bbf01da] {
+.superdoc__right-sidebar[data-v-e476c448] {
   width: 320px;
   min-width: 320px;
   padding: 0 10px;
@@ -2392,7 +2392,7 @@ img[data-v-c95b2073] {
   position: relative;
   z-index: 2;
 }
-.superdoc__compact-comment-popover[data-v-7bbf01da] {
+.superdoc__compact-comment-popover[data-v-e476c448] {
   position: absolute;
   top: 12px;
   right: 12px;
@@ -2401,14 +2401,14 @@ img[data-v-c95b2073] {
 }
 
 /* Tools styles */
-.tools[data-v-7bbf01da] {
+.tools[data-v-e476c448] {
   position: absolute;
   z-index: 3;
   display: flex;
   flex-direction: column;
   gap: var(--sd-ui-tools-gap, 6px);
 }
-.tools-item[data-v-7bbf01da] {
+.tools-item[data-v-e476c448] {
   display: flex;
   align-items: center;
   justify-content: center;
@@ -2419,10 +2419,10 @@ img[data-v-c95b2073] {
   cursor: pointer;
   position: relative;
 }
-.tools-item i[data-v-7bbf01da] {
+.tools-item i[data-v-e476c448] {
   cursor: pointer;
 }
-.superdoc__tools-icon[data-v-7bbf01da] {
+.superdoc__tools-icon[data-v-e476c448] {
   width: var(--sd-ui-tools-icon-size, 20px);
   height: var(--sd-ui-tools-icon-size, 20px);
   flex-shrink: 0;
@@ -2437,22 +2437,22 @@ img[data-v-c95b2073] {
 
 /* 834px is iPad screen size in portrait orientation */
 @media (max-width: 834px) {
-.superdoc .superdoc__layers[data-v-7bbf01da] {
+.superdoc .superdoc__layers[data-v-e476c448] {
     margin: 0;
     border: 0 !important;
     box-shadow: none;
 }
-.superdoc__sub-document[data-v-7bbf01da] {
+.superdoc__sub-document[data-v-e476c448] {
     max-width: 100%;
 }
-.superdoc__right-sidebar[data-v-7bbf01da] {
+.superdoc__right-sidebar[data-v-e476c448] {
     padding: 10px;
     position: relative;
 }
 }
 
 /* AI Writer styles */
-.ai-writer-container[data-v-7bbf01da] {
+.ai-writer-container[data-v-e476c448] {
   position: fixed;
   z-index: 1000;
   background: white;
@@ -2468,10 +2468,10 @@ img[data-v-c95b2073] {
   transform: translateY(-50%);
   z-index: 50;
 } */
-.ai-tool > svg[data-v-7bbf01da] {
+.ai-tool > svg[data-v-e476c448] {
   fill: transparent;
 }
-.ai-tool[data-v-7bbf01da]::before {
+.ai-tool[data-v-e476c448]::before {
   content: '';
   position: absolute;
   width: 20px;
@@ -2492,7 +2492,7 @@ img[data-v-c95b2073] {
   filter: brightness(1.2);
   transition: filter 0.2s ease;
 }
-.ai-tool[data-v-7bbf01da]:hover::before {
+.ai-tool[data-v-e476c448]:hover::before {
   filter: brightness(1.3);
 }
 
@@ -3022,7 +3022,7 @@ img[data-v-c95b2073] {
   display: flex;
 }
 
-.superdoc-toolbar[data-v-9418cc7d] {
+.superdoc-toolbar[data-v-0d00bc5b] {
   display: flex;
   width: 100%;
   justify-content: space-between;
@@ -3034,7 +3034,7 @@ img[data-v-c95b2073] {
   z-index: var(--sd-ui-toolbar-z-index, 10);
 }
 @media (max-width: 768px) {
-.superdoc-toolbar[data-v-9418cc7d] {
+.superdoc-toolbar[data-v-0d00bc5b] {
     padding: 4px 10px;
     justify-content: inherit;
 }

package/dist/style.layered.css

@@ -2340,34 +2340,34 @@ img[data-v-c95b2073] {
   pointer-events: auto;
 }
 
-.superdoc[data-v-7bbf01da] {
+.superdoc[data-v-e476c448] {
   display: flex;
   position: relative;
 }
-.right-sidebar[data-v-7bbf01da] {
+.right-sidebar[data-v-e476c448] {
   min-width: 320px;
   height: 100%;
 }
-.floating-comments[data-v-7bbf01da] {
+.floating-comments[data-v-e476c448] {
   min-width: 300px;
   width: 300px;
   height: 100%;
   overflow: visible;
 }
-.superdoc__layers[data-v-7bbf01da] {
+.superdoc__layers[data-v-e476c448] {
   height: 100%;
   position: relative;
   box-sizing: border-box;
 }
-.superdoc__document[data-v-7bbf01da] {
+.superdoc__document[data-v-e476c448] {
   width: 100%;
   position: relative;
 }
-.superdoc__sub-document[data-v-7bbf01da] {
+.superdoc__sub-document[data-v-e476c448] {
   width: 100%;
   position: relative;
 }
-.superdoc__selection-layer[data-v-7bbf01da] {
+.superdoc__selection-layer[data-v-e476c448] {
   position: absolute;
   min-width: 100%;
   min-height: 100%;
@@ -2378,13 +2378,13 @@ img[data-v-c95b2073] {
 /* SD-3497: PDF whiteboard overlay sits above the rendered PDF canvas but below
    the PDF comment anchors (z-index 6 in PdfCommentsLayer) so anchors stay
    clickable, and below the selection layer (z-index 10). */
-.superdoc__whiteboard-layer[data-v-7bbf01da] {
+.superdoc__whiteboard-layer[data-v-e476c448] {
   z-index: 4;
 }
-.superdoc__temp-selection[data-v-7bbf01da] {
+.superdoc__temp-selection[data-v-e476c448] {
   position: absolute;
 }
-.superdoc__right-sidebar[data-v-7bbf01da] {
+.superdoc__right-sidebar[data-v-e476c448] {
   width: 320px;
   min-width: 320px;
   padding: 0 10px;
@@ -2392,7 +2392,7 @@ img[data-v-c95b2073] {
   position: relative;
   z-index: 2;
 }
-.superdoc__compact-comment-popover[data-v-7bbf01da] {
+.superdoc__compact-comment-popover[data-v-e476c448] {
   position: absolute;
   top: 12px;
   right: 12px;
@@ -2401,14 +2401,14 @@ img[data-v-c95b2073] {
 }
 
 /* Tools styles */
-.tools[data-v-7bbf01da] {
+.tools[data-v-e476c448] {
   position: absolute;
   z-index: 3;
   display: flex;
   flex-direction: column;
   gap: var(--sd-ui-tools-gap, 6px);
 }
-.tools-item[data-v-7bbf01da] {
+.tools-item[data-v-e476c448] {
   display: flex;
   align-items: center;
   justify-content: center;
@@ -2419,10 +2419,10 @@ img[data-v-c95b2073] {
   cursor: pointer;
   position: relative;
 }
-.tools-item i[data-v-7bbf01da] {
+.tools-item i[data-v-e476c448] {
   cursor: pointer;
 }
-.superdoc__tools-icon[data-v-7bbf01da] {
+.superdoc__tools-icon[data-v-e476c448] {
   width: var(--sd-ui-tools-icon-size, 20px);
   height: var(--sd-ui-tools-icon-size, 20px);
   flex-shrink: 0;
@@ -2437,22 +2437,22 @@ img[data-v-c95b2073] {
 
 /* 834px is iPad screen size in portrait orientation */
 @media (max-width: 834px) {
-.superdoc .superdoc__layers[data-v-7bbf01da] {
+.superdoc .superdoc__layers[data-v-e476c448] {
     margin: 0;
     border: 0 !important;
     box-shadow: none;
 }
-.superdoc__sub-document[data-v-7bbf01da] {
+.superdoc__sub-document[data-v-e476c448] {
     max-width: 100%;
 }
-.superdoc__right-sidebar[data-v-7bbf01da] {
+.superdoc__right-sidebar[data-v-e476c448] {
     padding: 10px;
     position: relative;
 }
 }
 
 /* AI Writer styles */
-.ai-writer-container[data-v-7bbf01da] {
+.ai-writer-container[data-v-e476c448] {
   position: fixed;
   z-index: 1000;
   background: white;
@@ -2468,10 +2468,10 @@ img[data-v-c95b2073] {
   transform: translateY(-50%);
   z-index: 50;
 } */
-.ai-tool > svg[data-v-7bbf01da] {
+.ai-tool > svg[data-v-e476c448] {
   fill: transparent;
 }
-.ai-tool[data-v-7bbf01da]::before {
+.ai-tool[data-v-e476c448]::before {
   content: '';
   position: absolute;
   width: 20px;
@@ -2492,7 +2492,7 @@ img[data-v-c95b2073] {
   filter: brightness(1.2);
   transition: filter 0.2s ease;
 }
-.ai-tool[data-v-7bbf01da]:hover::before {
+.ai-tool[data-v-e476c448]:hover::before {
   filter: brightness(1.3);
 }
 
@@ -3022,7 +3022,7 @@ img[data-v-c95b2073] {
   display: flex;
 }
 
-.superdoc-toolbar[data-v-9418cc7d] {
+.superdoc-toolbar[data-v-0d00bc5b] {
   display: flex;
   width: 100%;
   justify-content: space-between;
@@ -3034,7 +3034,7 @@ img[data-v-c95b2073] {
   z-index: var(--sd-ui-toolbar-z-index, 10);
 }
 @media (max-width: 768px) {
-.superdoc-toolbar[data-v-9418cc7d] {
+.superdoc-toolbar[data-v-0d00bc5b] {
     padding: 4px 10px;
     justify-content: inherit;
 }

package/dist/superdoc/src/core/types/index.d.ts

@@ -3694,16 +3694,18 @@ export interface ToolbarConfig {
      * syntax resolves to nothing.
      */
     container?: string | HTMLElement;
-    /** Built-in controls to render by region. Controls keep their built-in order. Omit to use the default toolbar. */
+    /** Built-in controls to render by region. Each region's controls render in the array order given. Omit to use the default toolbar. */
     items?: Readonly<Partial<Record<ToolbarRegion, readonly ToolbarItemId[]>>>;
     /**
      * Which groups render, or which items they contain.
      *
      * An array selects groups. The built-in layout still places them in its
      * left, center, and right regions, and always renders the center region.
+     * Item order within each region stays the built-in order for this shape.
      *
      * An object maps each group to its toolbar item ids. Its keys choose the
-     * regions and its values form a grouped allowlist.
+     * regions; its values form both the group's composition and the render
+     * order of items within that region.
      * @deprecated replaceWith=`ui.toolbar.items` removeIn=v3.0
      */
     groups?: readonly string[] | Readonly<Record<string, readonly string[]>>;

package/dist/superdoc/src/internal/toolbar/built-in/default-items.d.ts

@@ -9,7 +9,7 @@
  * callers share this one rule so the two cannot drift apart.
  */
 export function withLinkHref(attributes: any, href: any): any;
-export function makeDefaultItems({ superToolbar, toolbarIcons, toolbarTexts, toolbarFonts, hideButtons, availableWidth, role, isDev, configuredItemNames, excludedItemNames, additionalItems, }?: {
+export function makeDefaultItems({ superToolbar, toolbarIcons, toolbarTexts, toolbarFonts, hideButtons, availableWidth, role, isDev, configuredItemNames, configuredItemOrder, excludedItemNames, additionalItems, }?: {
     isDev?: boolean | undefined;
     additionalItems?: never[] | undefined;
 }): {

package/dist/superdoc/src/internal/toolbar/built-in-toolbar.d.ts

@@ -166,6 +166,7 @@ export class BuiltInToolbar extends EventEmitter<string | symbol, any> {
         responsiveToContainer: boolean;
         mode: string;
         excludeItems: never[];
+        toolbarButtonsExclude: never[];
         groups: null;
         customButtons: never[];
         showFormattingMarksButton: boolean;