docxodus 6.0.0 → 6.2.0

package/dist/types.d.ts

@@ -58,6 +58,45 @@ export declare enum EmptyParagraphMode {
     /** Skip empty paragraphs entirely — they don't appear in the markdown or the anchor index. */
     Suppress = 2
 }
+/**
+ * How anchor ids are rendered inside `{#…}` tokens (and keyed in
+ * {@link MarkdownProjection.anchorIndex}). Mirrors the .NET
+ * `Docxodus.AnchorIdRendering` enum.
+ *
+ * `Anchor.token` (and any `AnchorRef` returned by `DocxSession` mutations)
+ * always carries the full Unid regardless of rendering — the choice only
+ * affects the markdown text. The returned `anchorIndex` is dual-keyed so
+ * lookups by either the rendered id or the full Unid work for the
+ * `Abbreviated`/`Sequential` modes.
+ */
+export declare enum AnchorIdRendering {
+    /** Full 32-char hex Unid (default; e.g. `{#h:body:a1b2c3d4e5f6789012345678901234ab}`). */
+    FullUnid = 0,
+    /** Shortest unique prefix per (kind, scope) bucket, 4-char floor (e.g. `{#h:body:a1b2}`).
+     *  Saves 5-10% of projection-token budget for LLM consumption. */
+    Abbreviated = 1,
+    /** Sequential numeric ids per (kind, scope) bucket in document order (e.g. `{#h:body:1}`).
+     *  Maximally token-efficient for one-shot LLM contexts. NOT stable across
+     *  `project()` calls and must NOT be persisted. */
+    Sequential = 2
+}
+/**
+ * How far below the target anchor to include in
+ * {@link DocxSession.projectAnchor}. Mirrors the .NET
+ * `Docxodus.ProjectionDepth` enum.
+ */
+export declare enum ProjectionDepth {
+    /** Just the target block itself (its anchor + its own text). For headings,
+     *  returns only the heading paragraph, not the section under it. */
+    SelfOnly = 0,
+    /** Self + descendants. Most useful for `tbl` anchors (returns the whole table);
+     *  for paragraphs it's the same as `SelfOnly`. */
+    Subtree = 1,
+    /** Self + descendants + following siblings up to (but not including) the next
+     *  sibling at the same or higher heading level. For non-heading anchors,
+     *  equivalent to `Subtree`. Dominant "give me this section" case; the default. */
+    SubtreeAndFollowingSiblings = 2
+}
 /**
  * Settings controlling the markdown projection. Mirrors the .NET
  * `WmlToMarkdownConverterSettings` class — see `docs/architecture/markdown_projection.md`.
@@ -71,6 +110,16 @@ export interface MarkdownProjectionSettings {
     trackedChanges?: TrackedChangeMode;
     resolveNumbering?: boolean;
     emptyParagraphs?: EmptyParagraphMode;
+    /**
+     * How anchor ids are rendered in markdown output. Default `FullUnid`.
+     * Set to `Abbreviated` for terse LLM-friendly ids; `Sequential` for
+     * 1-based per-scope counters (best for replay logs / human review).
+     * `Anchor.token` (and any `AnchorRef`) always reflects the full Unid
+     * regardless; this only affects the markdown text. Use the returned
+     * {@link MarkdownProjection.anchorIndex} (dual-keyed for Abbreviated /
+     * Sequential) to translate rendered ids back to full Unids.
+     */
+    anchorIdRendering?: AnchorIdRendering;
 }
 /**
  * Resolved location of an anchor in the underlying OOXML package — sufficient to walk
@@ -82,6 +131,14 @@ export interface MarkdownAnchorTarget {
     scope: string;
     unid: string;
     partUri: string;
+    /** First ~80 characters of the element's flat text — for previewing/picking anchors. */
+    textPreview: string;
+    /** Resolved auto-numbering prefix (e.g. "1.", "First") for paragraphs/headings/list
+     *  items whose style or `w:numPr` produces numbering. Absent when the element has
+     *  no numbering. The prefix is NOT included in {@link textPreview} because
+     *  textPreview reflects only the run text; this field gives callers the value
+     *  Word actually renders before the element's text. */
+    autoNumberPrefix?: string;
 }
 /**
  * Output of the markdown projection: rendered text plus the anchor index mapping
@@ -460,6 +517,12 @@ export interface DocxodusWasmExports {
         GenerateAnnotationCss: (labelsJson: string, extAnnotCssClassPrefix: string, extAnnotLabelMode: number) => string;
     };
     DocumentComparer: {
+        /**
+         * Force the comparison code path hot by running a real comparison against
+         * tiny in-memory seed documents. Returns "ok" or a JSON error object.
+         * Idempotent — assemblies load only once.
+         */
+        Warmup: () => string;
         CompareDocuments: (originalBytes: Uint8Array, modifiedBytes: Uint8Array, authorName: string) => Uint8Array;
         CompareDocumentsToHtml: (originalBytes: Uint8Array, modifiedBytes: Uint8Array, authorName: string) => string;
         CompareDocumentsToHtmlWithOptions: (originalBytes: Uint8Array, modifiedBytes: Uint8Array, authorName: string, renderTrackedChanges: boolean) => string;
@@ -474,8 +537,11 @@ export interface DocxodusWasmExports {
         OpenSession: (bytes: Uint8Array, settingsJson: string) => number;
         CloseSession: (handle: number) => void;
         Project: (handle: number) => string;
+        ProjectAnchor: (handle: number, anchorId: string, depth: number) => string;
         ReplaceText: (handle: number, anchor: string, md: string) => string;
         DeleteBlock: (handle: number, anchor: string) => string;
+        DeleteRange: (handle: number, fromAnchorId: string, toAnchorIdExclusive: string) => string;
+        DeleteSection: (handle: number, headingAnchorId: string) => string;
         InsertParagraph: (handle: number, anchor: string, pos: string, md: string) => string;
         SplitParagraph: (handle: number, anchor: string, offset: number) => string;
         MergeParagraphs: (handle: number, first: string, second: string) => string;
@@ -492,11 +558,25 @@ export interface DocxodusWasmExports {
         GrepCrossBlock: (handle: number, pattern: string, optionsJson: string) => string;
         ReplaceTextRange: (handle: number, anchor: string, find: string, replace: string, optionsJson: string) => string;
         ReplaceTextAtSpan: (handle: number, anchor: string, spanStart: number, spanLength: number, replace: string) => string;
-        FindPlaceholders: (handle: number, kinds: number, scope: number) => string;
+        ReplaceInner: (handle: number, matchText: string, anchor: string, spanStart: number, spanLength: number, newInner: string) => string;
+        FindPlaceholders: (handle: number, kinds: number, scope: number, contextChars: number, boundary: number) => string;
+        GetEditSummary: (handle: number) => string;
+        RemainingPlaceholders: (handle: number, kinds: number) => string;
+        GetDiff: (handle: number, format: number) => string;
         FindByAnnotation: (handle: number, annotationId: string) => string;
         FindByLabel: (handle: number, labelId: string) => string;
         FindByBookmark: (handle: number, bookmarkName: string) => string;
+        GetAnchorInfo: (handle: number, anchorId: string) => string;
+        GetAnchorInfos: (handle: number, anchorIdsJson: string) => string;
+        GetBlockMetadata: (handle: number, anchorId: string) => string;
+        GetBlockMetadatas: (handle: number, anchorIdsJson: string) => string;
+        GetListMembership: (handle: number, anchorId: string) => string;
+        GetSectionInfo: (handle: number, anchorId: string) => string;
         ListAnnotations: (handle: number) => string;
+        AddAnnotation: (handle: number, anchorId: string, spanJson: string, annotationJson: string) => string;
+        SessionRemoveAnnotation: (handle: number, annotationId: string) => string;
+        UpdateAnnotation: (handle: number, annotationId: string, updateJson: string) => string;
+        MoveAnnotation: (handle: number, annotationId: string, newAnchorId: string, newSpanJson: string) => string;
         Undo: (handle: number) => boolean;
         Redo: (handle: number) => boolean;
         Save: (handle: number) => Uint8Array;
@@ -559,6 +639,12 @@ export interface DocxSessionSettings {
      * straight-quoted text adjacent to surrounding already-curly text. Default false.
      */
     smartQuotes?: boolean;
+    /**
+     * When `true` (default), the session projects the document at construction
+     * time so {@link DocxSession.getDiff} can compare initial vs. current.
+     * Set to `false` to skip the ~200ms upfront cost if you don't plan to diff.
+     */
+    captureInitialProjection?: boolean;
 }
 export interface DocxSessionProjection {
     markdown: string;
@@ -567,6 +653,7 @@ export interface DocxSessionProjection {
         unid: string;
         kind: string;
         scope: string;
+        textPreview: string;
     }>;
 }
 /**
@@ -665,11 +752,132 @@ export declare const PlaceholderKinds: {
     readonly Instruction: 4;
     readonly All: 7;
 };
+/**
+ * Numeric flag layout matching the .NET `DiffFormat` enum. Use with
+ * {@link DocxSession.getDiff}.
+ *
+ * - `Json` (default) — anchor-keyed structured diff. Returns a `DiffEntry[]`.
+ * - `Unified` — `patch(1)`-compatible unified diff over the markdown projection.
+ *   Returns a single string (`""` when nothing changed).
+ * - `SideBySide` — two-column human-review diff (`diff -y` style) over the
+ *   markdown projection. Returns a single string.
+ */
+export declare const DiffFormat: {
+    readonly Json: 0;
+    readonly Unified: 1;
+    readonly SideBySide: 2;
+};
+/**
+ * A single anchor-keyed change in the diff between an initial and current projection.
+ */
+export interface DiffEntry {
+    op: "delete" | "insert" | "modify";
+    anchorId: string;
+    /** Pre-change text content for delete/modify; absent for insert. */
+    before?: string;
+    /** Post-change text content for insert/modify; absent for delete. */
+    after?: string;
+}
+/**
+ * Aggregate snapshot of edit-state introspection signals returned by
+ * {@link DocxSession.getEditSummary}.
+ */
+export interface EditSummary {
+    totalAnchors: number;
+    remainingPlaceholders: TemplatePlaceholder[];
+    bareUnderscoreRuns: TextMatch[];
+    footnoteCount: number;
+    inlineFootnoteRefCount: number;
+    commentCount: number;
+}
+/**
+ * Numeric flag layout matching the .NET `ContextBoundary` enum. Controls
+ * how `Grep` / `GrepCrossBlock` / `FindPlaceholders` decide where to stop
+ * walking outward when computing `TextMatch.contextBefore` / `contextAfter`.
+ *
+ * - `Char` (default) — truncate at `contextChars`. Matches legacy behavior.
+ * - `Bracket` — stop at `[` or `]`. Use for template fills: each placeholder's
+ *   context is unambiguously its own even when multiple placeholders crowd
+ *   into one sentence.
+ * - `Sentence` — stop at `.`, `!`, `?`, `:`, `;`.
+ * - `Comma` — stop at `,`. For matches inside enumerations.
+ */
+export declare const ContextBoundary: {
+    readonly Char: 0;
+    readonly Bracket: 1;
+    readonly Sentence: 2;
+    readonly Comma: 3;
+};
 export interface TemplatePlaceholder {
     kind: PlaceholderKind;
     /** For `instruction` placeholders: the inner text with surrounding brackets/asterisks stripped. */
     hint?: string;
     match: TextMatch;
+    /**
+     * Additional plausible classifications when the primary `kind` is borderline.
+     * Empty by default. The classic case is a long bracketed clause that happens
+     * to contain a `_______` blank: primary `kind` stays `"blank_fill"`
+     * (back-compat) and `alternativeKinds` contains `"alternative_clause"`.
+     */
+    alternativeKinds: PlaceholderKind[];
+}
+/**
+ * Options for {@link DocxSession.fillPlaceholders}.
+ */
+export interface FillOptions {
+    /** Which placeholder kinds to fill. Defaults to `PlaceholderKinds.All` so the
+     *  picker is invoked for every kind in the doc. Narrow with e.g.
+     *  `PlaceholderKinds.BlankFill | PlaceholderKinds.Instruction` to ignore
+     *  bracketed alternative clauses. */
+    kinds?: number;
+    /** Which package parts to scan. Defaults to body (1). */
+    scope?: number;
+    /** Max iteration passes for multi-pass nested-bracket scenarios. Default 8. */
+    maxPasses?: number;
+    /** When the match starts with `$` and the picker's return value doesn't,
+     *  preserve the `$` by prepending it. Default true. */
+    preserveDollarPrefix?: boolean;
+    /** Cap on `contextBefore` / `contextAfter` length on each side. Default 80. */
+    contextChars?: number;
+    /** Where to stop walking outward when computing context. Numeric layout
+     *  matching {@link ContextBoundary}. Default `Char` (0). */
+    boundary?: number;
+    /** When the picker returns an empty string (and after `$`-prefix preservation
+     *  has been applied), look at the chars immediately adjacent to the placeholder
+     *  span and absorb surrounding whitespace / leading-space-before-punctuation /
+     *  matched-brackets so the dropped placeholder doesn't leave cosmetic
+     *  artifacts. Default `false` (preserve the literal-delete behavior).
+     *
+     *  Rules: whitespace on both sides collapses to one space; whitespace before
+     *  and clause-terminating punctuation (`. , ; : ! ?`) after drops the leading
+     *  space; matched open/close brackets (`()` `[]` `{}`) on either side drop
+     *  both. NBSP / narrow NBSP / thin space are treated as whitespace.
+     *
+     *  Caveat: `$`-prefix preservation runs first, so a picker returning `""` for
+     *  `$[xxx]` with `preserveDollarPrefix: true` (default) ends up replacing with
+     *  `"$"` and coalescing is skipped. Set `preserveDollarPrefix: false` when you
+     *  want the `$` to drop along with the brackets. */
+    coalesceWhitespaceAroundEmptyFill?: boolean;
+}
+/**
+ * Aggregate result returned by {@link DocxSession.fillPlaceholders}.
+ *
+ * `skipped` counts placeholders the picker returned null for in the first pass
+ * that saw them — it stays > 0 even if later passes finished those same
+ * placeholders. Use `stillPresent` (post-loop document state) for the
+ * trustworthy "is the template done?" check; `skipped > 0 && stillPresent === 0`
+ * means "picker said no the first time but later passes resolved it."
+ */
+export interface BulkEditResult {
+    filled: number;
+    skipped: number;
+    /** Number of placeholders matching `options.kinds` in `options.scope` that
+     *  remain in the document after the final pass. `0` means the template is
+     *  fully filled for the requested kinds/scope. */
+    stillPresent: number;
+    passes: number;
+    unfilled: TemplatePlaceholder[];
+    errors: EditError[];
 }
 /**
  * Options for {@link DocxSession.grep}.
@@ -692,6 +900,13 @@ export interface GrepOptions {
      *   - 1 = Normalize (fold NBSP / narrow-NBSP / thin-space to ASCII space before matching)
      */
     whitespace?: number;
+    /**
+     * Where to stop walking outward when computing `TextMatch.contextBefore` /
+     * `contextAfter`. Numeric layout matching the .NET `ContextBoundary` enum;
+     * use the {@link ContextBoundary} const. Default `Char` (0) — truncate at
+     * `contextChars`.
+     */
+    boundary?: number;
 }
 /**
  * Resolved location of an anchor — what {@link DocxSession.findByAnnotation} and
@@ -701,13 +916,85 @@ export interface GrepOptions {
  */
 export interface AnchorTargetRef extends AnchorRef {
     partUri: string;
+    /** First ~80 characters of the element's flat text — for previewing/picking anchors. */
+    textPreview: string;
+    /** Resolved auto-numbering prefix (e.g. "1.", "First") when the element carries
+     *  numbering. Absent otherwise. See {@link MarkdownAnchorTarget.autoNumberPrefix}. */
+    autoNumberPrefix?: string;
+}
+/**
+ * The shape returned by {@link DocxSession.getAnchorInfo}.
+ * Use {@link MarkdownAnchorTarget} when iterating a full projection — it
+ * includes the same fields plus `unid` and `partUri`.
+ */
+export interface AnchorInfo {
+    id: string;
+    kind: string;
+    scope: string;
+    textPreview: string;
+    /** Resolved auto-numbering prefix (e.g. "1.", "First") when the element carries
+     *  numbering. Absent for un-numbered paragraphs or non-paragraph kinds. */
+    autoNumberPrefix?: string;
+}
+/** Six list formats supported by the list write surface (decimal, upperLetter,
+ *  lowerLetter, upperRoman, lowerRoman, bullet). Surfaced on
+ *  {@link ListMembership.format} as a string union (mirrors the JSON wire format). */
+export type NumberFormat = "decimal" | "upperLetter" | "lowerLetter" | "upperRoman" | "lowerRoman" | "bullet";
+/** Numbering facts for a list-item paragraph. Returned by
+ *  {@link DocxSession.getListMembership} and surfaced as {@link BlockMetadata.list}. */
+export interface ListMembership {
+    /** The w:numId the paragraph belongs to (the w:num instance). */
+    numId: number;
+    /** The w:abstractNumId the paragraph's w:num points at. */
+    abstractNumId: number;
+    /** The paragraph's level (w:ilvl), 0-8. */
+    level: number;
+    /** Resolved format for this level. */
+    format: NumberFormat;
+    /** Always true for a paragraph carrying w:numPr (inline or via style). */
+    isAutoNumbered: boolean;
+    /** True when the w:numPr is inherited from the paragraph's style chain. */
+    fromStyle: boolean;
+    /** Start-override from w:lvlOverride/w:startOverride for this level, if any. */
+    startOverride?: number;
+    /** Resolved label (e.g. "1.", "(a)") — same value surfaced via AnchorInfo.autoNumberPrefix. */
+    generatedLabel?: string;
+}
+/** Block-level structural metadata. Returned by {@link DocxSession.getBlockMetadata}. */
+export interface BlockMetadata {
+    anchorId: string;
+    kind: string;
+    scope: string;
+    styleId?: string;
+    styleName?: string;
+    /** 0-based outline level (Word convention). */
+    outlineLevel?: number;
+    list?: ListMembership;
+    /** True when any descendant w:r carries a non-empty w:rPr. */
+    hasInlineFormatting: boolean;
+}
+/** Page-layout snapshot for the w:sectPr that governs an anchor.
+ *  Returned by {@link DocxSession.getSectionInfo}. */
+export interface SectionInfo {
+    sectionUnid: string;
+    pageWidthTwips: number;
+    pageHeightTwips: number;
+    landscape: boolean;
+    marginTopTwips: number;
+    marginBottomTwips: number;
+    marginLeftTwips: number;
+    marginRightTwips: number;
+    columns: number;
+    headerPartUris: string[];
+    footerPartUris: string[];
 }
 /**
  * A custom annotation persisted in the document via Docxodus' annotation system.
  * Returned by {@link DocxSession.listAnnotations}; mirrors the wire-relevant
- * fields of the .NET `DocumentAnnotation` type. Stale page caches and arbitrary
- * metadata are omitted to keep the JSON payload compact — callers that need them
- * can use the .NET API directly.
+ * fields of the .NET `DocumentAnnotation` type. The page-info cache fields
+ * (`startPage`/`endPage`/`pageInfoStale`/`pageInfoComputedAt`) are omitted to
+ * keep the JSON payload compact — callers that need them can use the .NET API
+ * directly. The `metadata` bag is emitted only when non-empty.
  *
  * See `docs/architecture/custom_annotations.md` for the persistence design.
  */
@@ -728,6 +1015,21 @@ export interface DocumentAnnotation {
     created?: string;
     /** The text content covered by the annotation's bookmark, populated when reading. */
     annotatedText?: string;
+    /** Arbitrary string→string metadata bag persisted with the annotation. */
+    metadata?: Record<string, string>;
+}
+/**
+ * Partial-update payload for {@link DocxSession.updateAnnotation}.
+ * Null/missing fields leave the existing value unchanged. `metadataPatch`
+ * is a per-key merge: a non-null value sets the key, an explicit `null`
+ * removes it, a missing key leaves it unchanged.
+ */
+export interface AnnotationUpdate {
+    labelId?: string;
+    label?: string;
+    color?: string;
+    author?: string;
+    metadataPatch?: Record<string, string | null>;
 }
 /**
  * Severity level for comparison log entries.
@@ -1275,7 +1577,7 @@ export interface DocumentMetadata {
 /**
  * Message types sent from main thread to worker.
  */
-export type WorkerRequestType = "init" | "convertDocxToHtml" | "compareDocuments" | "compareDocumentsToHtml" | "getRevisions" | "getDocumentMetadata" | "getVersion";
+export type WorkerRequestType = "init" | "convertDocxToHtml" | "compareDocuments" | "compareDocumentsToHtml" | "getRevisions" | "getDocumentMetadata" | "getVersion" | "prepare" | "sessionOpen" | "sessionClose" | "sessionAddAnnotation" | "sessionRemoveAnnotation" | "sessionUpdateAnnotation" | "sessionMoveAnnotation";
 /**
  * Base structure for worker requests.
  */
@@ -1351,10 +1653,74 @@ export interface WorkerGetDocumentMetadataRequest extends WorkerRequestBase {
 export interface WorkerGetVersionRequest extends WorkerRequestBase {
     type: "getVersion";
 }
+/**
+ * Warm up the comparison code path so the next compare triggers no further
+ * WASM assembly fetches. Carries no payload.
+ */
+export interface WorkerPrepareRequest extends WorkerRequestBase {
+    type: "prepare";
+}
+/**
+ * Open a DocxSession in the worker.
+ */
+export interface WorkerSessionOpenRequest extends WorkerRequestBase {
+    type: "sessionOpen";
+    /** Document bytes transferred to the worker */
+    documentBytes: Uint8Array;
+    /** Session settings as JSON */
+    settingsJson?: string;
+}
+/**
+ * Close a worker DocxSession.
+ */
+export interface WorkerSessionCloseRequest extends WorkerRequestBase {
+    type: "sessionClose";
+    /** Session handle returned by sessionOpen */
+    handle: number;
+}
+/**
+ * Add an annotation via a worker DocxSession.
+ */
+export interface WorkerSessionAddAnnotationRequest extends WorkerRequestBase {
+    type: "sessionAddAnnotation";
+    handle: number;
+    anchorId: string;
+    /** CharSpan as JSON, or empty string for block-level */
+    spanJson: string;
+    annotationJson: string;
+}
+/**
+ * Remove an annotation via a worker DocxSession.
+ */
+export interface WorkerSessionRemoveAnnotationRequest extends WorkerRequestBase {
+    type: "sessionRemoveAnnotation";
+    handle: number;
+    annotationId: string;
+}
+/**
+ * Update an annotation via a worker DocxSession.
+ */
+export interface WorkerSessionUpdateAnnotationRequest extends WorkerRequestBase {
+    type: "sessionUpdateAnnotation";
+    handle: number;
+    annotationId: string;
+    updateJson: string;
+}
+/**
+ * Move an annotation via a worker DocxSession.
+ */
+export interface WorkerSessionMoveAnnotationRequest extends WorkerRequestBase {
+    type: "sessionMoveAnnotation";
+    handle: number;
+    annotationId: string;
+    newAnchorId: string;
+    /** CharSpan as JSON, or empty string for block-level */
+    newSpanJson: string;
+}
 /**
  * Union type of all possible worker requests.
  */
-export type WorkerRequest = WorkerInitRequest | WorkerConvertRequest | WorkerCompareRequest | WorkerCompareToHtmlRequest | WorkerGetRevisionsRequest | WorkerGetDocumentMetadataRequest | WorkerGetVersionRequest;
+export type WorkerRequest = WorkerInitRequest | WorkerConvertRequest | WorkerCompareRequest | WorkerCompareToHtmlRequest | WorkerGetRevisionsRequest | WorkerGetDocumentMetadataRequest | WorkerGetVersionRequest | WorkerPrepareRequest | WorkerSessionOpenRequest | WorkerSessionCloseRequest | WorkerSessionAddAnnotationRequest | WorkerSessionRemoveAnnotationRequest | WorkerSessionUpdateAnnotationRequest | WorkerSessionMoveAnnotationRequest;
 /**
  * Base structure for worker responses.
  */
@@ -1420,10 +1786,39 @@ export interface WorkerGetVersionResponse extends WorkerResponseBase {
     /** Version information */
     version?: VersionInfo;
 }
+/**
+ * Response from prepare request. Carries no payload beyond success/error.
+ */
+export interface WorkerPrepareResponse extends WorkerResponseBase {
+    type: "prepare";
+}
+/**
+ * Response from sessionOpen request.
+ */
+export interface WorkerSessionOpenResponse extends WorkerResponseBase {
+    type: "sessionOpen";
+    /** Integer handle identifying the session in the worker */
+    handle?: number;
+}
+/**
+ * Response from sessionClose request.
+ */
+export interface WorkerSessionCloseResponse extends WorkerResponseBase {
+    type: "sessionClose";
+}
+/**
+ * Response from session annotation write operations.
+ * The `result` field is the serialised EditResult from the WASM bridge.
+ */
+export interface WorkerSessionEditResponse extends WorkerResponseBase {
+    type: "sessionAddAnnotation" | "sessionRemoveAnnotation" | "sessionUpdateAnnotation" | "sessionMoveAnnotation";
+    /** EditResult returned by the session operation */
+    result?: EditResult;
+}
 /**
  * Union type of all possible worker responses.
  */
-export type WorkerResponse = WorkerInitResponse | WorkerConvertResponse | WorkerCompareResponse | WorkerCompareToHtmlResponse | WorkerGetRevisionsResponse | WorkerGetDocumentMetadataResponse | WorkerGetVersionResponse;
+export type WorkerResponse = WorkerInitResponse | WorkerConvertResponse | WorkerCompareResponse | WorkerCompareToHtmlResponse | WorkerGetRevisionsResponse | WorkerGetDocumentMetadataResponse | WorkerGetVersionResponse | WorkerPrepareResponse | WorkerSessionOpenResponse | WorkerSessionCloseResponse | WorkerSessionEditResponse;
 /**
  * Options for creating a worker-based Docxodus instance.
  */