superdoc 2.23.0-next.10 → 2.23.0-next.12

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.23.0-next.10",
+	superdocVersion: "2.23.0-next.12",
 	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.23.0-next.10",
+	superdocVersion: "2.23.0-next.12",
 	roomSchemaVersion: Object.freeze({ ...PRIVATE_ENGINE_INFO.roomSchemaVersion }),
 	supportedBundleVersions: SUPPORTED_COLLABORATION_UPGRADE_BUNDLE_VERSIONS,
 	supportedV1ReaderContractVersions: SUPPORTED_V1_READER_CONTRACT_VERSIONS

package/dist/document-api/src/contract/operation-registry.d.ts

@@ -1,4 +1,9 @@
 import { DocumentApiSurface } from '../index.js';
+import { PlainTextInsertInput } from '../insert/insert.js';
+import { TextReplaceInput } from '../replace/replace.js';
+import { BodyStoryLocator } from '../types/story.types.js';
+import { OperationCancellation } from '../write/operation-cancellation.js';
+import { TrackedTextMutationOptions } from '../write/write.js';
 import { OPERATION_DEFINITIONS } from './operation-definitions.js';
 import { OperationId } from './types.js';
 type ResolveMemberPath<T, Path extends string> = Path extends `${infer Head}.${infer Tail}` ? Head extends keyof T ? ResolveMemberPath<T[Head], Tail> : never : Path extends keyof T ? T[Path] : never;
@@ -18,8 +23,7 @@ export type OperationRegistry = {
         output: Id extends 'mutations.preview' | 'mutations.apply' | 'plan.execute' ? Awaited<MethodReturn<Method>> : MethodReturn<Method>;
     } : never;
 };
-/** Typed invoke request narrowed by `operationId`. */
-export type InvokeRequest<T extends OperationId> = OperationRegistry[T]['options'] extends never ? {
+type MethodInvokeRequest<T extends OperationId> = OperationRegistry[T]['options'] extends never ? {
     operationId: T;
     input: OperationRegistry[T]['input'];
     options?: never;
@@ -28,6 +32,19 @@ export type InvokeRequest<T extends OperationId> = OperationRegistry[T]['options
     input: OperationRegistry[T]['input'];
     options?: OperationRegistry[T]['options'];
 };
+type AttributedTextInvokeRequest<T extends OperationId> = T extends 'insert' ? {
+    operationId: T;
+    input: PlainTextInsertInput;
+    options: TrackedTextMutationOptions & OperationCancellation;
+} : T extends 'replace' ? {
+    operationId: T;
+    input: Exclude<TextReplaceInput, {
+        target: BodyStoryLocator;
+    }>;
+    options: TrackedTextMutationOptions;
+} : never;
+/** Typed invoke request narrowed by `operationId` and supported content shape. */
+export type InvokeRequest<T extends OperationId> = MethodInvokeRequest<T> | AttributedTextInvokeRequest<T>;
 /** Typed invoke result narrowed by `operationId`. */
 export type InvokeResult<T extends OperationId> = T extends 'mutations.preview' | 'mutations.apply' ? Promise<OperationRegistry[T]['output']> : T extends 'plan.execute' ? OperationRegistry[T]['output'] | Promise<OperationRegistry[T]['output']> : OperationRegistry[T]['output'];
 /** Loose request for callers that resolve operation identity at runtime. */

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

@@ -1,6 +1,6 @@
 import { SelectionTarget, DeleteBehavior, TargetLocator } from '../types/address.js';
 import { TextMutationReceipt } from '../types/receipt.js';
-import { MutationOptions } from '../types/mutation-plan.types.js';
+import { TextMutationOptions } from '../write/write.js';
 import { StoryLocator } from '../types/story.types.js';
 import { SelectionMutationAdapter } from '../selection-mutation.js';
 export type DeleteInput = TargetLocator & {
@@ -17,4 +17,4 @@ export type DeleteInput = TargetLocator & {
     /** Target a specific document story (body, header, footer, footnote, endnote). */
     in?: StoryLocator;
 };
-export declare function executeDelete(adapter: SelectionMutationAdapter, input: DeleteInput, options?: MutationOptions): TextMutationReceipt;
+export declare function executeDelete(adapter: SelectionMutationAdapter, input: DeleteInput, options?: TextMutationOptions): TextMutationReceipt;

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

@@ -30,7 +30,7 @@ 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, WriteAdapter } from './write/write.js';
+import { MutationOptions, RichContentMutationOptions, TrackedTextMutationOptions, 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';
@@ -105,7 +105,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 } from './write/write.js';
+export type { WriteAdapter, WriteRequest, RichContentMutationOptions, 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';
@@ -175,7 +175,7 @@ export { DocumentApiValidationError } from './errors.js';
 export { textReceiptToSDReceipt, buildStructuralReceipt } from './receipt-bridge.js';
 export type { MutationReceiptBridgeContext, StructuralReceiptParams } from './receipt-bridge.js';
 export { isBlockNodeAddress } from './validation-primitives.js';
-export type { InsertInput, InsertContentType, TextInsertInput, RichContentInsertInput, LegacyInsertInput, } from './insert/insert.js';
+export type { InsertInput, InsertContentType, TextInsertInput, PlainTextInsertInput, RichContentInsertInput, LegacyInsertInput, } from './insert/insert.js';
 export { isStructuralInsertInput } from './insert/insert.js';
 export type { ReplaceInput, TextReplaceInput, RichContentReplaceInput } from './replace/replace.js';
 export { executeReplace, isStructuralReplaceInput, isRichContentReplaceInput } from './replace/replace.js';
@@ -345,15 +345,19 @@ 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?: RichContentMutationOptions & OperationCancellation): SDMutationReceipt;
     /**
      * Replace text at a target range.
      */
+    replace(input: Exclude<import('./replace/replace.js').TextReplaceInput, {
+        target: import('./types/story.types.js').BodyStoryLocator;
+    }>, options: TrackedTextMutationOptions): SDMutationReceipt;
     replace(input: ReplaceInput, options?: RichContentMutationOptions): SDMutationReceipt;
     /**
      * Delete text at a target range.
      */
-    delete(input: DeleteInput, options?: MutationOptions): TextMutationReceipt;
+    delete(input: DeleteInput, options?: TextMutationOptions): TextMutationReceipt;
     /**
      * Formatting operations (inline and paragraph direct formatting).
      */

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

@@ -1,4 +1,4 @@
-import { RichContentMutationOptions, WriteAdapter } from '../write/write.js';
+import { RichContentMutationOptions, TextMutationOptions, 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';
@@ -46,6 +46,9 @@ export type LegacyInsertInput = TextInsertInput;
  * These are mutually exclusive: providing both is an error.
  */
 export type InsertInput = TextInsertInput | RichContentInsertInput | SDInsertInput;
+export type PlainTextInsertInput = TextInsertInput & {
+    type?: 'text';
+};
 export declare function isRichContentInsertInput(input: InsertInput): input is RichContentInsertInput;
 /** Returns true when the input uses the structural SDFragment shape. */
 export declare function isStructuralInsertInput(input: InsertInput): input is SDInsertInput;
@@ -71,5 +74,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 & OperationCancellation): SDMutationReceipt;
+export declare function executeInsert(selectionAdapter: SelectionMutationAdapter, writeAdapter: WriteAdapter, input: InsertInput, options?: (RichContentMutationOptions | TextMutationOptions) & OperationCancellation): SDMutationReceipt;
 export {};

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

@@ -1,4 +1,4 @@
-import { RichContentMutationOptions, WriteAdapter } from '../write/write.js';
+import { RichContentMutationOptions, TextMutationOptions, 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';
@@ -54,4 +54,4 @@ export type ReplaceInput = TextReplaceInput | RichContentReplaceInput | SDReplac
 export declare function isStructuralReplaceInput(input: ReplaceInput): input is SDReplaceInput;
 export declare function isRichContentReplaceInput(input: ReplaceInput): input is RichContentReplaceInput;
 export declare function validateReplaceInput(input: unknown): asserts input is ReplaceInput;
-export declare function executeReplace(selectionAdapter: SelectionMutationAdapter, writeAdapter: WriteAdapter, input: ReplaceInput, options?: RichContentMutationOptions): SDMutationReceipt;
+export declare function executeReplace(selectionAdapter: SelectionMutationAdapter, writeAdapter: WriteAdapter, input: ReplaceInput, options?: RichContentMutationOptions | TextMutationOptions): SDMutationReceipt;

package/dist/document-api/src/selection-mutation.d.ts

@@ -1,6 +1,6 @@
 import { SelectionTarget, DeleteBehavior, TargetLocator } from './types/address.js';
 import { TextMutationReceipt } from './types/receipt.js';
-import { MutationOptions } from './types/mutation-plan.types.js';
+import { TextMutationOptions } from './write/write.js';
 import { InlineRunPatch } from './format/inline-run-patch.js';
 import { StoryLocator } from './types/story.types.js';
 export type SelectionDeleteRequest = TargetLocator & {
@@ -44,5 +44,5 @@ export type SelectionMutationRequest = SelectionDeleteRequest | SelectionReplace
  * single interface.
  */
 export interface SelectionMutationAdapter {
-    execute(request: SelectionMutationRequest, options?: MutationOptions): TextMutationReceipt;
+    execute(request: SelectionMutationRequest, options?: TextMutationOptions): TextMutationReceipt;
 }

package/dist/document-api/src/types/sd-contract.d.ts

@@ -2,7 +2,7 @@ import { BlockNodeAddress } from './base.js';
 import { SelectionTarget, TextAddress } from './address.js';
 import { ReceiptEffects, ReceiptSuccess, TextMutationRange } from './receipt.js';
 import { BodyStoryLocator } from './story.types.js';
-export type SDErrorCode = 'INVALID_PAYLOAD' | 'INVALID_TARGET' | 'TARGET_NOT_FOUND' | 'ADDRESS_STALE' | 'PERMISSION_DENIED' | 'PRECONDITION_FAILED' | 'REVISION_MISMATCH' | 'CHECK_MISMATCH' | 'INVALID_CONTEXT' | 'INVALID_NESTING' | 'INVALID_PLACEMENT' | 'DUPLICATE_ID' | 'CAPABILITY_UNSUPPORTED' | 'RAW_MODE_REQUIRED' | 'PRESERVE_ONLY_VIOLATION' | 'NO_OP' | 'UNSUPPORTED_ENVIRONMENT' | 'INTERNAL_ERROR';
+export type SDErrorCode = 'INVALID_INPUT' | 'INVALID_PAYLOAD' | 'INVALID_TARGET' | 'TARGET_NOT_FOUND' | 'ADDRESS_STALE' | 'PERMISSION_DENIED' | 'PRECONDITION_FAILED' | 'REVISION_MISMATCH' | 'CHECK_MISMATCH' | 'INVALID_CONTEXT' | 'INVALID_NESTING' | 'INVALID_PLACEMENT' | 'DUPLICATE_ID' | 'CAPABILITY_UNSUPPORTED' | 'RAW_MODE_REQUIRED' | 'PRESERVE_ONLY_VIOLATION' | 'NO_OP' | 'UNSUPPORTED_ENVIRONMENT' | 'INTERNAL_ERROR';
 export declare const SD_HTML_MARKDOWN_OUTCOMES: readonly ["preserved", "preserved-with-warnings", "simplified", "rejected", "no-op", "invalid-target", "outdated"];
 export type SDHtmlMarkdownOutcome = (typeof SD_HTML_MARKDOWN_OUTCOMES)[number];
 export interface SDError {

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

@@ -41,9 +41,19 @@ export interface MutationOptions extends RevisionGuardOptions {
     dryRun?: boolean;
 }
 export interface RichContentMutationOptions extends MutationOptions {
+    author?: never;
     /** Guard returned by `doc.capabilities.check` for an exact rich write. */
     supportCheck?: SDHtmlMarkdownCheckGuard;
 }
+/** Display-only attribution for one tracked plain-text mutation. */
+export interface TrackedTextMutationOptions extends MutationOptions {
+    changeMode: 'tracked';
+    author: {
+        name: string;
+    };
+}
+export type TextMutationOptions = MutationOptions | TrackedTextMutationOptions;
+export declare function normalizeTextMutationOptions(options?: RichContentMutationOptions | TextMutationOptions): RichContentMutationOptions | TrackedTextMutationOptions;
 /**
  * Text insertion request: target-less insert at document end.
  *
@@ -67,11 +77,11 @@ export type WriteRequest = InsertWriteRequest;
  * `SelectionMutationAdapter` instead.
  */
 export interface WriteAdapter {
-    write(request: InsertWriteRequest, options?: MutationOptions): TextMutationReceipt;
+    write(request: InsertWriteRequest, options?: TextMutationOptions): TextMutationReceipt;
     /** Structured insert for SDFragment or markdown/html content. Returns SDMutationReceipt. */
     insertStructured(input: InsertInput, options?: RichContentMutationOptions): SDMutationReceipt;
     /** Structured replace for SDFragment or markdown/html content. Returns SDMutationReceipt. */
     replaceStructured(input: ReplaceInput, options?: RichContentMutationOptions): SDMutationReceipt;
 }
 export declare function normalizeMutationOptions(options?: MutationOptions | RichContentMutationOptions, supportCheckOperation?: 'insert' | 'replace'): RichContentMutationOptions;
-export declare function executeWrite(adapter: WriteAdapter, request: InsertWriteRequest, options?: MutationOptions): TextMutationReceipt;
+export declare function executeWrite(adapter: WriteAdapter, request: InsertWriteRequest, options?: TextMutationOptions): TextMutationReceipt;

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

@@ -1,4 +1,4 @@
-import { DocumentApi } from '../../../document-api/src/index.js';
+import { DocumentApi, DynamicInvokeRequest, InvokeRequest, InvokeResult, OperationId, OperationCancellation, PlainTextInsertInput, TextReplaceInput, TrackedTextMutationOptions } from '../../../document-api/src/index.js';
 type MaybePromise<T> = T | Promise<T>;
 type BrowserDocumentApiObject<T> = {
     [K in keyof T]: BrowserDocumentApiValue<T[K]>;
@@ -11,7 +11,17 @@ type BrowserDocumentApiValue<T> = T extends (...args: infer Args) => infer Retur
  * worker-backed runtime. SDK/headless callers should continue using the
  * synchronous `@superdoc/document-api` surface directly.
  */
-export type BrowserDocumentApi = BrowserDocumentApiObject<DocumentApi>;
+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, {
+        target: {
+            kind: 'story';
+            storyType: 'body';
+        };
+    }>, options: TrackedTextMutationOptions): MaybePromise<Awaited<ReturnType<DocumentApi['replace']>>>;
+};
 /**
  * Every operation optional, at any depth.
  *

package/dist/superdoc.cjs

@@ -304,7 +304,7 @@ var awarenessStatesToArray = (context, states) => {
 var DEFAULT_ENDPOINT = "https://ingest.superdoc.dev/v1/collect";
 function getSuperdocVersion() {
 	try {
-		return "2.23.0-next.10";
+		return "2.23.0-next.12";
 	} catch {
 		return "unknown";
 	}
@@ -46433,7 +46433,7 @@ var SuperDoc = class extends require_eventemitter3.import_eventemitter3.default
 		}
 		this.userColorMap = /* @__PURE__ */ new Map();
 		this.colorIndex = 0;
-		this.version = "2.23.0-next.10";
+		this.version = "2.23.0-next.12";
 		this.#log("🦋 [superdoc] Using SuperDoc version:", this.version);
 		this.superdocId = config.superdocId || require_uuid.v4();
 		this.colors = this.config.colors ?? [];

package/dist/superdoc.es.js

@@ -302,7 +302,7 @@ var awarenessStatesToArray = (context, states) => {
 var DEFAULT_ENDPOINT = "https://ingest.superdoc.dev/v1/collect";
 function getSuperdocVersion() {
 	try {
-		return "2.23.0-next.10";
+		return "2.23.0-next.12";
 	} catch {
 		return "unknown";
 	}
@@ -46362,7 +46362,7 @@ var SuperDoc = class extends import_eventemitter3.default {
 		}
 		this.userColorMap = /* @__PURE__ */ new Map();
 		this.colorIndex = 0;
-		this.version = "2.23.0-next.10";
+		this.version = "2.23.0-next.12";
 		this.#log("🦋 [superdoc] Using SuperDoc version:", this.version);
 		this.superdocId = config.superdocId || v4();
 		this.colors = this.config.colors ?? [];