@stll/docx-core 0.0.1-placeholder.0 → 0.1.0

package/dist/document-IR6XvC0O.d.ts

@@ -0,0 +1,1659 @@
+//#region src/model/colors.d.ts
+/**
+ * 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
+ */
+type 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;
+};
+type KnownBorderStyle = "none" | "single" | "double" | "dotted" | "dashed" | "thick" | "triple" | "thinThickSmallGap" | "thickThinSmallGap" | "thinThickMediumGap" | "thickThinMediumGap" | "thinThickLargeGap" | "thickThinLargeGap" | "wave" | "doubleWave" | "dashSmallGap" | "dashDotStroked" | "threeDEmboss" | "threeDEngrave" | "outset" | "inset" | "nil";
+/**
+ * Border specification for any border (paragraph, table, page)
+ */
+type BorderSpec = {
+  /** Border style. Unknown OOXML styles are preserved for fallback rendering. */style: string; /** 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;
+  /**
+   * Custom page-border art relationship id (`w:id` on `<w:pgBorders>` side
+   * children). Preserved for round-trip; folio does not paint art glyphs.
+   */
+  artRelationshipId?: string; /** Custom page-border art relationship id for the top-left corner. */
+  topLeftArtRelationshipId?: string; /** Custom page-border art relationship id for the top-right corner. */
+  topRightArtRelationshipId?: string; /** Custom page-border art relationship id for the bottom-left corner. */
+  bottomLeftArtRelationshipId?: string; /** Custom page-border art relationship id for the bottom-right corner. */
+  bottomRightArtRelationshipId?: string;
+};
+/**
+ * Shading/background properties
+ */
+type 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";
+};
+//#endregion
+//#region src/model/formatting.d.ts
+/**
+ * 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)
+ */
+type 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
+ */
+type 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)
+ */
+type SpacingExplicit = {
+  before?: boolean;
+  after?: boolean;
+};
+type 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; /** Which spacing sides came from this paragraph's own pPr. */
+  spacingExplicit?: SpacingExplicit; /** 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;
+  };
+  /**
+   * When `numPr` was resolved from the paragraph STYLE's pPr rather than the
+   * paragraph's own `<w:numPr>`, this records the style-sourced value. The
+   * serializer omits `numPr` while it still equals this value — writing it as
+   * direct formatting would flip Word's indent precedence (a directly
+   * referenced level's indents beat the style's; a style-referenced level's
+   * do not) and break the document on save/reload. Cleared the moment the
+   * user changes the numbering (values diverge).
+   */
+  numPrFromStyle?: {
+    numId?: number;
+    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;
+  /**
+   * Run-in heading: this paragraph's mark carries `<w:specVanish/>`
+   * and the next paragraph should render inline on the same line.
+   */
+  runInWithNext?: boolean;
+};
+/**
+ * Table width type
+ */
+type TableWidthType = "auto" | "dxa" | "nil" | "pct";
+/**
+ * Table measurement (width or height)
+ */
+type TableMeasurement = {
+  /** Value in twips (for dxa) or fifths of a percent (for pct) */value: number; /** Measurement type */
+  type: TableWidthType;
+};
+/**
+ * Table borders
+ */
+type TableBorders = {
+  top?: BorderSpec;
+  bottom?: BorderSpec;
+  left?: BorderSpec;
+  right?: BorderSpec;
+  insideH?: BorderSpec;
+  insideV?: BorderSpec;
+};
+/**
+ * Cell margins
+ */
+type CellMargins = {
+  top?: TableMeasurement;
+  bottom?: TableMeasurement;
+  left?: TableMeasurement;
+  right?: TableMeasurement;
+};
+/**
+ * Table look flags (for table styles)
+ */
+type TableLook = {
+  firstColumn?: boolean;
+  firstRow?: boolean;
+  lastColumn?: boolean;
+  lastRow?: boolean;
+  noHBand?: boolean;
+  noVBand?: boolean;
+};
+/**
+ * Floating table properties
+ */
+type 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)
+ */
+type 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)
+ */
+type 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;
+};
+/**
+ * Conditional format style
+ */
+type 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)
+ */
+type 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;
+};
+//#endregion
+//#region src/model/lists.d.ts
+/**
+ * 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" | "decimalZero3" | "decimalZero4" | "decimalZero5" | "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
+ */
+type 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)
+ */
+type 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)
+ */
+type NumberingInstance = {
+  /** Numbering ID (referenced by paragraphs) */numId: number; /** Reference to abstract numbering */
+  abstractNumId: number; /** Level overrides */
+  levelOverrides?: {
+    ilvl: number;
+    startOverride?: number;
+    lvl?: ListLevel;
+  }[];
+};
+/**
+ * Computed list rendering info
+ */
+type 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; /** Whether this level uses legal numbering (parent placeholders render decimal). */
+  isLegal?: 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;
+  /**
+   * `w:caps` on the numbering level rPr — the marker text renders in upper
+   * case (e.g. "SCHEDULE 1" instead of "Schedule 1"). Apply at substitution
+   * time so number-format letters (lowerLetter / lowerRoman) also flip.
+   */
+  markerAllCaps?: boolean;
+  /**
+   * `w:suff` (§17.9.25) — what follows the marker before body text.
+   * `tab` (the OOXML default) grows the marker to the next tab stop; `space`
+   * adds one space glyph; `nothing` lets body text butt against the marker.
+   */
+  markerSuffix?: LevelSuffix; /** Number format for each level from 0 through this paragraph's level. */
+  levelNumFmts?: NumberFormat[]; /** Abstract numbering definition shared by one or more numIds. */
+  abstractNumId?: number; /** Start override for this numId/level, if the numbering instance defines one. */
+  startOverride?: number;
+  /**
+   * Number of inline `LISTNUM` (default-list) fields the paragraph contains.
+   * Each represents an implicit counter advance at `ilvl + 1` (Word's
+   * default LISTNUM behaviour), so the next paragraph at that depth picks
+   * up the next letter — e.g. an OutNum2 line carrying inline "(a)" must
+   * be followed by an OutNum3 "(b)", not another "(a)".
+   */
+  implicitChildLevelAdvances?: number;
+  /**
+   * Column offset (in twips, from the marker zone's left edge) where the
+   * second slot of a tab-separated marker should land. Set when LISTNUM is
+   * folded into the marker so the cached "(a)" aligns vertically with the
+   * deeper level's marker column. Uses the next ilvl's `hangingIndent`.
+   */
+  markerSecondSlotOffsetTwips?: number;
+};
+/**
+ * Complete numbering definitions
+ */
+type NumberingDefinitions = {
+  /** Abstract numbering definitions */abstractNums: AbstractNumbering[]; /** Numbering instances */
+  nums: NumberingInstance[];
+};
+//#endregion
+//#region src/model/content.d.ts
+/**
+ * Plain text content
+ */
+type TextContent = {
+  type: "text"; /** The text string */
+  text: string; /** Preserve whitespace (xml:space="preserve") */
+  preserveSpace?: boolean;
+};
+/**
+ * Tab character
+ */
+type TabContent = {
+  type: "tab";
+};
+/**
+ * Line break
+ */
+type 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)
+ */
+type SymbolContent = {
+  type: "symbol"; /** Font name */
+  font: string; /** Character code */
+  char: string;
+};
+/**
+ * Footnote or endnote reference
+ */
+type NoteReferenceContent = {
+  type: "footnoteRef" | "endnoteRef"; /** Note ID */
+  id: number;
+};
+/**
+ * Field character (begin/separate/end)
+ */
+type FieldCharContent = {
+  type: "fieldChar"; /** Field character type */
+  charType: "begin" | "separate" | "end"; /** Field is locked */
+  fldLock?: boolean; /** Field is dirty (needs update) */
+  dirty?: boolean;
+  /**
+   * Cached display value from a child `<w:numberingChange w:original="…"/>`.
+   * Word writes this on the end fldChar of self-numbering fields (LISTNUM,
+   * AUTONUM, …) so the static "(a)" / "1." text is recoverable without
+   * re-evaluating the field. Used as a fallback `fieldResult` when the
+   * field has no `separate` run.
+   */
+  originalValue?: string;
+};
+/**
+ * Field instruction text
+ */
+type InstrTextContent = {
+  type: "instrText"; /** Field instruction */
+  text: string;
+};
+/**
+ * Soft hyphen
+ */
+type SoftHyphenContent = {
+  type: "softHyphen";
+};
+/**
+ * Non-breaking hyphen
+ */
+type NoBreakHyphenContent = {
+  type: "noBreakHyphen";
+};
+/**
+ * Drawing/image reference
+ */
+type DrawingContent = {
+  type: "drawing"; /** Image data */
+  image: Image; /** Original OOXML for package-preserving round-trips of unsupported drawing markup. */
+  rawXml?: string;
+};
+/**
+ * Shape reference
+ */
+type 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
+ */
+type 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)
+ */
+type 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)
+ */
+type 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)
+ */
+type 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" | "LISTNUM" | "IF" | "MERGEFIELD" | "NEXT" | "NEXTIF" | "ASK" | "SET" | "QUOTE" | "INCLUDETEXT" | "INCLUDEPICTURE" | "SYMBOL" | "ADVANCE" | "EDITTIME" | "REVNUM" | "SECTION" | "SECTIONPAGES" | "USERADDRESS" | "USERNAME" | "USERINITIALS" | "UNKNOWN";
+/**
+ * Simple field (w:fldSimple)
+ */
+type 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)
+ */
+type ComplexField = {
+  type: "complexField"; /** Field instruction */
+  instruction: string; /** Parsed field type */
+  fieldType: FieldType; /** Field code runs */
+  fieldCode: Run[]; /** Display result runs */
+  fieldResult: Run[];
+  /**
+   * Run formatting captured from the field's structural run(s) (`w:rPr` on the
+   * `begin`/code run). Used as the run-formatting fallback when the field has
+   * no separate result run to read it from, e.g. a footer `PAGE` number whose
+   * formatting lives on the field run (eigenpal/docx-editor#909).
+   */
+  formatting?: TextFormatting; /** Field is locked */
+  fldLock?: boolean; /** Field is dirty */
+  dirty?: boolean;
+};
+type Field = SimpleField | ComplexField;
+/**
+ * Image size specification
+ */
+type ImageSize = {
+  /** Width in EMUs (English Metric Units) */width: number; /** Height in EMUs */
+  height: number;
+};
+/**
+ * Image wrap type for floating images
+ */
+type 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
+ */
+type 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
+ */
+type ImageTransform = {
+  /** Rotation in degrees */rotation?: number; /** Flip horizontal */
+  flipH?: boolean; /** Flip vertical */
+  flipV?: boolean;
+};
+/**
+ * Image padding/margins
+ */
+type ImagePadding = {
+  top?: number;
+  bottom?: number;
+  left?: number;
+  right?: number;
+};
+/**
+ * Image crop fractions in [0, 1] applied to each side of the source bitmap.
+ * Mirrors the four `<a:srcRect>` attributes (`l`, `t`, `r`, `b`) defined in
+ * ECMA-376 §20.1.8.55, stored in 1/100000 units on the wire.
+ *
+ * eigenpal #424 (image-crop subset).
+ */
+type ImageCrop = {
+  left?: number;
+  top?: number;
+  right?: number;
+  bottom?: number;
+};
+/**
+ * Embedded image (w:drawing)
+ */
+type 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-bitmap crop (wp:srcRect), eigenpal #424 */
+  crop?: ImageCrop;
+  /**
+   * Opacity in [0, 1] (OOXML `a:alphaModFix amt`). Undefined or `1` means
+   * fully opaque. Mirrors eigenpal docx-editor #424.
+   */
+  opacity?: number;
+  /**
+   * `wp:anchor layoutInCell` — when true (OOXML 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 so the
+   * author's intent survives; undefined means "use the spec default".
+   */
+  layoutInCell?: boolean;
+  /**
+   * `wp:anchor allowOverlap` — when true (OOXML default), anchored objects
+   * may overlap; when false, Word repositions them to avoid collisions. We
+   * don't currently reposition, but we round-trip the flag so saving
+   * preserves the author's intent; undefined means "use the spec default".
+   */
+  allowOverlap?: boolean; /** 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
+ */
+type 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: {
+      position: number;
+      color: ColorValue;
+    }[];
+  };
+};
+/**
+ * Shape outline/stroke
+ */
+type 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
+ */
+type 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)
+ */
+type 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)
+ */
+type 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
+ */
+type 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
+ */
+type 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)
+ */
+type 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
+ */
+type 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
+ */
+type CommentRangeStart = {
+  type: "commentRangeStart";
+  id: number;
+};
+/**
+ * Comment range end marker in paragraph content
+ */
+type CommentRangeEnd = {
+  type: "commentRangeEnd";
+  id: number;
+};
+/**
+ * Point comment reference (w:commentReference without an explicit range).
+ * Word sometimes stores comments this way; we anchor them to nearby text for display.
+ */
+type CommentReference = {
+  type: "commentReference";
+  id: number;
+};
+/**
+ * Math equation content (m:oMath or m:oMathPara)
+ */
+type 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)
+ */
+type 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)
+ */
+type PropertyChangeInfo = {
+  /** Optional revision session ID */rsid?: string;
+} & TrackedChangeInfo;
+/**
+ * Insertion wrapper (w:ins) — runs inserted by tracked changes
+ */
+type Insertion = {
+  type: "insertion"; /** Tracked change metadata */
+  info: TrackedChangeInfo; /** Inserted content */
+  content: (Run | Hyperlink)[];
+};
+/**
+ * Deletion wrapper (w:del) — runs deleted by tracked changes
+ */
+type Deletion = {
+  type: "deletion"; /** Tracked change metadata */
+  info: TrackedChangeInfo; /** Deleted content */
+  content: (Run | Hyperlink)[];
+};
+/**
+ * Move-from wrapper (w:moveFrom) — content moved away from this position
+ */
+type MoveFrom = {
+  type: "moveFrom"; /** Tracked change metadata */
+  info: TrackedChangeInfo; /** Moved content */
+  content: (Run | Hyperlink)[];
+};
+/**
+ * Move-to wrapper (w:moveTo) — content moved into this position
+ */
+type 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.
+ */
+type MoveFromRangeStart = {
+  type: "moveFromRangeStart";
+  id: number;
+  name: string;
+};
+/**
+ * Move-from range end marker (w:moveFromRangeEnd)
+ */
+type 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.
+ */
+type MoveToRangeStart = {
+  type: "moveToRangeStart";
+  id: number;
+  name: string;
+};
+/**
+ * Move-to range end marker (w:moveToRangeEnd)
+ */
+type MoveToRangeEnd = {
+  type: "moveToRangeEnd";
+  id: number;
+};
+/**
+ * Run-level tracked wrappers represented in WordprocessingML.
+ */
+type TrackedRunChange = Insertion | Deletion | MoveFrom | MoveTo;
+/**
+ * Run property change (w:rPrChange)
+ */
+type 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)
+ */
+type 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)
+ */
+type 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)
+ */
+type 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)
+ */
+type 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;
+};
+/**
+ * Section property change (w:sectPrChange)
+ */
+type SectionPropertyChange = {
+  type: "sectionPropertyChange"; /** Tracked change metadata */
+  info: PropertyChangeInfo; /** Section properties before the tracked change */
+  previousProperties?: SectionProperties; /** Section properties after the tracked change (editor model convenience) */
+  currentProperties?: SectionProperties;
+};
+/**
+ * Table structural tracked change metadata (row/cell insert/delete/merge)
+ */
+type 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`).
+ *
+ * Modeled fields are a read-only projection for downstream tooling
+ * (tag/alias addressing, template extraction). They are NOT the
+ * serialization source: the original `<w:sdtPr>` is captured verbatim in
+ * `rawPropertiesXml` and replayed on save, which preserves element order
+ * (`CT_SdtPr` is an `xsd:sequence`), avoids double-emission, and keeps
+ * unmodeled features (`w:dataBinding`, `w15:repeatingSection`, `@lastValue`,
+ * `w:sdtEndPr`) lossless.
+ */
+type SdtProperties = {
+  /** SDT type (projection; round-trip uses `rawPropertiesXml`). */sdtType: SdtType; /** Numeric id (`w:id/@w:val`). */
+  id?: number; /** Alias (friendly name, `w:alias`). */
+  alias?: string; /** Tag (developer identifier, `w:tag`). */
+  tag?: string; /** Lock setting (`w:lock`). */
+  lock?: "sdtLocked" | "contentLocked" | "sdtContentLocked" | "unlocked";
+  /**
+   * Placeholder building-block name (`w:placeholder/w:docPart@w:val`) — a
+   * reference to a glossary docPart, not the literal placeholder text.
+   */
+  placeholder?: string; /** Whether the placeholder is currently shown (`w:showingPlcHdr`). */
+  showingPlaceholder?: boolean; /** Date display format (`w:date/w:dateFormat@w:val`). */
+  dateFormat?: string;
+  /**
+   * Bound date value (`w:date/@w:fullDate`), ISO 8601. Independent of
+   * `dateFormat` (which controls display): the body text may show a
+   * formatted version like "2 June 2026" while this stays as
+   * `2026-06-02T00:00:00Z` so Word's date binding round-trips losslessly.
+   */
+  dateValueISO?: string; /** Dropdown/combobox list items. */
+  listItems?: {
+    displayText: string;
+    value: string;
+  }[];
+  /**
+   * Selected dropdown / comboBox value (`w:dropDownList@w:lastValue`).
+   * Persisted as the OOXML value, independent of the body display text.
+   * Without this, the serializer had to recover the saved value by
+   * matching the body's display text against `listItems`, which picked
+   * the wrong entry when two items shared a `displayText`.
+   */
+  dropdownLastValue?: string; /** Checkbox checked state (`w14:checkbox/w14:checked`). */
+  checked?: boolean;
+  /**
+   * Verbatim `<w:sdtPr>…</w:sdtPr>` captured at parse time. Replayed on
+   * serialize so unmodeled OOXML features (data binding, repeating sections,
+   * `@lastValue`, custom XML mappings) survive round-trip.
+   */
+  rawPropertiesXml?: string; /** Verbatim `<w:sdtEndPr>…</w:sdtEndPr>` captured at parse time. */
+  rawEndPropertiesXml?: string;
+  /**
+   * Verbatim XML for any non-content direct children of `<w:sdt>` that
+   * appear BEFORE `<w:sdtContent>` — MS-OE376 §2.5.2.30 documents 16
+   * range-marker elements Word emits as direct sdt siblings (bookmark,
+   * comment range, custom XML range, tracked-change range). Captured at
+   * parse time and replayed on serialize so comment threads or tracked
+   * changes that span an SDT boundary round-trip without losing a
+   * delimiter.
+   */
+  rawSdtChildrenBeforeContent?: string; /** Verbatim XML for non-content sdt children that appear AFTER `<w:sdtContent>`. */
+  rawSdtChildrenAfterContent?: string;
+};
+/**
+ * Inline SDT (content control within a paragraph).
+ *
+ * OOXML allows runs, hyperlinks, simple/complex fields, nested SDTs,
+ * and math at this level. All of them must survive parse → edit → save
+ * so docProps-bound fields and similar template content do not lose
+ * their wrapper on round-trip.
+ */
+type InlineSdt = {
+  type: "inlineSdt"; /** SDT properties */
+  properties: SdtProperties; /** Inline content held inside the control */
+  content: (Run | Hyperlink | SimpleField | ComplexField | InlineSdt | MathEquation)[];
+};
+/**
+ * Block-level SDT (content control wrapping paragraphs/tables).
+ *
+ * Content is `BlockContent[]` (not just `(Paragraph | Table)[]`) because
+ * OOXML allows block SDTs to nest — e.g. a repeating-section control
+ * whose row is itself a content control.
+ */
+type BlockSdt = {
+  type: "blockSdt"; /** SDT properties (raw XML in `properties.rawPropertiesXml` round-trips losslessly). */
+  properties: SdtProperties; /** Block content inside the control. */
+  content: BlockContent[];
+};
+/**
+ * Paragraph content types
+ */
+type ParagraphContent = Run | Hyperlink | BookmarkStart | BookmarkEnd | SimpleField | ComplexField | InlineSdt | CommentRangeStart | CommentRangeEnd | CommentReference | Insertion | Deletion | MoveFrom | MoveTo | MoveFromRangeStart | MoveFromRangeEnd | MoveToRangeStart | MoveToRangeEnd | MathEquation;
+/**
+ * Paragraph (w:p)
+ */
+/**
+ * Paragraph-mark tracked-change marker (ECMA-376 §17.13.5).
+ *
+ * Word writes this as a child of `<w:pPr><w:rPr>` — `<w:ins/>` when the
+ * paragraph break itself was inserted in track-changes mode (the user
+ * pressed Enter mid-paragraph), `<w:del/>` when the paragraph break is
+ * pending deletion (Backspace at paragraph start or Delete at paragraph
+ * end). The mark is independent of the inline runs the paragraph carries.
+ */
+type ParagraphMarkChange = {
+  kind: "ins" | "del";
+  info: TrackedChangeInfo;
+};
+type 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-mark insertion / deletion (w:pPr / w:rPr / w:ins | w:del) */
+  pPrMark?: ParagraphMarkChange; /** 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;
+};
+/**
+ * Header/footer type
+ */
+type HeaderFooterType = "default" | "first" | "even";
+/**
+ * Header or footer reference
+ */
+type HeaderReference = {
+  type: HeaderFooterType;
+  rId: string;
+};
+type FooterReference = {
+  type: HeaderFooterType;
+  rId: string;
+};
+/**
+ * Header or footer content
+ */
+type HeaderFooter = {
+  type: "header" | "footer"; /** Header/footer type */
+  hdrFtrType: HeaderFooterType; /** Content (paragraphs, tables, block-level content controls). */
+  content: BlockContent[];
+  /**
+   * Document watermark detected in this header part. Word emits
+   * watermarks as VML or DrawingML behind-content shapes inside header
+   * parts; the body paragraph that contains them is empty otherwise.
+   * The modeled `Watermark` is exposed alongside `content` so callers
+   * can render and edit it without walking raw runs.
+   */
+  watermark?: Watermark;
+  /**
+   * Verbatim XML of the paragraph(s) containing the source watermark
+   * shape. Captured at parse time so an untouched DOCX serializes the
+   * watermark byte-exact even though `runParser` does not surface VML /
+   * DrawingML at the run level. Cleared (or rewritten) when callers
+   * mutate the modeled watermark via the headless API.
+   */
+  rawWatermarkXml?: string;
+  /**
+   * Index where the watermark paragraph sat among block-level siblings
+   * in the source header. The serializer inserts the watermark (raw or
+   * synthesized) at this position so a header that originally placed
+   * the watermark after visible text round-trips with the same flow.
+   * Undefined when no watermark was parsed or when callers built the
+   * watermark programmatically — in that case the serializer emits it
+   * at the top of the header (the same position Word's own UI uses).
+   */
+  watermarkBlockIndex?: number;
+};
+/**
+ * Document watermark (MS Word's behind-content page decoration).
+ */
+type Watermark = TextWatermark | PictureWatermark;
+type TextWatermark = {
+  kind: "text"; /** Visible string. Required. */
+  text: string; /** Font family. Word's default is Calibri. */
+  font?: string;
+  /**
+   * Hex color (`"C0C0C0"`), `"auto"`, or `undefined` for the producer
+   * default. Word emits `#C0C0C0` (light gray) for text watermarks.
+   */
+  color?: string;
+  /**
+   * `true` = diagonal (Word default, -45°), `false` = horizontal.
+   * Stored as a boolean since the only Word-supported rotations are
+   * -45 and 0.
+   */
+  diagonal?: boolean;
+  /**
+   * Opacity 0..1. Word's interactive UI exposes a "transparency"
+   * percentage; folio stores it as an opacity scalar for renderer
+   * convenience. Default ~0.5.
+   */
+  opacity?: number;
+};
+type PictureWatermark = {
+  kind: "picture"; /** Relationship id of the image part in `word/_rels/header*.xml.rels`. */
+  imageRId: string;
+  /**
+   * Stable identity of the image the `imageRId` resolved to in the header it
+   * was parsed from — an absolute package path for embedded media (e.g.
+   * `word/media/image1.png`) or the URL for a linked image (see
+   * {@link imageTargetExternal}). Relationship ids are scoped per header part
+   * and commonly repeat, so propagating a watermark across headers rebinds
+   * against this anchored target rather than the (ambiguous) source rId; each
+   * target header's relationship is written relative to its own part location.
+   */
+  imageTarget?: string;
+  /**
+   * When true, {@link imageTarget} is an external (linked) URL written back
+   * with `TargetMode="External"`, not an embedded package path.
+   */
+  imageTargetExternal?: boolean; /** Optional scale factor (1.0 = native, 0.5 = half-size). */
+  scale?: number;
+  /**
+   * Display width in points from the VML shape, captured at parse so the
+   * source aspect ratio survives a save that re-synthesizes the watermark
+   * (Word stretches the image to the shape box, so a non-2:1 box distorts a
+   * non-2:1 image). Absent for synthesized watermarks, which fall back to
+   * Word's default box scaled by `scale`.
+   */
+  widthPt?: number; /** Display height in points from the VML shape. See {@link widthPt}. */
+  heightPt?: number;
+  /**
+   * Whether Word's "washout" effect was applied (low contrast).
+   * Default true — Word emits washout=true on every picture
+   * watermark inserted via Insert → Watermark.
+   */
+  washout?: boolean;
+};
+/**
+ * Footnote position
+ */
+type FootnotePosition = "pageBottom" | "beneathText" | "sectEnd" | "docEnd";
+/**
+ * Endnote position
+ */
+type EndnotePosition = "sectEnd" | "docEnd";
+/**
+ * Number restart type
+ */
+type NoteNumberRestart = "continuous" | "eachSect" | "eachPage";
+/**
+ * Footnote properties
+ */
+type FootnoteProperties = {
+  position?: FootnotePosition;
+  numFmt?: NumberFormat;
+  numStart?: number;
+  numRestart?: NoteNumberRestart;
+};
+/**
+ * Endnote properties
+ */
+type EndnoteProperties = {
+  position?: EndnotePosition;
+  numFmt?: NumberFormat;
+  numStart?: number;
+  numRestart?: NoteNumberRestart;
+};
+/**
+ * Footnote (w:footnote)
+ */
+type Footnote = {
+  type: "footnote"; /** Footnote ID */
+  id: number; /** Special footnote type */
+  noteType?: "normal" | "separator" | "continuationSeparator" | "continuationNotice";
+  /**
+   * Content. Note bodies may carry block-level `<w:sdt>` content
+   * controls (citation slots, bound metadata fields) — preserved as
+   * `BlockSdt` so the rest of folio's SDT round-trip + mutate APIs
+   * work in notes the same as they do in the main body. Mirrors the
+   * shape upstream eigenpal/docx-editor#678 fixed for the same case.
+   */
+  content: (Paragraph | Table | BlockSdt)[];
+};
+/**
+ * Endnote (w:endnote)
+ */
+type Endnote = {
+  type: "endnote"; /** Endnote ID */
+  id: number; /** Special endnote type */
+  noteType?: "normal" | "separator" | "continuationSeparator" | "continuationNotice";
+  /**
+   * Content. Like `Footnote.content`, may carry block-level `<w:sdt>`
+   * preserved as `BlockSdt` so SDT round-trip works inside endnotes.
+   */
+  content: (Paragraph | Table | BlockSdt)[];
+};
+/**
+ * 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
+ */
+type Column = {
+  /** Column width in twips */width?: number; /** Space after column in twips */
+  space?: number;
+};
+/**
+ * Section properties (w:sectPr)
+ */
+type SectionTextDirection = "lrTb" | "tbRl" | "btLr" | "lrTbV" | "tbRlV" | "tbLrV" | "tb" | "rl" | "lr" | "tbV" | "rlV" | "lrV";
+type 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; /** Section text direction */
+  textDirection?: SectionTextDirection; /** 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 numbering settings */
+  pageNumbering?: {
+    format?: string;
+    start?: number;
+    chapterStyle?: number;
+    chapterSeparator?: string;
+  }; /** 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; /** Number of footnote columns in this section (`w15:footnoteColumns`) */
+  footnoteColumns?: number; /** 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; /** Protected forms in this section */
+  formProtection?: boolean; /** Suppress endnotes in this section */
+  noEndnote?: boolean; /** Use right-to-left gutter in this section */
+  rtlGutter?: boolean; /** Relationship id for printer settings */
+  printerSettingsRelationshipId?: string; /** Section-level tracked property changes (w:sectPrChange) */
+  propertyChanges?: SectionPropertyChange[];
+};
+/**
+ * Block-level content types
+ */
+type BlockContent = Paragraph | Table | BlockSdt;
+/**
+ * Section (implicit or explicit based on sectPr)
+ */
+type 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)
+ */
+type 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[];
+};
+//#endregion
+//#region src/model/styles.d.ts
+/**
+ * Style type
+ */
+type StyleType = "paragraph" | "character" | "numbering" | "table";
+/**
+ * Style definition
+ */
+type 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?: {
+    type: "band1Horz" | "band1Vert" | "band2Horz" | "band2Vert" | "firstCol" | "firstRow" | "lastCol" | "lastRow" | "neCell" | "nwCell" | "seCell" | "swCell" | "wholeTable";
+    pPr?: ParagraphFormatting;
+    rPr?: TextFormatting;
+    tblPr?: TableFormatting;
+    trPr?: TableRowFormatting;
+    tcPr?: TableCellFormatting;
+  }[];
+};
+/**
+ * Document defaults (w:docDefaults)
+ */
+type DocDefaults = {
+  /** Default run properties */rPr?: TextFormatting; /** Default paragraph properties */
+  pPr?: ParagraphFormatting;
+};
+/**
+ * Style definitions from styles.xml
+ */
+type 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)
+ */
+type 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)
+ */
+type 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)
+ */
+type ThemeFontScheme = {
+  /** Major font (headings) */majorFont?: ThemeFont; /** Minor font (body text) */
+  minorFont?: ThemeFont;
+};
+/**
+ * Theme (from theme1.xml)
+ */
+type 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
+ */
+type 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
+ */
+type FontTable = {
+  fonts: FontInfo[];
+};
+/**
+ * Relationship type
+ */
+type RelationshipType = string;
+/**
+ * Relationship entry
+ */
+type 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/
+ */
+type 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;
+};
+//#endregion
+//#region src/model/document.d.ts
+/**
+ * Document-wide settings parsed from `word/settings.xml`.
+ * Extend as more settings.xml fields enter the layout pipeline.
+ */
+type DocumentSettings = {
+  /**
+   * `w:defaultTabStop` (§17.6.13) — interval in twips between default
+   * tab stops applied when a paragraph has no custom `w:tabs`. Word
+   * defaults to 720 twips (½ inch) when absent.
+   */
+  defaultTabStop: number;
+  /**
+   * `w:evenAndOddHeaders` (§17.10.1) — when true, even pages use a distinct
+   * even header/footer. Word stores this in `settings.xml` (not `sectPr`), so
+   * it is a document-wide flag; absent means odd/even share one header.
+   */
+  evenAndOddHeaders?: boolean;
+  /**
+   * `w:themeFontLang` (§17.15.1.88) — language Word uses to fill empty
+   * `<a:ea>`/`<a:cs>` theme font slots from the script-specific
+   * `<a:font script="…">` entries. Absent for non-CJK/bidi docs.
+   */
+  themeFontLang?: {
+    eastAsia?: string;
+    bidi?: string;
+  };
+};
+/**
+ * Complete DOCX package structure
+ */
+type DocxPackage = {
+  /** Document body */document: DocumentBody; /** Document-wide settings (`word/settings.xml`). */
+  settings?: DocumentSettings; /** 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
+ */
+type Document = {
+  /** DOCX package with all parsed content */package: DocxPackage; /** Original ArrayBuffer for round-trip */
+  originalBuffer?: ArrayBuffer; /** Detected template variables ({{...}}) */
+  templateVariables?: string[]; /** Font families referenced in the document (extracted during parsing for deferred loading) */
+  requiredFonts?: string[]; /** Parsing warnings/errors */
+  warnings?: string[];
+};
+//#endregion
+export { InlineSdt as $, AbstractNumbering as $t, DocumentBody as A, ShadingProperties as An, ShapeContent as At, FootnotePosition as B, TableCell as Bt, Column as C, TableWidthType as Cn, SdtProperties as Ct, CommentReference as D, BorderSpec as Dn, SectionPropertyChange as Dt, CommentRangeStart as E, UnderlineStyle as En, SectionProperties as Et, Field as F, SimpleField as Ft, Hyperlink as G, TableStructuralChangeInfo as Gt, HeaderFooter as H, TablePropertyChange as Ht, FieldCharContent as I, SoftHyphenContent as It, ImagePadding as J, TextWatermark as Jt, Image as K, TextBox as Kt, FieldType as L, SymbolContent as Lt, Endnote as M, ShapeOutline as Mt, EndnotePosition as N, ShapeTextBody as Nt, ComplexField as O, ColorValue as On, SectionStart as Ot, EndnoteProperties as P, ShapeType as Pt, ImageWrap as Q, Watermark as Qt, FooterReference as R, TabContent as Rt, BreakContent as S, TableRowFormatting as Sn, RunPropertyChange as St, CommentRangeEnd as T, TextFormatting as Tn, Section as Tt, HeaderFooterType as U, TableRow as Ut, FootnoteProperties as V, TableCellPropertyChange as Vt, HeaderReference as W, TableRowPropertyChange as Wt, ImageSize as X, TrackedRunChange as Xt, ImagePosition as Y, TrackedChangeInfo as Yt, ImageTransform as Z, VerticalAlign as Zt, ThemeFontScheme as _, TableBorders as _n, ParagraphPropertyChange as _t, FontInfo as a, NumberingInstance as an, MoveFromRangeEnd as at, BookmarkEnd as b, TableLook as bn, Run as bt, Relationship as c, EmphasisMark as cn, MoveToRangeEnd as ct, Style as d, ParagraphAlignment as dn, NoteNumberRestart as dt, LevelSuffix as en, Insertion as et, StyleDefinitions as f, ParagraphFormatting as fn, NoteReferenceContent as ft, ThemeFont as g, TabStopAlignment as gn, ParagraphMarkChange as gt, ThemeColorScheme as h, TabStop as hn, ParagraphContent as ht, DocDefaults as i, NumberingDefinitions as in, MoveFrom as it, DrawingContent as j, ThemeColorSlot as jn, ShapeFill as jt, Deletion as k, KnownBorderStyle as kn, Shape as kt, RelationshipMap as l, FloatingTableProperties as ln, MoveToRangeStart as lt, Theme as m, TabLeader as mn, Paragraph as mt, DocumentSettings as n, ListRendering as nn, LineNumberRestart as nt, FontTable as o, CellMargins as on, MoveFromRangeStart as ot, StyleType as p, SpacingExplicit as pn, PageOrientation as pt, ImageCrop as q, TextContent as qt, DocxPackage as r, NumberFormat as rn, MathEquation as rt, MediaFile as s, ConditionalFormatStyle as sn, MoveTo as st, Document as t, ListLevel as tn, InstrTextContent as tt, RelationshipType as u, LineSpacingRule as un, NoBreakHyphenContent as ut, BlockContent as v, TableCellFormatting as vn, PictureWatermark as vt, Comment as w, TextEffect as wn, SdtType as wt, BookmarkStart as x, TableMeasurement as xn, RunContent as xt, BlockSdt as y, TableFormatting as yn, PropertyChangeInfo as yt, Footnote as z, Table as zt };