@eigenpal/docx-editor-agents 1.2.1 → 1.3.0

package/dist/{server-uM9UUIhk.d.mts → server-BaVhdHCd.d.mts}

@@ -970,6 +970,70 @@ interface Table {
     rows: TableRow[];
 }
 
+/**
+ * Watermark — the MS Word "Design → Watermark" feature.
+ *
+ * In OOXML a watermark is legacy VML stored inside a header part, inside a
+ * paragraph run: `<w:pict><v:shape>…</v:shape></w:pict>`. It renders behind
+ * the body content on every page of the section. Word supports two kinds:
+ *
+ * - **Text** — `<v:shape type="#_x0000_t136"><v:textpath string="DRAFT"/>`
+ *   with a fill color, font, optional rotation (diagonal vs horizontal) and a
+ *   reduced-opacity "semitransparent" look.
+ * - **Picture** — `<v:shape><v:imagedata r:id="rIdN"/>` referencing a media
+ *   file, scaled, optionally "washed out" (lightened).
+ *
+ * We model the watermark as a dedicated field on the owning `HeaderFooter`
+ * rather than as editable run content, so it stays out of the ProseMirror text
+ * flow while still round-tripping through parse → render → serialize.
+ */
+/**
+ * Text watermark (e.g. "CONFIDENTIAL", "DRAFT").
+ */
+interface TextWatermark {
+    kind: 'text';
+    /** The watermark text. */
+    text: string;
+    /** Font family (e.g. 'Calibri'). */
+    font: string;
+    /** Fill color as a CSS hex string (e.g. '#C0C0C0'). */
+    color: string;
+    /** Word's "Semitransparent" checkbox — renders at reduced opacity. */
+    semitransparent: boolean;
+    /** Diagonal (≈ -45°) or horizontal layout. */
+    layout: 'diagonal' | 'horizontal';
+    /** Font size in points. When undefined the renderer auto-sizes to the page (Word's "Auto"). */
+    fontSize?: number;
+}
+/**
+ * Picture watermark — a scaled, optionally washed-out background image.
+ */
+interface PictureWatermark {
+    kind: 'picture';
+    /** Header-part relationship id of the media (set for images parsed from an existing file). */
+    relId?: string;
+    /** Package path of the media, e.g. 'word/media/image1.png'. */
+    mediaPath?: string;
+    /** Raw bytes for an image added in-editor (no rId yet). */
+    data?: Uint8Array;
+    /** MIME type for `data`. */
+    contentType?: string;
+    /** Ready-to-use data URL for rendering (resolved from media or `data`). */
+    dataUrl?: string;
+    /** Scale factor; 1 = 100% / Word's "Auto". */
+    scale: number;
+    /** Word's "Washout" checkbox — lightens the image so text stays readable. */
+    washout: boolean;
+    /** Natural width in EMUs (when known). */
+    widthEmu?: number;
+    /** Natural height in EMUs (when known). */
+    heightEmu?: number;
+}
+/**
+ * A document watermark — text or picture.
+ */
+type Watermark = TextWatermark | PictureWatermark;
+
 /**
  * Page furniture — headers (`w:hdr`), footers (`w:ftr`), footnotes
  * (`w:footnote`), and endnotes (`w:endnote`), plus the section-level
@@ -1000,6 +1064,12 @@ interface HeaderFooter {
     hdrFtrType: HeaderFooterType;
     /** Content (paragraphs, tables, etc.) */
     content: BlockContent[];
+    /**
+     * Watermark stored on this header (MS Word "Design → Watermark"). Lives
+     * here, not in `content`, so it stays out of the editable text flow while
+     * still round-tripping. Only headers carry watermarks; footers never do.
+     */
+    watermark?: Watermark;
 }
 /**
  * Footnote position
@@ -1042,12 +1112,23 @@ interface Footnote {
     noteType?: 'normal' | 'separator' | 'continuationSeparator' | 'continuationNotice';
     /**
      * Content. Per ECMA-376 §17.11.10 footnotes can hold the same blocks as
-     * the body — paragraphs and tables. The parser previously only collected
-     * <w:p> children which silently dropped any <w:tbl> inside a footnote;
-     * widened to match HeaderFooter / TableCell shape so the body pipeline
-     * (toProseDoc → toFlowBlocks) can render them uniformly.
+     * the body, so the note parser reuses the body's `parseBlockContent`: the
+     * full block model — paragraphs, tables, and block-level `w:sdt` content
+     * controls (as `BlockSdt`) — flows through the body pipeline
+     * (toProseDoc → toFlowBlocks) and stays editable on round-trip.
      */
     content: BlockContent[];
+    /**
+     * Verbatim original XML of the entire `<w:footnote>` element, captured at
+     * parse time ONLY when the note body carries a block-level construct the
+     * model still can't represent — note-level bookmarks
+     * (`w:bookmarkStart`/`w:bookmarkEnd`) or `w:customXml`. Block-level `w:sdt`
+     * is NOT a trigger: it round-trips through the model as `BlockSdt`. When
+     * present the serializer re-emits these bytes instead of rebuilding from
+     * `content`, restoring pre-#646 fidelity for the unmodeled constructs.
+     * See `parseNoteBlockContent` / `serializeNote` for the gate (#646 F3).
+     */
+    verbatimXml?: string;
 }
 /**
  * Endnote (w:endnote)
@@ -1060,9 +1141,12 @@ interface Endnote {
     noteType?: 'normal' | 'separator' | 'continuationSeparator' | 'continuationNotice';
     /**
      * Content. Per ECMA-376 §17.11.4 endnotes can hold the same blocks as
-     * the body — paragraphs and tables. See note on `Footnote.content`.
+     * the body — paragraphs, tables, and block-level content controls. See note
+     * on `Footnote.content`.
      */
     content: BlockContent[];
+    /** Verbatim original XML — see `Footnote.verbatimXml` (#646 F3). */
+    verbatimXml?: string;
 }
 
 /**
@@ -1763,6 +1847,29 @@ interface NoteReferenceContent {
     /** Note ID */
     id: number;
 }
+/**
+ * Footnote/endnote auto-number mark (`w:footnoteRef` / `w:endnoteRef`).
+ *
+ * Distinct from {@link NoteReferenceContent}: that is the *reference* placed in
+ * the document body (`w:footnoteReference`), whereas this is the numbering
+ * placeholder that lives *inside* the note body — the run carrying it is what
+ * Word renders as the note's leading superscript number. Preserving it keeps
+ * the note's own number visible on round-trip.
+ */
+interface NoteRefMarkContent {
+    type: 'footnoteRefMark' | 'endnoteRefMark';
+}
+/**
+ * Footnote/endnote separator mark (`w:separator` / `w:continuationSeparator`).
+ *
+ * These appear inside the special separator notes (`w:type="separator"` and
+ * `w:type="continuationSeparator"`) and draw the horizontal rule Word places
+ * between the body and its notes. They carry no content; Word rejects a notes
+ * part whose separator notes have lost these markers, so they must round-trip.
+ */
+interface SeparatorContent {
+    type: 'separator' | 'continuationSeparator';
+}
 /**
  * Field character (begin/separate/end)
  */
@@ -1814,7 +1921,7 @@ interface ShapeContent {
 /**
  * All possible run content types
  */
-type RunContent = TextContent | TabContent | BreakContent | SymbolContent | NoteReferenceContent | FieldCharContent | InstrTextContent | SoftHyphenContent | NoBreakHyphenContent | DrawingContent | ShapeContent;
+type RunContent = TextContent | TabContent | BreakContent | SymbolContent | NoteReferenceContent | NoteRefMarkContent | SeparatorContent | FieldCharContent | InstrTextContent | SoftHyphenContent | NoBreakHyphenContent | DrawingContent | ShapeContent;
 /**
  * A run (`w:r`) — a contiguous span of inline content sharing one set of
  * character properties (bold, italic, font, color, etc.). Runs are the
@@ -2121,10 +2228,20 @@ interface DocxPackage {
     settings?: DocumentSettings;
     /** Font table */
     fontTable?: FontTable;
-    /** Footnotes */
+    /** Footnotes (normal notes only — separators live in `footnoteSeparators`) */
     footnotes?: Footnote[];
-    /** Endnotes */
+    /** Endnotes (normal notes only — separators live in `endnoteSeparators`) */
     endnotes?: Endnote[];
+    /**
+     * Separator footnotes (`w:type="separator"` / `"continuationSeparator"` /
+     * `"continuationNotice"`) kept out of `footnotes` so rendering/layout only
+     * sees real notes. Retained for round-trip: Word rejects a footnotes part
+     * whose separator notes are missing, so the serializer re-emits these ahead
+     * of the normal notes.
+     */
+    footnoteSeparators?: Footnote[];
+    /** Separator endnotes — see `footnoteSeparators`. */
+    endnoteSeparators?: Endnote[];
     /** Headers by relationship ID */
     headers?: Map<string, HeaderFooter>;
     /** Footers by relationship ID */
@@ -2218,7 +2335,24 @@ interface ReviewChange {
     date: string | null;
     text: string;
     context: string;
+    /**
+     * Index of the containing paragraph. For body changes this is the
+     * document-wide paragraph index; for note changes it is the paragraph index
+     * *within that note* (note bodies have their own numbering), so pair it with
+     * `noteId` / `noteType` rather than reading it as a body index.
+     */
     paragraphIndex: number;
+    /**
+     * Set when the change lives inside a footnote or endnote. Such changes are
+     * surfaced for discovery only — accept/reject operate on the body, so an id
+     * that resolves *only* to a note change throws `NoteChangeNotEditableError`
+     * (an id also present on a body change resolves to the body change). The
+     * raw `id` is not namespaced across parts, so pair it with `noteId` /
+     * `noteType` to identify the change.
+     */
+    noteId?: number;
+    /** Which note store the change came from. Absent for body changes. */
+    noteType?: 'footnote' | 'endnote';
 }
 interface ReviewCommentReply {
     id: number;
@@ -2239,6 +2373,10 @@ interface ReviewComment {
 interface ChangeFilter {
     author?: string;
     type?: 'insertion' | 'deletion' | 'moveFrom' | 'moveTo';
+    /** Also report tracked changes inside footnote bodies. Default: false. */
+    includeFootnotes?: boolean;
+    /** Also report tracked changes inside endnote bodies. Default: false. */
+    includeEndnotes?: boolean;
 }
 interface CommentFilter {
     author?: string;
@@ -2457,7 +2595,21 @@ declare class DocxReviewer {
      * Avoids JSON quote-escaping issues — LLMs can copy text verbatim.
      */
     getContentAsText(options?: GetContentOptions): string;
-    /** Get all tracked changes in the document. */
+    /**
+     * Get all tracked changes in the document. Pass `includeFootnotes` /
+     * `includeEndnotes` in the filter to also report changes inside note bodies
+     * (each such change carries `noteId` / `noteType`).
+     *
+     * The reported `id` is the raw `w:id`, which is unique only within its part
+     * (document.xml / footnotes.xml / endnotes.xml) — it is NOT namespaced across
+     * parts, so the same `id` can appear on a body change and a note change. Use
+     * `noteType` / `noteId` to disambiguate.
+     *
+     * Note changes are surfaced for discovery only. `acceptChange` /
+     * `rejectChange` operate on the document body, so an id that resolves *only*
+     * to a note change throws {@link NoteChangeNotEditableError} rather than
+     * mutating it (an id shared with a body change resolves to the body change).
+     */
     getChanges(filter?: ChangeFilter): ReviewChange[];
     /** Get all comments with their replies. */
     getComments(filter?: CommentFilter): ReviewComment[];
@@ -2505,9 +2657,38 @@ declare class DocxReviewer {
     proposeInsertion(options: ProposeInsertionOptions): void;
     /** Delete text as a tracked change. */
     proposeDeletion(options: ProposeDeletionOptions): void;
-    /** Accept a tracked change by its revision ID. */
+    /**
+     * Guard the body-only accept/reject path against in-note changes.
+     *
+     * A tracked-change `w:id` is unique only within its part, so the same id can
+     * appear in the body and in a footnote/endnote. When the id resolves to a
+     * body change we let the body-only impl handle it (body wins; the note, if
+     * any, is left untouched). When the id resolves ONLY to a note change we fail
+     * closed with {@link NoteChangeNotEditableError} rather than mis-reporting it
+     * as not-found — accept/reject cannot yet mutate note bodies.
+     */
+    private assertNotNoteOnly;
+    /**
+     * Accept a tracked change by its revision ID. Operates on the document body
+     * only.
+     *
+     * The public `id` is a `w:id`, which is unique only within its part, so the
+     * same id may appear in the body and in a footnote/endnote. Resolution is
+     * body-first: if a body change carries this id it is accepted and any
+     * same-id note change is left untouched. If the id resolves *only* to a note
+     * change, this throws {@link NoteChangeNotEditableError} (note bodies are not
+     * yet mutable here). If it resolves to nothing, it throws
+     * {@link ChangeNotFoundError}.
+     */
     acceptChange(id: number): void;
-    /** Reject a tracked change by its revision ID. */
+    /**
+     * Reject a tracked change by its revision ID. Operates on the document body
+     * only.
+     *
+     * Same resolution rules as {@link acceptChange}: body-first, throws
+     * {@link NoteChangeNotEditableError} for a note-only id, and
+     * {@link ChangeNotFoundError} when the id matches nothing.
+     */
     rejectChange(id: number): void;
     /** Accept all tracked changes. Returns count accepted. */
     acceptAll(): number;

package/dist/{server-uM9UUIhk.d.ts → server-BaVhdHCd.d.ts}

@@ -970,6 +970,70 @@ interface Table {
     rows: TableRow[];
 }
 
+/**
+ * Watermark — the MS Word "Design → Watermark" feature.
+ *
+ * In OOXML a watermark is legacy VML stored inside a header part, inside a
+ * paragraph run: `<w:pict><v:shape>…</v:shape></w:pict>`. It renders behind
+ * the body content on every page of the section. Word supports two kinds:
+ *
+ * - **Text** — `<v:shape type="#_x0000_t136"><v:textpath string="DRAFT"/>`
+ *   with a fill color, font, optional rotation (diagonal vs horizontal) and a
+ *   reduced-opacity "semitransparent" look.
+ * - **Picture** — `<v:shape><v:imagedata r:id="rIdN"/>` referencing a media
+ *   file, scaled, optionally "washed out" (lightened).
+ *
+ * We model the watermark as a dedicated field on the owning `HeaderFooter`
+ * rather than as editable run content, so it stays out of the ProseMirror text
+ * flow while still round-tripping through parse → render → serialize.
+ */
+/**
+ * Text watermark (e.g. "CONFIDENTIAL", "DRAFT").
+ */
+interface TextWatermark {
+    kind: 'text';
+    /** The watermark text. */
+    text: string;
+    /** Font family (e.g. 'Calibri'). */
+    font: string;
+    /** Fill color as a CSS hex string (e.g. '#C0C0C0'). */
+    color: string;
+    /** Word's "Semitransparent" checkbox — renders at reduced opacity. */
+    semitransparent: boolean;
+    /** Diagonal (≈ -45°) or horizontal layout. */
+    layout: 'diagonal' | 'horizontal';
+    /** Font size in points. When undefined the renderer auto-sizes to the page (Word's "Auto"). */
+    fontSize?: number;
+}
+/**
+ * Picture watermark — a scaled, optionally washed-out background image.
+ */
+interface PictureWatermark {
+    kind: 'picture';
+    /** Header-part relationship id of the media (set for images parsed from an existing file). */
+    relId?: string;
+    /** Package path of the media, e.g. 'word/media/image1.png'. */
+    mediaPath?: string;
+    /** Raw bytes for an image added in-editor (no rId yet). */
+    data?: Uint8Array;
+    /** MIME type for `data`. */
+    contentType?: string;
+    /** Ready-to-use data URL for rendering (resolved from media or `data`). */
+    dataUrl?: string;
+    /** Scale factor; 1 = 100% / Word's "Auto". */
+    scale: number;
+    /** Word's "Washout" checkbox — lightens the image so text stays readable. */
+    washout: boolean;
+    /** Natural width in EMUs (when known). */
+    widthEmu?: number;
+    /** Natural height in EMUs (when known). */
+    heightEmu?: number;
+}
+/**
+ * A document watermark — text or picture.
+ */
+type Watermark = TextWatermark | PictureWatermark;
+
 /**
  * Page furniture — headers (`w:hdr`), footers (`w:ftr`), footnotes
  * (`w:footnote`), and endnotes (`w:endnote`), plus the section-level
@@ -1000,6 +1064,12 @@ interface HeaderFooter {
     hdrFtrType: HeaderFooterType;
     /** Content (paragraphs, tables, etc.) */
     content: BlockContent[];
+    /**
+     * Watermark stored on this header (MS Word "Design → Watermark"). Lives
+     * here, not in `content`, so it stays out of the editable text flow while
+     * still round-tripping. Only headers carry watermarks; footers never do.
+     */
+    watermark?: Watermark;
 }
 /**
  * Footnote position
@@ -1042,12 +1112,23 @@ interface Footnote {
     noteType?: 'normal' | 'separator' | 'continuationSeparator' | 'continuationNotice';
     /**
      * Content. Per ECMA-376 §17.11.10 footnotes can hold the same blocks as
-     * the body — paragraphs and tables. The parser previously only collected
-     * <w:p> children which silently dropped any <w:tbl> inside a footnote;
-     * widened to match HeaderFooter / TableCell shape so the body pipeline
-     * (toProseDoc → toFlowBlocks) can render them uniformly.
+     * the body, so the note parser reuses the body's `parseBlockContent`: the
+     * full block model — paragraphs, tables, and block-level `w:sdt` content
+     * controls (as `BlockSdt`) — flows through the body pipeline
+     * (toProseDoc → toFlowBlocks) and stays editable on round-trip.
      */
     content: BlockContent[];
+    /**
+     * Verbatim original XML of the entire `<w:footnote>` element, captured at
+     * parse time ONLY when the note body carries a block-level construct the
+     * model still can't represent — note-level bookmarks
+     * (`w:bookmarkStart`/`w:bookmarkEnd`) or `w:customXml`. Block-level `w:sdt`
+     * is NOT a trigger: it round-trips through the model as `BlockSdt`. When
+     * present the serializer re-emits these bytes instead of rebuilding from
+     * `content`, restoring pre-#646 fidelity for the unmodeled constructs.
+     * See `parseNoteBlockContent` / `serializeNote` for the gate (#646 F3).
+     */
+    verbatimXml?: string;
 }
 /**
  * Endnote (w:endnote)
@@ -1060,9 +1141,12 @@ interface Endnote {
     noteType?: 'normal' | 'separator' | 'continuationSeparator' | 'continuationNotice';
     /**
      * Content. Per ECMA-376 §17.11.4 endnotes can hold the same blocks as
-     * the body — paragraphs and tables. See note on `Footnote.content`.
+     * the body — paragraphs, tables, and block-level content controls. See note
+     * on `Footnote.content`.
      */
     content: BlockContent[];
+    /** Verbatim original XML — see `Footnote.verbatimXml` (#646 F3). */
+    verbatimXml?: string;
 }
 
 /**
@@ -1763,6 +1847,29 @@ interface NoteReferenceContent {
     /** Note ID */
     id: number;
 }
+/**
+ * Footnote/endnote auto-number mark (`w:footnoteRef` / `w:endnoteRef`).
+ *
+ * Distinct from {@link NoteReferenceContent}: that is the *reference* placed in
+ * the document body (`w:footnoteReference`), whereas this is the numbering
+ * placeholder that lives *inside* the note body — the run carrying it is what
+ * Word renders as the note's leading superscript number. Preserving it keeps
+ * the note's own number visible on round-trip.
+ */
+interface NoteRefMarkContent {
+    type: 'footnoteRefMark' | 'endnoteRefMark';
+}
+/**
+ * Footnote/endnote separator mark (`w:separator` / `w:continuationSeparator`).
+ *
+ * These appear inside the special separator notes (`w:type="separator"` and
+ * `w:type="continuationSeparator"`) and draw the horizontal rule Word places
+ * between the body and its notes. They carry no content; Word rejects a notes
+ * part whose separator notes have lost these markers, so they must round-trip.
+ */
+interface SeparatorContent {
+    type: 'separator' | 'continuationSeparator';
+}
 /**
  * Field character (begin/separate/end)
  */
@@ -1814,7 +1921,7 @@ interface ShapeContent {
 /**
  * All possible run content types
  */
-type RunContent = TextContent | TabContent | BreakContent | SymbolContent | NoteReferenceContent | FieldCharContent | InstrTextContent | SoftHyphenContent | NoBreakHyphenContent | DrawingContent | ShapeContent;
+type RunContent = TextContent | TabContent | BreakContent | SymbolContent | NoteReferenceContent | NoteRefMarkContent | SeparatorContent | FieldCharContent | InstrTextContent | SoftHyphenContent | NoBreakHyphenContent | DrawingContent | ShapeContent;
 /**
  * A run (`w:r`) — a contiguous span of inline content sharing one set of
  * character properties (bold, italic, font, color, etc.). Runs are the
@@ -2121,10 +2228,20 @@ interface DocxPackage {
     settings?: DocumentSettings;
     /** Font table */
     fontTable?: FontTable;
-    /** Footnotes */
+    /** Footnotes (normal notes only — separators live in `footnoteSeparators`) */
     footnotes?: Footnote[];
-    /** Endnotes */
+    /** Endnotes (normal notes only — separators live in `endnoteSeparators`) */
     endnotes?: Endnote[];
+    /**
+     * Separator footnotes (`w:type="separator"` / `"continuationSeparator"` /
+     * `"continuationNotice"`) kept out of `footnotes` so rendering/layout only
+     * sees real notes. Retained for round-trip: Word rejects a footnotes part
+     * whose separator notes are missing, so the serializer re-emits these ahead
+     * of the normal notes.
+     */
+    footnoteSeparators?: Footnote[];
+    /** Separator endnotes — see `footnoteSeparators`. */
+    endnoteSeparators?: Endnote[];
     /** Headers by relationship ID */
     headers?: Map<string, HeaderFooter>;
     /** Footers by relationship ID */
@@ -2218,7 +2335,24 @@ interface ReviewChange {
     date: string | null;
     text: string;
     context: string;
+    /**
+     * Index of the containing paragraph. For body changes this is the
+     * document-wide paragraph index; for note changes it is the paragraph index
+     * *within that note* (note bodies have their own numbering), so pair it with
+     * `noteId` / `noteType` rather than reading it as a body index.
+     */
     paragraphIndex: number;
+    /**
+     * Set when the change lives inside a footnote or endnote. Such changes are
+     * surfaced for discovery only — accept/reject operate on the body, so an id
+     * that resolves *only* to a note change throws `NoteChangeNotEditableError`
+     * (an id also present on a body change resolves to the body change). The
+     * raw `id` is not namespaced across parts, so pair it with `noteId` /
+     * `noteType` to identify the change.
+     */
+    noteId?: number;
+    /** Which note store the change came from. Absent for body changes. */
+    noteType?: 'footnote' | 'endnote';
 }
 interface ReviewCommentReply {
     id: number;
@@ -2239,6 +2373,10 @@ interface ReviewComment {
 interface ChangeFilter {
     author?: string;
     type?: 'insertion' | 'deletion' | 'moveFrom' | 'moveTo';
+    /** Also report tracked changes inside footnote bodies. Default: false. */
+    includeFootnotes?: boolean;
+    /** Also report tracked changes inside endnote bodies. Default: false. */
+    includeEndnotes?: boolean;
 }
 interface CommentFilter {
     author?: string;
@@ -2457,7 +2595,21 @@ declare class DocxReviewer {
      * Avoids JSON quote-escaping issues — LLMs can copy text verbatim.
      */
     getContentAsText(options?: GetContentOptions): string;
-    /** Get all tracked changes in the document. */
+    /**
+     * Get all tracked changes in the document. Pass `includeFootnotes` /
+     * `includeEndnotes` in the filter to also report changes inside note bodies
+     * (each such change carries `noteId` / `noteType`).
+     *
+     * The reported `id` is the raw `w:id`, which is unique only within its part
+     * (document.xml / footnotes.xml / endnotes.xml) — it is NOT namespaced across
+     * parts, so the same `id` can appear on a body change and a note change. Use
+     * `noteType` / `noteId` to disambiguate.
+     *
+     * Note changes are surfaced for discovery only. `acceptChange` /
+     * `rejectChange` operate on the document body, so an id that resolves *only*
+     * to a note change throws {@link NoteChangeNotEditableError} rather than
+     * mutating it (an id shared with a body change resolves to the body change).
+     */
     getChanges(filter?: ChangeFilter): ReviewChange[];
     /** Get all comments with their replies. */
     getComments(filter?: CommentFilter): ReviewComment[];
@@ -2505,9 +2657,38 @@ declare class DocxReviewer {
     proposeInsertion(options: ProposeInsertionOptions): void;
     /** Delete text as a tracked change. */
     proposeDeletion(options: ProposeDeletionOptions): void;
-    /** Accept a tracked change by its revision ID. */
+    /**
+     * Guard the body-only accept/reject path against in-note changes.
+     *
+     * A tracked-change `w:id` is unique only within its part, so the same id can
+     * appear in the body and in a footnote/endnote. When the id resolves to a
+     * body change we let the body-only impl handle it (body wins; the note, if
+     * any, is left untouched). When the id resolves ONLY to a note change we fail
+     * closed with {@link NoteChangeNotEditableError} rather than mis-reporting it
+     * as not-found — accept/reject cannot yet mutate note bodies.
+     */
+    private assertNotNoteOnly;
+    /**
+     * Accept a tracked change by its revision ID. Operates on the document body
+     * only.
+     *
+     * The public `id` is a `w:id`, which is unique only within its part, so the
+     * same id may appear in the body and in a footnote/endnote. Resolution is
+     * body-first: if a body change carries this id it is accepted and any
+     * same-id note change is left untouched. If the id resolves *only* to a note
+     * change, this throws {@link NoteChangeNotEditableError} (note bodies are not
+     * yet mutable here). If it resolves to nothing, it throws
+     * {@link ChangeNotFoundError}.
+     */
     acceptChange(id: number): void;
-    /** Reject a tracked change by its revision ID. */
+    /**
+     * Reject a tracked change by its revision ID. Operates on the document body
+     * only.
+     *
+     * Same resolution rules as {@link acceptChange}: body-first, throws
+     * {@link NoteChangeNotEditableError} for a note-only id, and
+     * {@link ChangeNotFoundError} when the id matches nothing.
+     */
     rejectChange(id: number): void;
     /** Accept all tracked changes. Returns count accepted. */
     acceptAll(): number;

package/dist/server.d.mts

@@ -31,4 +31,4 @@
  * @packageDocumentation
  * @public
  */
-export { s as AgentContextSnapshot, j as AgentToolDefinition, k as AgentToolResult, D as DocxReviewer, E as EditorBridge, S as SelectionInfo, o as createReviewerBridge, n as docxAgentTools, p as executeToolCall, t as getToolDisplayName, q as getToolSchemas } from './server-uM9UUIhk.mjs';
+export { s as AgentContextSnapshot, j as AgentToolDefinition, k as AgentToolResult, D as DocxReviewer, E as EditorBridge, S as SelectionInfo, o as createReviewerBridge, n as docxAgentTools, p as executeToolCall, t as getToolDisplayName, q as getToolSchemas } from './server-BaVhdHCd.mjs';

package/dist/server.d.ts

@@ -31,4 +31,4 @@
  * @packageDocumentation
  * @public
  */
-export { s as AgentContextSnapshot, j as AgentToolDefinition, k as AgentToolResult, D as DocxReviewer, E as EditorBridge, S as SelectionInfo, o as createReviewerBridge, n as docxAgentTools, p as executeToolCall, t as getToolDisplayName, q as getToolSchemas } from './server-uM9UUIhk.js';
+export { s as AgentContextSnapshot, j as AgentToolDefinition, k as AgentToolResult, D as DocxReviewer, E as EditorBridge, S as SelectionInfo, o as createReviewerBridge, n as docxAgentTools, p as executeToolCall, t as getToolDisplayName, q as getToolSchemas } from './server-BaVhdHCd.js';

package/dist/server.js

@@ -1 +1 @@
-'use strict';var chunkUXHK7C33_js=require('./chunk-UXHK7C33.js'),chunkZDQ7OJ6K_js=require('./chunk-ZDQ7OJ6K.js'),chunkRI5S75JY_js=require('./chunk-RI5S75JY.js');Object.defineProperty(exports,"DocxReviewer",{enumerable:true,get:function(){return chunkUXHK7C33_js.a}});Object.defineProperty(exports,"createReviewerBridge",{enumerable:true,get:function(){return chunkZDQ7OJ6K_js.m}});Object.defineProperty(exports,"docxAgentTools",{enumerable:true,get:function(){return chunkRI5S75JY_js.a}});Object.defineProperty(exports,"executeToolCall",{enumerable:true,get:function(){return chunkRI5S75JY_js.b}});Object.defineProperty(exports,"getToolDisplayName",{enumerable:true,get:function(){return chunkRI5S75JY_js.c}});Object.defineProperty(exports,"getToolSchemas",{enumerable:true,get:function(){return chunkRI5S75JY_js.d}});
+'use strict';var chunkLX3NJWKV_js=require('./chunk-LX3NJWKV.js'),chunkXUAUDUJU_js=require('./chunk-XUAUDUJU.js'),chunkRI5S75JY_js=require('./chunk-RI5S75JY.js');Object.defineProperty(exports,"DocxReviewer",{enumerable:true,get:function(){return chunkLX3NJWKV_js.a}});Object.defineProperty(exports,"createReviewerBridge",{enumerable:true,get:function(){return chunkXUAUDUJU_js.n}});Object.defineProperty(exports,"docxAgentTools",{enumerable:true,get:function(){return chunkRI5S75JY_js.a}});Object.defineProperty(exports,"executeToolCall",{enumerable:true,get:function(){return chunkRI5S75JY_js.b}});Object.defineProperty(exports,"getToolDisplayName",{enumerable:true,get:function(){return chunkRI5S75JY_js.c}});Object.defineProperty(exports,"getToolSchemas",{enumerable:true,get:function(){return chunkRI5S75JY_js.d}});

package/dist/server.mjs

@@ -1 +1 @@
-export{a as DocxReviewer}from'./chunk-QU2WUEX3.mjs';export{m as createReviewerBridge}from'./chunk-OCMVGKIA.mjs';export{a as docxAgentTools,b as executeToolCall,c as getToolDisplayName,d as getToolSchemas}from'./chunk-24MVJKCP.mjs';
+export{a as DocxReviewer}from'./chunk-NFAEIOLC.mjs';export{n as createReviewerBridge}from'./chunk-P4DRISTP.mjs';export{a as docxAgentTools,b as executeToolCall,c as getToolDisplayName,d as getToolSchemas}from'./chunk-24MVJKCP.mjs';