@eigenpal/docx-js-editor 0.0.3 → 0.0.5

package/dist/{types-BJXChtaM.d.ts → types-XVRXTi4o.d.ts}

@@ -1,13 +1,7 @@
 /**
- * Comprehensive TypeScript types for full DOCX document representation
+ * Color & Styling Primitives
  *
- * These types represent all elements that can appear in a DOCX file,
- * supporting full Microsoft Word fidelity including:
- * - Text and paragraph formatting
- * - Tables, images, shapes
- * - Hyperlinks, bookmarks, fields
- * - Lists, headers/footers, footnotes
- * - Themes, styles, page layout
+ * Basic types used throughout OOXML for colors, borders, and shading.
  */
 /**
  * Theme color slots from theme1.xml
@@ -56,6 +50,14 @@ interface ShadingProperties {
     /** 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';
 }
+
+/**
+ * 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
  */
@@ -252,6 +254,290 @@ interface ParagraphFormatting {
     /** 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)
+ */
+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
+ */
+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;
+}
+/**
+ * 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;
+}
+
+/**
+ * Lists & Numbering Types
+ *
+ * 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;
+}
+/**
+ * Complete numbering definitions
+ */
+interface NumberingDefinitions {
+    /** Abstract numbering definitions */
+    abstractNums: AbstractNumbering[];
+    /** Numbering instances */
+    nums: NumberingInstance[];
+}
+
+/**
+ * Document Content Model
+ *
+ * All content-bearing types: runs, hyperlinks, bookmarks, fields,
+ * images, shapes, tables, lists, paragraphs, headers/footers,
+ * footnotes/endnotes, and sections.
+ *
+ * These types form a deeply interrelated tree (Paragraph ↔ Table ↔ ShapeTextBody)
+ * and are kept together to avoid circular import issues.
+ */
+
 /**
  * Plain text content
  */
@@ -532,6 +818,8 @@ interface Image {
     padding?: ImagePadding;
     /** Whether this is a decorative image */
     decorative?: boolean;
+    /** Image outline/border */
+    outline?: ShapeOutline;
     /** Image effects */
     effects?: {
         brightness?: number;
@@ -601,240 +889,70 @@ interface ShapeTextBody {
     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;
-    };
-}
-/**
- * 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)
- */
-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;
+    /** Text margins */
+    margins?: {
+        top?: number;
+        bottom?: number;
+        left?: number;
+        right?: number;
+    };
+    /** Paragraphs inside the shape */
+    content: Paragraph[];
 }
 /**
- * Conditional format style
+ * Shape/drawing object (wps:wsp)
  */
-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;
+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 formatting properties (w:tcPr)
+ * Text box (floating text container)
  */
-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;
+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;
+    };
 }
 /**
  * Table cell
@@ -869,99 +987,152 @@ interface Table {
     rows: TableRow[];
 }
 /**
- * Number format type
+ * A comment (w:comment) from comments.xml
  */
-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';
+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;
+}
 /**
- * Multi-level suffix (what follows the number)
+ * Comment range start marker in paragraph content
  */
-type LevelSuffix = 'tab' | 'space' | 'nothing';
+interface CommentRangeStart {
+    type: 'commentRangeStart';
+    id: number;
+}
 /**
- * List level definition
+ * Comment range end marker in paragraph content
  */
-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;
-    };
+interface CommentRangeEnd {
+    type: 'commentRangeEnd';
+    id: number;
 }
 /**
- * Abstract numbering definition (w:abstractNum)
+ * Math equation content (m:oMath or m:oMathPara)
  */
-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;
+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;
 }
 /**
- * Numbering instance (w:num)
+ * Tracked change metadata (w:ins, w:del attributes)
  */
-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;
-    }>;
+interface TrackedChangeInfo {
+    /** Revision ID */
+    id: number;
+    /** Author who made the change */
+    author: string;
+    /** Date of the change */
+    date?: string;
 }
 /**
- * Computed list rendering info
+ * Insertion wrapper (w:ins) — runs inserted by tracked changes
  */
-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;
+interface Insertion {
+    type: 'insertion';
+    /** Tracked change metadata */
+    info: TrackedChangeInfo;
+    /** Inserted content */
+    content: (Run | Hyperlink)[];
 }
 /**
- * Complete numbering definitions
+ * Deletion wrapper (w:del) — runs deleted by tracked changes
  */
-interface NumberingDefinitions {
-    /** Abstract numbering definitions */
-    abstractNums: AbstractNumbering[];
-    /** Numbering instances */
-    nums: NumberingInstance[];
+interface Deletion {
+    type: 'deletion';
+    /** Tracked change metadata */
+    info: TrackedChangeInfo;
+    /** Deleted content */
+    content: (Run | Hyperlink)[];
+}
+/**
+ * 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 | MathEquation;
+/**
+ * Paragraph (w:p)
+ */
+interface Paragraph {
+    type: 'paragraph';
+    /** Unique paragraph ID */
+    paraId?: string;
+    /** Text ID */
+    textId?: string;
+    /** Paragraph formatting */
+    formatting?: ParagraphFormatting;
+    /** 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
@@ -1042,28 +1213,6 @@ interface Endnote {
     /** Content */
     content: Paragraph[];
 }
-/**
- * Paragraph content types
- */
-type ParagraphContent = Run | Hyperlink | BookmarkStart | BookmarkEnd | SimpleField | ComplexField;
-/**
- * Paragraph (w:p)
- */
-interface Paragraph {
-    type: 'paragraph';
-    /** Unique paragraph ID */
-    paraId?: string;
-    /** Text ID */
-    textId?: string;
-    /** Paragraph formatting */
-    formatting?: ParagraphFormatting;
-    /** 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;
-}
 /**
  * Page orientation
  */
@@ -1182,7 +1331,7 @@ interface SectionProperties {
 /**
  * Block-level content types
  */
-type BlockContent = Paragraph | Table;
+type BlockContent = Paragraph | Table | BlockSdt;
 /**
  * Section (implicit or explicit based on sectPr)
  */
@@ -1206,7 +1355,16 @@ interface DocumentBody {
     sections?: Section[];
     /** Final section properties (from body's sectPr) */
     finalSectionProperties?: SectionProperties;
+    /** Comments from comments.xml */
+    comments?: Comment[];
 }
+
+/**
+ * Styles, Theme, Font Table, Relationships & Media Types
+ *
+ * Types for document-level definitions that don't form the content tree.
+ */
+
 /**
  * Style type
  */
@@ -1424,6 +1582,21 @@ interface MediaFile {
     /** Data URL for direct use in src attributes */
     dataUrl?: string;
 }
+
+/**
+ * Comprehensive TypeScript types for full DOCX document representation
+ *
+ * This barrel file re-exports all types from the split modules.
+ * Existing imports from './types/document' continue to work unchanged.
+ *
+ * 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
  */
@@ -2213,4 +2386,4 @@ interface PluginRegistrationResult {
     warnings?: string[];
 }
 
-export { type RunContent as $, type AIAction as A, type BlockContent as B, type CorePlugin as C, type DocumentBody as D, type Endnote as E, type Footnote as F, type McpToolContent as G, type Hyperlink as H, type Image as I, type JsonSchema as J, type McpToolContext as K, type ListLevel as L, type McpToolDefinition as M, type McpToolHandler as N, type McpToolResult as O, type PluginOptions as P, type NumberingDefinitions as Q, type Run as R, type ParagraphContext as S, type TextFormatting as T, type ParagraphFormatting as U, type ParagraphOutline as V, type PluginCommand as W, type PluginEvent as X, type Range as Y, type Relationship as Z, type ReplaceTextCommand as _, type PluginRegistrationResult as a, type SectionInfo as a0, type SectionProperties as a1, type SelectionContext as a2, type SetVariableCommand as a3, type Style as a4, type StyleDefinitions as a5, type StyleInfo as a6, type SuggestedAction as a7, type TableCell as a8, type TableRow as a9, type ThemeColorScheme as aA, type ThemeFont as aB, type ThemeFontScheme as aC, type ExtractCommand as aD, type McpToolExample as aE, type TypedCommandHandler as aF, type TextContent as aa, type Theme as ab, type ZodSchemaLike as ac, comparePositions as ad, createCollapsedRange as ae, createCommand as af, createRange as ag, getActionDescription as ah, getActionLabel as ai, isPositionInRange as aj, isZodSchema as ak, type ColorValue as al, type ThemeColorSlot as am, type HeaderFooter as an, type ParagraphAlignment as ao, type StyleType as ap, type BorderSpec as aq, type ShadingProperties as ar, type BreakContent as as, type BookmarkEnd as at, type BookmarkStart as au, type Field as av, type FooterReference as aw, type HeaderReference as ax, type Shape as ay, type TextBox as az, type CommandHandler as b, type PluginEventListener as c, type McpSession as d, type Paragraph as e, type Table as f, type Position as g, type Document as h, type AIActionRequest as i, type AgentCommand as j, type AgentContext as k, type AgentResponse as l, type ApplyStyleCommand as m, type ApplyVariablesCommand as n, type CommandResult as o, DEFAULT_AI_ACTIONS as p, type DeleteTextCommand as q, type DocxPackage as r, type FormatParagraphCommand as s, type FormatTextCommand as t, type InsertHyperlinkCommand as u, type InsertImageCommand as v, type InsertTableCommand as w, type InsertTextCommand as x, type LoadedDocument as y, type McpToolAnnotations as z };
+export { type RunContent as $, type AIAction as A, type BlockContent as B, type CorePlugin as C, type DocumentBody as D, type Endnote as E, type Footnote as F, type McpToolContent as G, type Hyperlink as H, type Image as I, type JsonSchema as J, type McpToolContext as K, type ListLevel as L, type McpToolDefinition as M, type McpToolHandler as N, type McpToolResult as O, type PluginOptions as P, type NumberingDefinitions as Q, type Run as R, type ParagraphContext as S, type TextFormatting as T, type ParagraphFormatting as U, type ParagraphOutline as V, type PluginCommand as W, type PluginEvent as X, type Range as Y, type Relationship as Z, type ReplaceTextCommand as _, type PluginRegistrationResult as a, type SectionInfo as a0, type SectionProperties as a1, type SelectionContext as a2, type SetVariableCommand as a3, type Style as a4, type StyleDefinitions as a5, type StyleInfo as a6, type SuggestedAction as a7, type TableCell as a8, type TableRow as a9, type Shape as aA, type TextBox as aB, type ThemeColorScheme as aC, type ThemeFont as aD, type ThemeFontScheme as aE, type ExtractCommand as aF, type McpToolExample as aG, type TypedCommandHandler as aH, type TextContent as aa, type Theme as ab, type ZodSchemaLike as ac, comparePositions as ad, createCollapsedRange as ae, createCommand as af, createRange as ag, getActionDescription as ah, getActionLabel as ai, isPositionInRange as aj, isZodSchema as ak, type ColorValue as al, type ThemeColorSlot as am, type ParagraphAlignment as an, type StyleType as ao, type TabStop as ap, type TabStopAlignment as aq, type BorderSpec as ar, type ShadingProperties as as, type BreakContent as at, type BookmarkEnd as au, type BookmarkStart as av, type Field as aw, type FooterReference as ax, type HeaderFooter as ay, type HeaderReference as az, type CommandHandler as b, type PluginEventListener as c, type McpSession as d, type Paragraph as e, type Table as f, type Position as g, type Document as h, type AIActionRequest as i, type AgentCommand as j, type AgentContext as k, type AgentResponse as l, type ApplyStyleCommand as m, type ApplyVariablesCommand as n, type CommandResult as o, DEFAULT_AI_ACTIONS as p, type DeleteTextCommand as q, type DocxPackage as r, type FormatParagraphCommand as s, type FormatTextCommand as t, type InsertHyperlinkCommand as u, type InsertImageCommand as v, type InsertTableCommand as w, type InsertTextCommand as x, type LoadedDocument as y, type McpToolAnnotations as z };