superdoc 2.13.0-next.1 → 2.13.0-next.11

package/dist/document-api/src/types/table-operations.types.d.ts

@@ -568,6 +568,8 @@ export interface TablesGetCellsInput extends TableLocator {
 }
 /** Per-cell info with stable ref for write handoff. */
 export interface TableCellInfo {
+    /** First paragraph in this cell, when the engine exposes paragraph identities. */
+    firstParagraphNodeId?: string;
     /** Shorthand cell identifier: convenient for logging, Map keys, and display. */
     nodeId: string;
     /** Mutation-ready address: pass directly as `target` in follow-up cell operations. */

package/dist/layout-engine/dom-contract/src/data-attrs.d.ts

@@ -52,6 +52,8 @@ export declare const DATA_ATTRS: {
     readonly LAYOUT_STORY: "data-layout-story";
     /** Source block reference (today: producer's `blockId`). */
     readonly LAYOUT_BLOCK_REF: "data-layout-block-ref";
+    /** Zero-based flow-column index that owns the rendered fragment. */
+    readonly LAYOUT_COLUMN_INDEX: "data-layout-column-index";
 };
 /**
  * CamelCase keys for use with `element.dataset.*` property access.
@@ -75,6 +77,7 @@ export declare const DATASET_KEYS: {
     readonly LAYOUT_FRAGMENT_ID: "layoutFragmentId";
     readonly LAYOUT_STORY: "layoutStory";
     readonly LAYOUT_BLOCK_REF: "layoutBlockRef";
+    readonly LAYOUT_COLUMN_INDEX: "layoutColumnIndex";
 };
 /**
  * Encode a `LayoutStoryLocator`-shaped object into its dataset string form.

package/dist/layout-engine/painters/dom/src/page-content.d.ts

@@ -94,8 +94,9 @@ export declare function createEmptyPaintWorkSummary(): PaintWorkSummary;
  * Painter plan P3a: reuse key for one exact page slot on the persistent-page
  * path. Joins everything the painted page DOM depends on for a fixed page
  * index: the resolve-stage version stamp per item (the product paint-reuse
- * mechanism), fragment identity + geometry (stamps do not cover geometry),
- * and, only when body content contains a dynamic field, its page context.
+ * mechanism), fragment identity + geometry + column ownership (stamps do not
+ * cover these), and, only when body content contains a dynamic field, its
+ * page context.
  * Header/footer providers have a separate decoration-only refresh path, so
  * their context must not invalidate otherwise reusable body fragments.
  *

package/dist/layout-engine/painters/dom/src/renderer.d.ts

@@ -657,6 +657,7 @@ export declare class DomPainter {
     private resolveFragmentWrapperZIndex;
     private applyFragmentWrapperZIndex;
     private applyResolvedFragmentFrame;
+    private applyFragmentColumnOwnership;
     /**
      * Estimates the height of a fragment when explicit height is not available.
      *

package/dist/public/collaboration-worker.cjs

@@ -0,0 +1,9 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let _superdoc_docx_engine_collaboration_worker = require("@superdoc/docx-engine/collaboration-worker");
+//#region src/public/collaboration-worker.ts
+/** Register provider adapters and start the worker used by `workerUrls.collaboration`. */
+function bootstrapSuperDocCollaborationWorker(options) {
+	(0, _superdoc_docx_engine_collaboration_worker.bootstrapSuperDocCollaborationWorker)(options);
+}
+//#endregion
+exports.bootstrapSuperDocCollaborationWorker = bootstrapSuperDocCollaborationWorker;

package/dist/public/collaboration-worker.es.js

@@ -0,0 +1,8 @@
+import { bootstrapSuperDocCollaborationWorker as bootstrapSuperDocCollaborationWorker$1 } from "@superdoc/docx-engine/collaboration-worker";
+//#region src/public/collaboration-worker.ts
+/** Register provider adapters and start the worker used by `workerUrls.collaboration`. */
+function bootstrapSuperDocCollaborationWorker(options) {
+	bootstrapSuperDocCollaborationWorker$1(options);
+}
+//#endregion
+export { bootstrapSuperDocCollaborationWorker };

package/dist/public/ui-react.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-BWWWNPP8.cjs");
+const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-DNfQTF2k.cjs");
 const require_slice_source = require("../chunks/slice-source-CFaqq0Vo.cjs");
 let react = require("react");
 //#region src/public/ui/react.ts

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

@@ -1,4 +1,4 @@
-import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-FnwgTkUv.es.js";
+import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-XWtQHPGP.es.js";
 import { t as toSliceSource } from "../chunks/slice-source-gfOhG2MW.es.js";
 import { createContext, createElement, useCallback, useContext, useEffect, useRef, useState } from "react";
 //#region src/public/ui/react.ts

package/dist/public/ui-vue.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-BWWWNPP8.cjs");
+const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-DNfQTF2k.cjs");
 const require_slice_source = require("../chunks/slice-source-CFaqq0Vo.cjs");
 let vue = require("vue");
 //#region src/public/ui/vue.ts

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

@@ -1,4 +1,4 @@
-import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-FnwgTkUv.es.js";
+import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-XWtQHPGP.es.js";
 import { t as toSliceSource } from "../chunks/slice-source-gfOhG2MW.es.js";
 import { computed, inject, onScopeDispose, provide, shallowRef, toRaw, toValue, watch } from "vue";
 //#region src/public/ui/vue.ts

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

package/dist/style.css

@@ -1818,11 +1818,11 @@ img[data-v-c95b2073] {
   pointer-events: auto;
 }
 
-.superdoc[data-v-0d27f262] {
+.superdoc[data-v-ebe9a1fb] {
   display: flex;
   position: relative;
 }
-.sd-visually-hidden[data-v-0d27f262] {
+.sd-visually-hidden[data-v-ebe9a1fb] {
   position: absolute;
   width: 1px;
   height: 1px;
@@ -1833,14 +1833,14 @@ img[data-v-c95b2073] {
   white-space: nowrap;
   border: 0;
 }
-.superdoc__mutation-status[data-v-0d27f262] {
+.superdoc__mutation-status[data-v-ebe9a1fb] {
   position: sticky;
   z-index: 10;
   top: 12px;
   height: 0;
   pointer-events: none;
 }
-.superdoc__edit-rejected-status[data-v-0d27f262] {
+.superdoc__edit-rejected-status[data-v-ebe9a1fb] {
   position: absolute;
   top: 0;
   left: 50%;
@@ -1858,30 +1858,30 @@ img[data-v-c95b2073] {
   line-height: 20px;
   pointer-events: none;
 }
-.right-sidebar[data-v-0d27f262] {
+.right-sidebar[data-v-ebe9a1fb] {
   min-width: 320px;
   height: 100%;
 }
-.floating-comments[data-v-0d27f262] {
+.floating-comments[data-v-ebe9a1fb] {
   min-width: 300px;
   width: 300px;
   height: 100%;
   overflow: visible;
 }
-.superdoc__layers[data-v-0d27f262] {
+.superdoc__layers[data-v-ebe9a1fb] {
   height: 100%;
   position: relative;
   box-sizing: border-box;
 }
-.superdoc__document[data-v-0d27f262] {
+.superdoc__document[data-v-ebe9a1fb] {
   width: 100%;
   position: relative;
 }
-.superdoc__sub-document[data-v-0d27f262] {
+.superdoc__sub-document[data-v-ebe9a1fb] {
   width: 100%;
   position: relative;
 }
-.superdoc__selection-layer[data-v-0d27f262] {
+.superdoc__selection-layer[data-v-ebe9a1fb] {
   position: absolute;
   min-width: 100%;
   min-height: 100%;
@@ -1892,13 +1892,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-0d27f262] {
+.superdoc__whiteboard-layer[data-v-ebe9a1fb] {
   z-index: 4;
 }
-.superdoc__temp-selection[data-v-0d27f262] {
+.superdoc__temp-selection[data-v-ebe9a1fb] {
   position: absolute;
 }
-.superdoc__right-sidebar[data-v-0d27f262] {
+.superdoc__right-sidebar[data-v-ebe9a1fb] {
   width: 320px;
   min-width: 320px;
   padding: 0 10px;
@@ -1906,7 +1906,7 @@ img[data-v-c95b2073] {
   position: relative;
   z-index: 2;
 }
-.superdoc__compact-comment-popover[data-v-0d27f262] {
+.superdoc__compact-comment-popover[data-v-ebe9a1fb] {
   position: absolute;
   top: 12px;
   right: 12px;
@@ -1915,14 +1915,14 @@ img[data-v-c95b2073] {
 }
 
 /* Tools styles */
-.tools[data-v-0d27f262] {
+.tools[data-v-ebe9a1fb] {
   position: absolute;
   z-index: 3;
   display: flex;
   flex-direction: column;
   gap: var(--sd-ui-tools-gap, 6px);
 }
-.tools-item[data-v-0d27f262] {
+.tools-item[data-v-ebe9a1fb] {
   display: flex;
   align-items: center;
   justify-content: center;
@@ -1933,10 +1933,10 @@ img[data-v-c95b2073] {
   cursor: pointer;
   position: relative;
 }
-.tools-item i[data-v-0d27f262] {
+.tools-item i[data-v-ebe9a1fb] {
   cursor: pointer;
 }
-.superdoc__tools-icon[data-v-0d27f262] {
+.superdoc__tools-icon[data-v-ebe9a1fb] {
   width: var(--sd-ui-tools-icon-size, 20px);
   height: var(--sd-ui-tools-icon-size, 20px);
   flex-shrink: 0;
@@ -1951,22 +1951,22 @@ img[data-v-c95b2073] {
 
 /* 834px is iPad screen size in portrait orientation */
 @media (max-width: 834px) {
-.superdoc .superdoc__layers[data-v-0d27f262] {
+.superdoc .superdoc__layers[data-v-ebe9a1fb] {
     margin: 0;
     border: 0 !important;
     box-shadow: none;
 }
-.superdoc__sub-document[data-v-0d27f262] {
+.superdoc__sub-document[data-v-ebe9a1fb] {
     max-width: 100%;
 }
-.superdoc__right-sidebar[data-v-0d27f262] {
+.superdoc__right-sidebar[data-v-ebe9a1fb] {
     padding: 10px;
     position: relative;
 }
 }
 
 /* AI Writer styles */
-.ai-writer-container[data-v-0d27f262] {
+.ai-writer-container[data-v-ebe9a1fb] {
   position: fixed;
   z-index: 1000;
   background: white;
@@ -1982,10 +1982,10 @@ img[data-v-c95b2073] {
   transform: translateY(-50%);
   z-index: 50;
 } */
-.ai-tool > svg[data-v-0d27f262] {
+.ai-tool > svg[data-v-ebe9a1fb] {
   fill: transparent;
 }
-.ai-tool[data-v-0d27f262]::before {
+.ai-tool[data-v-ebe9a1fb]::before {
   content: '';
   position: absolute;
   width: 20px;
@@ -2006,7 +2006,7 @@ img[data-v-c95b2073] {
   filter: brightness(1.2);
   transition: filter 0.2s ease;
 }
-.ai-tool[data-v-0d27f262]:hover::before {
+.ai-tool[data-v-ebe9a1fb]:hover::before {
   filter: brightness(1.3);
 }
 
@@ -2359,7 +2359,7 @@ img[data-v-c95b2073] {
   transform: scale(1);
 }
 
-.superdoc-toolbar-overflow[data-v-975959f9] {
+.superdoc-toolbar-overflow[data-v-5f8ee279] {
   min-width: auto !important;
   max-width: 200px;
   flex-wrap: wrap;

package/dist/style.layered.css

@@ -1818,11 +1818,11 @@ img[data-v-c95b2073] {
   pointer-events: auto;
 }
 
-.superdoc[data-v-0d27f262] {
+.superdoc[data-v-ebe9a1fb] {
   display: flex;
   position: relative;
 }
-.sd-visually-hidden[data-v-0d27f262] {
+.sd-visually-hidden[data-v-ebe9a1fb] {
   position: absolute;
   width: 1px;
   height: 1px;
@@ -1833,14 +1833,14 @@ img[data-v-c95b2073] {
   white-space: nowrap;
   border: 0;
 }
-.superdoc__mutation-status[data-v-0d27f262] {
+.superdoc__mutation-status[data-v-ebe9a1fb] {
   position: sticky;
   z-index: 10;
   top: 12px;
   height: 0;
   pointer-events: none;
 }
-.superdoc__edit-rejected-status[data-v-0d27f262] {
+.superdoc__edit-rejected-status[data-v-ebe9a1fb] {
   position: absolute;
   top: 0;
   left: 50%;
@@ -1858,30 +1858,30 @@ img[data-v-c95b2073] {
   line-height: 20px;
   pointer-events: none;
 }
-.right-sidebar[data-v-0d27f262] {
+.right-sidebar[data-v-ebe9a1fb] {
   min-width: 320px;
   height: 100%;
 }
-.floating-comments[data-v-0d27f262] {
+.floating-comments[data-v-ebe9a1fb] {
   min-width: 300px;
   width: 300px;
   height: 100%;
   overflow: visible;
 }
-.superdoc__layers[data-v-0d27f262] {
+.superdoc__layers[data-v-ebe9a1fb] {
   height: 100%;
   position: relative;
   box-sizing: border-box;
 }
-.superdoc__document[data-v-0d27f262] {
+.superdoc__document[data-v-ebe9a1fb] {
   width: 100%;
   position: relative;
 }
-.superdoc__sub-document[data-v-0d27f262] {
+.superdoc__sub-document[data-v-ebe9a1fb] {
   width: 100%;
   position: relative;
 }
-.superdoc__selection-layer[data-v-0d27f262] {
+.superdoc__selection-layer[data-v-ebe9a1fb] {
   position: absolute;
   min-width: 100%;
   min-height: 100%;
@@ -1892,13 +1892,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-0d27f262] {
+.superdoc__whiteboard-layer[data-v-ebe9a1fb] {
   z-index: 4;
 }
-.superdoc__temp-selection[data-v-0d27f262] {
+.superdoc__temp-selection[data-v-ebe9a1fb] {
   position: absolute;
 }
-.superdoc__right-sidebar[data-v-0d27f262] {
+.superdoc__right-sidebar[data-v-ebe9a1fb] {
   width: 320px;
   min-width: 320px;
   padding: 0 10px;
@@ -1906,7 +1906,7 @@ img[data-v-c95b2073] {
   position: relative;
   z-index: 2;
 }
-.superdoc__compact-comment-popover[data-v-0d27f262] {
+.superdoc__compact-comment-popover[data-v-ebe9a1fb] {
   position: absolute;
   top: 12px;
   right: 12px;
@@ -1915,14 +1915,14 @@ img[data-v-c95b2073] {
 }
 
 /* Tools styles */
-.tools[data-v-0d27f262] {
+.tools[data-v-ebe9a1fb] {
   position: absolute;
   z-index: 3;
   display: flex;
   flex-direction: column;
   gap: var(--sd-ui-tools-gap, 6px);
 }
-.tools-item[data-v-0d27f262] {
+.tools-item[data-v-ebe9a1fb] {
   display: flex;
   align-items: center;
   justify-content: center;
@@ -1933,10 +1933,10 @@ img[data-v-c95b2073] {
   cursor: pointer;
   position: relative;
 }
-.tools-item i[data-v-0d27f262] {
+.tools-item i[data-v-ebe9a1fb] {
   cursor: pointer;
 }
-.superdoc__tools-icon[data-v-0d27f262] {
+.superdoc__tools-icon[data-v-ebe9a1fb] {
   width: var(--sd-ui-tools-icon-size, 20px);
   height: var(--sd-ui-tools-icon-size, 20px);
   flex-shrink: 0;
@@ -1951,22 +1951,22 @@ img[data-v-c95b2073] {
 
 /* 834px is iPad screen size in portrait orientation */
 @media (max-width: 834px) {
-.superdoc .superdoc__layers[data-v-0d27f262] {
+.superdoc .superdoc__layers[data-v-ebe9a1fb] {
     margin: 0;
     border: 0 !important;
     box-shadow: none;
 }
-.superdoc__sub-document[data-v-0d27f262] {
+.superdoc__sub-document[data-v-ebe9a1fb] {
     max-width: 100%;
 }
-.superdoc__right-sidebar[data-v-0d27f262] {
+.superdoc__right-sidebar[data-v-ebe9a1fb] {
     padding: 10px;
     position: relative;
 }
 }
 
 /* AI Writer styles */
-.ai-writer-container[data-v-0d27f262] {
+.ai-writer-container[data-v-ebe9a1fb] {
   position: fixed;
   z-index: 1000;
   background: white;
@@ -1982,10 +1982,10 @@ img[data-v-c95b2073] {
   transform: translateY(-50%);
   z-index: 50;
 } */
-.ai-tool > svg[data-v-0d27f262] {
+.ai-tool > svg[data-v-ebe9a1fb] {
   fill: transparent;
 }
-.ai-tool[data-v-0d27f262]::before {
+.ai-tool[data-v-ebe9a1fb]::before {
   content: '';
   position: absolute;
   width: 20px;
@@ -2006,7 +2006,7 @@ img[data-v-c95b2073] {
   filter: brightness(1.2);
   transition: filter 0.2s ease;
 }
-.ai-tool[data-v-0d27f262]:hover::before {
+.ai-tool[data-v-ebe9a1fb]:hover::before {
   filter: brightness(1.3);
 }
 
@@ -2359,7 +2359,7 @@ img[data-v-c95b2073] {
   transform: scale(1);
 }
 
-.superdoc-toolbar-overflow[data-v-975959f9] {
+.superdoc-toolbar-overflow[data-v-5f8ee279] {
   min-width: auto !important;
   max-width: 200px;
   flex-wrap: wrap;

package/dist/superdoc/src/composables/use-viewport-fit.d.ts

@@ -48,3 +48,4 @@ export function resolveFitWidthOptions(rawFitConfig: any): {
 export function computeFitZoom(availableWidth: any, documentWidth: any): number | null;
 export function computeAppliedFitZoom(availableWidth: any, documentWidth: any, options: any): number | null;
 export function normalizePdfPageMeasurement(measured: any, scaleFactor: any, zoomFactor: any): any;
+export function resolveEditorPageWidth(editor: any): number | null;

package/dist/superdoc/src/core/collaboration/collaboration-exception.d.ts

@@ -0,0 +1,2 @@
+import { SuperDocExceptionCollaborationPayload } from '../types/index.js';
+export declare function createCollaborationException(code: string, documentId: string | null): SuperDocExceptionCollaborationPayload | null;

package/dist/superdoc/src/core/collaboration/resolve-v2-collaboration-target.d.ts

@@ -7,20 +7,20 @@
  * first-class single-doc provider families — y-websocket, Hocuspocus, and
  * Liveblocks — each bound to one `Y.Doc`, one provider session, and one
  * awareness channel (implemented inside the bundled v2 runtime) and surfaced
- * publicly through {@link V2CollaborationConfig} (`Document.v2Collaboration`).
+ * publicly through {@link DocumentCollaborationConfig} (`Document.collaboration`).
  *
  * The resolver never returns a "maybe collaborative" result: it either returns
  * a normalized, supported target or a stable, redacted diagnostic. Tokens, auth
  * keys, auth endpoints, and query strings are never echoed back in diagnostics.
  */
 /** Provider families the shipped v2 single-doc runtime can drive. */
-export type SupportedV2ProviderFamily = 'y-websocket' | 'hocuspocus' | 'liveblocks';
+export type SupportedV2ProviderFamily = 'y-websocket' | 'hocuspocus' | 'liveblocks' | 'extension';
 /**
  * Stable, machine-readable reasons a target cannot be treated as a supported v2
  * collaboration room. These strings are part of the diagnostic contract and are
  * safe to assert against in tests; they never carry caller-provided values.
  */
-export type V2CollaborationUnsupportedReason = 'missing-target' | 'invalid-document-id' | 'invalid-server-url' | 'invalid-room-mode' | 'invalid-auth-endpoint' | 'missing-auth' | 'mixed-auth' | 'unsupported-document-type' | 'unsupported-multi-document' | 'unsupported-legacy-provider' | 'unsupported-provider-family';
+export type V2CollaborationUnsupportedReason = 'missing-target' | 'invalid-document-id' | 'invalid-server-url' | 'invalid-room-mode' | 'invalid-auth-endpoint' | 'invalid-adapter-id' | 'invalid-provider-options' | 'missing-auth' | 'mixed-auth' | 'unsupported-document-type' | 'unsupported-multi-document' | 'unsupported-legacy-provider' | 'unsupported-provider-family';
 /**
  * Normalized, supported v2 collaboration room target.
  *
@@ -38,11 +38,15 @@ export interface NormalizedV2CollaborationTarget {
     /** Optional connection query params (e.g. auth token) forwarded verbatim. */
     params?: Record<string, string>;
     /** Hocuspocus auth-message token. */
-    token?: string;
+    token?: string | (() => string | Promise<string>);
     /** Liveblocks anonymous public key auth mode. */
     publicApiKey?: string;
     /** Liveblocks server-side auth endpoint mode. */
     authEndpoint?: string;
+    /** Adapter registration key for a customer collaboration Worker. */
+    adapterId?: string;
+    /** Structured-clone-safe options interpreted by the registered adapter. */
+    providerOptions?: unknown;
     /** Explicit room operation; join is the default at the untrusted input boundary. */
     roomMode: 'join' | 'create';
 }
@@ -68,7 +72,9 @@ export interface LegacyCollaborationLike {
     [key: string]: unknown;
 }
 export interface ResolveV2CollaborationTargetInput {
-    /** Document-level v2 collaboration config (canonical supported entry point). */
+    /** Preferred connection settings. Explicit null or invalid input never falls back to the alias. */
+    collaboration?: unknown;
+    /** Compatibility spelling for document-level connection settings. */
     v2Collaboration?: unknown;
     /** Legacy provider-agnostic collaboration block (`modules.collaboration` / upgrade opts). */
     legacyCollaboration?: LegacyCollaborationLike | null;
@@ -83,6 +89,11 @@ export interface ResolveV2CollaborationTargetInput {
      */
     authEndpointBaseUrl?: string;
 }
+/** Select the public spelling before validation; do not merge settings from different rooms. */
+export declare function readCollaborationConfig(input: {
+    collaboration?: unknown;
+    v2Collaboration?: unknown;
+}): unknown;
 /**
  * Redact a connection URL for safe inclusion in diagnostics and artifacts.
  *

package/dist/superdoc/src/core/theme/create-theme.d.ts

@@ -1,43 +1,55 @@
 export interface ThemeColors {
-    /** Action/accent color (buttons, links, active states). Default: #1355ff */
+    /** Action color for buttons, links, and active states. @defaultValue `#1355ff` */
     action?: string;
-    /** Action hover state. Default: #0f44cc */
+    /** Hover color for action elements. @defaultValue `#0f44cc` */
     actionHover?: string;
-    /** Text color on action-colored buttons. Default: #ffffff */
+    /** Text color shown on action-colored elements. @defaultValue `#ffffff` */
     actionText?: string;
-    /** Default background for panels, cards, dropdowns. Default: #ffffff */
+    /** Shared background for UI surfaces such as panels, cards, and dropdowns. @defaultValue `#ffffff` */
     bg?: string;
-    /** Hover background. Default: #dbdbdb */
+    /** Background for hovered controls. @defaultValue `#dbdbdb` */
     hoverBg?: string;
-    /** Active/pressed background. Default: #c8d0d8 */
+    /** Background for active and pressed controls. @defaultValue `#c8d0d8` */
     activeBg?: string;
-    /** Disabled background. Default: #f5f5f5 */
+    /** Background for disabled controls. @defaultValue `#f5f5f5` */
     disabledBg?: string;
-    /** Primary text color. Default: #47484a */
+    /** Primary UI text color. @defaultValue `#47484a` */
     text?: string;
-    /** Secondary/muted text. Default: #666666 */
+    /** Secondary UI text color. @defaultValue `#666666` */
     textMuted?: string;
-    /** Disabled text. Default: #ababab */
+    /** Text color for disabled controls. @defaultValue `#ababab` */
     textDisabled?: string;
-    /** Default border color. Default: #dbdbdb */
+    /** Shared UI border color. @defaultValue `#dbdbdb` */
     border?: string;
 }
+/** SuperDoc CSS variable overrides applied after the semantic theme values. */
+export type ThemeVariableOverrides = {
+    readonly [name: `--sd-${string}`]: string | null | undefined;
+};
 export interface ThemeConfig {
-    /** Theme name — used in the generated class name (e.g., "dark" → "sd-theme-dark") */
+    /** Name used in the generated class, such as `product` for `sd-theme-product`. */
     name?: string;
-    /** UI font family */
+    /**
+     * Font family for SuperDoc UI surfaces that inherit the theme, such as body-mounted dialogs
+     * and floating surfaces. The Editor root and the external toolbar set `--sd-ui-font-family`
+     * inline from `uiDisplayFallbackFont`, and an inline declaration outranks the theme class —
+     * set `uiDisplayFallbackFont` to the same value to change those surfaces too.
+     */
     font?: string;
-    /** Default border radius (e.g., "8px") */
+    /** Shared UI border radius, such as `8px`. */
     radius?: string;
-    /** Default box shadow */
+    /** Shared UI box shadow. */
     shadow?: string;
-    /** Core color palette — cascades to every component */
+    /** Semantic colors shared by SuperDoc UI components. */
     colors?: ThemeColors;
-    /** Escape hatch — raw CSS variable overrides (e.g., { '--sd-ui-toolbar-bg': '#f8fafc' }) */
-    vars?: Record<string, string | null | undefined>;
+    /** Component-specific overrides, such as `{ '--sd-ui-toolbar-bg': '#f8fafc' }`. */
+    vars?: ThemeVariableOverrides;
 }
+/** CSS generated by {@link buildTheme}. */
 export interface ThemeResult {
+    /** Class that activates the generated theme. */
     className: string;
+    /** CSS rule containing the generated SuperDoc variables. */
     css: string;
 }
 /**
@@ -65,8 +77,8 @@ export interface ThemeResult {
 export declare function createTheme(config: ThemeConfig): string;
 /**
  * Build a SuperDoc theme and return both the class name and raw CSS.
- * Pure function — does NOT inject styles into the DOM. Use this for SSR
- * or when you need to control style injection yourself (e.g., CSP nonce).
+ * This function does not access the DOM. Use it for server rendering or when
+ * your application controls style injection, such as with a CSP nonce.
  *
  * @example
  * ```ts