superdoc 2.0.0-next.45 → 2.0.0-next.47

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

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/replace-continuation.d.ts

@@ -0,0 +1,37 @@
+/**
+ * The find/replace panel's settled-replace continuation.
+ *
+ * A worker-backed replace resolves asynchronously, and the session it belongs to
+ * can be gone by the time it does: the search handle is reassigned when the
+ * active editor changes and nulled on teardown. Publishing the resolved snapshot
+ * anyway would repopulate the panel with matches from a document the user is no
+ * longer looking at.
+ *
+ * A leaf module rather than a closure inside `useFindReplace`, following
+ * `find-shortcut-owner.js`. The guard previously lived in two byte-identical
+ * inline closures, each of which needed a full composable driving a
+ * worker-backed host caught mid-swap to reach one branch. Nothing could, so it
+ * shipped with a comment admitting it was verified by inspection only. The
+ * duplication was the tell: logic worth stating twice is worth naming once.
+ */
+/**
+ * Build the continuation that publishes a settled replace back into the panel.
+ *
+ * The session handle itself is the identity. `onSettled` always runs, including
+ * when the write is skipped: it clears the pending flag that gates the replace
+ * controls, and leaving it set would disable them with nothing left to settle.
+ *
+ * @param {{ getSnapshot: () => unknown }} session The handle captured when the replace was issued.
+ * @param {object} deps
+ * @param {() => unknown} deps.getCurrentSession Reads the live session identity.
+ * @param {(snapshot: unknown) => void} deps.applySlice Publishes a snapshot into the panel.
+ * @param {() => void} deps.onSettled Runs whether or not the write was skipped.
+ * @returns {() => void}
+ */
+export function createReplaceContinuation(session: {
+    getSnapshot: () => unknown;
+}, { getCurrentSession, applySlice, onSettled }: {
+    getCurrentSession: () => unknown;
+    applySlice: (snapshot: unknown) => void;
+    onSettled: () => void;
+}): () => void;

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/default-items.d.ts

@@ -1,3 +1,14 @@
+/**
+ * Set or clear the link item's `href` without disturbing the rest of its
+ * attributes. The static configuration (`ariaLabel`, and anything added later)
+ * lives in the same object as the transient href, so rebuilding that object
+ * from the keys a caller knows about silently drops the others.
+ *
+ * Exported because the built-in toolbar's `updateToolbarState()` writes the
+ * href on its own path, without going through this item's handlers. Both
+ * callers share this one rule so the two cannot drift apart.
+ */
+export function withLinkHref(attributes: any, href: any): any;
 export function makeDefaultItems({ superToolbar, toolbarIcons, toolbarTexts, toolbarFonts, hideButtons, availableWidth, role, isDev, }?: {
     isDev?: boolean | undefined;
 }): {

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. */