@eigenpal/docx-editor-agents 0.1.1 → 0.3.0

package/dist/index.d.ts

@@ -1,2026 +1,147 @@
-/**
- * Color & Styling Primitives
- *
- * Basic types used throughout OOXML for colors, borders, and shading.
- */
-/**
- * Theme color slots from theme1.xml
- */
-type ThemeColorSlot = 'dk1' | 'lt1' | 'dk2' | 'lt2' | 'accent1' | 'accent2' | 'accent3' | 'accent4' | 'accent5' | 'accent6' | 'hlink' | 'folHlink' | 'background1' | 'text1' | 'background2' | 'text2';
-/**
- * Color value - can be direct RGB, theme reference, or auto
- */
-interface ColorValue {
-    /** RGB hex value without # (e.g., "FF0000") */
-    rgb?: string;
-    /** Theme color slot reference */
-    themeColor?: ThemeColorSlot;
-    /** Tint modifier (0-255 as hex string, e.g., "80") - makes color lighter */
-    themeTint?: string;
-    /** Shade modifier (0-255 as hex string) - makes color darker */
-    themeShade?: string;
-    /** Auto color - context-dependent (usually black for text) */
-    auto?: boolean;
-}
-/**
- * Border specification for any border (paragraph, table, page)
- */
-interface BorderSpec {
-    /** Border style */
-    style: 'none' | 'single' | 'double' | 'dotted' | 'dashed' | 'thick' | 'triple' | 'thinThickSmallGap' | 'thickThinSmallGap' | 'thinThickMediumGap' | 'thickThinMediumGap' | 'thinThickLargeGap' | 'thickThinLargeGap' | 'wave' | 'doubleWave' | 'dashSmallGap' | 'dashDotStroked' | 'threeDEmboss' | 'threeDEngrave' | 'outset' | 'inset' | 'nil';
-    /** Color of the border */
-    color?: ColorValue;
-    /** Width in eighths of a point (1/8 pt) */
-    size?: number;
-    /** Spacing from text in points */
-    space?: number;
-    /** Shadow effect */
-    shadow?: boolean;
-    /** Frame effect */
-    frame?: boolean;
-}
-/**
- * Shading/background properties
- */
-interface ShadingProperties {
-    /** Pattern fill color */
-    color?: ColorValue;
-    /** Background fill color */
-    fill?: ColorValue;
-    /** Shading pattern type */
-    pattern?: 'clear' | 'solid' | 'horzStripe' | 'vertStripe' | 'reverseDiagStripe' | 'diagStripe' | 'horzCross' | 'diagCross' | 'thinHorzStripe' | 'thinVertStripe' | 'thinReverseDiagStripe' | 'thinDiagStripe' | 'thinHorzCross' | 'thinDiagCross' | 'pct5' | 'pct10' | 'pct12' | 'pct15' | 'pct20' | 'pct25' | 'pct30' | 'pct35' | 'pct37' | 'pct40' | 'pct45' | 'pct50' | 'pct55' | 'pct60' | 'pct62' | 'pct65' | 'pct70' | 'pct75' | 'pct80' | 'pct85' | 'pct87' | 'pct90' | 'pct95' | 'nil';
-}
+import { G as GetContentOptions, C as ContentBlock, e as CommentFilter, R as ReviewComment, f as ChangeFilter, h as ReviewChange, F as FoundMatch, S as SelectionInfo, i as AddCommentByParaIdOptions, j as ReplyOptions, P as ProposeChangeOptions, k as ApplyFormattingOptions, l as SetParagraphStyleOptions, m as PageContent, n as ContentChangeEvent, o as SelectionChangeEvent } from './server-B7dGWiLh.js';
+export { A as AgentToolDefinition, a as AgentToolResult, B as BatchError, p as BatchResult, q as BatchReviewOptions, D as DocxReviewer, r as agentTools, s as createReviewerBridge, t as executeToolCall, g as getToolSchemas } from './server-B7dGWiLh.js';
 
 /**
- * Text, Paragraph, and Table Formatting Types
- *
- * Properties that control how text, paragraphs, and table structures
- * are formatted in OOXML (w:rPr, w:pPr, w:tblPr, etc.).
- */
-
-/**
- * Underline style options
- */
-type UnderlineStyle = 'none' | 'single' | 'words' | 'double' | 'thick' | 'dotted' | 'dottedHeavy' | 'dash' | 'dashedHeavy' | 'dashLong' | 'dashLongHeavy' | 'dotDash' | 'dashDotHeavy' | 'dotDotDash' | 'dashDotDotHeavy' | 'wave' | 'wavyHeavy' | 'wavyDouble';
-/**
- * Text effect animations
- */
-type TextEffect = 'none' | 'blinkBackground' | 'lights' | 'antsBlack' | 'antsRed' | 'shimmer' | 'sparkle';
-/**
- * Emphasis mark type
- */
-type EmphasisMark = 'none' | 'dot' | 'comma' | 'circle' | 'underDot';
-/**
- * Complete text formatting properties (w:rPr)
- */
-interface TextFormatting {
-    /** Bold (w:b) */
-    bold?: boolean;
-    /** Bold complex script (w:bCs) */
-    boldCs?: boolean;
-    /** Italic (w:i) */
-    italic?: boolean;
-    /** Italic complex script (w:iCs) */
-    italicCs?: boolean;
-    /** Underline style and color (w:u) */
-    underline?: {
-        style: UnderlineStyle;
-        color?: ColorValue;
-    };
-    /** Strikethrough (w:strike) */
-    strike?: boolean;
-    /** Double strikethrough (w:dstrike) */
-    doubleStrike?: boolean;
-    /** Superscript/subscript (w:vertAlign) */
-    vertAlign?: 'baseline' | 'superscript' | 'subscript';
-    /** Small caps (w:smallCaps) */
-    smallCaps?: boolean;
-    /** All caps (w:caps) */
-    allCaps?: boolean;
-    /** Hidden text (w:vanish) */
-    hidden?: boolean;
-    /** Text color (w:color) */
-    color?: ColorValue;
-    /** Highlight/background color (w:highlight) */
-    highlight?: 'black' | 'blue' | 'cyan' | 'darkBlue' | 'darkCyan' | 'darkGray' | 'darkGreen' | 'darkMagenta' | 'darkRed' | 'darkYellow' | 'green' | 'lightGray' | 'magenta' | 'none' | 'red' | 'white' | 'yellow';
-    /** Character shading (w:shd) */
-    shading?: ShadingProperties;
-    /** Font size in half-points (w:sz) - e.g., 24 = 12pt */
-    fontSize?: number;
-    /** Font size complex script (w:szCs) */
-    fontSizeCs?: number;
-    /** Font family (w:rFonts) */
-    fontFamily?: {
-        ascii?: string;
-        hAnsi?: string;
-        eastAsia?: string;
-        cs?: string;
-        /** Theme font reference */
-        asciiTheme?: 'majorAscii' | 'majorHAnsi' | 'majorEastAsia' | 'majorBidi' | 'minorAscii' | 'minorHAnsi' | 'minorEastAsia' | 'minorBidi';
-        hAnsiTheme?: string;
-        eastAsiaTheme?: string;
-        csTheme?: string;
-    };
-    /** Character spacing in twips (w:spacing) */
-    spacing?: number;
-    /** Raised/lowered text position in half-points (w:position) */
-    position?: number;
-    /** Horizontal text scale percentage (w:w) */
-    scale?: number;
-    /** Kerning threshold in half-points (w:kern) */
-    kerning?: number;
-    /** Text effect animation (w:effect) */
-    effect?: TextEffect;
-    /** Emphasis mark (w:em) */
-    emphasisMark?: EmphasisMark;
-    /** Emboss effect (w:emboss) */
-    emboss?: boolean;
-    /** Imprint/engrave effect (w:imprint) */
-    imprint?: boolean;
-    /** Outline effect (w:outline) */
-    outline?: boolean;
-    /** Shadow effect (w:shadow) */
-    shadow?: boolean;
-    /** Right-to-left text (w:rtl) */
-    rtl?: boolean;
-    /** Complex script formatting (w:cs) */
-    cs?: boolean;
-    /** Character style ID (w:rStyle) */
-    styleId?: string;
-}
-/**
- * Tab stop alignment
- */
-type TabStopAlignment = 'left' | 'center' | 'right' | 'decimal' | 'bar' | 'clear' | 'num';
-/**
- * Tab leader character
- */
-type TabLeader = 'none' | 'dot' | 'hyphen' | 'underscore' | 'heavy' | 'middleDot';
-/**
- * Tab stop definition
- */
-interface TabStop {
-    /** Position in twips from left margin */
-    position: number;
-    /** Alignment at tab stop */
-    alignment: TabStopAlignment;
-    /** Leader character */
-    leader?: TabLeader;
-}
-/**
- * Line spacing rule
- */
-type LineSpacingRule = 'auto' | 'exact' | 'atLeast';
-/**
- * Paragraph alignment/justification
- */
-type ParagraphAlignment = 'left' | 'center' | 'right' | 'both' | 'distribute' | 'mediumKashida' | 'highKashida' | 'lowKashida' | 'thaiDistribute';
-/**
- * Complete paragraph formatting properties (w:pPr)
- */
-interface ParagraphFormatting {
-    /** Paragraph alignment (w:jc) */
-    alignment?: ParagraphAlignment;
-    /** Text direction (w:bidi) */
-    bidi?: boolean;
-    /** Spacing before in twips (w:spacing/@w:before) */
-    spaceBefore?: number;
-    /** Spacing after in twips (w:spacing/@w:after) */
-    spaceAfter?: number;
-    /** Line spacing value (w:spacing/@w:line) */
-    lineSpacing?: number;
-    /** Line spacing rule (w:spacing/@w:lineRule) */
-    lineSpacingRule?: LineSpacingRule;
-    /** Auto space before (w:spacing/@w:beforeAutospacing) */
-    beforeAutospacing?: boolean;
-    /** Auto space after (w:spacing/@w:afterAutospacing) */
-    afterAutospacing?: boolean;
-    /** Left indent in twips (w:ind/@w:left) */
-    indentLeft?: number;
-    /** Right indent in twips (w:ind/@w:right) */
-    indentRight?: number;
-    /** First line indent in twips - positive for indent, negative for hanging (w:ind/@w:firstLine or @w:hanging) */
-    indentFirstLine?: number;
-    /** Whether first line is hanging indent */
-    hangingIndent?: boolean;
-    /** Paragraph borders (w:pBdr) */
-    borders?: {
-        top?: BorderSpec;
-        bottom?: BorderSpec;
-        left?: BorderSpec;
-        right?: BorderSpec;
-        between?: BorderSpec;
-        bar?: BorderSpec;
-    };
-    /** Paragraph shading (w:shd) */
-    shading?: ShadingProperties;
-    /** Custom tab stops (w:tabs) */
-    tabs?: TabStop[];
-    /** Keep with next paragraph (w:keepNext) */
-    keepNext?: boolean;
-    /** Keep lines together (w:keepLines) */
-    keepLines?: boolean;
-    /** Widow/orphan control (w:widowControl) */
-    widowControl?: boolean;
-    /** Page break before (w:pageBreakBefore) */
-    pageBreakBefore?: boolean;
-    /** Contextual spacing — suppress space between paragraphs of the same style (w:contextualSpacing) */
-    contextualSpacing?: boolean;
-    /** Numbering properties (w:numPr) */
-    numPr?: {
-        /** Numbering definition ID (w:numId) */
-        numId?: number;
-        /** List level (0-8) (w:ilvl) */
-        ilvl?: number;
-    };
-    /** Outline level 0-9 (w:outlineLvl) */
-    outlineLevel?: number;
-    /** Paragraph style ID (w:pStyle) */
-    styleId?: string;
-    /** Text frame properties (w:framePr) */
-    frame?: {
-        width?: number;
-        height?: number;
-        hAnchor?: 'text' | 'margin' | 'page';
-        vAnchor?: 'text' | 'margin' | 'page';
-        x?: number;
-        y?: number;
-        xAlign?: 'left' | 'center' | 'right' | 'inside' | 'outside';
-        yAlign?: 'top' | 'center' | 'bottom' | 'inside' | 'outside' | 'inline';
-        wrap?: 'around' | 'auto' | 'none' | 'notBeside' | 'through' | 'tight';
-    };
-    /** Suppress line numbers (w:suppressLineNumbers) */
-    suppressLineNumbers?: boolean;
-    /** Suppress auto hyphens (w:suppressAutoHyphens) */
-    suppressAutoHyphens?: boolean;
-    /** Run properties to apply to all runs (w:rPr) */
-    runProperties?: TextFormatting;
-}
-/**
- * Table width type
- */
-type TableWidthType = 'auto' | 'dxa' | 'nil' | 'pct';
-/**
- * Table measurement (width or height)
- */
-interface TableMeasurement {
-    /** Value in twips (for dxa) or fifths of a percent (for pct) */
-    value: number;
-    /** Measurement type */
-    type: TableWidthType;
-}
-/**
- * Table borders
- */
-interface TableBorders {
-    top?: BorderSpec;
-    bottom?: BorderSpec;
-    left?: BorderSpec;
-    right?: BorderSpec;
-    insideH?: BorderSpec;
-    insideV?: BorderSpec;
-}
-/**
- * Cell margins
- */
-interface CellMargins {
-    top?: TableMeasurement;
-    bottom?: TableMeasurement;
-    left?: TableMeasurement;
-    right?: TableMeasurement;
-}
-/**
- * Table look flags (for table styles)
- */
-interface TableLook {
-    firstColumn?: boolean;
-    firstRow?: boolean;
-    lastColumn?: boolean;
-    lastRow?: boolean;
-    noHBand?: boolean;
-    noVBand?: boolean;
-}
-/**
- * Floating table properties
- */
-interface FloatingTableProperties {
-    /** Horizontal anchor */
-    horzAnchor?: 'margin' | 'page' | 'text';
-    /** Vertical anchor */
-    vertAnchor?: 'margin' | 'page' | 'text';
-    /** Horizontal position */
-    tblpX?: number;
-    tblpXSpec?: 'left' | 'center' | 'right' | 'inside' | 'outside';
-    /** Vertical position */
-    tblpY?: number;
-    tblpYSpec?: 'top' | 'center' | 'bottom' | 'inside' | 'outside' | 'inline';
-    /** Distance from surrounding text */
-    topFromText?: number;
-    bottomFromText?: number;
-    leftFromText?: number;
-    rightFromText?: number;
-}
-/**
- * Table formatting properties (w:tblPr)
- */
-interface TableFormatting {
-    /** Table width */
-    width?: TableMeasurement;
-    /** Table justification */
-    justification?: 'left' | 'center' | 'right';
-    /** Cell spacing */
-    cellSpacing?: TableMeasurement;
-    /** Table indent from left margin */
-    indent?: TableMeasurement;
-    /** Table borders */
-    borders?: TableBorders;
-    /** Default cell margins */
-    cellMargins?: CellMargins;
-    /** Table layout */
-    layout?: 'fixed' | 'autofit';
-    /** Table style ID */
-    styleId?: string;
-    /** Table look (conditional formatting flags) */
-    look?: TableLook;
-    /** Shading/background */
-    shading?: ShadingProperties;
-    /** Overlap for floating tables */
-    overlap?: 'never' | 'overlap';
-    /** Floating table properties */
-    floating?: FloatingTableProperties;
-    /** Right to left table */
-    bidi?: boolean;
-}
-/**
- * Table row formatting properties (w:trPr)
+ * Error classes for @eigenpal/docx-editor-agents
  */
-interface TableRowFormatting {
-    /** Row height */
-    height?: TableMeasurement;
-    /** Height rule */
-    heightRule?: 'auto' | 'atLeast' | 'exact';
-    /** Header row (repeats on each page) */
-    header?: boolean;
-    /** Allow row to break across pages */
-    cantSplit?: boolean;
-    /** Row justification */
-    justification?: 'left' | 'center' | 'right';
-    /** Hidden row */
-    hidden?: boolean;
-    /** Conditional format style */
-    conditionalFormat?: ConditionalFormatStyle;
+declare class TextNotFoundError extends Error {
+    constructor(search: string, paragraphIndex?: number);
 }
-/**
- * Conditional format style
- */
-interface ConditionalFormatStyle {
-    /** First row */
-    firstRow?: boolean;
-    /** Last row */
-    lastRow?: boolean;
-    /** First column */
-    firstColumn?: boolean;
-    /** Last column */
-    lastColumn?: boolean;
-    /** Odd horizontal band */
-    oddHBand?: boolean;
-    /** Even horizontal band */
-    evenHBand?: boolean;
-    /** Odd vertical band */
-    oddVBand?: boolean;
-    /** Even vertical band */
-    evenVBand?: boolean;
-    /** Northwest corner */
-    nwCell?: boolean;
-    /** Northeast corner */
-    neCell?: boolean;
-    /** Southwest corner */
-    swCell?: boolean;
-    /** Southeast corner */
-    seCell?: boolean;
+declare class ChangeNotFoundError extends Error {
+    constructor(id: number);
 }
-/**
- * Table cell formatting properties (w:tcPr)
- */
-interface TableCellFormatting {
-    /** Cell width */
-    width?: TableMeasurement;
-    /** Cell borders */
-    borders?: TableBorders;
-    /** Cell margins (override table default) */
-    margins?: CellMargins;
-    /** Cell shading/background */
-    shading?: ShadingProperties;
-    /** Vertical alignment */
-    verticalAlign?: 'top' | 'center' | 'bottom';
-    /** Text direction */
-    textDirection?: 'lr' | 'lrV' | 'rl' | 'rlV' | 'tb' | 'tbV' | 'tbRl' | 'tbRlV' | 'btLr';
-    /** Grid span (horizontal merge) */
-    gridSpan?: number;
-    /** Vertical merge */
-    vMerge?: 'restart' | 'continue';
-    /** Fit text to cell width */
-    fitText?: boolean;
-    /** Wrap text */
-    noWrap?: boolean;
-    /** Hide cell marker */
-    hideMark?: boolean;
-    /** Conditional format style */
-    conditionalFormat?: ConditionalFormatStyle;
+declare class CommentNotFoundError extends Error {
+    constructor(id: number);
 }
 
 /**
- * Lists & Numbering Types
+ * Formal Word JS API parity contract.
  *
- * Types for bullet lists, numbered lists, and numbering definitions.
- */
-
-/**
- * Number format type
- */
-type NumberFormat = 'decimal' | 'upperRoman' | 'lowerRoman' | 'upperLetter' | 'lowerLetter' | 'ordinal' | 'cardinalText' | 'ordinalText' | 'hex' | 'chicago' | 'ideographDigital' | 'japaneseCounting' | 'aiueo' | 'iroha' | 'decimalFullWidth' | 'decimalHalfWidth' | 'japaneseLegal' | 'japaneseDigitalTenThousand' | 'decimalEnclosedCircle' | 'decimalFullWidth2' | 'aiueoFullWidth' | 'irohaFullWidth' | 'decimalZero' | 'bullet' | 'ganada' | 'chosung' | 'decimalEnclosedFullstop' | 'decimalEnclosedParen' | 'decimalEnclosedCircleChinese' | 'ideographEnclosedCircle' | 'ideographTraditional' | 'ideographZodiac' | 'ideographZodiacTraditional' | 'taiwaneseCounting' | 'ideographLegalTraditional' | 'taiwaneseCountingThousand' | 'taiwaneseDigital' | 'chineseCounting' | 'chineseLegalSimplified' | 'chineseCountingThousand' | 'koreanDigital' | 'koreanCounting' | 'koreanLegal' | 'koreanDigital2' | 'vietnameseCounting' | 'russianLower' | 'russianUpper' | 'none' | 'numberInDash' | 'hebrew1' | 'hebrew2' | 'arabicAlpha' | 'arabicAbjad' | 'hindiVowels' | 'hindiConsonants' | 'hindiNumbers' | 'hindiCounting' | 'thaiLetters' | 'thaiNumbers' | 'thaiCounting';
-/**
- * Multi-level suffix (what follows the number)
- */
-type LevelSuffix = 'tab' | 'space' | 'nothing';
-/**
- * List level definition
- */
-interface ListLevel {
-    /** Level index (0-8) */
-    ilvl: number;
-    /** Starting number */
-    start?: number;
-    /** Number format */
-    numFmt: NumberFormat;
-    /** Level text (e.g., "%1." or "•") */
-    lvlText: string;
-    /** Justification */
-    lvlJc?: 'left' | 'center' | 'right';
-    /** Suffix after number */
-    suffix?: LevelSuffix;
-    /** Paragraph properties for this level */
-    pPr?: ParagraphFormatting;
-    /** Run properties for the number/bullet */
-    rPr?: TextFormatting;
-    /** Restart numbering from higher level */
-    lvlRestart?: number;
-    /** Is legal numbering style */
-    isLgl?: boolean;
-    /** Legacy settings */
-    legacy?: {
-        legacy?: boolean;
-        legacySpace?: number;
-        legacyIndent?: number;
-    };
-}
-/**
- * Abstract numbering definition (w:abstractNum)
- */
-interface AbstractNumbering {
-    /** Abstract numbering ID */
-    abstractNumId: number;
-    /** Multi-level type */
-    multiLevelType?: 'hybridMultilevel' | 'multilevel' | 'singleLevel';
-    /** Numbering style link */
-    numStyleLink?: string;
-    /** Style link */
-    styleLink?: string;
-    /** Level definitions */
-    levels: ListLevel[];
-    /** Name */
-    name?: string;
-}
-/**
- * Numbering instance (w:num)
- */
-interface NumberingInstance {
-    /** Numbering ID (referenced by paragraphs) */
-    numId: number;
-    /** Reference to abstract numbering */
-    abstractNumId: number;
-    /** Level overrides */
-    levelOverrides?: Array<{
-        ilvl: number;
-        startOverride?: number;
-        lvl?: ListLevel;
-    }>;
-}
-/**
- * Computed list rendering info
- */
-interface ListRendering {
-    /** Computed marker text (e.g., "1.", "a)", "•") */
-    marker: string;
-    /** List level (0-8) */
-    level: number;
-    /** Numbering ID */
-    numId: number;
-    /** Whether this is a bullet or numbered list */
-    isBullet: boolean;
-    /** Number format type (decimal, lowerRoman, upperRoman, etc.) */
-    numFmt?: NumberFormat;
-    /** Whether the list marker is hidden (w:vanish on level rPr) */
-    markerHidden?: boolean;
-    /** Marker font family from numbering level rPr (ascii name) */
-    markerFontFamily?: string;
-    /** Marker font size from numbering level rPr, in points */
-    markerFontSize?: number;
-    /**
-     * NumberFormat for each level from 0..ilvl (inclusive).
-     * Used to resolve multi-level templates like "%1.%2." where each %N
-     * may need a different format (e.g., upperRoman parent + decimal child).
-     */
-    levelNumFmts?: NumberFormat[];
-}
-/**
- * Complete numbering definitions
- */
-interface NumberingDefinitions {
-    /** Abstract numbering definitions */
-    abstractNums: AbstractNumbering[];
-    /** Numbering instances */
-    nums: NumberingInstance[];
-}
-
-/**
- * Document Content Model
+ * This file declares what subset of Microsoft Word's Office.js JavaScript API
+ * (https://learn.microsoft.com/en-us/javascript/api/word) we mirror, **at the
+ * type level**. It is checked at compile time: `EditorBridge` must satisfy
+ * `WordCompatBridge` (verified via the static assertion at the bottom).
  *
- * All content-bearing types: runs, hyperlinks, bookmarks, fields,
- * images, shapes, tables, lists, paragraphs, headers/footers,
- * footnotes/endnotes, and sections.
+ * The assertion is the source of truth. If you change the bridge surface and
+ * forget to update parity, typecheck breaks.
  *
- * These types form a deeply interrelated tree (Paragraph ↔ Table ↔ ShapeTextBody)
- * and are kept together to avoid circular import issues.
- */
-
-/**
- * Plain text content
- */
-interface TextContent {
-    type: 'text';
-    /** The text string */
-    text: string;
-    /** Preserve whitespace (xml:space="preserve") */
-    preserveSpace?: boolean;
-}
-/**
- * Tab character
- */
-interface TabContent {
-    type: 'tab';
-}
-/**
- * Line break
- */
-interface BreakContent {
-    type: 'break';
-    /** Break type */
-    breakType?: 'page' | 'column' | 'textWrapping';
-    /** Clear type for text wrapping break */
-    clear?: 'none' | 'left' | 'right' | 'all';
-}
-/**
- * Symbol character (special font character)
- */
-interface SymbolContent {
-    type: 'symbol';
-    /** Font name */
-    font: string;
-    /** Character code */
-    char: string;
-}
-/**
- * Footnote or endnote reference
- */
-interface NoteReferenceContent {
-    type: 'footnoteRef' | 'endnoteRef';
-    /** Note ID */
-    id: number;
-}
-/**
- * Field character (begin/separate/end)
- */
-interface FieldCharContent {
-    type: 'fieldChar';
-    /** Field character type */
-    charType: 'begin' | 'separate' | 'end';
-    /** Field is locked */
-    fldLock?: boolean;
-    /** Field is dirty (needs update) */
-    dirty?: boolean;
-}
-/**
- * Field instruction text
- */
-interface InstrTextContent {
-    type: 'instrText';
-    /** Field instruction */
-    text: string;
-}
-/**
- * Soft hyphen
- */
-interface SoftHyphenContent {
-    type: 'softHyphen';
-}
-/**
- * Non-breaking hyphen
- */
-interface NoBreakHyphenContent {
-    type: 'noBreakHyphen';
-}
-/**
- * Drawing/image reference
- */
-interface DrawingContent {
-    type: 'drawing';
-    /** Image data */
-    image: Image;
-}
-/**
- * Shape reference
- */
-interface ShapeContent {
-    type: 'shape';
-    /** Shape data */
-    shape: Shape;
-}
-/**
- * All possible run content types
- */
-type RunContent = TextContent | TabContent | BreakContent | SymbolContent | NoteReferenceContent | FieldCharContent | InstrTextContent | SoftHyphenContent | NoBreakHyphenContent | DrawingContent | ShapeContent;
-/**
- * A run is a contiguous region of text with the same formatting
- */
-interface Run {
-    type: 'run';
-    /** Text formatting properties */
-    formatting?: TextFormatting;
-    /** Run-level tracked property changes (w:rPrChange) */
-    propertyChanges?: RunPropertyChange[];
-    /** Run content (text, tabs, breaks, etc.) */
-    content: RunContent[];
-}
-/**
- * Hyperlink (w:hyperlink)
- */
-interface Hyperlink {
-    type: 'hyperlink';
-    /** Relationship ID for external link */
-    rId?: string;
-    /** Resolved URL (from relationships) */
-    href?: string;
-    /** Internal bookmark anchor */
-    anchor?: string;
-    /** Tooltip text */
-    tooltip?: string;
-    /** Target frame */
-    target?: string;
-    /** Link history tracking */
-    history?: boolean;
-    /** Document location */
-    docLocation?: string;
-    /** Child runs */
-    children: (Run | BookmarkStart | BookmarkEnd)[];
-}
-/**
- * Bookmark start marker (w:bookmarkStart)
- */
-interface BookmarkStart {
-    type: 'bookmarkStart';
-    /** Bookmark ID */
-    id: number;
-    /** Bookmark name */
-    name: string;
-    /** Column index for table bookmarks */
-    colFirst?: number;
-    colLast?: number;
-}
-/**
- * Bookmark end marker (w:bookmarkEnd)
- */
-interface BookmarkEnd {
-    type: 'bookmarkEnd';
-    /** Bookmark ID */
-    id: number;
-}
-/**
- * Known field types
- */
-type FieldType = 'PAGE' | 'NUMPAGES' | 'NUMWORDS' | 'NUMCHARS' | 'DATE' | 'TIME' | 'CREATEDATE' | 'SAVEDATE' | 'PRINTDATE' | 'AUTHOR' | 'TITLE' | 'SUBJECT' | 'KEYWORDS' | 'COMMENTS' | 'FILENAME' | 'FILESIZE' | 'TEMPLATE' | 'DOCPROPERTY' | 'DOCVARIABLE' | 'REF' | 'PAGEREF' | 'NOTEREF' | 'HYPERLINK' | 'TOC' | 'TOA' | 'INDEX' | 'SEQ' | 'STYLEREF' | 'AUTONUM' | 'AUTONUMLGL' | 'AUTONUMOUT' | 'IF' | 'MERGEFIELD' | 'NEXT' | 'NEXTIF' | 'ASK' | 'SET' | 'QUOTE' | 'INCLUDETEXT' | 'INCLUDEPICTURE' | 'SYMBOL' | 'ADVANCE' | 'EDITTIME' | 'REVNUM' | 'SECTION' | 'SECTIONPAGES' | 'USERADDRESS' | 'USERNAME' | 'USERINITIALS' | 'UNKNOWN';
-/**
- * Simple field (w:fldSimple)
- */
-interface SimpleField {
-    type: 'simpleField';
-    /** Field instruction (e.g., "PAGE \\* MERGEFORMAT") */
-    instruction: string;
-    /** Parsed field type */
-    fieldType: FieldType;
-    /** Current display value */
-    content: (Run | Hyperlink)[];
-    /** Field is locked */
-    fldLock?: boolean;
-    /** Field is dirty */
-    dirty?: boolean;
-}
-/**
- * Complex field (w:fldChar begin/separate/end with w:instrText)
- */
-interface ComplexField {
-    type: 'complexField';
-    /** Field instruction */
-    instruction: string;
-    /** Parsed field type */
-    fieldType: FieldType;
-    /** Field code runs */
-    fieldCode: Run[];
-    /** Display result runs */
-    fieldResult: Run[];
-    /** Field is locked */
-    fldLock?: boolean;
-    /** Field is dirty */
-    dirty?: boolean;
-}
-/**
- * Image size specification
- */
-interface ImageSize {
-    /** Width in EMUs (English Metric Units) */
-    width: number;
-    /** Height in EMUs */
-    height: number;
-}
-/**
- * Image wrap type for floating images
- */
-interface ImageWrap {
-    type: 'inline' | 'square' | 'tight' | 'through' | 'topAndBottom' | 'behind' | 'inFront';
-    /** Wrap text direction */
-    wrapText?: 'bothSides' | 'left' | 'right' | 'largest';
-    /** Distance from text */
-    distT?: number;
-    distB?: number;
-    distL?: number;
-    distR?: number;
-}
-/**
- * Position for floating images
- */
-interface ImagePosition {
-    /** Horizontal positioning */
-    horizontal: {
-        relativeTo: 'character' | 'column' | 'insideMargin' | 'leftMargin' | 'margin' | 'outsideMargin' | 'page' | 'rightMargin';
-        alignment?: 'left' | 'right' | 'center' | 'inside' | 'outside';
-        posOffset?: number;
-    };
-    /** Vertical positioning */
-    vertical: {
-        relativeTo: 'insideMargin' | 'line' | 'margin' | 'outsideMargin' | 'page' | 'paragraph' | 'topMargin' | 'bottomMargin';
-        alignment?: 'top' | 'bottom' | 'center' | 'inside' | 'outside';
-        posOffset?: number;
-    };
-}
-/**
- * Image transformation
- */
-interface ImageTransform {
-    /** Rotation in degrees */
-    rotation?: number;
-    /** Flip horizontal */
-    flipH?: boolean;
-    /** Flip vertical */
-    flipV?: boolean;
-}
-/**
- * Image padding/margins
- */
-interface ImagePadding {
-    top?: number;
-    bottom?: number;
-    left?: number;
-    right?: number;
-}
-/**
- * Embedded image (w:drawing)
- */
-interface Image {
-    type: 'image';
-    /** Unique ID */
-    id?: string;
-    /** Relationship ID for the image data */
-    rId: string;
-    /** Resolved image data (base64 or blob URL) */
-    src?: string;
-    /** Image MIME type */
-    mimeType?: string;
-    /** Original filename */
-    filename?: string;
-    /** Alt text for accessibility */
-    alt?: string;
-    /** Title/description */
-    title?: string;
-    /** Image size */
-    size: ImageSize;
-    /** Original size before any transforms */
-    originalSize?: ImageSize;
-    /** Wrap settings */
-    wrap: ImageWrap;
-    /** Position for floating images */
-    position?: ImagePosition;
-    /** Image transformations */
-    transform?: ImageTransform;
-    /** Padding around image */
-    padding?: ImagePadding;
-    /** Whether this is a decorative image */
-    decorative?: boolean;
-    /** Hyperlink URL for clickable image */
-    hlinkHref?: string;
-    /** Image outline/border */
-    outline?: ShapeOutline;
-    /** Image effects */
-    effects?: {
-        brightness?: number;
-        contrast?: number;
-        saturation?: number;
-    };
-}
-/**
- * Shape types
- */
-type ShapeType = 'rect' | 'roundRect' | 'ellipse' | 'triangle' | 'rtTriangle' | 'parallelogram' | 'trapezoid' | 'pentagon' | 'hexagon' | 'heptagon' | 'octagon' | 'decagon' | 'dodecagon' | 'star4' | 'star5' | 'star6' | 'star7' | 'star8' | 'star10' | 'star12' | 'star16' | 'star24' | 'star32' | 'line' | 'straightConnector1' | 'bentConnector2' | 'bentConnector3' | 'bentConnector4' | 'bentConnector5' | 'curvedConnector2' | 'curvedConnector3' | 'curvedConnector4' | 'curvedConnector5' | 'rightArrow' | 'leftArrow' | 'upArrow' | 'downArrow' | 'leftRightArrow' | 'upDownArrow' | 'quadArrow' | 'leftRightUpArrow' | 'bentArrow' | 'uturnArrow' | 'leftUpArrow' | 'bentUpArrow' | 'curvedRightArrow' | 'curvedLeftArrow' | 'curvedUpArrow' | 'curvedDownArrow' | 'stripedRightArrow' | 'notchedRightArrow' | 'homePlate' | 'chevron' | 'rightArrowCallout' | 'downArrowCallout' | 'leftArrowCallout' | 'upArrowCallout' | 'leftRightArrowCallout' | 'quadArrowCallout' | 'circularArrow' | 'flowChartProcess' | 'flowChartAlternateProcess' | 'flowChartDecision' | 'flowChartInputOutput' | 'flowChartPredefinedProcess' | 'flowChartInternalStorage' | 'flowChartDocument' | 'flowChartMultidocument' | 'flowChartTerminator' | 'flowChartPreparation' | 'flowChartManualInput' | 'flowChartManualOperation' | 'flowChartConnector' | 'flowChartOffpageConnector' | 'flowChartPunchedCard' | 'flowChartPunchedTape' | 'flowChartSummingJunction' | 'flowChartOr' | 'flowChartCollate' | 'flowChartSort' | 'flowChartExtract' | 'flowChartMerge' | 'flowChartOnlineStorage' | 'flowChartDelay' | 'flowChartMagneticTape' | 'flowChartMagneticDisk' | 'flowChartMagneticDrum' | 'flowChartDisplay' | 'wedgeRectCallout' | 'wedgeRoundRectCallout' | 'wedgeEllipseCallout' | 'cloudCallout' | 'borderCallout1' | 'borderCallout2' | 'borderCallout3' | 'accentCallout1' | 'accentCallout2' | 'accentCallout3' | 'callout1' | 'callout2' | 'callout3' | 'accentBorderCallout1' | 'accentBorderCallout2' | 'accentBorderCallout3' | 'actionButtonBlank' | 'actionButtonHome' | 'actionButtonHelp' | 'actionButtonInformation' | 'actionButtonBackPrevious' | 'actionButtonForwardNext' | 'actionButtonBeginning' | 'actionButtonEnd' | 'actionButtonReturn' | 'actionButtonDocument' | 'actionButtonSound' | 'actionButtonMovie' | 'irregularSeal1' | 'irregularSeal2' | 'frame' | 'halfFrame' | 'corner' | 'diagStripe' | 'chord' | 'arc' | 'bracketPair' | 'bracePair' | 'leftBracket' | 'rightBracket' | 'leftBrace' | 'rightBrace' | 'can' | 'cube' | 'bevel' | 'donut' | 'noSmoking' | 'blockArc' | 'foldedCorner' | 'smileyFace' | 'heart' | 'lightningBolt' | 'sun' | 'moon' | 'cloud' | 'snip1Rect' | 'snip2SameRect' | 'snip2DiagRect' | 'snipRoundRect' | 'round1Rect' | 'round2SameRect' | 'round2DiagRect' | 'plaque' | 'teardrop' | 'mathPlus' | 'mathMinus' | 'mathMultiply' | 'mathDivide' | 'mathEqual' | 'mathNotEqual' | 'gear6' | 'gear9' | 'funnel' | 'pieWedge' | 'pie' | 'leftCircularArrow' | 'leftRightCircularArrow' | 'swooshArrow' | 'textBox';
-/**
- * Shape fill type
- */
-interface ShapeFill {
-    type: 'none' | 'solid' | 'gradient' | 'pattern' | 'picture';
-    /** Solid fill color */
-    color?: ColorValue;
-    /** Gradient stops for gradient fill */
-    gradient?: {
-        type: 'linear' | 'radial' | 'rectangular' | 'path';
-        angle?: number;
-        stops: Array<{
-            position: number;
-            color: ColorValue;
-        }>;
-    };
-}
-/**
- * Shape outline/stroke
- */
-interface ShapeOutline {
-    /** Line width in EMUs */
-    width?: number;
-    /** Line color */
-    color?: ColorValue;
-    /** Line style */
-    style?: 'solid' | 'dot' | 'dash' | 'lgDash' | 'dashDot' | 'lgDashDot' | 'lgDashDotDot' | 'sysDot' | 'sysDash' | 'sysDashDot' | 'sysDashDotDot';
-    /** Line cap */
-    cap?: 'flat' | 'round' | 'square';
-    /** Line join */
-    join?: 'bevel' | 'miter' | 'round';
-    /** Head arrow */
-    headEnd?: {
-        type: 'none' | 'triangle' | 'stealth' | 'diamond' | 'oval' | 'arrow';
-        width?: 'sm' | 'med' | 'lg';
-        length?: 'sm' | 'med' | 'lg';
-    };
-    /** Tail arrow */
-    tailEnd?: {
-        type: 'none' | 'triangle' | 'stealth' | 'diamond' | 'oval' | 'arrow';
-        width?: 'sm' | 'med' | 'lg';
-        length?: 'sm' | 'med' | 'lg';
-    };
-}
-/**
- * Text body inside a shape
- */
-interface ShapeTextBody {
-    /** Text direction */
-    vertical?: boolean;
-    /** Rotation */
-    rotation?: number;
-    /** Anchor/vertical alignment */
-    anchor?: 'top' | 'middle' | 'bottom' | 'distributed' | 'justified';
-    /** Anchor center */
-    anchorCenter?: boolean;
-    /** Auto fit */
-    autoFit?: 'none' | 'normal' | 'shape';
-    /** Text margins */
-    margins?: {
-        top?: number;
-        bottom?: number;
-        left?: number;
-        right?: number;
-    };
-    /** Paragraphs inside the shape */
-    content: Paragraph[];
-}
-/**
- * Shape/drawing object (wps:wsp)
- */
-interface Shape {
-    type: 'shape';
-    /** Shape type preset */
-    shapeType: ShapeType;
-    /** Unique ID */
-    id?: string;
-    /** Name */
-    name?: string;
-    /** Size in EMUs */
-    size: ImageSize;
-    /** Position for floating shapes */
-    position?: ImagePosition;
-    /** Wrap settings */
-    wrap?: ImageWrap;
-    /** Fill */
-    fill?: ShapeFill;
-    /** Outline/stroke */
-    outline?: ShapeOutline;
-    /** Transform */
-    transform?: ImageTransform;
-    /** Text content inside the shape */
-    textBody?: ShapeTextBody;
-    /** Custom geometry points */
-    customGeometry?: string;
-}
-/**
- * Table cell
- */
-interface TableCell {
-    type: 'tableCell';
-    /** Cell formatting */
-    formatting?: TableCellFormatting;
-    /** Cell-level tracked property changes (w:tcPrChange) */
-    propertyChanges?: TableCellPropertyChange[];
-    /** Tracked structural changes (cell insert/delete/merge) */
-    structuralChange?: TableStructuralChangeInfo;
-    /** Cell content (paragraphs, tables, etc.) */
-    content: (Paragraph | Table)[];
-}
-/**
- * Table row
- */
-interface TableRow {
-    type: 'tableRow';
-    /** Row formatting */
-    formatting?: TableRowFormatting;
-    /** Row-level tracked property changes (w:trPrChange) */
-    propertyChanges?: TableRowPropertyChange[];
-    /** Tracked structural changes (row insert/delete) */
-    structuralChange?: TableStructuralChangeInfo;
-    /** Cells in this row */
-    cells: TableCell[];
-}
-/**
- * Table (w:tbl)
- */
-interface Table {
-    type: 'table';
-    /** Table formatting */
-    formatting?: TableFormatting;
-    /** Table-level tracked property changes (w:tblPrChange) */
-    propertyChanges?: TablePropertyChange[];
-    /** Column widths in twips */
-    columnWidths?: number[];
-    /** Table rows */
-    rows: TableRow[];
-}
-/**
- * A comment (w:comment) from comments.xml
- */
-interface Comment {
-    /** Comment ID (matches commentRangeStart/End) */
-    id: number;
-    /** Author name */
-    author: string;
-    /** Author initials */
-    initials?: string;
-    /** Date */
-    date?: string;
-    /** Comment content (paragraphs) */
-    content: Paragraph[];
-    /** Parent comment ID (for replies) */
-    parentId?: number;
-    /** Whether the comment is resolved/done */
-    done?: boolean;
-}
-/**
- * Comment range start marker in paragraph content
- */
-interface CommentRangeStart {
-    type: 'commentRangeStart';
-    id: number;
-}
-/**
- * Comment range end marker in paragraph content
- */
-interface CommentRangeEnd {
-    type: 'commentRangeEnd';
-    id: number;
-}
-/**
- * Math equation content (m:oMath or m:oMathPara)
- */
-interface MathEquation {
-    type: 'mathEquation';
-    /** Whether this is a block (oMathPara) or inline (oMath) equation */
-    display: 'inline' | 'block';
-    /** Raw OMML XML for round-trip preservation */
-    ommlXml: string;
-    /** Plain text representation for accessibility/fallback */
-    plainText?: string;
-}
-/**
- * Tracked change metadata (w:ins, w:del attributes)
- */
-interface TrackedChangeInfo {
-    /** Revision ID */
-    id: number;
-    /** Author who made the change */
-    author: string;
-    /** Date of the change */
-    date?: string;
-}
-/**
- * Generic tracked property-change wrapper metadata (w:*PrChange)
- */
-interface PropertyChangeInfo extends TrackedChangeInfo {
-    /** Optional revision session ID */
-    rsid?: string;
-}
-/**
- * Insertion wrapper (w:ins) — runs inserted by tracked changes
- */
-interface Insertion {
-    type: 'insertion';
-    /** Tracked change metadata */
-    info: TrackedChangeInfo;
-    /** Inserted content */
-    content: (Run | Hyperlink)[];
-}
-/**
- * Deletion wrapper (w:del) — runs deleted by tracked changes
- */
-interface Deletion {
-    type: 'deletion';
-    /** Tracked change metadata */
-    info: TrackedChangeInfo;
-    /** Deleted content */
-    content: (Run | Hyperlink)[];
-}
-/**
- * Move-from wrapper (w:moveFrom) — content moved away from this position
- */
-interface MoveFrom {
-    type: 'moveFrom';
-    /** Tracked change metadata */
-    info: TrackedChangeInfo;
-    /** Moved content */
-    content: (Run | Hyperlink)[];
-}
-/**
- * Move-to wrapper (w:moveTo) — content moved into this position
- */
-interface MoveTo {
-    type: 'moveTo';
-    /** Tracked change metadata */
-    info: TrackedChangeInfo;
-    /** Moved content */
-    content: (Run | Hyperlink)[];
-}
-/**
- * Move-from range start marker (w:moveFromRangeStart) — ECMA-376 §17.13.5.22
- * Pairs with moveFromRangeEnd to delimit the source of a move in the document.
- */
-interface MoveFromRangeStart {
-    type: 'moveFromRangeStart';
-    id: number;
-    name: string;
-}
-/**
- * Move-from range end marker (w:moveFromRangeEnd)
- */
-interface MoveFromRangeEnd {
-    type: 'moveFromRangeEnd';
-    id: number;
-}
-/**
- * Move-to range start marker (w:moveToRangeStart) — ECMA-376 §17.13.5.24
- * Pairs with moveToRangeEnd to delimit the destination of a move.
- */
-interface MoveToRangeStart {
-    type: 'moveToRangeStart';
-    id: number;
-    name: string;
-}
-/**
- * Move-to range end marker (w:moveToRangeEnd)
- */
-interface MoveToRangeEnd {
-    type: 'moveToRangeEnd';
-    id: number;
-}
-/**
- * Run property change (w:rPrChange)
- */
-interface RunPropertyChange {
-    type: 'runPropertyChange';
-    /** Tracked change metadata */
-    info: PropertyChangeInfo;
-    /** Run properties before the tracked change */
-    previousFormatting?: TextFormatting;
-    /** Run properties after the tracked change (editor model convenience) */
-    currentFormatting?: TextFormatting;
-}
-/**
- * Paragraph property change (w:pPrChange)
- */
-interface ParagraphPropertyChange {
-    type: 'paragraphPropertyChange';
-    /** Tracked change metadata */
-    info: PropertyChangeInfo;
-    /** Paragraph properties before the tracked change */
-    previousFormatting?: ParagraphFormatting;
-    /** Paragraph properties after the tracked change (editor model convenience) */
-    currentFormatting?: ParagraphFormatting;
-}
-/**
- * Table property change (w:tblPrChange)
- */
-interface TablePropertyChange {
-    type: 'tablePropertyChange';
-    /** Tracked change metadata */
-    info: PropertyChangeInfo;
-    /** Table properties before the tracked change */
-    previousFormatting?: TableFormatting;
-    /** Table properties after the tracked change (editor model convenience) */
-    currentFormatting?: TableFormatting;
-}
-/**
- * Table row property change (w:trPrChange)
- */
-interface TableRowPropertyChange {
-    type: 'tableRowPropertyChange';
-    /** Tracked change metadata */
-    info: PropertyChangeInfo;
-    /** Row properties before the tracked change */
-    previousFormatting?: TableRowFormatting;
-    /** Row properties after the tracked change (editor model convenience) */
-    currentFormatting?: TableRowFormatting;
-}
-/**
- * Table cell property change (w:tcPrChange)
- */
-interface TableCellPropertyChange {
-    type: 'tableCellPropertyChange';
-    /** Tracked change metadata */
-    info: PropertyChangeInfo;
-    /** Cell properties before the tracked change */
-    previousFormatting?: TableCellFormatting;
-    /** Cell properties after the tracked change (editor model convenience) */
-    currentFormatting?: TableCellFormatting;
-}
-/**
- * Table structural tracked change metadata (row/cell insert/delete/merge)
- */
-interface TableStructuralChangeInfo {
-    type: 'tableRowInsertion' | 'tableRowDeletion' | 'tableCellInsertion' | 'tableCellDeletion' | 'tableCellMerge';
-    /** Tracked change metadata */
-    info: TrackedChangeInfo;
-}
-/**
- * SDT type (content control type)
- */
-type SdtType = 'richText' | 'plainText' | 'date' | 'dropdown' | 'comboBox' | 'checkbox' | 'picture' | 'buildingBlockGallery' | 'group' | 'unknown';
-/**
- * SDT properties (w:sdtPr)
- */
-interface SdtProperties {
-    /** SDT type */
-    sdtType: SdtType;
-    /** Alias (friendly name) */
-    alias?: string;
-    /** Tag (developer identifier) */
-    tag?: string;
-    /** Lock content editing */
-    lock?: 'sdtLocked' | 'contentLocked' | 'sdtContentLocked' | 'unlocked';
-    /** Placeholder text */
-    placeholder?: string;
-    /** Whether showing placeholder */
-    showingPlaceholder?: boolean;
-    /** Date format for date controls */
-    dateFormat?: string;
-    /** Dropdown/combobox list items */
-    listItems?: {
-        displayText: string;
-        value: string;
-    }[];
-    /** Checkbox checked state */
-    checked?: boolean;
-}
-/**
- * Inline SDT (content control within a paragraph)
- */
-interface InlineSdt {
-    type: 'inlineSdt';
-    /** SDT properties */
-    properties: SdtProperties;
-    /** Content runs inside the control */
-    content: (Run | Hyperlink)[];
-}
-/**
- * Block-level SDT (content control wrapping paragraphs/tables)
- */
-interface BlockSdt {
-    type: 'blockSdt';
-    /** SDT properties */
-    properties: SdtProperties;
-    /** Block content inside the control */
-    content: (Paragraph | Table)[];
-}
-/**
- * Paragraph content types
- */
-type ParagraphContent = Run | Hyperlink | BookmarkStart | BookmarkEnd | SimpleField | ComplexField | InlineSdt | CommentRangeStart | CommentRangeEnd | Insertion | Deletion | MoveFrom | MoveTo | MoveFromRangeStart | MoveFromRangeEnd | MoveToRangeStart | MoveToRangeEnd | MathEquation;
-/**
- * Paragraph (w:p)
- */
-interface Paragraph {
-    type: 'paragraph';
-    /** Unique paragraph ID */
-    paraId?: string;
-    /** Text ID */
-    textId?: string;
-    /** Paragraph formatting */
-    formatting?: ParagraphFormatting;
-    /** Paragraph-level tracked property changes (w:pPrChange) */
-    propertyChanges?: ParagraphPropertyChange[];
-    /** Paragraph content */
-    content: ParagraphContent[];
-    /** Computed list rendering (if this is a list item) */
-    listRendering?: ListRendering;
-    /** Section properties (if this paragraph ends a section) */
-    sectionProperties?: SectionProperties;
-}
-/**
- * Header/footer type
- */
-type HeaderFooterType = 'default' | 'first' | 'even';
-/**
- * Header or footer reference
- */
-interface HeaderReference {
-    type: HeaderFooterType;
-    rId: string;
-}
-interface FooterReference {
-    type: HeaderFooterType;
-    rId: string;
-}
-/**
- * Header or footer content
- */
-interface HeaderFooter {
-    type: 'header' | 'footer';
-    /** Header/footer type */
-    hdrFtrType: HeaderFooterType;
-    /** Content (paragraphs, tables, etc.) */
-    content: (Paragraph | Table)[];
-}
-/**
- * Footnote position
- */
-type FootnotePosition = 'pageBottom' | 'beneathText' | 'sectEnd' | 'docEnd';
-/**
- * Endnote position
- */
-type EndnotePosition = 'sectEnd' | 'docEnd';
-/**
- * Number restart type
- */
-type NoteNumberRestart = 'continuous' | 'eachSect' | 'eachPage';
-/**
- * Footnote properties
- */
-interface FootnoteProperties {
-    position?: FootnotePosition;
-    numFmt?: NumberFormat;
-    numStart?: number;
-    numRestart?: NoteNumberRestart;
-}
-/**
- * Endnote properties
- */
-interface EndnoteProperties {
-    position?: EndnotePosition;
-    numFmt?: NumberFormat;
-    numStart?: number;
-    numRestart?: NoteNumberRestart;
-}
-/**
- * Footnote (w:footnote)
- */
-interface Footnote {
-    type: 'footnote';
-    /** Footnote ID */
-    id: number;
-    /** Special footnote type */
-    noteType?: 'normal' | 'separator' | 'continuationSeparator' | 'continuationNotice';
-    /** Content */
-    content: Paragraph[];
-}
-/**
- * Endnote (w:endnote)
- */
-interface Endnote {
-    type: 'endnote';
-    /** Endnote ID */
-    id: number;
-    /** Special endnote type */
-    noteType?: 'normal' | 'separator' | 'continuationSeparator' | 'continuationNotice';
-    /** Content */
-    content: Paragraph[];
-}
-/**
- * Page orientation
- */
-type PageOrientation = 'portrait' | 'landscape';
-/**
- * Section start type
- */
-type SectionStart = 'continuous' | 'nextPage' | 'oddPage' | 'evenPage' | 'nextColumn';
-/**
- * Vertical alignment
- */
-type VerticalAlign = 'top' | 'center' | 'both' | 'bottom';
-/**
- * Line number restart type
- */
-type LineNumberRestart = 'continuous' | 'newPage' | 'newSection';
-/**
- * Column definition
- */
-interface Column {
-    /** Column width in twips */
-    width?: number;
-    /** Space after column in twips */
-    space?: number;
-}
-/**
- * Section properties (w:sectPr)
- */
-interface SectionProperties {
-    /** Page width in twips */
-    pageWidth?: number;
-    /** Page height in twips */
-    pageHeight?: number;
-    /** Page orientation */
-    orientation?: PageOrientation;
-    /** Top margin in twips */
-    marginTop?: number;
-    /** Bottom margin in twips */
-    marginBottom?: number;
-    /** Left margin in twips */
-    marginLeft?: number;
-    /** Right margin in twips */
-    marginRight?: number;
-    /** Header distance from top in twips */
-    headerDistance?: number;
-    /** Footer distance from bottom in twips */
-    footerDistance?: number;
-    /** Gutter margin in twips */
-    gutter?: number;
-    /** Number of columns */
-    columnCount?: number;
-    /** Space between columns in twips */
-    columnSpace?: number;
-    /** Equal width columns */
-    equalWidth?: boolean;
-    /** Separator line between columns */
-    separator?: boolean;
-    /** Individual column definitions */
-    columns?: Column[];
-    /** Section start type */
-    sectionStart?: SectionStart;
-    /** Vertical alignment of text */
-    verticalAlign?: VerticalAlign;
-    /** Right-to-left section */
-    bidi?: boolean;
-    /** Header references */
-    headerReferences?: HeaderReference[];
-    /** Footer references */
-    footerReferences?: FooterReference[];
-    /** Different first page header/footer */
-    titlePg?: boolean;
-    /** Different odd/even page headers/footers */
-    evenAndOddHeaders?: boolean;
-    /** Line numbering settings */
-    lineNumbers?: {
-        start?: number;
-        countBy?: number;
-        distance?: number;
-        restart?: LineNumberRestart;
-    };
-    /** Page borders */
-    pageBorders?: {
-        top?: BorderSpec;
-        bottom?: BorderSpec;
-        left?: BorderSpec;
-        right?: BorderSpec;
-        /** Display setting */
-        display?: 'allPages' | 'firstPage' | 'notFirstPage';
-        /** Offset from */
-        offsetFrom?: 'page' | 'text';
-        /** Z-order */
-        zOrder?: 'front' | 'back';
-    };
-    /** Page background */
-    background?: {
-        color?: ColorValue;
-        themeColor?: ThemeColorSlot;
-        themeTint?: string;
-        themeShade?: string;
-    };
-    /** Footnote properties for this section */
-    footnotePr?: FootnoteProperties;
-    /** Endnote properties for this section */
-    endnotePr?: EndnoteProperties;
-    /** Document grid */
-    docGrid?: {
-        type?: 'default' | 'lines' | 'linesAndChars' | 'snapToChars';
-        linePitch?: number;
-        charSpace?: number;
-    };
-    /** First page paper source */
-    paperSrcFirst?: number;
-    /** Other pages paper source */
-    paperSrcOther?: number;
-}
-/**
- * Block-level content types
- */
-type BlockContent = Paragraph | Table | BlockSdt;
-/**
- * Section (implicit or explicit based on sectPr)
- */
-interface Section {
-    /** Section properties */
-    properties: SectionProperties;
-    /** Content in this section */
-    content: BlockContent[];
-    /** Headers for this section */
-    headers?: Map<HeaderFooterType, HeaderFooter>;
-    /** Footers for this section */
-    footers?: Map<HeaderFooterType, HeaderFooter>;
-}
-/**
- * Document body (w:body)
- */
-interface DocumentBody {
-    /** All content (paragraphs, tables) */
-    content: BlockContent[];
-    /** Sections (derived from sectPr in paragraphs and final sectPr) */
-    sections?: Section[];
-    /** Final section properties (from body's sectPr) */
-    finalSectionProperties?: SectionProperties;
-    /** Comments from comments.xml */
-    comments?: Comment[];
-}
-
-/**
- * Styles, Theme, Font Table, Relationships & Media Types
+ * ## What we mirror (✓)
  *
- * Types for document-level definitions that don't form the content tree.
- */
-
-/**
- * Style type
- */
-type StyleType = 'paragraph' | 'character' | 'numbering' | 'table';
-/**
- * Style definition
- */
-interface Style {
-    /** Style ID */
-    styleId: string;
-    /** Style type */
-    type: StyleType;
-    /** Display name */
-    name?: string;
-    /** Based on style ID */
-    basedOn?: string;
-    /** Next style after Enter (for paragraph styles) */
-    next?: string;
-    /** Linked style (paragraph/character pair) */
-    link?: string;
-    /** UI sort priority */
-    uiPriority?: number;
-    /** Hidden from UI */
-    hidden?: boolean;
-    /** Semi-hidden from UI */
-    semiHidden?: boolean;
-    /** Unhide when used */
-    unhideWhenUsed?: boolean;
-    /** Quick format in gallery */
-    qFormat?: boolean;
-    /** Is default style */
-    default?: boolean;
-    /** Personal style (custom) */
-    personal?: boolean;
-    /** Paragraph properties (for paragraph/table styles) */
-    pPr?: ParagraphFormatting;
-    /** Run properties */
-    rPr?: TextFormatting;
-    /** Table properties (for table styles) */
-    tblPr?: TableFormatting;
-    /** Table row properties */
-    trPr?: TableRowFormatting;
-    /** Table cell properties */
-    tcPr?: TableCellFormatting;
-    /** Conditional table style parts */
-    tblStylePr?: Array<{
-        type: 'band1Horz' | 'band1Vert' | 'band2Horz' | 'band2Vert' | 'firstCol' | 'firstRow' | 'lastCol' | 'lastRow' | 'neCell' | 'nwCell' | 'seCell' | 'swCell';
-        pPr?: ParagraphFormatting;
-        rPr?: TextFormatting;
-        tblPr?: TableFormatting;
-        trPr?: TableRowFormatting;
-        tcPr?: TableCellFormatting;
-    }>;
-}
-/**
- * Document defaults (w:docDefaults)
- */
-interface DocDefaults {
-    /** Default run properties */
-    rPr?: TextFormatting;
-    /** Default paragraph properties */
-    pPr?: ParagraphFormatting;
-}
-/**
- * Style definitions from styles.xml
- */
-interface StyleDefinitions {
-    /** Document defaults */
-    docDefaults?: DocDefaults;
-    /** Latent styles */
-    latentStyles?: {
-        defLockedState?: boolean;
-        defUIPriority?: number;
-        defSemiHidden?: boolean;
-        defUnhideWhenUsed?: boolean;
-        defQFormat?: boolean;
-        count?: number;
-    };
-    /** Style definitions */
-    styles: Style[];
-}
-/**
- * Theme color scheme (a:clrScheme)
- */
-interface ThemeColorScheme {
-    /** Dark 1 color (usually black) */
-    dk1?: string;
-    /** Light 1 color (usually white) */
-    lt1?: string;
-    /** Dark 2 color */
-    dk2?: string;
-    /** Light 2 color */
-    lt2?: string;
-    /** Accent colors 1-6 */
-    accent1?: string;
-    accent2?: string;
-    accent3?: string;
-    accent4?: string;
-    accent5?: string;
-    accent6?: string;
-    /** Hyperlink color */
-    hlink?: string;
-    /** Followed hyperlink color */
-    folHlink?: string;
-}
-/**
- * Theme font (with script variants)
- */
-interface ThemeFont {
-    /** Latin font */
-    latin?: string;
-    /** East Asian font */
-    ea?: string;
-    /** Complex script font */
-    cs?: string;
-    /** Script-specific fonts */
-    fonts?: Record<string, string>;
-}
-/**
- * Theme font scheme (a:fontScheme)
- */
-interface ThemeFontScheme {
-    /** Major font (headings) */
-    majorFont?: ThemeFont;
-    /** Minor font (body text) */
-    minorFont?: ThemeFont;
-}
-/**
- * Theme (from theme1.xml)
- */
-interface Theme {
-    /** Theme name */
-    name?: string;
-    /** Color scheme */
-    colorScheme?: ThemeColorScheme;
-    /** Font scheme */
-    fontScheme?: ThemeFontScheme;
-    /** Format scheme (fills, lines, effects) - simplified */
-    formatScheme?: {
-        name?: string;
-    };
-}
-/**
- * Font info from fontTable.xml
- */
-interface FontInfo {
-    /** Font name */
-    name: string;
-    /** Alternate names */
-    altName?: string;
-    /** Panose-1 classification */
-    panose1?: string;
-    /** Character set */
-    charset?: string;
-    /** Font family type */
-    family?: 'decorative' | 'modern' | 'roman' | 'script' | 'swiss' | 'auto';
-    /** Pitch (fixed or variable) */
-    pitch?: 'default' | 'fixed' | 'variable';
-    /** Signature */
-    sig?: {
-        usb0?: string;
-        usb1?: string;
-        usb2?: string;
-        usb3?: string;
-        csb0?: string;
-        csb1?: string;
-    };
-    /** Embedded font data reference */
-    embedRegular?: string;
-    embedBold?: string;
-    embedItalic?: string;
-    embedBoldItalic?: string;
-}
-/**
- * Font table from fontTable.xml
- */
-interface FontTable {
-    fonts: FontInfo[];
-}
-/**
- * Relationship type
- */
-type RelationshipType = 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/image' | 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/hyperlink' | 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/header' | 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/footer' | 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/footnotes' | 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/endnotes' | 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/styles' | 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/numbering' | 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/fontTable' | 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/theme' | 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/settings' | 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/webSettings' | 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/oleObject' | 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/chart' | 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/diagramData' | string;
-/**
- * Relationship entry
- */
-interface Relationship {
-    /** Relationship ID (e.g., "rId1") */
-    id: string;
-    /** Relationship type URI */
-    type: RelationshipType;
-    /** Target path or URL */
-    target: string;
-    /** Target mode */
-    targetMode?: 'External' | 'Internal';
-}
-/**
- * Relationship map (keyed by rId)
- */
-type RelationshipMap = Map<string, Relationship>;
-/**
- * Media file from word/media/
- */
-interface MediaFile {
-    /** File path in ZIP */
-    path: string;
-    /** Original filename */
-    filename?: string;
-    /** MIME type */
-    mimeType: string;
-    /** Binary data */
-    data: ArrayBuffer;
-    /** Base64 encoded data for rendering */
-    base64?: string;
-    /** Data URL for direct use in src attributes */
-    dataUrl?: string;
-}
-
-/**
- * Comprehensive TypeScript types for full DOCX document representation
+ * | Word JS API                         | Our equivalent                        |
+ * | ----------------------------------- | ------------------------------------- |
+ * | `Range` (stable handle)             | `paraId: string`                      |
+ * | `body.search(text)` → Ranges        | `findText(query, opts) → FoundMatch[]`|
+ * | `range.insertComment(text)`         | `addComment({paraId, text, search?})` |
+ * | `comment.reply(text)`               | `replyTo(commentId, {text})`          |
+ * | `comment.resolved = true`           | `resolveComment(commentId)`           |
+ * | `range.insertText(text, location)`  | `proposeChange({paraId, search, replaceWith})` (3 modes via empty-string semantics) |
+ * | `document.getSelection()`           | `getSelection() → SelectionInfo|null` |
+ * | `range.scrollIntoView()`            | `scrollTo(paraId)`                    |
+ * | `commentCollection.getItems()`      | `getComments(filter?)`                |
+ * | `body.paragraphs.getItems()`        | `getContent(opts?)`                   |
+ * | `document.body.text`                | `getContentAsText(opts?)`             |
+ * | `revisionCollection.getItems()`     | `getChanges(filter?)`                 |
+ * | `Document.onContentChanged.add(...)`| `onContentChange(listener)`           |
+ * | `Document.onSelectionChanged.add()` | `onSelectionChange(listener)`         |
+ * | `Range.font.bold` / `italic` / `color` / `size` / `name` | `applyFormatting({paraId, search?, marks})` |
+ * | `ParagraphFormat.style` / `applyStyle(...)` | `setParagraphStyle({paraId, styleId})` |
  *
- * This barrel file re-exports all types from the split modules.
- * Existing imports from './types/document' continue to work unchanged.
+ * ## Beyond Word's surface (paged-document affordances)
  *
- * Module structure:
- * - colors.ts      — Color primitives, borders, shading
- * - formatting.ts  — Text, paragraph, and table formatting properties
- * - lists.ts       — Numbering and list definitions
- * - content.ts     — Content model (runs, images, shapes, tables, paragraphs, sections)
- * - styles.ts      — Styles, theme, fonts, relationships, media
- */
-
-/**
- * Complete DOCX package structure
- */
-interface DocxPackage {
-    /** Document body */
-    document: DocumentBody;
-    /** Style definitions */
-    styles?: StyleDefinitions;
-    /** Theme */
-    theme?: Theme;
-    /** Numbering definitions */
-    numbering?: NumberingDefinitions;
-    /** Font table */
-    fontTable?: FontTable;
-    /** Footnotes */
-    footnotes?: Footnote[];
-    /** Endnotes */
-    endnotes?: Endnote[];
-    /** Headers by relationship ID */
-    headers?: Map<string, HeaderFooter>;
-    /** Footers by relationship ID */
-    footers?: Map<string, HeaderFooter>;
-    /** Document relationships */
-    relationships?: RelationshipMap;
-    /** Media files */
-    media?: Map<string, MediaFile>;
-    /** Document properties */
-    properties?: {
-        title?: string;
-        subject?: string;
-        creator?: string;
-        keywords?: string;
-        description?: string;
-        lastModifiedBy?: string;
-        revision?: number;
-        created?: Date;
-        modified?: Date;
-    };
-}
-/**
- * Complete parsed DOCX document
- */
-interface Document {
-    /** DOCX package with all parsed content */
-    package: DocxPackage;
-    /** Original ArrayBuffer for round-trip */
-    originalBuffer?: ArrayBuffer;
-    /** Detected template variables ({{...}}) */
-    templateVariables?: string[];
-    /** Parsing warnings/errors */
-    warnings?: string[];
-}
-
-/**
- * Types for @eigenpal/docx-editor-agents
+ *  - `getPage(n)` / `getPages({from, to})` / `getTotalPages()` — Word's JS API
+ *    doesn't model pages as first-class addressable units. We do, because the
+ *    editor is paged. Backed by the layout-painter's page boundary state.
+ *
+ * ## Differences (intentional, documented)
+ *
+ *  - All "insertText" overloads collapse into `proposeChange` with empty-string
+ *    semantics: replaceWith="" deletes; search="" inserts at paragraph end;
+ *    both non-empty replaces. Word has separate `insertText(...,'Replace')`,
+ *    `insertText(...,'Before')`, etc.; we found three modes were enough and
+ *    serialize cleaner for LLM tool calls.
+ *  - Tracked changes are always *suggestions* in our world. Word lets the
+ *    range mutate directly; we always go through the tracked-change path so
+ *    the human keeps the final say. (This matches the agent UX.)
+ *  - Word's `Range.context.sync()` is unnecessary — every call is one PM
+ *    transaction.
+ *  - Word's `Range` is a stateful object. Ours is a plain `{paraId, search?}`
+ *    JSON value, so it survives JSON.stringify and works for tool calls / MCP.
+ *
+ * ## Out of scope (gaps we deliberately don't implement)
+ *
+ *  - Paragraph creation (`body.insertParagraph`). Out of scope for v1.
+ *  - Table mutation (insert row/col, delete cell). Read-only.
+ *  - Headers / footers / sections.
+ *  - `Range.getOoxml()` / `getHtml()`. Plain text only.
+ *  - `customXmlParts` / `contentControls`.
+ *  - Accept / reject tracked changes. Human-only by design.
+ *
+ * Future versions can grow these by extending this interface — typecheck
+ * will then enforce the new contract.
  */
-interface HeadingBlock {
-    type: 'heading';
-    index: number;
-    level: number;
-    text: string;
-}
-interface ParagraphBlock {
-    type: 'paragraph';
-    index: number;
-    text: string;
-}
-interface TableBlock {
-    type: 'table';
-    index: number;
-    rows: string[][];
-}
-interface ListItemBlock {
-    type: 'list-item';
-    index: number;
-    text: string;
-    listLevel: number;
-    listType: 'bullet' | 'number';
-}
-type ContentBlock = HeadingBlock | ParagraphBlock | TableBlock | ListItemBlock;
-interface GetContentOptions {
-    fromIndex?: number;
-    toIndex?: number;
-    /** Annotate tracked changes inline. Default: true */
-    includeTrackedChanges?: boolean;
-    /** Annotate comments inline. Default: true */
-    includeCommentAnchors?: boolean;
-}
-interface ReviewChange {
-    id: number;
-    type: 'insertion' | 'deletion' | 'moveFrom' | 'moveTo';
-    author: string;
-    date: string | null;
-    text: string;
-    context: string;
-    paragraphIndex: number;
-}
-interface ReviewCommentReply {
-    id: number;
-    author: string;
-    date: string | null;
-    text: string;
-}
-interface ReviewComment {
-    id: number;
-    author: string;
-    date: string | null;
-    text: string;
-    anchoredText: string;
-    paragraphIndex: number;
-    replies: ReviewCommentReply[];
-    done: boolean;
-}
-interface ChangeFilter {
-    author?: string;
-    type?: 'insertion' | 'deletion' | 'moveFrom' | 'moveTo';
-}
-interface CommentFilter {
-    author?: string;
-    done?: boolean;
-}
-interface AddCommentOptions {
-    paragraphIndex: number;
-    text: string;
-    author?: string;
-    /** Optional: anchor to specific text. Omit to anchor whole paragraph. */
-    search?: string;
-}
-interface ReplyOptions {
-    text: string;
-    author?: string;
-}
-interface ProposeReplacementOptions {
-    paragraphIndex: number;
-    search: string;
-    replaceWith: string;
-    author?: string;
-}
-interface ProposeInsertionOptions {
-    paragraphIndex: number;
-    insertText: string;
-    author?: string;
-    position?: 'before' | 'after';
-    search?: string;
-}
-interface ProposeDeletionOptions {
-    paragraphIndex: number;
-    search: string;
-    author?: string;
-}
-interface BatchReviewOptions {
-    accept?: number[];
-    reject?: number[];
-    comments?: AddCommentOptions[];
-    replies?: (ReplyOptions & {
-        commentId: number;
-    })[];
-    proposals?: ProposeReplacementOptions[];
-}
-interface BatchError {
-    operation: string;
-    id?: number;
-    search?: string;
-    error: string;
-}
-interface BatchResult {
-    accepted: number;
-    rejected: number;
-    commentsAdded: number;
-    repliesAdded: number;
-    proposalsAdded: number;
-    errors: BatchError[];
-}
 
 /**
- * DocxReviewer — Word-like API for AI document review.
+ * The formal Word-JS-API parity surface. Each method maps to one or more
+ * Word API methods (named in the JSDoc above each member).
  *
- * @example
- * ```ts
- * const reviewer = await DocxReviewer.fromBuffer(buffer, 'AI Reviewer');
- * const text = reviewer.getContentAsText();
- * reviewer.addComment(5, 'Fix this paragraph.');
- * reviewer.replace(5, '$50k', '$500k');
- * const output = await reviewer.toBuffer();
- * ```
+ * If you change the EditorBridge surface, this interface must change too —
+ * the static assertion at the bottom of the file enforces it.
  */
-
-declare class DocxReviewer {
-    private doc;
-    /** Default author for comments and tracked changes. Set once, used everywhere. */
-    readonly author: string;
-    /**
-     * Create a reviewer from a parsed Document.
-     * @param document - Parsed Document from @eigenpal/docx-core
-     * @param author - Default author name for comments and changes. (default: 'AI')
-     * @param originalBuffer - Original DOCX buffer, needed for toBuffer()
-     */
-    constructor(document: Document, author?: string, originalBuffer?: ArrayBuffer);
-    /**
-     * Create a reviewer from a DOCX file buffer.
-     * @param buffer - ArrayBuffer of the DOCX file
-     * @param author - Default author name for comments and changes. (default: 'AI')
-     */
-    static fromBuffer(buffer: ArrayBuffer, author?: string): Promise<DocxReviewer>;
-    private get body();
-    private resolveAuthor;
-    /** Get document content as structured blocks (headings, paragraphs, tables, lists). */
-    getContent(options?: GetContentOptions): ContentBlock[];
-    /**
-     * Get document content as plain text for LLM prompts.
-     * Each paragraph is prefixed with its index: `[0] text`, `[1] text`, etc.
-     * Table cells include position: `[5] (table, row 1, col 2) cell text`.
-     * Avoids JSON quote-escaping issues — LLMs can copy text verbatim.
-     */
+interface WordCompatBridge {
+    /** Word: `document.body.text` (stringified, indexed lines). */
     getContentAsText(options?: GetContentOptions): string;
-    /** Get all tracked changes in the document. */
-    getChanges(filter?: ChangeFilter): ReviewChange[];
-    /** Get all comments with their replies. */
+    /** Word: `body.paragraphs.getItems()`. */
+    getContent(options?: GetContentOptions): ContentBlock[];
+    /** Word: `commentCollection.getItems()`. */
     getComments(filter?: CommentFilter): ReviewComment[];
+    /** Word: `revisionCollection.getItems()`. */
+    getChanges(filter?: ChangeFilter): ReviewChange[];
+    /** Word: `body.search(text)` returning Range[]. */
+    findText(query: string, options?: {
+        caseSensitive?: boolean;
+        limit?: number;
+    }): FoundMatch[];
+    /** Word: `document.getSelection()`. */
+    getSelection(): SelectionInfo | null;
+    /** Word: `range.insertComment(text)`. Anchored by paraId (Range handle). */
+    addComment(options: AddCommentByParaIdOptions): number | null;
+    /** Word: `comment.reply(text)`. */
+    replyTo(commentId: number, options: ReplyOptions): number | null;
+    /** Word: `comment.resolved = true`. */
+    resolveComment(commentId: number): void;
     /**
-     * Add a comment on a paragraph.
-     * @param paragraphIndex - Index of the paragraph to comment on
-     * @param text - Comment text
-     * @returns The new comment ID
-     */
-    addComment(paragraphIndex: number, text: string): number;
-    /**
-     * Add a comment with full options (custom author, anchored to specific text).
-     * @param options - Comment options
-     * @returns The new comment ID
-     */
-    addComment(options: AddCommentOptions): number;
-    /**
-     * Reply to an existing comment.
-     * @param commentId - ID of the comment to reply to
-     * @param text - Reply text
-     * @returns The new reply comment ID
-     */
-    replyTo(commentId: number, text: string): number;
-    /** Reply to an existing comment with full options. */
-    replyTo(commentId: number, options: ReplyOptions): number;
-    /**
-     * Remove a comment by ID. Removing a top-level comment also removes its
-     * replies and the anchored range markers. Removing a reply only removes
-     * that reply.
-     * @param commentId - ID of the comment to remove
+     * Word: `range.insertText(text, location)` collapsed into one verb.
+     *  - replacement: search non-empty, replaceWith non-empty
+     *  - deletion:    search non-empty, replaceWith ""
+     *  - insertion:   search "",        replaceWith non-empty (paragraph end)
      */
-    removeComment(commentId: number): void;
+    proposeChange(options: ProposeChangeOptions): boolean;
     /**
-     * Replace text in a paragraph. Creates a tracked change (deletion + insertion).
-     * @param paragraphIndex - Index of the paragraph
-     * @param search - Short phrase to find within the paragraph
-     * @param replaceWith - Replacement text
+     * Word: `range.font.bold = true` / `range.font.italic = true` / etc.
+     * Applied to a paragraph or to a unique phrase within it. Direct edit,
+     * not a tracked change.
      */
-    replace(paragraphIndex: number, search: string, replaceWith: string): void;
-    /** Replace text with full options. */
-    replace(options: ProposeReplacementOptions): void;
-    /** @deprecated Use replace() instead. */
-    proposeReplacement(options: ProposeReplacementOptions): void;
-    /** Insert text as a tracked change. */
-    proposeInsertion(options: ProposeInsertionOptions): void;
-    /** Delete text as a tracked change. */
-    proposeDeletion(options: ProposeDeletionOptions): void;
-    /** Accept a tracked change by its revision ID. */
-    acceptChange(id: number): void;
-    /** Reject a tracked change by its revision ID. */
-    rejectChange(id: number): void;
-    /** Accept all tracked changes. Returns count accepted. */
-    acceptAll(): number;
-    /** Reject all tracked changes. Returns count rejected. */
-    rejectAll(): number;
+    applyFormatting(options: ApplyFormattingOptions): boolean;
+    /** Word: `paragraph.styleBuiltIn = ...` / `paragraph.style = 'Heading 1'`. */
+    setParagraphStyle(options: SetParagraphStyleOptions): boolean;
     /**
-     * Apply multiple review operations in one call.
-     * Uses the reviewer's default author. Individual failures are collected, not thrown.
+     * Read one rendered page (1-indexed). Word's JS API does not expose pages
+     * as first-class objects; we do because the editor is paged.
      */
-    applyReview(ops: BatchReviewOptions): BatchResult;
-    /** Get the modified Document model. */
-    toDocument(): Document;
-    /** Serialize back to a DOCX buffer. Requires the original buffer. */
-    toBuffer(): Promise<ArrayBuffer>;
-}
-
-/**
- * Error classes for @eigenpal/docx-editor-agents
- */
-declare class TextNotFoundError extends Error {
-    constructor(search: string, paragraphIndex?: number);
-}
-declare class ChangeNotFoundError extends Error {
-    constructor(id: number);
-}
-declare class CommentNotFoundError extends Error {
-    constructor(id: number);
+    getPage(pageNumber: number): PageContent | null;
+    /** Read a range of rendered pages (1-indexed, inclusive). */
+    getPages(options: {
+        from: number;
+        to: number;
+    }): PageContent[];
+    /** Total number of pages currently rendered. */
+    getTotalPages(): number;
+    /** Word: `range.scrollIntoView()`. */
+    scrollTo(paraId: string): boolean;
+    /** Word: `Document.onContentChanged.add(handler)`. Returns unsubscribe. */
+    onContentChange(listener: (event: ContentChangeEvent) => void): () => void;
+    /** Word: `Document.onSelectionChanged.add(handler)`. Returns unsubscribe. */
+    onSelectionChange(listener: (event: SelectionChangeEvent) => void): () => void;
 }
 
-export { type BatchError, type BatchResult, type BatchReviewOptions, ChangeNotFoundError, CommentNotFoundError, type ContentBlock, DocxReviewer, type GetContentOptions, type ReviewChange, type ReviewComment, TextNotFoundError };
+export { ChangeNotFoundError, CommentNotFoundError, ContentBlock, GetContentOptions, ReviewChange, ReviewComment, TextNotFoundError, type WordCompatBridge };