@betteroffice/docx 0.0.3 → 0.1.0

package/dist/{content-MOZ6hKP4.d.mts → content-DrqzbIr7.d.mts}

@@ -1,399 +1,213 @@
-import { C as ColorValue, P as ParagraphFormatting, a as TextFormatting, b as TableFormatting, c as TableRowFormatting, d as TableCellFormatting, B as BorderSpec, f as ThemeColorSlot } from './formatting-D1EPSaJP.mjs';
+import { C as ColorValue, y as ThemeColorSlot, a as ParagraphFormatting, b as TextFormatting, c as TableFormatting, d as TableRowFormatting, e as TableCellFormatting, B as BorderSpec, m as ShapeType, k as ShapeFill, l as ShapeOutline, D as ShapeTextBody$1, P as PresetGeometryPathCommand } from './formatting-BqrFPeev.mjs';
 import { WrapType } from './docx/wrapTypes.mjs';
 
-/**
- * DrawingML shape primitives — preset shape types, fill/outline/text-body
- * types, and the pure a:-namespace parsers for gradients, line ends,
- * transforms (a:xfrm), and preset geometry.
- */
-
-/**
- * Shape types
- *
- * @public
- */
-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
- *
- * @public
- */
-interface ShapeFill {
-    type: 'none' | 'solid' | 'gradient' | 'pattern' | 'picture';
-    /** Solid fill color */
+interface ShapeFillPaint {
+    kind?: 'none' | 'solid' | 'gradient' | 'pattern' | 'picture' | 'theme';
     color?: ColorValue;
-    /** Gradient stops for gradient fill */
-    gradient?: {
-        type: 'linear' | 'radial' | 'rectangular' | 'path';
-        angle?: number;
-        stops: Array<{
-            position: number;
-            color: ColorValue;
-        }>;
+    themeColor?: ThemeColorSlot;
+    gradientType?: 'linear' | 'path' | 'radial' | 'rectangular';
+    angle?: number;
+    stops?: Array<{
+        position?: number;
+        color?: ColorValue;
+    }>;
+    pathShape?: 'circle' | 'rect' | 'shape';
+    focusRect?: {
+        left?: number;
+        top?: number;
+        right?: number;
+        bottom?: number;
+    };
+    rotateWithShape?: boolean;
+    patternPreset?: string;
+    foregroundColor?: ColorValue;
+    backgroundColor?: ColorValue;
+    picture?: Image;
+    themeRefIndex?: number;
+    srcRect?: {
+        left?: number;
+        top?: number;
+        right?: number;
+        bottom?: number;
+    };
+    fillMode?: 'stretch' | 'tile';
+    tile?: {
+        offsetX?: number;
+        offsetY?: number;
+        scaleX?: number;
+        scaleY?: number;
+        alignment?: string;
+        flip?: 'none' | 'x' | 'y' | 'xy';
+    };
+    stretchRect?: {
+        left?: number;
+        top?: number;
+        right?: number;
+        bottom?: number;
     };
+    pictureOpacity?: number;
 }
-/**
- * Shape outline/stroke
- *
- * @public
- */
-interface ShapeOutline {
-    /** Line width in EMUs */
+interface ShapeStrokePaint {
+    fill?: ShapeFillPaint;
     width?: number;
-    /** Line color */
-    color?: ColorValue;
-    /** Line style */
-    style?: 'solid' | 'dot' | 'dash' | 'lgDash' | 'dashDot' | 'lgDashDot' | 'lgDashDotDot' | 'sysDot' | 'sysDash' | 'sysDashDot' | 'sysDashDotDot';
-    /** Line cap */
+    dash?: string;
+    customDash?: number[];
+    compound?: 'single' | 'double' | 'thickThin' | 'thinThick' | 'triple';
+    alignment?: 'center' | 'inset';
     cap?: 'flat' | 'round' | 'square';
-    /** Line join */
     join?: 'bevel' | 'miter' | 'round';
-    /** Head arrow */
+    miterLimit?: number;
     headEnd?: {
-        type: 'none' | 'triangle' | 'stealth' | 'diamond' | 'oval' | 'arrow';
-        width?: 'sm' | 'med' | 'lg';
-        length?: 'sm' | 'med' | 'lg';
+        type?: string;
+        width?: string;
+        length?: string;
     };
-    /** Tail arrow */
     tailEnd?: {
-        type: 'none' | 'triangle' | 'stealth' | 'diamond' | 'oval' | 'arrow';
-        width?: 'sm' | 'med' | 'lg';
-        length?: 'sm' | 'med' | 'lg';
+        type?: string;
+        width?: string;
+        length?: string;
     };
+    themeRefIndex?: number;
 }
-/**
- * Text body inside a shape.
- *
- * `TContent` is the host's paragraph/content type — DrawingML itself does
- * not prescribe what a paragraph looks like (docx uses `w:p`, pptx `a:p`).
- *
- * @public
- */
-interface ShapeTextBody$1<TContent = unknown> {
-    /** Text direction */
-    vertical?: boolean;
-    /** Rotation */
+interface ShapeEffect {
+    kind?: 'shadow' | 'glow' | 'reflection' | 'softEdge' | 'blur' | 'unknown';
+    color?: ColorValue;
+    opacity?: number;
+    blurRadius?: number;
+    distance?: number;
+    direction?: number;
+    size?: number;
+    rawName?: string;
+}
+interface ShapeTextBodyProperties {
+    vertical?: 'horizontal' | 'vertical' | 'vertical270' | 'wordArtVertical' | 'eastAsianVertical' | 'mongolianVertical';
     rotation?: number;
-    /** Anchor/vertical alignment */
+    upright?: boolean;
     anchor?: 'top' | 'middle' | 'bottom' | 'distributed' | 'justified';
-    /** Anchor center */
     anchorCenter?: boolean;
-    /** Auto fit */
-    autoFit?: 'none' | 'normal' | 'shape';
-    /** Text margins */
+    columns?: number;
+    columnSpacing?: number;
+    wrap?: 'square' | 'none';
+    horizontalOverflow?: 'clip' | 'overflow';
+    verticalOverflow?: 'clip' | 'ellipsis' | 'overflow';
     margins?: {
         top?: number;
         bottom?: number;
         left?: number;
         right?: number;
     };
-    /** Paragraphs inside the shape */
-    content: TContent[];
+    autoFit?: 'none' | 'normal' | 'shape';
+    fontScale?: number;
+    lineSpacingReduction?: number;
+    fromWordArt?: boolean;
+    presetTextWarp?: string;
+}
+interface DrawingSceneNode {
+    kind?: 'shape' | 'group' | 'canvas' | 'picture' | 'chart' | 'graphicFrame' | 'contentPart';
+    id?: string;
+    name?: string;
+    shape?: Shape;
+    image?: Image;
+    chart?: Chart;
+    children?: DrawingSceneNode[];
+    transform?: {
+        offsetX?: number;
+        offsetY?: number;
+        width?: number;
+        height?: number;
+        childOffsetX?: number;
+        childOffsetY?: number;
+        childWidth?: number;
+        childHeight?: number;
+        rotation?: number;
+        flipH?: boolean;
+        flipV?: boolean;
+    };
+    fill?: ShapeFillPaint;
+    effects?: ShapeEffect[];
+    relationshipId?: string;
+}
+interface DrawingScene {
+    version?: number;
+    root?: DrawingSceneNode;
+    title?: string;
+    description?: string;
+    decorative?: boolean;
+    hidden?: boolean;
 }
-/**
- * Normalized DrawingML preset-geometry path command.
- *
- * Coordinates are shape-local fractions in the `[0, 1]` box. Consumers scale
- * `x/y` and control points by the shape's resolved width/height.
- *
- * @public
- */
-type PresetGeometryPathCommand = {
-    type: 'move';
-    x: number;
-    y: number;
-} | {
-    type: 'line';
-    x: number;
-    y: number;
-} | {
-    type: 'quad';
-    cpx: number;
-    cpy: number;
-    x: number;
-    y: number;
-} | {
-    type: 'cubic';
-    cp1x: number;
-    cp1y: number;
-    cp2x: number;
-    cp2y: number;
-    x: number;
-    y: number;
-} | {
-    type: 'close';
-};
 
 /**
- * Embedded images (`w:drawing` → `pic:pic`): size, wrap, position,
- * transform, padding, crop.
+ * Lists & Numbering Types
+ *
+ * Types for bullet lists, numbered lists, and numbering definitions.
  */
 
-/** One point in a `wp:wrapPolygon`, in the drawing's authored coordinates. */
-interface ImageWrapPoint {
-    x?: number;
-    y?: number;
-}
 /**
- * Image size specification
+ * Number format type
  */
-interface ImageSize {
-    /** Width in EMUs (English Metric Units) */
-    width: number;
-    /** Height in EMUs */
-    height: number;
-}
+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';
 /**
- * Image wrap type for floating images
+ * Multi-level suffix (what follows the number)
  */
-interface ImageWrap {
-    type: WrapType;
-    /** Wrap text direction */
-    wrapText?: 'bothSides' | 'left' | 'right' | 'largest';
-    /** Distance from text */
-    distT?: number;
-    distB?: number;
-    distL?: number;
-    distR?: number;
-    /** Tight/through contour. Undefined = rectangular wrap. */
-    polygon?: ImageWrapPoint[];
-}
+type LevelSuffix = 'tab' | 'space' | 'nothing';
 /**
- * Position for floating images
+ * One indentation level of an abstract numbering definition (`w:lvl`).
+ * Carries the number format, the marker template (`lvlText` — e.g.
+ * `"%1.%2."`), the level's paragraph properties (indent, hanging) and
+ * character properties (font, size, color for the marker itself).
+ *
+ * `ilvl` ranges 0-8 in standard Word documents.
  */
-interface ImagePosition {
-    /** Use `wp:simplePos` instead of positionH/V. Undefined = false. */
-    useSimplePos?: boolean;
-    /** `wp:simplePos` coordinates in EMUs. */
-    simplePos?: {
-        x?: number;
-        y?: number;
-    };
-    /** Stable z-order (`wp:anchor/@relativeHeight`). Undefined = source order. */
-    relativeHeight?: number;
-    /** Behind-text plane (`wp:anchor/@behindDoc`). Undefined = false. */
-    behindDoc?: boolean;
-    /** Hidden drawing. Undefined = visible. */
-    hidden?: boolean;
-    /** Locked drawing metadata. Undefined = editable. */
-    locked?: boolean;
-    /** 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;
+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;
     };
 }
 /**
- * Image transformation
+ * Abstract numbering definition (`w:abstractNum`) — the reusable template
+ * for a list: which `NumberFormat` at each indentation level, what
+ * marker text, what paragraph/character formatting. Multiple
+ * `NumberingInstance`s (`w:num`) can reference one abstract numbering
+ * to share the template while keeping independent counters.
+ *
+ * See ECMA-376 §17.9.
  */
-interface ImageTransform {
-    /** Rotation in degrees */
-    rotation?: number;
-    /** Flip horizontal */
-    flipH?: boolean;
-    /** Flip vertical */
-    flipV?: boolean;
-}
-/** Post-transform layout footprint, kept separate from the content frame. */
-interface ImageRotationBounds {
-    width?: number;
-    height?: number;
-    offsetX?: number;
-    offsetY?: number;
-}
-/** One ordered DrawingML blip effect. Unknown effects stay named and inert. */
-interface ImageEffect {
-    kind?: 'brightnessContrast' | 'saturation' | 'grayscale' | 'biLevel' | 'colorChange' | 'duotone' | 'alpha' | 'blur' | 'unknown';
-    amount?: number;
-    threshold?: number;
-    colors?: string[];
-    rawName?: string;
-}
-/** Safe hyperlink metadata attached to picture non-visual properties. */
-interface ImageHyperlink {
-    href?: string;
-    tooltip?: string;
-    target?: string;
-    history?: boolean;
-    docLocation?: string;
-}
-/**
- * Image padding/margins
- */
-interface ImagePadding {
-    top?: number;
-    bottom?: number;
-    left?: number;
-    right?: number;
-}
-/**
- * Image crop, expressed as fractions of the source image to trim from each
- * edge. OOXML's `<a:srcRect l="10000" t="0" r="5000" b="0"/>` uses units of
- * 1/100000 (so 10000 → 0.1 → 10% trimmed from the left). We store the
- * normalised fraction so both the renderer and the saver can read it
- * directly without re-parsing units.
- */
-interface ImageCrop {
-    left?: number;
-    top?: number;
-    right?: number;
-    bottom?: number;
-}
-/**
- * Embedded image (`w:drawing` with an inline or anchored picture). Carries
- * the relationship-id pointer to the binary in `word/media/`, its
- * resolved data URL (`src`), display dimensions, optional crop /
- * transform / wrap behaviors, and anchor positioning for floating
- * images.
- *
- * See ECMA-376 §20.4 (DrawingML wordprocessingDrawing).
- */
-interface Image {
-    type: 'image';
-    /** Unique ID */
-    id?: string;
-    /** Relationship ID for the image data */
-    rId: string;
-    /** Resolved image data (base64 or blob URL) */
-    src?: string;
-    /** Image MIME type */
-    mimeType?: string;
-    /** Original filename */
-    filename?: string;
-    /** Alt text for accessibility */
-    alt?: string;
-    /** Title/description */
-    title?: string;
-    /** Image size */
-    size: ImageSize;
-    /** Original size before any transforms */
-    originalSize?: ImageSize;
-    /** Wrap settings */
-    wrap: ImageWrap;
-    /** Position for floating images */
-    position?: ImagePosition;
-    /** Image transformations */
-    transform?: ImageTransform;
-    /** Padding around image */
-    padding?: ImagePadding;
-    /** Source-image crop (fractional, OOXML `a:srcRect`). */
-    crop?: ImageCrop;
-    /** Opacity in [0, 1] (OOXML `a:alphaModFix amt`). Undefined = fully opaque. */
-    opacity?: number;
-    /** Whether this is a decorative image */
-    decorative?: boolean;
-    /**
-     * `wp:anchor layoutInCell` — when true (default), an anchored image inside
-     * a table cell is constrained to the cell. When false, the image escapes
-     * the cell into the page area. Round-tripped on save.
-     */
-    layoutInCell?: boolean;
-    /**
-     * `wp:anchor allowOverlap` — when true (default), anchored objects may
-     * overlap; when false, Word repositions them to avoid collisions. We
-     * don't currently reposition; we round-trip the flag so saving preserves
-     * the author's intent.
-     */
-    allowOverlap?: boolean;
-    /** Hyperlink URL for clickable image */
-    hlinkHref?: string;
-    /** Image outline/border */
-    outline?: ShapeOutline;
-    /** Image effects */
-    effects?: {
-        brightness?: number;
-        contrast?: number;
-        saturation?: number;
-        /** Ordered blip-effect list. Undefined = legacy scalar effects only. */
-        ordered?: ImageEffect[];
-    };
-    /** Rotated layout bbox. Undefined = use untransformed `size`. */
-    rotationBounds?: ImageRotationBounds;
-    /** Complete picture hyperlink metadata. Undefined = use `hlinkHref`. */
-    hyperlink?: ImageHyperlink;
-    /** Effect extents in EMUs. Undefined = no extra wrap/ink extent. */
-    effectExtent?: ImagePadding;
-}
-
-/**
- * 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' | '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';
-/**
- * One indentation level of an abstract numbering definition (`w:lvl`).
- * Carries the number format, the marker template (`lvlText` — e.g.
- * `"%1.%2."`), the level's paragraph properties (indent, hanging) and
- * character properties (font, size, color for the marker itself).
- *
- * `ilvl` ranges 0-8 in standard Word documents.
- */
-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`) — the reusable template
- * for a list: which `NumberFormat` at each indentation level, what
- * marker text, what paragraph/character formatting. Multiple
- * `NumberingInstance`s (`w:num`) can reference one abstract numbering
- * to share the template while keeping independent counters.
- *
- * See ECMA-376 §17.9.
- */
-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 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)
@@ -468,153 +282,42 @@ interface NumberingDefinitions {
 }
 
 /**
- * DrawingML chart model for basic rendered charts.
- *
- * This is intentionally normalized for display rather than lossless OOXML
- * round-trip. Unsupported chart families stay in the original package parts.
+ * Math equations (`m:oMath`, `m:oMathPara`). OMML XML is round-tripped
+ * verbatim to preserve fidelity Word/Pages/Docs can disagree on.
  */
+/**
+ * Math equation content (m:oMath or m:oMathPara)
+ */
+interface MathEquation {
+    type: 'mathEquation';
+    /** Whether this is a block (oMathPara) or inline (oMath) equation */
+    display: 'inline' | 'block';
+    /** Raw OMML XML for round-trip preservation */
+    ommlXml: string;
+    /** Plain text representation for accessibility/fallback */
+    plainText?: string;
+}
 
-type ChartType = 'bar' | 'column' | 'line' | 'pie' | 'doughnut';
-type ChartGrouping = 'standard' | 'clustered' | 'stacked' | 'percentStacked';
-interface ChartPoint {
-    index?: number;
-    value?: number;
-    category?: string;
-    color?: string;
-    explosion?: number;
-    marker?: {
-        symbol?: string;
-        size?: number;
-        color?: string;
-    };
-    label?: string;
-}
-interface ChartSeries {
-    name?: string;
-    categories: string[];
-    values: number[];
-    color?: string;
-    index?: number;
-    order?: number;
-    categoryFormula?: string;
-    valueFormula?: string;
-    axisIds?: string[];
-    points?: ChartPoint[];
-    grouping?: ChartGrouping;
-    marker?: {
-        symbol?: string;
-        size?: number;
-        color?: string;
-    };
-    smooth?: boolean;
-}
-interface ChartAxis {
-    id?: string;
-    title?: string;
-    min?: number;
-    max?: number;
-    labels?: string[];
-    axisType?: 'category' | 'value' | 'date' | 'series';
-    position?: 'left' | 'right' | 'top' | 'bottom';
-    crossAxisId?: string;
-    crosses?: 'autoZero' | 'min' | 'max' | 'value';
-    crossesAt?: number;
-    majorUnit?: number;
-    minorUnit?: number;
-    logarithmicBase?: number;
-    reversed?: boolean;
-    numberFormat?: string;
-    majorTickMark?: string;
-    minorTickMark?: string;
-    tickLabelPosition?: string;
-    hidden?: boolean;
-}
-/** One chart-family element inside `c:plotArea`. */
-interface ChartPlotGroup {
-    chartType?: ChartType | 'area' | 'scatter' | 'radar' | 'stock' | 'bubble' | 'ofPie' | 'surface';
-    grouping?: ChartGrouping;
-    overlap?: number;
-    gapWidth?: number;
-    axisIds?: string[];
-    series?: ChartSeries[];
-    varyColors?: boolean;
-    firstSliceAngle?: number;
-    holeSize?: number;
-    showDataLabels?: boolean;
-}
-interface ChartLegend {
-    position?: 'left' | 'right' | 'top' | 'bottom';
-    visible?: boolean;
-}
-interface Chart {
-    type: 'chart';
-    chartType: ChartType;
-    /** Relationship id used by the owning drawing part. */
-    rId?: string;
-    /** Normalized package path, e.g. word/charts/chart1.xml. */
-    path?: string;
-    title?: string;
-    legend?: ChartLegend;
-    series: ChartSeries[];
-    axes?: {
-        category?: ChartAxis;
-        value?: ChartAxis;
-    };
-    /** Drawing extent from wp:extent in EMUs. */
-    size?: ImageSize;
-    /** Wrap metadata from the containing drawing; v1 layout treats charts as inline blocks. */
-    wrap?: ImageWrap;
-    /** Floating anchor. Undefined = inline legacy behavior. */
-    position?: ImagePosition;
-    /** Multiple/combo plot groups. Undefined = synthesize one from legacy fields. */
-    plotGroups?: ChartPlotGroup[];
-    /** Complete axis collection keyed through plot-group `axisIds`. */
-    axisList?: ChartAxis[];
-    /** Chart accessibility description. */
-    description?: string;
-    /** Decorative flag. Undefined = false. */
-    decorative?: boolean;
-    /** Stable z-order for anchored charts. Undefined = source order. */
-    relativeHeight?: number;
-}
-
-/**
- * Math equations (`m:oMath`, `m:oMathPara`). OMML XML is round-tripped
- * verbatim to preserve fidelity Word/Pages/Docs can disagree on.
- */
-/**
- * Math equation content (m:oMath or m:oMathPara)
- */
-interface MathEquation {
-    type: 'mathEquation';
-    /** Whether this is a block (oMathPara) or inline (oMath) equation */
-    display: 'inline' | 'block';
-    /** Raw OMML XML for round-trip preservation */
-    ommlXml: string;
-    /** Plain text representation for accessibility/fallback */
-    plainText?: string;
-}
-
-/**
- * Tables (`w:tbl`), rows (`w:tr`), and cells (`w:tc`).
- */
-
-/**
- * Table cell (`w:tc`). Holds nested block content (paragraphs and nested
- * tables), cell-level formatting (borders, shading, vertical merge),
- * tracked property changes, and tracked structural changes for cell
- * insert/delete/merge operations.
- */
-interface TableCell {
-    type: 'tableCell';
-    /** Cell formatting */
-    formatting?: TableCellFormatting;
-    /** Cell-level tracked property changes (w:tcPrChange) */
-    propertyChanges?: TableCellPropertyChange[];
-    /** Tracked structural changes (cell insert/delete/merge) */
-    structuralChange?: TableStructuralChangeInfo;
-    /** Cell content (paragraphs, tables, etc.) */
-    content: (Paragraph | Table)[];
+/**
+ * Tables (`w:tbl`), rows (`w:tr`), and cells (`w:tc`).
+ */
+
+/**
+ * Table cell (`w:tc`). Holds nested block content (paragraphs and nested
+ * tables), cell-level formatting (borders, shading, vertical merge),
+ * tracked property changes, and tracked structural changes for cell
+ * insert/delete/merge operations.
+ */
+interface TableCell {
+    type: 'tableCell';
+    /** Cell formatting */
+    formatting?: TableCellFormatting;
+    /** Cell-level tracked property changes (w:tcPrChange) */
+    propertyChanges?: TableCellPropertyChange[];
+    /** Tracked structural changes (cell insert/delete/merge) */
+    structuralChange?: TableStructuralChangeInfo;
+    /** Cell content (paragraphs, tables, etc.) */
+    content: (Paragraph | Table)[];
 }
 /**
  * Table row (`w:tr`) — an ordered list of `TableCell` plus row-level
@@ -666,8 +369,8 @@ interface Table {
  *   file, scaled, optionally "washed out" (lightened).
  *
  * We model the watermark as a dedicated field on the owning `HeaderFooter`
- * rather than as editable run content, so it stays out of the ProseMirror text
- * flow while still round-tripping through parse → render → serialize.
+ * rather than as editable run content, so it stays out of the text flow while
+ * still round-tripping through parse → render → serialize.
  */
 /**
  * Text watermark (e.g. "CONFIDENTIAL", "DRAFT").
@@ -837,16 +540,7 @@ interface Footnote {
      * and stays editable on round-trip.
      */
     content: BlockContent[];
-    /**
-     * Verbatim original XML of the entire `<w:footnote>` element, captured at
-     * parse time ONLY when the note body carries a block-level construct the
-     * model still can't represent — note-level bookmarks
-     * (`w:bookmarkStart`/`w:bookmarkEnd`) or `w:customXml`. Block-level `w:sdt`
-     * is NOT a trigger: it round-trips through the model as `BlockSdt`. When
-     * present the serializer re-emits these bytes instead of rebuilding from
-     * `content`, restoring pre-#646 fidelity for the unmodeled constructs.
-     * See `parseNoteBlockContent` / `serializeNote` for the gate (#646 F3).
-     */
+    /** Verbatim note XML for unmodeled bookmarks or custom XML. */
     verbatimXml?: string;
 }
 /**
@@ -864,7 +558,7 @@ interface Endnote {
      * on `Footnote.content`.
      */
     content: BlockContent[];
-    /** Verbatim original XML — see `Footnote.verbatimXml` (#646 F3). */
+    /** Verbatim note XML for unmodeled blocks. */
     verbatimXml?: string;
 }
 
@@ -1509,9 +1203,9 @@ interface TrackedChangeInfo {
     date?: string;
 }
 /**
- * Tracked-change attribute triple as it appears on PM node attrs
+ * Tracked-change attribute triple as it appears on node attrs
  * (`paragraph.pPrIns`, `tableRow.trIns`, etc). Mirrors `TrackedChangeInfo`
- * but with a `null` date (PM attr defaults) and a `revisionId` name that
+ * but with a `null` date (attr defaults) and a `revisionId` name that
  * matches OOXML's `w:id` more idiomatically on the editor side.
  *
  * Round-trip pairs with `TrackedChangeInfo` via
@@ -1524,7 +1218,7 @@ interface RevisionInfo {
 }
 /**
  * Tracked-cell marker — the OOXML `<w:cellIns>` / `<w:cellDel>` /
- * `<w:cellMerge>` shape attached to a `TableCell` PM node and surfaced
+ * `<w:cellMerge>` shape attached to a `TableCell` node and surfaced
  * to the layout model and painter for visual rendering.
  *
  * `kind` matches the OOXML element name (ins / del / merge).
@@ -1958,151 +1652,6 @@ interface Paragraph {
  * Text body inside a shape (content typed as docx paragraphs)
  */
 type ShapeTextBody = ShapeTextBody$1<Paragraph>;
-/** Detailed DrawingML paint server retained alongside the legacy shared fill. */
-interface ShapeFillPaint {
-    kind?: 'none' | 'solid' | 'gradient' | 'pattern' | 'picture' | 'theme';
-    color?: ColorValue;
-    themeColor?: ThemeColorSlot;
-    gradientType?: 'linear' | 'path' | 'radial' | 'rectangular';
-    angle?: number;
-    stops?: Array<{
-        position?: number;
-        color?: ColorValue;
-    }>;
-    pathShape?: 'circle' | 'rect' | 'shape';
-    focusRect?: {
-        left?: number;
-        top?: number;
-        right?: number;
-        bottom?: number;
-    };
-    rotateWithShape?: boolean;
-    patternPreset?: string;
-    foregroundColor?: ColorValue;
-    backgroundColor?: ColorValue;
-    picture?: Image;
-    themeRefIndex?: number;
-    /** Picture-fill source crop fractions (`a:srcRect`, 0..1; negative = outset). */
-    srcRect?: {
-        left?: number;
-        top?: number;
-        right?: number;
-        bottom?: number;
-    };
-    /** Picture-fill mode: `a:stretch` (default) or `a:tile`. */
-    fillMode?: 'stretch' | 'tile';
-    /** Picture-fill tile parameters (`a:tile`). Offsets px, scales fractions. */
-    tile?: {
-        offsetX?: number;
-        offsetY?: number;
-        scaleX?: number;
-        scaleY?: number;
-        alignment?: string;
-        flip?: 'none' | 'x' | 'y' | 'xy';
-    };
-    /** Picture-fill stretch target rect fractions (`a:stretch/a:fillRect`, 0..1). */
-    stretchRect?: {
-        left?: number;
-        top?: number;
-        right?: number;
-        bottom?: number;
-    };
-    /** Picture-fill alpha 0..1 (`a:alphaModFix` on the blip). */
-    pictureOpacity?: number;
-}
-/** Detailed DrawingML line contract, including arrows and compound/custom dash. */
-interface ShapeStrokePaint {
-    fill?: ShapeFillPaint;
-    width?: number;
-    dash?: string;
-    customDash?: number[];
-    compound?: 'single' | 'double' | 'thickThin' | 'thinThick' | 'triple';
-    alignment?: 'center' | 'inset';
-    cap?: 'flat' | 'round' | 'square';
-    join?: 'bevel' | 'miter' | 'round';
-    miterLimit?: number;
-    headEnd?: {
-        type?: string;
-        width?: string;
-        length?: string;
-    };
-    tailEnd?: {
-        type?: string;
-        width?: string;
-        length?: string;
-    };
-    themeRefIndex?: number;
-}
-/** Common 2-D shape effect. Missing parameters mean the OOXML default. */
-interface ShapeEffect {
-    kind?: 'shadow' | 'glow' | 'reflection' | 'softEdge' | 'blur' | 'unknown';
-    color?: ColorValue;
-    opacity?: number;
-    blurRadius?: number;
-    distance?: number;
-    direction?: number;
-    size?: number;
-    rawName?: string;
-}
-/** Full `a:bodyPr` projection used by text-body/autofit layout. */
-interface ShapeTextBodyProperties {
-    vertical?: 'horizontal' | 'vertical' | 'vertical270' | 'wordArtVertical' | 'eastAsianVertical' | 'mongolianVertical';
-    rotation?: number;
-    upright?: boolean;
-    anchor?: 'top' | 'middle' | 'bottom' | 'distributed' | 'justified';
-    anchorCenter?: boolean;
-    columns?: number;
-    columnSpacing?: number;
-    wrap?: 'square' | 'none';
-    horizontalOverflow?: 'clip' | 'overflow';
-    verticalOverflow?: 'clip' | 'ellipsis' | 'overflow';
-    margins?: {
-        top?: number;
-        bottom?: number;
-        left?: number;
-        right?: number;
-    };
-    autoFit?: 'none' | 'normal' | 'shape';
-    fontScale?: number;
-    lineSpacingReduction?: number;
-    fromWordArt?: boolean;
-    presetTextWarp?: string;
-}
-/** Heterogeneous DrawingML group/canvas scene node. */
-interface DrawingSceneNode {
-    kind?: 'shape' | 'group' | 'canvas' | 'picture' | 'chart' | 'graphicFrame' | 'contentPart';
-    id?: string;
-    name?: string;
-    shape?: Shape;
-    image?: Image;
-    chart?: Chart;
-    children?: DrawingSceneNode[];
-    transform?: {
-        offsetX?: number;
-        offsetY?: number;
-        width?: number;
-        height?: number;
-        childOffsetX?: number;
-        childOffsetY?: number;
-        childWidth?: number;
-        childHeight?: number;
-        rotation?: number;
-        flipH?: boolean;
-        flipV?: boolean;
-    };
-    fill?: ShapeFillPaint;
-    effects?: ShapeEffect[];
-    relationshipId?: string;
-}
-/** Versioned general DrawingML scene. Undefined version reads as legacy v0. */
-interface DrawingScene {
-    version?: number;
-    root?: DrawingSceneNode;
-    title?: string;
-    description?: string;
-    decorative?: boolean;
-    hidden?: boolean;
-}
 /**
  * Shape/drawing object (wps:wsp)
  */
@@ -2199,4 +1748,371 @@ interface TextBox {
     bodyProperties?: ShapeTextBodyProperties;
 }
 
-export { type FieldType as $, type AbstractNumbering as A, type BlockContent as B, type CellMarker as C, type DrawingScene as D, type EndnoteProperties as E, type FootnoteProperties as F, type CommentAuthor as G, type HeaderFooter as H, type CommentRangeEnd as I, type CommentRangeStart as J, type CommentReferenceContent as K, type ComplexField as L, type ContentPosition as M, type NoteKind as N, DEFAULT_WATERMARK_PRESETS as O, type PresetGeometryPathCommand as P, type Deletion as Q, type RevisionInfo as R, type SectionProperties as S, type DrawingContent as T, type DrawingSceneNode as U, type EndnotePosition as V, type Watermark as W, type Field as X, type FieldCharContent as Y, type FieldFormData as Z, type FieldInlineContent as _, type SdtControlState as a, type SimpleField as a$, type FooterReference as a0, type FootnotePosition as a1, type HeaderFooterType as a2, type HeaderReference as a3, type Hyperlink as a4, type HyperlinkContent as a5, type Image as a6, type ImageCrop as a7, type ImageEffect as a8, type ImageHyperlink as a9, type NumberFormat as aA, type NumberingInstance as aB, type PageNumberingProperties as aC, type PageOrientation as aD, type ParagraphContent as aE, type ParagraphPropertyChange as aF, type PictureWatermark as aG, type PropertyChangeInfo as aH, type Run as aI, type RunContent as aJ, type RunPropertyChange as aK, type SdtCheckboxGlyph as aL, type SdtDataBinding as aM, type SdtDateState as aN, type SdtGalleryState as aO, type SdtType as aP, type Section as aQ, type SectionStart as aR, type SeparatorContent as aS, type Shape as aT, type ShapeContent as aU, type ShapeFill as aV, type ShapeFillPaint as aW, type ShapeOutline as aX, type ShapeStrokePaint as aY, type ShapeTextBody as aZ, type ShapeType as a_, type ImagePadding as aa, type ImagePosition as ab, type ImageRotationBounds as ac, type ImageSize as ad, type ImageTransform as ae, type ImageWrap as af, type ImageWrapPoint as ag, type InlineSdt as ah, type Insertion as ai, type InstrTextContent as aj, type LevelSuffix as ak, type LineNumberRestart as al, type ListLevel as am, type ListRendering as an, type MathEquation as ao, type MoveFrom as ap, type MoveFromRangeEnd as aq, type MoveFromRangeStart as ar, type MoveTo as as, type MoveToRangeEnd as at, type MoveToRangeStart as au, type NoBreakHyphenContent as av, type NoteNumberRestart as aw, type NoteRefMarkContent as ax, type NoteReferenceContent as ay, type NoteSeparatorReference as az, type SdtProperties as b, type SoftHyphenContent as b0, type StructuredFieldContent as b1, type StructuredFieldTree as b2, type SymbolContent as b3, type TabContent as b4, type Table as b5, type TableCell as b6, type TableCellPropertyChange as b7, type TablePropertyChange as b8, type TableRow as b9, type TableRowPropertyChange as ba, type TableStructuralChangeInfo as bb, type TextBox as bc, type TextContent as bd, type TextWatermark as be, type TrackedChangeInfo as bf, type TrackedRunChange as bg, type VerticalAlign as bh, pictureWatermarkDisplayEmu as bi, type ShapeEffect as c, type ShapeTextBodyProperties as d, type Chart as e, type Paragraph as f, type Comment as g, type DocumentBody as h, type NumberingDefinitions as i, type Footnote as j, type Endnote as k, type BookmarkRange as l, type BlockSdt as m, type BookmarkEnd as n, type BookmarkStart as o, type BreakContent as p, type ChartAxis as q, type ChartContent as r, type ChartGrouping as s, type ChartLegend as t, type ChartPlotGroup as u, type ChartPoint as v, type ChartSeries as w, type ChartType as x, type Column as y, type CommentAnchorRange as z };
+/**
+ * Embedded images (`w:drawing` → `pic:pic`): size, wrap, position,
+ * transform, padding, crop.
+ */
+
+/** One point in a `wp:wrapPolygon`, in the drawing's authored coordinates. */
+interface ImageWrapPoint {
+    x?: number;
+    y?: number;
+}
+/**
+ * Image size specification
+ */
+interface ImageSize {
+    /** Width in EMUs (English Metric Units) */
+    width: number;
+    /** Height in EMUs */
+    height: number;
+}
+/**
+ * Image wrap type for floating images
+ */
+interface ImageWrap {
+    type: WrapType;
+    /** Wrap text direction */
+    wrapText?: 'bothSides' | 'left' | 'right' | 'largest';
+    /** Distance from text */
+    distT?: number;
+    distB?: number;
+    distL?: number;
+    distR?: number;
+    /** Tight/through contour. Undefined = rectangular wrap. */
+    polygon?: ImageWrapPoint[];
+}
+/**
+ * Position for floating images
+ */
+interface ImagePosition {
+    /** Use `wp:simplePos` instead of positionH/V. Undefined = false. */
+    useSimplePos?: boolean;
+    /** `wp:simplePos` coordinates in EMUs. */
+    simplePos?: {
+        x?: number;
+        y?: number;
+    };
+    /** Stable z-order (`wp:anchor/@relativeHeight`). Undefined = source order. */
+    relativeHeight?: number;
+    /** Behind-text plane (`wp:anchor/@behindDoc`). Undefined = false. */
+    behindDoc?: boolean;
+    /** Hidden drawing. Undefined = visible. */
+    hidden?: boolean;
+    /** Locked drawing metadata. Undefined = editable. */
+    locked?: boolean;
+    /** Horizontal positioning */
+    horizontal: {
+        relativeTo: 'character' | 'column' | 'insideMargin' | 'leftMargin' | 'margin' | 'outsideMargin' | 'page' | 'rightMargin';
+        alignment?: 'left' | 'right' | 'center' | 'inside' | 'outside';
+        posOffset?: number;
+    };
+    /** Vertical positioning */
+    vertical: {
+        relativeTo: 'insideMargin' | 'line' | 'margin' | 'outsideMargin' | 'page' | 'paragraph' | 'topMargin' | 'bottomMargin';
+        alignment?: 'top' | 'bottom' | 'center' | 'inside' | 'outside';
+        posOffset?: number;
+    };
+}
+/**
+ * Image transformation
+ */
+interface ImageTransform {
+    /** Rotation in degrees */
+    rotation?: number;
+    /** Flip horizontal */
+    flipH?: boolean;
+    /** Flip vertical */
+    flipV?: boolean;
+}
+/** Post-transform layout footprint, kept separate from the content frame. */
+interface ImageRotationBounds {
+    width?: number;
+    height?: number;
+    offsetX?: number;
+    offsetY?: number;
+}
+/** One ordered DrawingML blip effect. Unknown effects stay named and inert. */
+interface ImageEffect {
+    kind?: 'brightnessContrast' | 'saturation' | 'grayscale' | 'biLevel' | 'colorChange' | 'duotone' | 'alpha' | 'blur' | 'unknown';
+    amount?: number;
+    threshold?: number;
+    colors?: string[];
+    rawName?: string;
+}
+/** Safe hyperlink metadata attached to picture non-visual properties. */
+interface ImageHyperlink {
+    href?: string;
+    tooltip?: string;
+    target?: string;
+    history?: boolean;
+    docLocation?: string;
+}
+/**
+ * Image padding/margins
+ */
+interface ImagePadding {
+    top?: number;
+    bottom?: number;
+    left?: number;
+    right?: number;
+}
+/**
+ * Image crop, expressed as fractions of the source image to trim from each
+ * edge. OOXML's `<a:srcRect l="10000" t="0" r="5000" b="0"/>` uses units of
+ * 1/100000 (so 10000 → 0.1 → 10% trimmed from the left). We store the
+ * normalised fraction so both the renderer and the saver can read it
+ * directly without re-parsing units.
+ */
+interface ImageCrop {
+    left?: number;
+    top?: number;
+    right?: number;
+    bottom?: number;
+}
+/**
+ * Embedded image (`w:drawing` with an inline or anchored picture). Carries
+ * the relationship-id pointer to the binary in `word/media/`, its
+ * resolved data URL (`src`), display dimensions, optional crop /
+ * transform / wrap behaviors, and anchor positioning for floating
+ * images.
+ *
+ * See ECMA-376 §20.4 (DrawingML wordprocessingDrawing).
+ */
+interface Image {
+    type: 'image';
+    /** Unique ID */
+    id?: string;
+    /** Relationship ID for the image data */
+    rId: string;
+    /** Resolved image data (base64 or blob URL) */
+    src?: string;
+    /** Image MIME type */
+    mimeType?: string;
+    /** Original filename */
+    filename?: string;
+    /** Alt text for accessibility */
+    alt?: string;
+    /** Title/description */
+    title?: string;
+    /** Image size */
+    size: ImageSize;
+    /** Original size before any transforms */
+    originalSize?: ImageSize;
+    /** Wrap settings */
+    wrap: ImageWrap;
+    /** Position for floating images */
+    position?: ImagePosition;
+    /** Image transformations */
+    transform?: ImageTransform;
+    /** Padding around image */
+    padding?: ImagePadding;
+    /** Source-image crop (fractional, OOXML `a:srcRect`). */
+    crop?: ImageCrop;
+    /** Opacity in [0, 1] (OOXML `a:alphaModFix amt`). Undefined = fully opaque. */
+    opacity?: number;
+    /** Whether this is a decorative image */
+    decorative?: boolean;
+    /**
+     * `wp:anchor layoutInCell` — when true (default), an anchored image inside
+     * a table cell is constrained to the cell. When false, the image escapes
+     * the cell into the page area. Round-tripped on save.
+     */
+    layoutInCell?: boolean;
+    /**
+     * `wp:anchor allowOverlap` — when true (default), anchored objects may
+     * overlap; when false, Word repositions them to avoid collisions. We
+     * don't currently reposition; we round-trip the flag so saving preserves
+     * the author's intent.
+     */
+    allowOverlap?: boolean;
+    /** Hyperlink URL for clickable image */
+    hlinkHref?: string;
+    /** Image outline/border */
+    outline?: ShapeOutline;
+    /** Image effects */
+    effects?: {
+        brightness?: number;
+        contrast?: number;
+        saturation?: number;
+        /** Ordered blip-effect list. Undefined = legacy scalar effects only. */
+        ordered?: ImageEffect[];
+    };
+    /** Rotated layout bbox. Undefined = use untransformed `size`. */
+    rotationBounds?: ImageRotationBounds;
+    /** Complete picture hyperlink metadata. Undefined = use `hlinkHref`. */
+    hyperlink?: ImageHyperlink;
+    /** Effect extents in EMUs. Undefined = no extra wrap/ink extent. */
+    effectExtent?: ImagePadding;
+}
+
+/**
+ * DrawingML chart model for basic rendered charts.
+ *
+ * This is intentionally normalized for display rather than lossless OOXML
+ * round-trip. Unsupported chart families stay in the original package parts.
+ */
+
+type ChartType = 'bar' | 'column' | 'line' | 'pie' | 'doughnut';
+type ChartGrouping = 'standard' | 'clustered' | 'stacked' | 'percentStacked';
+interface ChartPoint {
+    index?: number;
+    value?: number;
+    category?: string;
+    color?: string;
+    explosion?: number;
+    marker?: {
+        symbol?: string;
+        size?: number;
+        color?: string;
+    };
+    label?: string;
+}
+/** Run properties from a `c:txPr`; unset fields inherit from the chart. */
+interface ChartTextProperties {
+    font?: string;
+    sizePt?: number;
+    bold?: boolean;
+    italic?: boolean;
+    color?: string;
+}
+/** One `c:dLbl`: an index plus the switches it overrides. */
+interface ChartPointLabel {
+    index?: number;
+    text?: string;
+    labels: ChartDataLabels;
+}
+/** A `c:dLbls`; every switch is optional so an unset one inherits. */
+interface ChartDataLabels {
+    delete?: boolean;
+    showValue?: boolean;
+    showCategoryName?: boolean;
+    showSeriesName?: boolean;
+    showPercent?: boolean;
+    showLegendKey?: boolean;
+    showBubbleSize?: boolean;
+    separator?: string;
+    position?: string;
+    numberFormat?: string;
+    text?: ChartTextProperties;
+    points?: ChartPointLabel[];
+}
+interface ChartSeries {
+    name?: string;
+    categories: string[];
+    values: number[];
+    color?: string;
+    index?: number;
+    order?: number;
+    categoryFormula?: string;
+    valueFormula?: string;
+    axisIds?: string[];
+    points?: ChartPoint[];
+    grouping?: ChartGrouping;
+    marker?: {
+        symbol?: string;
+        size?: number;
+        color?: string;
+    };
+    smooth?: boolean;
+    /** `c:xVal` of a scatter or bubble series. */
+    xValues?: number[];
+    /** `c:bubbleSize` of a bubble series. */
+    bubbleSizes?: number[];
+    dataLabels?: ChartDataLabels;
+}
+interface ChartAxis {
+    id?: string;
+    title?: string;
+    min?: number;
+    max?: number;
+    labels?: string[];
+    axisType?: 'category' | 'value' | 'date' | 'series';
+    position?: 'left' | 'right' | 'top' | 'bottom';
+    crossAxisId?: string;
+    crosses?: 'autoZero' | 'min' | 'max' | 'value';
+    crossesAt?: number;
+    majorUnit?: number;
+    minorUnit?: number;
+    logarithmicBase?: number;
+    reversed?: boolean;
+    numberFormat?: string;
+    majorTickMark?: string;
+    minorTickMark?: string;
+    tickLabelPosition?: string;
+    hidden?: boolean;
+    majorGridlines?: boolean;
+    minorGridlines?: boolean;
+    text?: ChartTextProperties;
+}
+/** One chart-family element inside `c:plotArea`. */
+interface ChartPlotGroup {
+    chartType?: ChartType | 'area' | 'scatter' | 'radar' | 'stock' | 'bubble' | 'ofPie' | 'surface';
+    grouping?: ChartGrouping;
+    overlap?: number;
+    gapWidth?: number;
+    axisIds?: string[];
+    series?: ChartSeries[];
+    varyColors?: boolean;
+    firstSliceAngle?: number;
+    holeSize?: number;
+    showDataLabels?: boolean;
+    /** `c:scatterStyle`. */
+    scatterStyle?: 'none' | 'line' | 'lineMarker' | 'marker' | 'smooth' | 'smoothMarker';
+    /** `c:radarStyle`. */
+    radarStyle?: 'standard' | 'marker' | 'filled';
+    /** `c:bubbleScale`, a percentage of the default bubble size. */
+    bubbleScale?: number;
+    /** `c:sizeRepresents`. */
+    sizeRepresents?: 'area' | 'w';
+    /** `c:wireframe` of a surface chart. */
+    wireframe?: boolean;
+    hiLowLines?: boolean;
+    upDownBars?: boolean;
+    /** `c:marker` of a line chart, which switches every series marker off. */
+    marker?: boolean;
+    dataLabels?: ChartDataLabels;
+}
+interface ChartLegend {
+    position?: 'left' | 'right' | 'top' | 'bottom';
+    visible?: boolean;
+    /** `c:txPr` on the legend; unset fields inherit from the chart. */
+    text?: ChartTextProperties;
+}
+interface Chart {
+    type: 'chart';
+    chartType: ChartType;
+    /** Relationship id used by the owning drawing part. */
+    rId?: string;
+    /** Normalized package path, e.g. word/charts/chart1.xml. */
+    path?: string;
+    title?: string;
+    legend?: ChartLegend;
+    series: ChartSeries[];
+    axes?: {
+        category?: ChartAxis;
+        value?: ChartAxis;
+    };
+    /** Drawing extent from wp:extent in EMUs. */
+    size?: ImageSize;
+    /** Wrap metadata from the containing drawing; v1 layout treats charts as inline blocks. */
+    wrap?: ImageWrap;
+    /** Floating anchor. Undefined = inline legacy behavior. */
+    position?: ImagePosition;
+    /** Multiple/combo plot groups. Undefined = synthesize one from legacy fields. */
+    plotGroups?: ChartPlotGroup[];
+    /** Complete axis collection keyed through plot-group `axisIds`. */
+    axisList?: ChartAxis[];
+    /** Chart accessibility description. */
+    description?: string;
+    /** Decorative flag. Undefined = false. */
+    decorative?: boolean;
+    /** Stable z-order for anchored charts. Undefined = source order. */
+    relativeHeight?: number;
+    /** `c:txPr` on `c:chartSpace`: the root of chart text inheritance. */
+    text?: ChartTextProperties;
+    /** `c:txPr` on `c:title`. */
+    titleText?: ChartTextProperties;
+}
+
+export { type FieldInlineContent as $, type AbstractNumbering as A, type BlockContent as B, type CellMarker as C, type DrawingScene as D, type EndnoteProperties as E, type FootnoteProperties as F, type CommentAnchorRange as G, type HeaderFooter as H, type CommentAuthor as I, type CommentRangeEnd as J, type CommentRangeStart as K, type CommentReferenceContent as L, type ComplexField as M, type NoteKind as N, type ContentPosition as O, type Paragraph as P, DEFAULT_WATERMARK_PRESETS as Q, type RevisionInfo as R, type SectionProperties as S, type Deletion as T, type DrawingContent as U, type DrawingSceneNode as V, type Watermark as W, type EndnotePosition as X, type Field as Y, type FieldCharContent as Z, type FieldFormData as _, type SdtControlState as a, type StructuredFieldContent as a$, type FieldType as a0, type FooterReference as a1, type FootnotePosition as a2, type HeaderFooterType as a3, type HeaderReference as a4, type Hyperlink as a5, type HyperlinkContent as a6, type Image as a7, type ImageCrop as a8, type ImageEffect as a9, type NoteSeparatorReference as aA, type NumberFormat as aB, type NumberingInstance as aC, type PageNumberingProperties as aD, type PageOrientation as aE, type ParagraphContent as aF, type ParagraphPropertyChange as aG, type PictureWatermark as aH, type PropertyChangeInfo as aI, type Run as aJ, type RunContent as aK, type RunPropertyChange as aL, type SdtCheckboxGlyph as aM, type SdtDataBinding as aN, type SdtDateState as aO, type SdtGalleryState as aP, type SdtType as aQ, type Section as aR, type SectionStart as aS, type SeparatorContent as aT, type Shape as aU, type ShapeContent as aV, type ShapeFillPaint as aW, type ShapeStrokePaint as aX, type ShapeTextBody as aY, type SimpleField as aZ, type SoftHyphenContent as a_, type ImageHyperlink as aa, type ImagePadding as ab, type ImagePosition as ac, type ImageRotationBounds as ad, type ImageSize as ae, type ImageTransform as af, type ImageWrap as ag, type ImageWrapPoint as ah, type InlineSdt as ai, type Insertion as aj, type InstrTextContent as ak, type LevelSuffix as al, type LineNumberRestart as am, type ListLevel as an, type ListRendering as ao, type MathEquation as ap, type MoveFrom as aq, type MoveFromRangeEnd as ar, type MoveFromRangeStart as as, type MoveTo as at, type MoveToRangeEnd as au, type MoveToRangeStart as av, type NoBreakHyphenContent as aw, type NoteNumberRestart as ax, type NoteRefMarkContent as ay, type NoteReferenceContent as az, type SdtProperties as b, type StructuredFieldTree as b0, type SymbolContent as b1, type TabContent as b2, type Table as b3, type TableCell as b4, type TableCellPropertyChange as b5, type TablePropertyChange as b6, type TableRow as b7, type TableRowPropertyChange as b8, type TableStructuralChangeInfo as b9, type TextBox as ba, type TextContent as bb, type TextWatermark as bc, type TrackedChangeInfo as bd, type TrackedRunChange as be, type VerticalAlign as bf, pictureWatermarkDisplayEmu as bg, type ShapeEffect as c, type ShapeTextBodyProperties as d, type Chart as e, type Comment as f, type DocumentBody as g, type NumberingDefinitions as h, type Footnote as i, type Endnote as j, type BookmarkRange as k, type BlockSdt as l, type BookmarkEnd as m, type BookmarkStart as n, type BreakContent as o, type ChartAxis as p, type ChartContent as q, type ChartDataLabels as r, type ChartGrouping as s, type ChartLegend as t, type ChartPlotGroup as u, type ChartPoint as v, type ChartPointLabel as w, type ChartSeries as x, type ChartType as y, type Column as z };