@ansonlai/docx-redline-js 0.8.2 → 0.8.4

package/services/standalone-operation-runner.d.ts

@@ -1,427 +1,429 @@
-import type { ExistingRevisionsPolicy, RedlineError, RedlineStatus, RevisionToken } from '../index.js';
-
-export interface ParagraphTargetDescriptor {
-  text?: string;
-  exactText?: string;
-  index?: number | string;
-  paragraphIndex?: number | string;
-  paragraphId?: string;
-  occurrence?: number;
-  inTable?: boolean;
-  fingerprint?: string;
-  sourceFingerprint?: string;
-  /** Defaults to rejected for restore operations and accepted for all other operations. */
-  revisionView?: 'accepted' | 'rejected';
-  captureRef?: string;
-  select?: string;
-  createdByOperation?: number;
-}
-
-export interface InsertionAffinity {
-  formatting?: 'left' | 'right' | 'none';
-  hyperlink?: 'inside' | 'outside' | 'preserve';
-  revision?: 'coalesce_same_author' | 'separate';
-  bookmark?: 'inside' | 'outside';
-  comment?: 'inside' | 'outside';
-}
-
-export interface RejectedTextInsertionAnchor {
-  exactText: string;
-  occurrence?: number;
-  offset: number;
-}
-
-export interface LocalizedReplacement {
-  find: string;
-  replace: string;
-  occurrence?: number;
-}
-
-/** A header/footer part path from `inspect().headersFooters`, or a selector. */
-export type HeaderFooterPartSelector =
-  | string
-  | { kind: 'header' | 'footer'; type?: 'default' | 'first' | 'even'; section?: number };
-
-export interface DocumentOperationBase {
-  operationId?: string;
-  /** Target a header or footer instead of the body. Comments are not supported there. */
-  part?: HeaderFooterPartSelector;
-  captureKey?: string;
-  target?: string | ParagraphTargetDescriptor;
-  targetRef?: number | string | null;
-  author?: string;
-  generateRedlines?: boolean;
-  existingRevisions?: ExistingRevisionsPolicy;
-  pairReplacements?: boolean;
-  insertionAffinity?: InsertionAffinity;
-}
-
-interface RedlineDocumentOperationCommon extends DocumentOperationBase {
-  structuredContent?: boolean;
-  targetEnd?: ParagraphTargetDescriptor;
-  targetEndRef?: number | string | null;
-  /** Required when type is insert and target.revisionView is rejected. */
-  anchor?: RejectedTextInsertionAnchor;
-}
-
-export type RedlineDocumentOperation =
-  | (RedlineDocumentOperationCommon & {
-      type: 'redline' | 'replace';
-      modified: string;
-      replacements?: never;
-    })
-  | (RedlineDocumentOperationCommon & {
-      type: 'redline' | 'replace';
-      modified?: never;
-      /** Exact, case-sensitive replacements in one batch-start accepted-view paragraph. */
-      replacements: LocalizedReplacement[];
-    })
-  | (RedlineDocumentOperationCommon & {
-      type: 'format' | 'list-change' | 'table-reconciliation' | 'insert';
-      modified: string;
-      replacements?: never;
-    });
-
-interface RestoreDocumentOperationCommon extends DocumentOperationBase {
-  type: 'restore';
-}
-
-export type RestoreDocumentOperation =
-  | (RestoreDocumentOperationCommon & {
-      modified: string | string[];
-      replacements?: never;
-      targetEnd?: ParagraphTargetDescriptor;
-      targetEndRef?: number | string | null;
-    })
-  | (RestoreDocumentOperationCommon & {
-      modified?: never;
-      /** Exact, case-sensitive replacements in one strong rejected-view paragraph. */
-      replacements: LocalizedReplacement[];
-      targetEnd?: never;
-      targetEndRef?: never;
-    })
-  | (RestoreDocumentOperationCommon & {
-      /** Omit modified to restore one strong rejected-view paragraph verbatim. */
-      modified?: never;
-      replacements?: never;
-      targetEnd?: never;
-      targetEndRef?: never;
-    });
-
-export interface DeleteDocumentOperation extends DocumentOperationBase {
-  type: 'delete';
-  modified?: '';
-}
-
-export interface CommentDocumentOperation extends DocumentOperationBase {
-  type: 'comment';
-  textToComment?: string;
-  commentContent: string;
-}
-
-export interface CommentReplyDocumentOperation {
-  type: 'comment_reply';
-  operationId?: string;
-  parentCommentId: number | string;
-  commentContent: string;
-  author?: string;
-  date?: string;
-}
-
-/** Resolves (or with `resolved: false`, reopens) the whole thread containing `commentId`. Body-only. */
-export interface CommentResolveDocumentOperation {
-  type: 'comment_resolve';
-  operationId?: string;
-  commentId: number | string;
-  resolved?: boolean;
-}
-
-export interface CharacterFormatProperties {
-  bold?: boolean;
-  italic?: boolean;
-  underline?: boolean;
-  strike?: boolean;
-  strikethrough?: boolean;
-  highlight?: string | null;
-  color?: string | null;
-  fontSize?: number | string | null;
-  fontFamily?: string | null;
-}
-
-export interface ParagraphFormatProperties {
-  alignment?: 'left' | 'center' | 'right' | 'both';
-  keepNext?: boolean;
-  keepLines?: boolean;
-  pageBreakBefore?: boolean;
-  style?: string | null;
-}
-
-export interface HighlightDocumentOperation extends DocumentOperationBase {
-  type: 'highlight';
-  textToHighlight: string;
-  color?: string;
-}
-
-export interface CharacterFormatDocumentOperation extends DocumentOperationBase {
-  type: 'format' | 'character-format';
-  textToFormat: string;
-  properties: CharacterFormatProperties;
-  formattingRevisionPolicy?: 'always' | 'coalesce-own-insertion';
-}
-
-export interface ParagraphFormatDocumentOperation extends DocumentOperationBase {
-  type: 'paragraph-format';
-  properties: ParagraphFormatProperties;
-}
-
-export type DocumentOperation =
-  | RedlineDocumentOperation
-  | RestoreDocumentOperation
-  | DeleteDocumentOperation
-  | CommentDocumentOperation
-  | CommentReplyDocumentOperation
-  | CommentResolveDocumentOperation
-  | HighlightDocumentOperation
-  | CharacterFormatDocumentOperation
-  | ParagraphFormatDocumentOperation;
-
-export interface ResolvedDocumentTarget {
-  index: number;
-  paragraphId: string | null;
-  text: string;
-  fingerprint?: string;
-  revisionView?: 'accepted' | 'rejected';
-  inTable?: boolean;
-  targetTextMatch?: {
-    mode: 'exact' | 'space_equivalent' | 'normalized';
-    differences?: Array<{
-      offset: number;
-      sourceCodePoint: string;
-      requestedCodePoint: string;
-    }>;
-    sourceExcerpt?: string;
-    requestedExcerpt?: string;
-  };
-}
-
-export interface ResolvedCommentAnchor {
-  requestIndex: number;
-  paragraphIndex: number;
-  text: string;
-  resolvedBy: 'exact_anchor' | 'space_equivalent_anchor';
-  start: number;
-  end: number;
-}
-
-export interface StandaloneRunnerOptions {
-  atomic?: boolean;
-  continueOnError?: boolean;
-  generateRedlines?: boolean;
-  existingRevisions?: ExistingRevisionsPolicy;
-  strictTargets?: boolean;
-  expectedRevision?: RevisionToken;
-  pairReplacements?: boolean;
-  insertionAffinity?: InsertionAffinity;
-  onInfo?: (message: string) => void;
-  onWarn?: (message: string) => void;
-  [key: string]: unknown;
-}
-
-export interface MutationReceiptRevisionItem {
-  id: string;
-  kind: 'ins' | 'del' | 'move_from' | 'move_to' | 'rPrChange' | 'pPrChange' | 'structural';
-  partName: string;
-}
-
-export interface MutationReceipt {
-  operationIndex: number;
-  operationId?: string;
-  attemptedDisposition: 'applied' | 'no_change' | 'refused' | 'not_attempted';
-  finalDisposition: 'applied' | 'no_change' | 'refused' | 'rolled_back' | 'not_attempted';
-  committed: boolean;
-  authorUsed?: string;
-  revisionItems: MutationReceiptRevisionItem[];
-  commentIds: string[];
-  numberingIds: string[];
-  relationshipIds: string[];
-  affectedTargets: ResolvedDocumentTarget[];
-  warnings: string[];
-}
-
-export interface LocalizedReplacementChange {
-  kind: 'localized_replacement';
-  committed: boolean;
-  finalDisposition: 'applied' | 'rolled_back';
-  target: {
-    paragraphId?: string;
-    index?: number;
-    fingerprint?: string;
-    humanReference?: string;
-  };
-  context?: {
-    search?: string;
-    range?: string;
-    anchorMatchCount?: number;
-    humanReference?: string;
-  };
-  replacements: Array<{
-    find: string;
-    replace: string;
-    occurrence?: number;
-    matchMode?: 'space_equivalent';
-    beforeExcerpt: string;
-    afterExcerpt: string;
-  }>;
-  verification: {
-    acceptedViewMatchesCompiledText: boolean;
-  };
-}
-
-export interface DocumentOperationResult {
-  documentXml: string;
-  hasChanges: boolean;
-  numberingXml?: string | null;
-  commentsXml?: string | null;
-  commentsExtendedXml?: string | null;
-  commentsXmlMode?: 'merge' | 'replace';
-  commentsExtendedXmlMode?: 'merge' | 'replace';
-  warnings?: string[];
-  status?: RedlineStatus;
-  error?: RedlineError;
-  operationType: 'redline' | 'comment' | 'comment_reply' | 'comment_resolve' | 'highlight' | 'format' | 'paragraph-format';
-  authorUsed: string;
-  resolvedBy?: string;
-  resolvedTarget?: ResolvedDocumentTarget;
-  resolvedAnchor?: ResolvedCommentAnchor;
-  receipt?: MutationReceipt;
-  change?: LocalizedReplacementChange;
-}
-
-export interface BatchOperationItemResult {
-  index: number;
-  type: string;
-  operationType: 'redline' | 'comment' | 'comment_reply' | 'comment_resolve' | 'highlight' | 'format' | 'paragraph-format';
-  status: 'applied' | 'no_change' | 'error';
-  authorUsed: string;
-  resolvedBy?: string;
-  resolvedTarget?: ResolvedDocumentTarget;
-  resolvedAnchor?: ResolvedCommentAnchor;
-  warnings?: string[];
-  error?: RedlineError;
-  receipt?: MutationReceipt;
-  change?: LocalizedReplacementChange;
-}
-
-export interface DocumentOperationBatchResult {
-  documentXml: string;
-  hasChanges: boolean;
-  commentsXml: string | null;
-  commentsExtendedXml?: string | null;
-  commentsXmlMode?: 'merge' | 'replace';
-  commentsExtendedXmlMode?: 'merge' | 'replace';
-  numberingXmlParts: string[];
-  results: BatchOperationItemResult[];
-  receipts?: MutationReceipt[];
-  executionOrder: number[];
-  /** Authors attached to committed changes. Empty when an atomic batch rolls back. */
-  authorsUsed: string[];
-  rolledBack?: boolean;
-  status?: RedlineStatus;
-  error?: RedlineError;
-  warnings?: string[];
-  conflicts?: OperationConflict[];
-  retryPlan?: MutationRetryPlan;
-}
-
-export interface MutationRetryPlan {
-  base: 'original' | 'output';
-  committedIndexes: number[];
-  failedIndexes: number[];
-  unattemptedIndexes: number[];
-  replayWholeBatch: boolean;
-  sameArgumentsSafe: false;
-}
-
-export interface OperationPreflightItemResult {
-  index: number;
-  type: string;
-  operationType: 'redline' | 'comment' | 'comment_reply' | 'comment_resolve' | 'highlight' | 'format' | 'paragraph-format';
-  status: 'ready' | 'deferred' | 'error';
-  authorUsed: string;
-  resolvedBy?: string;
-  captureRef?: string;
-  select?: string;
-  resolvedTarget?: ResolvedDocumentTarget;
-  matchDiagnostics?: {
-    exactTextMatch: boolean;
-    normalizedTextMatch: boolean;
-    suppliedText: string;
-    actualText: string;
-  };
-  anchor?: {
-    text: string;
-    found: boolean;
-    resolvedBy?: 'exact_anchor' | 'space_equivalent_anchor';
-    start?: number;
-    end?: number;
-    candidates?: Array<{ start: number; end: number }>;
-  } | null;
-  hasRevisions?: boolean;
-  existingRevisions?: ExistingRevisionsPolicy;
-  warnings?: string[];
-  error?: RedlineError & { candidates?: ResolvedDocumentTarget[] };
-}
-
-export interface OperationConflict {
-  code: 'OVERLAPPING_SOURCE_TARGETS' | 'OVERLAPPING_TEXT_EDITS' | 'REVISION_ORDER_CONFLICT' | 'CAPTURE_FANOUT_CONFLICT' | string;
-  message: string;
-  operationIndexes: number[];
-  target: ResolvedDocumentTarget;
-  recoveryVersion?: number;
-  category?: string;
-  recovery?: RedlineError['recovery'];
-}
-
-export interface OperationPreflightResult {
-  valid: boolean;
-  status: 'ok' | 'error';
-  results: OperationPreflightItemResult[];
-  conflicts: OperationConflict[];
-  authorsUsed: string[];
-  requiredArtifacts: { comments: boolean; numbering: boolean };
-  error?: RedlineError;
-}
-
-export interface OperationDependencyPlan {
-  valid: boolean;
-  scheduled?: Array<{ operation: DocumentOperation; index: number }>;
-  captureProducers?: Map<string, number>;
-  error?: RedlineError;
-}
-
-export function buildOperationDependencyPlan(operations?: DocumentOperation[]): OperationDependencyPlan;
-
-export function orderOperationsForStableTargets(operations?: DocumentOperation[]): DocumentOperation[];
-
-export function preflightOperations(
-  documentXml: string,
-  operations: DocumentOperation[],
-  author?: string,
-  options?: StandaloneRunnerOptions
-): OperationPreflightResult;
-
-export function applyOperationToDocumentXml(
-  documentXml: string,
-  operation: DocumentOperation,
-  author?: string,
-  runtimeContext?: Record<string, unknown> | null,
-  options?: StandaloneRunnerOptions
-): Promise<DocumentOperationResult>;
-
-export function applyOperationsToDocumentXml(
-  documentXml: string,
-  operations: DocumentOperation[],
-  author?: string,
-  runtimeContext?: Record<string, unknown> | null,
-  options?: StandaloneRunnerOptions
-): Promise<DocumentOperationBatchResult>;
+import type { ExistingRevisionsPolicy, RedlineError, RedlineStatus, RevisionToken } from '../index.js';
+
+export interface ParagraphTargetDescriptor {
+  text?: string;
+  exactText?: string;
+  index?: number | string;
+  paragraphIndex?: number | string;
+  paragraphId?: string;
+  occurrence?: number;
+  inTable?: boolean;
+  fingerprint?: string;
+  sourceFingerprint?: string;
+  /** Defaults to rejected for restore operations and accepted for all other operations. */
+  revisionView?: 'accepted' | 'rejected';
+  captureRef?: string;
+  select?: string;
+  createdByOperation?: number;
+}
+
+export interface InsertionAffinity {
+  formatting?: 'left' | 'right' | 'none';
+  hyperlink?: 'inside' | 'outside' | 'preserve';
+  revision?: 'coalesce_same_author' | 'separate';
+  bookmark?: 'inside' | 'outside';
+  comment?: 'inside' | 'outside';
+}
+
+export interface RejectedTextInsertionAnchor {
+  exactText: string;
+  occurrence?: number;
+  offset: number;
+}
+
+export interface LocalizedReplacement {
+  find: string;
+  replace: string;
+  occurrence?: number;
+}
+
+/** A header/footer part path from `inspect().headersFooters`, or a selector. */
+export type HeaderFooterPartSelector =
+  | string
+  | { kind: 'header' | 'footer'; type?: 'default' | 'first' | 'even'; section?: number };
+
+export interface DocumentOperationBase {
+  operationId?: string;
+  /** Target a header or footer instead of the body. Comments are not supported there. */
+  part?: HeaderFooterPartSelector;
+  captureKey?: string;
+  target?: string | ParagraphTargetDescriptor;
+  targetRef?: number | string | null;
+  author?: string;
+  generateRedlines?: boolean;
+  existingRevisions?: ExistingRevisionsPolicy;
+  pairReplacements?: boolean;
+  insertionAffinity?: InsertionAffinity;
+}
+
+interface RedlineDocumentOperationCommon extends DocumentOperationBase {
+  structuredContent?: boolean;
+  targetEnd?: ParagraphTargetDescriptor;
+  targetEndRef?: number | string | null;
+  /** Required when type is insert and target.revisionView is rejected. */
+  anchor?: RejectedTextInsertionAnchor;
+}
+
+export type RedlineDocumentOperation =
+  | (RedlineDocumentOperationCommon & {
+      type: 'redline' | 'replace';
+      modified: string;
+      replacements?: never;
+    })
+  | (RedlineDocumentOperationCommon & {
+      type: 'redline' | 'replace';
+      modified?: never;
+      /** Exact, case-sensitive replacements in one batch-start accepted-view paragraph. */
+      replacements: LocalizedReplacement[];
+    })
+  | (RedlineDocumentOperationCommon & {
+      type: 'format' | 'list-change' | 'table-reconciliation' | 'insert';
+      modified: string;
+      replacements?: never;
+    });
+
+interface RestoreDocumentOperationCommon extends DocumentOperationBase {
+  type: 'restore';
+}
+
+export type RestoreDocumentOperation =
+  | (RestoreDocumentOperationCommon & {
+      modified: string | string[];
+      replacements?: never;
+      targetEnd?: ParagraphTargetDescriptor;
+      targetEndRef?: number | string | null;
+    })
+  | (RestoreDocumentOperationCommon & {
+      modified?: never;
+      /** Exact, case-sensitive replacements in one strong rejected-view paragraph. */
+      replacements: LocalizedReplacement[];
+      targetEnd?: never;
+      targetEndRef?: never;
+    })
+  | (RestoreDocumentOperationCommon & {
+      /** Omit modified to restore one strong rejected-view paragraph verbatim. */
+      modified?: never;
+      replacements?: never;
+      targetEnd?: never;
+      targetEndRef?: never;
+    });
+
+export interface DeleteDocumentOperation extends DocumentOperationBase {
+  type: 'delete';
+  modified?: '';
+}
+
+export interface CommentDocumentOperation extends DocumentOperationBase {
+  type: 'comment';
+  textToComment?: string;
+  commentContent: string;
+}
+
+export interface CommentReplyDocumentOperation {
+  type: 'comment_reply';
+  operationId?: string;
+  parentCommentId: number | string;
+  commentContent: string;
+  author?: string;
+  date?: string;
+}
+
+/** Resolves (or with `resolved: false`, reopens) the whole thread containing `commentId`. Body-only. */
+export interface CommentResolveDocumentOperation {
+  type: 'comment_resolve';
+  operationId?: string;
+  commentId: number | string;
+  resolved?: boolean;
+}
+
+export interface CharacterFormatProperties {
+  bold?: boolean;
+  italic?: boolean;
+  underline?: boolean;
+  strike?: boolean;
+  strikethrough?: boolean;
+  highlight?: string | null;
+  color?: string | null;
+  fontSize?: number | string | null;
+  fontFamily?: string | null;
+}
+
+export interface ParagraphFormatProperties {
+  alignment?: 'left' | 'center' | 'right' | 'both';
+  keepNext?: boolean;
+  keepLines?: boolean;
+  pageBreakBefore?: boolean;
+  style?: string | null;
+}
+
+export interface HighlightDocumentOperation extends DocumentOperationBase {
+  type: 'highlight';
+  textToHighlight: string;
+  color?: string;
+}
+
+export interface CharacterFormatDocumentOperation extends DocumentOperationBase {
+  type: 'format' | 'character-format';
+  textToFormat: string;
+  /** 1-based match of `textToFormat` inside the resolved paragraph (default 1). Independent of `target.occurrence`. */
+  textOccurrence?: number;
+  properties: CharacterFormatProperties;
+  formattingRevisionPolicy?: 'always' | 'coalesce-own-insertion';
+}
+
+export interface ParagraphFormatDocumentOperation extends DocumentOperationBase {
+  type: 'paragraph-format';
+  properties: ParagraphFormatProperties;
+}
+
+export type DocumentOperation =
+  | RedlineDocumentOperation
+  | RestoreDocumentOperation
+  | DeleteDocumentOperation
+  | CommentDocumentOperation
+  | CommentReplyDocumentOperation
+  | CommentResolveDocumentOperation
+  | HighlightDocumentOperation
+  | CharacterFormatDocumentOperation
+  | ParagraphFormatDocumentOperation;
+
+export interface ResolvedDocumentTarget {
+  index: number;
+  paragraphId: string | null;
+  text: string;
+  fingerprint?: string;
+  revisionView?: 'accepted' | 'rejected';
+  inTable?: boolean;
+  targetTextMatch?: {
+    mode: 'exact' | 'space_equivalent' | 'normalized';
+    differences?: Array<{
+      offset: number;
+      sourceCodePoint: string;
+      requestedCodePoint: string;
+    }>;
+    sourceExcerpt?: string;
+    requestedExcerpt?: string;
+  };
+}
+
+export interface ResolvedCommentAnchor {
+  requestIndex: number;
+  paragraphIndex: number;
+  text: string;
+  resolvedBy: 'exact_anchor' | 'space_equivalent_anchor';
+  start: number;
+  end: number;
+}
+
+export interface StandaloneRunnerOptions {
+  atomic?: boolean;
+  continueOnError?: boolean;
+  generateRedlines?: boolean;
+  existingRevisions?: ExistingRevisionsPolicy;
+  strictTargets?: boolean;
+  expectedRevision?: RevisionToken;
+  pairReplacements?: boolean;
+  insertionAffinity?: InsertionAffinity;
+  onInfo?: (message: string) => void;
+  onWarn?: (message: string) => void;
+  [key: string]: unknown;
+}
+
+export interface MutationReceiptRevisionItem {
+  id: string;
+  kind: 'ins' | 'del' | 'move_from' | 'move_to' | 'rPrChange' | 'pPrChange' | 'structural';
+  partName: string;
+}
+
+export interface MutationReceipt {
+  operationIndex: number;
+  operationId?: string;
+  attemptedDisposition: 'applied' | 'no_change' | 'refused' | 'not_attempted';
+  finalDisposition: 'applied' | 'no_change' | 'refused' | 'rolled_back' | 'not_attempted';
+  committed: boolean;
+  authorUsed?: string;
+  revisionItems: MutationReceiptRevisionItem[];
+  commentIds: string[];
+  numberingIds: string[];
+  relationshipIds: string[];
+  affectedTargets: ResolvedDocumentTarget[];
+  warnings: string[];
+}
+
+export interface LocalizedReplacementChange {
+  kind: 'localized_replacement';
+  committed: boolean;
+  finalDisposition: 'applied' | 'rolled_back';
+  target: {
+    paragraphId?: string;
+    index?: number;
+    fingerprint?: string;
+    humanReference?: string;
+  };
+  context?: {
+    search?: string;
+    range?: string;
+    anchorMatchCount?: number;
+    humanReference?: string;
+  };
+  replacements: Array<{
+    find: string;
+    replace: string;
+    occurrence?: number;
+    matchMode?: 'space_equivalent';
+    beforeExcerpt: string;
+    afterExcerpt: string;
+  }>;
+  verification: {
+    acceptedViewMatchesCompiledText: boolean;
+  };
+}
+
+export interface DocumentOperationResult {
+  documentXml: string;
+  hasChanges: boolean;
+  numberingXml?: string | null;
+  commentsXml?: string | null;
+  commentsExtendedXml?: string | null;
+  commentsXmlMode?: 'merge' | 'replace';
+  commentsExtendedXmlMode?: 'merge' | 'replace';
+  warnings?: string[];
+  status?: RedlineStatus;
+  error?: RedlineError;
+  operationType: 'redline' | 'comment' | 'comment_reply' | 'comment_resolve' | 'highlight' | 'format' | 'paragraph-format';
+  authorUsed: string;
+  resolvedBy?: string;
+  resolvedTarget?: ResolvedDocumentTarget;
+  resolvedAnchor?: ResolvedCommentAnchor;
+  receipt?: MutationReceipt;
+  change?: LocalizedReplacementChange;
+}
+
+export interface BatchOperationItemResult {
+  index: number;
+  type: string;
+  operationType: 'redline' | 'comment' | 'comment_reply' | 'comment_resolve' | 'highlight' | 'format' | 'paragraph-format';
+  status: 'applied' | 'no_change' | 'error';
+  authorUsed: string;
+  resolvedBy?: string;
+  resolvedTarget?: ResolvedDocumentTarget;
+  resolvedAnchor?: ResolvedCommentAnchor;
+  warnings?: string[];
+  error?: RedlineError;
+  receipt?: MutationReceipt;
+  change?: LocalizedReplacementChange;
+}
+
+export interface DocumentOperationBatchResult {
+  documentXml: string;
+  hasChanges: boolean;
+  commentsXml: string | null;
+  commentsExtendedXml?: string | null;
+  commentsXmlMode?: 'merge' | 'replace';
+  commentsExtendedXmlMode?: 'merge' | 'replace';
+  numberingXmlParts: string[];
+  results: BatchOperationItemResult[];
+  receipts?: MutationReceipt[];
+  executionOrder: number[];
+  /** Authors attached to committed changes. Empty when an atomic batch rolls back. */
+  authorsUsed: string[];
+  rolledBack?: boolean;
+  status?: RedlineStatus;
+  error?: RedlineError;
+  warnings?: string[];
+  conflicts?: OperationConflict[];
+  retryPlan?: MutationRetryPlan;
+}
+
+export interface MutationRetryPlan {
+  base: 'original' | 'output';
+  committedIndexes: number[];
+  failedIndexes: number[];
+  unattemptedIndexes: number[];
+  replayWholeBatch: boolean;
+  sameArgumentsSafe: false;
+}
+
+export interface OperationPreflightItemResult {
+  index: number;
+  type: string;
+  operationType: 'redline' | 'comment' | 'comment_reply' | 'comment_resolve' | 'highlight' | 'format' | 'paragraph-format';
+  status: 'ready' | 'deferred' | 'error';
+  authorUsed: string;
+  resolvedBy?: string;
+  captureRef?: string;
+  select?: string;
+  resolvedTarget?: ResolvedDocumentTarget;
+  matchDiagnostics?: {
+    exactTextMatch: boolean;
+    normalizedTextMatch: boolean;
+    suppliedText: string;
+    actualText: string;
+  };
+  anchor?: {
+    text: string;
+    found: boolean;
+    resolvedBy?: 'exact_anchor' | 'space_equivalent_anchor';
+    start?: number;
+    end?: number;
+    candidates?: Array<{ start: number; end: number }>;
+  } | null;
+  hasRevisions?: boolean;
+  existingRevisions?: ExistingRevisionsPolicy;
+  warnings?: string[];
+  error?: RedlineError & { candidates?: ResolvedDocumentTarget[] };
+}
+
+export interface OperationConflict {
+  code: 'OVERLAPPING_SOURCE_TARGETS' | 'OVERLAPPING_TEXT_EDITS' | 'REVISION_ORDER_CONFLICT' | 'CAPTURE_FANOUT_CONFLICT' | string;
+  message: string;
+  operationIndexes: number[];
+  target: ResolvedDocumentTarget;
+  recoveryVersion?: number;
+  category?: string;
+  recovery?: RedlineError['recovery'];
+}
+
+export interface OperationPreflightResult {
+  valid: boolean;
+  status: 'ok' | 'error';
+  results: OperationPreflightItemResult[];
+  conflicts: OperationConflict[];
+  authorsUsed: string[];
+  requiredArtifacts: { comments: boolean; numbering: boolean };
+  error?: RedlineError;
+}
+
+export interface OperationDependencyPlan {
+  valid: boolean;
+  scheduled?: Array<{ operation: DocumentOperation; index: number }>;
+  captureProducers?: Map<string, number>;
+  error?: RedlineError;
+}
+
+export function buildOperationDependencyPlan(operations?: DocumentOperation[]): OperationDependencyPlan;
+
+export function orderOperationsForStableTargets(operations?: DocumentOperation[]): DocumentOperation[];
+
+export function preflightOperations(
+  documentXml: string,
+  operations: DocumentOperation[],
+  author?: string,
+  options?: StandaloneRunnerOptions
+): OperationPreflightResult;
+
+export function applyOperationToDocumentXml(
+  documentXml: string,
+  operation: DocumentOperation,
+  author?: string,
+  runtimeContext?: Record<string, unknown> | null,
+  options?: StandaloneRunnerOptions
+): Promise<DocumentOperationResult>;
+
+export function applyOperationsToDocumentXml(
+  documentXml: string,
+  operations: DocumentOperation[],
+  author?: string,
+  runtimeContext?: Record<string, unknown> | null,
+  options?: StandaloneRunnerOptions
+): Promise<DocumentOperationBatchResult>;