superdoc 2.0.0-next.44 → 2.0.0-next.46

package/dist/public/ui-react.cjs

@@ -1,27 +1,30 @@
 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-DYky1UEo.cjs");
+const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-6FUZ9d-y.cjs");
 let react = require("react");
 var SuperDocUIContext = (0, react.createContext)(null);
+function disposeOwnedUi(ref) {
+	const ui = ref.current;
+	if (!ui) return;
+	ui.destroy();
+	ref.current = null;
+}
 function SuperDocUIProvider(props) {
 	const [ui, setUi] = (0, react.useState)(null);
 	const [host, setHost] = (0, react.useState)(null);
-	const uiRef = (0, react.useRef)(null);
+	const ownedUiRef = (0, react.useRef)(null);
 	const setSuperDoc = (0, react.useCallback)((superdoc) => {
-		if (uiRef.current) uiRef.current.destroy();
-		const next = require_create_super_doc_ui.createSuperDocUI({ superdoc });
-		uiRef.current = next;
-		setUi(next);
+		const hostUi = superdoc.ui;
+		disposeOwnedUi(ownedUiRef);
+		if (hostUi) setUi(hostUi);
+		else {
+			const created = require_create_super_doc_ui.createSuperDocUI({ superdoc });
+			ownedUiRef.current = created;
+			setUi(created);
+		}
 		setHost(superdoc);
 	}, []);
-	(0, react.useEffect)(() => {
-		return () => {
-			if (uiRef.current) {
-				uiRef.current.destroy();
-				uiRef.current = null;
-			}
-		};
-	}, []);
+	(0, react.useEffect)(() => () => disposeOwnedUi(ownedUiRef), []);
 	const value = {
 		ui,
 		host,

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

@@ -1,25 +1,28 @@
-import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-BFz0iim0.es.js";
+import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-DCFTmVRK.es.js";
 import { createContext, createElement, useCallback, useContext, useEffect, useRef, useState } from "react";
 var SuperDocUIContext = createContext(null);
+function disposeOwnedUi(ref) {
+	const ui = ref.current;
+	if (!ui) return;
+	ui.destroy();
+	ref.current = null;
+}
 function SuperDocUIProvider(props) {
 	const [ui, setUi] = useState(null);
 	const [host, setHost] = useState(null);
-	const uiRef = useRef(null);
+	const ownedUiRef = useRef(null);
 	const setSuperDoc = useCallback((superdoc) => {
-		if (uiRef.current) uiRef.current.destroy();
-		const next = createSuperDocUI({ superdoc });
-		uiRef.current = next;
-		setUi(next);
+		const hostUi = superdoc.ui;
+		disposeOwnedUi(ownedUiRef);
+		if (hostUi) setUi(hostUi);
+		else {
+			const created = createSuperDocUI({ superdoc });
+			ownedUiRef.current = created;
+			setUi(created);
+		}
 		setHost(superdoc);
 	}, []);
-	useEffect(() => {
-		return () => {
-			if (uiRef.current) {
-				uiRef.current.destroy();
-				uiRef.current = null;
-			}
-		};
-	}, []);
+	useEffect(() => () => disposeOwnedUi(ownedUiRef), []);
 	const value = {
 		ui,
 		host,

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

package/dist/style.css

@@ -1368,28 +1368,28 @@ img[data-v-c95b2073] {
   background-color: #1355ff7f;
 }
 
-.comment-placeholder[data-v-7f4821a8] {
+.comment-placeholder[data-v-a1bd2282] {
   position: absolute;
   width: 300px;
   transition: top 0.3s ease;
 }
-.comment-placeholder.is-direct-decision-continuity-target[data-v-7f4821a8] .overflow-menu {
+.comment-placeholder.is-direct-decision-continuity-target[data-v-a1bd2282] .overflow-menu {
   opacity: 1;
   pointer-events: auto;
 }
-.floating-comment[data-v-7f4821a8] {
+.floating-comment[data-v-a1bd2282] {
   position: relative;
   display: block;
   min-width: 300px;
 }
-.sidebar-container[data-v-7f4821a8] {
+.sidebar-container[data-v-a1bd2282] {
   position: absolute;
   width: 300px;
   min-height: 300px;
   transition: transform 0.3s ease;
   will-change: transform;
 }
-.section-wrapper[data-v-7f4821a8] {
+.section-wrapper[data-v-a1bd2282] {
   position: relative;
   min-height: 100%;
   width: 300px;
@@ -1727,11 +1727,11 @@ img[data-v-c95b2073] {
   pointer-events: auto;
 }
 
-.superdoc[data-v-91c4cd11] {
+.superdoc[data-v-41f40a40] {
   display: flex;
   position: relative;
 }
-.sd-visually-hidden[data-v-91c4cd11] {
+.sd-visually-hidden[data-v-41f40a40] {
   position: absolute;
   width: 1px;
   height: 1px;
@@ -1742,30 +1742,30 @@ img[data-v-c95b2073] {
   white-space: nowrap;
   border: 0;
 }
-.right-sidebar[data-v-91c4cd11] {
+.right-sidebar[data-v-41f40a40] {
   min-width: 320px;
   height: 100%;
 }
-.floating-comments[data-v-91c4cd11] {
+.floating-comments[data-v-41f40a40] {
   min-width: 300px;
   width: 300px;
   height: 100%;
   overflow: visible;
 }
-.superdoc__layers[data-v-91c4cd11] {
+.superdoc__layers[data-v-41f40a40] {
   height: 100%;
   position: relative;
   box-sizing: border-box;
 }
-.superdoc__document[data-v-91c4cd11] {
+.superdoc__document[data-v-41f40a40] {
   width: 100%;
   position: relative;
 }
-.superdoc__sub-document[data-v-91c4cd11] {
+.superdoc__sub-document[data-v-41f40a40] {
   width: 100%;
   position: relative;
 }
-.superdoc__selection-layer[data-v-91c4cd11] {
+.superdoc__selection-layer[data-v-41f40a40] {
   position: absolute;
   min-width: 100%;
   min-height: 100%;
@@ -1776,13 +1776,13 @@ img[data-v-c95b2073] {
 /* SD-3497: PDF whiteboard overlay sits above the rendered PDF canvas but below
    the PDF comment anchors (z-index 6 in PdfCommentsLayer) so anchors stay
    clickable, and below the selection layer (z-index 10). */
-.superdoc__whiteboard-layer[data-v-91c4cd11] {
+.superdoc__whiteboard-layer[data-v-41f40a40] {
   z-index: 4;
 }
-.superdoc__temp-selection[data-v-91c4cd11] {
+.superdoc__temp-selection[data-v-41f40a40] {
   position: absolute;
 }
-.superdoc__right-sidebar[data-v-91c4cd11] {
+.superdoc__right-sidebar[data-v-41f40a40] {
   width: 320px;
   min-width: 320px;
   padding: 0 10px;
@@ -1790,7 +1790,7 @@ img[data-v-c95b2073] {
   position: relative;
   z-index: 2;
 }
-.superdoc__compact-comment-popover[data-v-91c4cd11] {
+.superdoc__compact-comment-popover[data-v-41f40a40] {
   position: absolute;
   top: 12px;
   right: 12px;
@@ -1799,14 +1799,14 @@ img[data-v-c95b2073] {
 }
 
 /* Tools styles */
-.tools[data-v-91c4cd11] {
+.tools[data-v-41f40a40] {
   position: absolute;
   z-index: 3;
   display: flex;
   flex-direction: column;
   gap: var(--sd-ui-tools-gap, 6px);
 }
-.tools-item[data-v-91c4cd11] {
+.tools-item[data-v-41f40a40] {
   display: flex;
   align-items: center;
   justify-content: center;
@@ -1817,10 +1817,10 @@ img[data-v-c95b2073] {
   cursor: pointer;
   position: relative;
 }
-.tools-item i[data-v-91c4cd11] {
+.tools-item i[data-v-41f40a40] {
   cursor: pointer;
 }
-.superdoc__tools-icon[data-v-91c4cd11] {
+.superdoc__tools-icon[data-v-41f40a40] {
   width: var(--sd-ui-tools-icon-size, 20px);
   height: var(--sd-ui-tools-icon-size, 20px);
   flex-shrink: 0;
@@ -1835,22 +1835,22 @@ img[data-v-c95b2073] {
 
 /* 834px is iPad screen size in portrait orientation */
 @media (max-width: 834px) {
-.superdoc .superdoc__layers[data-v-91c4cd11] {
+.superdoc .superdoc__layers[data-v-41f40a40] {
     margin: 0;
     border: 0 !important;
     box-shadow: none;
 }
-.superdoc__sub-document[data-v-91c4cd11] {
+.superdoc__sub-document[data-v-41f40a40] {
     max-width: 100%;
 }
-.superdoc__right-sidebar[data-v-91c4cd11] {
+.superdoc__right-sidebar[data-v-41f40a40] {
     padding: 10px;
     position: relative;
 }
 }
 
 /* AI Writer styles */
-.ai-writer-container[data-v-91c4cd11] {
+.ai-writer-container[data-v-41f40a40] {
   position: fixed;
   z-index: 1000;
   background: white;
@@ -1866,10 +1866,10 @@ img[data-v-c95b2073] {
   transform: translateY(-50%);
   z-index: 50;
 } */
-.ai-tool > svg[data-v-91c4cd11] {
+.ai-tool > svg[data-v-41f40a40] {
   fill: transparent;
 }
-.ai-tool[data-v-91c4cd11]::before {
+.ai-tool[data-v-41f40a40]::before {
   content: '';
   position: absolute;
   width: 20px;
@@ -1890,7 +1890,7 @@ img[data-v-c95b2073] {
   filter: brightness(1.2);
   transition: filter 0.2s ease;
 }
-.ai-tool[data-v-91c4cd11]:hover::before {
+.ai-tool[data-v-41f40a40]:hover::before {
   filter: brightness(1.3);
 }
 

package/dist/style.layered.css

@@ -1368,28 +1368,28 @@ img[data-v-c95b2073] {
   background-color: #1355ff7f;
 }
 
-.comment-placeholder[data-v-7f4821a8] {
+.comment-placeholder[data-v-a1bd2282] {
   position: absolute;
   width: 300px;
   transition: top 0.3s ease;
 }
-.comment-placeholder.is-direct-decision-continuity-target[data-v-7f4821a8] .overflow-menu {
+.comment-placeholder.is-direct-decision-continuity-target[data-v-a1bd2282] .overflow-menu {
   opacity: 1;
   pointer-events: auto;
 }
-.floating-comment[data-v-7f4821a8] {
+.floating-comment[data-v-a1bd2282] {
   position: relative;
   display: block;
   min-width: 300px;
 }
-.sidebar-container[data-v-7f4821a8] {
+.sidebar-container[data-v-a1bd2282] {
   position: absolute;
   width: 300px;
   min-height: 300px;
   transition: transform 0.3s ease;
   will-change: transform;
 }
-.section-wrapper[data-v-7f4821a8] {
+.section-wrapper[data-v-a1bd2282] {
   position: relative;
   min-height: 100%;
   width: 300px;
@@ -1727,11 +1727,11 @@ img[data-v-c95b2073] {
   pointer-events: auto;
 }
 
-.superdoc[data-v-91c4cd11] {
+.superdoc[data-v-41f40a40] {
   display: flex;
   position: relative;
 }
-.sd-visually-hidden[data-v-91c4cd11] {
+.sd-visually-hidden[data-v-41f40a40] {
   position: absolute;
   width: 1px;
   height: 1px;
@@ -1742,30 +1742,30 @@ img[data-v-c95b2073] {
   white-space: nowrap;
   border: 0;
 }
-.right-sidebar[data-v-91c4cd11] {
+.right-sidebar[data-v-41f40a40] {
   min-width: 320px;
   height: 100%;
 }
-.floating-comments[data-v-91c4cd11] {
+.floating-comments[data-v-41f40a40] {
   min-width: 300px;
   width: 300px;
   height: 100%;
   overflow: visible;
 }
-.superdoc__layers[data-v-91c4cd11] {
+.superdoc__layers[data-v-41f40a40] {
   height: 100%;
   position: relative;
   box-sizing: border-box;
 }
-.superdoc__document[data-v-91c4cd11] {
+.superdoc__document[data-v-41f40a40] {
   width: 100%;
   position: relative;
 }
-.superdoc__sub-document[data-v-91c4cd11] {
+.superdoc__sub-document[data-v-41f40a40] {
   width: 100%;
   position: relative;
 }
-.superdoc__selection-layer[data-v-91c4cd11] {
+.superdoc__selection-layer[data-v-41f40a40] {
   position: absolute;
   min-width: 100%;
   min-height: 100%;
@@ -1776,13 +1776,13 @@ img[data-v-c95b2073] {
 /* SD-3497: PDF whiteboard overlay sits above the rendered PDF canvas but below
    the PDF comment anchors (z-index 6 in PdfCommentsLayer) so anchors stay
    clickable, and below the selection layer (z-index 10). */
-.superdoc__whiteboard-layer[data-v-91c4cd11] {
+.superdoc__whiteboard-layer[data-v-41f40a40] {
   z-index: 4;
 }
-.superdoc__temp-selection[data-v-91c4cd11] {
+.superdoc__temp-selection[data-v-41f40a40] {
   position: absolute;
 }
-.superdoc__right-sidebar[data-v-91c4cd11] {
+.superdoc__right-sidebar[data-v-41f40a40] {
   width: 320px;
   min-width: 320px;
   padding: 0 10px;
@@ -1790,7 +1790,7 @@ img[data-v-c95b2073] {
   position: relative;
   z-index: 2;
 }
-.superdoc__compact-comment-popover[data-v-91c4cd11] {
+.superdoc__compact-comment-popover[data-v-41f40a40] {
   position: absolute;
   top: 12px;
   right: 12px;
@@ -1799,14 +1799,14 @@ img[data-v-c95b2073] {
 }
 
 /* Tools styles */
-.tools[data-v-91c4cd11] {
+.tools[data-v-41f40a40] {
   position: absolute;
   z-index: 3;
   display: flex;
   flex-direction: column;
   gap: var(--sd-ui-tools-gap, 6px);
 }
-.tools-item[data-v-91c4cd11] {
+.tools-item[data-v-41f40a40] {
   display: flex;
   align-items: center;
   justify-content: center;
@@ -1817,10 +1817,10 @@ img[data-v-c95b2073] {
   cursor: pointer;
   position: relative;
 }
-.tools-item i[data-v-91c4cd11] {
+.tools-item i[data-v-41f40a40] {
   cursor: pointer;
 }
-.superdoc__tools-icon[data-v-91c4cd11] {
+.superdoc__tools-icon[data-v-41f40a40] {
   width: var(--sd-ui-tools-icon-size, 20px);
   height: var(--sd-ui-tools-icon-size, 20px);
   flex-shrink: 0;
@@ -1835,22 +1835,22 @@ img[data-v-c95b2073] {
 
 /* 834px is iPad screen size in portrait orientation */
 @media (max-width: 834px) {
-.superdoc .superdoc__layers[data-v-91c4cd11] {
+.superdoc .superdoc__layers[data-v-41f40a40] {
     margin: 0;
     border: 0 !important;
     box-shadow: none;
 }
-.superdoc__sub-document[data-v-91c4cd11] {
+.superdoc__sub-document[data-v-41f40a40] {
     max-width: 100%;
 }
-.superdoc__right-sidebar[data-v-91c4cd11] {
+.superdoc__right-sidebar[data-v-41f40a40] {
     padding: 10px;
     position: relative;
 }
 }
 
 /* AI Writer styles */
-.ai-writer-container[data-v-91c4cd11] {
+.ai-writer-container[data-v-41f40a40] {
   position: fixed;
   z-index: 1000;
   background: white;
@@ -1866,10 +1866,10 @@ img[data-v-c95b2073] {
   transform: translateY(-50%);
   z-index: 50;
 } */
-.ai-tool > svg[data-v-91c4cd11] {
+.ai-tool > svg[data-v-41f40a40] {
   fill: transparent;
 }
-.ai-tool[data-v-91c4cd11]::before {
+.ai-tool[data-v-41f40a40]::before {
   content: '';
   position: absolute;
   width: 20px;
@@ -1890,7 +1890,7 @@ img[data-v-c95b2073] {
   filter: brightness(1.2);
   transition: filter 0.2s ease;
 }
-.ai-tool[data-v-91c4cd11]:hover::before {
+.ai-tool[data-v-41f40a40]:hover::before {
   filter: brightness(1.3);
 }
 

package/dist/superdoc/src/components/surfaces/FindReplaceSurface.vue.d.ts

@@ -1,15 +1,15 @@
 declare const _default: import('vue').DefineComponent<{}, {
     close: Function;
     resolve: Function;
-    mode: string;
     request: Record<string, any>;
+    mode: string;
     surfaceId: string;
     findReplace: Record<string, any>;
     $props: {
         readonly close?: Function | undefined;
         readonly resolve?: Function | undefined;
-        readonly mode?: string | undefined;
         readonly request?: Record<string, any> | undefined;
+        readonly mode?: string | undefined;
         readonly surfaceId?: string | undefined;
         readonly findReplace?: Record<string, any> | undefined;
     };

package/dist/superdoc/src/components/surfaces/PasswordPromptSurface.vue.d.ts

@@ -1,15 +1,15 @@
 declare const _default: import('vue').DefineComponent<{}, {
     close: Function;
     resolve: Function;
-    mode: string;
     request: Record<string, any>;
+    mode: string;
     surfaceId: string;
     passwordPrompt: Record<string, any>;
     $props: {
         readonly close?: Function | undefined;
         readonly resolve?: Function | undefined;
-        readonly mode?: string | undefined;
         readonly request?: Record<string, any> | undefined;
+        readonly mode?: string | undefined;
         readonly surfaceId?: string | undefined;
         readonly passwordPrompt?: Record<string, any> | undefined;
     };

package/dist/superdoc/src/components/surfaces/SurfaceExternalMount.vue.d.ts

@@ -1,15 +1,15 @@
 declare const _default: import('vue').DefineComponent<{}, {
     close: Function;
     resolve: Function;
-    mode: string;
     request: Record<string, any>;
+    mode: string;
     render: Function;
     surfaceId: string;
     $props: {
         readonly close?: Function | undefined;
         readonly resolve?: Function | undefined;
-        readonly mode?: string | undefined;
         readonly request?: Record<string, any> | undefined;
+        readonly mode?: string | undefined;
         readonly render?: Function | undefined;
         readonly surfaceId?: string | undefined;
     };

package/dist/superdoc/src/composables/use-find-replace.d.ts

@@ -10,8 +10,8 @@
  * @param {() => SearchEditor | null} options.getActiveEditor
  * @param {import('vue').Ref} [options.activeEditorRef] - Reactive ref to the active editor (for watching switches)
  * @param {() => boolean | FindReplaceConfig | undefined} [options.getFindReplaceConfig] - Config getter
- * @param {() => { search?: any } | null | undefined} [options.getSuperDocUI] - V2 UI controller getter
- *   (`createSuperDocUI({ superdoc })`). Its `.search` slice is the single V2
+ * @param {() => { search?: any } | null | undefined} [options.getSuperDocUI] - Getter for the
+ *   SuperDoc-owned UI controller (`superdoc.ui`). Its `.search` slice is the single V2
  *   find/replace session authority; the V2 driver never touches `editor.commands`.
  */
 export function useFindReplace({ getSurfaceManager, getActiveEditor, activeEditorRef, getFindReplaceConfig, getSuperDocUI, }: {

package/dist/superdoc/src/core/SuperDoc.d.ts

@@ -3,6 +3,7 @@ import { HocuspocusProviderWebsocket } from '@hocuspocus/provider';
 import { createSuperdocVueApp } from './create-app.js';
 import { Whiteboard } from './whiteboard/Whiteboard.js';
 import { EditorRuntimeFocusOptions } from './editor-runtime/types.js';
+import { BorrowedSuperDocUI } from '../public/ui/types.js';
 import { AwarenessUser, CanPerformPermissionParams, CollaborationProvider, Config, ContentControlActiveChangePayload, ContentControlClickPayload, DocumentMode, Editor, EditorUpdateEvent, ExportParams, FontsChangedPayload, FontsResolvedPayload, InternalConfig, ListDefinitionsPayload, NavigableAddress, DocumentRendererRuntime, SearchMatch, SuperDocAwarenessUpdatePayload, SuperDocCommentsUpdatePayload, SuperDocEditorPayload, SuperDocExceptionPayload, SuperDocFontsApi, SuperDocLockedPayload, SuperDocMeasurementUnit, SuperDocMeasurementUnitChangePayload, SuperDocReadyPayload, SuperDocState, SuperDocViewportChangePayload, SuperDocViewportMetrics, SuperDocZoomMode, SuperDocZoomPayload, SuperDocZoomState, SurfaceHandle, SurfaceRequest, UpgradeToCollaborationOptions, User } from './types/index.js';
 import { WhiteboardData } from './whiteboard/Whiteboard.js';
 type ToolbarLike = {
@@ -53,6 +54,13 @@ interface SuperDocEventMap {
     'measurement-unit-change': [SuperDocMeasurementUnitChangePayload];
     'formatting-marks-change': [SuperDocFormattingMarksPayload];
     'document-mode-change': [SuperDocDocumentModeChangePayload];
+    /**
+     * The active editor was assigned or cleared. Internal: the UI controller
+     * listens so its snapshot follows the live editor. `editorCreate` only
+     * covers assignment, and it is emitted after `broadcastReady()`, so
+     * neither a pre-ready read nor a clear would refresh without this.
+     */
+    'active-editor-change': [];
     'editor-update': [EditorUpdateEvent];
     'content-error': [SuperDocContentErrorPayload];
     'fonts-resolved': [FontsResolvedPayload];
@@ -231,6 +239,39 @@ export declare class SuperDoc extends EventEmitter<SuperDocEventMap> {
      * @returns The number of required editors
      */
     get requiredNumberOfEditors(): number;
+    /**
+     * The UI controller for this instance: the single place to read command
+     * state and drive comments, track changes, selection, zoom, and the other
+     * UI surfaces from application code.
+     *
+     * SuperDoc owns exactly one controller per instance. Every internal
+     * consumer — the built-in toolbar, the link popover, keyboard command
+     * routing, and the React bindings — reads this same object, so command
+     * state never diverges between built-in and custom UI. The controller is
+     * created by the first read and its identity never changes afterwards:
+     * replacing the document, remounting an editor, or switching the active
+     * editor in a multi-document instance all keep the same controller.
+     *
+     * Reading it is safe before the document is ready. Slices report a `pending`
+     * status and commands report themselves disabled instead of throwing, so a
+     * custom UI can subscribe in the same tick as the constructor and will start
+     * receiving real values once an editor mounts.
+     *
+     * `SuperDoc.destroy()` destroys the controller. The returned type is
+     * {@link BorrowedSuperDocUI}, which omits `destroy()`, so a consumer tearing
+     * down state that other readers of this instance still observe is a compile
+     * error rather than a rule in a comment. The instance keeps the owning
+     * reference privately.
+     *
+     * This is an observation and command surface, not a permission boundary.
+     * Anything it exposes is reachable by the page that hosts SuperDoc.
+     *
+     * @example
+     * const superdoc = new SuperDoc({ selector: '#editor', document: file });
+     * const stop = superdoc.ui.comments.observe((comments) => render(comments));
+     * superdoc.ui.commands.get('bold').getState(); // { enabled, active, ... }
+     */
+    get ui(): BorrowedSuperDocUI;
     /**
      * Snapshot of the current SuperDoc state. Always reflects the most
      * recent values from the Pinia store; consumers must re-read on