@docx-editor.dev/editor-api 2.23.0 → 2.25.0

package/dist/{server-mLIW1Y6U.d.mts → server-Csjpe214.d.mts}

@@ -1,73 +1,6 @@
 import { AutomationHandle, AutomationSpan, AutomationOperation, AutomationValue, AutomationSpanRef, RevisionBatchResult, AutomationHost, AutomationCapabilities, AutomationPaginationOptions } from '@docx-editor.dev/core/automation';
 import { CollaborationModuleContribution } from '@docx-editor.dev/core/collaboration';
 
-/** Locations used by Office-shaped insertion calls. Each call validates its allowed subset. @public */
-declare enum InsertLocation {
-    replace = "Replace",
-    start = "Start",
-    end = "End",
-    before = "Before",
-    after = "After"
-}
-/** Paragraph alignment vocabulary. Mixed and unknown are read states, not authoring modes. @public */
-declare enum Alignment {
-    mixed = "Mixed",
-    unknown = "Unknown",
-    left = "Left",
-    centered = "Centered",
-    right = "Right",
-    justified = "Justified"
-}
-/** Physical page orientation. @public */
-declare enum PageOrientation {
-    portrait = "Portrait",
-    landscape = "Landscape"
-}
-/** Tracking policy vocabulary. Unsupported policies fail explicitly at sync. @public */
-declare enum ChangeTrackingMode {
-    off = "Off",
-    trackAll = "TrackAll",
-    trackMineOnly = "TrackMineOnly"
-}
-/** Vertical placement of content within a table cell. Mixed cannot be authored. @public */
-declare enum VerticalAlignment {
-    mixed = "Mixed",
-    top = "Top",
-    center = "Center",
-    bottom = "Bottom"
-}
-/** Office break vocabulary; enum presence does not imply support for every break kind. @public */
-declare enum BreakType {
-    line = "Line",
-    page = "Page",
-    next = "Next",
-    sectionNext = "SectionNext",
-    sectionContinuous = "SectionContinuous",
-    sectionEven = "SectionEven",
-    sectionOdd = "SectionOdd"
-}
-/** Content-control kinds, including the read subtypes that insertion does not accept. @public */
-declare enum ContentControlType {
-    unknown = "Unknown",
-    richText = "RichText",
-    plainText = "PlainText",
-    picture = "Picture",
-    buildingBlockGallery = "BuildingBlockGallery",
-    checkBox = "CheckBox",
-    comboBox = "ComboBox",
-    datePicker = "DatePicker",
-    dropDownList = "DropDownList",
-    group = "Group",
-    repeatingSection = "RepeatingSection",
-    plainTextInline = "PlainTextInline",
-    plainTextParagraph = "PlainTextParagraph",
-    richTextInline = "RichTextInline",
-    richTextParagraphs = "RichTextParagraphs",
-    richTextTable = "RichTextTable",
-    richTextTableCell = "RichTextTableCell",
-    richTextTableRow = "RichTextTableRow"
-}
-
 /**
  * What the host is told to look at.
  *
@@ -196,6 +129,67 @@ declare class ActionQueue {
     clear(): void;
 }
 
+declare abstract class ModelObject extends ClientObject {
+    /** Runtime-wide revision view behind standard Office-compatible text reads and searches. */
+    protected revisionTextView(): 'allMarkup' | 'original';
+    /** Queue a read whose text answer becomes the loaded property `name`. */
+    protected loadTextInto(name: string, plan: () => AutomationOperation): void;
+    /** Queue a command with nothing to answer. Nothing is written until `sync()`. */
+    protected command(name: string, plan: () => AutomationOperation, dispose?: () => void): void;
+    /**
+     * Queue a command whose answer this call has no use for.
+     *
+     * `clear()` is the case: the operation behind it is a replacement, and a replacement answers the
+     * range it wrote — a range over no text, here. The answer is dropped rather than checked for a
+     * shape the method does not return, so that the operation stays the same one an insertion uses.
+     */
+    protected commandDiscarding(name: string, plan: () => AutomationOperation): void;
+    /** Queue a command whose answer names something the caller keeps. */
+    protected commandAnswering(label: string, plan: () => AutomationOperation, settle: (value: AutomationValue) => void, dispose?: () => void): void;
+    /** Queue a read whose answer is hydrated by the caller. */
+    protected read(label: string, plan: () => AutomationOperation, settle: (value: AutomationValue) => void): void;
+    /** The properties a load asked for, refusing any name this object does not have. */
+    protected selection(request: ResolvedLoadOptions, available: readonly string[]): readonly string[];
+    /** @internal Plan the read this object's `load(...)` asked for. */
+    protected onLoad(request: ResolvedLoadOptions): void;
+}
+
+/**
+ * Core document properties. Load explicit names before reads; assignments commit at sync.
+ * Values are XML-safe strings of at most 4096 characters. Tracked writes are unsupported.
+ * Individual dates and custom properties are unsupported. Document.removeDocumentInformation can remove property parts.
+ * Collaborative writes require an existing core-properties part.
+ * Create properties before joining collaboration when the input omits that part.
+ * @public
+ */
+declare class DocumentProperties extends ModelObject {
+    #private;
+    /** @internal */
+    static of(context: RequestContext, owner: ObjectPath): DocumentProperties;
+    private constructor();
+    /** Last saved author, from cp:lastModifiedBy. Load before reading. */
+    get lastAuthor(): string;
+    /** Document author metadata, separate from the revision author. Load before reading; assign before sync. */
+    get author(): string;
+    set author(value: string);
+    /** Document title metadata. Load before reading; assign before sync. */
+    get title(): string;
+    set title(value: string);
+    /** Document subject metadata. Load before reading; assign before sync. */
+    get subject(): string;
+    set subject(value: string);
+    /** Document search keywords. Load before reading; assign before sync. */
+    get keywords(): string;
+    set keywords(value: string);
+    /** Document description metadata, separate from review comments. Load before reading; assign before sync. */
+    get comments(): string;
+    set comments(value: string);
+    /** Document category metadata. Load before reading; assign before sync. */
+    get category(): string;
+    set category(value: string);
+    protected onLoad(request: ResolvedLoadOptions): void;
+}
+
 /** What a promised member is told once the read that looked for it has answered. */
 interface PromisedItem {
     /** @internal The member was there, at this address. */
@@ -251,29 +245,94 @@ declare abstract class HandleCollection<T extends ClientObject & PromisedItem> e
     protected addressAt(value: AutomationValue, label: string, index: number): ObjectAddress | undefined;
 }
 
-declare abstract class ModelObject extends ClientObject {
-    /** Runtime-wide revision view behind standard Office-compatible text reads and searches. */
-    protected revisionTextView(): 'allMarkup' | 'original';
-    /** Queue a read whose text answer becomes the loaded property `name`. */
-    protected loadTextInto(name: string, plan: () => AutomationOperation): void;
-    /** Queue a command with nothing to answer. Nothing is written until `sync()`. */
-    protected command(name: string, plan: () => AutomationOperation, dispose?: () => void): void;
-    /**
-     * Queue a command whose answer this call has no use for.
-     *
-     * `clear()` is the case: the operation behind it is a replacement, and a replacement answers the
-     * range it wrote — a range over no text, here. The answer is dropped rather than checked for a
-     * shape the method does not return, so that the operation stays the same one an insertion uses.
-     */
-    protected commandDiscarding(name: string, plan: () => AutomationOperation): void;
-    /** Queue a command whose answer names something the caller keeps. */
-    protected commandAnswering(label: string, plan: () => AutomationOperation, settle: (value: AutomationValue) => void, dispose?: () => void): void;
-    /** Queue a read whose answer is hydrated by the caller. */
-    protected read(label: string, plan: () => AutomationOperation, settle: (value: AutomationValue) => void): void;
-    /** The properties a load asked for, refusing any name this object does not have. */
-    protected selection(request: ResolvedLoadOptions, available: readonly string[]): readonly string[];
-    /** @internal Plan the read this object's `load(...)` asked for. */
-    protected onLoad(request: ResolvedLoadOptions): void;
+/** Locations used by Office-shaped insertion calls. Each call validates its allowed subset. @public */
+declare enum InsertLocation {
+    replace = "Replace",
+    start = "Start",
+    end = "End",
+    before = "Before",
+    after = "After"
+}
+/** Paragraph alignment vocabulary. Mixed and unknown are read states, not authoring modes. @public */
+declare enum Alignment {
+    mixed = "Mixed",
+    unknown = "Unknown",
+    left = "Left",
+    centered = "Centered",
+    right = "Right",
+    justified = "Justified"
+}
+/** Physical page orientation. @public */
+declare enum PageOrientation {
+    portrait = "Portrait",
+    landscape = "Landscape"
+}
+/** Tracking policy vocabulary. Unsupported policies fail explicitly at sync. @public */
+declare enum ChangeTrackingMode {
+    off = "Off",
+    trackAll = "TrackAll",
+    trackMineOnly = "TrackMineOnly"
+}
+/** Vertical placement of content within a table cell. Mixed cannot be authored. @public */
+declare enum VerticalAlignment {
+    mixed = "Mixed",
+    top = "Top",
+    center = "Center",
+    bottom = "Bottom"
+}
+/** Office break vocabulary; enum presence does not imply support for every break kind. @public */
+declare enum BreakType {
+    line = "Line",
+    page = "Page",
+    next = "Next",
+    sectionNext = "SectionNext",
+    sectionContinuous = "SectionContinuous",
+    sectionEven = "SectionEven",
+    sectionOdd = "SectionOdd"
+}
+/** Content-control kinds, including the read subtypes that insertion does not accept. @public */
+declare enum ContentControlType {
+    unknown = "Unknown",
+    richText = "RichText",
+    plainText = "PlainText",
+    picture = "Picture",
+    buildingBlockGallery = "BuildingBlockGallery",
+    checkBox = "CheckBox",
+    comboBox = "ComboBox",
+    datePicker = "DatePicker",
+    dropDownList = "DropDownList",
+    group = "Group",
+    repeatingSection = "RepeatingSection",
+    plainTextInline = "PlainTextInline",
+    plainTextParagraph = "PlainTextParagraph",
+    richTextInline = "RichTextInline",
+    richTextParagraphs = "RichTextParagraphs",
+    richTextTable = "RichTextTable",
+    richTextTableCell = "RichTextTableCell",
+    richTextTableRow = "RichTextTableRow"
+}
+/** Document information categories. Only DocumentProperties removal is supported. @public */
+declare enum RemoveDocInfoType {
+    all = "All",
+    atMentions = "AtMentions",
+    commentReactions = "CommentReactions",
+    comments = "Comments",
+    contentType = "ContentType",
+    documentIntelligence = "DocumentIntelligence",
+    documentManagementPolicy = "DocumentManagementPolicy",
+    documentProperties = "DocumentProperties",
+    documentServerProperties = "DocumentServerProperties",
+    documentTasks = "DocumentTasks",
+    documentWorkspace = "DocumentWorkspace",
+    emailHeader = "EmailHeader",
+    inkAnnotations = "InkAnnotations",
+    removePersonalInformation = "RemovePersonalInformation",
+    revisions = "Revisions",
+    routingSlip = "RoutingSlip",
+    sendForReview = "SendForReview",
+    taskpaneWebExtensions = "TaskpaneWebExtensions",
+    template = "Template",
+    versions = "Versions"
 }
 
 /** Supported Word bullet styles. @public */
@@ -492,6 +551,43 @@ declare class Font extends ModelObject {
     protected onLoad(request: ResolvedLoadOptions): void;
 }
 
+/** An inert Word field. Code writes and evaluation support PAGE and NUMPAGES. @public */
+declare class Field extends ModelObject implements PromisedItem {
+    #private;
+    /** @internal */
+    static at(context: RequestContext, label: string, address: ObjectAddress): Field;
+    /** @internal */
+    static promised(context: RequestContext, label: string, nullable: boolean): Field;
+    private constructor();
+    /** @internal */
+    hydrateAddress(address: ObjectAddress): void;
+    /** @internal */
+    hydrateNull(): void;
+    get code(): string;
+    set code(value: string);
+    /** Remove this field, including its cached result. Other fields remain inert and unchanged. */
+    delete(): void;
+    /** Compute a cached result using actual host pagination. Missing pagination refuses explicitly. */
+    updateResult(): void;
+    protected onLoad(request: ResolvedLoadOptions): void;
+}
+/** Fields contained within a body or range. @public */
+declare class FieldCollection extends ItemCollection<Field> {
+    #private;
+    /** @internal */
+    static of(context: RequestContext, label: string, owner: ObjectPath, kind: SpanOwner): FieldCollection;
+    private constructor();
+    getFirst(): Field;
+    getLast(): Field;
+    getFirstOrNullObject(): Field;
+    getLastOrNullObject(): Field;
+    protected listing(): AutomationOperation;
+    protected size(value: AutomationValue, label: string): number;
+    protected addressAt(value: AutomationValue, label: string, index: number): ObjectAddress | undefined;
+    protected itemAt(label: string, address: ObjectAddress): Field;
+    protected promised(label: string, nullable: boolean): Field & PromisedItem;
+}
+
 /** Office field types. This runtime authors Page, NumPages, and Empty with a supported code. @public */
 declare enum FieldType {
     addin = "Addin",
@@ -641,7 +737,10 @@ declare class Table extends ModelObject implements PromisedItem {
     hydrateAddress(address: ObjectAddress): void;
     /** @internal */
     hydrateNull(): void;
-    /** Cell text by row. A write replaces the whole rectangular matrix; rich cell content refuses. */
+    /**
+     * Cell text by row. Writes require the current dimensions and ordinary cell text.
+     * TrackMineOnly records text revisions outside collaboration; collaborative tracked writes refuse.
+     */
     get values(): string[][];
     set values(value: string[][]);
     /** Table style display name. Writes must name an existing table style in the document. */
@@ -658,11 +757,18 @@ declare class Table extends ModelObject implements PromisedItem {
     get rows(): TableRowCollection;
     /** Address a cell by zero-based row and column. Read-derived operations may share its next sync. */
     getCell(rowIndex: number, cellIndex: number): TableCell;
-    /** Add rows at an edge. Sync before configuring the returned rows; omitted values create empty cells. */
+    /**
+     * Add rows at an edge. Sync before configuring the returned rows; omitted values create empty cells.
+     * Ordinary edge rows can belong to a table with unrelated merged headers.
+     * TrackMineOnly records native row insertion revisions, including supplied initial values.
+     */
     addRows(insertLocation: InsertLocation.start | InsertLocation.end | 'Start' | 'End', rowCount: number, values?: string[][]): TableRowCollection;
     /** Add columns at an edge. Values are row-major; new columns initially copy the nearest edge width. */
     addColumns(insertLocation: InsertLocation.start | InsertLocation.end | 'Start' | 'End', columnCount: number, values?: string[][]): void;
-    /** Delete consecutive rows from a zero-based index. Defaults to one row. */
+    /**
+     * Delete consecutive rows from a zero-based index. Defaults to one row.
+     * Tracking requires one row without a pending deletion to remain and refuses pending row or cell structure revisions.
+     */
     deleteRows(rowIndex: number, rowCount?: number): void;
     /** Delete consecutive columns from a zero-based index. Defaults to one column. */
     deleteColumns(columnIndex: number, columnCount?: number): void;
@@ -682,6 +788,12 @@ declare class TableRow extends ModelObject implements PromisedItem {
     hydrateAddress(address: ObjectAddress): void;
     /** @internal */
     hydrateNull(): void;
+    /**
+     * Insert ordinary rows before or after this row. Sync before using the returned rows.
+     * Unrelated merged headers remain unchanged. Merged source rows and crossing merges refuse.
+     * TrackMineOnly records native row insertion revisions, including initial values.
+     */
+    insertRows(insertLocation: InsertLocation.before | InsertLocation.after | 'Before' | 'After', rowCount: number, values?: string[][]): TableRowCollection;
     /** Stable cell collection for this row. Load `items` and sync before reading. */
     get cells(): TableCellCollection;
 }
@@ -699,7 +811,10 @@ declare class TableCell extends ModelObject implements PromisedItem {
     hydrateNull(): void;
     /** A body scoped to this cell for text, ranges, formatting, and nested table navigation. */
     get body(): Body;
-    /** Plain cell text. Replacing complex content refuses; use the scoped body for targeted edits. */
+    /**
+     * Plain cell text. Replacing complex content refuses; use the scoped body for targeted edits.
+     * TrackMineOnly records text revisions outside collaboration; collaborative tracked writes refuse.
+     */
     get value(): string;
     set value(value: string);
     /** Width in points. A write affects the whole grid column, not only this cell. */
@@ -965,6 +1080,7 @@ declare class ContentControl extends ModelObject implements PromisedItem {
     setValue(value: ContentControlValue): void;
     /**
      * Put text into the control: over what it holds, or at one end of it.
+     * Supports text-like controls. Date, checkbox, and other typed controls refuse with NotSupported.
      *
      * `Replace` goes through the control's own value path, so the prompt it was showing and a
      * `w:temporary` wrapper are dealt with there rather than a second time here. The range comes
@@ -1388,8 +1504,9 @@ declare class Range extends ModelObject implements PromisedItem {
      * Await `context.sync()` before loading or addressing that returned range.
      *
      * With server `document.changeTrackingMode = 'TrackMineOnly'`, this creates a tracked text
-     * edit attributed to the runtime author. Tracked edits must stay within one paragraph and
-     * cannot touch pending revisions. Structural and formatting tracking are not supported.
+     * edit attributed to the runtime author. Tracked range replacement supports adjacent sibling paragraphs outside collaboration.
+     * Table and wrapper boundaries and foreign pending revisions refuse. Font and paragraph
+     * formatting support property revisions.
      * Empty text with `Replace` deletes the range; empty text at an insertion point is a no-op.
      * Agent tools that intend a replacement should validate non-empty model output first.
      *
@@ -1399,7 +1516,7 @@ declare class Range extends ModelObject implements PromisedItem {
      * gets back is a range naming the text that was written, in every case.
      */
     insertText(text: string, insertLocation: InsertLocation | 'Replace' | 'Start' | 'End' | 'Before' | 'After'): Range;
-    /** Delete this range's content. TrackMineOnly preserves inline text as a pending deletion. */
+    /** Delete range content. Tracking supports adjacent sibling paragraphs outside collaboration. */
     delete(): void;
     /** Clear this range's content, preserving the surrounding structure. */
     clear(): void;
@@ -1412,15 +1529,25 @@ declare class Range extends ModelObject implements PromisedItem {
      */
     insertComment(commentText: string): Comment;
     /**
-     * Wrap this single-paragraph range in a rich-text or plain-text content control.
+     * Wrap this single-paragraph range in a rich-text, plain-text, or date-picker content control.
      * Await sync before configuring the returned control. Other types explicitly refuse.
+     * TrackMineOnly supports nonempty ordinary text outside collaboration.
+     * Existing revisions and empty tracked ranges refuse with NotSupported.
      */
     insertContentControl(contentControlType?: ContentControlType.richText | ContentControlType.plainText | ContentControlType.buildingBlockGallery | ContentControlType.checkBox | ContentControlType.comboBox | ContentControlType.datePicker | ContentControlType.dropDownList | ContentControlType.group | ContentControlType.picture | ContentControlType.repeatingSection | 'RichText' | 'PlainText' | 'BuildingBlockGallery' | 'CheckBox' | 'ComboBox' | 'DatePicker' | 'DropDownList' | 'Group' | 'Picture' | 'RepeatingSection'): ContentControl;
     /** Tables contained by this range, in document order. */
     get tables(): TableCollection;
     /** Fields fully contained within this range. */
     get fields(): FieldCollection;
+    /**
+     * Insert PAGE, NUMPAGES, or an inert TOC field with supported switches.
+     * TOC entries are not calculated. Tracked field insertion refuses.
+     */
     insertField(insertLocation: InsertLocation | 'Before' | 'After' | 'Start' | 'End' | 'Replace', fieldType?: FieldType, text?: string, removeFormatting?: boolean): Field;
+    /**
+     * Insert PAGE, NUMPAGES, or an inert TOC field with supported switches.
+     * TOC entries are not calculated. Tracked field insertion refuses.
+     */
     insertField(insertLocation: InsertLocation | 'Before' | 'After' | 'Start' | 'End' | 'Replace', fieldType?: FieldTypeLiteral, text?: string, removeFormatting?: boolean): Field;
     /** Inline pictures fully contained within this snapshot range. */
     get inlinePictures(): InlinePictureCollection;
@@ -1428,7 +1555,11 @@ declare class Range extends ModelObject implements PromisedItem {
     insertInlinePictureFromBase64(base64EncodedImage: string, insertLocation: InsertLocation | 'Before' | 'After' | 'Start' | 'End' | 'Replace'): InlinePicture;
     /** Page and next-page section breaks are supported; other break types refuse at sync. */
     insertBreak(breakType: BreakType | 'Page' | 'SectionNext' | 'Next' | 'Line' | 'SectionContinuous' | 'SectionEven' | 'SectionOdd', insertLocation: InsertLocation.before | InsertLocation.after | 'Before' | 'After'): void;
-    /** Insert a rectangular table before or after this range. */
+    /**
+     * Insert a rectangular table before or after this range.
+     * TrackMineOnly records native row/cell insertions, including initial values.
+     * Sync before configuring the returned table. Nested table authoring refuses.
+     */
     insertTable(rowCount: number, columnCount: number, insertLocation: InsertLocation.before | InsertLocation.after | 'Before' | 'After', values?: string[][]): Table;
     /** Add a paragraph before or after the one this range starts or ends in. */
     insertParagraph(paragraphText: string, insertLocation: InsertLocation.before | InsertLocation.after | 'Before' | 'After'): Paragraph;
@@ -1649,80 +1780,6 @@ declare class RangeCollection extends ItemCollection<Range> {
     protected promised(label: string, nullable: boolean): Range & PromisedItem;
 }
 
-/** Which kind of note: Word's own two. */
-type NoteItemType = 'Footnote' | 'Endnote';
-/**
- * One footnote or endnote: text that belongs to the document but not to its flow.
- *
- * A note IS a story. Its {@link NoteItem.body} is an ordinary {@link Body} — paragraphs,
- * formatting, styles, the same operations — laid out at the foot of a page or the end of the
- * document rather than in the column, so everything the object model can do to the main story it
- * can do to a note without a second vocabulary.
- *
- * `delete()` removes the reference too. A note's body and the citation that reached it are one
- * thing to a reader, and deleting the body alone would leave a mark pointing at nothing. The
- * engine spells that as a package-level transaction, which is why it travels alone in its batch.
- *
- * @public
- */
-declare class NoteItem extends ModelObject implements PromisedItem {
-    #private;
-    /** @internal A note a read has already named. */
-    static at(context: RequestContext, label: string, address: ObjectAddress): NoteItem;
-    /** @internal A note a queued read will name, or report as nothing. */
-    static promised(context: RequestContext, label: string, nullable: boolean): NoteItem;
-    private constructor();
-    /** @internal Bind this object to the address the owning read answered. */
-    hydrateAddress(address: ObjectAddress): void;
-    /** @internal Settle as the null object: the read found nothing to name. */
-    hydrateNull(): void;
-    /** Whether this is a footnote or an endnote. */
-    get type(): NoteItemType;
-    /**
-     * The note's plain text.
-     *
-     * This is the same value as loading `text` from {@link NoteItem.body}: every paragraph in the
-     * note story, in reading order, joined by one carriage return per paragraph mark. Load it
-     * directly when structured traversal or editing through {@link NoteItem.body} is not needed.
-     */
-    get text(): string;
-    /** The note's own story. */
-    get body(): Body;
-    /**
-     * Remove the note and every reference to it.
-     *
-     * A package transaction, so it is the ONLY operation its `sync()` may carry — the host refuses it
-     * any company rather than committing half a batch. Two syncs get a delete and anything else.
-     */
-    delete(): void;
-    /** The next note of the same kind. `ItemNotFound` at the sync when this is the last one. */
-    getNext(): NoteItem;
-    /** @internal Plan the read this object's `load(...)` asked for. */
-    protected onLoad(request: ResolvedLoadOptions): void;
-}
-/**
- * The notes of one kind, in the order the notes part writes them.
- *
- * DocxEditor's own collection type: the pinned reference fixture does not carry
- * `Word.NoteItemCollection`, so it is not measured for conformance — recorded as an omission in
- * `compat/manifest.json` — while `NoteItem` itself is. Without it a note would be unreachable, which
- * is the one thing worse than an unmeasured collection.
- */
-declare class NoteItemCollection extends HandleCollection<NoteItem> {
-    #private;
-    /** @internal A collection a named read will answer. */
-    static of(context: RequestContext, label: string, owner: ObjectPath, plan: () => AutomationOperation): NoteItemCollection;
-    private constructor();
-    /** The first note. `ItemNotFound` at the sync if the document has none of this kind. */
-    getFirst(): NoteItem;
-    /** @internal The read that answers this collection's members. */
-    protected listing(): AutomationOperation;
-    /** @internal Build one member from an address the listing answered. */
-    protected itemAt(label: string, address: ObjectAddress): NoteItem;
-    /** @internal A member an edge accessor named before the sync that finds it. */
-    protected promised(label: string, nullable: boolean): NoteItem & PromisedItem;
-}
-
 /** Which header or footer of a section: Word's own three variants. */
 type HeaderFooterType = 'Primary' | 'FirstPage' | 'EvenPages';
 /**
@@ -1883,6 +1940,15 @@ declare class Document extends ModelObject {
      * back a fresh proxy per access would put the load on one and the read on another.
      */
     get body(): Body;
+    /**
+     * Remove standard core, extended, and custom document-property parts in one sync.
+     * Only DocumentProperties is supported. Tracking and collaboration refuse with NotSupported.
+     * This command must be the only write in its sync. It does not anonymize document content.
+     */
+    removeDocumentInformation(removeDocInfoType: RemoveDocInfoType): void;
+    removeDocumentInformation(removeDocInfoType: 'Comments' | 'Revisions' | 'Versions' | 'RemovePersonalInformation' | 'EmailHeader' | 'RoutingSlip' | 'SendForReview' | 'DocumentProperties' | 'Template' | 'DocumentWorkspace' | 'InkAnnotations' | 'DocumentServerProperties' | 'DocumentManagementPolicy' | 'ContentType' | 'TaskpaneWebExtensions' | 'AtMentions' | 'DocumentTasks' | 'DocumentIntelligence' | 'CommentReactions' | 'All'): void;
+    /** Core document metadata. Reads require load; writes commit at sync. */
+    get properties(): DocumentProperties;
     /** The main story's paragraphs, in reading order. */
     get paragraphs(): ParagraphCollection;
     /** The document's sections, in document order. */
@@ -1903,9 +1969,7 @@ declare class Document extends ModelObject {
     /**
      * The document's footnotes, in the order its notes part writes them.
      *
-     * DocxEditor's own accessor: upstream reaches notes through `Body#footnotes`, whose collection type
-     * the pinned reference fixture does not carry — see `compat/manifest.json`. Without an accessor a
-     * note would be unreachable, so it is published here and recorded as unmeasured.
+     * Legacy document-wide accessor. Prefer the Office.js-shaped `body.footnotes` accessor.
      */
     get footnotes(): NoteItemCollection;
     /** The document's endnotes, in the order its notes part writes them. */
@@ -2378,41 +2442,78 @@ declare class DocxEditorError extends Error {
  */
 declare function isDocxEditorError(value: unknown): value is DocxEditorError;
 
-/** An inert Word field. Code writes and evaluation support PAGE and NUMPAGES. @public */
-declare class Field extends ModelObject implements PromisedItem {
+/** Which kind of note: Word's own two. */
+type NoteItemType = 'Footnote' | 'Endnote';
+/**
+ * One footnote or endnote: text that belongs to the document but not to its flow.
+ *
+ * A note IS a story. Its {@link NoteItem.body} is an ordinary {@link Body} — paragraphs,
+ * formatting, styles, the same operations — laid out at the foot of a page or the end of the
+ * document rather than in the column, so everything the object model can do to the main story it
+ * can do to a note without a second vocabulary.
+ *
+ * `delete()` removes the reference too. A note's body and the citation that reached it are one
+ * thing to a reader, and deleting the body alone would leave a mark pointing at nothing. The
+ * engine spells that as a package-level transaction, which is why it travels alone in its batch.
+ *
+ * @public
+ */
+declare class NoteItem extends ModelObject implements PromisedItem {
     #private;
-    /** @internal */
-    static at(context: RequestContext, label: string, address: ObjectAddress): Field;
-    /** @internal */
-    static promised(context: RequestContext, label: string, nullable: boolean): Field;
+    /** @internal A note a read has already named. */
+    static at(context: RequestContext, label: string, address: ObjectAddress): NoteItem;
+    /** @internal A note a queued read will name, or report as nothing. */
+    static promised(context: RequestContext, label: string, nullable: boolean): NoteItem;
     private constructor();
-    /** @internal */
+    /** @internal Bind this object to the address the owning read answered. */
     hydrateAddress(address: ObjectAddress): void;
-    /** @internal */
+    /** @internal Settle as the null object: the read found nothing to name. */
     hydrateNull(): void;
-    get code(): string;
-    set code(value: string);
-    /** Remove this field, including its cached result. Other fields remain inert and unchanged. */
+    /** Whether this is a footnote or an endnote. */
+    get type(): NoteItemType;
+    /**
+     * The note's plain text.
+     *
+     * This is the same value as loading `text` from {@link NoteItem.body}: every paragraph in the
+     * note story, in reading order, joined by one carriage return per paragraph mark. Load it
+     * directly when structured traversal or editing through {@link NoteItem.body} is not needed.
+     */
+    get text(): string;
+    /** The note's own story. */
+    get body(): Body;
+    /**
+     * Remove the note and every reference to it.
+     *
+     * A package transaction, so it is the ONLY operation its `sync()` may carry — the host refuses it
+     * any company rather than committing half a batch. Two syncs get a delete and anything else.
+     */
     delete(): void;
-    /** Compute a cached result using actual host pagination. Missing pagination refuses explicitly. */
-    updateResult(): void;
+    /** The next note of the same kind. `ItemNotFound` at the sync when this is the last one. */
+    getNext(): NoteItem;
+    /** @internal Plan the read this object's `load(...)` asked for. */
     protected onLoad(request: ResolvedLoadOptions): void;
 }
-/** Fields contained within a body or range. @public */
-declare class FieldCollection extends ItemCollection<Field> {
+/**
+ * The notes of one kind, in the order the notes part writes them.
+ *
+ * DocxEditor's own collection type: the pinned reference fixture does not carry
+ * `Word.NoteItemCollection`, so it is not measured for conformance — recorded as an omission in
+ * `compat/manifest.json` — while `NoteItem` itself is. Without it a note would be unreachable, which
+ * is the one thing worse than an unmeasured collection.
+ */
+declare class NoteItemCollection extends HandleCollection<NoteItem> {
     #private;
-    /** @internal */
-    static of(context: RequestContext, label: string, owner: ObjectPath, kind: SpanOwner): FieldCollection;
+    /** @internal A collection a named read will answer. */
+    static of(context: RequestContext, label: string, owner: ObjectPath, plan: () => AutomationOperation): NoteItemCollection;
     private constructor();
-    getFirst(): Field;
-    getLast(): Field;
-    getFirstOrNullObject(): Field;
-    getLastOrNullObject(): Field;
+    /** The first note. `ItemNotFound` at the sync if the document has none of this kind. */
+    getFirst(): NoteItem;
+    /** @internal The read that answers this collection's members. */
     protected listing(): AutomationOperation;
-    protected size(value: AutomationValue, label: string): number;
-    protected addressAt(value: AutomationValue, label: string, index: number): ObjectAddress | undefined;
-    protected itemAt(label: string, address: ObjectAddress): Field;
-    protected promised(label: string, nullable: boolean): Field & PromisedItem;
+    /** @internal Build one member from an address the listing answered. */
+    protected itemAt(label: string, address: ObjectAddress): NoteItem;
+    /** @internal A member an edge accessor named before the sync that finds it. */
+    protected promised(label: string, nullable: boolean): NoteItem & PromisedItem;
 }
 
 /**
@@ -2433,6 +2534,10 @@ declare class FieldCollection extends ItemCollection<Field> {
  */
 declare class Body extends ModelObject {
     #private;
+    /** Footnotes referenced within this body, in reference order. */
+    get footnotes(): NoteItemCollection;
+    /** Endnotes referenced within this body, in reference order. */
+    get endnotes(): NoteItemCollection;
     /** @internal The main story of the document this context is running against. */
     static main(context: RequestContext, label: string): Body;
     /**
@@ -2614,4 +2719,5 @@ interface CreateServerOptions {
 /** Options for {@link createCollaborative}. @public */
 type CreateCollaborativeOptions = CreateServerOptions;
 
-export { PageOrientation as $, Alignment as A, type BesideLocation as B, type CreateServerOptions as C, type DocxEditorServerRuntime as D, type DocxEditorErrorCode as E, type DocxEditorErrorInit as F, type DocxEditorRuntime as G, type EditorModule as H, Field as I, FieldCollection as J, FieldType as K, type FieldTypeLiteral as L, Font as M, type HeaderFooterType as N, InlinePicture as O, InlinePictureCollection as P, InsertLocation as Q, List as R, ListBullet as S, ListCollection as T, ListItem as U, ListNumbering as V, type LoadOption as W, type LoadQueryOptions as X, NoteItem as Y, NoteItemCollection as Z, type NoteItemType as _, type CreateCollaborativeOptions as a, PageSetup as a0, Paragraph as a1, type ParagraphAlignment as a2, ParagraphCollection as a3, type ParagraphInsertTextLocation as a4, Range as a5, RangeCollection as a6, type RangeInsertTextLocation as a7, RequestContext as a8, Revision as a9, RevisionCollection as aa, type RevisionTextView as ab, type RevisionType as ac, type RunCallback as ad, type SearchOptions as ae, Section as af, SectionCollection as ag, type SelectionMode as ah, type ServerPaginationOptions as ai, Table as aj, TableCell as ak, TableCellCollection as al, TableCollection as am, TableRow as an, TableRowCollection as ao, TrackedObjects as ap, UnderlineType as aq, VerticalAlignment as ar, isDocxEditorError as as, Body as b, type BodyInsertParagraphLocation as c, type BodyInsertTextLocation as d, Bookmark as e, BookmarkCollection as f, BreakType as g, ChangeTrackingMode as h, ClientObject as i, ClientResult as j, Comment as k, CommentCollection as l, CommentReply as m, CommentReplyCollection as n, ContentControl as o, ContentControlCollection as p, type ContentControlLockState as q, type ContentControlSubtype as r, ContentControlType as s, type ContentControlValue as t, Document as u, type DocumentCapabilities as v, type DocumentLimits as w, type DocumentXmlLimits as x, type DocumentZipLimits as y, DocxEditorError as z };
+export { Alignment as A, DocxEditorError as E, Field as J, FieldCollection as K, FieldType as L, Font as N, InlinePicture as P, InlinePictureCollection as Q, InsertLocation as R, List as S, ListBullet as T, ListCollection as U, ListItem as V, ListNumbering as W, NoteItem as Z, NoteItemCollection as _, PageOrientation as a0, PageSetup as a1, Paragraph as a2, ParagraphCollection as a4, Range as a6, RangeCollection as a7, RemoveDocInfoType as a9, RequestContext as aa, Revision as ab, RevisionCollection as ac, Section as ah, SectionCollection as ai, Table as al, TableCell as am, TableCellCollection as an, TableCollection as ao, TableRow as ap, TableRowCollection as aq, TrackedObjects as ar, UnderlineType as as, VerticalAlignment as at, isDocxEditorError as au, Body as b, Bookmark as e, BookmarkCollection as f, BreakType as g, ChangeTrackingMode as h, ClientObject as i, ClientResult as j, Comment as k, CommentCollection as l, CommentReply as m, CommentReplyCollection as n, ContentControl as o, ContentControlCollection as p, ContentControlType as s, Document as u, DocumentProperties as x };
+export type { NoteItemType as $, BesideLocation as B, CreateServerOptions as C, DocxEditorServerRuntime as D, DocxEditorErrorCode as F, DocxEditorErrorInit as G, DocxEditorRuntime as H, EditorModule as I, FieldTypeLiteral as M, HeaderFooterType as O, LoadOption as X, LoadQueryOptions as Y, CreateCollaborativeOptions as a, ParagraphAlignment as a3, ParagraphInsertTextLocation as a5, RangeInsertTextLocation as a8, RevisionTextView as ad, RevisionType as ae, RunCallback as af, SearchOptions as ag, SelectionMode as aj, ServerPaginationOptions as ak, BodyInsertParagraphLocation as c, BodyInsertTextLocation as d, ContentControlLockState as q, ContentControlSubtype as r, ContentControlValue as t, DocumentCapabilities as v, DocumentLimits as w, DocumentXmlLimits as y, DocumentZipLimits as z };