superdoc 2.0.0-next.45 → 2.0.0-next.46

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

@@ -1,4 +1,5 @@
 import { CommentsListQuery as DocumentApiCommentsListQuery, CommentsListResult, TrackChangesListResult, EntityAddress, TextAddress, TextTarget, ScrollIntoViewInput, ScrollIntoViewOutput, SelectionInfo, SelectionTarget, Receipt, ReceiptFailureCode, ContentControlInfo, StyleCatalogItem, StyleCatalogDiagnostic, StyleCatalogSourceStatus, StylesGetCatalogInput, StylesGetCatalogResult } from '../../../../document-api/src/index.js';
+import { PartialBrowserDocumentApi } from '../browser-document-api.js';
 import { SuperDocUIReason } from './reasons.js';
 /**
  * v2-native `superdoc/ui` controller types.
@@ -26,9 +27,10 @@ import { SuperDocUIReason } from './reasons.js';
  * (`scripts/ensure-types.cjs` `rewriteDocApiPaths`), so no bare private
  * specifier leaks into the emitted `.d.ts`.
  */
-export type { Receipt, SelectionInfo, SelectionTarget, SelectionPoint, TextTarget, TextAddress, ScrollIntoViewInput, ScrollIntoViewOutput, EntityAddress, CommentsListQuery as DocumentApiCommentsListQuery, CommentsListResult, TrackChangesListResult, ContentControlsListResult, ContentControlInfo, } from '../../../../document-api/src/index.js';
+export type { Receipt, SelectionInfo, SelectionTarget, SelectionPoint, TextTarget, TextAddress, ScrollIntoViewInput, ScrollIntoViewOutput, DocumentApi, EntityAddress, CommentsListQuery as DocumentApiCommentsListQuery, CommentsListResult, TrackChangesListResult, ContentControlsListResult, ContentControlInfo, } from '../../../../document-api/src/index.js';
 export type { StyleCatalogView, StyleCatalogItemType, StyleCatalogFilterType, StyleProvenance, StyleCatalogItemVisibility, StyleCatalogItemUsage, StyleCatalogItemPreview, StyleCatalogItem, StyleCatalogDefaults, StyleCatalogDiagnostic, StyleCatalogSourceStatus, StylesGetCatalogInput, StylesGetCatalogResult, } from '../../../../document-api/src/index.js';
 export type { ListPresetId } from '../../../../document-api/src/index.js';
+export type { BrowserDocumentApi, PartialBrowserDocumentApi } from '../browser-document-api.js';
 export type { SuperDocUIReason } from './reasons.js';
 /** Equality predicate used to suppress redundant slice notifications. */
 export type EqualityFn<T> = (a: T, b: T) => boolean;
@@ -414,14 +416,44 @@ export interface CustomCommandContext<TPayload = unknown> {
     editor: SuperDocEditorLike | null;
     superdoc: SuperDocLike;
     context?: ViewportContext;
-    /** The live UI controller (shared command-state truth). */
-    ui: SuperDocUI;
+    /**
+     * The live UI controller (shared command-state truth).
+     *
+     * Borrowed: a custom command runs against whichever controller invoked it,
+     * which for `superdoc.ui.commands.register(...)` is the instance-owned
+     * singleton the built-in toolbar also reads. Typing this as the owned form
+     * would let a command callback destroy it, which is the hole the borrowed
+     * handle exists to close.
+     *
+     * Borrowed unconditionally, including for a controller you built with
+     * `createSuperDocUI()`. That costs an owner nothing: you necessarily hold the
+     * owned reference already, since you called `.commands.register(...)` on it,
+     * so tear it down through that instead of through the context. Varying this
+     * by ownership would mean `SuperDocUI` and {@link BorrowedSuperDocUI} needing
+     * different `commands` handles, and the borrowed form is derived from the
+     * owned one precisely so the two cannot drift.
+     */
+    ui: BorrowedSuperDocUI;
     /** Run a catalog command id through the shared controller. */
     execute(id: string, payload?: unknown): CommandExecutionResult;
     /** Run a catalog command id and await its settled result. */
     executeAsync(id: string, payload?: unknown): Promise<CommandExecutionResult>;
-    /** Public browser Document API facade (read-only-guarded, async-capable), or `null` when unavailable. */
-    doc: Record<string, any> | null;
+    /**
+     * The host's browser Document API facade (read-only-guarded, async-capable),
+     * or `null` when unavailable.
+     *
+     * Partial for the same reason {@link SuperDocEditorLike.doc} is: this is the
+     * host's own object handed straight through, and a duck-typed host is only
+     * required to carry the operations it implements. Typing it as the complete
+     * facade would promise operations a custom adapter or stub never defines.
+     *
+     * Prefer {@link CustomCommandContext.execute}, `executeAsync`, and
+     * `insertText` where they cover the work: those route through the controller
+     * and fail closed with a reason or a receipt when an operation is missing.
+     * Reach for `doc` when you need an operation the controller does not route,
+     * and guard the call.
+     */
+    doc: PartialBrowserDocumentApi | null;
     /** Read-only selection snapshot at invocation time. */
     selection: SelectionSlice;
     /** Current document mode. */
@@ -1228,14 +1260,23 @@ export interface SearchHandle extends SnapshotSubscribable<SearchSlice> {
 export interface SuperDocEditorLike {
     /** Runtime evidence of the bundled v2 editor. */
     editorVersion?: number;
-    /** Public, read-only-guarded browser Document API facade (async-capable in browser). */
-    doc?: Record<string, any> | null;
+    /**
+     * Public, read-only-guarded browser Document API facade (async-capable in
+     * browser). Partial by design: this is what a host supplies, and a stub or
+     * custom adapter carries only the operations it implements.
+     *
+     * `CustomCommandContext.doc` is the same partial type, because the controller
+     * passes this object straight through and can promise no more than the host
+     * does. {@link BrowserDocumentApi}, the complete facade, is the type of
+     * `activeEditor.doc` on a real `Editor`.
+     */
+    doc?: PartialBrowserDocumentApi | null;
     /** Stable reason the Document API is unavailable. */
     documentApiUnavailableReason?: string | null;
     /** Editor-scoped event subscription. */
-    on?(event: string, handler: (...args: any[]) => void): unknown;
+    on?(event: string, handler: (...args: unknown[]) => void): unknown;
     /** Editor-scoped event unsubscription. */
-    off?(event: string, handler: (...args: any[]) => void): unknown;
+    off?(event: string, handler: (...args: unknown[]) => void): unknown;
     /** Export the active editor's document. */
     exportDocx?(...args: unknown[]): Promise<unknown>;
     /** Save the active editor's document. */
@@ -1251,10 +1292,19 @@ export interface SuperDocEditorLike {
 export interface SuperDocLike {
     /** The routed active editor, when one is mounted. */
     activeEditor?: SuperDocEditorLike | null;
+    /**
+     * The host-owned UI controller. A real `SuperDoc` instance always exposes
+     * one and owns its lifecycle; bare structural stubs may not, which is why
+     * this is optional. Consumers should read it rather than build their own.
+     *
+     * Borrowed, not owned: the host tears this down, so the type omits
+     * `destroy()` and a reader cannot call it.
+     */
+    ui?: BorrowedSuperDocUI;
     /** Lifecycle event subscription. */
-    on?(event: string, handler: (...args: any[]) => void): unknown;
+    on?(event: string, handler: (...args: unknown[]) => void): unknown;
     /** Lifecycle event unsubscription. */
-    off?(event: string, handler: (...args: any[]) => void): unknown;
+    off?(event: string, handler: (...args: unknown[]) => void): unknown;
     /** Set the document mode across the instance. */
     setDocumentMode?(mode: string): unknown;
     /** Export the active document. */
@@ -1351,6 +1401,25 @@ export interface SuperDocUI {
     readonly formatPainter: FormatPainterHandle;
     /** Create a disposable subscription scope. */
     createScope(): SuperDocUIScope;
-    /** Tear down all subscriptions and detach from the host. */
+    /**
+     * Tear down all subscriptions and detach from the host.
+     *
+     * Only the owner calls this. A controller obtained from `createSuperDocUI()`
+     * is owned by its caller. The one at `superdoc.ui` is owned by the instance
+     * and is typed {@link BorrowedSuperDocUI}, which does not carry this method.
+     */
     destroy(): void;
 }
+/**
+ * The controller as a *consumer* sees it: everything except `destroy()`.
+ *
+ * This is what `superdoc.ui` and the React hooks return. The instance owns that
+ * controller and tears it down in `superdoc.destroy()`, so a consumer calling
+ * `destroy()` would freeze command state for the built-in toolbar and every
+ * other reader of the same instance. Omitting the method makes that a compile
+ * error rather than a documented convention nobody reads.
+ *
+ * Derived from {@link SuperDocUI} rather than declared separately so the two
+ * cannot drift: every handle added there appears here automatically.
+ */
+export type BorrowedSuperDocUI = Omit<SuperDocUI, 'destroy'>;

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

@@ -1,9 +1,10 @@
 /**
  * SuperDoc public facade: `superdoc/ui/react` entry.
  *
- * v2-native React bindings for the `createSuperDocUI` controller: the
- * provider, the lifecycle bind hook, the generic slice hook, and the domain
- * hooks.
+ * v2-native React bindings for the SuperDoc-owned UI controller
+ * (`superdoc.ui`): the provider, the bind hook, the generic slice hook, and
+ * the domain hooks. This layer consumes the controller; SuperDoc creates and
+ * destroys it.
  *
  * v2 NOTE: this is NOT the v1 re-export. It routes through the local,
  * self-contained v2 React layer under `./ui/react.ts`, which is built on the

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

@@ -1,5 +1,7 @@
 // Generated by scripts/ensure-types.cjs. Do not edit by hand.
 import type { ActiveParagraphStyle as __Cjs_ActiveParagraphStyle } from './ui.js' with { "resolution-mode": "import" };
+import type { BorrowedSuperDocUI as __Cjs_BorrowedSuperDocUI } from './ui.js' with { "resolution-mode": "import" };
+import type { BrowserDocumentApi as __Cjs_BrowserDocumentApi } from './ui.js' with { "resolution-mode": "import" };
 import type { CommandExecutionResult as __Cjs_CommandExecutionResult } from './ui.js' with { "resolution-mode": "import" };
 import type { CommandHandle as __Cjs_CommandHandle } from './ui.js' with { "resolution-mode": "import" };
 import type { CommandsHandle as __Cjs_CommandsHandle } from './ui.js' with { "resolution-mode": "import" };
@@ -22,6 +24,7 @@ import type { CustomCommandHandle as __Cjs_CustomCommandHandle } from './ui.js'
 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" };
 import type { CustomCommandRegistrationResult as __Cjs_CustomCommandRegistrationResult } from './ui.js' with { "resolution-mode": "import" };
+import type { DocumentApi as __Cjs_DocumentApi } from './ui.js' with { "resolution-mode": "import" };
 import type { DocumentHandle as __Cjs_DocumentHandle } from './ui.js' with { "resolution-mode": "import" };
 import type { DocumentSlice as __Cjs_DocumentSlice } from './ui.js' with { "resolution-mode": "import" };
 import type { EntityAddress as __Cjs_EntityAddress } from './ui.js' with { "resolution-mode": "import" };
@@ -31,6 +34,7 @@ import type { FontsHandle as __Cjs_FontsHandle } from './ui.js' with { "resoluti
 import type { FontSizeOption as __Cjs_FontSizeOption } from './ui.js' with { "resolution-mode": "import" };
 import type { FontsSlice as __Cjs_FontsSlice } from './ui.js' with { "resolution-mode": "import" };
 import type { MetadataHandle as __Cjs_MetadataHandle } from './ui.js' with { "resolution-mode": "import" };
+import type { PartialBrowserDocumentApi as __Cjs_PartialBrowserDocumentApi } from './ui.js' with { "resolution-mode": "import" };
 import type { Receipt as __Cjs_Receipt } from './ui.js' with { "resolution-mode": "import" };
 import type { ScrollIntoViewInput as __Cjs_ScrollIntoViewInput } from './ui.js' with { "resolution-mode": "import" };
 import type { ScrollIntoViewOutput as __Cjs_ScrollIntoViewOutput } from './ui.js' with { "resolution-mode": "import" };
@@ -90,6 +94,8 @@ import type { WorkflowScrollResult as __Cjs_WorkflowScrollResult } from './ui.js
 import type { ZoomHandle as __Cjs_ZoomHandle } from './ui.js' with { "resolution-mode": "import" };
 import type { ZoomSlice as __Cjs_ZoomSlice } from './ui.js' with { "resolution-mode": "import" };
 export type { __Cjs_ActiveParagraphStyle as ActiveParagraphStyle };
+export type { __Cjs_BorrowedSuperDocUI as BorrowedSuperDocUI };
+export type { __Cjs_BrowserDocumentApi as BrowserDocumentApi };
 export declare const BUILT_IN_COMMAND_IDS: typeof import('./ui.js', { with: { "resolution-mode": "import" } }).BUILT_IN_COMMAND_IDS;
 export type { __Cjs_CommandExecutionResult as CommandExecutionResult };
 export type { __Cjs_CommandHandle as CommandHandle };
@@ -114,6 +120,7 @@ export type { __Cjs_CustomCommandHandle as CustomCommandHandle };
 export type { __Cjs_CustomCommandHandleState as CustomCommandHandleState };
 export type { __Cjs_CustomCommandRegistration as CustomCommandRegistration };
 export type { __Cjs_CustomCommandRegistrationResult as CustomCommandRegistrationResult };
+export type { __Cjs_DocumentApi as DocumentApi };
 export type { __Cjs_DocumentHandle as DocumentHandle };
 export type { __Cjs_DocumentSlice as DocumentSlice };
 export type { __Cjs_EntityAddress as EntityAddress };
@@ -123,6 +130,7 @@ export type { __Cjs_FontsHandle as FontsHandle };
 export type { __Cjs_FontSizeOption as FontSizeOption };
 export type { __Cjs_FontsSlice as FontsSlice };
 export type { __Cjs_MetadataHandle as MetadataHandle };
+export type { __Cjs_PartialBrowserDocumentApi as PartialBrowserDocumentApi };
 export type { __Cjs_Receipt as Receipt };
 export type { __Cjs_ScrollIntoViewInput as ScrollIntoViewInput };
 export type { __Cjs_ScrollIntoViewOutput as ScrollIntoViewOutput };

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, 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, 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, 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-DDxbK_M7.cjs");
+const require_create_super_doc_ui = require("./chunks/create-super-doc-ui-6FUZ9d-y.cjs");
 let vue = require("vue");
 vue = require_rolldown_runtime.__toESM(vue);
 require("y-websocket");
@@ -13807,6 +13807,7 @@ var _hoisted_1$16 = {
 var _hoisted_2$13 = ["innerHTML"];
 var _hoisted_3$10 = { class: "superdoc__document document" };
 var _hoisted_4$7 = { class: "floating-comments" };
+var UNAVAILABLE_COMMAND_RESULT = false;
 var V2_SELECTION_TOOLBAR_SYNC_RETRY_FRAMES = 3;
 var V2_TYPING_REVIEW_HYDRATION_IDLE_MS = 6500;
 var V2_TYPING_REVIEW_HYDRATION_CEILING_MS = 8e3;
@@ -13927,19 +13928,19 @@ var _sfc_main$20 = {
 		const v2GeometryEpoch = (0, vue.ref)(null);
 		let v2GeometryRafHandle = 0;
 		const activeEditorRef = (0, vue.computed)(() => proxy.$superdoc.activeEditor);
-		let linkPopoverUi = null;
+		const getSuperDocUI = () => proxy.$superdoc?.ui ?? null;
+		const UNAVAILABLE_COMMAND_STATE = Object.freeze({
+			enabled: false,
+			active: false,
+			supported: false
+		});
 		const findReplace = useFindReplace({
 			getSurfaceManager: () => surfaceManager,
 			getActiveEditor: () => proxy.$superdoc?.activeEditor,
 			activeEditorRef,
 			getFindReplaceConfig: () => proxy.$superdoc?.config?.modules?.surfaces?.findReplace,
-			getSuperDocUI: () => getLinkPopoverUi()
+			getSuperDocUI
 		});
-		const getLinkPopoverUi = () => {
-			if (proxy.$superdoc?.toolbar?.ui) return proxy.$superdoc.toolbar.ui;
-			if (!linkPopoverUi && proxy.$superdoc) linkPopoverUi = require_create_super_doc_ui.createSuperDocUI({ superdoc: proxy.$superdoc });
-			return linkPopoverUi;
-		};
 		const getLinkPopoverSurfaceManager = () => {
 			if (surfaceManager) return surfaceManager;
 			if (typeof proxy.$superdoc?.openSurface !== "function") return null;
@@ -13948,7 +13949,7 @@ var _sfc_main$20 = {
 		const linkPopover = useLinkPopover({
 			getSurfaceManager: getLinkPopoverSurfaceManager,
 			getActiveEditor: () => proxy.$superdoc?.activeEditor,
-			getUi: getLinkPopoverUi,
+			getUi: getSuperDocUI,
 			getResolver: () => proxy.$superdoc?.config?.modules?.links?.popoverResolver,
 			getLayerElement: () => layers.value,
 			emitException: (payload) => {
@@ -14019,11 +14020,6 @@ var _sfc_main$20 = {
 			} catch (err) {
 				console.warn("[SuperDoc] v2 command-shortcut unbind failed", err);
 			}
-			try {
-				entry.ui?.destroy?.();
-			} catch (err) {
-				console.warn("[SuperDoc] v2 command-shortcut UI teardown failed", err);
-			}
 		};
 		const resolveV2LinkWorkflowOpener = () => {
 			const toolbar = proxy.$superdoc?.toolbar;
@@ -14039,20 +14035,19 @@ var _sfc_main$20 = {
 			if (!documentId) return;
 			clearV2CommandShortcutBinding(documentId);
 			if (typeof bindEditShortcuts !== "function") return;
-			const fallbackUi = require_create_super_doc_ui.createSuperDocUI({ superdoc: proxy.$superdoc });
-			const resolveUi = () => proxy.$superdoc?.toolbar?.ui ?? fallbackUi;
 			const openLinkWorkflow = resolveV2LinkWorkflowOpener();
 			const unbind = bindEditShortcuts({
 				commandRoute: {
-					executeAsync: (commandId, payload) => resolveUi().commands.executeAsync(commandId, payload),
-					getState: (commandId) => resolveUi().commands.get(commandId).getState()
+					executeAsync: (commandId, payload) => {
+						const ui = getSuperDocUI();
+						if (!ui) return Promise.resolve(UNAVAILABLE_COMMAND_RESULT);
+						return ui.commands.executeAsync(commandId, payload);
+					},
+					getState: (commandId) => getSuperDocUI()?.commands.get(commandId).getState() ?? UNAVAILABLE_COMMAND_STATE
 				},
 				...openLinkWorkflow ? { openLinkWorkflow } : {}
 			});
-			v2CommandShortcutBindings.set(documentId, {
-				unbind,
-				ui: fallbackUi
-			});
+			v2CommandShortcutBindings.set(documentId, { unbind });
 		};
 		const clearV2SessionShortcutBinding = (documentId) => {
 			const entry = v2SessionShortcutBindings.get(documentId);
@@ -15604,8 +15599,6 @@ var _sfc_main$20 = {
 			passwordPrompt.destroy();
 			findReplace.destroy();
 			linkPopover.destroy();
-			linkPopoverUi?.destroy?.();
-			linkPopoverUi = null;
 			cancelScheduledV2DomSelectionSync();
 			cancelScheduledV2SelectionToolbarSync();
 			for (const documentId of Array.from(v2Runtimes.keys())) clearV2RuntimeRegistration(documentId);
@@ -16122,7 +16115,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-91c4cd11"]]);
+var SuperDoc_default = /* @__PURE__ */ require__plugin_vue_export_helper.__plugin_vue_export_helper_default(_sfc_main$20, [["__scopeId", "data-v-41f40a40"]]);
 var PINIA_DEVTOOLS_SETUP_EVENT = "devtools-plugin:setup";
 var PINIA_DEVTOOLS_PLUGIN_ID = "dev.esm.pinia";
 var piniaDevtoolsSuppressionState = {
@@ -33930,24 +33923,31 @@ var BuiltInToolbar = class extends require_eventemitter3.import_eventemitter3.de
 			const uiFontFamily = (this.config?.uiDisplayFallbackFont || "").toString().trim() || "Arial, Helvetica, sans-serif";
 			this.toolbarContainer.style.setProperty("--sd-ui-font-family", uiFontFamily);
 		}
-		this.#initController();
-		this.#initToolbarGroups();
-		this.#makeToolbarItems();
-		this.#bindHostEvents();
-		this._lastFontOptionsSignature = this.#fontOptionsSignature();
-		if (!this.toolbarContainer) {
+		try {
+			this.#initController();
+			this.#initToolbarGroups();
+			this.#makeToolbarItems();
+			this.#bindHostEvents();
+			this._lastFontOptionsSignature = this.#fontOptionsSignature();
+			if (!this.toolbarContainer) {
+				this.updateToolbarState();
+				return;
+			}
+			this.app = (0, vue.createApp)(Toolbar_default);
+			this.app.directive("click-outside", v_click_outside_default);
+			this.app.config.globalProperties.$toolbar = this;
+			this.toolbar = this.app.mount(this.toolbarContainer);
 			this.updateToolbarState();
-			return;
+		} catch (error) {
+			try {
+				this.destroy();
+			} catch {}
+			throw error;
 		}
-		this.app = (0, vue.createApp)(Toolbar_default);
-		this.app.directive("click-outside", v_click_outside_default);
-		this.app.config.globalProperties.$toolbar = this;
-		this.toolbar = this.app.mount(this.toolbarContainer);
-		this.updateToolbarState();
 	}
 	#initController() {
-		if (!this.superdoc) return;
-		this.ui = require_create_super_doc_ui.createSuperDocUI({ superdoc: this.superdoc });
+		this.ui = this.superdoc?.ui ?? null;
+		if (!this.ui) return;
 		this.snapshot = this.ui.toolbar.getSnapshot();
 		this._unsubscribeController = this.ui.toolbar.subscribe(() => {
 			this.snapshot = this.ui.toolbar.getSnapshot();
@@ -33968,9 +33968,6 @@ var BuiltInToolbar = class extends require_eventemitter3.import_eventemitter3.de
 			reg.unregister?.();
 		} catch {}
 		this._customCommandRegs.clear();
-		try {
-			this.ui?.destroy?.();
-		} catch {}
 		this.ui = null;
 		this.snapshot = null;
 	}
@@ -34591,6 +34588,7 @@ var SuperDoc = class extends require_eventemitter3.import_eventemitter3.default
 	#v2LockUnsub = null;
 	#pendingV2LockSeed = null;
 	#mountWrapper = null;
+	#ui = null;
 	#surfaceManager;
 	#editorRuntimeRegistry = new EditorRuntimeRegistry();
 	#editorRuntimeRegistryUnsub = null;
@@ -34697,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.45";
+		this.version = "2.0.0-next.46";
 		this.#log("🦋 [superdoc] Using SuperDoc version:", this.version);
 		this.superdocId = config.superdocId || require_uuid.v4_default();
 		this.colors = this.config.colors ?? [];
@@ -34749,6 +34747,13 @@ var SuperDoc = class extends require_eventemitter3.import_eventemitter3.default
 	get requiredNumberOfEditors() {
 		return this.#requireSuperdocStore("requiredNumberOfEditors").documents.filter((d) => d.type === DOCX).length;
 	}
+	get ui() {
+		if (!this.#ui) {
+			this.#ui = require_create_super_doc_ui.createSuperDocUI({ superdoc: this });
+			if (this.#destroyed) this.#ui.destroy();
+		}
+		return this.#ui;
+	}
 	get state() {
 		return {
 			documents: this.#requireSuperdocStore("state").documents,
@@ -35456,10 +35461,12 @@ var SuperDoc = class extends require_eventemitter3.import_eventemitter3.default
 		return this.#fontsApi;
 	}
 	#clearActiveEditorProjection() {
+		const hadActiveEditor = this.activeEditor !== null;
 		this.#teardownV2FontsRelay();
 		this.activeEditor = null;
 		if (this.toolbar?.setActiveEditor) this.toolbar.setActiveEditor(null);
 		else if (this.toolbar) this.toolbar.activeEditor = null;
+		if (hadActiveEditor) this.emit("active-editor-change");
 	}
 	#v2FontsUnsub = null;
 	#teardownV2FontsRelay() {
@@ -35494,9 +35501,11 @@ var SuperDoc = class extends require_eventemitter3.import_eventemitter3.default
 	#setActiveEditorCompatibilityProjection(editor) {
 		if (isV2ActiveEditorFacade(editor)) {
 			if (!this.#applyingRuntimeActiveChange && this.#editorRuntimeRegistry.getActive()) this.#editorRuntimeRegistry.setActive(null, "set-active-v2-facade");
+			const previous = this.activeEditor;
 			this.activeEditor = editor;
 			this.#wireV2FontsRelay(editor);
 			this.toolbar?.setActiveEditor?.(editor);
+			if (previous !== this.activeEditor) this.emit("active-editor-change");
 			return;
 		}
 		this.#clearActiveEditorProjection();
@@ -36215,6 +36224,7 @@ var SuperDoc = class extends require_eventemitter3.import_eventemitter3.default
 			delete this.app.config.globalProperties.$config;
 			delete this.app.config.globalProperties.$superdoc;
 		}
+		this.#ui?.destroy();
 		this.#cleanupCollaboration();
 		this.#editorRuntimeRegistryUnsub?.();
 		this.#editorRuntimeRegistryUnsub = null;