@eigenpal/docx-editor-core 1.0.2 → 1.1.0

package/dist/types/content.d.mts

@@ -12,1170 +12,7 @@
  * @packageDocumentation
  * @public
  */
-import { P as ParagraphFormatting, T as TextFormatting, h as TableFormatting, k as TableRowFormatting, g as TableCellFormatting } from '../formatting-D9I-lFS4.mjs';
-import { WrapType } from '../docx/wrapTypes.mjs';
-import { B as BorderSpec, C as ColorValue, T as ThemeColorSlot } from '../colors-C3vA7HUU.mjs';
-import { c as NumberFormat, b as ListRendering } from '../lists-JDB80qyP.mjs';
-
-/**
- * Hyperlinks (`w:hyperlink`), bookmark markers (`w:bookmarkStart`/`End`),
- * and field types (`w:fldSimple`, complex `w:fldChar` runs).
- */
-
-/**
- * Hyperlink (`w:hyperlink`) — wraps runs in a clickable link. External
- * targets resolve through the relationships part (`rId` → `href`);
- * internal targets reference a `BookmarkStart` anchor by name.
- */
-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;
-}
-type Field = SimpleField | ComplexField;
-
-/**
- * Math equations (`m:oMath`, `m:oMathPara`). OMML XML is round-tripped
- * verbatim to preserve fidelity Word/Pages/Docs can disagree on.
- */
-/**
- * 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-changes model — insertion/deletion/move wrappers, range
- * markers, and per-element property-change wrappers (`w:rPrChange`,
- * `w:pPrChange`, `w:tblPrChange`, `w:trPrChange`, `w:tcPrChange`) plus
- * structural changes (row/cell insert/delete/merge).
- */
-
-/**
- * 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-level tracked wrappers represented in WordprocessingML.
- */
-type TrackedRunChange = Insertion | Deletion | MoveFrom | MoveTo;
-/**
- * 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;
-}
-
-/**
- * Tables (`w:tbl`), rows (`w:tr`), and cells (`w:tc`).
- */
-
-/**
- * Table cell (`w:tc`). Holds nested block content (paragraphs and nested
- * tables), cell-level formatting (borders, shading, vertical merge),
- * tracked property changes, and tracked structural changes for cell
- * insert/delete/merge operations.
- */
-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 (`w:tr`) — an ordered list of `TableCell` plus row-level
- * formatting (height, repeated header, cantSplit) and tracked changes
- * for inserts/deletes.
- */
-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`) — a block-level grid of rows × cells. Tables carry
- * their own formatting layer (borders, shading, alignment, indent,
- * floating placement) and an explicit column-width grid in twips. Tables
- * can nest arbitrarily through `TableCell.content`.
- *
- * See ECMA-376 §17.4.
- */
-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[];
-}
-
-/**
- * Structured Document Tags / content controls (`w:sdt`) — inline and
- * block variants, plus properties (alias, tag, lock, list items,
- * checkbox state) for the supported SDT types.
- */
-
-/**
- * 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;
-    /**
-     * Inline content held inside the control. OOXML allows runs,
-     * hyperlinks, simple/complex fields, nested SDTs, and math at this
-     * level; the renderer must descend into all of them so docProps-bound
-     * fields and similar template content survive paged rendering.
-     */
-    content: (Run | Hyperlink | SimpleField | ComplexField | InlineSdt | MathEquation)[];
-}
-/**
- * Block-level SDT (content control wrapping paragraphs/tables)
- */
-interface BlockSdt {
-    type: 'blockSdt';
-    /** SDT properties */
-    properties: SdtProperties;
-    /** Block content inside the control */
-    content: (Paragraph | Table)[];
-}
-
-/**
- * Comments (`w:comment` in `comments.xml`) and the inline range markers
- * (`w:commentRangeStart`/`End`) that anchor them inside paragraphs.
- */
-
-/**
- * A comment from `comments.xml` — the top-level entity for review
- * comments and replies. `id` matches the inline `CommentRangeStart` /
- * `CommentRangeEnd` markers that anchor it inside a paragraph; `parentId`
- * threads replies under their parent; `done` reflects Word's "Resolve"
- * state (`w15:done`).
- */
-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;
-}
-
-/**
- * Page furniture — headers (`w:hdr`), footers (`w:ftr`), footnotes
- * (`w:footnote`), and endnotes (`w:endnote`), plus the section-level
- * properties (`w:footnotePr`/`w:endnotePr`) that configure note layout.
- */
-
-/**
- * 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. Per ECMA-376 §17.11.10 footnotes can hold the same blocks as
-     * the body — paragraphs and tables. The parser previously only collected
-     * <w:p> children which silently dropped any <w:tbl> inside a footnote;
-     * widened to match HeaderFooter / TableCell shape so the body pipeline
-     * (toProseDoc → toFlowBlocks) can render them uniformly.
-     */
-    content: (Paragraph | Table)[];
-}
-/**
- * Endnote (w:endnote)
- */
-interface Endnote {
-    type: 'endnote';
-    /** Endnote ID */
-    id: number;
-    /** Special endnote type */
-    noteType?: 'normal' | 'separator' | 'continuationSeparator' | 'continuationNotice';
-    /**
-     * Content. Per ECMA-376 §17.11.4 endnotes can hold the same blocks as
-     * the body — paragraphs and tables. See note on `Footnote.content`.
-     */
-    content: (Paragraph | Table)[];
-}
-
-/**
- * Section properties (`w:sectPr`) — page size and margins, columns,
- * header/footer references, line numbers, page borders, document grid,
- * paper sources — plus the section and document-body containers that
- * group block-level content.
- */
-
-/**
- * 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`) — page geometry, margins, columns,
- * header/footer references, and page numbering for one section of the
- * document. Sections are introduced by inline `sectPr` markers on the
- * terminating paragraph (`Paragraph.sectionProperties`) and the body's
- * final `sectPr`.
- *
- * All distance units are twips (1/20 of a point) on the wire. The layout
- * engine converts to pixels.
- *
- * See ECMA-376 §17.6.
- */
-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;
-/**
- * One section of the document — a `SectionProperties` plus the block
- * content (`Paragraph`s and `Table`s) that lives under those properties.
- *
- * Sections are derived during parse: every paragraph carrying an inline
- * `sectPr` ends a section, and the body's final `sectPr` defines the
- * last section. Each section may carry its own headers/footers map.
- */
-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`) — the editable content of the document.
- *
- * Contains the ordered block content (paragraphs and tables), the section
- * layout chain derived from inline `sectPr` markers, the final `sectPr`,
- * and any document-level comments. This is what most edit operations
- * mutate; headers/footers/styles live elsewhere in the package.
- */
-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[];
-}
-
-/**
- * Paragraph (`w:p`) — the union of inline content that can sit inside a
- * paragraph (runs, hyperlinks, bookmarks, fields, SDT, comment ranges,
- * tracked-change wrappers, math) plus paragraph-level metadata
- * (formatting, list rendering, optional terminating section properties).
- */
-
-/**
- * Inline content that can appear inside a paragraph. Covers runs (text),
- * hyperlinks, bookmarks, fields, structured document tags, comment range
- * markers, tracked-change wrappers, and math equations. Every node in
- * this union carries a `type` discriminator so consumers can narrow at
- * runtime.
- */
-type ParagraphContent = Run | Hyperlink | BookmarkStart | BookmarkEnd | SimpleField | ComplexField | InlineSdt | CommentRangeStart | CommentRangeEnd | Insertion | Deletion | MoveFrom | MoveTo | MoveFromRangeStart | MoveFromRangeEnd | MoveToRangeStart | MoveToRangeEnd | MathEquation;
-/**
- * Paragraph (`w:p`) — the primary block-level container in a Word document.
- *
- * Every paragraph carries direct formatting (`formatting`), tracked
- * property changes (`propertyChanges`), inline content (`content`), and
- * optional list rendering / section break metadata. `paraId` is Word's
- * stable identifier (`w14:paraId`) and is what `EditorBridge` and the
- * agent toolkit use to address paragraphs.
- *
- * See ECMA-376 §17.3.1.
- */
-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;
-    /** Word's cached layout says this paragraph started on a new rendered page. */
-    renderedPageBreakBefore?: boolean;
-    /** Section properties (if this paragraph ends a section) */
-    sectionProperties?: SectionProperties;
-}
-
-/**
- * DrawingML shapes (`wps:wsp`) and text boxes — preset shape types,
- * fill, outline, shape text body, transform.
- */
-
-/**
- * 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;
-}
-/**
- * Text box (floating text container)
- */
-interface TextBox {
-    type: 'textBox';
-    /** Unique ID */
-    id?: string;
-    /** Size */
-    size: ImageSize;
-    /** Position */
-    position?: ImagePosition;
-    /** Wrap settings */
-    wrap?: ImageWrap;
-    /** Fill */
-    fill?: ShapeFill;
-    /** Outline */
-    outline?: ShapeOutline;
-    /** Text content */
-    content: Paragraph[];
-    /** Internal margins */
-    margins?: {
-        top?: number;
-        bottom?: number;
-        left?: number;
-        right?: number;
-    };
-}
-
-/**
- * Embedded images (`w:drawing` → `pic:pic`): size, wrap, position,
- * transform, padding, crop.
- */
-
-/**
- * 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: WrapType;
-    /** 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;
-}
-/**
- * Image crop, expressed as fractions of the source image to trim from each
- * edge. OOXML's `<a:srcRect l="10000" t="0" r="5000" b="0"/>` uses units of
- * 1/100000 (so 10000 → 0.1 → 10% trimmed from the left). We store the
- * normalised fraction so both the renderer and the saver can read it
- * directly without re-parsing units.
- */
-interface ImageCrop {
-    left?: number;
-    top?: number;
-    right?: number;
-    bottom?: number;
-}
-/**
- * Embedded image (`w:drawing` with an inline or anchored picture). Carries
- * the relationship-id pointer to the binary in `word/media/`, its
- * resolved data URL (`src`), display dimensions, optional crop /
- * transform / wrap behaviors, and anchor positioning for floating
- * images.
- *
- * See ECMA-376 §20.4 (DrawingML wordprocessingDrawing).
- */
-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;
-    /** Source-image crop (fractional, OOXML `a:srcRect`). */
-    crop?: ImageCrop;
-    /** Opacity in [0, 1] (OOXML `a:alphaModFix amt`). Undefined = fully opaque. */
-    opacity?: number;
-    /** Whether this is a decorative image */
-    decorative?: boolean;
-    /**
-     * `wp:anchor layoutInCell` — when true (default), an anchored image inside
-     * a table cell is constrained to the cell. When false, the image escapes
-     * the cell into the page area. Round-tripped on save.
-     */
-    layoutInCell?: boolean;
-    /**
-     * `wp:anchor allowOverlap` — when true (default), anchored objects may
-     * overlap; when false, Word repositions them to avoid collisions. We
-     * don't currently reposition; we round-trip the flag so saving preserves
-     * the author's intent.
-     */
-    allowOverlap?: boolean;
-    /** Hyperlink URL for clickable image */
-    hlinkHref?: string;
-    /** Image outline/border */
-    outline?: ShapeOutline;
-    /** Image effects */
-    effects?: {
-        brightness?: number;
-        contrast?: number;
-        saturation?: number;
-    };
-}
-
-/**
- * Run content (`w:r`) and the inline pieces that live inside a run —
- * text, tab, break, symbol, footnote/endnote references, field chars,
- * instruction text, soft/no-break hyphens, drawings, shapes.
- */
-
-/**
- * Plain text run content (`w:t`). `preserveSpace` mirrors the
- * `xml:space="preserve"` attribute and matters for runs that begin or end
- * with whitespace — without it, Word collapses leading/trailing spaces.
- */
-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 (`w:r`) — a contiguous span of inline content sharing one set of
- * character properties (bold, italic, font, color, etc.). Runs are the
- * atomic unit of character formatting; toggling bold on a selection that
- * spans different formatting creates new runs.
- *
- * See ECMA-376 §17.3.2.
- *
- * @example
- * ```ts
- * const run: Run = {
- *   type: 'run',
- *   formatting: { bold: true },
- *   content: [{ type: 'text', text: 'Hello' }],
- * };
- * ```
- */
-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[];
-}
-
-export type { BlockContent, BlockSdt, BookmarkEnd, BookmarkStart, BreakContent, Column, Comment, CommentRangeEnd, CommentRangeStart, ComplexField, Deletion, DocumentBody, DrawingContent, Endnote, EndnotePosition, EndnoteProperties, Field, FieldCharContent, FieldType, FooterReference, Footnote, FootnotePosition, FootnoteProperties, HeaderFooter, HeaderFooterType, HeaderReference, Hyperlink, Image, ImageCrop, ImagePadding, ImagePosition, ImageSize, ImageTransform, ImageWrap, InlineSdt, Insertion, InstrTextContent, LineNumberRestart, MathEquation, MoveFrom, MoveFromRangeEnd, MoveFromRangeStart, MoveTo, MoveToRangeEnd, MoveToRangeStart, NoBreakHyphenContent, NoteNumberRestart, NoteReferenceContent, PageOrientation, Paragraph, ParagraphContent, ParagraphPropertyChange, PropertyChangeInfo, Run, RunContent, RunPropertyChange, SdtProperties, SdtType, Section, SectionProperties, SectionStart, Shape, ShapeContent, ShapeFill, ShapeOutline, ShapeTextBody, ShapeType, SimpleField, SoftHyphenContent, SymbolContent, TabContent, Table, TableCell, TableCellPropertyChange, TablePropertyChange, TableRow, TableRowPropertyChange, TableStructuralChangeInfo, TextBox, TextContent, TrackedChangeInfo, TrackedRunChange, VerticalAlign };
+export { B as BlockContent, v as BlockSdt, w as BookmarkEnd, x as BookmarkStart, t as BreakContent, y as Column, C as Comment, a as CommentRangeEnd, b as CommentRangeStart, z as ComplexField, D as Deletion, c as DocumentBody, G as DrawingContent, E as Endnote, J as EndnotePosition, K as EndnoteProperties, O as Field, Q as FieldCharContent, U as FieldType, V as FooterReference, F as Footnote, W as FootnotePosition, X as FootnoteProperties, u as HeaderFooter, Y as HeaderFooterType, Z as HeaderReference, H as Hyperlink, I as Image, _ as ImageCrop, $ as ImagePadding, a0 as ImagePosition, a1 as ImageSize, a2 as ImageTransform, a3 as ImageWrap, a4 as InlineSdt, d as Insertion, a5 as InstrTextContent, a7 as LineNumberRestart, a9 as MathEquation, M as MoveFrom, aa as MoveFromRangeEnd, ab as MoveFromRangeStart, e as MoveTo, ac as MoveToRangeEnd, ad as MoveToRangeStart, ae as NoBreakHyphenContent, af as NoteNumberRestart, ag as NoteReferenceContent, ai as PageOrientation, P as Paragraph, f as ParagraphContent, p as ParagraphPropertyChange, aj as PropertyChangeInfo, R as Run, g as RunContent, ak as RunPropertyChange, al as SdtProperties, am as SdtType, an as Section, S as SectionProperties, ao as SectionStart, ap as Shape, aq as ShapeContent, ar as ShapeFill, as as ShapeOutline, at as ShapeTextBody, au as ShapeType, av as SimpleField, aw as SoftHyphenContent, ax as SymbolContent, ay as TabContent, T as Table, h as TableCell, r as TableCellPropertyChange, q as TablePropertyChange, i as TableRow, s as TableRowPropertyChange, az as TableStructuralChangeInfo, aA as TextBox, j as TextContent, k as TrackedChangeInfo, l as TrackedRunChange, aB as VerticalAlign } from '../content-5Mrz6w_b.mjs';
+import '../formatting-BH4hcZiq.mjs';
+import '../colors-C3vA7HUU.mjs';
+import '../docx/wrapTypes.mjs';