superdoc 2.0.0-next.49 → 2.0.0-next.50

package/dist/superdoc/src/public/index.d.cts

@@ -39,6 +39,7 @@ import type { FindReplaceResolution as __Cjs_FindReplaceResolution } from './ind
 import type { FlowBlock as __Cjs_FlowBlock } from './index.js' with { "resolution-mode": "import" };
 import type { FlowMode as __Cjs_FlowMode } from './index.js' with { "resolution-mode": "import" };
 import type { IntentSurfaceRequest as __Cjs_IntentSurfaceRequest } from './index.js' with { "resolution-mode": "import" };
+import type { InteractionConfig as __Cjs_InteractionConfig } from './index.js' with { "resolution-mode": "import" };
 import type { Layout as __Cjs_Layout } from './index.js' with { "resolution-mode": "import" };
 import type { LayoutEngineOptions as __Cjs_LayoutEngineOptions } from './index.js' with { "resolution-mode": "import" };
 import type { LayoutFragment as __Cjs_LayoutFragment } from './index.js' with { "resolution-mode": "import" };
@@ -154,6 +155,7 @@ import type { SurfaceOutcome as __Cjs_SurfaceOutcome } from './index.js' with {
 import type { SurfaceRequest as __Cjs_SurfaceRequest } from './index.js' with { "resolution-mode": "import" };
 import type { SurfaceResolution as __Cjs_SurfaceResolution } from './index.js' with { "resolution-mode": "import" };
 import type { SurfaceResolver as __Cjs_SurfaceResolver } from './index.js' with { "resolution-mode": "import" };
+import type { SurfacesConfig as __Cjs_SurfacesConfig } from './index.js' with { "resolution-mode": "import" };
 import type { SurfacesModuleConfig as __Cjs_SurfacesModuleConfig } from './index.js' with { "resolution-mode": "import" };
 import type { TextAddress as __Cjs_TextAddress } from './index.js' with { "resolution-mode": "import" };
 import type { TextSegment as __Cjs_TextSegment } from './index.js' with { "resolution-mode": "import" };
@@ -165,6 +167,7 @@ import type { TrackChangesSemanticColorsConfig as __Cjs_TrackChangesSemanticColo
 import type { TrackedChangeAddress as __Cjs_TrackedChangeAddress } from './index.js' with { "resolution-mode": "import" };
 import type { TrackedChangeSemanticColorKey as __Cjs_TrackedChangeSemanticColorKey } from './index.js' with { "resolution-mode": "import" };
 import type { TrackedChangeSemanticColorResolverInput as __Cjs_TrackedChangeSemanticColorResolverInput } from './index.js' with { "resolution-mode": "import" };
+import type { UIConfig as __Cjs_UIConfig } from './index.js' with { "resolution-mode": "import" };
 import type { UpgradeToCollaborationOptions as __Cjs_UpgradeToCollaborationOptions } from './index.js' with { "resolution-mode": "import" };
 import type { User as __Cjs_User } from './index.js' with { "resolution-mode": "import" };
 import type { V2CollaborationConfig as __Cjs_V2CollaborationConfig } from './index.js' with { "resolution-mode": "import" };
@@ -218,6 +221,7 @@ export type { __Cjs_FlowMode as FlowMode };
 export declare const getFileObject: typeof import('./index.js', { with: { "resolution-mode": "import" } }).getFileObject;
 export declare const HTML: typeof import('./index.js', { with: { "resolution-mode": "import" } }).HTML;
 export type { __Cjs_IntentSurfaceRequest as IntentSurfaceRequest };
+export type { __Cjs_InteractionConfig as InteractionConfig };
 export type { __Cjs_Layout as Layout };
 export type { __Cjs_LayoutEngineOptions as LayoutEngineOptions };
 export type { __Cjs_LayoutFragment as LayoutFragment };
@@ -335,6 +339,7 @@ export type { __Cjs_SurfaceOutcome as SurfaceOutcome };
 export type { __Cjs_SurfaceRequest as SurfaceRequest };
 export type { __Cjs_SurfaceResolution as SurfaceResolution };
 export type { __Cjs_SurfaceResolver as SurfaceResolver };
+export type { __Cjs_SurfacesConfig as SurfacesConfig };
 export type { __Cjs_SurfacesModuleConfig as SurfacesModuleConfig };
 export type { __Cjs_TextAddress as TextAddress };
 export type { __Cjs_TextSegment as TextSegment };
@@ -346,6 +351,7 @@ export type { __Cjs_TrackChangesSemanticColorsConfig as TrackChangesSemanticColo
 export type { __Cjs_TrackedChangeAddress as TrackedChangeAddress };
 export type { __Cjs_TrackedChangeSemanticColorKey as TrackedChangeSemanticColorKey };
 export type { __Cjs_TrackedChangeSemanticColorResolverInput as TrackedChangeSemanticColorResolverInput };
+export type { __Cjs_UIConfig as UIConfig };
 export type { __Cjs_UpgradeToCollaborationOptions as UpgradeToCollaborationOptions };
 export type { __Cjs_User as User };
 export type { __Cjs_V2CollaborationConfig as V2CollaborationConfig };

package/dist/superdoc/src/public/index.d.ts

@@ -108,6 +108,9 @@ export type { TrackChangesSemanticColorsConfig } from '../core/types/index.js';
 export type { TrackedChangeSemanticColorKey } from '../core/types/index.js';
 export type { TrackedChangeSemanticColorResolverInput } from '../core/types/index.js';
 export type { TrackedChangeAddress } from '../core/types/index.js';
+export type { InteractionConfig } from '../core/types/index.js';
+export type { SurfacesConfig } from '../core/types/index.js';
+export type { UIConfig } from '../core/types/index.js';
 export type { UpgradeToCollaborationOptions } from '../core/types/index.js';
 export type { V2CollaborationConfig } from '../core/types/index.js';
 export type { User } from '../core/types/index.js';

package/dist/superdoc/src/public/ui.d.cts

@@ -20,6 +20,7 @@ import type { ContentControlsListResult as __Cjs_ContentControlsListResult } fro
 import type { ContentControlsSlice as __Cjs_ContentControlsSlice } from './ui.js' with { "resolution-mode": "import" };
 import type { ContentControlViewportAddress as __Cjs_ContentControlViewportAddress } from './ui.js' with { "resolution-mode": "import" };
 import type { ContextMenuItem as __Cjs_ContextMenuItem } from './ui.js' with { "resolution-mode": "import" };
+import type { CustomCommandContext as __Cjs_CustomCommandContext } from './ui.js' with { "resolution-mode": "import" };
 import type { CustomCommandHandle as __Cjs_CustomCommandHandle } from './ui.js' with { "resolution-mode": "import" };
 import type { CustomCommandHandleState as __Cjs_CustomCommandHandleState } from './ui.js' with { "resolution-mode": "import" };
 import type { CustomCommandRegistration as __Cjs_CustomCommandRegistration } from './ui.js' with { "resolution-mode": "import" };
@@ -116,6 +117,7 @@ export type { __Cjs_ContentControlsSlice as ContentControlsSlice };
 export type { __Cjs_ContentControlViewportAddress as ContentControlViewportAddress };
 export type { __Cjs_ContextMenuItem as ContextMenuItem };
 export declare const createSuperDocUI: typeof import('./ui.js', { with: { "resolution-mode": "import" } }).createSuperDocUI;
+export type { __Cjs_CustomCommandContext as CustomCommandContext };
 export type { __Cjs_CustomCommandHandle as CustomCommandHandle };
 export type { __Cjs_CustomCommandHandleState as CustomCommandHandleState };
 export type { __Cjs_CustomCommandRegistration as CustomCommandRegistration };

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

@@ -26,4 +26,4 @@
 export { createSuperDocUI } from './ui/create-super-doc-ui.js';
 export { shallowEqual } from './ui/equality.js';
 export { BUILT_IN_COMMAND_IDS } from './ui/commands.js';
-export type { EqualityFn, SelectorFn, Subscribable, SuperDocUI, BorrowedSuperDocUI, SuperDocUIOptions, SuperDocUIState, SuperDocUIScope, SuperDocLike, SuperDocEditorLike, CommandHandle, CommandState, CommandExecutionResult, WorkflowReceipt, WorkflowActionResult, WorkflowScrollResult, SelectionRestoreResult, SuperDocUIReason, CommandsHandle, ContextMenuItem, CustomCommandHandle, CustomCommandHandleState, CustomCommandRegistration, CustomCommandRegistrationResult, MetadataHandle, SelectionHandle, ToolbarHandle, CommentsHandle, TrackChangesHandle, ContentControlsHandle, ContentControlFocusResult, FontsHandle, ZoomHandle, DocumentHandle, ViewportHandle, StylesHandle, ActiveParagraphStyle, SliceStatus, SelectionSlice, SelectionCapture, CommentAnchorCapture, ToolbarSnapshotSlice, CommentsSlice, TrackChangesSlice, ContentControlsSlice, FontsSlice, ZoomSlice, DocumentSlice, StylesSlice, StyleCatalogView, StyleCatalogItemType, StyleCatalogFilterType, StyleProvenance, StyleCatalogItemVisibility, StyleCatalogItemUsage, StyleCatalogItemPreview, StyleCatalogItem, StyleCatalogDefaults, StyleCatalogDiagnostic, StyleCatalogSourceStatus, StylesGetCatalogInput, StylesGetCatalogResult, CommentInfo, CommentsListQuery, TrackChangeInfo, TrackChangePointHit, TrackChangesItem, FontFamilyOption, FontSizeOption, CommentAddress, TrackedChangeAddress, ContentControlViewportAddress, ViewportEntityAddress, ViewportEntityHit, ViewportContext, ViewportRect, ViewportGetRectInput, ViewportRectResult, BrowserDocumentApi, PartialBrowserDocumentApi, DocumentApi, Receipt, SelectionInfo, SelectionTarget, SelectionPoint, TextTarget, TextAddress, ScrollIntoViewInput, ScrollIntoViewOutput, EntityAddress, CommentsListResult, TrackChangesListResult, ContentControlsListResult, ContentControlInfo, } from './ui/types.js';
+export type { EqualityFn, SelectorFn, Subscribable, SuperDocUI, BorrowedSuperDocUI, SuperDocUIOptions, SuperDocUIState, SuperDocUIScope, SuperDocLike, SuperDocEditorLike, CommandHandle, CommandState, CommandExecutionResult, WorkflowReceipt, WorkflowActionResult, WorkflowScrollResult, SelectionRestoreResult, SuperDocUIReason, CommandsHandle, ContextMenuItem, CustomCommandContext, CustomCommandHandle, CustomCommandHandleState, CustomCommandRegistration, CustomCommandRegistrationResult, MetadataHandle, SelectionHandle, ToolbarHandle, CommentsHandle, TrackChangesHandle, ContentControlsHandle, ContentControlFocusResult, FontsHandle, ZoomHandle, DocumentHandle, ViewportHandle, StylesHandle, ActiveParagraphStyle, SliceStatus, SelectionSlice, SelectionCapture, CommentAnchorCapture, ToolbarSnapshotSlice, CommentsSlice, TrackChangesSlice, ContentControlsSlice, FontsSlice, ZoomSlice, DocumentSlice, StylesSlice, StyleCatalogView, StyleCatalogItemType, StyleCatalogFilterType, StyleProvenance, StyleCatalogItemVisibility, StyleCatalogItemUsage, StyleCatalogItemPreview, StyleCatalogItem, StyleCatalogDefaults, StyleCatalogDiagnostic, StyleCatalogSourceStatus, StylesGetCatalogInput, StylesGetCatalogResult, CommentInfo, CommentsListQuery, TrackChangeInfo, TrackChangePointHit, TrackChangesItem, FontFamilyOption, FontSizeOption, CommentAddress, TrackedChangeAddress, ContentControlViewportAddress, ViewportEntityAddress, ViewportEntityHit, ViewportContext, ViewportRect, ViewportGetRectInput, ViewportRectResult, BrowserDocumentApi, PartialBrowserDocumentApi, DocumentApi, Receipt, SelectionInfo, SelectionTarget, SelectionPoint, TextTarget, TextAddress, ScrollIntoViewInput, ScrollIntoViewOutput, EntityAddress, CommentsListResult, TrackChangesListResult, ContentControlsListResult, ContentControlInfo, } from './ui/types.js';

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-BNo2DvD1.cjs");
+const require_create_super_doc_ui = require("./chunks/create-super-doc-ui-DlSN0ENQ.cjs");
 let vue = require("vue");
 vue = require_rolldown_runtime.__toESM(vue);
 require("y-websocket");
@@ -378,7 +378,7 @@ function setupDevtoolsPlugin(pluginDescriptor, setupFn) {
 var activePinia;
 var setActivePinia = (pinia) => activePinia = pinia;
 var piniaSymbol = require_jszip.process$1.env.NODE_ENV !== "production" ? Symbol("pinia") : Symbol();
-function isPlainObject(o) {
+function isPlainObject$3(o) {
 	return o && typeof o === "object" && Object.prototype.toString.call(o) === "[object Object]" && typeof o.toJSON !== "function";
 }
 var MutationType;
@@ -1052,7 +1052,7 @@ function patchObject(newState, oldState) {
 		const subPatch = oldState[key];
 		if (!(key in newState)) continue;
 		const targetValue = newState[key];
-		if (isPlainObject(targetValue) && isPlainObject(subPatch) && !(0, lib_exports.isRef)(subPatch) && !(0, lib_exports.isReactive)(subPatch)) newState[key] = patchObject(targetValue, subPatch);
+		if (isPlainObject$3(targetValue) && isPlainObject$3(subPatch) && !(0, lib_exports.isRef)(subPatch) && !(0, lib_exports.isReactive)(subPatch)) newState[key] = patchObject(targetValue, subPatch);
 		else newState[key] = subPatch;
 	}
 	return newState;
@@ -1085,14 +1085,14 @@ function mergeReactiveObjects(target, patchToApply) {
 		if (!patchToApply.hasOwnProperty(key)) continue;
 		const subPatch = patchToApply[key];
 		const targetValue = target[key];
-		if (isPlainObject(targetValue) && isPlainObject(subPatch) && target.hasOwnProperty(key) && !(0, lib_exports.isRef)(subPatch) && !(0, lib_exports.isReactive)(subPatch)) target[key] = mergeReactiveObjects(targetValue, subPatch);
+		if (isPlainObject$3(targetValue) && isPlainObject$3(subPatch) && target.hasOwnProperty(key) && !(0, lib_exports.isRef)(subPatch) && !(0, lib_exports.isReactive)(subPatch)) target[key] = mergeReactiveObjects(targetValue, subPatch);
 		else target[key] = subPatch;
 	}
 	return target;
 }
 var skipHydrateSymbol = require_jszip.process$1.env.NODE_ENV !== "production" ? Symbol("pinia:skipHydration") : Symbol();
 function shouldHydrate(obj) {
-	return !isPlainObject(obj) || !obj.hasOwnProperty(skipHydrateSymbol);
+	return !isPlainObject$3(obj) || !obj.hasOwnProperty(skipHydrateSymbol);
 }
 var { assign } = Object;
 function isComputed(o) {
@@ -1302,7 +1302,7 @@ function createSetupStore($id, setup, options = {}, pinia, hot, isOptionsStore)
 			if (stateKey in store.$state) {
 				const newStateTarget = newStore.$state[stateKey];
 				const oldStateSource = store.$state[stateKey];
-				if (typeof newStateTarget === "object" && isPlainObject(newStateTarget) && isPlainObject(oldStateSource)) patchObject(newStateTarget, oldStateSource);
+				if (typeof newStateTarget === "object" && isPlainObject$3(newStateTarget) && isPlainObject$3(oldStateSource)) patchObject(newStateTarget, oldStateSource);
 				else newStore.$state[stateKey] = oldStateSource;
 			}
 			set(store, stateKey, (0, lib_exports.toRef)(newStore.$state, stateKey));
@@ -3010,6 +3010,11 @@ const useCommentsStore = defineStore("comments", () => {
 		ok: false,
 		reason: "read-only-document"
 	});
+	const resolveDisabledOutcome = () => ({
+		ok: false,
+		reason: "resolve-disabled"
+	});
+	const resolveIsDisabled = () => commentsConfig.allowResolve === false;
 	const commentsAreReadOnly$1 = () => commentsConfig.readOnly === true;
 	const viewingVisibility = (0, vue.reactive)({
 		documentMode: "editing",
@@ -4318,6 +4323,7 @@ const useCommentsStore = defineStore("comments", () => {
 	};
 	const resolveCommentV2 = async ({ superdoc, commentId } = {}) => {
 		if (commentsAreReadOnly$1()) return readOnlyMutationOutcome$1();
+		if (resolveIsDisabled()) return resolveDisabledOutcome();
 		const v2Adapter = getV2CommentsAdapter(superdoc);
 		if (!v2Adapter) return {
 			ok: false,
@@ -4365,6 +4371,7 @@ const useCommentsStore = defineStore("comments", () => {
 	};
 	const reopenCommentV2 = async ({ superdoc, commentId } = {}) => {
 		if (commentsAreReadOnly$1()) return readOnlyMutationOutcome$1();
+		if (resolveIsDisabled()) return resolveDisabledOutcome();
 		const v2Adapter = getV2CommentsAdapter(superdoc);
 		if (!v2Adapter) return {
 			ok: false,
@@ -8789,19 +8796,20 @@ var _sfc_main$30 = {
 				});
 			}
 			positions.sort((a, b) => a.anchorTop - b.anchorTop);
-			resolveCollisions(positions, activeKey ? positions.findIndex((p) => p.id === activeKey) : -1, 15);
+			const collisionPositions = [];
 			for (const position of positions) {
-				if (!position.hasAnchorGeometry) continue;
-				const offscreenTop = resolvePersistentReviewCardTop({
+				const offscreenTop = position.hasAnchorGeometry ? resolvePersistentReviewCardTop({
 					comment: position.commentRef,
 					anchorTop: position.anchorTop,
 					anchorBottom: position.anchorBottom,
 					cardHeight: position.height,
 					viewportTop: viewportRange.top,
 					viewportBottom: viewportRange.bottom
-				});
-				if (offscreenTop != null) position.top = offscreenTop;
+				}) : null;
+				if (offscreenTop == null) collisionPositions.push(position);
+				else position.top = offscreenTop;
 			}
+			resolveCollisions(collisionPositions, activeKey ? collisionPositions.findIndex((p) => p.id === activeKey) : -1, 15);
 			return positions;
 		});
 		const wrapperMinHeight = (0, vue.computed)(() => {
@@ -9310,7 +9318,7 @@ var _sfc_main$30 = {
 		};
 	}
 };
-var FloatingComments_default = /* @__PURE__ */ require__plugin_vue_export_helper.__plugin_vue_export_helper_default(_sfc_main$30, [["__scopeId", "data-v-a1bd2282"]]);
+var FloatingComments_default = /* @__PURE__ */ require__plugin_vue_export_helper.__plugin_vue_export_helper_default(_sfc_main$30, [["__scopeId", "data-v-b5be33eb"]]);
 var _hoisted_1$22 = {
 	class: "superdoc__pdf-comments-layer pdf-comments-layer",
 	"aria-hidden": "false"
@@ -13889,8 +13897,7 @@ var _sfc_main$20 = {
 		const allowSelectionInViewMode = () => !!proxy?.$superdoc?.config?.allowSelectionInViewMode;
 		const isViewingCommentsVisible = (0, vue.computed)(() => isViewingMode() && commentsStore.viewingVisibility.commentsVisible === true);
 		const isFindReplaceEnabled = (0, vue.computed)(() => {
-			const val = proxy?.$superdoc?.config?.modules?.surfaces?.findReplace;
-			return val === true || typeof val === "object" && val !== null;
+			return proxy?.$superdoc?.uiConfig?.search?.enabled === true;
 		});
 		(0, vue.computed)(() => isViewingMode() && commentsStore.viewingVisibility.trackChangesVisible === true);
 		const shouldRenderCommentsInViewing = (0, vue.computed)(() => commentsStore.shouldRenderReviewInViewing);
@@ -13962,7 +13969,7 @@ var _sfc_main$20 = {
 			getSurfaceManager: getLinkPopoverSurfaceManager,
 			getActiveEditor: () => proxy.$superdoc?.activeEditor,
 			getUi: getSuperDocUI,
-			getResolver: () => proxy.$superdoc?.config?.modules?.links?.popoverResolver,
+			getResolver: () => proxy.$superdoc?.uiConfig?.linkPopover?.suppressed ? () => ({ type: "none" }) : proxy.$superdoc?.config?.modules?.links?.popoverResolver,
 			getLayerElement: () => layers.value,
 			emitException: (payload) => {
 				proxy.$superdoc?.emit("exception", {
@@ -15176,11 +15183,11 @@ var _sfc_main$20 = {
 				externalExtensions: proxy.$superdoc.config.editorExtensions || [],
 				extensions: proxy.$superdoc.config.extensions || [],
 				suppressDefaultDocxStyles: proxy.$superdoc.config.suppressDefaultDocxStyles,
-				disableContextMenu: proxy.$superdoc.config.disableContextMenu,
+				disableContextMenu: !proxy.$superdoc.uiConfig.contextMenu.enabled || proxy.$superdoc.config.disableContextMenu === true,
 				jsonOverride: proxy.$superdoc.config.jsonOverride,
 				viewOptions: proxy.$superdoc.config.viewOptions,
 				contained: proxy.$superdoc.config.contained,
-				linkPopoverResolver: proxy.$superdoc.config.modules?.links?.popoverResolver,
+				linkPopoverResolver: proxy.$superdoc.uiConfig.linkPopover.enabled ? proxy.$superdoc.config.modules?.links?.popoverResolver : void 0,
 				layoutEngineOptions: useLayoutEngine ? {
 					...proxy.$superdoc.config.layoutEngineOptions || {},
 					proofing: resolvedProofingConfig.value,
@@ -15188,7 +15195,7 @@ var _sfc_main$20 = {
 					zoom: (activeZoom.value ?? 100) / 100,
 					emitCommentPositionsInViewing: isViewingMode() && shouldRenderCommentsInViewing.value,
 					enableCommentsInViewing: isViewingCommentsVisible.value,
-					contentControlsChrome: proxy.$superdoc.config.modules?.contentControls?.chrome,
+					contentControlsChrome: !proxy.$superdoc.uiConfig.contentControls.enabled ? "none" : proxy.$superdoc.uiConfig.contentControls.options.chrome ?? (proxy.$superdoc.config.modules?.contentControls?.chrome === "none" ? void 0 : proxy.$superdoc.config.modules?.contentControls?.chrome),
 					resolveTrackedChangeColor: require_create_super_doc_ui.composeAuthorColorResolver(proxy.$superdoc.config.modules?.trackChanges?.authorColors)
 				} : void 0,
 				permissionResolver: (payload = {}) => proxy.$superdoc.canPerformPermission({
@@ -15783,6 +15790,7 @@ var _sfc_main$20 = {
 			selectionLayer.value.style.pointerEvents = "none";
 		};
 		const shouldShowSelection = (0, vue.computed)(() => {
+			if (!proxy.$superdoc.uiConfig.comments.enabled) return false;
 			const config = proxy.$superdoc.config.modules?.comments;
 			if (!config || config === false) return false;
 			return !config.readOnly;
@@ -15796,6 +15804,7 @@ var _sfc_main$20 = {
 			if (!isV2Mode.value) return false;
 			if (!doc || doc.type !== "application/vnd.openxmlformats-officedocument.wordprocessingml.document") return false;
 			if (proxy.$superdoc.config.viewOptions?.layout === "web") return false;
+			if (proxy.$superdoc.uiConfig.ruler.suppressed) return false;
 			if (!Boolean(unwrapDocField(doc.rulers))) return false;
 			if (!v2RulerReady.value) return false;
 			const editor = proxy.$superdoc?.activeEditor;
@@ -16127,7 +16136,7 @@ var _sfc_main$20 = {
 		};
 	}
 };
-var SuperDoc_default = /* @__PURE__ */ require__plugin_vue_export_helper.__plugin_vue_export_helper_default(_sfc_main$20, [["__scopeId", "data-v-41f40a40"]]);
+var SuperDoc_default = /* @__PURE__ */ require__plugin_vue_export_helper.__plugin_vue_export_helper_default(_sfc_main$20, [["__scopeId", "data-v-2a7bfa95"]]);
 var PINIA_DEVTOOLS_SETUP_EVENT = "devtools-plugin:setup";
 var PINIA_DEVTOOLS_PLUGIN_ID = "dev.esm.pinia";
 var piniaDevtoolsSuppressionState = {
@@ -28382,7 +28391,7 @@ var SurfaceManager = class {
 				if (resolution.type === "external") return { render: resolution.render };
 			}
 		}
-		throw new Error(`SurfaceManager: no renderer resolved for kind "${request.kind}". Provide a resolver via modules.surfaces.resolver, or use a direct-render request.`);
+		throw new Error(`SurfaceManager: no renderer resolved for kind "${request.kind}". Provide a resolver via surfaces.resolver, or use a direct-render request.`);
 	}
 	#createDestroyedHandle(rawRequest) {
 		return {
@@ -28514,6 +28523,129 @@ function normalizeSuperDocUser(user) {
 		...user
 	};
 }
+function mergeDefined(...sources) {
+	const merged = {};
+	for (const source of sources) {
+		if (typeof source !== "object" || source === null) continue;
+		for (const [key, value] of Object.entries(source)) {
+			if (value === void 0) continue;
+			merged[key] = value;
+		}
+	}
+	return merged;
+}
+function firstDefined(...values) {
+	for (const value of values) if (value !== void 0) return value;
+}
+var HISTORICAL_DEFAULTS = Object.freeze({
+	toolbar: true,
+	comments: true,
+	contextMenu: true,
+	search: false,
+	linkPopover: false,
+	ruler: false,
+	contentControls: true
+});
+var DEFAULT_TOOLBAR_GROUP_IDS = Object.freeze([
+	"left",
+	"center",
+	"right"
+]);
+var BUILT_IN_SURFACES = Object.freeze(Object.keys(HISTORICAL_DEFAULTS));
+var isPlainObject$2 = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+function resolveSurface(ui, key) {
+	const value = ui?.[key];
+	if (value === false) return false;
+	if (value === void 0) return HISTORICAL_DEFAULTS[key];
+	return true;
+}
+function resolveOptions(ui, key) {
+	const value = ui?.[key];
+	return isPlainObject$2(value) ? value : {};
+}
+function normalizeUiConfig(config = {}) {
+	const raw = config.ui;
+	const allDisabled = raw === false;
+	const ui = isPlainObject$2(raw) ? raw : void 0;
+	const enabled = (key) => !allDisabled && resolveSurface(ui, key);
+	const explicit = (key) => {
+		if (allDisabled) return false;
+		return ui?.[key] === void 0 ? void 0 : resolveSurface(ui, key);
+	};
+	const options = (key) => allDisabled ? {} : resolveOptions(ui, key);
+	const rulerSuppressed = allDisabled || explicit("ruler") === false;
+	const toolbarOptions = options("toolbar");
+	const legacyToolbar = config.modules?.toolbar;
+	const legacyToolbarOptions = isPlainObject$2(legacyToolbar) ? legacyToolbar : {};
+	const groupCandidates = [toolbarOptions.groups, legacyToolbarOptions.groups];
+	const composedGroups = groupCandidates.find(isPlainObject$2);
+	const selectedGroups = firstDefined(groupCandidates.find(Array.isArray), legacyToolbarOptions.toolbarGroups, config.toolbarGroups);
+	const selection = Array.isArray(selectedGroups) ? selectedGroups : null;
+	const ownGroup = (map, group) => Object.prototype.hasOwnProperty.call(map, group);
+	const projectedGroups = composedGroups && selection ? Object.fromEntries([...selection.filter((group) => ownGroup(composedGroups, group)), ...Object.keys(composedGroups).filter((group) => !DEFAULT_TOOLBAR_GROUP_IDS.includes(group))].map((group) => [group, composedGroups[group]])) : composedGroups;
+	return {
+		enabled: !allDisabled,
+		toolbar: {
+			enabled: enabled("toolbar"),
+			container: allDisabled ? null : firstDefined(toolbarOptions.container, legacyToolbarOptions.selector, config.toolbar) ?? null,
+			options: allDisabled ? {} : {
+				...mergeDefined(legacyToolbarOptions, toolbarOptions),
+				groups: projectedGroups,
+				toolbarGroups: selectedGroups,
+				icons: mergeDefined(config.toolbarIcons, legacyToolbarOptions.icons, toolbarOptions.icons),
+				texts: mergeDefined(config.toolbarTexts, legacyToolbarOptions.texts, toolbarOptions.texts)
+			}
+		},
+		comments: {
+			enabled: explicit("comments") ?? (!allDisabled && config.modules?.comments !== false),
+			options: options("comments")
+		},
+		contextMenu: {
+			enabled: explicit("contextMenu") ?? (!allDisabled && config.disableContextMenu !== true),
+			suppressed: allDisabled || explicit("contextMenu") === false,
+			options: options("contextMenu")
+		},
+		search: {
+			enabled: explicit("search") ?? (!allDisabled && Boolean(config.modules?.surfaces?.findReplace)),
+			options: options("search")
+		},
+		linkPopover: {
+			enabled: explicit("linkPopover") ?? (!allDisabled && Boolean(config.modules?.links?.popoverResolver)),
+			suppressed: allDisabled || explicit("linkPopover") === false,
+			options: options("linkPopover")
+		},
+		ruler: {
+			enabled: explicit("ruler") ?? (!allDisabled && Boolean(config.rulers)),
+			suppressed: rulerSuppressed,
+			container: rulerSuppressed ? null : options("ruler").container ?? config.rulerContainer ?? null
+		},
+		contentControls: {
+			enabled: explicit("contentControls") ?? (!allDisabled && config.modules?.contentControls?.chrome !== "none"),
+			options: options("contentControls")
+		}
+	};
+}
+var isPlainObject$1 = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+function normalizeInteractionConfig(config = {}) {
+	const interaction = isPlainObject$1(config.interaction) ? config.interaction : {};
+	const interactionComments = isPlainObject$1(interaction.comments) ? interaction.comments : {};
+	const legacyComments = isPlainObject$1(config.modules?.comments) ? config.modules.comments : {};
+	return { comments: {
+		readOnly: (interactionComments.readOnly ?? legacyComments.readOnly ?? false) === true,
+		allowResolve: (interactionComments.allowResolve ?? legacyComments.allowResolve ?? true) !== false
+	} };
+}
+var isPlainObject = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+function normalizeSurfacesConfig(config = {}) {
+	const next = isPlainObject(config.surfaces) ? config.surfaces : {};
+	const legacy = isPlainObject(config.modules?.surfaces) ? config.modules.surfaces : {};
+	const resolver = next.resolver === void 0 ? legacy.resolver : next.resolver;
+	return {
+		resolver: typeof resolver === "function" ? resolver : null,
+		dialog: mergeDefined(legacy.dialog, next.dialog),
+		floating: mergeDefined(legacy.floating, next.floating)
+	};
+}
 var EditorRuntimeRegistry = class {
 	#runtimes = /* @__PURE__ */ new Map();
 	#rootToId = /* @__PURE__ */ new Map();
@@ -34008,6 +34140,11 @@ var BuiltInToolbar = class extends require_eventemitter3.import_eventemitter3.de
 		this._detachFontsChanged = null;
 	}
 	#initToolbarGroups() {
+		if (Array.isArray(this.config.groups)) {
+			this.config.toolbarGroups = this.config.groups;
+			this.config.groups = null;
+			return;
+		}
 		if (this.config.groups && !Array.isArray(this.config.groups) && Object.keys(this.config.groups).length) this.config.toolbarGroups = Object.keys(this.config.groups);
 	}
 	getAvailableWidth() {
@@ -34021,6 +34158,7 @@ var BuiltInToolbar = class extends require_eventemitter3.import_eventemitter3.de
 	}
 	#makeToolbarItems() {
 		const availableWidth = this.getAvailableWidth();
+		const hasExplicitGroupComposition = this.config.groups && !Array.isArray(this.config.groups) && Object.keys(this.config.groups).length > 0;
 		const { defaultItems, overflowItems } = makeDefaultItems({
 			superToolbar: this,
 			toolbarIcons: this.config.icons,
@@ -34035,14 +34173,14 @@ var BuiltInToolbar = class extends require_eventemitter3.import_eventemitter3.de
 		const customToolbarItems = customItems.map((item) => this.#prepareCustomButton(item));
 		if (customItems.length) defaultItems.push(...customToolbarItems);
 		let allConfigItems = [...defaultItems.map((item) => item.name.value), ...overflowItems.map((item) => item.name.value)];
-		if (this.config.groups) {
+		if (hasExplicitGroupComposition) {
 			const groupedItems = Object.values(this.config.groups).flatMap((item) => item);
 			const configuredGroups = new Set(Object.keys(this.config.groups));
 			const groupedCustomItems = customToolbarItems.filter((item) => configuredGroups.has(item.group?.value || "center")).map((item) => item.name.value);
 			allConfigItems = [...new Set([...groupedItems, ...groupedCustomItems])];
 		}
 		const filteredItems = defaultItems.filter((item) => allConfigItems.includes(item.name.value)).filter((item) => !this.config.excludeItems.includes(item.name.value));
-		if (this.config.groups) {
+		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;
 		}
 		this.toolbarItems = filteredItems;
@@ -34606,6 +34744,18 @@ var SuperDoc = class extends require_eventemitter3.import_eventemitter3.default
 	#pendingV2LockSeed = null;
 	#mountWrapper = null;
 	#ui = null;
+	#uiConfig = normalizeUiConfig({});
+	get uiConfig() {
+		return this.#uiConfig;
+	}
+	#interactionConfig = normalizeInteractionConfig({});
+	get interactionConfig() {
+		return this.#interactionConfig;
+	}
+	#surfacesConfig = normalizeSurfacesConfig({});
+	get surfacesConfig() {
+		return this.#surfacesConfig;
+	}
 	#surfaceManager;
 	#editorRuntimeRegistry = new EditorRuntimeRegistry();
 	#editorRuntimeRegistryUnsub = null;
@@ -34675,7 +34825,7 @@ var SuperDoc = class extends require_eventemitter3.import_eventemitter3.default
 		if (!config.selector) throw new Error("SuperDoc: selector is required");
 		const container = typeof config.selector === "string" ? document.querySelector(config.selector) : config.selector;
 		if (!(container instanceof HTMLElement)) throw new Error("SuperDoc: selector must be a valid CSS selector string or DOM element");
-		this.#surfaceManager = new SurfaceManager({ getModuleConfig: () => this.config.modules?.surfaces });
+		this.#surfaceManager = new SurfaceManager({ getModuleConfig: () => this.#surfacesConfig });
 		this.#init(config, container);
 	}
 	async #init(config, container) {
@@ -34709,10 +34859,21 @@ var SuperDoc = class extends require_eventemitter3.import_eventemitter3.default
 		this.config.modules = this.config.modules || {};
 		if (!Object.prototype.hasOwnProperty.call(this.config.modules, "comments")) this.config.modules.comments = {};
 		this.config.modules.comments = normalizeCommentsUiPolicy(this.config.modules.comments);
+		this.#uiConfig = normalizeUiConfig(this.config);
+		this.#interactionConfig = normalizeInteractionConfig(this.config);
+		this.#surfacesConfig = normalizeSurfacesConfig(this.config);
+		this.config.disableContextMenu = !this.#uiConfig.contextMenu.enabled;
+		if (!this.#uiConfig.comments.enabled) this.config.modules.comments = false;
+		else if (this.config.modules.comments === false) this.config.modules.comments = {};
+		if (this.#uiConfig.comments.enabled) {
+			if (this.config.modules.comments === true) this.config.modules.comments = {};
+			const commentsBlock = this.config.modules.comments;
+			if (commentsBlock) Object.assign(commentsBlock, this.#interactionConfig.comments);
+		}
 		this.config.colors = shuffleArray(this.config.colors);
 		this.userColorMap = /* @__PURE__ */ new Map();
 		this.colorIndex = 0;
-		this.version = "2.0.0-next.49";
+		this.version = "2.0.0-next.50";
 		this.#log("🦋 [superdoc] Using SuperDoc version:", this.version);
 		this.superdocId = config.superdocId || require_uuid.v4_default();
 		this.colors = this.config.colors ?? [];
@@ -35724,29 +35885,28 @@ var SuperDoc = class extends require_eventemitter3.import_eventemitter3.default
 	#addToolbar() {
 		const toolbarModuleConfig = this.config.modules?.toolbar;
 		const toolbarModule = toolbarModuleConfig && typeof toolbarModuleConfig === "object" ? toolbarModuleConfig : {};
-		this.toolbarElement = toolbarModule.selector || this.config.toolbar;
-		if (!(Boolean(this.config.toolbar) || toolbarModuleConfig === true || toolbarModuleConfig != null && typeof toolbarModuleConfig === "object")) {
+		const toolbarUi = this.#uiConfig.toolbar;
+		this.toolbarElement = toolbarUi.container ?? void 0;
+		const uiBlock = this.config.ui;
+		const namedInUiBlock = typeof uiBlock === "object" && uiBlock !== null && uiBlock.toolbar !== void 0;
+		if (!(toolbarUi.enabled && (Boolean(toolbarUi.container) || toolbarModuleConfig === true || toolbarModuleConfig != null && typeof toolbarModuleConfig === "object" || namedInUiBlock))) {
 			this.toolbar = null;
 			return;
 		}
 		try {
 			this.toolbar = createBuiltInToolbar({
 				...toolbarModule,
+				...toolbarUi.options,
 				selector: this.toolbarElement,
 				superdoc: this,
 				editor: this.activeEditor,
 				role: this.config.role,
 				isDev: this.isDev,
 				documentMode: this.config.documentMode,
-				toolbarGroups: toolbarModule.toolbarGroups ?? this.config.toolbarGroups,
-				icons: {
-					...this.config.toolbarIcons,
-					...toolbarModule.icons
-				},
-				texts: {
-					...this.config.toolbarTexts,
-					...toolbarModule.texts
-				},
+				groups: toolbarUi.options.groups,
+				toolbarGroups: toolbarUi.options.toolbarGroups,
+				icons: toolbarUi.options.icons,
+				texts: toolbarUi.options.texts,
 				uiDisplayFallbackFont: this.config.uiDisplayFallbackFont
 			});
 		} catch (error) {
@@ -35797,6 +35957,7 @@ var SuperDoc = class extends require_eventemitter3.import_eventemitter3.default
 		return documentRuntime.scrollToElement(elementId);
 	}
 	setDisableContextMenu(disabled = true) {
+		if (!disabled && this.#uiConfig.contextMenu.suppressed) return;
 		const nextValue = Boolean(disabled);
 		if (this.config.disableContextMenu === nextValue) return;
 		this.config.disableContextMenu = nextValue;
@@ -36080,13 +36241,26 @@ var SuperDoc = class extends require_eventemitter3.import_eventemitter3.default
 		if (isV2ActiveEditorFacade(activeEditor) && typeof activeEditor.replaceFile === "function") {
 			const result = await activeEditor.replaceFile(source);
 			const state = result && typeof result === "object" ? result.state : null;
-			if (state === null || state === "review-ready" || state === "editing-ready") this.#replaceActiveDocumentData(activeEditor, source);
+			if (state === null || state === "review-ready" || state === "editing-ready") {
+				this.#replaceActiveDocumentData(activeEditor, source);
+				this.emit("document-replaced", {
+					editor: activeEditor,
+					host: activeEditor?.host
+				});
+			}
 			return result;
 		}
 		const legacyReplaceFile = activeEditor && !isV2ActiveEditorFacade(activeEditor) ? activeEditor.replaceFile : null;
 		if (typeof legacyReplaceFile === "function") {
 			const result = await legacyReplaceFile.call(activeEditor, source);
-			this.#replaceActiveDocumentData(activeEditor, source);
+			const legacyState = result && typeof result === "object" ? result.state : void 0;
+			if (legacyState === void 0 || legacyState === null || legacyState === "review-ready" || legacyState === "editing-ready") {
+				this.#replaceActiveDocumentData(activeEditor, source);
+				this.emit("document-replaced", {
+					editor: activeEditor,
+					host: activeEditor?.host
+				});
+			}
 			return result;
 		}
 		throw new Error("SuperDoc: replaceFile is unavailable for the active editor");