superdoc 2.0.0-next.33 → 2.0.0-next.34

package/dist/collaboration-upgrade-engine.cjs

@@ -7,7 +7,7 @@ const 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.0.0-next.33",
+	superdocVersion: "2.0.0-next.34",
 	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

@@ -6,7 +6,7 @@ const COLLABORATION_UPGRADE_ENGINE_MINIMUM_NODE_MAJOR = 20;
 var PRIVATE_ENGINE_INFO = getCollaborationUpgradeEngineInfo$1();
 var ENGINE_INFO = Object.freeze({
 	...PRIVATE_ENGINE_INFO,
-	superdocVersion: "2.0.0-next.33",
+	superdocVersion: "2.0.0-next.34",
 	roomSchemaVersion: Object.freeze({ ...PRIVATE_ENGINE_INFO.roomSchemaVersion }),
 	supportedBundleVersions: SUPPORTED_COLLABORATION_UPGRADE_BUNDLE_VERSIONS,
 	supportedV1ReaderContractVersions: SUPPORTED_V1_READER_CONTRACT_VERSIONS

package/dist/document-api/src/types/blocks.types.d.ts

@@ -182,4 +182,9 @@ export interface BlocksDeleteRangeResult {
         after: string;
     };
     dryRun: boolean;
+    trackedChangeRefs?: ReceiptInsert[];
+    invalidatedRefs?: AffectedRef[];
+    affectedStories?: StoryLocator[];
+    textRangeShifts?: TextRangeShift[];
+    txId?: string;
 }

package/dist/public/ui-react.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_rolldown_runtime = require("../chunks/rolldown-runtime-_dR15c8t.cjs");
-const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-C0ZJE05U.cjs");
+const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-DLyJzmj9.cjs");
 let react = require("react");
 var SuperDocUIContext = (0, react.createContext)(null);
 function SuperDocUIProvider(props) {

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

@@ -1,4 +1,4 @@
-import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-C01vcKRO.es.js";
+import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-C_kKiKQ4.es.js";
 import { createContext, createElement, useCallback, useContext, useEffect, useRef, useState } from "react";
 var SuperDocUIContext = createContext(null);
 function SuperDocUIProvider(props) {

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-C0ZJE05U.cjs");
+const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-DLyJzmj9.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 { n as BUILT_IN_COMMAND_IDS, r as shallowEqual, t as createSuperDocUI } from "../chunks/create-super-doc-ui-C01vcKRO.es.js";
+import { n as BUILT_IN_COMMAND_IDS, r as shallowEqual, t as createSuperDocUI } from "../chunks/create-super-doc-ui-C_kKiKQ4.es.js";
 export { BUILT_IN_COMMAND_IDS, createSuperDocUI, shallowEqual };

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

@@ -1 +1 @@
-export function refocusEditorSurface(superToolbar: any): void;
+export function refocusEditorSurface(superToolbar: any, preferredEditor?: null): void;

package/dist/superdoc.cjs

@@ -6,7 +6,7 @@ const require_uuid = require("./chunks/uuid-CFp0WGVU.cjs");
 const require_jszip = require("./chunks/jszip-BdUBlUeG.cjs");
 const require__plugin_vue_export_helper = require("./chunks/_plugin-vue_export-helper-BTwbGDKw.cjs");
 const require_constants = require("./chunks/constants-sbCZ2O_A.cjs");
-const require_create_super_doc_ui = require("./chunks/create-super-doc-ui-C0ZJE05U.cjs");
+const require_create_super_doc_ui = require("./chunks/create-super-doc-ui-DLyJzmj9.cjs");
 let vue = require("vue");
 vue = require_rolldown_runtime.__toESM(vue);
 require("y-websocket");
@@ -1845,6 +1845,7 @@ function useComment(params) {
 	const trackedChangeStoryLabel = (0, vue.ref)(params.trackedChangeStoryLabel || "");
 	const trackedChangeAnchorKey = (0, vue.ref)(params.trackedChangeAnchorKey || null);
 	const trackedChangeCanonicalId = (0, vue.ref)(params.trackedChangeCanonicalId || null);
+	const trackedChangePositionAliases = (0, vue.ref)(params.trackedChangePositionAliases || []);
 	const deletedText = (0, vue.ref)(params.deletedText || null);
 	const trackedChangeLabel = (0, vue.ref)(params.trackedChangeLabel || null);
 	const trackedChangeDetailLines = (0, vue.ref)(params.trackedChangeDetailLines || null);
@@ -2014,6 +2015,7 @@ function useComment(params) {
 			trackedChangeStoryLabel: trackedChangeStoryLabel.value,
 			trackedChangeAnchorKey: trackedChangeAnchorKey.value,
 			trackedChangeCanonicalId: trackedChangeCanonicalId.value,
+			trackedChangePositionAliases: trackedChangePositionAliases.value,
 			trackedChangeDecision: trackedChangeDecision.value,
 			trackedChangeLabel: trackedChangeLabel.value,
 			trackedChangeDetailLines: trackedChangeDetailLines.value,
@@ -2063,6 +2065,7 @@ function useComment(params) {
 		trackedChangeStoryLabel,
 		trackedChangeAnchorKey,
 		trackedChangeCanonicalId,
+		trackedChangePositionAliases,
 		trackedChangeDecision,
 		trackedChangeLabel,
 		trackedChangeDetailLines,
@@ -2516,6 +2519,11 @@ var toFinitePageIndex = (value) => {
 var buildPageScopedInstanceId = (positionKey, pageIndex) => {
 	return `${positionKey}::page:${pageIndex}`;
 };
+var matchesTrackedChangePositionAlias = (positionKey, alias) => {
+	const normalizedPositionKey = String(positionKey);
+	const normalizedAlias = String(alias);
+	return normalizedPositionKey === normalizedAlias || normalizedPositionKey.startsWith("tc::") && normalizedPositionKey.endsWith(`::${normalizedAlias}`);
+};
 var aggregateRectBounds = (rects) => {
 	if (!Array.isArray(rects) || rects.length === 0) return null;
 	let left = Number.POSITIVE_INFINITY;
@@ -2622,7 +2630,9 @@ var buildRepeatedHeaderFooterInstances = ({ comment, positionKey, positionEntry,
 	});
 };
 const buildFloatingCommentInstances = ({ comment, positionKey, positionEntry, fallbackId }) => {
-	const instanceId = comment?.trackedChange && comment?.trackedChangeCanonicalId && positionKey && fallbackId && String(positionKey) !== String(fallbackId) ? fallbackId : positionKey ?? fallbackId;
+	const hasTrackedChangePositionAlias = comment?.trackedChange && positionKey && fallbackId && Array.isArray(comment?.trackedChangePositionAliases) && comment.trackedChangePositionAliases.some((alias) => matchesTrackedChangePositionAlias(positionKey, alias));
+	const hasSharedTrackedChangeAnchor = comment?.trackedChange && comment?.trackedChangeCanonicalId && positionKey && fallbackId && String(positionKey) !== String(fallbackId);
+	const instanceId = hasTrackedChangePositionAlias || hasSharedTrackedChangeAnchor ? fallbackId : positionKey ?? fallbackId;
 	if (!instanceId) return [];
 	if (isRepeatedHeaderFooterTrackedChange(comment, positionEntry) && positionKey) {
 		const repeatedInstances = buildRepeatedHeaderFooterInstances({
@@ -3104,6 +3114,37 @@ const useCommentsStore = defineStore("comments", () => {
 		if (config.comments && config.comments.length) commentsList.value = config.comments?.map((c) => useComment(c)) || [];
 	};
 	const normalizeCommentId = (id) => id === void 0 || id === null ? null : String(id);
+	const normalizeTrackedChangePositionAliases = (aliases) => {
+		if (!Array.isArray(aliases)) return [];
+		return [...new Set(aliases.map((id) => normalizeCommentId(id)).filter(Boolean))];
+	};
+	const getTrackedChangeStoryKey = (comment) => {
+		if (!comment?.trackedChange) return null;
+		const anchorKey = normalizeCommentId(comment.trackedChangeAnchorKey);
+		if (anchorKey?.startsWith("tc::")) {
+			const separatorIndex = anchorKey.indexOf("::", 4);
+			if (separatorIndex > 4) return anchorKey.slice(4, separatorIndex);
+		}
+		const story = comment.trackedChangeStory;
+		switch (story?.storyType) {
+			case "body": return "body";
+			case "headerFooterPart": return story.refId ? `hf:${story.refId}` : null;
+			case "footnote": return story.noteId ? `fn:${story.noteId}` : null;
+			case "endnote": return story.noteId ? `en:${story.noteId}` : null;
+			case "textbox": return story.textboxId ? `textbox:${story.textboxId}` : null;
+			default: return null;
+		}
+	};
+	const normalizeTrackedChangeStoryKey = (storyKey) => {
+		if (storyKey?.startsWith("hf:part:")) return `hf:${storyKey.slice(8)}`;
+		if (storyKey?.startsWith("headerFooterPart:")) return `hf:${storyKey.slice(17)}`;
+		return storyKey;
+	};
+	const positionEntryMatchesTrackedChangeStory = (entry, comment) => {
+		const expectedStoryKey = normalizeTrackedChangeStoryKey(getTrackedChangeStoryKey(comment));
+		const entryStoryKey = normalizeTrackedChangeStoryKey(normalizeCommentId(entry?.storyKey));
+		return !expectedStoryKey || !entryStoryKey || entryStoryKey === expectedStoryKey;
+	};
 	const buildTrackedChangeImportedPositionId = (id) => {
 		const normalizedId = normalizeCommentId(id);
 		if (!normalizedId) return null;
@@ -3227,6 +3268,8 @@ const useCommentsStore = defineStore("comments", () => {
 		if (commentOrId === void 0 || commentOrId === null) return [];
 		const rawId = typeof commentOrId === "object" ? null : commentOrId;
 		const comment = typeof commentOrId === "object" ? commentOrId : getComment(commentOrId);
+		const trackedChangePositionAliases = comment?.trackedChange ? normalizeTrackedChangePositionAliases(comment?.trackedChangePositionAliases) : [];
+		const trackedChangeStoryKey = normalizeTrackedChangeStoryKey(getTrackedChangeStoryKey(comment));
 		const seen = /* @__PURE__ */ new Set();
 		return [
 			rawId,
@@ -3234,7 +3277,11 @@ const useCommentsStore = defineStore("comments", () => {
 			comment?.trackedChangeAnchorKey,
 			comment?.commentId,
 			comment?.importedId,
-			comment?.trackedChange ? buildTrackedChangeImportedPositionId(comment?.importedId) : null
+			comment?.trackedChange ? buildTrackedChangeImportedPositionId(comment?.importedId) : null,
+			...trackedChangePositionAliases.flatMap((id) => [trackedChangeStoryKey && !id.startsWith("tc::") ? makeTrackedChangeAnchorKey({
+				storyKey: trackedChangeStoryKey,
+				rawId: id
+			}) : null, id])
 		].map((id) => normalizeCommentId(id)).filter((id) => {
 			if (!id || seen.has(id)) return false;
 			seen.add(id);
@@ -3243,12 +3290,13 @@ const useCommentsStore = defineStore("comments", () => {
 	};
 	const resolveCommentPositionEntry = (commentOrId, preferredId) => {
 		const currentPositions = editorCommentPositions.value || {};
+		const comment = typeof commentOrId === "object" ? commentOrId : getComment(commentOrId);
 		const seen = /* @__PURE__ */ new Set();
 		for (const key of [preferredId, ...getCommentAliasIds(commentOrId)].map((id) => normalizeCommentId(id)).filter(Boolean)) {
 			if (seen.has(key)) continue;
 			seen.add(key);
 			const entry = currentPositions[key];
-			if (entry !== void 0) return {
+			if (entry !== void 0 && positionEntryMatchesTrackedChangeStory(entry, comment)) return {
 				key,
 				entry
 			};
@@ -3487,9 +3535,11 @@ const useCommentsStore = defineStore("comments", () => {
 			documentId: params?.documentId ?? null
 		});
 		try {
-			const { event, changeId, trackedChangeText, trackedChangeType, trackedChangeDisplayType, semanticColorKey, semanticColor, deletedText, trackedChangeLabel, trackedChangeDetailLines, trackedChangeImagePreview, authorId, authorEmail, authorImage, date, author: authorName, importedAuthor, documentId, coords, trackedChangeStory, trackedChangeStoryKind, trackedChangeStoryLabel, trackedChangeAnchorKey, trackedChangeCanonicalId, importedId } = params;
+			const { event, changeId, trackedChangeText, trackedChangeType, trackedChangeDisplayType, semanticColorKey, semanticColor, deletedText, trackedChangeLabel, trackedChangeDetailLines, trackedChangeImagePreview, authorId, authorEmail, authorImage, date, author: authorName, importedAuthor, documentId, coords, trackedChangeStory, trackedChangeStoryKind, trackedChangeStoryLabel, trackedChangeAnchorKey, trackedChangeCanonicalId, trackedChangePositionAliases, importedId } = params;
 			const normalizedChangeId = changeId != null ? String(changeId) : null;
 			const normalizedTrackedChangeCanonicalId = trackedChangeCanonicalId != null ? String(trackedChangeCanonicalId) : null;
+			const hasTrackedChangePositionAliases = Object.prototype.hasOwnProperty.call(params, "trackedChangePositionAliases");
+			const normalizedTrackedChangePositionAliases = hasTrackedChangePositionAliases ? normalizeTrackedChangePositionAliases(trackedChangePositionAliases) : void 0;
 			const hasImportedId = Object.prototype.hasOwnProperty.call(params, "importedId");
 			const normalizedImportedId = hasImportedId ? importedId != null ? String(importedId) : null : void 0;
 			const normalizedDocumentId = documentId != null ? String(documentId) : null;
@@ -3547,6 +3597,7 @@ const useCommentsStore = defineStore("comments", () => {
 				trackedChangeStoryLabel: normalizedTrackedChangeStoryLabel,
 				trackedChangeAnchorKey: normalizedTrackedChangeAnchorKey,
 				trackedChangeCanonicalId: normalizedTrackedChangeCanonicalId,
+				...hasTrackedChangePositionAliases ? { trackedChangePositionAliases: normalizedTrackedChangePositionAliases } : {},
 				selection: {
 					source: DOCUMENT_EDITOR_SELECTION_SOURCE,
 					selectionBounds: coords
@@ -3607,6 +3658,7 @@ const useCommentsStore = defineStore("comments", () => {
 					createdTime: date ?? null
 				};
 				if (hasImportedId) fields.importedId = normalizedImportedId;
+				if (hasTrackedChangePositionAliases) fields.trackedChangePositionAliases = normalizedTrackedChangePositionAliases;
 				let didChange = false;
 				for (const [key, value] of Object.entries(fields)) didChange = setIfChanged(target, key, value) || didChange;
 				if (target && !(target.trackedChangeDetailLines == null && normalizedTrackedChangeDetailLines == null) && !trackedChangeDetailLinesEqual(target.trackedChangeDetailLines, normalizedTrackedChangeDetailLines)) {
@@ -9713,304 +9765,6 @@ var _sfc_main$27 = {
 	}
 };
 var WhiteboardLayer_default = /* @__PURE__ */ require__plugin_vue_export_helper.__plugin_vue_export_helper_default(_sfc_main$27, [["__scopeId", "data-v-54546c3d"]]);
-var FALLBACK_PALETTE = [
-	"#1f6feb",
-	"#d1242f",
-	"#8250df",
-	"#bf3989",
-	"#1a7f37",
-	"#9a6700",
-	"#bc4c00",
-	"#0969da",
-	"#cf222e",
-	"#6639ba",
-	"#116329",
-	"#7d4e00"
-];
-const authorIdentityKey = (author) => {
-	if (!author) return "";
-	return `${typeof author.name === "string" ? author.name : ""} ${typeof author.email === "string" ? author.email : ""}`;
-};
-var hashString = (value) => {
-	let hash = 2166136261;
-	for (let i = 0; i < value.length; i += 1) {
-		hash ^= value.charCodeAt(i);
-		hash = Math.imul(hash, 16777619);
-	}
-	return hash >>> 0;
-};
-const fallbackAuthorColor = (author) => {
-	return FALLBACK_PALETTE[hashString(authorIdentityKey(author)) % FALLBACK_PALETTE.length];
-};
-var isNonEmptyString = (value) => typeof value === "string" && value.length > 0;
-const composeAuthorColorResolver = (config) => {
-	if (!config || config.enabled === false) return void 0;
-	const overrides = config.overrides && typeof config.overrides === "object" ? config.overrides : void 0;
-	const resolve = typeof config.resolve === "function" ? config.resolve : void 0;
-	return (author) => {
-		const safeAuthor = author ?? {};
-		if (overrides) {
-			if (isNonEmptyString(safeAuthor.email) && isNonEmptyString(overrides[safeAuthor.email])) return overrides[safeAuthor.email];
-			if (isNonEmptyString(safeAuthor.name) && isNonEmptyString(overrides[safeAuthor.name])) return overrides[safeAuthor.name];
-		}
-		if (resolve) try {
-			const resolved = resolve(safeAuthor);
-			if (isNonEmptyString(resolved)) return resolved;
-		} catch {}
-		return fallbackAuthorColor(safeAuthor);
-	};
-};
-const TRACKED_CHANGE_CONFIGURABLE_SEMANTIC_COLOR_KEYS = [
-	"insertion",
-	"deletion",
-	"move",
-	"move-from",
-	"move-to",
-	"table-cell-insertion",
-	"table-cell-deletion",
-	"cell-merge",
-	"cell-split",
-	"image-insertion",
-	"image-deletion",
-	"image-property-change"
-];
-var CONFIGURABLE_SEMANTIC_COLOR_KEY_SET = new Set(TRACKED_CHANGE_CONFIGURABLE_SEMANTIC_COLOR_KEYS);
-const DRAWING_DIAGNOSTIC_CODES = {
-	externalImageDeferred: "render.media.external-image-deferred",
-	missingRelationship: "render.drawing.missing-relationship",
-	missingMediaPart: "render.media.missing-part",
-	unsupportedRelationshipType: "render.drawing.unsupported-relationship-type",
-	unsupportedMime: "render.media.unsupported-mime",
-	imageTooLarge: "render.media.image-too-large",
-	unsafeSvg: "render.media.unsafe-svg",
-	unsupportedFormat: "render.media.unsupported-format",
-	embeddedObjectNotSupported: "render.embedded-object-not-supported",
-	unsupportedObject: "render.drawing.unsupported-object",
-	vmlUnsupported: "render.drawing.vml-unsupported",
-	vmlImageUnsupported: "render.drawing.vml-image-unsupported",
-	unsupportedGeometryCommand: "render.drawing.unsupported-geometry-command",
-	anchorUnsupported: "render.drawing.anchor-unsupported",
-	wrapUnsupported: "render.drawing.wrap-unsupported",
-	altContentNoSupportedChoice: "render.drawing.altcontent-no-supported-choice",
-	groupChildUnsupported: "render.drawing.group-child-unsupported"
-};
-const DRAWING_DIAGNOSTIC_CODE_ALIASES = {
-	"render.media.missing-relationship": DRAWING_DIAGNOSTIC_CODES.missingRelationship,
-	"render.media.wrong-relationship-type": DRAWING_DIAGNOSTIC_CODES.unsupportedRelationshipType,
-	"render.media.unsupported-target": DRAWING_DIAGNOSTIC_CODES.unsupportedRelationshipType,
-	"render.media.invalid-image-size": DRAWING_DIAGNOSTIC_CODES.imageTooLarge,
-	"render.media-resolver-unavailable": DRAWING_DIAGNOSTIC_CODES.missingMediaPart,
-	"render.chart-not-supported": DRAWING_DIAGNOSTIC_CODES.unsupportedObject,
-	"render.textbox.vml-unsupported": DRAWING_DIAGNOSTIC_CODES.vmlUnsupported
-};
-const DRAWING_SUPPORT_TAXONOMY = {
-	inlineBitmap: {
-		family: "inlineBitmap",
-		support: "supported",
-		description: "wp:inline pic:pic with internal media and browser-safe MIME (PNG/JPEG; WebP/SVG once the host media resolver lands).",
-		contract: "ImageRun"
-	},
-	anchoredBitmap: {
-		family: "anchoredBitmap",
-		support: "supported",
-		description: "wp:anchor bitmap with anchor/wrap expressible by ImageAnchor/ImageWrap. Never silently inlined.",
-		contract: "ImageBlock"
-	},
-	imageChildInGroup: {
-		family: "imageChildInGroup",
-		support: "supported",
-		description: "Bitmap child of a supported DrawingML group/drawing wrapper. Supported only when the parent is.",
-		contract: "ImageDrawing"
-	},
-	vectorShape: {
-		family: "vectorShape",
-		support: "supported",
-		description: "Block/floating DrawingML preset/custom shape with the supported geometry/style subset.",
-		contract: "DrawingBlock",
-		drawingKind: "vectorShape"
-	},
-	shapeGroup: {
-		family: "shapeGroup",
-		support: "supported",
-		description: "DrawingML group whose rendered children are supported vector/image children.",
-		contract: "DrawingBlock",
-		drawingKind: "shapeGroup"
-	},
-	chart: {
-		family: "chart",
-		support: "supported",
-		description: "DrawingML chart projected into a ChartDrawing with parsed cached chart XML data. Complete Word chart fidelity remains deferred to chartFidelity.",
-		contract: "DrawingBlock",
-		drawingKind: "chart"
-	},
-	alternateContent: {
-		family: "alternateContent",
-		support: "supported",
-		description: "mc:AlternateContent traversal/select policy. Selected Choice/Fallback maps to its family contract; unselected branches preserved for save/reopen.",
-		contract: "selected-choice"
-	},
-	externalImage: {
-		family: "externalImage",
-		support: "fail-closed",
-		description: "External image relationship (r:link / TargetMode=\"External\"). Not fetched.",
-		contract: "none",
-		diagnostic: DRAWING_DIAGNOSTIC_CODES.externalImageDeferred
-	},
-	missingRelationship: {
-		family: "missingRelationship",
-		support: "fail-closed",
-		description: "Drawing references a relationship id absent from the owner part .rels.",
-		contract: "none",
-		diagnostic: DRAWING_DIAGNOSTIC_CODES.missingRelationship
-	},
-	missingMediaPart: {
-		family: "missingMediaPart",
-		support: "fail-closed",
-		description: "Relationship resolves but the target media part bytes are missing or empty.",
-		contract: "none",
-		diagnostic: DRAWING_DIAGNOSTIC_CODES.missingMediaPart
-	},
-	wrongRelationshipType: {
-		family: "wrongRelationshipType",
-		support: "fail-closed",
-		description: "Relationship exists but is not an image relationship type.",
-		contract: "none",
-		diagnostic: DRAWING_DIAGNOSTIC_CODES.unsupportedRelationshipType
-	},
-	unsupportedMime: {
-		family: "unsupportedMime",
-		support: "fail-closed",
-		description: "Media MIME outside the supported allowlist (incl. GIF/BMP/ICO).",
-		contract: "none",
-		diagnostic: DRAWING_DIAGNOSTIC_CODES.unsupportedMime
-	},
-	oversizedMediaPart: {
-		family: "oversizedMediaPart",
-		support: "fail-closed",
-		description: "Media part exceeds the host byte-size policy before bytes are materialized.",
-		contract: "none",
-		diagnostic: DRAWING_DIAGNOSTIC_CODES.imageTooLarge
-	},
-	unsafeSvg: {
-		family: "unsafeSvg",
-		support: "fail-closed",
-		description: "SVG content rejected by the SVG safety policy.",
-		contract: "none",
-		diagnostic: DRAWING_DIAGNOSTIC_CODES.unsafeSvg
-	},
-	metafileOrTiff: {
-		family: "metafileOrTiff",
-		support: "fail-closed",
-		description: "EMF/WMF/TIFF and other non-browser-native formats with no approved conversion path.",
-		contract: "none",
-		diagnostic: DRAWING_DIAGNOSTIC_CODES.unsupportedFormat
-	},
-	embeddedObject: {
-		family: "embeddedObject",
-		support: "fail-closed",
-		description: "OLE / ActiveX / embedded package object.",
-		contract: "none",
-		diagnostic: DRAWING_DIAGNOSTIC_CODES.embeddedObjectNotSupported
-	},
-	smartArtOrDiagram: {
-		family: "smartArtOrDiagram",
-		support: "fail-closed",
-		description: "SmartArt / diagram / unknown external graphic-data object.",
-		contract: "none",
-		diagnostic: DRAWING_DIAGNOSTIC_CODES.unsupportedObject
-	},
-	vml: {
-		family: "vml",
-		support: "fail-closed",
-		description: "VML structure outside any supported image-like subset (default fail-closed policy).",
-		contract: "none",
-		diagnostic: DRAWING_DIAGNOSTIC_CODES.vmlUnsupported
-	},
-	vmlImageLike: {
-		family: "vmlImageLike",
-		support: "fail-closed",
-		description: "Simple VML image references (v:imagedata) / watermark image metadata. Fail-closed unless a later change promotes a named subset with deterministic fixtures and exact oracles.",
-		contract: "none",
-		diagnostic: DRAWING_DIAGNOSTIC_CODES.vmlImageUnsupported
-	},
-	unsupportedGeometryCommand: {
-		family: "unsupportedGeometryCommand",
-		support: "fail-closed",
-		description: "Custom geometry command the extractor does not implement, e.g. arcTo.",
-		contract: "none",
-		diagnostic: DRAWING_DIAGNOSTIC_CODES.unsupportedGeometryCommand
-	},
-	unsupportedAnchorFields: {
-		family: "unsupportedAnchorFields",
-		support: "fail-closed",
-		description: "Anchor fields required for honest placement are unsupported (char-relative, alignment modes, etc.).",
-		contract: "none",
-		diagnostic: DRAWING_DIAGNOSTIC_CODES.anchorUnsupported
-	},
-	unsupportedWrapFields: {
-		family: "unsupportedWrapFields",
-		support: "fail-closed",
-		description: "Wrap fields required for honest placement are unsupported (arbitrary wrap polygons, etc.).",
-		contract: "none",
-		diagnostic: DRAWING_DIAGNOSTIC_CODES.wrapUnsupported
-	},
-	alternateContentNoSupportedChoice: {
-		family: "alternateContentNoSupportedChoice",
-		support: "fail-closed",
-		description: "mc:AlternateContent with no supported choice and no usable fallback.",
-		contract: "none",
-		diagnostic: DRAWING_DIAGNOSTIC_CODES.altContentNoSupportedChoice
-	},
-	groupChildUnsupported: {
-		family: "groupChildUnsupported",
-		support: "fail-closed",
-		description: "Unsupported child inside an otherwise-supported group. Supported siblings are not dropped.",
-		contract: "none",
-		diagnostic: DRAWING_DIAGNOSTIC_CODES.groupChildUnsupported
-	},
-	objectEditing: {
-		family: "objectEditing",
-		support: "deferred",
-		description: "Editing/mutation of anchored/vector objects.",
-		contract: "none"
-	},
-	customWrapPolygon: {
-		family: "customWrapPolygon",
-		support: "deferred",
-		description: "Full Word-compatible text wrapping for arbitrary custom wrap polygons.",
-		contract: "none"
-	},
-	chartFidelity: {
-		family: "chartFidelity",
-		support: "deferred",
-		description: "Complete chart fidelity (a dedicated chart effort owns the parsed subset).",
-		contract: "none"
-	},
-	vmlFidelity: {
-		family: "vmlFidelity",
-		support: "deferred",
-		description: "Complete VML fidelity.",
-		contract: "none"
-	},
-	decorativeAccessibilityUi: {
-		family: "decorativeAccessibilityUi",
-		support: "deferred",
-		description: "Full accessibility UI for decorative image semantics beyond preserving source data.",
-		contract: "none"
-	}
-};
-const DRAWING_FAMILIES = Object.keys(DRAWING_SUPPORT_TAXONOMY);
-const PAGE_CHECKPOINT_DEPENDENCY_CLASSES = Object.freeze([
-	"multiple-sections",
-	"furniture-page-tokens",
-	"non-balanceable-multi-column-sections",
-	"body-anchored-objects",
-	"footnotes",
-	"page-references",
-	"keep-constraints",
-	"tables",
-	"furniture-anchored-objects"
-]);
 var _hoisted_1$20 = { class: "superdoc-html-viewer" };
 var _hoisted_2$17 = { class: "superdoc-html-viewer__document" };
 var _hoisted_3$14 = ["innerHTML"];
@@ -15426,7 +15180,7 @@ var _sfc_main$20 = {
 					emitCommentPositionsInViewing: isViewingMode() && shouldRenderCommentsInViewing.value,
 					enableCommentsInViewing: isViewingCommentsVisible.value,
 					contentControlsChrome: proxy.$superdoc.config.modules?.contentControls?.chrome,
-					resolveTrackedChangeColor: composeAuthorColorResolver(proxy.$superdoc.config.modules?.trackChanges?.authorColors)
+					resolveTrackedChangeColor: require_create_super_doc_ui.composeAuthorColorResolver(proxy.$superdoc.config.modules?.trackChanges?.authorColors)
 				} : void 0,
 				permissionResolver: (payload = {}) => proxy.$superdoc.canPerformPermission({
 					role: proxy.$superdoc.config.role,
@@ -32600,7 +32354,11 @@ var _sfc_main$2 = {
 	}
 };
 var IconGrid_default = /* @__PURE__ */ require__plugin_vue_export_helper.__plugin_vue_export_helper_default(_sfc_main$2, [["__scopeId", "data-v-52b0283a"]]);
-const refocusEditorSurface = (superToolbar) => {
+const refocusEditorSurface = (superToolbar, preferredEditor = null) => {
+	if (typeof preferredEditor?.focus === "function") {
+		preferredEditor.focus();
+		return;
+	}
 	const focusHandle = superToolbar?.superdoc?.focus ?? superToolbar?.activeEditor?.focus;
 	if (typeof focusHandle === "function") {
 		focusHandle.call(superToolbar?.superdoc ?? superToolbar?.activeEditor);
@@ -33726,6 +33484,7 @@ const makeDefaultItems = ({ superToolbar, toolbarIcons: toolbarIcons$1, toolbarT
 		return (0, vue.h)(DocumentMode_default, {
 			options: getDocumentOptionsAfterRole(role, documentOptions),
 			onSelect: (item) => {
+				const selectedEditor = superToolbar.superdoc?.activeEditor ?? superToolbar.activeEditor;
 				closeDropdown(renderDocumentButton);
 				const { label, icon, value } = item;
 				documentMode.label.value = label;
@@ -33734,6 +33493,7 @@ const makeDefaultItems = ({ superToolbar, toolbarIcons: toolbarIcons$1, toolbarT
 					item: documentMode,
 					argument: value
 				});
+				refocusEditorSurface(superToolbar, selectedEditor);
 			}
 		});
 	}
@@ -34935,7 +34695,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.0.0-next.33";
+		this.version = "2.0.0-next.34";
 		this.#log("🦋 [superdoc] Using SuperDoc version:", this.version);
 		this.superdocId = config.superdocId || require_uuid.v4_default();
 		this.colors = this.config.colors ?? [];