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

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

@@ -10,6 +10,7 @@ import { CustomCommandContext, FontFamilyOption as ToolbarFontFamilyOption } fro
 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;
 export type { BrowserDocumentApi } from '../../public/browser-document-api.js';
+export type { CommentsType, ExportParams, ExportType } from '../../public/export-types.js';
 /**
  * A row in a custom dropdown's option list, and the value handed back to the
  * `command` callback when one is chosen.
@@ -591,10 +592,12 @@ export interface CollaborationProvider {
     off?: (...args: unknown[]) => unknown;
     disconnect?: () => unknown;
     destroy?: () => unknown;
+    /** Send a provider-specific stateless string payload. */
+    sendStateless?: (message: string) => unknown;
     [key: string]: unknown;
 }
 /**
- * Document-level v2 collaboration handoff.
+ * Connection settings for one shared document, used at startup and during an upgrade.
  *
  * This is the public surface for SuperDoc v2's shipped real-time collaboration
  * model. v2 collaboration is always single-doc: one `Y.Doc`, one provider
@@ -604,18 +607,19 @@ export interface CollaborationProvider {
  * single-doc provider internally. One `documentId` maps to exactly one
  * room/provider/root identity.
  *
- * SuperDoc v2 supports three first-class provider families through this field:
- * y-websocket, Hocuspocus, and Liveblocks. The provider is selected with
- * `providerType`; omitting it preserves the original y-websocket-only shape
- * (`{ documentId, serverUrl, params? }`) for backward compatibility.
+ * SuperDoc v2 includes y-websocket, Hocuspocus, and Liveblocks adapters and can
+ * route a named provider extension through a configured collaboration Worker.
+ * The provider is selected with `providerType`; omitting it preserves the
+ * original y-websocket-only shape (`{ documentId, serverUrl, params? }`).
  *
  * This is intentionally distinct from the legacy provider-agnostic
- * {@link CollaborationConfig} (`Config.modules.collaboration`): v2 owns its
- * provider internally and does **not** accept an external Yjs `provider`/`ydoc`
- * through this field. External `{ ydoc, provider }` remains a v1 /
- * provider-compat concern only and is rejected as a v2 content driver.
+ * {@link CollaborationConfig} (`Config.modules.collaboration`): v2 owns the
+ * Y.Doc. Provider extensions receive that document inside the collaboration
+ * Worker instead of replacing it.
  */
-export type V2CollaborationConfig = V2YWebsocketCollaborationConfig | V2HocuspocusCollaborationConfig | V2LiveblocksCollaborationConfig;
+export type DocumentCollaborationConfig = V2YWebsocketCollaborationConfig | V2HocuspocusCollaborationConfig | V2LiveblocksCollaborationConfig | V2ProviderExtensionCollaborationConfig;
+/** @deprecated replaceWith=`DocumentCollaborationConfig` compat-indefinitely: existing v2 integrations import this type. */
+export type V2CollaborationConfig = DocumentCollaborationConfig;
 /**
  * y-websocket single-doc provider config.
  *
@@ -653,8 +657,8 @@ export interface V2HocuspocusCollaborationConfig {
     url?: string;
     /** Optional connection params forwarded to the backend. */
     params?: Record<string, string> | null;
-    /** Auth-message token forwarded to the Hocuspocus backend. */
-    token?: string;
+    /** Static auth token or resolver invoked for every Hocuspocus connection. */
+    token?: string | (() => string | Promise<string>);
     /** Explicit room operation. Defaults to `'join'`; `'create'` never joins an existing room. */
     roomMode?: 'join' | 'create';
 }
@@ -681,6 +685,20 @@ export interface V2LiveblocksCollaborationConfig {
     /** Explicit room operation. Defaults to `'join'`; `'create'` never joins an existing room. */
     roomMode?: 'join' | 'create';
 }
+/** Named provider adapter implemented by the configured collaboration Worker. */
+export interface V2ProviderExtensionCollaborationConfig {
+    providerType: 'extension';
+    /** Adapter registration key understood by the collaboration Worker. */
+    adapterId: string;
+    /** Stable shared document identity. */
+    documentId: string;
+    /** Structured-clone-safe options passed to the registered adapter factory. */
+    providerOptions?: unknown;
+    /** Optional host-owned credential resolver available to the adapter. */
+    token?: string | (() => string | Promise<string>);
+    /** Explicit room operation. Defaults to `'join'`; `'create'` never joins an existing room. */
+    roomMode?: 'join' | 'create';
+}
 export interface Comment {
     id?: string;
     commentId?: string;
@@ -932,29 +950,21 @@ export interface AwarenessUser extends User {
 }
 /**
  * One entry in the `states` array delivered to
- * {@link Config.onAwarenessUpdate}. SuperDoc emits an entry per remote
- * client, derived from the underlying Yjs awareness states.
+ * {@link Config.onAwarenessUpdate}. In V2, `states` includes the current
+ * user and remote participants. Do not append the current user again.
  *
- * The runtime helper `awarenessStatesToArray` spreads each remote user
- * onto the top of the entry (`{ clientId, ...value.user, color }`), so
- * `User` fields like `name`, `email`, `image` appear at the top level
- * (not nested under a `user` property). Consumers should read `state.id`,
- * `state.name`, and `state.email`, not `state.user.name`.
+ * Display fields such as `name`, `email`, and `color` are at the top
+ * level, not nested under `user`. Fields may be absent; a presence
+ * entry is not an authenticated account record.
  *
  * Application-specific fields attached to the awareness state by the
  * provider surface through the `[key: string]: unknown` index
  * signature; consumers narrow before use.
  */
 export interface AwarenessState extends User {
-    /** Yjs client identifier for the remote peer. */
+    /** Presence identifier. In V2, scoped to this editor instance, not a Yjs transport id. */
     clientId?: number;
-    /**
-     * Color assigned by SuperDoc's presence system. Spread onto the
-     * awareness entry after the user fields, so it takes precedence
-     * over any color the awareness user carried in (see
-     * {@link AwarenessUser.color}). Used when the presence system
-     * computes a stable palette assignment for the remote peer.
-     */
+    /** Resolved cursor color supplied by the presence system. */
     color?: string;
     /** Application-specific fields spread from the awareness provider. */
     [key: string]: unknown;
@@ -998,12 +1008,11 @@ export interface Document {
      */
     provider?: CollaborationProvider;
     /**
-     * Document-level v2 collaboration handoff. When present, the v2 runtime
-     * makes this document collaborative through the shipped single-doc
-     * y-websocket provider (one room / Y.Doc / awareness channel per
-     * `documentId`). See {@link V2CollaborationConfig}. Ignored by the v1
-     * editor, which uses `Config.modules.collaboration` instead.
+     * Connect this document to a shared room. SuperDoc owns the provider and Y.Doc.
+     * Takes precedence over `v2Collaboration`; `null` opens a local document.
      */
+    collaboration?: DocumentCollaborationConfig | null;
+    /** @deprecated replaceWith=`collaboration` compat-indefinitely: existing v2 integrations use this field. */
     v2Collaboration?: V2CollaborationConfig | null;
 }
 type DocumentSourceOptions = Omit<Document, 'data' | 'type' | 'url'>;
@@ -1126,9 +1135,8 @@ export interface CollaborationConfig {
 /**
  * Options for `upgradeToCollaboration()`.
  *
- * v2 promotes a local single-DOCX editor into the shipped single-doc
- * y-websocket room described by {@link V2CollaborationConfig}. Pass a
- * `v2Collaboration` target to promote into a supported v2 room.
+ * Promote a local DOCX into a shared room using `collaboration`.
+ * Supports the same providers as {@link DocumentCollaborationConfig}.
  *
  * The legacy `ydoc` / `provider` fields remain accepted for source
  * compatibility with v1-shaped callers, but v2 does **not** drive document
@@ -1138,14 +1146,15 @@ export interface CollaborationConfig {
  * fields are therefore optional and only honored when they resolve to a
  * supported v2 room.
  *
- * @see {@link V2CollaborationConfig}
+ * @see {@link DocumentCollaborationConfig}
  */
 export interface UpgradeToCollaborationOptions {
     /**
-     * Canonical supported v2 promotion target: the single-doc y-websocket room
-     * ({ documentId, serverUrl, params? }) to create from the current document.
-     * Promotion fails if the v2 room already exists.
+     * Create a shared room from the current document. Fails if the room already exists.
+     * Takes precedence over `v2Collaboration`.
      */
+    collaboration?: DocumentCollaborationConfig;
+    /** @deprecated replaceWith=`collaboration` compat-indefinitely: existing v2 integrations use this field. */
     v2Collaboration?: V2CollaborationConfig;
     /**
      * Legacy external Yjs document. Accepted for v1 source compatibility; not a
@@ -2781,12 +2790,6 @@ export interface TrackChangesModuleConfig {
     semanticColors?: TrackChangesSemanticColorsConfig;
 }
 export type DocumentMode = 'editing' | 'viewing' | 'suggesting';
-export type ExportType = 'docx';
-/**
- * - 'external': Include only external comments (default)
- * - 'clean': Export without any comments
- */
-export type CommentsType = 'external' | 'clean';
 /**
  * Document view layout values — mirrors OOXML ST_View (ECMA-376 §17.18.102).
  * - 'print': Print Layout View — displays document as it prints (default)
@@ -2805,30 +2808,6 @@ export interface ViewOptions {
      */
     layout?: ViewLayout;
 }
-export interface ExportParams {
-    /** Browser export format. DOCX is the only supported output. */
-    exportType?: readonly [ExportType];
-    /** How to handle comments. */
-    commentsType?: CommentsType;
-    /** Custom filename (without extension). */
-    exportedName?: string;
-    /** Extra files to include in the export zip. */
-    additionalFiles?: globalThis.Blob[];
-    /** Filenames for the additional files. */
-    additionalFileNames?: string[];
-    /** Whether this is a final document export. */
-    isFinalDoc?: boolean;
-    /** Auto-download or return blob. */
-    triggerDownload?: boolean;
-    /**
-     * Color for field highlights. The runtime defaults to `null` when no
-     * value is supplied (and forwards `null` through to the underlying
-     * editor export, which accepts `string | null`); the typedef accepts
-     * `null` explicitly so consumers can pass an explicit "no highlight"
-     * value without a typecheck failure.
-     */
-    fieldsHighlightColor?: string | null;
-}
 /** Surface where the edit originated. */
 export type EditorSurface = 'body' | 'header' | 'footer';
 export interface EditorUpdateEvent {
@@ -3242,6 +3221,14 @@ export interface SuperDocExceptionEditorPayload {
     /** Structured browser-worker failure detail when editor startup failed in its worker transport. */
     workerFailure?: SuperDocWorkerFailureDetail;
 }
+/** Connection failure while opening a collaboration room, reported through `onException`. */
+export interface SuperDocExceptionCollaborationPayload extends SuperDocExceptionEditorPayload {
+    error: Error;
+    code: 'collaboration-access-denied' | 'collaboration-connection-failed' | 'collaboration-sync-timeout';
+    /** Access denial requires an explicit provider rejection; a timeout is not proof of denied access. */
+    collaborationReason: 'access-denied' | 'connection-failed' | 'sync-timeout';
+    editor: null;
+}
 /**
  * Exception payload raised by the built-in toolbar.
  *
@@ -3311,6 +3298,7 @@ export interface SuperDocExceptionDiagnosticPayload {
  * Consumers can narrow with `'stage' in payload` (store init),
  * `'code' in payload` (editor lifecycle), `'itemName' in payload`
  * (built-in toolbar), `'source' in payload` (hyperlink activation),
+ * `'collaborationReason' in payload` (collaboration connection),
  * or `'diagnosticCode' in payload` (structured diagnostic).
  *
  * The union exists today because multiple independent emit sites pre-date a
@@ -3318,7 +3306,7 @@ export interface SuperDocExceptionDiagnosticPayload {
  * separate follow-up; consumers can narrow with the `in` checks above in the
  * meantime.
  */
-export type SuperDocExceptionPayload = SuperDocExceptionStorePayload | SuperDocExceptionRestorePayload | SuperDocExceptionEditorPayload | SuperDocExceptionToolbarPayload | SuperDocExceptionHyperlinkPayload | SuperDocExceptionDiagnosticPayload;
+export type SuperDocExceptionPayload = SuperDocExceptionStorePayload | SuperDocExceptionRestorePayload | SuperDocExceptionEditorPayload | SuperDocExceptionCollaborationPayload | SuperDocExceptionToolbarPayload | SuperDocExceptionHyperlinkPayload | SuperDocExceptionDiagnosticPayload;
 /**
  * Zoom mode. `manual` holds whatever value was last set; `fit-width`
  * continuously recomputes the zoom that fits the page width into the
@@ -3827,7 +3815,7 @@ export interface Config {
     role?: 'editor' | 'viewer' | 'suggester';
     /**
      * Document to open. Pass a URL, file, byte source, or structured source.
-     * Use a structured document carrying `v2Collaboration` for collaboration,
+     * Use a structured document carrying `collaboration` for collaboration,
      * or a structured source for other metadata. Omit it to open a blank DOCX.
      */
     document?: DocumentSource | null;

package/dist/superdoc/src/public/collaboration-worker.d.cts

@@ -0,0 +1,18 @@
+// Generated by scripts/ensure-types.cjs. Do not edit by hand.
+import type { SuperDocCollaborationProviderAdapter as __Cjs_SuperDocCollaborationProviderAdapter } from './collaboration-worker.js' with { "resolution-mode": "import" };
+import type { SuperDocCollaborationProviderAttachInput as __Cjs_SuperDocCollaborationProviderAttachInput } from './collaboration-worker.js' with { "resolution-mode": "import" };
+import type { SuperDocCollaborationProviderAwareness as __Cjs_SuperDocCollaborationProviderAwareness } from './collaboration-worker.js' with { "resolution-mode": "import" };
+import type { SuperDocCollaborationProviderFactory as __Cjs_SuperDocCollaborationProviderFactory } from './collaboration-worker.js' with { "resolution-mode": "import" };
+import type { SuperDocCollaborationProviderFactoryInput as __Cjs_SuperDocCollaborationProviderFactoryInput } from './collaboration-worker.js' with { "resolution-mode": "import" };
+import type { SuperDocCollaborationProviderFamily as __Cjs_SuperDocCollaborationProviderFamily } from './collaboration-worker.js' with { "resolution-mode": "import" };
+import type { SuperDocCollaborationProviderTransport as __Cjs_SuperDocCollaborationProviderTransport } from './collaboration-worker.js' with { "resolution-mode": "import" };
+import type { SuperDocCollaborationWorkerOptions as __Cjs_SuperDocCollaborationWorkerOptions } from './collaboration-worker.js' with { "resolution-mode": "import" };
+export declare const bootstrapSuperDocCollaborationWorker: typeof import('./collaboration-worker.js', { with: { "resolution-mode": "import" } }).bootstrapSuperDocCollaborationWorker;
+export type { __Cjs_SuperDocCollaborationProviderAdapter as SuperDocCollaborationProviderAdapter };
+export type { __Cjs_SuperDocCollaborationProviderAttachInput as SuperDocCollaborationProviderAttachInput };
+export type { __Cjs_SuperDocCollaborationProviderAwareness as SuperDocCollaborationProviderAwareness };
+export type { __Cjs_SuperDocCollaborationProviderFactory as SuperDocCollaborationProviderFactory };
+export type { __Cjs_SuperDocCollaborationProviderFactoryInput as SuperDocCollaborationProviderFactoryInput };
+export type { __Cjs_SuperDocCollaborationProviderFamily as SuperDocCollaborationProviderFamily };
+export type { __Cjs_SuperDocCollaborationProviderTransport as SuperDocCollaborationProviderTransport };
+export type { __Cjs_SuperDocCollaborationWorkerOptions as SuperDocCollaborationWorkerOptions };

package/dist/superdoc/src/public/collaboration-worker.d.ts

@@ -0,0 +1,48 @@
+import { Doc as YDoc } from 'yjs';
+export type SuperDocCollaborationProviderFamily = 'y-websocket' | 'hocuspocus' | 'liveblocks';
+export interface SuperDocCollaborationProviderAwareness {
+    getLocalState(): Record<string, unknown> | null;
+    setLocalState(state: Record<string, unknown> | null): void;
+    getStates(): Map<number, Record<string, unknown>>;
+    on(event: 'change' | 'update', listener: (payload: {
+        added: number[];
+        updated: number[];
+        removed: number[];
+    }) => void): void;
+    off(event: 'change' | 'update', listener: (payload: {
+        added: number[];
+        updated: number[];
+        removed: number[];
+    }) => void): void;
+}
+export interface SuperDocCollaborationProviderAttachInput {
+    readonly rootId: string;
+    readonly ydoc: YDoc;
+    readonly providerRoomName: string;
+    onSynced(): void;
+    onDegraded(): void;
+    onFailed(detail: Record<string, unknown>): void;
+    onStateless(message: string): void;
+}
+export interface SuperDocCollaborationProviderTransport {
+    readonly awareness?: SuperDocCollaborationProviderAwareness | null;
+    disconnect(): void;
+    destroy(): void;
+    sendStateless?(message: string): Promise<void> | void;
+}
+export interface SuperDocCollaborationProviderAdapter {
+    readonly providerFamily: SuperDocCollaborationProviderFamily;
+    attach(input: SuperDocCollaborationProviderAttachInput): SuperDocCollaborationProviderTransport;
+    destroy?(): void;
+}
+export interface SuperDocCollaborationProviderFactoryInput {
+    readonly documentId: string;
+    readonly providerOptions: unknown;
+    readonly token: string | (() => Promise<string>) | null;
+}
+export type SuperDocCollaborationProviderFactory = (input: SuperDocCollaborationProviderFactoryInput) => SuperDocCollaborationProviderAdapter;
+export interface SuperDocCollaborationWorkerOptions {
+    readonly providerAdapters: Readonly<Record<string, SuperDocCollaborationProviderFactory>>;
+}
+/** Register provider adapters and start the worker used by `workerUrls.collaboration`. */
+export declare function bootstrapSuperDocCollaborationWorker(options: SuperDocCollaborationWorkerOptions): void;

package/dist/superdoc/src/public/export-types.d.ts

@@ -0,0 +1,23 @@
+/** Browser export format. DOCX is the only supported output. */
+export type ExportType = 'docx';
+/** Comment output: `external` includes external comments; `clean` removes comments. */
+export type CommentsType = 'external' | 'clean';
+/** Options accepted by `SuperDoc.export()` and `ui.document.export()`. */
+export interface ExportParams {
+    /** Browser export format. DOCX is the only supported output. */
+    exportType?: readonly [ExportType];
+    /** How to handle comments. */
+    commentsType?: CommentsType;
+    /** Custom filename without an extension. */
+    exportedName?: string;
+    /** Extra files to include in the export zip. */
+    additionalFiles?: globalThis.Blob[];
+    /** Filenames for the additional files. */
+    additionalFileNames?: string[];
+    /** Whether this is a final document export. */
+    isFinalDoc?: boolean;
+    /** Download the file or return its Blob without downloading. */
+    triggerDownload?: boolean;
+    /** Field-highlight color, or `null` to omit field highlighting. */
+    fieldsHighlightColor?: string | null;
+}

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

@@ -38,6 +38,7 @@ import type { DirectSurfaceRequest as __Cjs_DirectSurfaceRequest } from './index
 import type { DocRange as __Cjs_DocRange } from './index.js' with { "resolution-mode": "import" };
 import type { Document as __Cjs_Document } from './index.js' with { "resolution-mode": "import" };
 import type { DocumentApi as __Cjs_DocumentApi } from './index.js' with { "resolution-mode": "import" };
+import type { DocumentCollaborationConfig as __Cjs_DocumentCollaborationConfig } from './index.js' with { "resolution-mode": "import" };
 import type { DocumentDataSource as __Cjs_DocumentDataSource } from './index.js' with { "resolution-mode": "import" };
 import type { DocumentMode as __Cjs_DocumentMode } from './index.js' with { "resolution-mode": "import" };
 import type { DocumentProtectionState as __Cjs_DocumentProtectionState } from './index.js' with { "resolution-mode": "import" };
@@ -131,6 +132,7 @@ import type { SuperDocDiagnosticStage as __Cjs_SuperDocDiagnosticStage } from '.
 import type { SuperDocDisposableBag as __Cjs_SuperDocDisposableBag } from './index.js' with { "resolution-mode": "import" };
 import type { SuperDocDocumentModeChangePayload as __Cjs_SuperDocDocumentModeChangePayload } from './index.js' with { "resolution-mode": "import" };
 import type { SuperDocEditorPayload as __Cjs_SuperDocEditorPayload } from './index.js' with { "resolution-mode": "import" };
+import type { SuperDocExceptionCollaborationPayload as __Cjs_SuperDocExceptionCollaborationPayload } from './index.js' with { "resolution-mode": "import" };
 import type { SuperDocExceptionDiagnosticPayload as __Cjs_SuperDocExceptionDiagnosticPayload } from './index.js' with { "resolution-mode": "import" };
 import type { SuperDocExceptionEditorPayload as __Cjs_SuperDocExceptionEditorPayload } from './index.js' with { "resolution-mode": "import" };
 import type { SuperDocExceptionHyperlinkPayload as __Cjs_SuperDocExceptionHyperlinkPayload } from './index.js' with { "resolution-mode": "import" };
@@ -213,6 +215,10 @@ import type { SurfacesModuleConfig as __Cjs_SurfacesModuleConfig } from './index
 import type { TextAddress as __Cjs_TextAddress } from './index.js' with { "resolution-mode": "import" };
 import type { TextSegment as __Cjs_TextSegment } from './index.js' with { "resolution-mode": "import" };
 import type { TextTarget as __Cjs_TextTarget } from './index.js' with { "resolution-mode": "import" };
+import type { ThemeColors as __Cjs_ThemeColors } from './index.js' with { "resolution-mode": "import" };
+import type { ThemeConfig as __Cjs_ThemeConfig } from './index.js' with { "resolution-mode": "import" };
+import type { ThemeResult as __Cjs_ThemeResult } from './index.js' with { "resolution-mode": "import" };
+import type { ThemeVariableOverrides as __Cjs_ThemeVariableOverrides } from './index.js' with { "resolution-mode": "import" };
 import type { ToolbarCommandId as __Cjs_ToolbarCommandId } from './index.js' with { "resolution-mode": "import" };
 import type { ToolbarConfig as __Cjs_ToolbarConfig } from './index.js' with { "resolution-mode": "import" };
 import type { ToolbarCustomButton as __Cjs_ToolbarCustomButton } from './index.js' with { "resolution-mode": "import" };
@@ -298,6 +304,7 @@ export type { __Cjs_DirectSurfaceRequest as DirectSurfaceRequest };
 export type { __Cjs_DocRange as DocRange };
 export type { __Cjs_Document as Document };
 export type { __Cjs_DocumentApi as DocumentApi };
+export type { __Cjs_DocumentCollaborationConfig as DocumentCollaborationConfig };
 export type { __Cjs_DocumentDataSource as DocumentDataSource };
 export type { __Cjs_DocumentMode as DocumentMode };
 export type { __Cjs_DocumentProtectionState as DocumentProtectionState };
@@ -396,6 +403,7 @@ export type { __Cjs_SuperDocDiagnosticStage as SuperDocDiagnosticStage };
 export type { __Cjs_SuperDocDisposableBag as SuperDocDisposableBag };
 export type { __Cjs_SuperDocDocumentModeChangePayload as SuperDocDocumentModeChangePayload };
 export type { __Cjs_SuperDocEditorPayload as SuperDocEditorPayload };
+export type { __Cjs_SuperDocExceptionCollaborationPayload as SuperDocExceptionCollaborationPayload };
 export type { __Cjs_SuperDocExceptionDiagnosticPayload as SuperDocExceptionDiagnosticPayload };
 export type { __Cjs_SuperDocExceptionEditorPayload as SuperDocExceptionEditorPayload };
 export type { __Cjs_SuperDocExceptionHyperlinkPayload as SuperDocExceptionHyperlinkPayload };
@@ -478,6 +486,10 @@ export type { __Cjs_SurfacesModuleConfig as SurfacesModuleConfig };
 export type { __Cjs_TextAddress as TextAddress };
 export type { __Cjs_TextSegment as TextSegment };
 export type { __Cjs_TextTarget as TextTarget };
+export type { __Cjs_ThemeColors as ThemeColors };
+export type { __Cjs_ThemeConfig as ThemeConfig };
+export type { __Cjs_ThemeResult as ThemeResult };
+export type { __Cjs_ThemeVariableOverrides as ThemeVariableOverrides };
 export type { __Cjs_ToolbarCommandId as ToolbarCommandId };
 export type { __Cjs_ToolbarConfig as ToolbarConfig };
 export type { __Cjs_ToolbarCustomButton as ToolbarCustomButton };

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

@@ -9,6 +9,7 @@ export { DOCX, PDF, HTML, getFileObject, compareVersions };
 export { SuperDoc } from '../core/SuperDoc.js';
 export { buildTheme } from '../core/theme/create-theme.js';
 export { createTheme } from '../core/theme/create-theme.js';
+export type { ThemeColors, ThemeConfig, ThemeResult, ThemeVariableOverrides } from '../core/theme/create-theme.js';
 export type { AwarenessState } from '../core/types/index.js';
 export type { AwarenessUser } from '../core/types/index.js';
 export type { BlockNavigationAddress } from '../core/types/index.js';
@@ -23,6 +24,7 @@ export type { Config } from '../core/types/index.js';
 export type { DirectSurfaceRequest } from '../core/types/index.js';
 export type { DocRange } from '../core/types/index.js';
 export type { Document } from '../core/types/index.js';
+export type { DocumentCollaborationConfig } from '../core/types/index.js';
 export type { DocumentDataSource } from '../core/types/index.js';
 export type { DocumentSource } from '../core/types/index.js';
 export type { DocumentUploadSource } from '../core/types/index.js';
@@ -86,6 +88,7 @@ export type { SuperDocWorkerFailureDetail } from '../core/types/index.js';
 export type { SuperDocExceptionHyperlinkPayload } from '../core/types/index.js';
 export type { SuperDocExceptionToolbarPayload } from '../core/types/index.js';
 export type { SuperDocExceptionPayload } from '../core/types/index.js';
+export type { SuperDocExceptionCollaborationPayload } from '../core/types/index.js';
 export type { SuperDocExceptionRestorePayload } from '../core/types/index.js';
 export type { SuperDocExceptionStorePayload } from '../core/types/index.js';
 export type { SuperDocFitWidthOptions } from '../core/types/index.js';

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

@@ -1,5 +1,6 @@
 import { CommentsListQuery as DocumentApiCommentsListQuery, CommentsListResult, TrackChangesListResult, EntityAddress, TextAddress, TextTarget, ScrollIntoViewInput, ScrollIntoViewOutput, SelectionInfo, SelectionTarget, Receipt, ReceiptFailureCode, ContentControlInfo, StyleCatalogItem, StyleCatalogDiagnostic, StyleCatalogSourceStatus, StylesGetCatalogInput, StylesGetCatalogResult } from '../../../../document-api/src/index.js';
 import { PartialBrowserDocumentApi } from '../browser-document-api.js';
+import { ExportParams } from '../export-types.js';
 import { SuperDocUIReason } from './reasons.js';
 import { BuiltInCommandId } from './commands.js';
 /**
@@ -657,7 +658,7 @@ export interface DocumentSlice {
     ready: boolean;
     /** Current document mode. */
     mode: 'editing' | 'suggesting' | 'viewing' | null;
-    /** The document has unsaved changes. */
+    /** The current document has local changes. */
     dirty: boolean;
 }
 /**
@@ -735,7 +736,10 @@ export interface StylesHandle extends SnapshotSubscribable<StylesSlice> {
     /** Resolve the active paragraph style for the current selection. */
     getActiveParagraphStyle(): ActiveParagraphStyle;
 }
-/** A painted rectangle in viewport coordinates. */
+/**
+ * A painted document rectangle. Coordinates use browser client space by
+ * default, or the element-relative space requested through `relativeTo`.
+ */
 export interface ViewportRect {
     /** Zero-based page index the rect belongs to. */
     pageIndex: number;
@@ -762,7 +766,7 @@ export type ViewportGetRectTarget = SelectionTarget | TextAddress | TextTarget |
 export interface ViewportGetRectInput {
     /** Target to resolve to painted geometry. */
     target: ViewportGetRectTarget;
-    /** Optional element to anchor returned coordinates against. */
+    /** Return coordinates relative to this element instead of browser client space. */
     relativeTo?: HTMLElement;
 }
 /** Result of `ui.viewport.getRect`. */
@@ -791,7 +795,7 @@ export interface SelectionHandle extends SnapshotSubscribable<SelectionSlice> {
      * Returns `null` before the first async browser read settles.
      */
     current(): SelectionInfo | null;
-    /** Freeze the current selection for later comment/format actions. */
+    /** Preserve the current non-empty selection for work that moves focus into application UI. */
     capture(): SelectionCapture | null;
     /**
      * Restore a previously captured selection, best-effort. Never throws;
@@ -820,7 +824,9 @@ export interface SelectionHandle extends SnapshotSubscribable<SelectionSlice> {
         relativeTo?: HTMLElement;
     }): readonly ViewportRect[];
 }
+/** A non-empty selection snapshot preserved independently of browser focus. */
 export interface SelectionCapture extends SelectionSlice {
+    /** Unix time in milliseconds when the selection was captured. */
     capturedAt: number;
 }
 /**
@@ -1144,8 +1150,8 @@ export interface DocumentHandle extends SnapshotSubscribable<DocumentSlice> {
     getSnapshot(): DocumentSlice;
     /** Set the document mode (editing / suggesting / viewing). */
     setMode(mode: 'editing' | 'suggesting' | 'viewing'): void;
-    /** Export the document; returns the SuperDoc export promise when available. */
-    export(input?: unknown): Promise<unknown> | undefined;
+    /** Export the document and return the produced Blob, optionally downloading it. */
+    export(input?: ExportParams): Promise<Blob> | undefined;
     /** Read text through the Document API; `null` when unavailable. */
     getText(): string | null;
     /** Replace the active document file, when supported by the host. */
@@ -1153,9 +1159,12 @@ export interface DocumentHandle extends SnapshotSubscribable<DocumentSlice> {
 }
 /** Viewport handle. */
 export interface ViewportHandle {
-    /** Resolve painted geometry for an entity / content-control address. */
+    /** Resolve current painted geometry for a selection, text target, or supported entity address. */
     getRect(input: ViewportGetRectInput): ViewportRectResult;
-    /** Subscribe to viewport/geometry invalidation. */
+    /**
+     * Subscribe to geometry invalidation after selection, zoom, scroll, resize,
+     * layout, or repaint changes. The callback is coalesced to one per frame.
+     */
     observe(listener: () => void): () => void;
     /** Painted editor host element, when available. */
     getHost(): HTMLElement | null;
@@ -1433,7 +1442,7 @@ export interface SuperDocLike {
     /** Set the document mode across the instance. */
     setDocumentMode?(mode: string): unknown;
     /** Export the active document. */
-    export?(...args: unknown[]): Promise<unknown> | unknown;
+    export?(params?: ExportParams): Promise<Blob> | Blob;
     /** Set an absolute zoom value. */
     setZoom?(value: number): unknown;
     /** Set a zoom mode. */