superdoc 2.13.0-next.10 → 2.13.0-next.11

package/dist/chunks/{create-super-doc-ui-mHK2pqj3.cjs → create-super-doc-ui-DNfQTF2k.cjs}

@@ -3111,6 +3111,18 @@ function commandResultFromOperationResult(result) {
 function isSuccessfulReceipt(result) {
 	return Boolean(result) && typeof result === "object" && result.success === true;
 }
+/**
+* The host also emits `mutation:committed` for previews and no-op receipts;
+* those events must not mark the document as having unsaved edits.
+*/
+function mutationCommittedEventChangedDocument(event) {
+	if (event.dryRun === true) return false;
+	const receipt = event.receipt;
+	if (receipt && typeof receipt === "object" && receipt.changed === false) return false;
+	if (receipt && typeof receipt === "object" && receipt.noop === true) return false;
+	if (receipt && typeof receipt === "object" && receipt.status === "NO_OP") return false;
+	return true;
+}
 function commandResultSucceeded(result) {
 	if (result === false) return false;
 	if (result && typeof result === "object" && result.success === false) return false;
@@ -3917,6 +3929,30 @@ function createSuperDocUI(options) {
 	let allTrackedChangesResolvedToken = null;
 	let selectionEpoch = 0;
 	let lastCoordinatorEditor = null;
+	/**
+	* Fallback dirty state for editors that do not expose `isDirty` (V2). Kept
+	* per host so switching the active editor away and back does not forget an
+	* edit, and seeded from the host's local mutation revision so a controller
+	* created after the first edit still reports it. A document replacement or
+	* a verified zero revision clears an entry: `save:completed` fires for every DOCX export,
+	* including a download, and producing bytes is not persistence.
+	*/
+	const dirtyHosts = /* @__PURE__ */ new WeakSet();
+	const hostSeededMutationRevision = /* @__PURE__ */ new WeakMap();
+	const seedLocalDocumentMutation = (host) => {
+		if (hostSeededMutationRevision.has(host)) return;
+		const revision = typeof host.getLocalMutationRevision === "function" ? safeCall(() => host.getLocalMutationRevision(), null) : null;
+		const seeded = typeof revision === "number" ? revision : 0;
+		hostSeededMutationRevision.set(host, seeded);
+		if (seeded > 0) dirtyHosts.add(host);
+		else if (revision === 0) dirtyHosts.delete(host);
+	};
+	const hasLocalDocumentMutation = () => {
+		const host = getHost();
+		if (!host) return false;
+		seedLocalDocumentMutation(host);
+		return dirtyHosts.has(host);
+	};
 	/** Token shared by document-content reads (editor identity + mutation revision). */
 	const contentToken = () => `${editorIdentityId(getEditor())}|m${documentMutationRevision}`;
 	const clearPostDecisionTrackChanges = () => {
@@ -5184,10 +5220,11 @@ function createSuperDocUI(options) {
 	};
 	const computeDocument = () => {
 		const editor = getEditor();
+		const editorDirty = editor ? editor.isDirty : void 0;
 		return {
 			ready: editor != null,
 			mode: readDocumentMode(),
-			dirty: editor ? Boolean(editor.isDirty) : false
+			dirty: editor ? editorDirty === void 0 ? hasLocalDocumentMutation() : Boolean(editorDirty) : false
 		};
 	};
 	/**
@@ -7114,7 +7151,8 @@ function createSuperDocUI(options) {
 	state = computeState("initial");
 	lastOptimisticInlineSelectionSignature = selectionInlineValueSignature(state.selection);
 	const syncHostEventsSubscription = () => {
-		const events = (getEditor()?.host)?.events;
+		const host = getEditor()?.host;
+		const events = host?.events;
 		const next = events && typeof events.subscribe === "function" ? events : null;
 		if (next === currentHostEventsSource) return;
 		if (detachHostEvents) {
@@ -7123,9 +7161,24 @@ function createSuperDocUI(options) {
 		}
 		currentHostEventsSource = next;
 		if (!next) return;
+		if (host) {
+			hostSeededMutationRevision.delete(host);
+			seedLocalDocumentMutation(host);
+		}
 		try {
 			const off = next.subscribe((event) => {
 				const type = event?.type;
+				const isStandaloneDocumentMutation = type === "document:mutated" && event.hasCommitEvent !== true;
+				if ((type === "document:mutated" || type === "mutation:committed" && mutationCommittedEventChangedDocument(event)) && host && !dirtyHosts.has(host)) {
+					dirtyHosts.add(host);
+					recompute("document-dirty");
+				}
+				if (type === "collaboration:document-replaced" && host) {
+					dirtyHosts.delete(host);
+					hostSeededMutationRevision.delete(host);
+					seedLocalDocumentMutation(host);
+					recompute("document-dirty");
+				}
 				if (type === "review-mutation:started") {
 					beginUiReviewMutation(event.reviewMutation?.token);
 					return;
@@ -7145,8 +7198,8 @@ function createSuperDocUI(options) {
 					refreshIncompleteTrackChangesDirectories();
 					return;
 				}
-				if (type === "mutation:committed" || type === "collaboration:remote-changed") lastEditableMutationAtMs = Date.now();
-				if (type === "mutation:committed" || type === "save:completed" || type === "collaboration:remote-changed") {
+				if (isStandaloneDocumentMutation || type === "mutation:committed" || type === "collaboration:remote-changed") lastEditableMutationAtMs = Date.now();
+				if (isStandaloneDocumentMutation || type === "mutation:committed" || type === "save:completed" || type === "collaboration:remote-changed") {
 					const impact = type === "mutation:committed" ? getV2TrackedChangeMutationImpact(event) : null;
 					if (impact?.allResolved) {
 						replaceTrackedChangeItemsInCache([]);
@@ -7161,7 +7214,7 @@ function createSuperDocUI(options) {
 						return;
 					}
 					if (impact?.removedIds.size && impact.upsertIds.size === 0) return;
-					if (type === "collaboration:remote-changed" || type === "mutation:committed" && !isTypingBurst) schedulePostPaintContentRefresh();
+					if (isStandaloneDocumentMutation || type === "collaboration:remote-changed" || type === "mutation:committed" && !isTypingBurst) schedulePostPaintContentRefresh();
 					const remoteCommentsPartChanged = type === "collaboration:remote-changed" && Array.isArray(event.changedPartUris) && event.changedPartUris.some((partUri) => typeof partUri === "string" && COMMENTS_CATALOG_PART_URIS.has(partUri));
 					const loadedCommentAnchorsMayHaveChanged = type === "collaboration:remote-changed" && Array.isArray(event.changedStoryIds) && event.changedStoryIds.length > 0 && commentsCatalogMayHaveRows();
 					if (remoteCommentsPartChanged && !isTypingBurst) heavyReadsHeldUntilIdle = true;
@@ -7275,6 +7328,11 @@ function createSuperDocUI(options) {
 				const matchesEditor = Boolean(replacedEditor) && replacedEditor === getEditor();
 				const matchesHost = Boolean(replacedHost) && replacedHost === getHost();
 				if (!matchesEditor && !matchesHost) return;
+				const replacedDirtyHost = matchesHost ? replacedHost : getHost();
+				if (replacedDirtyHost) {
+					dirtyHosts.delete(replacedDirtyHost);
+					hostSeededMutationRevision.delete(replacedDirtyHost);
+				}
 				runDocumentResetHooks();
 				asyncReads.clear();
 				invalidateDocumentContent();

package/dist/chunks/{create-super-doc-ui-u1giSvlm.es.js → create-super-doc-ui-XWtQHPGP.es.js}

@@ -3111,6 +3111,18 @@ function commandResultFromOperationResult(result) {
 function isSuccessfulReceipt(result) {
 	return Boolean(result) && typeof result === "object" && result.success === true;
 }
+/**
+* The host also emits `mutation:committed` for previews and no-op receipts;
+* those events must not mark the document as having unsaved edits.
+*/
+function mutationCommittedEventChangedDocument(event) {
+	if (event.dryRun === true) return false;
+	const receipt = event.receipt;
+	if (receipt && typeof receipt === "object" && receipt.changed === false) return false;
+	if (receipt && typeof receipt === "object" && receipt.noop === true) return false;
+	if (receipt && typeof receipt === "object" && receipt.status === "NO_OP") return false;
+	return true;
+}
 function commandResultSucceeded(result) {
 	if (result === false) return false;
 	if (result && typeof result === "object" && result.success === false) return false;
@@ -3917,6 +3929,30 @@ function createSuperDocUI(options) {
 	let allTrackedChangesResolvedToken = null;
 	let selectionEpoch = 0;
 	let lastCoordinatorEditor = null;
+	/**
+	* Fallback dirty state for editors that do not expose `isDirty` (V2). Kept
+	* per host so switching the active editor away and back does not forget an
+	* edit, and seeded from the host's local mutation revision so a controller
+	* created after the first edit still reports it. A document replacement or
+	* a verified zero revision clears an entry: `save:completed` fires for every DOCX export,
+	* including a download, and producing bytes is not persistence.
+	*/
+	const dirtyHosts = /* @__PURE__ */ new WeakSet();
+	const hostSeededMutationRevision = /* @__PURE__ */ new WeakMap();
+	const seedLocalDocumentMutation = (host) => {
+		if (hostSeededMutationRevision.has(host)) return;
+		const revision = typeof host.getLocalMutationRevision === "function" ? safeCall(() => host.getLocalMutationRevision(), null) : null;
+		const seeded = typeof revision === "number" ? revision : 0;
+		hostSeededMutationRevision.set(host, seeded);
+		if (seeded > 0) dirtyHosts.add(host);
+		else if (revision === 0) dirtyHosts.delete(host);
+	};
+	const hasLocalDocumentMutation = () => {
+		const host = getHost();
+		if (!host) return false;
+		seedLocalDocumentMutation(host);
+		return dirtyHosts.has(host);
+	};
 	/** Token shared by document-content reads (editor identity + mutation revision). */
 	const contentToken = () => `${editorIdentityId(getEditor())}|m${documentMutationRevision}`;
 	const clearPostDecisionTrackChanges = () => {
@@ -5184,10 +5220,11 @@ function createSuperDocUI(options) {
 	};
 	const computeDocument = () => {
 		const editor = getEditor();
+		const editorDirty = editor ? editor.isDirty : void 0;
 		return {
 			ready: editor != null,
 			mode: readDocumentMode(),
-			dirty: editor ? Boolean(editor.isDirty) : false
+			dirty: editor ? editorDirty === void 0 ? hasLocalDocumentMutation() : Boolean(editorDirty) : false
 		};
 	};
 	/**
@@ -7114,7 +7151,8 @@ function createSuperDocUI(options) {
 	state = computeState("initial");
 	lastOptimisticInlineSelectionSignature = selectionInlineValueSignature(state.selection);
 	const syncHostEventsSubscription = () => {
-		const events = (getEditor()?.host)?.events;
+		const host = getEditor()?.host;
+		const events = host?.events;
 		const next = events && typeof events.subscribe === "function" ? events : null;
 		if (next === currentHostEventsSource) return;
 		if (detachHostEvents) {
@@ -7123,9 +7161,24 @@ function createSuperDocUI(options) {
 		}
 		currentHostEventsSource = next;
 		if (!next) return;
+		if (host) {
+			hostSeededMutationRevision.delete(host);
+			seedLocalDocumentMutation(host);
+		}
 		try {
 			const off = next.subscribe((event) => {
 				const type = event?.type;
+				const isStandaloneDocumentMutation = type === "document:mutated" && event.hasCommitEvent !== true;
+				if ((type === "document:mutated" || type === "mutation:committed" && mutationCommittedEventChangedDocument(event)) && host && !dirtyHosts.has(host)) {
+					dirtyHosts.add(host);
+					recompute("document-dirty");
+				}
+				if (type === "collaboration:document-replaced" && host) {
+					dirtyHosts.delete(host);
+					hostSeededMutationRevision.delete(host);
+					seedLocalDocumentMutation(host);
+					recompute("document-dirty");
+				}
 				if (type === "review-mutation:started") {
 					beginUiReviewMutation(event.reviewMutation?.token);
 					return;
@@ -7145,8 +7198,8 @@ function createSuperDocUI(options) {
 					refreshIncompleteTrackChangesDirectories();
 					return;
 				}
-				if (type === "mutation:committed" || type === "collaboration:remote-changed") lastEditableMutationAtMs = Date.now();
-				if (type === "mutation:committed" || type === "save:completed" || type === "collaboration:remote-changed") {
+				if (isStandaloneDocumentMutation || type === "mutation:committed" || type === "collaboration:remote-changed") lastEditableMutationAtMs = Date.now();
+				if (isStandaloneDocumentMutation || type === "mutation:committed" || type === "save:completed" || type === "collaboration:remote-changed") {
 					const impact = type === "mutation:committed" ? getV2TrackedChangeMutationImpact(event) : null;
 					if (impact?.allResolved) {
 						replaceTrackedChangeItemsInCache([]);
@@ -7161,7 +7214,7 @@ function createSuperDocUI(options) {
 						return;
 					}
 					if (impact?.removedIds.size && impact.upsertIds.size === 0) return;
-					if (type === "collaboration:remote-changed" || type === "mutation:committed" && !isTypingBurst) schedulePostPaintContentRefresh();
+					if (isStandaloneDocumentMutation || type === "collaboration:remote-changed" || type === "mutation:committed" && !isTypingBurst) schedulePostPaintContentRefresh();
 					const remoteCommentsPartChanged = type === "collaboration:remote-changed" && Array.isArray(event.changedPartUris) && event.changedPartUris.some((partUri) => typeof partUri === "string" && COMMENTS_CATALOG_PART_URIS.has(partUri));
 					const loadedCommentAnchorsMayHaveChanged = type === "collaboration:remote-changed" && Array.isArray(event.changedStoryIds) && event.changedStoryIds.length > 0 && commentsCatalogMayHaveRows();
 					if (remoteCommentsPartChanged && !isTypingBurst) heavyReadsHeldUntilIdle = true;
@@ -7275,6 +7328,11 @@ function createSuperDocUI(options) {
 				const matchesEditor = Boolean(replacedEditor) && replacedEditor === getEditor();
 				const matchesHost = Boolean(replacedHost) && replacedHost === getHost();
 				if (!matchesEditor && !matchesHost) return;
+				const replacedDirtyHost = matchesHost ? replacedHost : getHost();
+				if (replacedDirtyHost) {
+					dirtyHosts.delete(replacedDirtyHost);
+					hostSeededMutationRevision.delete(replacedDirtyHost);
+				}
 				runDocumentResetHooks();
 				asyncReads.clear();
 				invalidateDocumentContent();

package/dist/collaboration-upgrade-engine.cjs

@@ -19,7 +19,7 @@ var COLLABORATION_UPGRADE_ENGINE_MINIMUM_NODE_MAJOR = 20;
 var PRIVATE_ENGINE_INFO = (0, _superdoc_docx_engine_collaboration_upgrade_engine.getCollaborationUpgradeEngineInfo)();
 var ENGINE_INFO = Object.freeze({
 	...PRIVATE_ENGINE_INFO,
-	superdocVersion: "2.13.0-next.10",
+	superdocVersion: "2.13.0-next.11",
 	roomSchemaVersion: Object.freeze({ ...PRIVATE_ENGINE_INFO.roomSchemaVersion }),
 	supportedBundleVersions: SUPPORTED_COLLABORATION_UPGRADE_BUNDLE_VERSIONS,
 	supportedV1ReaderContractVersions: SUPPORTED_V1_READER_CONTRACT_VERSIONS

package/dist/collaboration-upgrade-engine.es.js

@@ -18,7 +18,7 @@ var COLLABORATION_UPGRADE_ENGINE_MINIMUM_NODE_MAJOR = 20;
 var PRIVATE_ENGINE_INFO = getCollaborationUpgradeEngineInfo$1();
 var ENGINE_INFO = Object.freeze({
 	...PRIVATE_ENGINE_INFO,
-	superdocVersion: "2.13.0-next.10",
+	superdocVersion: "2.13.0-next.11",
 	roomSchemaVersion: Object.freeze({ ...PRIVATE_ENGINE_INFO.roomSchemaVersion }),
 	supportedBundleVersions: SUPPORTED_COLLABORATION_UPGRADE_BUNDLE_VERSIONS,
 	supportedV1ReaderContractVersions: SUPPORTED_V1_READER_CONTRACT_VERSIONS

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-mHK2pqj3.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-u1giSvlm.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-mHK2pqj3.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-u1giSvlm.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-mHK2pqj3.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-u1giSvlm.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/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/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

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.
@@ -2789,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)
@@ -2813,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 {

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

@@ -215,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" };
@@ -482,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';

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