superdoc 2.28.0 → 2.29.0-next.13

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

@@ -1,4 +1,4 @@
-import { DocumentApi, DynamicInvokeRequest, InvokeRequest, InvokeResult, OperationId, OperationCancellation, PlainTextInsertInput, TextReplaceInput, TrackedTextMutationOptions } from '../../../document-api/src/index.js';
+import { DocumentApi, DynamicInvokeRequest, InsertInput, InvokeRequest, InvokeResult, OperationId, OperationCancellation, ReplaceInput, TrackedReplaceMutationOptions, TrackedRichContentMutationOptions } from '../../../document-api/src/index.js';
 type MaybePromise<T> = T | Promise<T>;
 type BrowserDocumentApiObject<T> = {
     [K in keyof T]: BrowserDocumentApiValue<T[K]>;
@@ -14,13 +14,14 @@ type BrowserDocumentApiValue<T> = T extends (...args: infer Args) => infer Retur
 export type BrowserDocumentApi = Omit<BrowserDocumentApiObject<DocumentApi>, 'invoke'> & {
     invoke<T extends OperationId>(request: InvokeRequest<T>): MaybePromise<Awaited<InvokeResult<T>>>;
     invoke(request: DynamicInvokeRequest): unknown;
-    insert(input: PlainTextInsertInput, options: TrackedTextMutationOptions & OperationCancellation): MaybePromise<Awaited<ReturnType<DocumentApi['insert']>>>;
-    replace(input: Exclude<TextReplaceInput, {
+    insert(input: InsertInput, options: TrackedRichContentMutationOptions & OperationCancellation): MaybePromise<Awaited<ReturnType<DocumentApi['insert']>>>;
+    replace(input: Exclude<ReplaceInput, {
         target: {
             kind: 'story';
             storyType: 'body';
         };
-    }>, options: TrackedTextMutationOptions): MaybePromise<Awaited<ReturnType<DocumentApi['replace']>>>;
+        text: string;
+    }>, options: TrackedReplaceMutationOptions): MaybePromise<Awaited<ReturnType<DocumentApi['replace']>>>;
 };
 /**
  * Every operation optional, at any depth.

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

@@ -111,6 +111,19 @@ import type { PermissionRangeEditor as __Cjs_PermissionRangeEditor } from './ind
 import type { PermissionRangeEditorResolution as __Cjs_PermissionRangeEditorResolution } from './index.js' with { "resolution-mode": "import" };
 import type { PermissionResolver as __Cjs_PermissionResolver } from './index.js' with { "resolution-mode": "import" };
 import type { PermissionResolverParams as __Cjs_PermissionResolverParams } from './index.js' with { "resolution-mode": "import" };
+import type { ProofingCapabilities as __Cjs_ProofingCapabilities } from './index.js' with { "resolution-mode": "import" };
+import type { ProofingCheckRequest as __Cjs_ProofingCheckRequest } from './index.js' with { "resolution-mode": "import" };
+import type { ProofingCheckResult as __Cjs_ProofingCheckResult } from './index.js' with { "resolution-mode": "import" };
+import type { ProofingConfig as __Cjs_ProofingConfig } from './index.js' with { "resolution-mode": "import" };
+import type { ProofingError as __Cjs_ProofingError } from './index.js' with { "resolution-mode": "import" };
+import type { ProofingIssue as __Cjs_ProofingIssue } from './index.js' with { "resolution-mode": "import" };
+import type { ProofingIssueKind as __Cjs_ProofingIssueKind } from './index.js' with { "resolution-mode": "import" };
+import type { ProofingProvider as __Cjs_ProofingProvider } from './index.js' with { "resolution-mode": "import" };
+import type { ProofingSegment as __Cjs_ProofingSegment } from './index.js' with { "resolution-mode": "import" };
+import type { ProofingSegmentMetadata as __Cjs_ProofingSegmentMetadata } from './index.js' with { "resolution-mode": "import" };
+import type { ProofingStatus as __Cjs_ProofingStatus } from './index.js' with { "resolution-mode": "import" };
+import type { ProofingSuggestRequest as __Cjs_ProofingSuggestRequest } from './index.js' with { "resolution-mode": "import" };
+import type { ProofingSuggestResult as __Cjs_ProofingSuggestResult } from './index.js' with { "resolution-mode": "import" };
 import type { ResolvedFindReplaceTexts as __Cjs_ResolvedFindReplaceTexts } from './index.js' with { "resolution-mode": "import" };
 import type { ResolvedPasswordPromptTexts as __Cjs_ResolvedPasswordPromptTexts } from './index.js' with { "resolution-mode": "import" };
 import type { ResolveRangeOutput as __Cjs_ResolveRangeOutput } from './index.js' with { "resolution-mode": "import" };
@@ -413,6 +426,19 @@ export type { __Cjs_PermissionRangeEditor as PermissionRangeEditor };
 export type { __Cjs_PermissionRangeEditorResolution as PermissionRangeEditorResolution };
 export type { __Cjs_PermissionResolver as PermissionResolver };
 export type { __Cjs_PermissionResolverParams as PermissionResolverParams };
+export type { __Cjs_ProofingCapabilities as ProofingCapabilities };
+export type { __Cjs_ProofingCheckRequest as ProofingCheckRequest };
+export type { __Cjs_ProofingCheckResult as ProofingCheckResult };
+export type { __Cjs_ProofingConfig as ProofingConfig };
+export type { __Cjs_ProofingError as ProofingError };
+export type { __Cjs_ProofingIssue as ProofingIssue };
+export type { __Cjs_ProofingIssueKind as ProofingIssueKind };
+export type { __Cjs_ProofingProvider as ProofingProvider };
+export type { __Cjs_ProofingSegment as ProofingSegment };
+export type { __Cjs_ProofingSegmentMetadata as ProofingSegmentMetadata };
+export type { __Cjs_ProofingStatus as ProofingStatus };
+export type { __Cjs_ProofingSuggestRequest as ProofingSuggestRequest };
+export type { __Cjs_ProofingSuggestResult as ProofingSuggestResult };
 export type { __Cjs_ResolvedFindReplaceTexts as ResolvedFindReplaceTexts };
 export type { __Cjs_ResolvedPasswordPromptTexts as ResolvedPasswordPromptTexts };
 export declare const resolvePermissionRangeEditor: typeof import('./index.js', { with: { "resolution-mode": "import" } }).resolvePermissionRangeEditor;

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

@@ -65,6 +65,19 @@ export type { PasswordPromptRenderContext } from '../core/types/index.js';
 export type { PasswordPromptResolution } from '../core/types/index.js';
 export type { PermissionResolver } from '../core/types/index.js';
 export type { PermissionResolverParams } from '../core/types/index.js';
+export type { ProofingCapabilities } from '../core/types/index.js';
+export type { ProofingCheckRequest } from '../core/types/index.js';
+export type { ProofingCheckResult } from '../core/types/index.js';
+export type { ProofingConfig } from '../core/types/index.js';
+export type { ProofingError } from '../core/types/index.js';
+export type { ProofingIssue } from '../core/types/index.js';
+export type { ProofingIssueKind } from '../core/types/index.js';
+export type { ProofingProvider } from '../core/types/index.js';
+export type { ProofingSegment } from '../core/types/index.js';
+export type { ProofingSegmentMetadata } from '../core/types/index.js';
+export type { ProofingStatus } from '../core/types/index.js';
+export type { ProofingSuggestRequest } from '../core/types/index.js';
+export type { ProofingSuggestResult } from '../core/types/index.js';
 export type { ResolvedFindReplaceTexts } from '../core/types/index.js';
 export type { ResolvedPasswordPromptTexts } from '../core/types/index.js';
 export type { ResolveRangeOutput } from '../../../document-api/src/index.js';

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

@@ -135,9 +135,9 @@ export interface FieldCommandSpec {
     instruction: string;
 }
 /** Number style of a section's pages, as Word's Format Page Numbers names them. */
-export type PageNumberFormat = 'decimal' | 'lowerLetter' | 'upperLetter' | 'lowerRoman' | 'upperRoman' | 'numberInDash' | 'hebrew1' | 'hebrew2';
+type PageNumberFormat = 'decimal' | 'lowerLetter' | 'upperLetter' | 'lowerRoman' | 'upperRoman' | 'numberInDash' | 'hebrew1' | 'hebrew2';
 /** Normalized input of the page-numbers-apply command. Omitted options keep the section's settings. */
-export interface PageNumbersApplyCommandInput {
+interface PageNumbersApplyCommandInput {
     /** 'header' numbers the top of the page, 'footer' the bottom. */
     kind: 'header' | 'footer';
     alignment?: 'left' | 'center' | 'right';
@@ -147,7 +147,7 @@ export interface PageNumbersApplyCommandInput {
     start?: number | null;
 }
 /** Normalized input of the page-numbers-remove command. */
-export interface PageNumbersRemoveCommandInput {
+interface PageNumbersRemoveCommandInput {
     /** Remove only the header's or the footer's numbers. Omitted removes both. */
     kind?: 'header' | 'footer';
 }
@@ -237,44 +237,44 @@ export interface CommandDescriptor {
     reason?: SuperDocUIReason;
 }
 /** Strip a trailing `pt` unit from v1-style font sizes (`"12pt"` → `"12"`). */
-export declare function normalizeFontSizePayload(payload: unknown): unknown;
+declare function normalizeFontSizePayload(payload: unknown): unknown;
 /**
  * Normalize v1-style zoom payloads to the percentage `SuperDoc.setZoom`
  * expects (`100 === 100%`). Accepts `150`, `"150%"`, `"1.5"`, or `1.5`.
  * Percentages pass through as numbers; legacy fraction-style values in the
  * `0..5` range are converted to percentages (`1.5` → `150`).
  */
-export declare function normalizeZoomPayload(payload: unknown): unknown;
+declare function normalizeZoomPayload(payload: unknown): unknown;
 /**
  * Normalize a measurement-unit payload to the `'in'` / `'cm'` form
  * `SuperDoc.setMeasurementUnit` expects. Accepts the canonical `'in'` / `'cm'`,
  * a `{ value }` wrapper, or common long forms (`"inches"`, `"centimeters"`).
  * An unrecognized value passes through so the instance method can reject it.
  */
-export declare function normalizeMeasurementUnitPayload(payload: unknown): unknown;
+declare function normalizeMeasurementUnitPayload(payload: unknown): unknown;
 /**
  * Normalize a v1-style color payload to the `#RRGGBB` form the inline
  * `format.color` / `format.highlight` operations expect. Accepts `"#RRGGBB"`,
  * `"RRGGBB"`, or `{ value }`. `null` (clear) passes through unchanged; an
  * unrecognized value is returned as-is so the operation can reject it.
  */
-export declare function normalizeColorPayload(payload: unknown): unknown;
+declare function normalizeColorPayload(payload: unknown): unknown;
 /** Normalize a v1 alignment payload (`"left"`, `{ value }`, `"justified"`) to a `ParagraphAlignment`. */
-export declare function normalizeAlignmentPayload(payload: unknown): unknown;
+declare function normalizeAlignmentPayload(payload: unknown): unknown;
 /**
  * Normalize a page-numbers-apply payload. `position` takes 'top' or 'bottom';
  * `kind` takes 'header' or 'footer'; without either the numbers go at the bottom
  * of the page, as in Word. Other omitted options keep the section's settings.
  * Returns null for a value it does not recognize, so the command fails closed.
  */
-export declare function normalizePageNumbersApplyPayload(payload: unknown): PageNumbersApplyCommandInput | null;
+declare function normalizePageNumbersApplyPayload(payload: unknown): PageNumbersApplyCommandInput | null;
 /** Normalize a page-numbers-remove payload: an optional `position` or `kind`. */
-export declare function normalizePageNumbersRemovePayload(payload: unknown): PageNumbersRemoveCommandInput | null;
-export declare function normalizeLineHeightPayload(payload: unknown): unknown;
+declare function normalizePageNumbersRemovePayload(payload: unknown): PageNumbersRemoveCommandInput | null;
+declare function normalizeLineHeightPayload(payload: unknown): unknown;
 /** Preserve semantic style intent; normalize legacy linked-style payloads to a concrete ID. */
-export declare function normalizeStyleIdPayload(payload: unknown): unknown;
+declare function normalizeStyleIdPayload(payload: unknown): unknown;
 /** Resolve a document-mode payload (`"viewing"` or `{ mode }`) to the mode string. */
-export declare function normalizeDocumentModePayload(payload: unknown): unknown;
+declare function normalizeDocumentModePayload(payload: unknown): unknown;
 /**
  * The built-in command catalog. Order is documentation-only. Every v1
  * headless-toolbar id appears here with an explicit disposition; the 14
@@ -797,3 +797,4 @@ export declare const COMMAND_CATALOG: readonly [{
 export declare const ALL_BUILT_IN_COMMAND_IDS: readonly BuiltInCommandId[];
 /** Resolve a command descriptor by id, or `null` when the id is unknown. */
 export declare function getCommandDescriptor(id: string): CommandDescriptor | null;
+export {};

package/dist/superdoc/src/public/ui/create-super-doc-ui.d.ts

@@ -25,7 +25,7 @@ export declare function executeFirstPartyShortcutAsync(ui: object, id: string, p
  * tested set. Keys are coordinator cache keys (exact) or key families
  * (prefix). See the gate in `readAsync` for the runtime semantics.
  */
-export interface HeavyDocReadPolicyEntry {
+interface HeavyDocReadPolicyEntry {
     key: string;
     match: 'exact' | 'prefix';
     /** Audit rationale — why this key is catalog-scale (or reserved). */

package/dist/superdoc/src/public/ui/entity-at.d.ts

@@ -8,7 +8,7 @@ import { ViewportEntityHit } from './types.js';
  * fresh). Kept off the public {@link ViewportEntityHit} so consumers still only
  * switch on the typed public shape.
  */
-export interface CollectedEntityHit extends ViewportEntityHit {
+interface CollectedEntityHit extends ViewportEntityHit {
     storyKey?: string;
 }
 export declare function collectDecorationProvidersFromChain(start: Element | null, stopAt: Element): string[];
@@ -28,3 +28,4 @@ export declare function collectDecorationProvidersFromChain(start: Element | nul
  * browser) without an `instanceof` check that could fail across realms.
  */
 export declare function collectEntityHitsFromChain(start: Element | null, stopAt?: Element | null): CollectedEntityHit[];
+export {};

package/dist/superdoc/src/public/ui/format-painter-helpers.d.ts

@@ -2,22 +2,16 @@
  * Maps SDRunProps field names to InlineRunPatch field names.
  * SDRunProps (read-side) and InlineRunPatch (write-side) use different keys
  * for the same properties; direct assignment between them is forbidden.
- *
- * @param {Record<string, unknown>} props - SDRunProps object from doc.getNodeById
- * @returns {Record<string, unknown>} InlineRunPatch ready for doc.format.apply
  */
-export function sdRunPropsToInlineRunPatch(props: Record<string, unknown>): Record<string, unknown>;
+export declare function sdRunPropsToInlineRunPatch(props: Record<string, unknown>): Record<string, unknown>;
 /**
  * Serializes a selection to a stable string key used to detect whether
  * the target selection is the same as the source (skip apply in that case).
  *
  * Falls back to the plain text target when the host has not populated an
  * explicit `selectionTarget` yet.
- *
- * @param {{ selectionTarget?: unknown; target?: unknown } | null | undefined} selection
- * @returns {string}
  */
-export function selectionKey(selection: {
+export declare function selectionKey(selection: {
     selectionTarget?: unknown;
     target?: unknown;
 } | null | undefined): string;

package/dist/superdoc/src/public/ui/style-match-patch.d.ts

@@ -1,7 +1,7 @@
 import { FormatReadSelectionResult, InlineRunPatchKey, StylesStyleRunPatch } from '../../../../document-api/src/index.js';
-export declare const STYLE_MATCH_KEYS: readonly [readonly ["bold", "bold"], readonly ["italic", "italic"], readonly ["underline", "underline"], readonly ["color", "color"], readonly ["fontSize", "fontSize"], readonly ["rFonts", "fontFamily"]];
 export declare const STYLE_MATCH_READ_KEYS: InlineRunPatchKey[];
-export interface StyleMatchPatchOptions {
+interface StyleMatchPatchOptions {
     selectionUsesStyle: boolean;
 }
 export declare function buildStyleMatchPatch(effective: FormatReadSelectionResult, direct: FormatReadSelectionResult, options: StyleMatchPatchOptions): StylesStyleRunPatch;
+export {};

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

@@ -31,7 +31,7 @@ import { BuiltInCommandId } from './commands.js';
  * (`scripts/ensure-types.cjs` `rewriteDocApiPaths`), so no bare private
  * specifier leaks into the emitted `.d.ts`.
  */
-export type { Receipt, DocumentApiRejectionReason, DocumentApiRejectionDetails, TextRangeRejectionReason, ContentControlCreationRejectionReason, SelectionInfo, SelectionTarget, SelectionPoint, TextTarget, TextAddress, BookmarkAddress, ScrollIntoViewInput, ScrollIntoViewOutput, DocumentApi, EntityAddress, CommentsListQuery as DocumentApiCommentsListQuery, CommentsListResult, TrackChangesListResult, ContentControlsListResult, ContentControlInfo, ContentControlTarget, RichContentInsertInput, OperationCapabilityResolveResult, SDHtmlMarkdownSupportCheckResult, PictureWatermarkInput, RetainedPictureWatermarkInput, TextWatermark, WatermarkInfo, WatermarkTarget, WatermarksApplyInput, WatermarksApplyResult, WatermarksApplySuccess, WatermarksApplyTarget, TemporaryMutationOperation, TemporaryOperationResultTarget, TemporaryOperationEffects, TemporaryMutationInput, TemporaryMutationReplaceInput, TemporaryMutationHandleInput, TemporaryMutationReceipt, StoryLocator as DocumentStoryLocator, OperationId, OperationCall, OperationInput, OperationOptions, OperationOutput, } from '../../../../document-api/src/index.js';
+export type { Receipt, DocumentApiRejectionReason, DocumentApiRejectionDetails, TextRangeRejectionReason, ContentControlCreationRejectionReason, SelectionInfo, SelectionTarget, SelectionPoint, TextTarget, TextAddress, BookmarkAddress, ScrollIntoViewInput, ScrollIntoViewOutput, DocumentApi, EntityAddress, CommentsListResult, TrackChangesListResult, ContentControlsListResult, ContentControlInfo, ContentControlTarget, RichContentInsertInput, OperationCapabilityResolveResult, SDHtmlMarkdownSupportCheckResult, PictureWatermarkInput, RetainedPictureWatermarkInput, TextWatermark, WatermarkInfo, WatermarkTarget, WatermarksApplyInput, WatermarksApplyResult, WatermarksApplySuccess, WatermarksApplyTarget, TemporaryMutationOperation, TemporaryOperationResultTarget, TemporaryOperationEffects, TemporaryMutationInput, TemporaryMutationReplaceInput, TemporaryMutationHandleInput, TemporaryMutationReceipt, StoryLocator as DocumentStoryLocator, OperationId, OperationCall, OperationInput, OperationOptions, OperationOutput, } from '../../../../document-api/src/index.js';
 export type { StyleCatalogView, StyleCatalogItemType, StyleCatalogFilterType, StyleProvenance, StyleCatalogItemVisibility, StyleCatalogItemUsage, StyleCatalogItemPreview, StyleCatalogItem, StyleCatalogDefaults, StyleCatalogDiagnostic, StyleCatalogSourceStatus, StylesGetCatalogInput, StylesGetCatalogResult, } from '../../../../document-api/src/index.js';
 export type { ListPresetId } from '../../../../document-api/src/index.js';
 export type { BrowserDocumentApi, PartialBrowserDocumentApi } from '../browser-document-api.js';