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

package/dist/style.css

@@ -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

@@ -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

package/dist/superdoc/src/core/types/index.d.ts

@@ -1,25 +1,13 @@
 import { Doc as YDoc } from 'yjs';
 import { HocuspocusProviderWebsocket } from '@hocuspocus/provider';
 import { Ref, ComputedRef } from 'vue';
-import { DocumentApi } from '../../../../document-api/src/index.js';
 import { DocumentFontOption, FontAssetUrlResolver, FontFamilyOption, FontLoadSummary, FontResolutionRecord } from '../../../../shared/font-system/src/index.js';
 import { SuperDoc as SuperDocClass } from '../SuperDoc.js';
 import { SuperDocActiveEditorExtensions, SuperDocExtension } from '../extensions/index.js';
+import { BrowserDocumentApi } from '../../public/browser-document-api.js';
 export type { DocumentFontOption, FontAssetUrlContext, FontAssetUrlResolver, FontFaceSlot, FontFamilyOption, FontLoadResult, FontLoadStatus, FontLoadSummary, FontResolutionReason, FontResolutionRecord, GlyphException, ResolvedFontEvidence, SubstitutePolicyAction, SubstituteVerdict, } from '../../../../shared/font-system/src/index.js';
 export type SuperDoc = SuperDocClass;
-type MaybePromise<T> = T | Promise<T>;
-type BrowserDocumentApiObject<T> = {
-    [K in keyof T]: BrowserDocumentApiValue<T[K]>;
-};
-type BrowserDocumentApiValue<T> = T extends (...args: infer Args) => infer Return ? ((...args: Args) => MaybePromise<Awaited<Return>>) & BrowserDocumentApiObject<T> : T extends object ? BrowserDocumentApiObject<T> : T;
-/**
- * Browser V2 active-editor Document API facade (`superdoc.activeEditor.doc`).
- * In the browser this surface is intentionally async-capable: callers must
- * tolerate promise-returning reads/writes, including the default
- * worker-backed runtime. SDK/headless callers should continue using the
- * synchronous `@superdoc/document-api` surface directly.
- */
-export type BrowserDocumentApi = BrowserDocumentApiObject<DocumentApi>;
+export type { BrowserDocumentApi } from '../../public/browser-document-api.js';
 export type V2AuthoringSelectionCollapse = 'start' | 'end' | null;
 export type V2AuthoringResult = {
     ok: true;

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

@@ -177,14 +177,14 @@ export class BuiltInToolbar extends EventEmitter<string | symbol, any> {
     _detachFontsChanged: null;
     /** Active editor compatibility reference (set by `SuperDoc.setActiveEditor`). */
     activeEditor: any;
-    /** Live shared command controller (single command-state truth). */
-    ui: import('../../public/ui.js').SuperDocUI | null;
+    /** SuperDoc-owned command controller (single command-state truth). */
+    ui: any;
     /** Latest controller toolbar snapshot. */
-    snapshot: import('../../public/ui.js').ToolbarSnapshotSlice | null;
+    snapshot: any;
     /** Controller subscription unsubscribe handle. */
-    _unsubscribeController: (() => void) | null;
+    _unsubscribeController: any;
     /** Format-painter mode subscription unsubscribe handle. */
-    _detachFormatPainterModeChange: (() => void) | null;
+    _detachFormatPainterModeChange: any;
     /** Registered custom-button command unregister handles. */
     _customCommandRegs: Map<any, any>;
     /** Signature of the last-built font options, to skip redundant rebuilds. */

package/dist/superdoc/src/public/browser-document-api.d.ts

@@ -0,0 +1,53 @@
+import { DocumentApi } from '../../../document-api/src/index.js';
+type MaybePromise<T> = T | Promise<T>;
+type BrowserDocumentApiObject<T> = {
+    [K in keyof T]: BrowserDocumentApiValue<T[K]>;
+};
+type BrowserDocumentApiValue<T> = T extends (...args: infer Args) => infer Return ? ((...args: Args) => MaybePromise<Awaited<Return>>) & BrowserDocumentApiObject<T> : T extends object ? BrowserDocumentApiObject<T> : T;
+/**
+ * Browser V2 active-editor Document API facade (`superdoc.activeEditor.doc`).
+ * In the browser this surface is intentionally async-capable: callers must
+ * tolerate promise-returning reads/writes, including the default
+ * worker-backed runtime. SDK/headless callers should continue using the
+ * synchronous `@superdoc/document-api` surface directly.
+ */
+export type BrowserDocumentApi = BrowserDocumentApiObject<DocumentApi>;
+/**
+ * Every operation optional, at any depth.
+ *
+ * A callable member keeps its call signature *and* its properties, mirroring
+ * what {@link BrowserDocumentApiValue} does. Parts of the Document API are both:
+ * `capabilities` is callable and carries `get()`, so reconstructing only the call
+ * signature would make `doc.capabilities.get()` a type error on a value that
+ * supports it at runtime.
+ *
+ * Intersected rather than unioned with the property bag. A union would let a
+ * non-callable object stand in for a callable member, which also makes the
+ * member type unenforceable: `{ comments: { list: 42 } }` satisfies a
+ * props-only alternative and the type stops catching wrong operations at all.
+ */
+type DeepPartial<T> = T extends (...args: infer Args) => infer Return ? ((...args: Args) => Return) & {
+    [K in keyof T]?: DeepPartial<T[K]>;
+} : T extends object ? {
+    [K in keyof T]?: DeepPartial<T[K]>;
+} : T;
+/**
+ * What a *host* may supply as `activeEditor.doc`.
+ *
+ * A host is duck-typed: a custom adapter or a test stub is expected to carry
+ * only the operations it actually implements, and the controller resolves
+ * operations defensively at runtime rather than assuming any of them exist.
+ * Requiring the whole surface here would reject exactly the partial hosts the
+ * contract is documented to accept.
+ *
+ * `CustomCommandContext.doc` uses this same partial type, because that value is
+ * the host's own object passed straight through. It can promise no more than the
+ * host contract does. {@link BrowserDocumentApi}, the complete facade, is the
+ * type of `activeEditor.doc` on a real `Editor`.
+ *
+ * Partial, not permissive: the operations a host does declare are still
+ * checked, so a typo or a wrong member type fails instead of passing as
+ * `any`.
+ */
+export type PartialBrowserDocumentApi = DeepPartial<BrowserDocumentApi>;
+export {};

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

@@ -5,6 +5,7 @@ import type { BlockNavigationAddress as __Cjs_BlockNavigationAddress } from './i
 import type { BlocksListResult as __Cjs_BlocksListResult } from './index.js' with { "resolution-mode": "import" };
 import type { BookmarkAddress as __Cjs_BookmarkAddress } from './index.js' with { "resolution-mode": "import" };
 import type { BookmarkInfo as __Cjs_BookmarkInfo } from './index.js' with { "resolution-mode": "import" };
+import type { BorrowedSuperDocUI as __Cjs_BorrowedSuperDocUI } from './index.js' with { "resolution-mode": "import" };
 import type { CanPerformPermissionParams as __Cjs_CanPerformPermissionParams } from './index.js' with { "resolution-mode": "import" };
 import type { CollaborationConfig as __Cjs_CollaborationConfig } from './index.js' with { "resolution-mode": "import" };
 import type { CommentAddress as __Cjs_CommentAddress } from './index.js' with { "resolution-mode": "import" };
@@ -133,6 +134,7 @@ import type { SuperDocStoryLocator as __Cjs_SuperDocStoryLocator } from './index
 import type { SuperDocTelemetryConfig as __Cjs_SuperDocTelemetryConfig } from './index.js' with { "resolution-mode": "import" };
 import type { SuperDocTextAddress as __Cjs_SuperDocTextAddress } from './index.js' with { "resolution-mode": "import" };
 import type { SuperDocTextTarget as __Cjs_SuperDocTextTarget } from './index.js' with { "resolution-mode": "import" };
+import type { SuperDocUI as __Cjs_SuperDocUI } from './index.js' with { "resolution-mode": "import" };
 import type { SuperDocViewportChangePayload as __Cjs_SuperDocViewportChangePayload } from './index.js' with { "resolution-mode": "import" };
 import type { SuperDocViewportMetrics as __Cjs_SuperDocViewportMetrics } from './index.js' with { "resolution-mode": "import" };
 import type { SuperDocVisibleRange as __Cjs_SuperDocVisibleRange } from './index.js' with { "resolution-mode": "import" };
@@ -175,6 +177,7 @@ export type { __Cjs_BlockNavigationAddress as BlockNavigationAddress };
 export type { __Cjs_BlocksListResult as BlocksListResult };
 export type { __Cjs_BookmarkAddress as BookmarkAddress };
 export type { __Cjs_BookmarkInfo as BookmarkInfo };
+export type { __Cjs_BorrowedSuperDocUI as BorrowedSuperDocUI };
 export declare const buildTheme: typeof import('./index.js', { with: { "resolution-mode": "import" } }).buildTheme;
 export type { __Cjs_CanPerformPermissionParams as CanPerformPermissionParams };
 export type { __Cjs_CollaborationConfig as CollaborationConfig };
@@ -312,6 +315,7 @@ export type { __Cjs_SuperDocStoryLocator as SuperDocStoryLocator };
 export type { __Cjs_SuperDocTelemetryConfig as SuperDocTelemetryConfig };
 export type { __Cjs_SuperDocTextAddress as SuperDocTextAddress };
 export type { __Cjs_SuperDocTextTarget as SuperDocTextTarget };
+export type { __Cjs_SuperDocUI as SuperDocUI };
 export type { __Cjs_SuperDocViewportChangePayload as SuperDocViewportChangePayload };
 export type { __Cjs_SuperDocViewportMetrics as SuperDocViewportMetrics };
 export type { __Cjs_SuperDocVisibleRange as SuperDocVisibleRange };

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

@@ -81,6 +81,8 @@ export type { SuperDocMeasurementUnitChangePayload } from '../core/types/index.j
 export type { SuperDocReadyPayload } from '../core/types/index.js';
 export type { SuperDocState } from '../core/types/index.js';
 export type { SuperDocTelemetryConfig } from '../core/types/index.js';
+export type { BorrowedSuperDocUI } from './ui/types.js';
+export type { SuperDocUI } from './ui/types.js';
 export type { SuperDocViewportChangePayload } from '../core/types/index.js';
 export type { SuperDocViewportMetrics } from '../core/types/index.js';
 export type { SuperDocZoomConfig } from '../core/types/index.js';

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

@@ -1,5 +1,5 @@
 import { ReactNode } from 'react';
-import { CommandState, CommentsSlice, ContentControlsSlice, DocumentSlice, FontFamilyOption, FontSizeOption, SelectionSlice, Subscribable, SuperDocLike, SuperDocUI, ToolbarSnapshotSlice, TrackChangesSlice, ZoomSlice } from './types.js';
+import { BorrowedSuperDocUI, CommandState, CommentsSlice, ContentControlsSlice, DocumentSlice, FontFamilyOption, FontSizeOption, SelectionSlice, Subscribable, SuperDocLike, ToolbarSnapshotSlice, TrackChangesSlice, ZoomSlice } from './types.js';
 /** The raw SuperDoc instance (or host stub) handed to the provider. */
 export type SuperDocHost = SuperDocLike;
 /** Props accepted by {@link SuperDocUIProvider}. */
@@ -8,13 +8,24 @@ export interface SuperDocUIProviderProps {
     children?: ReactNode;
 }
 /**
- * Root provider. Owns the controller lifecycle: call {@link useSetSuperDoc}
- * from your editor-mount component's ready callback to bind a running SuperDoc
- * instance; the controller is created then and destroyed on unmount / rebind.
+ * Root provider. Call {@link useSetSuperDoc} from your editor-mount
+ * component's ready callback to bind a running SuperDoc instance; the hooks
+ * below then read that instance's own controller (`superdoc.ui`).
+ *
+ * The provider is a consumer, not an owner. SuperDoc creates the controller
+ * and destroys it in `superdoc.destroy()`, so unmounting or rebinding the
+ * provider leaves it running for the built-in toolbar and any other consumer
+ * of the same instance. Every React hook therefore observes the same command
+ * state the rest of the application sees.
  */
 export declare function SuperDocUIProvider(props: SuperDocUIProviderProps): import('react').ReactElement;
-/** Read the controller, or `null` until a SuperDoc instance is bound. */
-export declare function useSuperDocUI(): SuperDocUI | null;
+/**
+ * Read the controller, or `null` until a SuperDoc instance is bound.
+ *
+ * Borrowed: the bound instance owns teardown, so the returned type omits
+ * `destroy()`. A provider-built fallback controller is disposed by the provider.
+ */
+export declare function useSuperDocUI(): BorrowedSuperDocUI | null;
 /** Read the raw bound SuperDoc host, or `null` until one is bound. */
 export declare function useSuperDocHost(): SuperDocHost | null;
 /** Get the stable callback used to bind a running SuperDoc instance. */
@@ -46,7 +57,7 @@ export declare function toSliceSource<T>(source: SliceSource<T> | Subscribable<T
  * normalized via {@link toSliceSource}. `initial` is returned until the
  * controller is bound.
  */
-export declare function useSuperDocSlice<T>(pick: (ui: SuperDocUI) => SliceSource<T> | Subscribable<T>, initial: T): T;
+export declare function useSuperDocSlice<T>(pick: (ui: BorrowedSuperDocUI) => SliceSource<T> | Subscribable<T>, initial: T): T;
 /** Subscribe to the selection slice. */
 export declare function useSuperDocSelection(): SelectionSlice;
 /** Subscribe to the comments slice. */