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

package/dist/superdoc.es.js

@@ -5,7 +5,7 @@ import { t as v4_default } from "./chunks/uuid-B2Sqk-3p.es.js";
 import { a as init_dist, i as global, n as init_dist$1, r as process$1, t as require_jszip_min } from "./chunks/jszip-DzmwAHr3.es.js";
 import { t as __plugin_vue_export_helper_default } from "./chunks/_plugin-vue_export-helper-CInC0bKI.es.js";
 import { n as PDF_TO_CSS_UNITS } from "./chunks/constants-CY3R3_kF.es.js";
-import { a as createV2ReviewMutationReconciler, i as isV2EditableTextMutationEvent, o as getV2TrackedChangeMutationImpact, s as composeAuthorColorResolver, t as createSuperDocUI } from "./chunks/create-super-doc-ui-BmtUtDDR.es.js";
+import { a as createV2ReviewMutationReconciler, i as isV2EditableTextMutationEvent, o as getV2TrackedChangeMutationImpact, s as composeAuthorColorResolver, t as createSuperDocUI } from "./chunks/create-super-doc-ui-D4UDePxr.es.js";
 import * as Vue from "vue";
 import { Fragment, Teleport, Transition, computed, createApp, createBlock, createCommentVNode, createElementBlock, createElementVNode, createTextVNode, createVNode, defineAsyncComponent, defineComponent, getCurrentInstance, h, inject, markRaw, mergeProps, nextTick, normalizeClass, normalizeProps, normalizeStyle, onActivated, onBeforeUnmount, onDeactivated, onMounted, openBlock, reactive, ref, renderList, renderSlot, resolveDirective, resolveDynamicComponent, shallowRef, toDisplayString, toRaw, toRef, unref, useAttrs, vModelText, watch, withCtx, withDirectives, withKeys, withModifiers } from "vue";
 import "y-websocket";
@@ -375,7 +375,7 @@ function setupDevtoolsPlugin(pluginDescriptor, setupFn) {
 var activePinia;
 var setActivePinia = (pinia) => activePinia = pinia;
 var piniaSymbol = 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;
@@ -1049,7 +1049,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;
@@ -1082,14 +1082,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 = 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) {
@@ -1299,7 +1299,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));
@@ -3006,6 +3006,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 = reactive({
 		documentMode: "editing",
@@ -4314,6 +4319,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,
@@ -4361,6 +4367,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,
@@ -8778,19 +8785,20 @@ var FloatingComments_default = /* @__PURE__ */ __plugin_vue_export_helper_defaul
 				});
 			}
 			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 = computed(() => {
@@ -9298,7 +9306,7 @@ var FloatingComments_default = /* @__PURE__ */ __plugin_vue_export_helper_defaul
 			}), 128))], 4)], 36);
 		};
 	}
-}, [["__scopeId", "data-v-a1bd2282"]]);
+}, [["__scopeId", "data-v-b5be33eb"]]);
 var _hoisted_1$22 = {
 	class: "superdoc__pdf-comments-layer pdf-comments-layer",
 	"aria-hidden": "false"
@@ -13850,8 +13858,7 @@ var SuperDoc_default = /* @__PURE__ */ __plugin_vue_export_helper_default({
 		const allowSelectionInViewMode = () => !!proxy?.$superdoc?.config?.allowSelectionInViewMode;
 		const isViewingCommentsVisible = computed(() => isViewingMode() && commentsStore.viewingVisibility.commentsVisible === true);
 		const isFindReplaceEnabled = computed(() => {
-			const val = proxy?.$superdoc?.config?.modules?.surfaces?.findReplace;
-			return val === true || typeof val === "object" && val !== null;
+			return proxy?.$superdoc?.uiConfig?.search?.enabled === true;
 		});
 		computed(() => isViewingMode() && commentsStore.viewingVisibility.trackChangesVisible === true);
 		const shouldRenderCommentsInViewing = computed(() => commentsStore.shouldRenderReviewInViewing);
@@ -13923,7 +13930,7 @@ var SuperDoc_default = /* @__PURE__ */ __plugin_vue_export_helper_default({
 			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", {
@@ -15137,11 +15144,11 @@ var SuperDoc_default = /* @__PURE__ */ __plugin_vue_export_helper_default({
 				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,
@@ -15149,7 +15156,7 @@ var SuperDoc_default = /* @__PURE__ */ __plugin_vue_export_helper_default({
 					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: composeAuthorColorResolver(proxy.$superdoc.config.modules?.trackChanges?.authorColors)
 				} : void 0,
 				permissionResolver: (payload = {}) => proxy.$superdoc.canPerformPermission({
@@ -15744,6 +15751,7 @@ var SuperDoc_default = /* @__PURE__ */ __plugin_vue_export_helper_default({
 			selectionLayer.value.style.pointerEvents = "none";
 		};
 		const shouldShowSelection = 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;
@@ -15757,6 +15765,7 @@ var SuperDoc_default = /* @__PURE__ */ __plugin_vue_export_helper_default({
 			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;
@@ -16087,7 +16096,7 @@ var SuperDoc_default = /* @__PURE__ */ __plugin_vue_export_helper_default({
 			], 38);
 		};
 	}
-}, [["__scopeId", "data-v-41f40a40"]]);
+}, [["__scopeId", "data-v-2a7bfa95"]]);
 var PINIA_DEVTOOLS_SETUP_EVENT = "devtools-plugin:setup";
 var PINIA_DEVTOOLS_PLUGIN_ID = "dev.esm.pinia";
 var piniaDevtoolsSuppressionState = {
@@ -28341,7 +28350,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 {
@@ -28473,6 +28482,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"
+]);
+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();
@@ -33945,6 +34077,11 @@ var BuiltInToolbar = class extends import_eventemitter3.default {
 		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() {
@@ -33958,6 +34095,7 @@ var BuiltInToolbar = class extends import_eventemitter3.default {
 	}
 	#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,
@@ -33972,14 +34110,14 @@ var BuiltInToolbar = class extends import_eventemitter3.default {
 		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;
@@ -34543,6 +34681,18 @@ var SuperDoc = class extends 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;
@@ -34612,7 +34762,7 @@ var SuperDoc = class extends 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) {
@@ -34646,10 +34796,21 @@ var SuperDoc = class extends 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 || v4_default();
 		this.colors = this.config.colors ?? [];
@@ -35661,29 +35822,28 @@ var SuperDoc = class extends 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) {
@@ -35734,6 +35894,7 @@ var SuperDoc = class extends 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;
@@ -36017,13 +36178,26 @@ var SuperDoc = class extends 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");