superdoc 2.29.0-next.1 → 2.29.0-next.13

package/dist/document-api/src/index.d.ts

@@ -26,12 +26,12 @@ import { InsertInput } from './insert/insert.js';
 import { ResolveRangeInput, ResolveRangeOutput } from './ranges/ranges.types.js';
 import { SelectionApi, SelectionAdapter } from './selection/selection.js';
 import { ListsAdapter, ListsApi } from './lists/lists.js';
-import { ReplaceInput, ReplaceMutationOptions } from './replace/replace.js';
+import { ReplaceInput, ReplaceMutationOptions, TrackedReplaceMutationOptions } from './replace/replace.js';
 import { CreateAdapter, CreateApi } from './create/create.js';
 import { BlocksAdapter, BlocksApi } from './blocks/blocks.js';
 import { TableLocator, TableMutationResult, TablesConvertFromTextInput, TablesMoveInput, TablesSplitInput, TablesConvertToTextInput, TablesSetLayoutInput, TablesInsertRowInput, TablesDeleteRowInput, TablesMoveRowInput, TablesSetRowHeightInput, TablesDistributeRowsInput, TablesSetRowOptionsInput, TablesInsertColumnInput, TablesDeleteColumnInput, TablesMoveColumnInput, TablesSetColumnWidthInput, TablesDistributeColumnsInput, TablesInsertCellInput, TablesDeleteCellInput, TablesMergeCellsInput, TablesUnmergeCellsInput, TablesSplitCellInput, TablesSetCellPropertiesInput, TablesSetCellTextInput, TablesSortInput, TablesSetAltTextInput, TablesSetStyleInput, TablesClearStyleInput, TablesSetStyleOptionInput, TablesSetBorderInput, TablesClearBorderInput, TablesApplyBorderPresetInput, TablesSetShadingInput, TablesClearShadingInput, TablesSetTablePaddingInput, TablesSetCellPaddingInput, TablesSetCellSpacingInput, TablesClearCellSpacingInput, TablesApplyStyleInput, TablesSetBordersInput, TablesSetTableOptionsInput, TablesApplyPresetInput, TablesGetInput, TablesGetOutput, TablesGetCellsInput, TablesGetCellsOutput, TablesGetPropertiesInput, TablesGetPropertiesOutput, TablesGetStylesInput, TablesGetStylesOutput, TablesSetDefaultStyleInput, TablesClearDefaultStyleInput } from './types/table-operations.types.js';
 import { TrackChangesAdapter, TrackChangesApi } from './track-changes/track-changes.js';
-import { MutationOptions, RichContentMutationOptions, TrackedTextMutationOptions, TextMutationOptions, WriteAdapter } from './write/write.js';
+import { MutationOptions, RichContentMutationOptions, TrackedRichContentMutationOptions, TextMutationOptions, WriteAdapter } from './write/write.js';
 import { OperationCancellation } from './write/operation-cancellation.js';
 import { SelectionMutationAdapter } from './selection-mutation.js';
 import { CapabilitiesAdapter, DocumentApiCapabilities, OperationCapabilityResolveInput, OperationCapabilityResolveResult } from './capabilities/capabilities.js';
@@ -109,7 +109,7 @@ export type { GetMarkdownAdapter, GetMarkdownInput } from './get-markdown/get-ma
 export type { GetHtmlAdapter, GetHtmlInput } from './get-html/get-html.js';
 export type { InfoAdapter, InfoInput } from './info/info.js';
 export type { ExtractAdapter, ExtractInput } from './extract/extract.js';
-export type { WriteAdapter, WriteRequest, RichContentMutationOptions, TrackedAttribution, TrackedTextMutationOptions, TextMutationOptions, } from './write/write.js';
+export type { WriteAdapter, WriteRequest, RichContentMutationOptions, TrackedAttribution, TrackedRichContentMutationOptions, TrackedTextMutationOptions, TextMutationOptions, } from './write/write.js';
 export type { OperationCancellation, OperationCancellationCode } from './write/operation-cancellation.js';
 export { OperationCancellationError, assertOperationCanStart, indeterminateOperation, splitOperationCancellation, } from './write/operation-cancellation.js';
 export type { FormatInlineAliasApi, FormatInlineAliasInput, FormatBoldInput, FormatItalicInput, FormatRangeInput, FormatUnderlineInput, FormatStrikethroughInput, StyleApplyInput, StyleApplyOptions, } from './format/format.js';
@@ -185,7 +185,7 @@ export type { MutationReceiptBridgeContext, StructuralReceiptParams } from './re
 export { isBlockNodeAddress } from './validation-primitives.js';
 export type { InsertInput, InsertContentType, TextInsertInput, PlainTextInsertInput, RichContentInsertInput, NativeOoxmlInsertInput, LegacyInsertInput, } from './insert/insert.js';
 export { isStructuralInsertInput } from './insert/insert.js';
-export type { ReplaceInput, TextReplaceInput, TextReplacementGranularity, RichContentReplaceInput, ReplaceMutationOptions, NativeOoxmlReplaceInput, SnapshotReplaceInput, ParagraphTextReplaceInput, } from './replace/replace.js';
+export type { ReplaceInput, TextReplaceInput, TextReplacementGranularity, RichContentReplaceInput, ReplaceMutationOptions, TrackedReplaceMutationOptions, NativeOoxmlReplaceInput, SnapshotReplaceInput, ParagraphTextReplaceInput, } from './replace/replace.js';
 export { executeReplace, isStructuralReplaceInput, isRichContentReplaceInput, TEXT_REPLACEMENT_GRANULARITIES, isTextReplacementGranularity, isSingleParagraphVisibleTextSelection, } from './replace/replace.js';
 export { executeFind } from './find/find.js';
 export { validateDocumentFragment, validateSDFragment } from './validation/fragment-validator.js';
@@ -362,14 +362,15 @@ export interface DocumentApiSurface {
      * Insert content at a target location.
      * If target is omitted, inserts at the end of the document.
      */
-    insert(input: import('./insert/insert.js').PlainTextInsertInput, options: TrackedTextMutationOptions & OperationCancellation): SDMutationReceipt;
+    insert(input: InsertInput, options: TrackedRichContentMutationOptions & OperationCancellation): SDMutationReceipt;
     insert(input: InsertInput, options?: RichContentMutationOptions & OperationCancellation): SDMutationReceipt;
     /**
      * Replace text at a target range.
      */
-    replace(input: Exclude<import('./replace/replace.js').TextReplaceInput, {
+    replace(input: Exclude<ReplaceInput, {
         target: import('./types/story.types.js').BodyStoryLocator;
-    }>, options: TrackedTextMutationOptions): SDMutationReceipt;
+        text: string;
+    }>, options: TrackedReplaceMutationOptions): SDMutationReceipt;
     replace(input: ReplaceInput, options?: ReplaceMutationOptions): SDMutationReceipt;
     /**
      * Delete text at a target range.

package/dist/document-api/src/insert/insert.d.ts

@@ -1,5 +1,5 @@
 import { OoxmlContentSource } from '../selection/selection.types.js';
-import { RichContentMutationOptions, TextMutationOptions, WriteAdapter } from '../write/write.js';
+import { RichContentMutationOptions, TextMutationOptions, TrackedRichContentMutationOptions, WriteAdapter } from '../write/write.js';
 import { SelectionTarget, TargetLocator, SDMutationReceipt } from '../types/index.js';
 import { SDInsertInput } from '../types/structural-input.js';
 import { StoryLocator } from '../types/story.types.js';
@@ -80,5 +80,5 @@ export declare function validateInsertInput(input: unknown): asserts input is In
  * @param options - Optional mutation options (changeMode, dryRun, expectedRevision).
  * @returns Receipt indicating success/failure and mutation metadata.
  */
-export declare function executeInsert(selectionAdapter: SelectionMutationAdapter, writeAdapter: WriteAdapter, input: InsertInput, options?: (RichContentMutationOptions | TextMutationOptions) & OperationCancellation): SDMutationReceipt;
+export declare function executeInsert(selectionAdapter: SelectionMutationAdapter, writeAdapter: WriteAdapter, input: InsertInput, options?: (RichContentMutationOptions | TrackedRichContentMutationOptions | TextMutationOptions) & OperationCancellation): SDMutationReceipt;
 export {};

package/dist/document-api/src/replace/replace.d.ts

@@ -1,5 +1,5 @@
 import { OoxmlContentSource } from '../selection/selection.types.js';
-import { RichContentMutationOptions, TextMutationOptions, WriteAdapter } from '../write/write.js';
+import { RichContentMutationOptions, TextMutationOptions, TrackedRichContentMutationOptions, WriteAdapter } from '../write/write.js';
 import { SelectionTarget } from '../types/address.js';
 import { SDMutationReceipt } from '../types/sd-contract.js';
 import { SDReplaceInput } from '../types/structural-input.js';
@@ -81,7 +81,8 @@ export interface ReplaceMutationOptions extends RichContentMutationOptions {
     /** Compare the addressed paragraph with an unchanged retained snapshot before committing. */
     expectedSnapshotId?: string;
 }
-type ReplaceExecutionOptions = ReplaceMutationOptions | (TextMutationOptions & {
+export type TrackedReplaceMutationOptions = TrackedRichContentMutationOptions & Pick<ReplaceMutationOptions, 'replaceMode' | 'expectedSnapshotId'>;
+type ReplaceExecutionOptions = ReplaceMutationOptions | TrackedReplaceMutationOptions | (TextMutationOptions & {
     replaceMode?: never;
     expectedSnapshotId?: never;
 });

package/dist/document-api/src/tables/tables.d.ts

@@ -1,5 +1,5 @@
 import { MutationOptions } from '../write/write.js';
-import { TablesApplyStyleInput, TablesSetBordersInput, TablesSetCellPaddingInput, TablesSetLayoutInput, TablesSetTableOptionsInput } from '../types/table-operations.types.js';
+import { TablesApplyStyleInput, TablesSetBordersInput, TablesSetCellPaddingInput, TablesSetLayoutInput, TablesSetTableOptionsInput, TablesSortInput } from '../types/table-operations.types.js';
 type RowLocatorInput = {
     target?: unknown;
     nodeId?: unknown;
@@ -52,6 +52,7 @@ export declare function executeTableLocatorOp<TInput extends {
     nodeId?: unknown;
 }, TResult>(operationName: string, adapter: (input: TInput, options?: MutationOptions) => TResult, input: TInput, options?: MutationOptions): TResult;
 export declare function executeTablesSetLayoutOp<TResult>(adapter: (input: TablesSetLayoutInput, options?: MutationOptions) => TResult, input: TablesSetLayoutInput, options?: MutationOptions): TResult;
+export declare function executeTablesSortOp<TResult>(adapter: (input: TablesSortInput, options?: MutationOptions) => TResult, input: TablesSortInput, options?: MutationOptions): TResult;
 export declare function executeRowLocatorOp<TInput extends RowLocatorInput, TResult>(operationName: string, adapter: (input: TInput, options?: MutationOptions) => TResult, input: TInput, options?: MutationOptions, rowLocatorOptions?: RowLocatorOptions): TResult;
 export declare function executeCellOrTableScopedCellLocatorOp<TInput extends CellOrTableScopedCellLocatorInput, TResult>(operationName: string, adapter: (input: TInput, options?: MutationOptions) => TResult, input: TInput, options?: MutationOptions): TResult;
 /**

package/dist/document-api/src/types/address.d.ts

@@ -17,6 +17,7 @@ export type Range = {
 export type TextCoordinateSpace = 'visible' | 'tracked';
 export type TextAddress = {
     kind: 'text';
+    captureState?: string;
     blockId: string;
     range: Range;
     /** Story containing this text. Omit for body (backward compatible). */
@@ -47,6 +48,7 @@ export type TextSegment = {
  */
 export type TextTarget = {
     kind: 'text';
+    captureState?: string;
     segments: [TextSegment, ...TextSegment[]];
     /** Story containing this text target. Omit for body (backward compatible). */
     story?: StoryLocator;
@@ -93,6 +95,7 @@ export type SelectionPoint = {
  */
 export type SelectionTarget = {
     kind: 'selection';
+    captureState?: string;
     start: SelectionPoint;
     end: SelectionPoint;
     /** Story containing this selection. Omit for body (backward compatible). */

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

@@ -364,6 +364,7 @@ export interface TablesSortKey {
 }
 export interface TablesSortInput extends TableLocator {
     keys: [TablesSortKey, ...TablesSortKey[]];
+    skipHeaderRows?: number;
 }
 export interface TablesSetAltTextInput extends TableLocator {
     title?: string;

package/dist/document-api/src/types/temporary-mutation.d.ts

@@ -1,7 +1,7 @@
 import { DocumentApiSurface } from '../index.js';
 import { ReceiptEntity, ReceiptFailureResult, ReceiptSuccess } from './receipt.js';
 import { PlainTextInsertInput } from '../insert/insert.js';
-import { ParagraphTextReplaceInput, ReplaceMutationOptions, TextReplaceInput } from '../replace/replace.js';
+import { ParagraphTextReplaceInput, ReplaceMutationOptions, TextReplaceInput, TrackedReplaceMutationOptions } from '../replace/replace.js';
 import { MutationOptions, TrackedTextMutationOptions } from '../write/write.js';
 import { BodyStoryLocator } from './story.types.js';
 type TemporaryCall<Name extends string, Method extends (...args: never[]) => unknown> = {
@@ -37,6 +37,10 @@ export type TemporaryMutationOperation = {
     operation: 'replace';
     input: ParagraphTextReplaceInput;
     options?: ReplaceMutationOptions;
+} | {
+    operation: 'replace';
+    input: ParagraphTextReplaceInput;
+    options: TrackedReplaceMutationOptions;
 } | TemporaryCall<'delete', DocumentApiSurface['delete']> | TemporaryCall<'blocks.delete', DocumentApiSurface['blocks']['delete']> | TemporaryCall<'trackChanges.decide', DocumentApiSurface['trackChanges']['decide']> | {
     operation: 'comments.create';
     input: TemporaryCommentInput;

package/dist/document-api/src/write/write.d.ts

@@ -1,6 +1,6 @@
 import { TextMutationReceipt, SDMutationReceipt } from '../types/index.js';
 import { InsertInput } from '../insert/insert.js';
-import { ReplaceMutationOptions, ReplaceInput } from '../replace/replace.js';
+import { ReplaceMutationOptions, ReplaceInput, TrackedReplaceMutationOptions } from '../replace/replace.js';
 import { StoryLocator } from '../types/story.types.js';
 import { SDHtmlMarkdownCheckGuard } from '../capabilities/html-markdown-support.js';
 export type ChangeMode = 'direct' | 'tracked';
@@ -50,16 +50,22 @@ export interface TrackedAttribution {
     /** ISO 8601 UTC revision timestamp. Omitted values use the transaction time. */
     date?: string;
 }
-export interface RichContentMutationOptions extends MutationOptions, TrackedAttribution {
+export interface RichContentMutationOptions extends MutationOptions {
+    author?: never;
+    date?: never;
     /** Guard returned by `doc.capabilities.check` for an exact rich write. */
     supportCheck?: SDHtmlMarkdownCheckGuard;
 }
 export interface TrackedTextMutationOptions extends MutationOptions, TrackedAttribution {
     changeMode: 'tracked';
 }
-export type TextMutationOptions = MutationOptions | TrackedTextMutationOptions;
+export type TrackedRichContentMutationOptions = TrackedTextMutationOptions & Pick<RichContentMutationOptions, 'supportCheck'>;
+export type TextMutationOptions = (MutationOptions & {
+    author?: never;
+    date?: never;
+}) | TrackedTextMutationOptions;
 export declare function normalizeTextMutationOptions(options?: RichContentMutationOptions | TextMutationOptions): RichContentMutationOptions | TrackedTextMutationOptions;
-export declare function normalizeRichMutationOptions(options: (MutationOptions & TrackedAttribution & Partial<RichContentMutationOptions>) | undefined, supportCheckOperation?: 'insert' | 'replace'): RichContentMutationOptions;
+export declare function normalizeRichMutationOptions(options: (MutationOptions & TrackedAttribution & Pick<RichContentMutationOptions, 'supportCheck'>) | undefined, supportCheckOperation?: 'insert' | 'replace'): RichContentMutationOptions | TrackedRichContentMutationOptions;
 /**
  * Text insertion request: target-less insert at document end.
  *
@@ -87,9 +93,9 @@ export interface WriteAdapter {
     readonly supportsNativeOoxml?: boolean;
     write(request: InsertWriteRequest, options?: TextMutationOptions): TextMutationReceipt;
     /** Structured insert for SDFragment or markdown/html content. Returns SDMutationReceipt. */
-    insertStructured(input: InsertInput, options?: RichContentMutationOptions): SDMutationReceipt;
+    insertStructured(input: InsertInput, options?: RichContentMutationOptions | TrackedRichContentMutationOptions): SDMutationReceipt;
     /** Structured replace for SDFragment or markdown/html content. Returns SDMutationReceipt. */
-    replaceStructured(input: ReplaceInput, options?: ReplaceMutationOptions): SDMutationReceipt;
+    replaceStructured(input: ReplaceInput, options?: ReplaceMutationOptions | TrackedReplaceMutationOptions): SDMutationReceipt;
 }
 export declare function normalizeMutationOptions(options?: MutationOptions | RichContentMutationOptions, supportCheckOperation?: 'insert' | 'replace'): RichContentMutationOptions;
 export declare function executeWrite(adapter: WriteAdapter, request: InsertWriteRequest, options?: TextMutationOptions): TextMutationReceipt;

package/dist/layout-engine/contracts/src/index.d.ts

@@ -2976,7 +2976,7 @@ export declare const extractHeaderFooterSpace: (margins?: PageMargins | null) =>
 export type { ResolvedLayout, ResolvedPage, ResolvedPaintItem, ResolvedGroupItem, ResolvedFragmentItem, ResolvedParagraphContent, ResolvedTextLineItem, ResolvedDropCapItem, ResolvedListMarkerItem, ResolvedTableItem, ResolvedImageItem, ResolvedDrawingItem, ResolvedHeaderFooterPage, ResolvedHeaderFooterLayout, } from './resolved-layout.js';
 export { isResolvedTableItem, isResolvedImageItem, isResolvedDrawingItem } from './resolved-layout.js';
 export { PAGE_BREAK_DELETION_ANCHOR_ATTR, DELETED_PAGE_BREAK_LABEL, isPageBreakDeletionAnchorRun, expandRunsForInlineNewlines, isBodyNoteReferenceRun, isZeroWidthMarkerRun, isGeneratedFieldResultRun, hasZeroWidthMarkerSpan, isNoteLabelRun, isNumberedNoteMarkerRun, isEmptyInlineSdtPlaceholderRun, isEmptySdtPlaceholderRun, NOTE_LABEL_MARKER_ATTR, NOTE_REFERENCE_MARKER_ATTR, sliceRunsForLine, usesPositionedTextGeometry, } from './run-helpers.js';
-export { INLINE_OBJECT_REPLACEMENT_CHARACTER, flattenParagraphVisibleText, mapVisibleRangeToRunSlices, type ParagraphVisibleRunSlice, } from './paragraph-visible-text.js';
+export { runVisibleLength, splitsSurrogatePair, INLINE_OBJECT_REPLACEMENT_CHARACTER, flattenParagraphVisibleText, mapVisibleRangeToRunSlices, type ParagraphVisibleRunSlice, } from './paragraph-visible-text.js';
 export { inlineBoxStyleSignature, isFiniteNonNegativeInteger, normalizeInlineBoxLogicalSides, type InlineBoxLogicalSides, type ResolvedInlineBoxLogicalSides, } from './inline-box.js';
 export { INCREMENTAL_DEPENDENCY_CERTIFICATE_CLASSES, PAGE_CHECKPOINT_DEPENDENCY_CLASSES, areValidPageCheckpointDependencyClasses, isValidIncrementalDependencyOwnerVersion, isValidNonFlowingPageRelativeAnchorDependencyProof, isValidPageCheckpointDependencyCertificate, type IncrementalDependencyCertificateClass, type IncrementalDependencyOwnerVersion, type NonFlowingPageRelativeAnchorDependencyProof, type PageCheckpointDependencyCertificate, type PageCheckpointDependencyClass, } from './incremental-dependency.js';
 export * as Engines from './engines/index.js';

package/dist/layout-engine/contracts/src/paragraph-visible-text.d.ts

@@ -1,10 +1,12 @@
-import { ParagraphBlock } from './index.js';
+import { ParagraphBlock, Run } from './index.js';
 export declare const INLINE_OBJECT_REPLACEMENT_CHARACTER = "\uFFFC";
 export type ParagraphVisibleRunSlice = {
     runIndex: number;
     fromChar: number;
     toChar: number;
 };
+export declare const runVisibleLength: (run: Run) => number;
+export declare const splitsSurrogatePair: (text: string, offset: number) => boolean;
 /**
  * Flattens a paragraph into Document API visible-text coordinates.
  *

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-0OA8hCNb.cjs");
+const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-_SbygYQ4.cjs");
 const require_slice_source = require("../chunks/slice-source-CFaqq0Vo.cjs");
 let react = require("react");
 let use_sync_external_store_shim = require("use-sync-external-store/shim");

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

@@ -1,4 +1,4 @@
-import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-Duf65d0b.es.js";
+import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-DdT4b29f.es.js";
 import { t as toSliceSource } from "../chunks/slice-source-gfOhG2MW.es.js";
 import { createContext, createElement, useCallback, useContext, useEffect, useRef, useState } from "react";
 import { useSyncExternalStore } from "use-sync-external-store/shim";

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-0OA8hCNb.cjs");
+const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-_SbygYQ4.cjs");
 const require_slice_source = require("../chunks/slice-source-CFaqq0Vo.cjs");
 let superdoc_entry_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-Duf65d0b.es.js";
+import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-DdT4b29f.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-0OA8hCNb.cjs");
+const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-_SbygYQ4.cjs");
 //#region ../document-api/src/types/receipt.ts
 /** Read a known failure.details.reason without assuming every failure has one. */
 function getDocumentApiRejectionReason(details) {

package/dist/public/ui.es.js

@@ -1,4 +1,4 @@
-import { m as shallowEqual, s as BUILT_IN_COMMAND_IDS, t as createSuperDocUI } from "../chunks/create-super-doc-ui-Duf65d0b.es.js";
+import { m as shallowEqual, s as BUILT_IN_COMMAND_IDS, t as createSuperDocUI } from "../chunks/create-super-doc-ui-DdT4b29f.es.js";
 //#region ../document-api/src/types/receipt.ts
 /** Read a known failure.details.reason without assuming every failure has one. */
 function getDocumentApiRejectionReason(details) {