@office-open/docx 0.8.1 → 0.9.0

package/dist/document-CWr8C_OX.mjs

@@ -0,0 +1,4404 @@
+import { TargetModeType, convertEmuToPixels, convertPixelsToEmu, convertToEmu, convertToTwip, convertUniversalMeasureToEmu, decimalNumber, eighthPointMeasureValue, hexColorValue, hpsMeasureValue, measurementOrPercentValue, pointMeasureValue, signedTwipsMeasureValue, toUint8Array, twipsMeasureValue, uCharHexNumber, uniqueId, uniqueNumericIdCreator, xsdVerticalMergeRev } from "@office-open/core";
+import { attr, attrBool, attrNum, children, element, escapeXml, findChild, findDeep, textOf } from "@office-open/xml";
+import { calculateEffectExtent, createEffectDag, createScene3D, createShape3D, customGeometryDesc, effectListDesc, extractBlipFillMedia, fillDesc, outlineDesc, scene3DDesc, shape3DDesc, transform2DDesc } from "@office-open/core/drawingml";
+import { chartSpaceDesc } from "@office-open/core/chart";
+import { createDataModel } from "@office-open/core/smartart";
+//#region src/shared/media/media.ts
+/**
+* Converts user-facing transformation options (pixels or universal measure) to internal
+* transformation data (pixels + EMUs).
+*
+* @param options - User-facing transformation in pixels or universal measure
+* @returns Internal transformation data with both pixel and EMU values
+*/
+const createTransformation = (options) => ({
+	emus: {
+		x: typeof options.width === "string" ? convertUniversalMeasureToEmu(options.width) : convertPixelsToEmu(options.width),
+		y: typeof options.height === "string" ? convertUniversalMeasureToEmu(options.height) : convertPixelsToEmu(options.height)
+	},
+	flip: options.flip,
+	offset: {
+		emus: {
+			x: typeof options.offset?.left === "string" ? convertUniversalMeasureToEmu(options.offset.left) : convertPixelsToEmu(options.offset?.left ?? 0),
+			y: typeof options.offset?.top === "string" ? convertUniversalMeasureToEmu(options.offset.top) : convertPixelsToEmu(options.offset?.top ?? 0)
+		},
+		pixels: {
+			x: typeof options.offset?.left === "number" ? Math.round(options.offset.left) : 0,
+			y: typeof options.offset?.top === "number" ? Math.round(options.offset.top) : 0
+		}
+	},
+	pixels: {
+		x: typeof options.width === "number" ? Math.round(options.width) : 0,
+		y: typeof options.height === "number" ? Math.round(options.height) : 0
+	},
+	rotation: options.rotation ? options.rotation * 6e4 : void 0
+});
+/**
+* Manages embedded media (images) in a document.
+*
+* Media stores all images referenced in the document and provides
+* access to their data for packaging into the DOCX file. Each image
+* is stored with a unique key for retrieval.
+*
+* @example
+* ```typescript
+* const media = new Media();
+* media.addImage("image1", {
+*   type: "png",
+*   fileName: "image1.png",
+*   transformation: {
+*     pixels: { x: 200, y: 100 },
+*     emus: { x: 1828800, y: 914400 }
+*   },
+*   data: imageBuffer
+* });
+* const allImages = media.Array;
+* ```
+*/
+var Media = class {
+	map;
+	constructor() {
+		this.map = /* @__PURE__ */ new Map();
+	}
+	/**
+	* Adds an image to the media collection.
+	*
+	* @param key - Unique identifier for this image
+	* @param mediaData - Complete image data including file name, transformation, and raw data
+	*/
+	addImage(key, mediaData) {
+		this.map.set(key, mediaData);
+	}
+	/**
+	* Gets all images as an array.
+	*
+	* @returns Read-only array of all media data in the collection
+	*/
+	get array() {
+		return [...this.map.values()];
+	}
+};
+//#endregion
+//#region src/shared/media/data.ts
+/**
+* @ignore
+*/
+const WORKAROUND2 = "";
+//#endregion
+//#region src/parts/drawing/inline/graphic/graphic-data/wps/body-properties.ts
+/**
+* Text anchoring type (ST_TextAnchoringType).
+*
+* ## XSD Schema
+* ```xml
+* <xsd:simpleType name="ST_TextAnchoringType">
+*   <xsd:restriction base="xsd:token">
+*     <xsd:enumeration value="t"/>
+*     <xsd:enumeration value="ctr"/>
+*     <xsd:enumeration value="b"/>
+*     <xsd:enumeration value="just"/>
+*     <xsd:enumeration value="dist"/>
+*   </xsd:restriction>
+* </xsd:simpleType>
+* ```
+*
+* @publicApi
+*/
+let VerticalAnchor = /* @__PURE__ */ function(VerticalAnchor) {
+	VerticalAnchor["TOP"] = "t";
+	VerticalAnchor["CENTER"] = "ctr";
+	VerticalAnchor["BOTTOM"] = "b";
+	VerticalAnchor["JUSTIFY"] = "just";
+	VerticalAnchor["DISTRIBUTED"] = "dist";
+	return VerticalAnchor;
+}({});
+/**
+* Text vertical overflow type (ST_TextVertOverflowType).
+*/
+const TextVertOverflowType = {
+	OVERFLOW: "overflow",
+	ELLIPSIS: "ellipsis",
+	CLIP: "clip"
+};
+/**
+* Text horizontal overflow type (ST_TextHorzOverflowType).
+*/
+const TextHorzOverflowType = {
+	OVERFLOW: "overflow",
+	CLIP: "clip"
+};
+/**
+* Text vertical type (ST_TextVerticalType).
+*
+* ## XSD Schema
+* ```xml
+* <xsd:simpleType name="ST_TextVerticalType">
+*   <xsd:restriction base="xsd:token">
+*     <xsd:enumeration value="horz"/>
+*     <xsd:enumeration value="vert"/>
+*     <xsd:enumeration value="vert270"/>
+*     <xsd:enumeration value="wordArtVert"/>
+*     <xsd:enumeration value="eaVert"/>
+*     <xsd:enumeration value="mongolianVert"/>
+*     <xsd:enumeration value="wordArtVertRtl"/>
+*   </xsd:restriction>
+* </xsd:simpleType>
+* ```
+*/
+const TextVerticalType = {
+	HORIZONTAL: "horz",
+	VERTICAL: "vert",
+	VERTICAL_270: "vert270",
+	WORD_ART_VERTICAL: "wordArtVert",
+	EAST_ASIAN_VERTICAL: "eaVert",
+	MONGOLIAN_VERTICAL: "mongolianVert",
+	WORD_ART_VERTICAL_RTL: "wordArtVertRtl"
+};
+/**
+* Text body wrapping type (ST_TextWrappingType).
+*
+* This is different from text wrapping around shapes (ST_WrapText).
+*/
+const TextBodyWrappingType = {
+	NONE: "none",
+	SQUARE: "square"
+};
+const filterAttrs = (options) => {
+	const attrs = {};
+	for (const [key, value] of Object.entries(options)) if (value !== void 0) attrs[key] = value;
+	return Object.keys(attrs).length > 0 ? attrs : void 0;
+};
+const createPresetTextShape = (options) => {
+	const adjChildren = [];
+	if (options.adjustments) for (const adj of options.adjustments) adjChildren.push(`<a:gd name="${adj.name}" fmla="${adj.formula}"/>`);
+	return element("a:prstTxWarp", { prst: options.preset }, adjChildren.length > 0 ? [element("a:avLst", void 0, adjChildren)] : void 0);
+};
+/**
+* Creates a text body properties element (wps:bodyPr).
+*
+* Supports all 19 CT_TextBodyProperties attributes and all child elements
+* including preset text warp, autofit variants, 3D scene, and text 3D.
+*
+* @example
+* ```typescript
+* // Simple margins and anchor
+* createBodyProperties({
+*   margins: { top: 100, bottom: 100, left: 200, right: 200 },
+*   verticalAnchor: VerticalAnchor.CENTER,
+* });
+*
+* // Full options with vertical text and autofit
+* createBodyProperties({
+*   vert: TextVerticalType.VERTICAL,
+*   wrap: TextBodyWrappingType.NONE,
+*   normAutofit: { fontScale: 80000 },
+*   numCol: 2,
+*   anchor: VerticalAnchor.TOP,
+* });
+* ```
+*/
+const createBodyProperties = (options = {}) => {
+	const anchor = options.anchor ?? options.verticalAnchor;
+	const lIns = options.lIns ?? options.margins?.left;
+	const tIns = options.tIns ?? options.margins?.top;
+	const rIns = options.rIns ?? options.margins?.right;
+	const bIns = options.bIns ?? options.margins?.bottom;
+	const attrs = filterAttrs({
+		rot: options.rotation,
+		spcFirstLastPara: options.spcFirstLastPara,
+		vertOverflow: options.vertOverflow,
+		horzOverflow: options.horzOverflow,
+		vert: options.vert,
+		wrap: options.wrap,
+		lIns: lIns !== void 0 ? convertToEmu(lIns) : void 0,
+		tIns: tIns !== void 0 ? convertToEmu(tIns) : void 0,
+		rIns: rIns !== void 0 ? convertToEmu(rIns) : void 0,
+		bIns: bIns !== void 0 ? convertToEmu(bIns) : void 0,
+		numCol: options.numCol,
+		spcCol: options.spcCol !== void 0 ? convertToEmu(options.spcCol) : void 0,
+		rtlCol: options.rtlCol,
+		fromWordArt: options.fromWordArt,
+		anchor,
+		anchorCtr: options.anchorCtr,
+		forceAA: options.forceAA,
+		upright: options.upright,
+		compatLnSpc: options.compatLnSpc
+	});
+	const children = [];
+	if (options.prstTxWarp) children.push(createPresetTextShape(options.prstTxWarp));
+	if (options.noAutoFit) children.push(`<a:noAutofit/>`);
+	else if (options.normAutofit) {
+		const normAttrs = filterAttrs({
+			fontScale: options.normAutofit.fontScale,
+			lnSpcReduction: options.normAutofit.lnSpcReduction
+		});
+		children.push(element("a:normAutofit", normAttrs));
+	} else if (options.spAutoFit) children.push(`<a:spAutoFit/>`);
+	if (options.scene3d) children.push(createScene3D(options.scene3d));
+	if (options.sp3d) children.push(createShape3D(options.sp3d));
+	else if (options.flatTx) {
+		const flatAttrs = filterAttrs({ z: options.flatTx.z });
+		children.push(element("a:flatTx", flatAttrs));
+	}
+	return element("wps:bodyPr", attrs, children.length > 0 ? children : void 0);
+};
+//#endregion
+//#region src/parts/table/table-cell/table-cell-components.ts
+/**
+* Vertical merge types for table cells.
+*
+* Defines the merge behavior for vertically merged cells (row span).
+*/
+const VerticalMergeType = {
+	/**
+	* Cell that is merged with upper one.
+	*/
+	CONTINUE: "continue",
+	/**
+	* Cell that is starting the vertical merge.
+	*/
+	RESTART: "restart"
+};
+/**
+* Text direction values for table cells.
+*
+* Specifies the direction in which text flows within a table cell.
+*/
+const TextDirection = {
+	/** Text flows from bottom to top, left to right */
+	BOTTOM_TO_TOP_LEFT_TO_RIGHT: "btLr",
+	/** Text flows from left to right, top to bottom (default) */
+	LEFT_TO_RIGHT_TOP_TO_BOTTOM: "lrTb",
+	/** Text flows from top to bottom, right to left */
+	TOP_TO_BOTTOM_RIGHT_TO_LEFT: "tbRl"
+};
+//#endregion
+//#region src/shared/border.ts
+/**
+* Table borders are defined with the <w:tblBorders> element. Child elements of this element specify the kinds of `border`:
+*
+* `bottom`, `end` (`right` in the previous version of the standard), `insideH`, `insideV`, `start` (`left` in the previous version of the standard), and `top`.
+*
+* Reference: http://officeopenxml.com/WPtableBorders.php
+*
+* ## XSD Schema
+* ```xml
+* <xsd:simpleType name="ST_Border">
+*     <xsd:restriction base="xsd:string">
+*          <xsd:enumeration value="single"/>
+*          <xsd:enumeration value="dashDotStroked"/>
+*          <xsd:enumeration value="dashed"/>
+*          <xsd:enumeration value="dashSmallGap"/>
+*          <xsd:enumeration value="dotDash"/>
+*          <xsd:enumeration value="dotDotDash"/>
+*          <xsd:enumeration value="dotted"/>
+*          <xsd:enumeration value="double"/>
+*          <xsd:enumeration value="doubleWave"/>
+*          <xsd:enumeration value="inset"/>
+*          <xsd:enumeration value="nil"/>
+*          <xsd:enumeration value="none"/>
+*          <xsd:enumeration value="outset"/>
+*          <xsd:enumeration value="thick"/>
+*          <xsd:enumeration value="thickThinLargeGap"/>
+*          <xsd:enumeration value="thickThinMediumGap"/>
+*          <xsd:enumeration value="thickThinSmallGap"/>
+*          <xsd:enumeration value="thinThickLargeGap"/>
+*          <xsd:enumeration value="thinThickMediumGap"/>
+*          <xsd:enumeration value="thinThickSmallGap"/>
+*          <xsd:enumeration value="thinThickThinLargeGap"/>
+*          <xsd:enumeration value="thinThickThinMediumGap"/>
+*          <xsd:enumeration value="thinThickThinSmallGap"/>
+*          <xsd:enumeration value="threeDEmboss"/>
+*          <xsd:enumeration value="threeDEngrave"/>
+*          <xsd:enumeration value="triple"/>
+*          <xsd:enumeration value="wave"/>
+*     </xsd:restriction>
+* </xsd:simpleType>
+* ```
+*
+* @publicApi
+*/
+const BorderStyle = {
+	/** A single line */
+	SINGLE: "single",
+	/** A line with a series of alternating thin and thick strokes */
+	DASH_DOT_STROKED: "dashDotStroked",
+	/** A dashed line */
+	DASHED: "dashed",
+	/** A dashed line with small gaps */
+	DASH_SMALL_GAP: "dashSmallGap",
+	/** A line with alternating dots and dashes */
+	DOT_DASH: "dotDash",
+	/** A line with a repeating dot - dot - dash sequence */
+	DOT_DOT_DASH: "dotDotDash",
+	/** A dotted line */
+	DOTTED: "dotted",
+	/** A double line */
+	DOUBLE: "double",
+	/** A double wavy line */
+	DOUBLE_WAVE: "doubleWave",
+	/** An inset set of lines */
+	INSET: "inset",
+	/** No border */
+	NIL: "nil",
+	/** No border */
+	NONE: "none",
+	/** An outset set of lines */
+	OUTSET: "outset",
+	/** A single line */
+	THICK: "thick",
+	/** A thick line contained within a thin line with a large-sized intermediate gap */
+	THICK_THIN_LARGE_GAP: "thickThinLargeGap",
+	/** A thick line contained within a thin line with a medium-sized intermediate gap */
+	THICK_THIN_MEDIUM_GAP: "thickThinMediumGap",
+	/** A thick line contained within a thin line with a small intermediate gap */
+	THICK_THIN_SMALL_GAP: "thickThinSmallGap",
+	/** A thin line contained within a thick line with a large-sized intermediate gap */
+	THIN_THICK_LARGE_GAP: "thinThickLargeGap",
+	/** A thick line contained within a thin line with a medium-sized intermediate gap */
+	THIN_THICK_MEDIUM_GAP: "thinThickMediumGap",
+	/** A thick line contained within a thin line with a small intermediate gap */
+	THIN_THICK_SMALL_GAP: "thinThickSmallGap",
+	/** A thin-thick-thin line with a large gap */
+	THIN_THICK_THIN_LARGE_GAP: "thinThickThinLargeGap",
+	/** A thin-thick-thin line with a medium gap */
+	THIN_THICK_THIN_MEDIUM_GAP: "thinThickThinMediumGap",
+	/** A thin-thick-thin line with a small gap */
+	THIN_THICK_THIN_SMALL_GAP: "thinThickThinSmallGap",
+	/** A three-staged gradient line, getting darker towards the paragraph */
+	THREE_D_EMBOSS: "threeDEmboss",
+	/** A three-staged gradient like, getting darker away from the paragraph */
+	THREE_D_ENGRAVE: "threeDEngrave",
+	/** A triple line */
+	TRIPLE: "triple",
+	/** A wavy line */
+	WAVE: "wave"
+};
+//#endregion
+//#region src/parts/table/table-width.ts
+/**
+* Width type values for tables and cells.
+*
+* ## XSD Schema
+* ```xml
+* <xsd:simpleType name="ST_TblWidth">
+*   <xsd:restriction base="xsd:string">
+*     <xsd:enumeration value="nil"/>
+*     <xsd:enumeration value="pct"/>
+*     <xsd:enumeration value="dxa"/>
+*     <xsd:enumeration value="auto"/>
+*   </xsd:restriction>
+* </xsd:simpleType>
+* ```
+*
+* @publicApi
+*/
+const WidthType = {
+	/** Auto. */
+	AUTO: "auto",
+	/** Value is in twentieths of a point */
+	DXA: "dxa",
+	/** No (empty) value. */
+	NIL: "nil",
+	/** Value is in percentage. */
+	PERCENTAGE: "pct"
+};
+//#endregion
+//#region src/parts/drawing/text-wrap/text-wrapping.ts
+/**
+* Enumeration of text wrapping types for floating drawings.
+*
+* Reference: http://officeopenxml.com/drwPicFloating-textWrap.php
+*
+* @publicApi
+*/
+const TextWrappingType = {
+	NONE: 0,
+	SQUARE: 1,
+	TIGHT: 2,
+	TOP_AND_BOTTOM: 3,
+	THROUGH: 4
+};
+/**
+* Enumeration of text wrapping sides for floating drawings.
+*
+* Specifies on which side(s) text can wrap around the drawing.
+*
+* Reference: http://officeopenxml.com/drwPicFloating-textWrap.php
+*
+* @publicApi
+*/
+const TextWrappingSide = {
+	/** Text wraps on both sides of the drawing */
+	BOTH_SIDES: "bothSides",
+	/** Text wraps only on the left side */
+	LEFT: "left",
+	/** Text wraps only on the right side */
+	RIGHT: "right",
+	/** Text wraps on the side with more space */
+	LARGEST: "largest"
+};
+//#endregion
+//#region src/parts/drawing/text-wrap/wrap-tight.ts
+/**
+* Wrap Tight module for DrawingML text wrapping.
+*
+* This module provides tight text wrapping for floating drawings
+* where text wraps closely around the image shape.
+*
+* Reference: http://officeopenxml.com/drwPicFloating-textWrap.php
+*
+* @module
+*/
+/**
+* Creates a default rectangular wrap polygon matching the image extent.
+*
+* Reference: http://officeopenxml.com/drwPicFloating-textWrap.php
+*
+* ## XSD Schema
+* ```xml
+* <xsd:complexType name="CT_WrapPath">
+*   <xsd:sequence>
+*     <xsd:element name="start" type="a:CT_Point2D" minOccurs="1" maxOccurs="1"/>
+*     <xsd:element name="lineTo" type="a:CT_Point2D" minOccurs="2" maxOccurs="unbounded"/>
+*   </xsd:sequence>
+*   <xsd:attribute name="edited" type="xsd:boolean" use="optional"/>
+* </xsd:complexType>
+* ```
+*/
+const createWrapPolygon$1 = (cx, cy) => element("wp:wrapPolygon", { edited: "0" }, [
+	`<wp:start x="0" y="0"/>`,
+	`<wp:lineTo x="0" y="${-cy}"/>`,
+	`<wp:lineTo x="${cx}" y="${-cy}"/>`,
+	`<wp:lineTo x="${cx}" y="0"/>`,
+	`<wp:lineTo x="0" y="0"/>`
+]);
+/**
+* Creates tight text wrapping for a floating drawing.
+*
+* WrapTight causes text to wrap closely around the contours
+* of the drawing rather than its rectangular bounding box.
+* A default rectangular wrap polygon matching the image extent is generated.
+*
+* Reference: http://officeopenxml.com/drwPicFloating-textWrap.php
+*
+* ## XSD Schema
+* ```xml
+* <xsd:complexType name="CT_WrapTight">
+*   <xsd:sequence>
+*     <xsd:element name="wrapPolygon" type="CT_WrapPath" minOccurs="1" maxOccurs="1"/>
+*   </xsd:sequence>
+*   <xsd:attribute name="wrapText" type="ST_WrapText" use="required"/>
+*   <xsd:attribute name="distL" type="ST_WrapDistance"/>
+*   <xsd:attribute name="distR" type="ST_WrapDistance"/>
+* </xsd:complexType>
+* ```
+*/
+const createWrapTight = (textWrapping, margins = {
+	bottom: 0,
+	left: 0,
+	right: 0,
+	top: 0
+}, extent) => element("wp:wrapTight", {
+	distL: margins.left,
+	distR: margins.right,
+	wrapText: textWrapping.side || TextWrappingSide.BOTH_SIDES
+}, [createWrapPolygon$1(extent.x, extent.y)]);
+//#endregion
+//#region src/parts/drawing/text-wrap/wrap-through.ts
+/**
+* Wrap Through module for DrawingML text wrapping.
+*
+* This module provides "through" text wrapping for floating drawings
+* where text wraps through the image contours, filling any concave areas.
+*
+* Reference: http://officeopenxml.com/drwPicFloating-textWrap.php
+*
+* @module
+*/
+/**
+* Creates a default rectangular wrap polygon matching the image extent.
+*
+* Reference: http://officeopenxml.com/drwPicFloating-textWrap.php
+*
+* ## XSD Schema
+* ```xml
+* <xsd:complexType name="CT_WrapPath">
+*   <xsd:sequence>
+*     <xsd:element name="start" type="a:CT_Point2D" minOccurs="1" maxOccurs="1"/>
+*     <xsd:element name="lineTo" type="a:CT_Point2D" minOccurs="2" maxOccurs="unbounded"/>
+*   </xsd:sequence>
+*   <xsd:attribute name="edited" type="xsd:boolean" use="optional"/>
+* </xsd:complexType>
+* ```
+*/
+const createWrapPolygon = (cx, cy) => element("wp:wrapPolygon", { edited: "0" }, [
+	`<wp:start x="0" y="0"/>`,
+	`<wp:lineTo x="0" y="${-cy}"/>`,
+	`<wp:lineTo x="${cx}" y="${-cy}"/>`,
+	`<wp:lineTo x="${cx}" y="0"/>`,
+	`<wp:lineTo x="0" y="0"/>`
+]);
+/**
+* Creates "through" text wrapping for a floating drawing.
+*
+* WrapThrough is similar to WrapTight but allows text to wrap through
+* the concave portions of the drawing shape (e.g., the inside of the letter "O").
+* A default rectangular wrap polygon matching the image extent is generated.
+*
+* Reference: http://officeopenxml.com/drwPicFloating-textWrap.php
+*
+* ## XSD Schema
+* ```xml
+* <xsd:complexType name="CT_WrapThrough">
+*   <xsd:sequence>
+*     <xsd:element name="wrapPolygon" type="CT_WrapPath" minOccurs="1" maxOccurs="1"/>
+*   </xsd:sequence>
+*   <xsd:attribute name="wrapText" type="ST_WrapText" use="required"/>
+*   <xsd:attribute name="distL" type="ST_WrapDistance"/>
+*   <xsd:attribute name="distR" type="ST_WrapDistance"/>
+* </xsd:complexType>
+* ```
+*/
+const createWrapThrough = (textWrapping, margins = {
+	bottom: 0,
+	left: 0,
+	right: 0,
+	top: 0
+}, extent) => element("wp:wrapThrough", {
+	distL: margins.left,
+	distR: margins.right,
+	wrapText: textWrapping.side || TextWrappingSide.BOTH_SIDES
+}, [createWrapPolygon(extent.x, extent.y)]);
+//#endregion
+//#region src/shared/constants.ts
+/**
+* Shared constants for WordprocessingML documents.
+*
+* Provides alignment, number format, and space type constants
+* used across multiple document components.
+*
+* @module
+*/
+/**
+* Horizontal alignment options for floating drawings.
+*
+* Reference: https://www.datypic.com/sc/ooxml/t-wp_ST_AlignH.html
+*
+* @publicApi
+*/
+const HorizontalPositionAlign = {
+	CENTER: "center",
+	INSIDE: "inside",
+	LEFT: "left",
+	OUTSIDE: "outside",
+	RIGHT: "right"
+};
+/**
+* Vertical alignment options for floating drawings.
+*
+* Reference: https://www.datypic.com/sc/ooxml/t-wp_ST_AlignV.html
+*
+* @publicApi
+*/
+const VerticalPositionAlign = {
+	BOTTOM: "bottom",
+	CENTER: "center",
+	INSIDE: "inside",
+	OUTSIDE: "outside",
+	TOP: "top"
+};
+/**
+* Number format types for page numbers and list numbering.
+*
+* Reference: http://officeopenxml.com/WPnumbering-numFmt.php
+*
+* @publicApi
+*/
+const NumberFormat = {
+	AIUEO: "aiueo",
+	AIUEO_FULL_WIDTH: "aiueoFullWidth",
+	ARABIC_ABJAD: "arabicAbjad",
+	ARABIC_ALPHA: "arabicAlpha",
+	BAHT_TEXT: "bahtText",
+	BULLET: "bullet",
+	CARDINAL_TEXT: "cardinalText",
+	CHICAGO: "chicago",
+	CHINESE_COUNTING: "chineseCounting",
+	CHINESE_COUNTING_TEN_THOUSAND: "chineseCountingThousand",
+	CHINESE_LEGAL_SIMPLIFIED: "chineseLegalSimplified",
+	CHOSUNG: "chosung",
+	DECIMAL: "decimal",
+	DECIMAL_ENCLOSED_CIRCLE: "decimalEnclosedCircle",
+	DECIMAL_ENCLOSED_CIRCLE_CHINESE: "decimalEnclosedCircleChinese",
+	DECIMAL_ENCLOSED_FULL_STOP: "decimalEnclosedFullstop",
+	DECIMAL_ENCLOSED_PAREN: "decimalEnclosedParen",
+	DECIMAL_FULL_WIDTH: "decimalFullWidth",
+	DECIMAL_FULL_WIDTH_2: "decimalFullWidth2",
+	DECIMAL_HALF_WIDTH: "decimalHalfWidth",
+	DECIMAL_ZERO: "decimalZero",
+	DOLLAR_TEXT: "dollarText",
+	GANADA: "ganada",
+	HEBREW_1: "hebrew1",
+	HEBREW_2: "hebrew2",
+	HEX: "hex",
+	HINDI_CONSONANTS: "hindiConsonants",
+	HINDI_COUNTING: "hindiCounting",
+	HINDI_NUMBERS: "hindiNumbers",
+	HINDI_VOWELS: "hindiVowels",
+	IDEOGRAPH_DIGITAL: "ideographDigital",
+	IDEOGRAPH_ENCLOSED_CIRCLE: "ideographEnclosedCircle",
+	IDEOGRAPH_LEGAL_TRADITIONAL: "ideographLegalTraditional",
+	IDEOGRAPH_TRADITIONAL: "ideographTraditional",
+	IDEOGRAPH_ZODIAC: "ideographZodiac",
+	IDEOGRAPH_ZODIAC_TRADITIONAL: "ideographZodiacTraditional",
+	IROHA: "iroha",
+	IROHA_FULL_WIDTH: "irohaFullWidth",
+	JAPANESE_COUNTING: "japaneseCounting",
+	JAPANESE_DIGITAL_TEN_THOUSAND: "japaneseDigitalTenThousand",
+	JAPANESE_LEGAL: "japaneseLegal",
+	KOREAN_COUNTING: "koreanCounting",
+	KOREAN_DIGITAL: "koreanDigital",
+	KOREAN_DIGITAL_2: "koreanDigital2",
+	KOREAN_LEGAL: "koreanLegal",
+	LOWER_LETTER: "lowerLetter",
+	LOWER_ROMAN: "lowerRoman",
+	NONE: "none",
+	NUMBER_IN_DASH: "numberInDash",
+	ORDINAL: "ordinal",
+	ORDINAL_TEXT: "ordinalText",
+	RUSSIAN_LOWER: "russianLower",
+	RUSSIAN_UPPER: "russianUpper",
+	TAIWANESE_COUNTING: "taiwaneseCounting",
+	TAIWANESE_COUNTING_THOUSAND: "taiwaneseCountingThousand",
+	TAIWANESE_DIGITAL: "taiwaneseDigital",
+	THAI_COUNTING: "thaiCounting",
+	THAI_LETTERS: "thaiLetters",
+	THAI_NUMBERS: "thaiNumbers",
+	UPPER_LETTER: "upperLetter",
+	UPPER_ROMAN: "upperRoman",
+	VIETNAMESE_COUNTING: "vietnameseCounting"
+};
+/**
+* XML space handling modes.
+*
+* @publicApi
+*/
+const SpaceType = {
+	DEFAULT: "default",
+	PRESERVE: "preserve"
+};
+//#endregion
+//#region src/parts/drawing/floating/floating-position.ts
+/**
+* Horizontal Relative Positioning.
+*
+* Specifies the horizontal base from which the drawing position is calculated.
+*
+* Reference: https://www.datypic.com/sc/ooxml/t-wp_ST_RelFromH.html
+*
+* ## XSD Schema
+* ```xml
+* <xsd:simpleType name="ST_RelFromH">
+*   <xsd:restriction base="xsd:token">
+*     <xsd:enumeration value="margin"/>
+*     <xsd:enumeration value="page"/>
+*     <xsd:enumeration value="column"/>
+*     <xsd:enumeration value="character"/>
+*     <xsd:enumeration value="leftMargin"/>
+*     <xsd:enumeration value="rightMargin"/>
+*     <xsd:enumeration value="insideMargin"/>
+*     <xsd:enumeration value="outsideMargin"/>
+*   </xsd:restriction>
+* </xsd:simpleType>
+* ```
+*
+* @publicApi
+*/
+const HorizontalPositionRelativeFrom = {
+	/**
+	* ## Character
+	*
+	* Specifies that the horizontal positioning shall be relative to the position of the anchor within its run content.
+	*/
+	CHARACTER: "character",
+	/**
+	* ## Column
+	*
+	* Specifies that the horizontal positioning shall be relative to the extents of the column which contains its anchor.
+	*/
+	COLUMN: "column",
+	/**
+	* ## Inside Margin
+	*
+	* Specifies that the horizontal positioning shall be relative to the inside margin of the current page (the left margin on odd pages, right on even pages).
+	*/
+	INSIDE_MARGIN: "insideMargin",
+	/**
+	* ## Left Margin
+	*
+	* Specifies that the horizontal positioning shall be relative to the left margin of the page.
+	*/
+	LEFT_MARGIN: "leftMargin",
+	/**
+	* ## Page Margin
+	*
+	* Specifies that the horizontal positioning shall be relative to the page margins.
+	*/
+	MARGIN: "margin",
+	/**
+	* ## Outside Margin
+	*
+	* Specifies that the horizontal positioning shall be relative to the outside margin of the current page (the right margin on odd pages, left on even pages).
+	*/
+	OUTSIDE_MARGIN: "outsideMargin",
+	/**
+	* ## Page Edge
+	*
+	* Specifies that the horizontal positioning shall be relative to the edge of the page.
+	*/
+	PAGE: "page",
+	/**
+	* ## Right Margin
+	*
+	* Specifies that the horizontal positioning shall be relative to the right margin of the page.
+	*/
+	RIGHT_MARGIN: "rightMargin"
+};
+/**
+* Vertical Relative Positioning.
+*
+* Specifies the vertical base from which the drawing position is calculated.
+*
+* Reference: https://www.datypic.com/sc/ooxml/t-wp_ST_RelFromV.html
+*
+* ## XSD Schema
+* ```xml
+* <xsd:simpleType name="ST_RelFromV">
+*   <xsd:restriction base="xsd:token">
+*     <xsd:enumeration value="margin"/>
+*     <xsd:enumeration value="page"/>
+*     <xsd:enumeration value="paragraph"/>
+*     <xsd:enumeration value="line"/>
+*     <xsd:enumeration value="topMargin"/>
+*     <xsd:enumeration value="bottomMargin"/>
+*     <xsd:enumeration value="insideMargin"/>
+*     <xsd:enumeration value="outsideMargin"/>
+*   </xsd:restriction>
+* </xsd:simpleType>
+* ```
+*
+* @publicApi
+*/
+const VerticalPositionRelativeFrom = {
+	/**
+	* ## Bottom Margin
+	*
+	* Specifies that the vertical positioning shall be relative to the bottom margin of the current page.
+	*/
+	BOTTOM_MARGIN: "bottomMargin",
+	/**
+	* ## Inside Margin
+	*
+	* Specifies that the vertical positioning shall be relative to the inside margin of the current page.
+	*/
+	INSIDE_MARGIN: "insideMargin",
+	/**
+	* ## Line
+	*
+	* Specifies that the vertical positioning shall be relative to the line containing the anchor character.
+	*/
+	LINE: "line",
+	/**
+	* ## Page Margin
+	*
+	* Specifies that the vertical positioning shall be relative to the page margins.
+	*/
+	MARGIN: "margin",
+	/**
+	* ## Outside Margin
+	*
+	* Specifies that the vertical positioning shall be relative to the outside margin of the current page.
+	*/
+	OUTSIDE_MARGIN: "outsideMargin",
+	/**
+	* ## Page Edge
+	*
+	* Specifies that the vertical positioning shall be relative to the edge of the page.
+	*/
+	PAGE: "page",
+	/**
+	* ## Paragraph
+	*
+	* Specifies that the vertical positioning shall be relative to the paragraph which contains the drawing anchor.
+	*/
+	PARAGRAPH: "paragraph",
+	/**
+	* ## Top Margin
+	*
+	* Specifies that the vertical positioning shall be relative to the top margin of the current page.
+	*/
+	TOP_MARGIN: "topMargin"
+};
+//#endregion
+//#region src/parts/drawing/floating/horizontal-position.ts
+/**
+* Horizontal position module for floating drawings in WordprocessingML documents.
+*
+* This module provides horizontal positioning for floating drawing objects,
+* specifying the horizontal placement relative to a base element.
+*
+* Reference: http://officeopenxml.com/drwPicFloating-position.php
+*
+* @module
+*/
+/**
+* Creates a horizontal position element for floating drawings.
+*
+* The positionH element specifies the horizontal positioning of a floating
+* object relative to a base element (page, margin, column, etc.).
+*
+* Reference: https://www.datypic.com/sc/ooxml/e-wp_positionH-1.html
+*
+* ## XSD Schema
+* ```xml
+* <xsd:complexType name="CT_PosH">
+*   <xsd:choice>
+*     <xsd:element name="align" type="ST_AlignH"/>
+*     <xsd:element name="posOffset" type="ST_PositionOffset"/>
+*   </xsd:choice>
+*   <xsd:attribute name="relativeFrom" type="ST_RelFromH" use="required"/>
+* </xsd:complexType>
+* ```
+*
+* @param options - Horizontal position configuration
+* @returns The positionH XML string
+*
+* @example
+* ```typescript
+* // Align to the left of the page
+* createHorizontalPosition({
+*   relative: HorizontalPositionRelativeFrom.PAGE,
+*   align: HorizontalPositionAlign.LEFT,
+* });
+*
+* // Offset from the margin
+* createHorizontalPosition({
+*   relative: HorizontalPositionRelativeFrom.MARGIN,
+*   offset: 914400, // 1 inch in EMUs
+* });
+* ```
+*/
+const createHorizontalPosition = ({ relative, align, offset }) => {
+	const child = align ? `<wp:align>${align}</wp:align>` : offset !== void 0 ? `<wp:posOffset>${offset}</wp:posOffset>` : `<wp:align>${HorizontalPositionAlign.LEFT}</wp:align>`;
+	return element("wp:positionH", { relativeFrom: relative ?? HorizontalPositionRelativeFrom.PAGE }, [child]);
+};
+//#endregion
+//#region src/parts/drawing/floating/vertical-position.ts
+/**
+* Vertical position module for floating drawings in WordprocessingML documents.
+*
+* This module provides vertical positioning for floating drawing objects,
+* specifying the vertical placement relative to a base element.
+*
+* Reference: http://officeopenxml.com/drwPicFloating-position.php
+*
+* @module
+*/
+/**
+* Creates a vertical position element for floating drawings.
+*
+* The positionV element specifies the vertical positioning of a floating
+* object relative to a base element (page, margin, paragraph, line, etc.).
+*
+* Reference: https://www.datypic.com/sc/ooxml/e-wp_positionV-1.html
+*
+* ## XSD Schema
+* ```xml
+* <xsd:complexType name="CT_PosV">
+*   <xsd:choice>
+*     <xsd:element name="align" type="ST_AlignV"/>
+*     <xsd:element name="posOffset" type="ST_PositionOffset"/>
+*   </xsd:choice>
+*   <xsd:attribute name="relativeFrom" type="ST_RelFromV" use="required"/>
+* </xsd:complexType>
+* ```
+*
+* @param options - Vertical position configuration
+* @returns The positionV XML string
+*
+* @example
+* ```typescript
+* // Align to the top of the page
+* createVerticalPosition({
+*   relative: VerticalPositionRelativeFrom.PAGE,
+*   align: VerticalPositionAlign.TOP,
+* });
+*
+* // Offset from the paragraph
+* createVerticalPosition({
+*   relative: VerticalPositionRelativeFrom.PARAGRAPH,
+*   offset: 457200, // 0.5 inch in EMUs
+* });
+* ```
+*/
+const createVerticalPosition = ({ relative, align, offset }) => {
+	const child = align ? `<wp:align>${align}</wp:align>` : offset !== void 0 ? `<wp:posOffset>${offset}</wp:posOffset>` : `<wp:align>${VerticalPositionAlign.TOP}</wp:align>`;
+	return element("wp:positionV", { relativeFrom: relative ?? VerticalPositionRelativeFrom.PAGE }, [child]);
+};
+//#endregion
+//#region src/parts/drawing/drawing-parse.ts
+/**
+* Drawing parser for DOCX documents.
+*
+* Parses w:drawing elements and extracts image, chart, or SmartArt data.
+*
+* @module
+*/
+/**
+* Parse a w:drawing element and dispatch to the correct parser
+* based on the graphicData URI.
+*/
+function parseDrawingRun(el, ctx) {
+	const graphicData = findDeep(el, "a:graphicData")[0];
+	if (!graphicData) return void 0;
+	const uri = attr(graphicData, "uri") ?? "";
+	if (uri.includes("/chart")) return parseChartDrawing(el, ctx);
+	if (uri.includes("/diagram")) return parseSmartArtDrawing(el, ctx);
+	return parseImageRun(el, ctx);
+}
+/**
+* Determine image type from file extension or MIME type.
+*/
+function imageTypeFromPath(path) {
+	switch (path.split(".").pop()?.toLowerCase() ?? "") {
+		case "jpg":
+		case "jpeg": return "jpg";
+		case "png": return "png";
+		case "gif": return "gif";
+		case "bmp": return "bmp";
+		case "tif":
+		case "tiff": return "tif";
+		case "ico": return "ico";
+		case "emf": return "emf";
+		case "wmf": return "wmf";
+		default: return "png";
+	}
+}
+/**
+* Parse a w:drawing element and return image data wrapped in { image: ... }.
+*/
+function parseImageRun(el, ctx) {
+	const inline = findDeep(el, "wp:inline")[0];
+	const anchor = inline ? void 0 : findDeep(el, "wp:anchor")[0];
+	const parent = inline ?? anchor;
+	if (!parent) return void 0;
+	const extent = findChild(parent, "wp:extent");
+	let width;
+	let height;
+	if (extent) {
+		const cxEmu = attrNum(extent, "cx");
+		const cyEmu = attrNum(extent, "cy");
+		if (cxEmu !== void 0) width = convertEmuToPixels(cxEmu);
+		if (cyEmu !== void 0) height = convertEmuToPixels(cyEmu);
+	}
+	const blip = findDeep(parent, "a:blip")[0];
+	if (!blip) return void 0;
+	const rEmbed = attr(blip, "r:embed");
+	if (!rEmbed) return void 0;
+	const mediaPath = ctx.docx.partRefs.media.get(rEmbed);
+	if (!mediaPath) return void 0;
+	const imageData = ctx.docx.doc.getRaw(mediaPath);
+	if (!imageData) return void 0;
+	const imageOpts = {
+		type: imageTypeFromPath(mediaPath),
+		data: imageData,
+		transformation: {
+			...width !== void 0 ? { width } : {},
+			...height !== void 0 ? { height } : {}
+		}
+	};
+	const docPr = findChild(parent, "wp:docPr");
+	if (docPr) {
+		const name = attr(docPr, "name");
+		const descr = attr(docPr, "descr");
+		const title = attr(docPr, "title");
+		if (name || descr || title) imageOpts.altText = {
+			...name ? { name } : {},
+			...descr ? { description: descr } : {},
+			...title ? { title } : {}
+		};
+	}
+	if (anchor && !inline) {
+		const floating = {};
+		const posH = findChild(anchor, "wp:positionH");
+		if (posH) {
+			const align = findChild(posH, "wp:align");
+			const posOffset = findChild(posH, "wp:posOffset");
+			if (align) floating.horizontalPosition = { align: textOf(align) };
+			else if (posOffset) {
+				const val = Number(textOf(posOffset));
+				if (!isNaN(val)) floating.horizontalPosition = { offset: val };
+			}
+		}
+		const posV = findChild(anchor, "wp:positionV");
+		if (posV) {
+			const align = findChild(posV, "wp:align");
+			const posOffset = findChild(posV, "wp:posOffset");
+			if (align) floating.verticalPosition = { align: textOf(align) };
+			else if (posOffset) {
+				const val = Number(textOf(posOffset));
+				if (!isNaN(val)) floating.verticalPosition = { offset: val };
+			}
+		}
+		for (const wrapType of [
+			"wrapSquare",
+			"wrapTight",
+			"wrapTopAndBottom",
+			"wrapNone"
+		]) if (findChild(anchor, `wp:${wrapType}`)) {
+			floating.wrap = wrapType;
+			break;
+		}
+		if (attrBool(anchor, "behindDoc")) floating.behindDocument = true;
+		if (Object.keys(floating).length > 0) imageOpts.floating = floating;
+	}
+	return { image: imageOpts };
+}
+function getDrawingExtent(el) {
+	const inline = findDeep(el, "wp:inline")[0];
+	const anchor = inline ? void 0 : findDeep(el, "wp:anchor")[0];
+	const parent = inline ?? anchor;
+	if (!parent) return {};
+	const extent = findChild(parent, "wp:extent");
+	if (!extent) return {};
+	const cxEmu = attrNum(extent, "cx");
+	const cyEmu = attrNum(extent, "cy");
+	return {
+		...cxEmu !== void 0 ? { width: convertEmuToPixels(cxEmu) } : {},
+		...cyEmu !== void 0 ? { height: convertEmuToPixels(cyEmu) } : {}
+	};
+}
+/**
+* Look up a relationship ID in a map, with fallback for double "rId" prefix
+* that the library's generation code produces (e.g. "rIdrId7" → "rId7").
+*/
+function lookupRId(map, rId) {
+	if (!rId) return void 0;
+	const direct = map.get(rId);
+	if (direct) return direct;
+	if (rId.startsWith("rIdrId")) return map.get(rId.slice(3));
+}
+function parseChartDrawing(el, ctx) {
+	const chartRef = findDeep(el, "c:chart")[0];
+	if (!chartRef) return void 0;
+	const rId = attr(chartRef, "r:id");
+	const chartPath = lookupRId(ctx.docx.partRefs.charts, rId);
+	if (!chartPath) return void 0;
+	const chartXml = ctx.docx.doc.get(chartPath);
+	if (!chartXml) return void 0;
+	const opts = parseChartXml(chartXml);
+	if (!opts) return void 0;
+	const ext = getDrawingExtent(el);
+	if (ext.width !== void 0 || ext.height !== void 0) opts.transformation = { ...ext };
+	return { chart: opts };
+}
+/**
+* Parse c:chartSpace element into ChartOptions.
+*/
+function parseChartXml(el) {
+	const chart = findChild(el, "c:chart");
+	if (!chart) return void 0;
+	const opts = {};
+	const titleEl = findChild(chart, "c:title");
+	if (titleEl) {
+		const rich = findDeep(titleEl, "c:rich")[0];
+		if (rich) {
+			const t = findDeep(rich, "a:t")[0];
+			if (t) {
+				const title = textOf(t);
+				if (title) opts.title = title;
+			}
+		}
+	}
+	const plotArea = findChild(chart, "c:plotArea");
+	if (!plotArea) return void 0;
+	let chartType;
+	let typeElement;
+	for (const child of plotArea.elements ?? []) {
+		switch (child.name) {
+			case "c:barChart": {
+				const barDir = findChild(child, "c:barDir");
+				chartType = barDir && attr(barDir, "val") === "bar" ? "bar" : "column";
+				typeElement = child;
+				break;
+			}
+			case "c:lineChart":
+				chartType = "line";
+				typeElement = child;
+				break;
+			case "c:pieChart":
+				chartType = "pie";
+				typeElement = child;
+				break;
+			case "c:areaChart":
+				chartType = "area";
+				typeElement = child;
+				break;
+			case "c:scatterChart":
+				chartType = "scatter";
+				typeElement = child;
+				break;
+		}
+		if (chartType) break;
+	}
+	if (!chartType || !typeElement) return void 0;
+	opts.type = chartType;
+	const series = [];
+	let categories;
+	for (const serEl of typeElement.elements ?? []) {
+		if (serEl.name !== "c:ser") continue;
+		const nameParts = extractStrCache(serEl, "c:tx");
+		const cats = extractStrCache(serEl, "c:cat");
+		if (cats.length > 0 && !categories) categories = cats;
+		const vals = extractNumCache(serEl);
+		series.push({
+			name: nameParts[0] ?? "",
+			values: vals
+		});
+	}
+	opts.categories = categories ?? [];
+	opts.series = series;
+	opts.showLegend = findChild(chart, "c:legend") !== void 0;
+	const styleEl = findChild(el, "c:style");
+	if (styleEl) {
+		const val = attrNum(styleEl, "val");
+		if (val !== void 0) opts.style = val;
+	}
+	return opts;
+}
+/**
+* Extract string values from c:strCache within a container element.
+*/
+function extractStrCache(parent, containerName) {
+	const container = findChild(parent, containerName);
+	if (!container) return [];
+	const cache = findDeep(container, "c:strCache")[0];
+	if (!cache) return [];
+	const values = [];
+	for (const pt of cache.elements ?? []) {
+		if (pt.name !== "c:pt") continue;
+		const v = findChild(pt, "c:v");
+		if (v) values.push(textOf(v) ?? "");
+	}
+	return values;
+}
+/**
+* Extract numeric values from c:numCache within a c:val container.
+*/
+function extractNumCache(parent) {
+	const valEl = findChild(parent, "c:val");
+	if (!valEl) return [];
+	const cache = findDeep(valEl, "c:numCache")[0];
+	if (!cache) return [];
+	const values = [];
+	for (const pt of cache.elements ?? []) {
+		if (pt.name !== "c:pt") continue;
+		const v = findChild(pt, "c:v");
+		if (v) {
+			const num = Number(textOf(v));
+			if (!isNaN(num)) values.push(num);
+		}
+	}
+	return values;
+}
+function parseSmartArtDrawing(el, ctx) {
+	const relIds = findDeep(el, "dgm:relIds")[0];
+	if (!relIds) return void 0;
+	const rId = attr(relIds, "r:dm");
+	const dataPath = lookupRId(ctx.docx.partRefs.diagramData, rId);
+	if (!dataPath) return void 0;
+	const dataEl = ctx.docx.doc.get(dataPath);
+	if (!dataEl) return void 0;
+	const opts = parseSmartArtDataXml(dataEl);
+	if (!opts) return void 0;
+	const ext = getDrawingExtent(el);
+	if (ext.width !== void 0 || ext.height !== void 0) opts.transformation = { ...ext };
+	return { smartArt: opts };
+}
+/**
+* Parse dgm:dataModel element into SmartArtOptions.
+*/
+function parseSmartArtDataXml(el) {
+	const ptLst = findChild(el, "dgm:ptLst");
+	if (!ptLst) return void 0;
+	const opts = {};
+	const nodeMap = /* @__PURE__ */ new Map();
+	for (const pt of ptLst.elements ?? []) {
+		if (pt.name !== "dgm:pt") continue;
+		const type = attr(pt, "type");
+		const modelId = attr(pt, "modelId");
+		if (type === "doc") {
+			const prSet = findChild(pt, "dgm:prSet");
+			if (prSet) {
+				const loTypeId = attr(prSet, "loTypeId") ?? "";
+				const qsTypeId = attr(prSet, "qsTypeId") ?? "";
+				const csTypeId = attr(prSet, "csTypeId") ?? "";
+				const layout = loTypeId.split("/").pop();
+				if (layout) opts.layout = layout;
+				const style = qsTypeId.split("/").pop();
+				if (style) opts.style = style;
+				const color = csTypeId.split("/").pop();
+				if (color) opts.color = color;
+			}
+		} else if (type === "node" && modelId) {
+			const t = findDeep(pt, "a:t")[0];
+			nodeMap.set(modelId, t ? textOf(t) ?? "" : "");
+		}
+	}
+	const cxnLst = findChild(el, "dgm:cxnLst");
+	if (!cxnLst) {
+		opts.data = { nodes: [] };
+		return opts;
+	}
+	const childrenMap = /* @__PURE__ */ new Map();
+	for (const cxn of cxnLst.elements ?? []) {
+		if (cxn.name !== "dgm:cxn") continue;
+		const srcId = attr(cxn, "srcId");
+		const destId = attr(cxn, "destId");
+		if (!srcId || !destId || !nodeMap.has(destId)) continue;
+		let arr = childrenMap.get(srcId);
+		if (!arr) {
+			arr = [];
+			childrenMap.set(srcId, arr);
+		}
+		arr.push(destId);
+	}
+	opts.data = { nodes: (childrenMap.get("0") ?? []).map((id) => buildSmartArtNode(id, nodeMap, childrenMap)) };
+	return opts;
+}
+function buildSmartArtNode(id, nodeMap, childrenMap) {
+	const text = nodeMap.get(id) ?? "";
+	const childIds = childrenMap.get(id) ?? [];
+	if (childIds.length === 0) return { text };
+	return {
+		text,
+		children: childIds.map((cid) => buildSmartArtNode(cid, nodeMap, childrenMap))
+	};
+}
+//#endregion
+//#region src/parts/drawing/descriptor.ts
+/**
+* Drawing descriptor for DOCX documents.
+*
+* Produces `<w:drawing>` XML directly from media data and options,
+* eliminating the Drawing/Inline/Anchor/Graphic/GraphicData/Pic XmlComponent
+* class chain (~10 instances per drawing in the old path).
+*
+* Common path (inline image/chart/smartart without advanced properties):
+* zero XmlComponent instances — pure string concatenation.
+*
+* Advanced properties (outline, fill, effects on images) and floating
+* positioning use core `create*()` + `.toXml({stack:[]})` for sub-elements
+* (lightweight BuilderElement instances, not deep hierarchies).
+*
+* Reference: ISO/IEC 29500-4, wml.xsd, CT_Drawing
+*
+* @module
+*/
+const NOOP_CTX = {
+	addRelationship: () => "",
+	addMedia: () => ""
+};
+let _docPropsIdGen = uniqueNumericIdCreator();
+/** Reset the doc properties ID generator (for testing). */
+const resetDrawingIdGen = () => {
+	_docPropsIdGen = uniqueNumericIdCreator();
+};
+const GRAPHIC_NS = "xmlns:a=\"http://schemas.openxmlformats.org/drawingml/2006/main\"";
+const PIC_URI = "http://schemas.openxmlformats.org/drawingml/2006/picture";
+const CHART_URI = "http://schemas.openxmlformats.org/drawingml/2006/chart";
+const DGM_URI = "http://schemas.openxmlformats.org/drawingml/2006/diagram";
+const WPS_URI = "http://schemas.microsoft.com/office/word/2010/wordprocessingShape";
+const WPG_URI = "http://schemas.microsoft.com/office/word/2010/wordprocessingGroup";
+const HYPERLINK_REL = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/hyperlink";
+function registerHyperlinks(hyperlink, ctx) {
+	if (!hyperlink) return {};
+	const result = {};
+	if (hyperlink.click) {
+		const linkId = uniqueId();
+		ctx.viewWrapper.relationships.addRelationship(linkId, HYPERLINK_REL, hyperlink.click, TargetModeType.EXTERNAL);
+		result.clickId = `rId${linkId}`;
+	}
+	if (hyperlink.hover) {
+		const linkId = uniqueId();
+		ctx.viewWrapper.relationships.addRelationship(linkId, HYPERLINK_REL, hyperlink.hover, TargetModeType.EXTERNAL);
+		result.hoverId = `rId${linkId}`;
+	}
+	return result;
+}
+function buildHyperlinkChildren(ids) {
+	const parts = [];
+	const aNs = "xmlns:a=\"http://schemas.openxmlformats.org/drawingml/2006/main\"";
+	if (ids.clickId) parts.push(`<a:hlinkClick r:id="${ids.clickId}" ${aNs}/>`);
+	if (ids.hoverId) parts.push(`<a:hlinkHover r:id="${ids.hoverId}" ${aNs}/>`);
+	return parts.join("");
+}
+function stringifyDocPr(opts, hlIds) {
+	const id = opts?.id ?? _docPropsIdGen();
+	const name = opts?.name ?? "";
+	const attrs = [`id="${id}"`, `name="${escapeXml(name)}"`];
+	if (opts?.description != null && opts.description !== void 0) attrs.push(`descr="${escapeXml(opts.description)}"`);
+	if (opts?.title != null && opts.title !== void 0) attrs.push(`title="${escapeXml(opts.title)}"`);
+	const hlXml = buildHyperlinkChildren(hlIds);
+	if (hlXml) return `<wp:docPr ${attrs.join(" ")}>${hlXml}</wp:docPr>`;
+	return `<wp:docPr ${attrs.join(" ")}/>`;
+}
+function stringifyBlipFill(mediaData, blipEffects, tile) {
+	const fileName = mediaData.type === "svg" && "fallback" in mediaData ? mediaData.fallback.fileName : mediaData.fileName;
+	const parts = [];
+	const blipAttrs = [`r:embed="{${escapeXml(fileName)}}"`, "cstate=\"none\""];
+	const blipContent = (mediaData.type === "svg" ? `<a:extLst><a:ext uri="{96DAC541-7B7A-43D3-8B79-37D633B846F1}"><asvg:svgBlip xmlns:asvg="http://schemas.microsoft.com/office/drawing/2016/SVG/main" r:embed="{${escapeXml(mediaData.fileName)}}"/></a:ext></a:extLst>` : "") + (blipEffects ? buildBlipEffectsXml(blipEffects) : "");
+	if (blipContent) parts.push(`<a:blip ${blipAttrs.join(" ")}>${blipContent}</a:blip>`);
+	else parts.push(`<a:blip ${blipAttrs.join(" ")}/>`);
+	if (mediaData.srcRect) {
+		const srAttrs = [];
+		if (mediaData.srcRect.left !== void 0) srAttrs.push(`l="${mediaData.srcRect.left}"`);
+		if (mediaData.srcRect.top !== void 0) srAttrs.push(`t="${mediaData.srcRect.top}"`);
+		if (mediaData.srcRect.right !== void 0) srAttrs.push(`r="${mediaData.srcRect.right}"`);
+		if (mediaData.srcRect.bottom !== void 0) srAttrs.push(`b="${mediaData.srcRect.bottom}"`);
+		if (srAttrs.length) parts.push(`<a:srcRect ${srAttrs.join(" ")}/>`);
+	}
+	if (tile) {
+		const tileAttrs = [];
+		if (tile.tx !== void 0) tileAttrs.push(`tx="${tile.tx}"`);
+		if (tile.ty !== void 0) tileAttrs.push(`ty="${tile.ty}"`);
+		if (tile.sx !== void 0) tileAttrs.push(`sx="${tile.sx}"`);
+		if (tile.sy !== void 0) tileAttrs.push(`sy="${tile.sy}"`);
+		const tileAttrStr = tileAttrs.length ? " " + tileAttrs.join(" ") : "";
+		parts.push(`<a:tile${tileAttrStr}/>`);
+	} else parts.push("<a:stretch><a:fillRect/></a:stretch>");
+	return `<pic:blipFill>${parts.join("")}</pic:blipFill>`;
+}
+function buildBlipEffectsXml(opts) {
+	const parts = [];
+	if (opts.grayscale) parts.push("<a:grayscl/>");
+	if (opts.luminance) {
+		const a = [];
+		if (opts.luminance.bright !== void 0) a.push(`bright="${opts.luminance.bright}%"`);
+		if (opts.luminance.contrast !== void 0) a.push(`contrast="${opts.luminance.contrast}%"`);
+		parts.push(`<a:lum${a.length ? " " + a.join(" ") : ""}/>`);
+	}
+	if (opts.biLevel) parts.push(`<a:biLevel thresh="${opts.biLevel.threshold}%"/>`);
+	if (opts.blur) {
+		const a = [];
+		if (opts.blur.radius !== void 0) a.push(`rad="${opts.blur.radius}"`);
+		if (opts.blur.grow === false) a.push("grow=\"0\"");
+		parts.push(`<a:blur${a.length ? " " + a.join(" ") : ""}/>`);
+	}
+	return parts.join("");
+}
+function stringifyShapeProps(transform, outline, fill, effects) {
+	const parts = [];
+	parts.push(transform2DDesc.stringify({
+		x: transform.offset?.emus?.x ?? 0,
+		y: transform.offset?.emus?.y ?? 0,
+		width: transform.emus.x,
+		height: transform.emus.y,
+		flipHorizontal: transform.flip?.horizontal,
+		flipVertical: transform.flip?.vertical,
+		rotation: transform.rotation
+	}, NOOP_CTX) ?? "");
+	parts.push("<a:prstGeom prst=\"rect\"><a:avLst/></a:prstGeom>");
+	if (fill) parts.push(fillDesc.stringify(fill, NOOP_CTX) ?? "");
+	if (outline) parts.push(outlineDesc.stringify(outline, NOOP_CTX) ?? "");
+	if (effects) parts.push(effectListDesc.stringify(effects, NOOP_CTX) ?? "");
+	return `<pic:spPr bwMode="auto">${parts.join("")}</pic:spPr>`;
+}
+function stringifyNvPicPr(hlIds) {
+	const hlXml = buildHyperlinkChildren(hlIds);
+	return `<pic:nvPicPr><pic:cNvPr id="0" name="" descr=""${hlXml ? `>${hlXml}</pic:cNvPr>` : "/>"}<pic:cNvPicPr preferRelativeResize="1"><a:picLocks noChangeArrowheads="1" noChangeAspect="1"/></pic:cNvPicPr></pic:nvPicPr>`;
+}
+function stringifyGroupTransform2D(transform, chOff, chExt) {
+	const attrs = [];
+	if (transform.flip?.horizontal !== void 0) attrs.push(`flipH="${transform.flip.horizontal}"`);
+	if (transform.flip?.vertical !== void 0) attrs.push(`flipV="${transform.flip.vertical}"`);
+	if (transform.rotation !== void 0) attrs.push(`rot="${transform.rotation}"`);
+	return `<a:xfrm${attrs.length ? " " + attrs.join(" ") : ""}>${`<a:off x="${transform.offset?.emus?.x ?? 0}" y="${transform.offset?.emus?.y ?? 0}"/>`}${`<a:ext cx="${transform.emus.x}" cy="${transform.emus.y}"/>`}${chOff ? `<a:chOff x="${chOff.x}" y="${chOff.y}"/>` : ""}${chExt ? `<a:chExt cx="${chExt.cx}" cy="${chExt.cy}"/>` : ""}</a:xfrm>`;
+}
+function stringifyWpsShape(opts, ctx) {
+	const transform = opts.transformation;
+	const spPrParts = [];
+	spPrParts.push(transform2DDesc.stringify({
+		x: transform.offset?.emus?.x ?? 0,
+		y: transform.offset?.emus?.y ?? 0,
+		width: transform.emus.x,
+		height: transform.emus.y,
+		flipHorizontal: transform.flip?.horizontal,
+		flipVertical: transform.flip?.vertical,
+		rotation: transform.rotation
+	}, NOOP_CTX) ?? "");
+	if (opts.customGeometry) spPrParts.push(customGeometryDesc.stringify(opts.customGeometry, NOOP_CTX) ?? "");
+	else spPrParts.push("<a:prstGeom prst=\"rect\"><a:avLst/></a:prstGeom>");
+	if (opts.fill) spPrParts.push(fillDesc.stringify(opts.fill, NOOP_CTX) ?? "");
+	if (opts.outline) spPrParts.push(outlineDesc.stringify(opts.outline, NOOP_CTX) ?? "");
+	if (opts.effectDag) spPrParts.push(createEffectDag(opts.effectDag));
+	else if (opts.effects) spPrParts.push(effectListDesc.stringify(opts.effects, NOOP_CTX) ?? "");
+	if (opts.scene3d) spPrParts.push(scene3DDesc.stringify(opts.scene3d, NOOP_CTX) ?? "");
+	if (opts.shape3d) spPrParts.push(shape3DDesc.stringify(opts.shape3d, NOOP_CTX) ?? "");
+	const cNvSpPr = opts.nonVisualProperties ? stringifyNonVisualShapeProperties(opts.nonVisualProperties) : "<wps:cNvSpPr txBox=\"1\"/>";
+	const childXml = opts.children?.map((c) => stringifyParagraphInline(c, ctx)).join("") ?? "";
+	return "<wps:wsp>" + cNvSpPr + `<wps:spPr bwMode="auto">${spPrParts.join("")}</wps:spPr><wps:txbx><wps:txbxContent>${childXml}</wps:txbxContent></wps:txbx>` + stringifyBodyPr(opts.bodyProperties) + "</wps:wsp>";
+}
+function stringifyNonVisualShapeProperties(opts) {
+	if (!opts.txBox) return "<wps:cNvSpPr/>";
+	return `<wps:cNvSpPr txBox="${opts.txBox}"/>`;
+}
+function stringifyBodyPr(opts) {
+	if (!opts) return "<wps:bodyPr/>";
+	const attrs = [];
+	if (opts.anchor !== void 0) attrs.push(`anchor="${opts.anchor}"`);
+	if (opts.vert !== void 0) attrs.push(`vert="${opts.vert}"`);
+	if (opts.wrap !== void 0) attrs.push(`wrap="${opts.wrap}"`);
+	if (opts.lIns !== void 0) attrs.push(`lIns="${opts.lIns}"`);
+	if (opts.tIns !== void 0) attrs.push(`tIns="${opts.tIns}"`);
+	if (opts.rIns !== void 0) attrs.push(`rIns="${opts.rIns}"`);
+	if (opts.bIns !== void 0) attrs.push(`bIns="${opts.bIns}"`);
+	if (opts.numCol !== void 0) attrs.push(`numCol="${opts.numCol}"`);
+	if (opts.rotation !== void 0) attrs.push(`rot="${opts.rotation}"`);
+	const attrStr = attrs.length ? " " + attrs.join(" ") : "";
+	const parts = [];
+	if (opts.normAutofit) {
+		const afAttrs = [];
+		if (opts.normAutofit.fontScale !== void 0) afAttrs.push(`fontScale="${opts.normAutofit.fontScale}"`);
+		if (opts.normAutofit.lnSpcReduction !== void 0) afAttrs.push(`lnSpcReduction="${opts.normAutofit.lnSpcReduction}"`);
+		parts.push(`<a:normAutofit ${afAttrs.join(" ")}/>`);
+	}
+	const body = parts.join("");
+	return body ? `<wps:bodyPr${attrStr}>${body}</wps:bodyPr>` : `<wps:bodyPr${attrStr}/>`;
+}
+function stringifyWpgGroup(opts, ctx) {
+	const transform = opts.transformation;
+	const grpSpPrParts = [];
+	grpSpPrParts.push(stringifyGroupTransform2D(transform, opts.chOff, opts.chExt));
+	if (opts.fill) grpSpPrParts.push(fillDesc.stringify(opts.fill, NOOP_CTX) ?? "");
+	if (opts.effects) grpSpPrParts.push(effectListDesc.stringify(opts.effects, NOOP_CTX) ?? "");
+	const childXml = opts.children.map((child) => {
+		if (child.type === "wps") {
+			const wpsData = child;
+			return stringifyWpsShape({
+				...wpsData.data,
+				outline: wpsData.outline ?? wpsData.data.outline,
+				fill: wpsData.fill ?? wpsData.data.fill,
+				transformation: wpsData.transformation
+			}, ctx);
+		}
+		const picData = child;
+		const picParts = [];
+		picParts.push("<pic:nvPicPr><pic:cNvPr id=\"0\" name=\"\" descr=\"\"/><pic:cNvPicPr preferRelativeResize=\"1\"><a:picLocks noChangeAspect=\"1\"/></pic:cNvPicPr></pic:nvPicPr>");
+		picParts.push(`<pic:blipFill><a:blip r:embed="{${picData.fileName}}" cstate="none"/><a:stretch><a:fillRect/></a:stretch></pic:blipFill>`);
+		picParts.push(`<pic:spPr bwMode="auto">${transform2DDesc.stringify({
+			x: picData.transformation.offset?.emus?.x ?? 0,
+			y: picData.transformation.offset?.emus?.y ?? 0,
+			width: picData.transformation.emus.x,
+			height: picData.transformation.emus.y
+		}, NOOP_CTX) ?? "<a:xfrm/>"}<a:prstGeom prst="rect"><a:avLst/></a:prstGeom></pic:spPr>`);
+		return `<pic:pic xmlns:pic="${PIC_URI}">${picParts.join("")}</pic:pic>`;
+	}).join("");
+	return `<wpg:wgp><wpg:cNvGrpSpPr/><wpg:grpSpPr>${grpSpPrParts.join("")}</wpg:grpSpPr>` + childXml + "</wpg:wgp>";
+}
+function stringifyGraphicDataContent(mediaData, opts, hlIds, ctx) {
+	const { outline, fill, effects, blipEffects, tile } = opts;
+	const transform = mediaData.transformation;
+	if (mediaData.type === "chart") return `<a:graphicData uri="${CHART_URI}"><c:chart xmlns:c="${CHART_URI}" xmlns:r="http://schemas.openxmlformats.org/officeDocument/2006/relationships" r:id="{chart:${mediaData.chartKey}}"/></a:graphicData>`;
+	if (mediaData.type === "smartart") {
+		const md = mediaData;
+		return `<a:graphicData uri="${DGM_URI}"><dgm:relIds xmlns:dgm="${DGM_URI}" xmlns:r="http://schemas.openxmlformats.org/officeDocument/2006/relationships" r:dm="{smartart:${md.smartArtKey}}" r:lo="{smartart-lo:${md.smartArtKey}}" r:qs="{smartart-qs:${md.smartArtKey}}" r:cs="{smartart-cs:${md.smartArtKey}}"/></a:graphicData>`;
+	}
+	if (mediaData.type === "wps") return `<a:graphicData uri="${WPS_URI}">${stringifyWpsShape({
+		...mediaData.data,
+		outline,
+		fill,
+		transformation: transform
+	}, ctx)}</a:graphicData>`;
+	if (mediaData.type === "wpg") {
+		const md = mediaData;
+		return `<a:graphicData uri="${WPG_URI}">${stringifyWpgGroup({
+			children: md.children,
+			transformation: transform,
+			chOff: md.chOff,
+			chExt: md.chExt,
+			fill: md.fill,
+			effects: md.effects
+		}, ctx)}</a:graphicData>`;
+	}
+	const md = mediaData;
+	return `<a:graphicData uri="${PIC_URI}"><pic:pic xmlns:pic="${PIC_URI}">` + stringifyNvPicPr(hlIds) + stringifyBlipFill(md, blipEffects, tile) + stringifyShapeProps(transform, outline, fill, effects) + `</pic:pic></a:graphicData>`;
+}
+function stringifyPositionH(opts) {
+	return `<wp:positionH relativeFrom="${opts.relative ?? HorizontalPositionRelativeFrom.PAGE}">${opts.align ? `<wp:align>${opts.align}</wp:align>` : opts.offset !== void 0 ? `<wp:posOffset>${opts.offset}</wp:posOffset>` : "<wp:align>left</wp:align>"}</wp:positionH>`;
+}
+function stringifyPositionV(opts) {
+	return `<wp:positionV relativeFrom="${opts.relative ?? VerticalPositionRelativeFrom.PAGE}">${opts.align ? `<wp:align>${opts.align}</wp:align>` : opts.offset !== void 0 ? `<wp:posOffset>${opts.offset}</wp:posOffset>` : "<wp:align>top</wp:align>"}</wp:positionV>`;
+}
+function wrapPolygonStr(cx, cy) {
+	return `<wp:wrapPolygon edited="0"><wp:start x="0" y="0"/><wp:lineTo x="0" y="${-cy}"/><wp:lineTo x="${cx}" y="${-cy}"/><wp:lineTo x="${cx}" y="0"/><wp:lineTo x="0" y="0"/></wp:wrapPolygon>`;
+}
+function wrapSquareStr(textWrapping, margins) {
+	const side = textWrapping.side ?? TextWrappingSide.BOTH_SIDES;
+	const m = margins ?? {};
+	return `<wp:wrapSquare ${[
+		`wrapText="${side}"`,
+		...m.top != null ? [`distT="${m.top}"`] : [],
+		...m.bottom != null ? [`distB="${m.bottom}"`] : [],
+		...m.left != null ? [`distL="${m.left}"`] : [],
+		...m.right != null ? [`distR="${m.right}"`] : []
+	].join(" ")}/>`;
+}
+function wrapTightStr(textWrapping, margins, cx, cy) {
+	const a = [`wrapText="${textWrapping.side ?? TextWrappingSide.BOTH_SIDES}"`];
+	if (margins.left != null) a.push(`distL="${margins.left}"`);
+	if (margins.right != null) a.push(`distR="${margins.right}"`);
+	return `<wp:wrapTight ${a.join(" ")}>${wrapPolygonStr(cx, cy)}</wp:wrapTight>`;
+}
+function wrapThroughStr(textWrapping, margins, cx, cy) {
+	const a = [`wrapText="${textWrapping.side ?? TextWrappingSide.BOTH_SIDES}"`];
+	if (margins.left != null) a.push(`distL="${margins.left}"`);
+	if (margins.right != null) a.push(`distR="${margins.right}"`);
+	return `<wp:wrapThrough ${a.join(" ")}>${wrapPolygonStr(cx, cy)}</wp:wrapThrough>`;
+}
+function wrapTopAndBottomStr(margins) {
+	const m = margins ?? {};
+	const a = [...m.top != null ? [`distT="${m.top}"`] : [], ...m.bottom != null ? [`distB="${m.bottom}"`] : []].join(" ");
+	return a ? `<wp:wrapTopAndBottom ${a}/>` : "<wp:wrapTopAndBottom/>";
+}
+function stringifyInline(opts, hlIds, ctx) {
+	const { mediaData, effects, docProperties } = opts;
+	const cx = mediaData.transformation.emus.x;
+	const cy = mediaData.transformation.emus.y;
+	const effectExtent = calculateEffectExtent(effects);
+	const graphicDataXml = stringifyGraphicDataContent(mediaData, opts, hlIds, ctx);
+	return `<w:drawing><wp:inline distT="0" distB="0" distL="0" distR="0"><wp:extent cx="${cx}" cy="${cy}"/><wp:effectExtent l="${effectExtent.l}" t="${effectExtent.t}" r="${effectExtent.r}" b="${effectExtent.b}"/>` + stringifyDocPr(docProperties, hlIds) + `<wp:cNvGraphicFramePr><a:graphicFrameLocks noChangeAspect="1" xmlns:a="http://schemas.openxmlformats.org/drawingml/2006/main"/></wp:cNvGraphicFramePr><a:graphic ${GRAPHIC_NS}>${graphicDataXml}</a:graphic></wp:inline></w:drawing>`;
+}
+function stringifyAnchor(opts, hlIds, ctx) {
+	const { mediaData, floating: rawFloating, docProperties } = opts;
+	const cx = mediaData.transformation.emus.x;
+	const cy = mediaData.transformation.emus.y;
+	const floating = {
+		allowOverlap: true,
+		behindDocument: false,
+		horizontalPosition: {},
+		layoutInCell: true,
+		lockAnchor: false,
+		verticalPosition: {},
+		zIndex: mediaData.transformation.emus.y,
+		margins: {},
+		wrap: { type: TextWrappingType.NONE },
+		...rawFloating
+	};
+	const attrParts = [
+		`distT="${floating.margins?.top ?? 0}"`,
+		`distB="${floating.margins?.bottom ?? 0}"`,
+		`distL="${floating.margins?.left ?? 0}"`,
+		`distR="${floating.margins?.right ?? 0}"`,
+		"simplePos=\"0\"",
+		`allowOverlap="${floating.allowOverlap ? 1 : 0}"`,
+		`behindDoc="${floating.behindDocument ? 1 : 0}"`,
+		`locked="${floating.lockAnchor ? 1 : 0}"`,
+		`layoutInCell="${floating.layoutInCell ? 1 : 0}"`,
+		`relativeHeight="${floating.zIndex}"`
+	];
+	let wrapXml;
+	const rawWrap = rawFloating?.wrap;
+	if (rawWrap?.type === TextWrappingType.SQUARE) wrapXml = wrapSquareStr(rawWrap, floating.margins);
+	else if (rawWrap?.type === TextWrappingType.TIGHT) wrapXml = wrapTightStr(rawWrap, floating.margins, cx, cy);
+	else if (rawWrap?.type === TextWrappingType.THROUGH) wrapXml = wrapThroughStr(rawWrap, floating.margins, cx, cy);
+	else if (rawWrap?.type === TextWrappingType.TOP_AND_BOTTOM) wrapXml = wrapTopAndBottomStr(floating.margins);
+	else wrapXml = "<wp:wrapNone/>";
+	const graphicDataXml = stringifyGraphicDataContent(mediaData, opts, hlIds, ctx);
+	return `<w:drawing><wp:anchor ${attrParts.join(" ")}><wp:simplePos x="0" y="0"/>` + stringifyPositionH(floating.horizontalPosition) + stringifyPositionV(floating.verticalPosition) + `<wp:extent cx="${cx}" cy="${cy}"/><wp:effectExtent l="0" t="0" r="0" b="0"/>` + wrapXml + stringifyDocPr(docProperties, hlIds) + `<wp:cNvGraphicFramePr><a:graphicFrameLocks noChangeAspect="1" xmlns:a="http://schemas.openxmlformats.org/drawingml/2006/main"/></wp:cNvGraphicFramePr><a:graphic ${GRAPHIC_NS}>${graphicDataXml}</a:graphic></wp:anchor></w:drawing>`;
+}
+/**
+* Drawing descriptor for DOCX `<w:drawing>` elements.
+*
+* Eliminates the Drawing/Inline/Anchor/Graphic/GraphicData/Pic XmlComponent
+* class chain. Inline images, charts, and smartarts produce XML via pure
+* string concatenation — zero XmlComponent instances.
+*
+* @example
+* ```typescript
+* const xml = drawingDesc.stringify({ mediaData, docProperties: opts.altText, floating: opts.floating }, ctx);
+* ```
+*/
+const drawingDesc = {
+	kind: "custom",
+	stringify(opts, ctx) {
+		if (opts.fill) {
+			const media = extractBlipFillMedia(opts.fill);
+			if (media) ctx.file.media.addImage(media.fileName, {
+				data: media.data,
+				fileName: media.fileName,
+				type: media.type,
+				transformation: {
+					pixels: {
+						x: 0,
+						y: 0
+					},
+					emus: {
+						x: 0,
+						y: 0
+					}
+				}
+			});
+		}
+		const hlIds = registerHyperlinks(opts.docProperties?.hyperlink, ctx);
+		if (opts.floating) return stringifyAnchor(opts, hlIds, ctx);
+		return stringifyInline(opts, hlIds, ctx);
+	},
+	parse(el, ctx) {
+		return parseDrawingRun(el, ctx) ?? {};
+	}
+};
+//#endregion
+//#region src/parts/paragraph/math/stringify.ts
+/**
+* Direct XML string builders for Office MathML (OMML).
+*
+* Replaces `coerceMathInput()` + `new Math().toXml()` recursive class chain
+* with direct string concatenation — zero XmlComponent instances.
+*
+* Processes `MathInput` discriminated union directly to XML strings.
+*
+* @module
+*/
+function mathRunPropsStr(opts) {
+	const parts = [];
+	if (opts.lit) parts.push("<m:lit m:val=\"1\"/>");
+	if (opts.normal) parts.push("<m:nor m:val=\"1\"/>");
+	if (opts.script) parts.push(`<m:scr m:val="${opts.script}"/>`);
+	if (opts.style) parts.push(`<m:sty m:val="${opts.style}"/>`);
+	if (opts.breakAlignment) parts.push(`<m:brk m:alnAt="${opts.breakAlignment}"/>`);
+	if (opts.align) parts.push("<m:aln m:val=\"1\"/>");
+	return parts.length ? `<m:rPr>${parts.join("")}</m:rPr>` : "";
+}
+function stringifyChildren(items) {
+	return items.map(stringifyMathInput).join("");
+}
+function stringifyMathInput(value) {
+	if (typeof value === "string") return `<m:r><m:t>${escapeXml(value)}</m:t></m:r>`;
+	if (typeof value !== "object" || value === null) return "";
+	if ("subSuperScript" in value) {
+		const opts = value.subSuperScript;
+		return `<m:sSubSup><m:sSubSupPr/><m:e>${stringifyChildren(opts.children)}</m:e><m:sub>${stringifyChildren(opts.subScript)}</m:sub><m:sup>${stringifyChildren(opts.superScript)}</m:sup></m:sSubSup>`;
+	}
+	if ("preSubSuperScript" in value) {
+		const opts = value.preSubSuperScript;
+		return `<m:sPre><m:sPrePr/><m:sub>${stringifyChildren(opts.subScript)}</m:sub><m:sup>${stringifyChildren(opts.superScript)}</m:sup><m:e>${stringifyChildren(opts.children)}</m:e></m:sPre>`;
+	}
+	if ("superScript" in value) {
+		const opts = value.superScript;
+		return `<m:sSup><m:sSupPr/><m:e>${stringifyChildren(opts.children)}</m:e><m:sup>${stringifyChildren(opts.superScript)}</m:sup></m:sSup>`;
+	}
+	if ("subScript" in value) {
+		const opts = value.subScript;
+		return `<m:sSub><m:sSubPr/><m:e>${stringifyChildren(opts.children)}</m:e><m:sub>${stringifyChildren(opts.subScript)}</m:sub></m:sSub>`;
+	}
+	if ("fraction" in value) {
+		const opts = value.fraction;
+		return `<m:f>${opts.fractionType ? `<m:fPr><m:type m:val="${opts.fractionType}"/></m:fPr>` : ""}<m:num>${stringifyChildren(opts.numerator)}</m:num><m:den>${stringifyChildren(opts.denominator)}</m:den></m:f>`;
+	}
+	if ("radical" in value) {
+		const opts = value.radical;
+		const hasDegree = opts.degree && opts.degree.length > 0;
+		return `<m:rad>${!hasDegree ? "<m:radPr><m:degHide m:val=\"1\"/></m:radPr>" : "<m:radPr/>"}${hasDegree ? `<m:deg>${stringifyChildren(opts.degree)}</m:deg>` : "<m:deg/>"}<m:e>${stringifyChildren(opts.children)}</m:e></m:rad>`;
+	}
+	if ("sum" in value) return stringifyNAry(value.sum, "∑");
+	if ("integral" in value) return stringifyNAry(value.integral, "∫");
+	if ("limitLower" in value) {
+		const opts = value.limitLower;
+		return `<m:limLow>${opts.properties ? "" : ""}<m:e>${stringifyChildren(opts.children)}</m:e><m:lim>${stringifyChildren(opts.limit)}</m:lim></m:limLow>`;
+	}
+	if ("limitUpper" in value) {
+		const opts = value.limitUpper;
+		return `<m:limUpp>${opts.properties ? "" : ""}<m:e>${stringifyChildren(opts.children)}</m:e><m:lim>${stringifyChildren(opts.limit)}</m:lim></m:limUpp>`;
+	}
+	if ("function" in value) {
+		const opts = value.function;
+		return `<m:func>${opts.properties ? "" : ""}<m:fName>${stringifyChildren(opts.name)}</m:fName><m:e>${stringifyChildren(opts.children)}</m:e></m:func>`;
+	}
+	if ("matrix" in value) {
+		const opts = value.matrix;
+		const rows = opts.rows.map((row) => `<m:mr>${row.map((cell) => `<m:e>${stringifyMathInput(cell)}</m:e>`).join("")}</m:mr>`).join("");
+		let pr = "";
+		if (opts.properties) {
+			const p = opts.properties;
+			const prParts = [];
+			if (p.baseJc) prParts.push(`<m:baseJc m:val="${p.baseJc}"/>`);
+			if (p.plcHide) prParts.push("<m:plcHide m:val=\"1\"/>");
+			if (p.rSpRule) prParts.push(`<m:rSpRule m:val="${p.rSpRule}"/>`);
+			if (p.cGpRule) prParts.push(`<m:cGpRule m:val="${p.cGpRule}"/>`);
+			if (p.rSp) prParts.push(`<m:rSp m:val="${p.rSp}"/>`);
+			if (p.cSp) prParts.push(`<m:cSp m:val="${p.cSp}"/>`);
+			if (p.cGp) prParts.push(`<m:cGp m:val="${p.cGp}"/>`);
+			if (p.mcs) {
+				const mcItems = p.mcs.map((mc) => `<m:mc><m:mcPr><m:count m:val="${mc.count}"/><m:mcJc m:val="${mc.mcJc}"/></m:mcPr></m:mc>`).join("");
+				prParts.push(`<m:mcs>${mcItems}</m:mcs>`);
+			}
+			if (prParts.length) pr = `<m:mPr>${prParts.join("")}</m:mPr>`;
+		}
+		return `<m:m>${pr}${rows}</m:m>`;
+	}
+	if ("roundBrackets" in value) return stringifyDelimiters(bracketChildren(value.roundBrackets), "(", ")");
+	if ("curlyBrackets" in value) return stringifyDelimiters(bracketChildren(value.curlyBrackets), "{", "}");
+	if ("angledBrackets" in value) return stringifyDelimiters(bracketChildren(value.angledBrackets), "〈", "〉");
+	if ("squareBrackets" in value) return stringifyDelimiters(bracketChildren(value.squareBrackets), "[", "]");
+	if ("borderBox" in value) {
+		const opts = value.borderBox;
+		let pr = "";
+		if (opts.properties) {
+			const p = opts.properties;
+			const parts = [];
+			if (p.hideTop) parts.push("<m:hideTop m:val=\"1\"/>");
+			if (p.hideBottom) parts.push("<m:hideBot m:val=\"1\"/>");
+			if (p.hideLeft) parts.push("<m:hideLeft m:val=\"1\"/>");
+			if (p.hideRight) parts.push("<m:hideRight m:val=\"1\"/>");
+			if (p.strikeHorizontal) parts.push("<m:strikeH m:val=\"1\"/>");
+			if (p.strikeVertical) parts.push("<m:strikeV m:val=\"1\"/>");
+			if (p.strikeDiagonalUp) parts.push("<m:strikeBLTR m:val=\"1\"/>");
+			if (p.strikeDiagonalDown) parts.push("<m:strikeTLBR m:val=\"1\"/>");
+			if (parts.length) pr = `<m:borderBoxPr>${parts.join("")}</m:borderBoxPr>`;
+		}
+		return `<m:borderBox>${pr}<m:e>${stringifyChildren(opts.children)}</m:e></m:borderBox>`;
+	}
+	if ("box" in value) {
+		const opts = value.box;
+		let pr = "";
+		if (opts.properties) {
+			const p = opts.properties;
+			const parts = [];
+			if (p.opEmu) parts.push("<m:opEmu m:val=\"1\"/>");
+			if (p.noBreak) parts.push("<m:noBreak m:val=\"1\"/>");
+			if (p.diff) parts.push("<m:diff m:val=\"1\"/>");
+			if (p.aln) parts.push("<m:aln m:val=\"1\"/>");
+			if (parts.length) pr = `<m:boxPr>${parts.join("")}</m:boxPr>`;
+		}
+		return `<m:box>${pr}<m:e>${stringifyChildren(opts.children)}</m:e></m:box>`;
+	}
+	if ("groupChr" in value) {
+		const opts = value.groupChr;
+		let pr = "";
+		if (opts.properties) {
+			const p = opts.properties;
+			const parts = [];
+			if (p.chr) parts.push(`<m:chr m:val="${p.chr}"/>`);
+			if (p.pos) parts.push(`<m:pos m:val="${p.pos}"/>`);
+			if (p.vertJc) parts.push(`<m:vertJc m:val="${p.vertJc}"/>`);
+			if (parts.length) pr = `<m:groupChrPr>${parts.join("")}</m:groupChrPr>`;
+		}
+		return `<m:groupChr>${pr}<m:e>${stringifyChildren(opts.children)}</m:e></m:groupChr>`;
+	}
+	if ("phant" in value) {
+		const opts = value.phant;
+		let pr = "";
+		if (opts.properties) {
+			const p = opts.properties;
+			const parts = [];
+			if (p.show !== void 0) parts.push(`<m:show m:val="${p.show ? 1 : 0}"/>`);
+			if (p.zeroWid) parts.push("<m:zeroWid m:val=\"1\"/>");
+			if (p.zeroAsc) parts.push("<m:zeroAsc m:val=\"1\"/>");
+			if (p.zeroDesc) parts.push("<m:zeroDesc m:val=\"1\"/>");
+			if (p.transp) parts.push("<m:transp m:val=\"1\"/>");
+			if (parts.length) pr = `<m:phantPr>${parts.join("")}</m:phantPr>`;
+		}
+		return `<m:phant>${pr}<m:e>${stringifyChildren(opts.children)}</m:e></m:phant>`;
+	}
+	if ("eqArr" in value) {
+		const opts = value.eqArr;
+		let pr = "";
+		if (opts.properties) {
+			const p = opts.properties;
+			const parts = [];
+			if (p.baseJc) parts.push(`<m:baseJc m:val="${p.baseJc}"/>`);
+			if (p.maxDist) parts.push("<m:maxDist m:val=\"1\"/>");
+			if (p.objDist) parts.push("<m:objDist m:val=\"1\"/>");
+			if (p.rSpRule) parts.push(`<m:rSpRule m:val="${p.rSpRule}"/>`);
+			if (p.rSp) parts.push(`<m:rSp m:val="${p.rSp}"/>`);
+			if (parts.length) pr = `<m:eqArrPr>${parts.join("")}</m:eqArrPr>`;
+		}
+		const rows = opts.rows.map((row) => `<m:e>${stringifyChildren(row)}</m:e>`).join("");
+		return `<m:eqArr>${pr}${rows}</m:eqArr>`;
+	}
+	if ("accent" in value) {
+		const opts = value.accent;
+		return `<m:acc>${opts.accentCharacter ? `<m:accPr><m:chr m:val="${opts.accentCharacter}"/></m:accPr>` : ""}<m:e>${stringifyChildren(opts.children)}</m:e></m:acc>`;
+	}
+	if ("bar" in value) {
+		const opts = value.bar;
+		return `<m:bar><m:barPr><m:pos m:val="${opts.type}"/></m:barPr><m:e>${stringifyChildren(opts.children)}</m:e></m:bar>`;
+	}
+	if ("text" in value) return `<m:r>${value.properties ? mathRunPropsStr(value.properties) : ""}<m:t>${escapeXml(value.text)}</m:t></m:r>`;
+	return "";
+}
+function stringifyNAry(opts, chr) {
+	const hasSub = opts.subScript && opts.subScript.length > 0;
+	const hasSup = opts.superScript && opts.superScript.length > 0;
+	const prParts = [`<m:chr m:val="${chr}"/>`];
+	if (!hasSub) prParts.push("<m:subHide m:val=\"1\"/>");
+	if (!hasSup) prParts.push("<m:supHide m:val=\"1\"/>");
+	return `<m:nary>${`<m:naryPr>${prParts.join("")}</m:naryPr>`}${hasSub ? `<m:sub>${stringifyChildren(opts.subScript)}</m:sub>` : "<m:sub/>"}${hasSup ? `<m:sup>${stringifyChildren(opts.superScript)}</m:sup>` : "<m:sup/>"}<m:e>${stringifyChildren(opts.children)}</m:e></m:nary>`;
+}
+function stringifyDelimiters(children, begChr, endChr) {
+	return `<m:d><m:dPr><m:begChr m:val="${begChr}"/><m:endChr m:val="${endChr}"/></m:dPr><m:e>${stringifyChildren(children)}</m:e></m:d>`;
+}
+function bracketChildren(v) {
+	if (Array.isArray(v)) return v;
+	return v.children;
+}
+function stringifyMath(children) {
+	return `<m:oMath>${children.map((c) => stringifyMathInput(c)).join("")}</m:oMath>`;
+}
+/**
+* Parse all math children from an m:oMath (or similar container) element.
+*/
+function parseMathChildren(el) {
+	const result = [];
+	for (const child of el.elements ?? []) {
+		const parsed = parseMathElement(child);
+		if (parsed !== void 0) result.push(parsed);
+	}
+	return result;
+}
+function parseMathElement(el) {
+	switch (el.name) {
+		case "m:r": return parseMathRun(el);
+		case "m:f": return parseMathFraction(el);
+		case "m:rad": return parseMathRadical(el);
+		case "m:sSup": return parseMathSuperScript(el);
+		case "m:sSub": return parseMathSubScript(el);
+		case "m:sSubSup": return parseMathSubSuperScript(el);
+		case "m:nary": return parseMathNAry(el);
+		case "m:func": return parseMathFunction(el);
+		case "m:d": return parseMathDelimiter(el);
+		case "m:m": return parseMathMatrix(el);
+		case "m:acc": return parseMathAccent(el);
+		case "m:bar": return parseMathBar(el);
+		case "m:borderBox": return { borderBox: { children: parseMathArg(el, "m:e") } };
+		case "m:box": return { box: { children: parseMathArg(el, "m:e") } };
+		case "m:groupChr": return { groupChr: { children: parseMathArg(el, "m:e") } };
+		case "m:phant": return { phant: { children: parseMathArg(el, "m:e") } };
+		case "m:eqArr": return parseMathEqArr(el);
+		case "m:limLow": return parseMathLimitLower(el);
+		case "m:limUpp": return parseMathLimitUpper(el);
+		case "m:rPr":
+		case "m:fPr":
+		case "m:radPr":
+		case "m:sSupPr":
+		case "m:sSubPr":
+		case "m:sSubSupPr":
+		case "m:naryPr":
+		case "m:funcPr":
+		case "m:dPr":
+		case "m:mPr":
+		case "m:accPr":
+		case "m:barPr":
+		case "m:borderBoxPr":
+		case "m:boxPr":
+		case "m:groupChrPr":
+		case "m:phantPr":
+		case "m:eqArrPr":
+		case "m:limLowPr":
+		case "m:limUppPr":
+		case "m:ctrlPr": return;
+		default: return;
+	}
+}
+function parseMathRun(el) {
+	return textOf(findChild(el, "m:t")) ?? "";
+}
+function parseMathFraction(el) {
+	return { fraction: {
+		numerator: parseMathArg(el, "m:num"),
+		denominator: parseMathArg(el, "m:den")
+	} };
+}
+function parseMathRadical(el) {
+	const degree = parseMathArg(el, "m:deg");
+	return { radical: {
+		children: parseMathArg(el, "m:e"),
+		...degree.length > 0 ? { degree } : {}
+	} };
+}
+function parseMathSuperScript(el) {
+	return { superScript: {
+		children: parseMathArg(el, "m:e"),
+		superScript: parseMathArg(el, "m:sup")
+	} };
+}
+function parseMathSubScript(el) {
+	return { subScript: {
+		children: parseMathArg(el, "m:e"),
+		subScript: parseMathArg(el, "m:sub")
+	} };
+}
+function parseMathSubSuperScript(el) {
+	return { subSuperScript: {
+		children: parseMathArg(el, "m:e"),
+		subScript: parseMathArg(el, "m:sub"),
+		superScript: parseMathArg(el, "m:sup")
+	} };
+}
+function parseMathNAry(el) {
+	const naryPr = findChild(el, "m:naryPr");
+	const chrEl = naryPr ? findChild(naryPr, "m:chr") : void 0;
+	const chrVal = chrEl ? attr(chrEl, "m:val") : void 0;
+	const baseChildren = parseMathArg(el, "m:e");
+	const sub = parseMathArg(el, "m:sub");
+	const sup = parseMathArg(el, "m:sup");
+	const common = {
+		children: baseChildren,
+		...sub.length > 0 ? { subScript: sub } : {},
+		...sup.length > 0 ? { superScript: sup } : {}
+	};
+	if (chrVal === "∑") return { sum: common };
+	return { integral: common };
+}
+function parseMathFunction(el) {
+	return { function: {
+		name: parseMathArg(el, "m:fName"),
+		children: parseMathArg(el, "m:e")
+	} };
+}
+function parseMathDelimiter(el) {
+	const dPr = findChild(el, "m:dPr");
+	const begChrEl = dPr ? findChild(dPr, "m:begChr") : void 0;
+	const begChr = begChrEl ? attr(begChrEl, "m:val") : "(";
+	const mathChildren = parseMathArg(el, "m:e");
+	switch (begChr) {
+		case "[": return { squareBrackets: mathChildren };
+		case "{": return { curlyBrackets: mathChildren };
+		case "<":
+		case "⟨": return { angledBrackets: mathChildren };
+		default: return { roundBrackets: mathChildren };
+	}
+}
+function parseMathMatrix(el) {
+	const rows = [];
+	for (const mr of children(el, "m:mr")) rows.push(parseMathArg(mr, "m:e"));
+	return { matrix: { rows } };
+}
+function parseMathAccent(el) {
+	const accPr = findChild(el, "m:accPr");
+	const chrEl = accPr ? findChild(accPr, "m:chr") : void 0;
+	const accentChar = chrEl ? attr(chrEl, "m:val") : void 0;
+	return { accent: {
+		children: parseMathArg(el, "m:e"),
+		...accentChar ? { accentCharacter: accentChar } : {}
+	} };
+}
+function parseMathBar(el) {
+	const barPr = findChild(el, "m:barPr");
+	const posEl = barPr ? findChild(barPr, "m:pos") : void 0;
+	const pos = posEl ? attr(posEl, "m:val") : "top";
+	return { bar: {
+		children: parseMathArg(el, "m:e"),
+		type: pos ?? "top"
+	} };
+}
+function parseMathEqArr(el) {
+	const rows = [];
+	for (const e of children(el, "m:e")) rows.push(parseMathChildren(e));
+	return { eqArr: { rows } };
+}
+function parseMathLimitLower(el) {
+	return { limitLower: {
+		children: parseMathArg(el, "m:e"),
+		limit: parseMathArg(el, "m:lim")
+	} };
+}
+function parseMathLimitUpper(el) {
+	return { limitUpper: {
+		children: parseMathArg(el, "m:e"),
+		limit: parseMathArg(el, "m:lim")
+	} };
+}
+function parseMathArg(parent, childName) {
+	const container = findChild(parent, childName);
+	if (!container) return [];
+	return parseMathChildren(container);
+}
+//#endregion
+//#region src/parts/paragraph/stringify.ts
+/**
+* Direct XML string builders for paragraph and run properties.
+*
+* Replaces `buildParagraphProperties() + xml()` and `buildRunProperties() + xml()`
+* with direct string concatenation — zero intermediate IXmlableObject allocation,
+* zero recursive xml() traversal. Follows PPTX/XLSX pattern.
+*
+* @module
+*/
+/** On/off: `<w:name/>` for true, `<w:name w:val="0"/>` for false */
+function onOff(name, val) {
+	return val ? `<${name}/>` : `<${name} w:val="0"/>`;
+}
+/** Build attrs string from key-value pairs, skipping undefined */
+function attrParts(attrs) {
+	const parts = [];
+	for (const [key, val] of Object.entries(attrs)) if (val !== void 0) parts.push(`${key}="${val}"`);
+	return parts.join(" ");
+}
+function borderStr(name, opts) {
+	return `<${name} ${attrParts({
+		"w:val": opts.style,
+		"w:color": opts.color !== void 0 ? hexColorValue(opts.color) : void 0,
+		"w:sz": opts.size !== void 0 ? eighthPointMeasureValue(opts.size) : void 0,
+		"w:space": opts.space !== void 0 ? pointMeasureValue(opts.space) : void 0,
+		"w:themeColor": opts.themeColor,
+		"w:themeTint": opts.themeTint !== void 0 ? uCharHexNumber(opts.themeTint) : void 0,
+		"w:themeShade": opts.themeShade !== void 0 ? uCharHexNumber(opts.themeShade) : void 0,
+		"w:shadow": opts.shadow !== void 0 ? opts.shadow ? 1 : 0 : void 0,
+		"w:frame": opts.frame !== void 0 ? opts.frame ? 1 : 0 : void 0
+	})}/>`;
+}
+function shadingStr(opts) {
+	return `<w:shd ${attrParts({
+		"w:val": opts.type ?? "clear",
+		"w:color": opts.color !== void 0 ? hexColorValue(opts.color) : void 0,
+		"w:fill": opts.fill !== void 0 ? hexColorValue(opts.fill) : void 0,
+		"w:themeColor": opts.themeColor,
+		"w:themeTint": opts.themeTint !== void 0 ? uCharHexNumber(opts.themeTint) : void 0,
+		"w:themeShade": opts.themeShade !== void 0 ? uCharHexNumber(opts.themeShade) : void 0,
+		"w:themeFill": opts.themeFill,
+		"w:themeFillTint": opts.themeFillTint !== void 0 ? uCharHexNumber(opts.themeFillTint) : void 0,
+		"w:themeFillShade": opts.themeFillShade !== void 0 ? uCharHexNumber(opts.themeFillShade) : void 0
+	})}/>`;
+}
+function spacingStr(opts) {
+	return `<w:spacing ${attrParts({
+		"w:after": opts.after,
+		"w:afterAutospacing": opts.afterAutoSpacing !== void 0 ? opts.afterAutoSpacing ? 1 : 0 : void 0,
+		"w:afterLines": opts.afterLines !== void 0 ? decimalNumber(opts.afterLines) : void 0,
+		"w:before": opts.before,
+		"w:beforeAutospacing": opts.beforeAutoSpacing !== void 0 ? opts.beforeAutoSpacing ? 1 : 0 : void 0,
+		"w:beforeLines": opts.beforeLines !== void 0 ? decimalNumber(opts.beforeLines) : void 0,
+		"w:line": opts.line,
+		"w:lineRule": opts.lineRule
+	})}/>`;
+}
+function indentStr(opts) {
+	return `<w:ind ${attrParts({
+		"w:start": opts.start !== void 0 ? signedTwipsMeasureValue(opts.start) : void 0,
+		"w:startChars": opts.startChars !== void 0 ? decimalNumber(opts.startChars) : void 0,
+		"w:end": opts.end !== void 0 ? signedTwipsMeasureValue(opts.end) : void 0,
+		"w:endChars": opts.endChars !== void 0 ? decimalNumber(opts.endChars) : void 0,
+		"w:left": opts.left !== void 0 ? signedTwipsMeasureValue(opts.left) : void 0,
+		"w:leftChars": opts.leftChars !== void 0 ? decimalNumber(opts.leftChars) : void 0,
+		"w:right": opts.right !== void 0 ? signedTwipsMeasureValue(opts.right) : void 0,
+		"w:rightChars": opts.rightChars !== void 0 ? decimalNumber(opts.rightChars) : void 0,
+		"w:hanging": opts.hanging !== void 0 ? twipsMeasureValue(opts.hanging) : void 0,
+		"w:hangingChars": opts.hangingChars !== void 0 ? decimalNumber(opts.hangingChars) : void 0,
+		"w:firstLine": opts.firstLine !== void 0 ? twipsMeasureValue(opts.firstLine) : void 0,
+		"w:firstLineChars": opts.firstLineChars !== void 0 ? decimalNumber(opts.firstLineChars) : void 0
+	})}/>`;
+}
+function tabStopsStr(defs) {
+	return `<w:tabs>${defs.map(({ type, position, leader }) => {
+		return `<w:tab ${attrParts({
+			"w:val": type,
+			"w:pos": position,
+			"w:leader": leader
+		})}/>`;
+	}).join("")}</w:tabs>`;
+}
+function cnfStyleStr(opts) {
+	return `<w:cnfStyle ${attrParts({
+		"w:firstRow": opts.firstRow ? "1" : "0",
+		"w:lastRow": opts.lastRow ? "1" : "0",
+		"w:firstColumn": opts.firstColumn ? "1" : "0",
+		"w:lastColumn": opts.lastColumn ? "1" : "0",
+		"w:oddVBand": opts.oddVBand ? "1" : "0",
+		"w:evenVBand": opts.evenVBand ? "1" : "0",
+		"w:oddHBand": opts.oddHBand ? "1" : "0",
+		"w:evenHBand": opts.evenHBand ? "1" : "0",
+		"w:firstRowFirstColumn": opts.firstRowFirstColumn ? "1" : "0",
+		"w:firstRowLastColumn": opts.firstRowLastColumn ? "1" : "0",
+		"w:lastRowFirstColumn": opts.lastRowFirstColumn ? "1" : "0",
+		"w:lastRowLastColumn": opts.lastRowLastColumn ? "1" : "0"
+	})}/>`;
+}
+function framePrStr(opts) {
+	const alignment = opts.alignment;
+	const position = opts.position;
+	return `<w:framePr ${attrParts({
+		"w:xAlign": alignment?.x,
+		"w:yAlign": alignment?.y,
+		"w:hAnchor": opts.anchor?.horizontal,
+		"w:anchorLock": opts.anchorLock,
+		"w:vAnchor": opts.anchor?.vertical,
+		"w:dropCap": opts.dropCap,
+		"w:h": opts.height,
+		"w:lines": opts.lines,
+		"w:hRule": opts.rule,
+		"w:hSpace": opts.space?.horizontal,
+		"w:vSpace": opts.space?.vertical,
+		"w:w": opts.width,
+		"w:wrap": opts.wrap,
+		"w:x": position?.x,
+		"w:y": position?.y
+	})}/>`;
+}
+function numPrStr(numberId, indentLevel, numberingChange) {
+	const idVal = typeof numberId === "string" ? `{${numberId}}` : numberId;
+	const parts = [`<w:ilvl w:val="${Math.min(indentLevel, 9)}"/>`, `<w:numId w:val="${idVal}"/>`];
+	if (numberingChange) {
+		const a = attrParts({
+			"w:original": numberingChange.original,
+			"w:id": numberingChange.id,
+			"w:author": numberingChange.author,
+			"w:date": numberingChange.date
+		});
+		parts.push(`<w:numberingChange ${a}/>`);
+	}
+	return `<w:numPr>${parts.join("")}</w:numPr>`;
+}
+function colorStr(colorOrOptions) {
+	if (typeof colorOrOptions === "string") return `<w:color w:val="${hexColorValue(colorOrOptions)}"/>`;
+	const opts = colorOrOptions;
+	return `<w:color ${attrParts({
+		"w:val": opts.val !== void 0 ? hexColorValue(opts.val) : void 0,
+		"w:themeColor": opts.themeColor,
+		"w:themeTint": opts.themeTint !== void 0 ? uCharHexNumber(opts.themeTint) : void 0,
+		"w:themeShade": opts.themeShade !== void 0 ? uCharHexNumber(opts.themeShade) : void 0
+	})}/>`;
+}
+function runFontsStr(nameOrAttrs, hint) {
+	if (typeof nameOrAttrs === "string") return `<w:rFonts ${attrParts({
+		"w:ascii": nameOrAttrs,
+		"w:cs": nameOrAttrs,
+		"w:eastAsia": nameOrAttrs,
+		"w:hAnsi": nameOrAttrs,
+		"w:hint": hint
+	})}/>`;
+	const attrs = nameOrAttrs;
+	return `<w:rFonts ${attrParts({
+		"w:ascii": attrs.ascii,
+		"w:asciiTheme": attrs.asciiTheme,
+		"w:cs": attrs.cs,
+		"w:cstheme": attrs.cstheme,
+		"w:eastAsia": attrs.eastAsia,
+		"w:eastAsiaTheme": attrs.eastAsiaTheme,
+		"w:hAnsi": attrs.hAnsi,
+		"w:hAnsiTheme": attrs.hAnsiTheme,
+		"w:hint": attrs.hint
+	})}/>`;
+}
+function underlineStr(type, color) {
+	return `<w:u ${attrParts({
+		"w:val": type ?? "single",
+		"w:color": color !== void 0 ? hexColorValue(color) : void 0
+	})}/>`;
+}
+function eastAsianLayoutStr(opts) {
+	return `<w:eastAsianLayout ${attrParts({
+		"w:id": opts.id !== void 0 ? decimalNumber(opts.id) : void 0,
+		"w:combine": opts.combine !== void 0 ? opts.combine ? 1 : 0 : void 0,
+		"w:combineBrackets": opts.combineBrackets,
+		"w:vert": opts.vert !== void 0 ? opts.vert ? 1 : 0 : void 0,
+		"w:vertCompress": opts.vertCompress !== void 0 ? opts.vertCompress ? 1 : 0 : void 0
+	})}/>`;
+}
+function languageStr(opts) {
+	return `<w:lang ${attrParts({
+		"w:val": opts.value,
+		"w:eastAsia": opts.eastAsia,
+		"w:bidi": opts.bidirectional
+	})}/>`;
+}
+/**
+* Build `<w:pPr>` XML string directly from options — zero IXmlableObject allocation.
+*
+* Replaces `buildParagraphProperties() + xml()` with a single-pass string builder.
+*/
+function stringifyParagraphProperties(options) {
+	const numberingReferences = [];
+	if (!options) return {
+		xml: void 0,
+		numberingReferences
+	};
+	const parts = [];
+	if (options.heading) parts.push(`<w:pStyle w:val="${escapeXml(options.heading)}"/>`);
+	if (options.bullet) parts.push("<w:pStyle w:val=\"ListParagraph\"/>");
+	if (options.numbering) {
+		if (!options.style && !options.heading) {
+			if (!options.numbering.custom) parts.push("<w:pStyle w:val=\"ListParagraph\"/>");
+		}
+	}
+	if (options.style) parts.push(`<w:pStyle w:val="${escapeXml(options.style)}"/>`);
+	if (options.keepNext !== void 0) parts.push(onOff("w:keepNext", options.keepNext));
+	if (options.keepLines !== void 0) parts.push(onOff("w:keepLines", options.keepLines));
+	if (options.pageBreakBefore) parts.push("<w:pageBreakBefore/>");
+	if (options.frame) parts.push(framePrStr(options.frame));
+	if (options.widowControl !== void 0) parts.push(onOff("w:widowControl", options.widowControl));
+	if (options.bullet) parts.push(`<w:numPr><w:ilvl w:val="${Math.min(options.bullet.level, 9)}"/><w:numId w:val="1"/></w:numPr>`);
+	if (options.numbering) {
+		numberingReferences.push({
+			instance: options.numbering.instance ?? 0,
+			reference: options.numbering.reference
+		});
+		const numId = `${options.numbering.reference}-${options.numbering.instance ?? 0}`;
+		parts.push(numPrStr(numId, options.numbering.level, options.numbering.numberingChange));
+	} else if (options.numbering === false) parts.push(numPrStr(0, 0));
+	if (options.border) {
+		const bParts = [];
+		if (options.border.top) bParts.push(borderStr("w:top", options.border.top));
+		if (options.border.left) bParts.push(borderStr("w:left", options.border.left));
+		if (options.border.bottom) bParts.push(borderStr("w:bottom", options.border.bottom));
+		if (options.border.right) bParts.push(borderStr("w:right", options.border.right));
+		if (options.border.between) bParts.push(borderStr("w:between", options.border.between));
+		if (options.border.bar) bParts.push(borderStr("w:bar", options.border.bar));
+		if (bParts.length) parts.push(`<w:pBdr>${bParts.join("")}</w:pBdr>`);
+	}
+	if (options.thematicBreak) parts.push(`<w:pBdr>${borderStr("w:bottom", {
+		color: "auto",
+		size: 6,
+		space: 1,
+		style: BorderStyle.SINGLE
+	})}</w:pBdr>`);
+	if (options.shading) parts.push(shadingStr(options.shading));
+	if (options.wordWrap) parts.push("<w:wordWrap w:val=\"0\"/>");
+	if (options.overflowPunctuation) parts.push(onOff("w:overflowPunct", options.overflowPunctuation));
+	const tabDefs = [
+		...options.rightTabStop !== void 0 ? [{
+			position: options.rightTabStop,
+			type: "right"
+		}] : [],
+		...options.tabStops ? options.tabStops : [],
+		...options.leftTabStop !== void 0 ? [{
+			position: options.leftTabStop,
+			type: "left"
+		}] : []
+	];
+	if (tabDefs.length > 0) parts.push(tabStopsStr(tabDefs));
+	if (options.bidirectional !== void 0) parts.push(onOff("w:bidi", options.bidirectional));
+	if (options.spacing) parts.push(spacingStr(options.spacing));
+	if (options.indent) parts.push(indentStr(options.indent));
+	if (options.contextualSpacing !== void 0) parts.push(onOff("w:contextualSpacing", options.contextualSpacing));
+	if (options.alignment) parts.push(`<w:jc w:val="${options.alignment}"/>`);
+	if (options.outlineLevel !== void 0) parts.push(`<w:outlineLvl w:val="${options.outlineLevel}"/>`);
+	if (options.divId !== void 0) parts.push(`<w:divId w:val="${options.divId}"/>`);
+	if (options.cnfStyle) parts.push(cnfStyleStr(options.cnfStyle));
+	if (options.suppressLineNumbers !== void 0) parts.push(onOff("w:suppressLineNumbers", options.suppressLineNumbers));
+	if (options.autoSpaceEastAsianText !== void 0) parts.push(onOff("w:autoSpaceDN", options.autoSpaceEastAsianText));
+	if (options.suppressAutoHyphens !== void 0) parts.push(onOff("w:suppressAutoHyphens", options.suppressAutoHyphens));
+	if (options.adjustRightInd !== void 0) parts.push(onOff("w:adjustRightInd", options.adjustRightInd));
+	if (options.snapToGrid !== void 0) parts.push(onOff("w:snapToGrid", options.snapToGrid));
+	if (options.mirrorIndents !== void 0) parts.push(onOff("w:mirrorIndents", options.mirrorIndents));
+	if (options.kinsoku !== void 0) parts.push(onOff("w:kinsoku", options.kinsoku));
+	if (options.topLinePunct !== void 0) parts.push(onOff("w:topLinePunct", options.topLinePunct));
+	if (options.autoSpaceDE !== void 0) parts.push(onOff("w:autoSpaceDE", options.autoSpaceDE));
+	if (options.textAlignment !== void 0) parts.push(`<w:textAlignment w:val="${options.textAlignment}"/>`);
+	if (options.textboxTightWrap !== void 0) parts.push(`<w:textboxTightWrap w:val="${options.textboxTightWrap}"/>`);
+	if (options.textDirection !== void 0) parts.push(`<w:textDirection w:val="${options.textDirection}"/>`);
+	if (options.suppressOverlap !== void 0) parts.push(onOff("w:suppressOverlap", options.suppressOverlap));
+	if (options.run) {
+		const inner = stringifyRunPropertiesInner(options.run);
+		if (inner !== void 0) {
+			const extra = [];
+			const runOpts = options.run;
+			if (runOpts.insertion) {
+				const { id, author, date } = runOpts.insertion;
+				extra.push(`<w:ins w:id="${id}" w:author="${escapeXml(author)}" w:date="${date}"/>`);
+			}
+			if (runOpts.deletion) {
+				const { id, author, date } = runOpts.deletion;
+				extra.push(`<w:del w:id="${id}" w:author="${escapeXml(author)}" w:date="${date}"/>`);
+			}
+			const body = inner + extra.join("");
+			parts.push(`<w:rPr>${body}</w:rPr>`);
+		}
+	}
+	if (options.revision) {
+		const rev = options.revision;
+		const { author: _a, date: _d, id: _i, ...originalProps } = rev;
+		const inner = stringifyParagraphProperties({
+			...originalProps,
+			includeIfEmpty: true
+		});
+		parts.push(`<w:pPrChange w:author="${escapeXml(rev.author)}" w:date="${rev.date}" w:id="${rev.id}">${inner.xml ?? "<w:pPr/>"}</w:pPrChange>`);
+	}
+	const body = parts.join("");
+	return {
+		xml: options.includeIfEmpty || body.length > 0 ? `<w:pPr>${body}</w:pPr>` : void 0,
+		numberingReferences
+	};
+}
+/**
+* Build the inner content of `<w:rPr>` as a string.
+* Returns undefined if no properties are set.
+*/
+function stringifyRunPropertiesInner(opts) {
+	if (!opts) return void 0;
+	const parts = [];
+	if (opts.style) parts.push(`<w:rStyle w:val="${escapeXml(opts.style)}"/>`);
+	if (opts.font) if (typeof opts.font === "string") parts.push(runFontsStr(opts.font));
+	else if ("name" in opts.font) parts.push(runFontsStr(opts.font.name, opts.font.hint));
+	else parts.push(runFontsStr(opts.font));
+	if (opts.bold !== void 0) parts.push(onOff("w:b", opts.bold));
+	if ((opts.boldComplexScript === void 0 && opts.bold !== void 0 || opts.boldComplexScript) !== void 0) parts.push(onOff("w:bCs", opts.boldComplexScript ?? opts.bold));
+	if (opts.italic !== void 0) parts.push(onOff("w:i", opts.italic));
+	if ((opts.italicComplexScript === void 0 && opts.italic !== void 0 || opts.italicComplexScript) !== void 0) parts.push(onOff("w:iCs", opts.italicComplexScript ?? opts.italic));
+	if (opts.smallCaps !== void 0) parts.push(onOff("w:smallCaps", opts.smallCaps));
+	else if (opts.allCaps !== void 0) parts.push(onOff("w:caps", opts.allCaps));
+	if (opts.strike !== void 0) parts.push(onOff("w:strike", opts.strike));
+	if (opts.doubleStrike !== void 0) parts.push(onOff("w:dstrike", opts.doubleStrike));
+	if (opts.emboss !== void 0) parts.push(onOff("w:emboss", opts.emboss));
+	if (opts.imprint !== void 0) parts.push(onOff("w:imprint", opts.imprint));
+	if (opts.outline !== void 0) parts.push(onOff("w:outline", opts.outline));
+	if (opts.shadow !== void 0) parts.push(onOff("w:shadow", opts.shadow));
+	if (opts.webHidden !== void 0) parts.push(onOff("w:webHidden", opts.webHidden));
+	if (opts.noProof !== void 0) parts.push(onOff("w:noProof", opts.noProof));
+	if (opts.snapToGrid !== void 0) parts.push(onOff("w:snapToGrid", opts.snapToGrid));
+	if (opts.vanish) parts.push(onOff("w:vanish", opts.vanish));
+	if (opts.color) parts.push(colorStr(opts.color));
+	if (opts.characterSpacing) parts.push(`<w:spacing w:val="${signedTwipsMeasureValue(opts.characterSpacing)}"/>`);
+	if (opts.scale !== void 0) parts.push(`<w:w w:val="${opts.scale}"/>`);
+	if (opts.kern) parts.push(`<w:kern w:val="${hpsMeasureValue(opts.kern)}"/>`);
+	if (opts.position) parts.push(`<w:position w:val="${opts.position}"/>`);
+	if (opts.size !== void 0) parts.push(`<w:sz w:val="${hpsMeasureValue(opts.size * 2)}"/>`);
+	const szCs = opts.sizeComplexScript === void 0 || opts.sizeComplexScript === true ? opts.size : opts.sizeComplexScript;
+	if (szCs) parts.push(`<w:szCs w:val="${hpsMeasureValue(szCs * 2)}"/>`);
+	if (opts.highlight) parts.push(`<w:highlight w:val="${opts.highlight}"/>`);
+	if (opts.highlightComplexScript === true) {
+		if (opts.highlight) parts.push(`<w:highlightCs w:val="${opts.highlight}"/>`);
+	} else if (opts.highlightComplexScript !== void 0 && opts.highlightComplexScript !== false) parts.push(`<w:highlightCs w:val="${opts.highlightComplexScript}"/>`);
+	if (opts.underline) parts.push(underlineStr(opts.underline.type, opts.underline.color));
+	if (opts.effect) parts.push(`<w:effect w:val="${opts.effect}"/>`);
+	if (opts.border) parts.push(borderStr("w:bdr", opts.border));
+	if (opts.shading) parts.push(shadingStr(opts.shading));
+	if (opts.subScript) parts.push("<w:vertAlign w:val=\"subscript\"/>");
+	if (opts.superScript) parts.push("<w:vertAlign w:val=\"superscript\"/>");
+	if (opts.rightToLeft !== void 0) parts.push(onOff("w:rtl", opts.rightToLeft));
+	if (opts.emphasisMark) parts.push(`<w:em w:val="${opts.emphasisMark.type ?? "dot"}"/>`);
+	if (opts.language) parts.push(languageStr(opts.language));
+	if (opts.specVanish) parts.push("<w:specVanish/>");
+	if (opts.math) parts.push(onOff("w:oMath", opts.math));
+	if (opts.fitText !== void 0) parts.push(`<w:fitText w:val="${opts.fitText}"/>`);
+	if (opts.complexScript !== void 0) parts.push(onOff("w:cs", opts.complexScript));
+	if (opts.eastAsianLayout) parts.push(eastAsianLayoutStr(opts.eastAsianLayout));
+	if (opts.contentPartRId) parts.push(`<w:contentPart r:id="${opts.contentPartRId}"/>`);
+	if (opts.revision) {
+		const rev = opts.revision;
+		const { author: _a, date: _d, id: _i, ...originalProps } = rev;
+		const inner = stringifyRunPropertiesInner(originalProps);
+		parts.push(`<w:rPrChange w:author="${escapeXml(rev.author)}" w:date="${rev.date}" w:id="${rev.id}"><w:rPr>${inner ?? ""}</w:rPr></w:rPrChange>`);
+	}
+	return parts.length > 0 ? parts.join("") : void 0;
+}
+/**
+* Build `<w:rPr>` XML string directly from options — zero IXmlableObject allocation.
+*
+* Replaces `buildRunProperties() + xml()` with a single-pass string builder.
+*/
+function stringifyRunProperties(opts) {
+	const inner = stringifyRunPropertiesInner(opts);
+	return inner ? `<w:rPr>${inner}</w:rPr>` : void 0;
+}
+//#endregion
+//#region src/parts/inline.ts
+/**
+* Shared inline run/paragraph stringification for DOCX descriptors.
+*
+* Used by table.ts, comments.ts, body.ts, and other descriptors that need to
+* serialize paragraph/run content. Includes JSON child dispatch for all
+* IParagraphJsonChild variants (image, chart, hyperlink, etc.).
+*
+* Pure string concatenation — zero IXmlableObject, zero BaseXmlComponent.
+*
+* @module
+*/
+function stringifyRunInline(opts, ctx) {
+	const parts = [];
+	const rPr = stringifyRunProperties(opts);
+	if (rPr) parts.push(rPr);
+	if (opts.break) for (let i = 0; i < opts.break; i++) parts.push("<w:br/>");
+	if (opts.children) for (const child of opts.children) if (typeof child === "string") parts.push(`<w:t xml:space="preserve">${escapeXml(child)}</w:t>`);
+	else {
+		const jsonResult = stringifyJsonChild(child, ctx);
+		if (jsonResult !== void 0) if (Array.isArray(jsonResult)) parts.push(...jsonResult);
+		else parts.push(jsonResult);
+		else if ("text" in child || "children" in child || "break" in child) parts.push(stringifyRunInline(child, ctx));
+	}
+	else if (opts.text !== void 0) parts.push(`<w:t xml:space="preserve">${escapeXml(String(opts.text))}</w:t>`);
+	const rsidAttrs = [];
+	if (opts.rsidRPr) rsidAttrs.push(` w:rsidRPr="${opts.rsidRPr}"`);
+	if (opts.rsidDel) rsidAttrs.push(` w:rsidDel="${opts.rsidDel}"`);
+	const attr = rsidAttrs.join("");
+	const body = parts.join("");
+	return body.length === 0 ? attr ? `<w:r${attr}/>` : "<w:r/>" : `<w:r${attr}>${body}</w:r>`;
+}
+function createImageData(data, transformation, key, srcRect) {
+	return {
+		data,
+		fileName: key,
+		srcRect,
+		transformation: createTransformation(transformation)
+	};
+}
+let nextChartId = 1;
+function stringifyJsonChild(child, ctx) {
+	if ("pageBreak" in child) return "<w:r><w:br w:type=\"page\"/></w:r>";
+	if ("columnBreak" in child) return "<w:r><w:br w:type=\"column\"/></w:r>";
+	if ("tab" in child) return "<w:r><w:tab/></w:r>";
+	if ("footnoteReference" in child) return `<w:r><w:rPr><w:rStyle w:val="FootnoteReference"/></w:rPr><w:footnoteReference w:id="${child.footnoteReference}"/></w:r>`;
+	if ("endnoteReference" in child) return `<w:r><w:rPr><w:rStyle w:val="EndnoteReference"/></w:rPr><w:endnoteReference w:id="${child.endnoteReference}"/></w:r>`;
+	if ("commentRangeStart" in child) return `<w:commentRangeStart w:id="${child.commentRangeStart}"/>`;
+	if ("commentRangeEnd" in child) return `<w:commentRangeEnd w:id="${child.commentRangeEnd}"/>`;
+	if ("commentReference" in child) return `<w:r><w:rPr><w:rStyle w:val="CommentReference"/></w:rPr><w:commentReference w:id="${child.commentReference}"/></w:r>`;
+	if ("bookmarkStart" in child) return `<w:bookmarkStart w:id="${child.bookmarkStart.id}" w:name="${child.bookmarkStart.name}"/>`;
+	if ("bookmarkEnd" in child) return `<w:bookmarkEnd w:id="${child.bookmarkEnd}"/>`;
+	if ("symbolRun" in child) {
+		const opts = child.symbolRun;
+		return stringifyRunInline({
+			...opts,
+			children: [`<w:sym w:char="${opts.char}" w:font="${opts.symbolfont ?? "Wingdings"}"/>`]
+		}, ctx);
+	}
+	if ("image" in child) {
+		const opts = child.image;
+		const key = `${uniqueId()}.${opts.type}`;
+		const rawData = toUint8Array(opts.data);
+		let mediaData;
+		if (opts.type === "svg") {
+			const fallbackData = toUint8Array(opts.fallback.data);
+			mediaData = {
+				type: "svg",
+				...createImageData(rawData, opts.transformation, key, opts.srcRect),
+				fallback: {
+					type: opts.fallback.type,
+					...createImageData(fallbackData, opts.transformation, `${uniqueId()}.${opts.fallback.type}`)
+				}
+			};
+		} else mediaData = {
+			type: opts.type,
+			...createImageData(rawData, opts.transformation, key, opts.srcRect)
+		};
+		ctx.file.media.addImage(mediaData.fileName, mediaData);
+		if (mediaData.type === "svg") ctx.file.media.addImage(mediaData.fallback.fileName, mediaData.fallback);
+		return `<w:r>${drawingDesc.stringify({
+			mediaData,
+			docProperties: opts.altText,
+			floating: opts.floating
+		}, ctx)}</w:r>`;
+	}
+	if ("chart" in child) {
+		const opts = child.chart;
+		const chartKey = `chart_${nextChartId++}`;
+		const mediaData = {
+			chartKey,
+			transformation: createTransformation(opts.transformation),
+			type: "chart"
+		};
+		const chartXml = chartSpaceDesc.stringify({
+			categories: opts.categories,
+			series: opts.series,
+			showLegend: opts.showLegend,
+			style: opts.style,
+			title: opts.title,
+			type: opts.type,
+			threeD: opts.threeD
+		}, ctx.file);
+		ctx.file.charts.addChart(chartKey, {
+			key: chartKey,
+			chartSpaceXml: chartXml ?? ""
+		});
+		return `<w:r>${drawingDesc.stringify({
+			mediaData,
+			docProperties: opts.altText,
+			floating: opts.floating
+		}, ctx)}</w:r>`;
+	}
+	if ("smartArt" in child) {
+		const opts = child.smartArt;
+		const smartArtKey = `smartart_${hashSmartArtData(opts)}`;
+		const mediaData = {
+			smartArtKey,
+			transformation: createTransformation(opts.transformation),
+			type: "smartart"
+		};
+		const layoutId = opts.layout ?? "default";
+		const styleId = opts.style ?? "simple1";
+		const colorId = opts.color ?? "accent1_2";
+		const dataModelXml = createDataModel(opts.data.nodes, layoutId, styleId, colorId);
+		ctx.file.smartArts.addSmartArt(smartArtKey, {
+			dataModelXml,
+			key: smartArtKey,
+			layout: layoutId,
+			style: styleId,
+			color: colorId
+		});
+		return `<w:r>${drawingDesc.stringify({
+			mediaData,
+			docProperties: opts.altText,
+			floating: opts.floating
+		}, ctx)}</w:r>`;
+	}
+	if ("wpsShape" in child) {
+		const opts = child.wpsShape;
+		const mediaData = {
+			data: opts,
+			transformation: createTransformation(opts.transformation),
+			type: "wps"
+		};
+		return `<w:r>${drawingDesc.stringify({
+			mediaData,
+			docProperties: opts.altText,
+			floating: opts.floating,
+			outline: opts.outline,
+			fill: opts.fill
+		}, ctx)}</w:r>`;
+	}
+	if ("ruby" in child && typeof child.ruby === "object" && child.ruby !== null) {
+		const r = child.ruby;
+		const align = r.alignment ?? "center";
+		const hps = (r.fontSize ?? 10) * 2;
+		const hpsRaise = (r.raise ?? 10) * 2;
+		const hpsBaseText = (r.baseFontSize ?? 20) * 2;
+		const lid = r.languageId ?? "ja-JP";
+		const prParts = [
+			`<w:rubyAlign w:val="${align}"/>`,
+			`<w:hps w:val="${hps}"/>`,
+			`<w:hpsRaise w:val="${hpsRaise}"/>`,
+			`<w:hpsBaseText w:val="${hpsBaseText}"/>`,
+			`<w:lid w:val="${lid}"/>`
+		];
+		if (r.dirty) prParts.push("<w:dirty/>");
+		const rt = `<w:rt><w:r><w:t xml:space="preserve">${escapeXml(r.text)}</w:t></w:r></w:rt>`;
+		const rubyBase = `<w:rubyBase><w:r><w:t xml:space="preserve">${escapeXml(r.base)}</w:t></w:r></w:rubyBase>`;
+		return `<w:ruby><w:rubyPr>${prParts.join("")}</w:rubyPr>${rt}${rubyBase}</w:ruby>`;
+	}
+	if ("math" in child && typeof child.math === "object" && child.math !== null) return stringifyMath(child.math.children ?? []);
+	if ("insertion" in child) {
+		const { id, author, date, ...runOpts } = child.insertion;
+		const runXml = stringifyRunInline(runOpts, ctx);
+		return `<w:ins w:id="${id}" w:author="${escapeXml(String(author))}" w:date="${date}">${runXml}</w:ins>`;
+	}
+	if ("deletion" in child) {
+		const { id, author, date, ...runOpts } = child.deletion;
+		const parts = [];
+		const rPr = stringifyRunProperties(runOpts);
+		if (rPr) parts.push(rPr);
+		if (runOpts.break) for (let i = 0; i < runOpts.break; i++) parts.push("<w:br/>");
+		if (runOpts.children) {
+			for (const c of runOpts.children) if (typeof c === "string") {
+				const instrText = {
+					CURRENT: "PAGE",
+					TOTAL_PAGES: "NUMPAGES",
+					TOTAL_PAGES_IN_SECTION: "SECTIONPAGES"
+				}[c];
+				if (instrText) parts.push(`<w:fldChar w:fldCharType="begin"/><w:delInstrText xml:space="preserve">${instrText}</w:delInstrText><w:fldChar w:fldCharType="separate"/><w:fldChar w:fldCharType="end"/>`);
+				else parts.push(`<w:delText xml:space="preserve">${escapeXml(c)}</w:delText>`);
+			}
+		} else if (runOpts.text) parts.push(`<w:delText xml:space="preserve">${escapeXml(String(runOpts.text))}</w:delText>`);
+		const runBody = parts.join("");
+		return `<w:del w:id="${id}" w:author="${escapeXml(String(author))}" w:date="${date}"><w:r>${runBody}</w:r></w:del>`;
+	}
+	if ("hyperlink" in child) {
+		const hl = child.hyperlink;
+		const childParts = [];
+		if (hl.children) for (const rc of hl.children) if (typeof rc === "string") childParts.push(stringifyRunInline({ text: rc }, ctx));
+		else childParts.push(stringifyRunInline(rc, ctx));
+		const body = childParts.join("");
+		if (hl.link) {
+			const linkId = uniqueId();
+			ctx.viewWrapper.relationships.addRelationship(linkId, "http://schemas.openxmlformats.org/officeDocument/2006/relationships/hyperlink", hl.link, TargetModeType.EXTERNAL);
+			const attrs = [`r:id="rId${linkId}"`, "w:history=\"1\""];
+			if (hl.tooltip) attrs.push(`w:tooltip="${escapeXml(hl.tooltip)}"`);
+			return `<w:hyperlink ${attrs.join(" ")}>${body}</w:hyperlink>`;
+		}
+		if (hl.anchor) {
+			const attrs = [`w:anchor="${escapeXml(hl.anchor)}"`, "w:history=\"1\""];
+			if (hl.tooltip) attrs.push(`w:tooltip="${escapeXml(hl.tooltip)}"`);
+			return `<w:hyperlink ${attrs.join(" ")}>${body}</w:hyperlink>`;
+		}
+		return "";
+	}
+	if ("proofErr" in child) return `<w:proofErr w:type="${child.proofErr}"/>`;
+	if ("positionalTab" in child) {
+		const pt = child.positionalTab;
+		return `<w:ptab w:alignment="${pt.alignment}" w:leader="${pt.leader}" w:relativeTo="${pt.relativeTo}"/>`;
+	}
+	if ("permStart" in child) {
+		const ps = child.permStart;
+		const a = [`w:id="${ps.id}"`];
+		if (ps.ed !== void 0) a.push(`w:ed="${escapeXml(String(ps.ed))}"`);
+		if (ps.editGroup !== void 0) a.push(`w:edGrp="${ps.editGroup}"`);
+		if (ps.colFirst !== void 0) a.push(`w:colFirst="${ps.colFirst}"`);
+		if (ps.colLast !== void 0) a.push(`w:colLast="${ps.colLast}"`);
+		return `<w:permStart ${a.join(" ")}/>`;
+	}
+	if ("permEnd" in child) return `<w:permEnd w:id="${child.permEnd}"/>`;
+	if ("moveFromRangeStart" in child) {
+		const m = child.moveFromRangeStart;
+		const a = [`w:id="${m.id}"`];
+		if (m.name) a.push(`w:name="${escapeXml(m.name)}"`);
+		if (m.author) a.push(`w:author="${escapeXml(m.author)}"`);
+		if (m.date) a.push(`w:date="${m.date}"`);
+		return `<w:moveFromRangeStart ${a.join(" ")}/>`;
+	}
+	if ("moveFromRangeEnd" in child) return `<w:moveFromRangeEnd w:id="${child.moveFromRangeEnd}"/>`;
+	if ("moveToRangeStart" in child) {
+		const m = child.moveToRangeStart;
+		const a = [`w:id="${m.id}"`];
+		if (m.name) a.push(`w:name="${escapeXml(m.name)}"`);
+		if (m.author) a.push(`w:author="${escapeXml(m.author)}"`);
+		if (m.date) a.push(`w:date="${m.date}"`);
+		return `<w:moveToRangeStart ${a.join(" ")}/>`;
+	}
+	if ("moveToRangeEnd" in child) return `<w:moveToRangeEnd w:id="${child.moveToRangeEnd}"/>`;
+	if ("movedFrom" in child) {
+		const { id, author, date, ...runOpts } = child.movedFrom;
+		const runXml = stringifyRunInline(runOpts, ctx);
+		return `<w:moveFrom w:id="${id}" w:author="${escapeXml(String(author))}" w:date="${date}">${runXml}</w:moveFrom>`;
+	}
+	if ("movedTo" in child) {
+		const { id, author, date, ...runOpts } = child.movedTo;
+		const runXml = stringifyRunInline(runOpts, ctx);
+		return `<w:moveTo w:id="${id}" w:author="${escapeXml(String(author))}" w:date="${date}">${runXml}</w:moveTo>`;
+	}
+	if ("customXmlInsRangeStart" in child) {
+		const o = child.customXmlInsRangeStart;
+		return `<w:customXmlInsRangeStart w:id="${o.id}" w:author="${escapeXml(o.author)}"${o.date ? ` w:date="${o.date}"` : ""}/>`;
+	}
+	if ("customXmlInsRangeEnd" in child) return `<w:customXmlInsRangeEnd w:id="${child.customXmlInsRangeEnd}"/>`;
+	if ("customXmlDelRangeStart" in child) {
+		const o = child.customXmlDelRangeStart;
+		return `<w:customXmlDelRangeStart w:id="${o.id}" w:author="${escapeXml(o.author)}"${o.date ? ` w:date="${o.date}"` : ""}/>`;
+	}
+	if ("customXmlDelRangeEnd" in child) return `<w:customXmlDelRangeEnd w:id="${child.customXmlDelRangeEnd}"/>`;
+	if ("customXmlMoveFromRangeStart" in child) {
+		const o = child.customXmlMoveFromRangeStart;
+		return `<w:customXmlMoveFromRangeStart w:id="${o.id}" w:author="${escapeXml(o.author)}"${o.date ? ` w:date="${o.date}"` : ""}/>`;
+	}
+	if ("customXmlMoveFromRangeEnd" in child) return `<w:customXmlMoveFromRangeEnd w:id="${child.customXmlMoveFromRangeEnd}"/>`;
+	if ("customXmlMoveToRangeStart" in child) {
+		const o = child.customXmlMoveToRangeStart;
+		return `<w:customXmlMoveToRangeStart w:id="${o.id}" w:author="${escapeXml(o.author)}"${o.date ? ` w:date="${o.date}"` : ""}/>`;
+	}
+	if ("customXmlMoveToRangeEnd" in child) return `<w:customXmlMoveToRangeEnd w:id="${child.customXmlMoveToRangeEnd}"/>`;
+	if ("simpleField" in child) {
+		const sf = child.simpleField;
+		if (sf.cachedValue !== void 0) return `<w:fldSimple w:instr="${escapeXml(sf.instruction)}"><w:r><w:t>${escapeXml(sf.cachedValue)}</w:t></w:r></w:fldSimple>`;
+		return `<w:fldSimple w:instr="${escapeXml(sf.instruction)}"/>`;
+	}
+	if ("seqIdentifier" in child) {
+		const id = child.seqIdentifier;
+		return `<w:r><w:fldChar w:fldCharType="begin"/><w:instrText xml:space="preserve"> SEQ ${escapeXml(id)} </w:instrText><w:fldChar w:fldCharType="separate"/><w:fldChar w:fldCharType="end"/></w:r>`;
+	}
+	if ("pageReference" in child) {
+		const pr = child.pageReference;
+		let instr = ` PAGEREF ${escapeXml(pr.bookmarkId)} `;
+		if (pr.hyperlink) instr += "\\h ";
+		if (pr.useRelativePosition) instr += "\\p ";
+		return `<w:r><w:fldChar w:fldCharType="begin"/><w:instrText xml:space="preserve">${instr}</w:instrText><w:fldChar w:fldCharType="end"/></w:r>`;
+	}
+	if ("dir" in child) {
+		const d = child.dir;
+		const childXml = serializeDirChildren(d.children, ctx);
+		return `<w:dir w:val="${d.val}">${childXml}</w:dir>`;
+	}
+	if ("bdo" in child) {
+		const b = child.bdo;
+		const childXml = serializeDirChildren(b.children, ctx);
+		return `<w:bdo w:val="${b.val}">${childXml}</w:bdo>`;
+	}
+	if ("smartTag" in child) {
+		const st = child.smartTag;
+		const attrs = [];
+		if (st.uri) attrs.push(`w:uri="${escapeXml(st.uri)}"`);
+		attrs.push(`w:element="${escapeXml(st.element)}"`);
+		const parts = [];
+		if (st.properties?.length) {
+			const propParts = [];
+			for (const p of st.properties) {
+				const pa = [];
+				if (p.uri) pa.push(`w:uri="${escapeXml(p.uri)}"`);
+				pa.push(`w:name="${escapeXml(p.name)}"`, `w:val="${escapeXml(p.val)}"`);
+				propParts.push(`<w:attr ${pa.join(" ")}/>`);
+			}
+			parts.push(`<w:smartTagPr>${propParts.join("")}</w:smartTagPr>`);
+		}
+		if (st.children) for (const c of st.children) parts.push(typeof c === "string" ? stringifyRunInline({ text: c }, ctx) : stringifyRunInline(c, ctx));
+		return `<w:smartTag ${attrs.join(" ")}>${parts.join("")}</w:smartTag>`;
+	}
+	if ("customXml" in child) {
+		const cx = child.customXml;
+		const attrs = [`w:element="${escapeXml(cx.element)}"`];
+		if (cx.uri) attrs.push(`w:uri="${escapeXml(cx.uri)}"`);
+		const parts = [];
+		if (cx.customXmlPr) {
+			const prParts = [];
+			if (cx.customXmlPr.placeholder) prParts.push(`<w:placeholder w:val="${escapeXml(cx.customXmlPr.placeholder)}"/>`);
+			if (cx.customXmlPr.attrs?.length) for (const a of cx.customXmlPr.attrs) {
+				const aa = [`w:name="${escapeXml(a.name)}"`, `w:val="${escapeXml(a.val)}"`];
+				if (a.uri) aa.push(`w:uri="${escapeXml(a.uri)}"`);
+				prParts.push(`<w:attr ${aa.join(" ")}/>`);
+			}
+			if (prParts.length) parts.push(`<w:customXmlPr>${prParts.join("")}</w:customXmlPr>`);
+		}
+		if (cx.children) for (const c of cx.children) if (typeof c === "string") parts.push(stringifyRunInline({ text: c }, ctx));
+		else {
+			const jr = stringifyJsonChild(c, ctx);
+			if (jr !== void 0) parts.push(Array.isArray(jr) ? jr.join("") : jr);
+			else parts.push(stringifyRunInline(c, ctx));
+		}
+		return `<w:customXml ${attrs.join(" ")}>${parts.join("")}</w:customXml>`;
+	}
+}
+/** Serialize children of Dir/Bdo containers. */
+function serializeDirChildren(children, ctx) {
+	if (!children) return "";
+	const parts = [];
+	for (const c of children) if (typeof c === "string") parts.push(stringifyRunInline({ text: c }, ctx));
+	else parts.push(stringifyRunInline(c, ctx));
+	return parts.join("");
+}
+/** Hash SmartArt data for unique key generation (duplicated from SmartArtRun). */
+function hashSmartArtData(options) {
+	const data = JSON.stringify(options.data);
+	let hash = 0;
+	for (let i = 0; i < data.length; i++) {
+		const char = data.charCodeAt(i);
+		hash = (hash << 5) - hash + char | 0;
+	}
+	return Math.abs(hash);
+}
+function stringifyParagraphInline(opts, ctx) {
+	const resolved = typeof opts === "string" ? { text: opts } : opts;
+	const parts = [];
+	const props = stringifyParagraphProperties(resolved);
+	if (props.xml) parts.push(props.xml);
+	if (props.numberingReferences.length > 0) for (const ref of props.numberingReferences) ctx.file.numbering.createConcreteNumberingInstance(ref.reference, ref.instance);
+	if (resolved.text !== void 0) parts.push(stringifyRunInline({ text: resolved.text }, ctx));
+	if (resolved.children) {
+		for (const child of resolved.children) if (typeof child === "string") parts.push(stringifyRunInline({ text: child }, ctx));
+		else if (typeof child === "object" && child !== null) {
+			const jsonResult = stringifyJsonChild(child, ctx);
+			if (jsonResult !== void 0) if (Array.isArray(jsonResult)) parts.push(...jsonResult);
+			else parts.push(jsonResult);
+			else if ("text" in child || "children" in child || "break" in child) parts.push(stringifyRunInline(child, ctx));
+		}
+	}
+	const body = parts.join("");
+	return body ? `<w:p>${body}</w:p>` : "<w:p/>";
+}
+//#endregion
+//#region src/parts/table/stringify.ts
+/**
+* Direct XML string builders for table properties.
+*
+* Replaces `buildTableProperties() + xml()`, `buildTableRowProperties() + xml()`,
+* `buildTableCellProperties() + xml()`, and `new TablePropertyExceptions().toXml()`
+* with direct string concatenation — zero IXmlableObject allocation.
+*
+* @module
+*/
+function tableWidthStr(name, opts) {
+	const type = opts.type ?? WidthType.AUTO;
+	let w = opts.size;
+	if (type === WidthType.PERCENTAGE && typeof w === "number") w = `${w}%`;
+	return `<${name} ${attrParts({
+		"w:w": w !== void 0 ? measurementOrPercentValue(w) : void 0,
+		"w:type": type
+	})}/>`;
+}
+function cellMarginChildrenStr(opts) {
+	const unitType = opts.marginUnitType ?? WidthType.DXA;
+	const parts = [];
+	if (opts.top !== void 0) parts.push(tableWidthStr("w:top", {
+		size: opts.top,
+		type: unitType
+	}));
+	if (opts.left !== void 0) parts.push(tableWidthStr("w:left", {
+		size: opts.left,
+		type: unitType
+	}));
+	if (opts.bottom !== void 0) parts.push(tableWidthStr("w:bottom", {
+		size: opts.bottom,
+		type: unitType
+	}));
+	if (opts.right !== void 0) parts.push(tableWidthStr("w:right", {
+		size: opts.right,
+		type: unitType
+	}));
+	return parts.join("");
+}
+function cellMarginStr(tag, opts) {
+	const inner = cellMarginChildrenStr(opts);
+	return inner ? `<${tag}>${inner}</${tag}>` : void 0;
+}
+const DEFAULT_BORDER = {
+	color: "auto",
+	size: 4,
+	style: BorderStyle.SINGLE
+};
+function tableBordersStr(opts) {
+	const parts = [];
+	parts.push(borderStr("w:top", opts.top ?? DEFAULT_BORDER));
+	parts.push(borderStr("w:left", opts.left ?? DEFAULT_BORDER));
+	parts.push(borderStr("w:bottom", opts.bottom ?? DEFAULT_BORDER));
+	parts.push(borderStr("w:right", opts.right ?? DEFAULT_BORDER));
+	parts.push(borderStr("w:insideH", opts.insideHorizontal ?? DEFAULT_BORDER));
+	parts.push(borderStr("w:insideV", opts.insideVertical ?? DEFAULT_BORDER));
+	return `<w:tblBorders>${parts.join("")}</w:tblBorders>`;
+}
+function cellBordersStr(opts) {
+	const parts = [];
+	if (opts.top) parts.push(borderStr("w:top", opts.top));
+	if (opts.start) parts.push(borderStr("w:start", opts.start));
+	if (opts.left) parts.push(borderStr("w:left", opts.left));
+	if (opts.bottom) parts.push(borderStr("w:bottom", opts.bottom));
+	if (opts.end) parts.push(borderStr("w:end", opts.end));
+	if (opts.right) parts.push(borderStr("w:right", opts.right));
+	if (opts.topLeftToBottomRight) parts.push(borderStr("w:tl2br", opts.topLeftToBottomRight));
+	if (opts.topRightToBottomLeft) parts.push(borderStr("w:tr2bl", opts.topRightToBottomLeft));
+	return parts.length > 0 ? `<w:tcBorders>${parts.join("")}</w:tcBorders>` : void 0;
+}
+function floatPropertiesStr(opts) {
+	return `<w:tblpPr ${attrParts({
+		"w:horzAnchor": opts.horizontalAnchor,
+		"w:vertAnchor": opts.verticalAnchor,
+		"w:tblpX": opts.absoluteHorizontalPosition !== void 0 ? signedTwipsMeasureValue(opts.absoluteHorizontalPosition) : void 0,
+		"w:tblpXSpec": opts.relativeHorizontalPosition,
+		"w:tblpY": opts.absoluteVerticalPosition !== void 0 ? signedTwipsMeasureValue(opts.absoluteVerticalPosition) : void 0,
+		"w:tblpYSpec": opts.relativeVerticalPosition,
+		"w:bottomFromText": opts.bottomFromText !== void 0 ? twipsMeasureValue(opts.bottomFromText) : void 0,
+		"w:topFromText": opts.topFromText !== void 0 ? twipsMeasureValue(opts.topFromText) : void 0,
+		"w:leftFromText": opts.leftFromText !== void 0 ? twipsMeasureValue(opts.leftFromText) : void 0,
+		"w:rightFromText": opts.rightFromText !== void 0 ? twipsMeasureValue(opts.rightFromText) : void 0
+	})}/>`;
+}
+function tableLookStr(opts) {
+	return `<w:tblLook ${attrParts({
+		"w:firstRow": opts.firstRow,
+		"w:lastRow": opts.lastRow,
+		"w:firstColumn": opts.firstColumn,
+		"w:lastColumn": opts.lastColumn,
+		"w:noHBand": opts.noHBand,
+		"w:noVBand": opts.noVBand
+	})}/>`;
+}
+function changeAttrStr(tag, opts) {
+	return `<${tag} ${attrParts({
+		"w:author": opts.author,
+		"w:date": opts.date,
+		"w:id": opts.id
+	})}/>`;
+}
+function cellMergeStr(opts) {
+	const attrs = {
+		"w:author": opts.author,
+		"w:date": opts.date,
+		"w:id": opts.id
+	};
+	if (opts.verticalMerge !== void 0) attrs["w:vMerge"] = xsdVerticalMergeRev.to(opts.verticalMerge);
+	if (opts.verticalMergeOriginal !== void 0) attrs["w:vMergeOrig"] = xsdVerticalMergeRev.to(opts.verticalMergeOriginal);
+	return `<w:cellMerge ${attrParts(attrs)}/>`;
+}
+function cellSpacingStr(opts) {
+	return `<w:tblCellSpacing ${attrParts({
+		"w:type": opts.type,
+		"w:w": measurementOrPercentValue(opts.value)
+	})}/>`;
+}
+function stringifyTablePropertiesChangeInner(options) {
+	const inner = stringifyTablePropertiesInner({
+		...options,
+		includeIfEmpty: true
+	});
+	return `<w:tblPrChange ${attrParts({
+		"w:author": options.author,
+		"w:date": options.date,
+		"w:id": options.id
+	})}><w:tblPr>${inner}</w:tblPr></w:tblPrChange>`;
+}
+function stringifyTablePropertiesInner(options) {
+	const parts = [];
+	if (options.style) parts.push(`<w:tblStyle w:val="${options.style}"/>`);
+	if (options.float) {
+		parts.push(floatPropertiesStr(options.float));
+		if (options.float.overlap) parts.push(`<w:tblOverlap w:val="${options.float.overlap}"/>`);
+	}
+	if (options.visuallyRightToLeft !== void 0) parts.push(onOff("w:bidiVisual", options.visuallyRightToLeft));
+	if (options.styleRowBandSize !== void 0) parts.push(`<w:tblStyleRowBandSize w:val="${options.styleRowBandSize}"/>`);
+	if (options.styleColBandSize !== void 0) parts.push(`<w:tblStyleColBandSize w:val="${options.styleColBandSize}"/>`);
+	if (options.width) parts.push(tableWidthStr("w:tblW", options.width));
+	if (options.alignment) parts.push(`<w:jc w:val="${options.alignment}"/>`);
+	if (options.indent) parts.push(tableWidthStr("w:tblInd", options.indent));
+	if (options.borders) parts.push(tableBordersStr(options.borders));
+	if (options.shading) parts.push(shadingStr(options.shading));
+	if (options.layout) parts.push(`<w:tblLayout w:type="${options.layout}"/>`);
+	if (options.cellMargin) {
+		const cm = cellMarginStr("w:tblCellMar", options.cellMargin);
+		if (cm) parts.push(cm);
+	}
+	if (options.tableLook) parts.push(tableLookStr(options.tableLook));
+	if (options.cellSpacing) parts.push(cellSpacingStr(options.cellSpacing));
+	if (options.caption !== void 0) parts.push(`<w:tblCaption w:val="${options.caption}"/>`);
+	if (options.description !== void 0) parts.push(`<w:tblDescription w:val="${options.description}"/>`);
+	if (options.revision) parts.push(stringifyTablePropertiesChangeInner(options.revision));
+	return parts.join("");
+}
+function stringifyTableProperties(options) {
+	const inner = stringifyTablePropertiesInner(options);
+	if (options.includeIfEmpty || inner) return `<w:tblPr>${inner}</w:tblPr>`;
+}
+function stringifyTableRowPropertiesChangeInner(options) {
+	const inner = stringifyTableRowPropertiesInner({
+		...options,
+		includeIfEmpty: true
+	});
+	return `<w:trPrChange ${attrParts({
+		"w:author": options.author,
+		"w:date": options.date,
+		"w:id": options.id
+	})}><w:trPr>${inner}</w:trPr></w:trPrChange>`;
+}
+function stringifyTableRowPropertiesInner(options) {
+	const parts = [];
+	if (options.cnfStyle !== void 0) {
+		const a = attrParts({
+			"w:val": options.cnfStyle.val,
+			"w:changed": options.cnfStyle.changed
+		});
+		parts.push(`<w:cnfStyle ${a}/>`);
+	}
+	if (options.divId !== void 0) parts.push(`<w:divId w:val="${options.divId}"/>`);
+	if (options.gridBefore !== void 0) parts.push(`<w:gridBefore w:val="${options.gridBefore}"/>`);
+	if (options.gridAfter !== void 0) parts.push(`<w:gridAfter w:val="${options.gridAfter}"/>`);
+	if (options.widthBefore) parts.push(tableWidthStr("w:wBefore", options.widthBefore));
+	if (options.widthAfter) parts.push(tableWidthStr("w:wAfter", options.widthAfter));
+	if (options.cantSplit !== void 0) parts.push(onOff("w:cantSplit", options.cantSplit));
+	if (options.tableHeader !== void 0) parts.push(onOff("w:tblHeader", options.tableHeader));
+	if (options.height) {
+		const a = attrParts({
+			"w:val": twipsMeasureValue(options.height.value),
+			"w:hRule": options.height.rule
+		});
+		parts.push(`<w:trHeight ${a}/>`);
+	}
+	if (options.cellSpacing) parts.push(cellSpacingStr(options.cellSpacing));
+	if (options.rowAlignment) parts.push(`<w:jc w:val="${options.rowAlignment}"/>`);
+	if (options.hidden !== void 0) parts.push(onOff("w:hidden", options.hidden));
+	if (options.insertion) parts.push(changeAttrStr("w:ins", options.insertion));
+	if (options.deletion) parts.push(changeAttrStr("w:del", options.deletion));
+	if (options.revision) parts.push(stringifyTableRowPropertiesChangeInner(options.revision));
+	return parts.join("");
+}
+function stringifyTableRowProperties(options) {
+	const inner = stringifyTableRowPropertiesInner(options);
+	if (options.includeIfEmpty || inner) return `<w:trPr>${inner}</w:trPr>`;
+}
+function stringifyTableCellPropertiesChangeInner(options) {
+	const inner = stringifyTableCellPropertiesInner({
+		...options,
+		includeIfEmpty: true
+	});
+	return `<w:tcPrChange ${attrParts({
+		"w:author": options.author,
+		"w:date": options.date,
+		"w:id": options.id
+	})}><w:tcPr>${inner}</w:tcPr></w:tcPrChange>`;
+}
+function stringifyTableCellPropertiesInner(options) {
+	const parts = [];
+	if (options.cnfStyle !== void 0) {
+		const a = attrParts({
+			"w:val": options.cnfStyle.val,
+			"w:changed": options.cnfStyle.changed
+		});
+		parts.push(`<w:cnfStyle ${a}/>`);
+	}
+	if (options.width) parts.push(tableWidthStr("w:tcW", options.width));
+	if (options.columnSpan) parts.push(`<w:gridSpan w:val="${options.columnSpan}"/>`);
+	if (options.verticalMerge) parts.push(`<w:vMerge w:val="${options.verticalMerge}"/>`);
+	else if (options.rowSpan && options.rowSpan > 1) parts.push(`<w:vMerge w:val="${VerticalMergeType.RESTART}"/>`);
+	if (options.borders) {
+		const bs = cellBordersStr(options.borders);
+		if (bs) parts.push(bs);
+	}
+	if (options.shading) parts.push(shadingStr(options.shading));
+	if (options.margins) {
+		const cm = cellMarginStr("w:tcMar", options.margins);
+		if (cm) parts.push(cm);
+	}
+	if (options.textDirection) parts.push(`<w:textDirection w:val="${options.textDirection}"/>`);
+	if (options.verticalAlign) parts.push(`<w:vAlign w:val="${options.verticalAlign}"/>`);
+	if (options.horizontalMerge !== void 0) if (options.horizontalMerge === "restart") parts.push(`<w:hMerge w:val="restart"/>`);
+	else parts.push(`<w:hMerge/>`);
+	if (options.noWrap !== void 0) parts.push(onOff("w:noWrap", options.noWrap));
+	if (options.fitText !== void 0) parts.push(onOff("w:tcFitText", options.fitText));
+	if (options.hideMark !== void 0) parts.push(onOff("w:hideMark", options.hideMark));
+	if (options.headers !== void 0) {
+		const headerParts = options.headers.map((h) => `<w:header w:val="${h}"/>`).join("");
+		parts.push(`<w:headers>${headerParts}</w:headers>`);
+	}
+	if (options.insertion) parts.push(changeAttrStr("w:cellIns", options.insertion));
+	if (options.deletion) parts.push(changeAttrStr("w:cellDel", options.deletion));
+	if (options.revision) parts.push(stringifyTableCellPropertiesChangeInner(options.revision));
+	if (options.cellMerge) parts.push(cellMergeStr(options.cellMerge));
+	return parts.join("");
+}
+function stringifyTableCellProperties(options) {
+	const inner = stringifyTableCellPropertiesInner(options);
+	if (options.includeIfEmpty || inner) return `<w:tcPr>${inner}</w:tcPr>`;
+}
+function stringifyTablePropertyExceptions(options) {
+	const parts = [];
+	if (options.width) parts.push(tableWidthStr("w:tblW", options.width));
+	if (options.alignment) parts.push(`<w:jc w:val="${options.alignment}"/>`);
+	if (options.cellSpacing) parts.push(cellSpacingStr(options.cellSpacing));
+	if (options.indent) parts.push(tableWidthStr("w:tblInd", options.indent));
+	if (options.borders) parts.push(tableBordersStr(options.borders));
+	if (options.shading) parts.push(shadingStr(options.shading));
+	if (options.layout) parts.push(`<w:tblLayout w:type="${options.layout}"/>`);
+	if (options.cellMargin) {
+		const cm = cellMarginStr("w:tblCellMar", options.cellMargin);
+		if (cm) parts.push(cm);
+	}
+	if (options.tableLook) parts.push(tableLookStr(options.tableLook));
+	if (options.tblPrExChange) {
+		const change = options.tblPrExChange;
+		const attrs = {
+			"w:author": change.author,
+			"w:id": change.id
+		};
+		if (change.date !== void 0) attrs["w:date"] = change.date;
+		const a = attrParts(attrs);
+		parts.push(`<w:tblPrExChange ${a}/>`);
+	}
+	return `<w:tblPrEx>${parts.join("")}</w:tblPrEx>`;
+}
+//#endregion
+//#region src/parts/table/descriptor.ts
+function buildTableGridXml(widths, revision) {
+	const cols = widths.map((w) => `<w:gridCol w:w="${w}"/>`).join("");
+	if (revision) {
+		const revCols = revision.columnWidths.map((w) => `<w:gridCol w:w="${w}"/>`).join("");
+		return `<w:tblGrid>${cols}<w:tblGridChange w:id="${revision.id}"><w:tblGrid>${revCols}</w:tblGrid></w:tblGridChange></w:tblGrid>`;
+	}
+	return `<w:tblGrid>${cols}</w:tblGrid>`;
+}
+/** Extract column/row span from a plain-object cell. */
+function getCellSpans(cell) {
+	return {
+		columnSpan: cell.columnSpan ?? 1,
+		rowSpan: cell.rowSpan ?? 1
+	};
+}
+/**
+* Stringify a cell child (SectionChild) inline.
+* Handles strings and plain objects (paragraph/table).
+*/
+function stringifyCellChild(child, ctx) {
+	if (typeof child === "string") return stringifyParagraphInline(child, ctx);
+	if ("paragraph" in child) return stringifyParagraphInline(child.paragraph, ctx);
+	if ("table" in child) return tableDesc.stringify(child.table, ctx) ?? "";
+	return "";
+}
+function stringifyTableCell(cell, ctx) {
+	const parts = [];
+	const tcPr = stringifyTableCellProperties(cell);
+	if (tcPr) parts.push(tcPr);
+	const children = cell.children;
+	if (children) for (const child of children) parts.push(stringifyCellChild(child, ctx));
+	const last = children?.[children.length - 1];
+	if (!(last && typeof last !== "string" && ("paragraph" in last || "table" in last))) parts.push("<w:p/>");
+	return `<w:tc>${parts.join("")}</w:tc>`;
+}
+function stringifyTableRow(row, ctx, extraCells) {
+	const parts = [];
+	if (row.propertyExceptions) parts.push(stringifyTablePropertyExceptions(row.propertyExceptions));
+	const trPr = stringifyTableRowProperties(row);
+	if (trPr) parts.push(trPr);
+	const prefixCount = parts.length;
+	for (const cell of row.cells) parts.push(stringifyTableCell(cell, ctx));
+	if (extraCells && extraCells.length > 0) for (const { cell, columnIndex } of extraCells) {
+		const insertIdx = findInsertIndex(row.cells, columnIndex, prefixCount);
+		parts.splice(insertIdx, 0, stringifyTableCell(cell, ctx));
+	}
+	const rsidAttrs = [];
+	if (row.rsidRPr) rsidAttrs.push(` w:rsidRPr="${row.rsidRPr}"`);
+	if (row.rsidR) rsidAttrs.push(` w:rsidR="${row.rsidR}"`);
+	if (row.rsidDel) rsidAttrs.push(` w:rsidDel="${row.rsidDel}"`);
+	if (row.rsidTr) rsidAttrs.push(` w:rsidTr="${row.rsidTr}"`);
+	const attr = rsidAttrs.join("");
+	const body = parts.join("");
+	return body ? `<w:tr${attr}>${body}</w:tr>` : attr ? `<w:tr${attr}/>` : "<w:tr/>";
+}
+function findInsertIndex(cells, columnIndex, prefixCount) {
+	let colIdx = 0;
+	for (let i = 0; i < cells.length; i++) {
+		const { columnSpan } = getCellSpans(cells[i]);
+		colIdx += columnSpan;
+		if (colIdx > columnIndex) return i + prefixCount;
+	}
+	return cells.length + prefixCount;
+}
+/**
+* Pre-process rows to compute CONTINUE cells for vertical merge.
+*/
+function computeVerticalMergeCells(rows) {
+	const extraMap = /* @__PURE__ */ new Map();
+	for (let ri = 0; ri < rows.length - 1; ri++) {
+		const cells = rows[ri].cells;
+		let colIdx = 0;
+		for (const cell of cells) {
+			const typedCell = cell;
+			const { columnSpan, rowSpan } = getCellSpans(typedCell);
+			if (rowSpan > 1) {
+				const continueCell = {
+					borders: typedCell.borders,
+					children: [],
+					columnSpan,
+					rowSpan: rowSpan - 1,
+					verticalMerge: VerticalMergeType.CONTINUE
+				};
+				if (!extraMap.has(ri + 1)) extraMap.set(ri + 1, []);
+				extraMap.get(ri + 1).push({
+					cell: continueCell,
+					columnIndex: colIdx
+				});
+			}
+			colIdx += columnSpan;
+		}
+	}
+	return extraMap;
+}
+const tableDesc = {
+	kind: "custom",
+	stringify(opts, ctx) {
+		const parts = [];
+		const tblPr = stringifyTableProperties({
+			alignment: opts.alignment,
+			borders: opts.borders ?? {},
+			caption: opts.caption,
+			cellMargin: opts.margins,
+			cellSpacing: opts.cellSpacing,
+			description: opts.description,
+			float: opts.float,
+			indent: opts.indent,
+			layout: opts.layout,
+			revision: opts.revision,
+			style: opts.style,
+			styleColBandSize: opts.styleColBandSize,
+			styleRowBandSize: opts.styleRowBandSize,
+			tableLook: opts.tableLook,
+			visuallyRightToLeft: opts.visuallyRightToLeft,
+			width: opts.width ?? { size: 100 }
+		});
+		if (tblPr) parts.push(tblPr);
+		const columnWidths = opts.columnWidths ?? Array(Math.max(...opts.rows.map((r) => r.cells.length))).fill(100);
+		parts.push(buildTableGridXml(columnWidths, opts.columnWidthsRevision));
+		const extraCells = computeVerticalMergeCells(opts.rows);
+		for (let ri = 0; ri < opts.rows.length; ri++) {
+			const row = opts.rows[ri];
+			const extras = extraCells.get(ri);
+			parts.push(stringifyTableRow(row, ctx, extras));
+		}
+		return `<w:tbl>${parts.join("")}</w:tbl>`;
+	},
+	parse(el, ctx) {
+		return parseTableEl(el, ctx);
+	}
+};
+/** Callback used by table parser to parse body children. */
+let _parseChild;
+/** Set the child parser callback (called from parseBody). */
+function setTableParseChild(fn) {
+	_parseChild = fn;
+}
+function parseTablePropertiesEl(el) {
+	const opts = {};
+	const style = findChild(el, "w:tblStyle");
+	if (style) {
+		const val = attr(style, "w:val");
+		if (val) opts.style = val;
+	}
+	const tblW = findChild(el, "w:tblW");
+	if (tblW) {
+		const rawSize = attr(tblW, "w:w");
+		const type = attr(tblW, "w:type");
+		const size = type === "pct" ? rawSize : attrNum(tblW, "w:w");
+		if (size !== void 0 || type) opts.width = {
+			size: size ?? 0,
+			...type ? { type } : {}
+		};
+	}
+	const jc = findChild(el, "w:jc");
+	if (jc) {
+		const val = attr(jc, "w:val");
+		if (val) opts.alignment = val;
+	}
+	const layout = findChild(el, "w:tblLayout");
+	if (layout) {
+		const val = attr(layout, "w:type");
+		if (val === "autofit" || val === "fixed") opts.layout = val;
+	}
+	const tblBorders = findChild(el, "w:tblBorders");
+	if (tblBorders) {
+		const borders = {};
+		for (const side of [
+			"top",
+			"bottom",
+			"left",
+			"right",
+			"insideH",
+			"insideV"
+		]) {
+			const sideEl = findChild(tblBorders, `w:${side}`);
+			if (sideEl) {
+				const b = {};
+				const val = attr(sideEl, "w:val");
+				if (val) b.style = val;
+				const color = attr(sideEl, "w:color");
+				if (color) b.color = color;
+				const sz = attrNum(sideEl, "w:sz");
+				if (sz !== void 0) b.size = sz;
+				const space = attrNum(sideEl, "w:space");
+				if (space !== void 0) b.space = space;
+				borders[side] = b;
+			}
+		}
+		if (Object.keys(borders).length > 0) opts.borders = borders;
+	}
+	const tblCellMar = findChild(el, "w:tblCellMar");
+	if (tblCellMar) {
+		const margins = {};
+		for (const side of [
+			"top",
+			"bottom",
+			"left",
+			"right"
+		]) {
+			const sideEl = findChild(tblCellMar, `w:${side}`);
+			if (sideEl) {
+				const size = attrNum(sideEl, "w:w");
+				const type = attr(sideEl, "w:type");
+				if (size !== void 0) margins[side] = {
+					size,
+					type: type ?? "dxa"
+				};
+			}
+		}
+		if (Object.keys(margins).length > 0) opts.margins = margins;
+	}
+	const shd = findChild(el, "w:shd");
+	if (shd) {
+		const shading = {};
+		const fill = attr(shd, "w:fill");
+		if (fill) shading.fill = fill;
+		const color = attr(shd, "w:color");
+		if (color) shading.color = color;
+		const val = attr(shd, "w:val");
+		if (val) shading.type = val;
+		if (Object.keys(shading).length > 0) opts.shading = shading;
+	}
+	return opts;
+}
+function parseColumnWidthsEl(el) {
+	const cols = [];
+	const tblGrid = findChild(el, "w:tblGrid");
+	if (!tblGrid) return cols;
+	for (const col of children(tblGrid, "w:gridCol")) {
+		const w = attrNum(col, "w:w");
+		cols.push(w ?? 100);
+	}
+	return cols;
+}
+function parseTableRowPropertiesEl(el) {
+	const opts = {};
+	const trHeight = findChild(el, "w:trHeight");
+	if (trHeight) {
+		const val = attrNum(trHeight, "w:val");
+		const rule = attr(trHeight, "w:hRule");
+		if (val !== void 0) opts.height = {
+			value: val,
+			rule: rule ?? "atLeast"
+		};
+	}
+	const tblHeader = findChild(el, "w:tblHeader");
+	if (tblHeader) opts.tableHeader = attrBool(tblHeader, "w:val") ?? true;
+	const cantSplit = findChild(el, "w:cantSplit");
+	if (cantSplit) opts.cantSplit = attrBool(cantSplit, "w:val") ?? true;
+	return opts;
+}
+function parseTableCellPropertiesEl(el) {
+	const opts = {};
+	const tcW = findChild(el, "w:tcW");
+	if (tcW) {
+		const size = attrNum(tcW, "w:w");
+		const type = attr(tcW, "w:type");
+		if (size !== void 0) opts.width = {
+			size,
+			type: type ?? "dxa"
+		};
+	}
+	const gridSpan = findChild(el, "w:gridSpan");
+	if (gridSpan) {
+		const val = attrNum(gridSpan, "w:val");
+		if (val !== void 0) opts.columnSpan = val;
+	}
+	const vMerge = findChild(el, "w:vMerge");
+	if (vMerge) opts.verticalMerge = attr(vMerge, "w:val") === "restart" ? "restart" : "continue";
+	const vAlign = findChild(el, "w:vAlign");
+	if (vAlign) {
+		const val = attr(vAlign, "w:val");
+		if (val) opts.verticalAlign = val;
+	}
+	const shd = findChild(el, "w:shd");
+	if (shd) {
+		const shading = {};
+		const fill = attr(shd, "w:fill");
+		if (fill) shading.fill = fill;
+		const color = attr(shd, "w:color");
+		if (color) shading.color = color;
+		const val = attr(shd, "w:val");
+		if (val) shading.type = val;
+		if (Object.keys(shading).length > 0) opts.shading = shading;
+	}
+	const tcBorders = findChild(el, "w:tcBorders");
+	if (tcBorders) {
+		const borders = {};
+		for (const side of [
+			"top",
+			"bottom",
+			"left",
+			"right"
+		]) {
+			const sideEl = findChild(tcBorders, `w:${side}`);
+			if (sideEl) {
+				const b = {};
+				const val = attr(sideEl, "w:val");
+				if (val) b.style = val;
+				const color = attr(sideEl, "w:color");
+				if (color) b.color = color;
+				const sz = attrNum(sideEl, "w:sz");
+				if (sz !== void 0) b.size = sz;
+				borders[side] = b;
+			}
+		}
+		if (Object.keys(borders).length > 0) opts.borders = borders;
+	}
+	if (findChild(el, "w:noWrap")) opts.noWrap = true;
+	const tcMar = findChild(el, "w:tcMar");
+	if (tcMar) {
+		const margins = {};
+		let marginUnitType;
+		for (const side of [
+			"top",
+			"bottom",
+			"left",
+			"right"
+		]) {
+			const sideEl = findChild(tcMar, `w:${side}`);
+			if (sideEl) {
+				const size = attrNum(sideEl, "w:w");
+				const type = attr(sideEl, "w:type");
+				if (size !== void 0) {
+					margins[side] = size;
+					if (type && !marginUnitType) marginUnitType = type;
+				}
+			}
+		}
+		if (marginUnitType) margins.marginUnitType = marginUnitType;
+		if (Object.keys(margins).length > 0) opts.margins = margins;
+	}
+	const textDirection = findChild(el, "w:textDirection");
+	if (textDirection) {
+		const val = attr(textDirection, "w:val");
+		if (val) opts.textDirection = val;
+	}
+	return opts;
+}
+function parseTableCellEl(el, ctx) {
+	const opts = {};
+	const tcPr = findChild(el, "w:tcPr");
+	if (tcPr) Object.assign(opts, parseTableCellPropertiesEl(tcPr));
+	const childElements = [];
+	for (const child of el.elements ?? []) switch (child.name) {
+		case "w:tcPr": break;
+		case "w:p":
+		case "w:tbl":
+			if (_parseChild) childElements.push(_parseChild(child, ctx));
+			break;
+		default: break;
+	}
+	opts.children = childElements;
+	return opts;
+}
+function parseTableRowEl(el, ctx) {
+	const opts = {};
+	const trPr = findChild(el, "w:trPr");
+	if (trPr) Object.assign(opts, parseTableRowPropertiesEl(trPr));
+	const childCells = [];
+	for (const child of el.elements ?? []) if (child.name === "w:tc") childCells.push(parseTableCellEl(child, ctx));
+	opts.cells = childCells;
+	return opts;
+}
+function parseTableEl(el, ctx) {
+	const opts = {};
+	const tblPr = findChild(el, "w:tblPr");
+	if (tblPr) Object.assign(opts, parseTablePropertiesEl(tblPr));
+	const colWidths = parseColumnWidthsEl(el);
+	if (colWidths.length > 0) opts.columnWidths = colWidths;
+	const rows = [];
+	for (const child of el.elements ?? []) if (child.name === "w:tr") rows.push(parseTableRowEl(child, ctx));
+	opts.rows = rows;
+	return opts;
+}
+//#endregion
+//#region src/parts/document/document-attributes.ts
+/**
+* Document attributes module for WordprocessingML documents.
+*
+* This module defines the XML namespace declarations used in OOXML documents.
+* These namespaces are required for proper document parsing and generation.
+*
+* Reference: http://officeopenxml.com/anatomyofOOXML.php
+*
+* @module
+*/
+/**
+* XML namespace URIs used in WordprocessingML documents.
+*
+* These namespaces define the various XML schemas that can be referenced
+* in a document, including WordprocessingML, DrawingML, VML, and others.
+*/
+const DocumentAttributeNamespaces = {
+	aink: "http://schemas.microsoft.com/office/drawing/2016/ink",
+	am3d: "http://schemas.microsoft.com/office/drawing/2017/model3d",
+	cp: "http://schemas.openxmlformats.org/package/2006/metadata/core-properties",
+	cx: "http://schemas.microsoft.com/office/drawing/2014/chartex",
+	cx1: "http://schemas.microsoft.com/office/drawing/2015/9/8/chartex",
+	cx2: "http://schemas.microsoft.com/office/drawing/2015/10/21/chartex",
+	cx3: "http://schemas.microsoft.com/office/drawing/2016/5/9/chartex",
+	cx4: "http://schemas.microsoft.com/office/drawing/2016/5/10/chartex",
+	cx5: "http://schemas.microsoft.com/office/drawing/2016/5/11/chartex",
+	cx6: "http://schemas.microsoft.com/office/drawing/2016/5/12/chartex",
+	cx7: "http://schemas.microsoft.com/office/drawing/2016/5/13/chartex",
+	cx8: "http://schemas.microsoft.com/office/drawing/2016/5/14/chartex",
+	dc: "http://purl.org/dc/elements/1.1/",
+	dcmitype: "http://purl.org/dc/dcmitype/",
+	dcterms: "http://purl.org/dc/terms/",
+	m: "http://schemas.openxmlformats.org/officeDocument/2006/math",
+	mc: "http://schemas.openxmlformats.org/markup-compatibility/2006",
+	o: "urn:schemas-microsoft-com:office:office",
+	r: "http://schemas.openxmlformats.org/officeDocument/2006/relationships",
+	v: "urn:schemas-microsoft-com:vml",
+	w: "http://schemas.openxmlformats.org/wordprocessingml/2006/main",
+	w10: "urn:schemas-microsoft-com:office:word",
+	w14: "http://schemas.microsoft.com/office/word/2010/wordml",
+	w15: "http://schemas.microsoft.com/office/word/2012/wordml",
+	w16: "http://schemas.microsoft.com/office/word/2018/wordml",
+	w16cex: "http://schemas.microsoft.com/office/word/2018/wordml/cex",
+	w16cid: "http://schemas.microsoft.com/office/word/2016/wordml/cid",
+	w16sdtdh: "http://schemas.microsoft.com/office/word/2020/wordml/sdtdatahash",
+	w16se: "http://schemas.microsoft.com/office/word/2015/wordml/symex",
+	wne: "http://schemas.microsoft.com/office/word/2006/wordml",
+	wp: "http://schemas.openxmlformats.org/drawingml/2006/wordprocessingDrawing",
+	wp14: "http://schemas.microsoft.com/office/word/2010/wordprocessingDrawing",
+	wpc: "http://schemas.microsoft.com/office/word/2010/wordprocessingCanvas",
+	wpg: "http://schemas.microsoft.com/office/word/2010/wordprocessingGroup",
+	wpi: "http://schemas.microsoft.com/office/word/2010/wordprocessingInk",
+	wps: "http://schemas.microsoft.com/office/word/2010/wordprocessingShape",
+	xsi: "http://www.w3.org/2001/XMLSchema-instance"
+};
+//#endregion
+//#region src/parts/document/body/section-properties/properties/page-size.ts
+/**
+* This simple type specifies the orientation of all pages in the parent section. This information is used to determine the actual paper size to use when printing the file.
+*
+* Reference: https://c-rex.net/samples/ooxml/e1/Part4/OOXML_P4_DOCX_ST_PageOrientation_topic_ID0EKBK3.html
+*
+* ## XSD Schema
+*
+* ```xml
+* <xsd:simpleType name="ST_PageOrientation">
+*   <xsd:restriction base="xsd:string">
+*     <xsd:enumeration value="portrait"/>
+*     <xsd:enumeration value="landscape"/>
+*   </xsd:restriction>
+* </xsd:simpleType>
+* ```
+*
+* @publicApi
+*/
+const PageOrientation = {
+	/**
+	* ## Portrait Mode
+	*
+	* Specifies that pages in this section shall be printed in portrait mode.
+	*/
+	PORTRAIT: "portrait",
+	/**
+	* ## Landscape Mode
+	*
+	* Specifies that pages in this section shall be printed in landscape mode, which prints the page contents with a 90 degree rotation with respect to the normal page orientation.
+	*/
+	LANDSCAPE: "landscape"
+};
+/**
+* This element specifies the properties (size and orientation) for all pages in the current section.
+*
+* Reference: https://c-rex.net/samples/ooxml/e1/Part4/OOXML_P4_DOCX_pgSz_topic_ID0ENEDT.html?hl=pgsz%2Cpage%2Csize
+*
+* ## XSD Schema
+*
+* ```xml
+* <xsd:complexType name="CT_PageSz">
+*   <xsd:attribute name="w" type="s:ST_TwipsMeasure"/>
+*   <xsd:attribute name="h" type="s:ST_TwipsMeasure"/>
+*   <xsd:attribute name="orient" type="ST_PageOrientation" use="optional"/>
+*   <xsd:attribute name="code" type="ST_DecimalNumber" use="optional"/>
+* </xsd:complexType>
+* ```
+*/
+const createPageSize = ({ width, height, orientation, code }) => {
+	const widthTwips = twipsMeasureValue(width);
+	const heightTwips = twipsMeasureValue(height);
+	return element("w:pgSz", {
+		"w:code": code,
+		"w:h": orientation === PageOrientation.LANDSCAPE ? widthTwips : heightTwips,
+		"w:orient": orientation,
+		"w:w": orientation === PageOrientation.LANDSCAPE ? heightTwips : widthTwips
+	});
+};
+//#endregion
+//#region src/parts/document/body/section-properties/properties/page-text-direction.ts
+/**
+* Page text direction module for WordprocessingML section properties.
+*
+* Defines text flow direction for pages in a section.
+*
+* Reference: http://officeopenxml.com/WPsectionPr.php
+*
+* @module
+*/
+/**
+* Specifies the text flow direction for pages in a section.
+*
+* This controls whether text flows horizontally (left-to-right) or
+* vertically (top-to-bottom), commonly used for East Asian languages.
+*/
+const PageTextDirectionType = {
+	/** Left-to-right, top-to-bottom (standard Western text flow) */
+	LEFT_TO_RIGHT_TOP_TO_BOTTOM: "lrTb",
+	/** Top-to-bottom, right-to-left (vertical East Asian text flow) */
+	TOP_TO_BOTTOM_RIGHT_TO_LEFT: "tbRl"
+};
+//#endregion
+//#region src/parts/document/body/section-properties/section-properties.ts
+const sectionMarginDefaults = {
+	TOP: 1440,
+	RIGHT: 1800,
+	BOTTOM: 1440,
+	LEFT: 1800,
+	HEADER: 851,
+	FOOTER: 992,
+	GUTTER: 0
+};
+const sectionPageSizeDefaults = {
+	WIDTH: 11906,
+	HEIGHT: 16838,
+	ORIENTATION: PageOrientation.PORTRAIT
+};
+//#endregion
+//#region src/parts/document/body/section-properties/properties/doc-grid.ts
+/**
+* Specifies the type of the current document grid, which defines the grid behavior.
+*
+* The grid can define a grid which snaps all East Asian characters to grid positions, but leaves Latin text with its default spacing; a grid which adds the specified character pitch to all characters on each row; or a grid which affects only the line pitch for the current section.
+*
+* Reference: https://c-rex.net/samples/ooxml/e1/Part4/OOXML_P4_DOCX_ST_DocGrid_topic_ID0ELYP2.html
+*
+* ## XSD Schema
+* ```xml
+* <xsd:simpleType name="ST_DocGrid">
+*   <xsd:restriction base="xsd:string">
+*     <xsd:enumeration value="default"/>
+*     <xsd:enumeration value="lines"/>
+*     <xsd:enumeration value="linesAndChars"/>
+*     <xsd:enumeration value="snapToChars"/>
+*   </xsd:restriction>
+* </xsd:simpleType>
+* ```
+*/
+const DocumentGridType = {
+	/**
+	* Specifies that no document grid shall be applied to the contents of the current section in the document.
+	*/
+	DEFAULT: "default",
+	/**
+	* Specifies that the parent section shall have additional line pitch added to each line within it (as specified on the <docGrid> element (§2.6.5)) in order to maintain the specified number of lines per page.
+	*/
+	LINES: "lines",
+	/**
+	* Specifies that the parent section shall have both the additional line pitch and character pitch added to each line and character within it (as specified on the <docGrid> element (§2.6.5)) in order to maintain a specific number of lines per page and characters per line.
+	*
+	* When this value is set, the input specified via the user interface may be allowed in exact number of line/character pitch units. */
+	LINES_AND_CHARS: "linesAndChars",
+	/**
+	* Specifies that the parent section shall have both the additional line pitch and character pitch added to each line and character within it (as specified on the <docGrid> element (§2.6.5)) in order to maintain a specific number of lines per page and characters per line.
+	*
+	* When this value is set, the input specified via the user interface may be restricted to the number of lines per page and characters per line, with the consumer or producer translating this information based on the current font data to get the resulting line and character pitch values
+	*/
+	SNAP_TO_CHARS: "snapToChars"
+};
+/**
+* This element specifies the settings for the document grid, which enables precise layout of full-width East Asian language characters within a document by specifying the desired number of characters per line and lines per page for all East Asian text content in this section.
+*
+* Reference: https://c-rex.net/samples/ooxml/e1/Part4/OOXML_P4_DOCX_docGrid_topic_ID0EHU5S.html
+*
+* ```xml
+* <xsd:complexType name="CT_DocGrid">
+*   <xsd:attribute name="type" type="ST_DocGrid"/>
+*   <xsd:attribute name="linePitch" type="ST_DecimalNumber"/>
+*   <xsd:attribute name="charSpace" type="ST_DecimalNumber"/>
+* </xsd:complexType>
+* ```
+* @returns
+*/
+const createDocumentGrid = ({ type, linePitch, charSpace }) => element("w:docGrid", {
+	"w:charSpace": charSpace ? decimalNumber(charSpace) : void 0,
+	"w:linePitch": decimalNumber(linePitch),
+	"w:type": type
+});
+//#endregion
+//#region src/parts/document/body/section-properties/properties/page-number.ts
+/**
+* Specifies the separator character between chapter number and page number.
+*
+* ## XSD Schema
+* ```xml
+* <xsd:simpleType name="ST_ChapterSep">
+*   <xsd:restriction base="xsd:string">
+*     <xsd:enumeration value="hyphen"/>
+*     <xsd:enumeration value="period"/>
+*     <xsd:enumeration value="colon"/>
+*     <xsd:enumeration value="emDash"/>
+*     <xsd:enumeration value="enDash"/>
+*   </xsd:restriction>
+* </xsd:simpleType>
+* ```
+*
+* @publicApi
+*/
+const PageNumberSeparator = {
+	/** Hyphen separator (-) */
+	HYPHEN: "hyphen",
+	/** Period separator (.) */
+	PERIOD: "period",
+	/** Colon separator (:) */
+	COLON: "colon",
+	/** Em dash separator (—) */
+	EM_DASH: "emDash",
+	/** En dash separator (–) */
+	EN_DASH: "enDash"
+};
+/**
+* Creates page numbering settings (pgNumType) for a document section.
+*
+* This element specifies the page numbering format and starting value
+* for all pages in a section.
+*
+* Reference: http://officeopenxml.com/WPSectionPgNumType.php
+*
+* ## XSD Schema
+* ```xml
+* <xsd:complexType name="CT_PageNumber">
+*   <xsd:attribute name="fmt" type="ST_NumberFormat" use="optional" default="decimal"/>
+*   <xsd:attribute name="start" type="ST_DecimalNumber" use="optional"/>
+*   <xsd:attribute name="chapStyle" type="ST_DecimalNumber" use="optional"/>
+*   <xsd:attribute name="chapSep" type="ST_ChapterSep" use="optional" default="hyphen"/>
+* </xsd:complexType>
+* ```
+*
+* @example
+* ```typescript
+* // Start page numbering at 5 with lowercase roman numerals
+* createPageNumberType({
+*   start: 5,
+*   formatType: NumberFormat.LOWER_ROMAN
+* });
+* ```
+*/
+const createPageNumberType = ({ start, formatType, separator, chapStyle }) => element("w:pgNumType", {
+	"w:chapStyle": chapStyle === void 0 ? void 0 : decimalNumber(chapStyle),
+	"w:fmt": formatType,
+	"w:chapSep": separator,
+	"w:start": start === void 0 ? void 0 : decimalNumber(start)
+});
+//#endregion
+//#region src/parts/document/body/section-properties/properties/page-borders.ts
+/**
+* Specifies which pages display the page border.
+*
+* ## XSD Schema
+* ```xml
+* <xsd:simpleType name="ST_PageBorderDisplay">
+*   <xsd:restriction base="xsd:string">
+*     <xsd:enumeration value="allPages"/>
+*     <xsd:enumeration value="firstPage"/>
+*     <xsd:enumeration value="notFirstPage"/>
+*   </xsd:restriction>
+* </xsd:simpleType>
+* ```
+*
+* @publicApi
+*/
+const PageBorderDisplay = {
+	/** Display border on all pages */
+	ALL_PAGES: "allPages",
+	/** Display border only on first page */
+	FIRST_PAGE: "firstPage",
+	/** Display border on all pages except first page */
+	NOT_FIRST_PAGE: "notFirstPage"
+};
+/**
+* Specifies whether page border is positioned relative to page edge or text.
+*
+* ## XSD Schema
+* ```xml
+* <xsd:simpleType name="ST_PageBorderOffset">
+*   <xsd:restriction base="xsd:string">
+*     <xsd:enumeration value="page"/>
+*     <xsd:enumeration value="text"/>
+*   </xsd:restriction>
+* </xsd:simpleType>
+* ```
+*
+* @publicApi
+*/
+const PageBorderOffsetFrom = {
+	/** Position border relative to page edge */
+	PAGE: "page",
+	/** Position border relative to text (default) */
+	TEXT: "text"
+};
+/**
+* Specifies z-order of page border relative to intersecting objects.
+*
+* ## XSD Schema
+* ```xml
+* <xsd:simpleType name="ST_PageBorderZOrder">
+*   <xsd:restriction base="xsd:string">
+*     <xsd:enumeration value="front"/>
+*     <xsd:enumeration value="back"/>
+*   </xsd:restriction>
+* </xsd:simpleType>
+* ```
+*
+* @publicApi
+*/
+const PageBorderZOrder = {
+	/** Display border behind page contents */
+	BACK: "back",
+	/** Display border in front of page contents (default) */
+	FRONT: "front"
+};
+//#endregion
+//#region src/parts/document/body/section-properties/properties/page-margin.ts
+/**
+* Page margin module for WordprocessingML section properties.
+*
+* Defines page margins for document sections.
+*
+* Reference: http://officeopenxml.com/WPsectionPr.php
+*
+* @module
+*/
+/**
+* Creates page margins (pgMar) for a document section.
+*
+* This element specifies the page margins for all pages in a section,
+* including top, bottom, left, right, header, footer, and gutter margins.
+*
+* Reference: http://officeopenxml.com/WPsectionPr.php
+*
+* ## XSD Schema
+* ```xml
+* <xsd:complexType name="CT_PageMar">
+*   <xsd:attribute name="top" type="ST_SignedTwipsMeasure" use="required"/>
+*   <xsd:attribute name="right" type="s:ST_TwipsMeasure" use="required"/>
+*   <xsd:attribute name="bottom" type="ST_SignedTwipsMeasure" use="required"/>
+*   <xsd:attribute name="left" type="s:ST_TwipsMeasure" use="required"/>
+*   <xsd:attribute name="header" type="s:ST_TwipsMeasure" use="required"/>
+*   <xsd:attribute name="footer" type="s:ST_TwipsMeasure" use="required"/>
+*   <xsd:attribute name="gutter" type="s:ST_TwipsMeasure" use="required"/>
+* </xsd:complexType>
+* ```
+*
+* @example
+* ```typescript
+* // Create page margins with 1 inch margins (1440 twips = 1 inch)
+* createPageMargin(1440, 1440, 1440, 1440, 720, 720, 0);
+* ```
+*/
+const createPageMargin = (top, right, bottom, left, header, footer, gutter) => `<w:pgMar w:bottom="${signedTwipsMeasureValue(bottom)}" w:footer="${twipsMeasureValue(footer)}" w:gutter="${twipsMeasureValue(gutter)}" w:header="${twipsMeasureValue(header)}" w:left="${twipsMeasureValue(left)}" w:right="${twipsMeasureValue(right)}" w:top="${signedTwipsMeasureValue(top)}"/>`;
+//#endregion
+//#region src/parts/document/body/section-properties/properties/line-number.ts
+/**
+* This simple type specifies when the line numbering in the parent section shall be reset to its restart value. The line numbering increments for each line (even if the line number itself is not displayed) until it reaches the restart point specified by this element.
+*
+* Reference: https://c-rex.net/samples/ooxml/e1/Part4/OOXML_P4_DOCX_ST_LineNumberRestart_topic_ID0EUS42.html
+*
+* ## XSD Schema
+*
+* ```xml
+* <xsd:simpleType name="ST_LineNumberRestart">
+*   <xsd:restriction base="xsd:string">
+*     <xsd:enumeration value="newPage"/>
+*     <xsd:enumeration value="newSection"/>
+*     <xsd:enumeration value="continuous"/>
+*   </xsd:restriction>
+* </xsd:simpleType>
+* ```
+*
+* @publicApi
+*/
+const LineNumberRestartFormat = {
+	/**
+	* ## Restart Line Numbering on Each Page
+	*
+	* Specifies that line numbering for the parent section shall restart to the starting value whenever a new page is displayed.
+	*/
+	NEW_PAGE: "newPage",
+	/**
+	* ## Restart Line Numbering for Each Section
+	*
+	* Specifies that line numbering for the parent section shall restart to the starting value whenever the parent begins.
+	*/
+	NEW_SECTION: "newSection",
+	/**
+	* ## Continue Line Numbering From Previous Section
+	*
+	* Specifies that line numbering for the parent section shall continue from the line numbering from the end of the previous section, if any.
+	*/
+	CONTINUOUS: "continuous"
+};
+/**
+* This element specifies the settings for line numbering to be displayed before each column of text in this section in the document.
+*
+* References:
+* - https://c-rex.net/samples/ooxml/e1/Part4/OOXML_P4_DOCX_lnNumType_topic_ID0EVRAT.html
+* - http://officeopenxml.com/WPsectionLineNumbering.php
+*
+* ## XSD Schema
+*
+* ```xml
+* <xsd:complexType name="CT_LineNumber">
+*   <xsd:attribute name="countBy" type="ST_DecimalNumber" use="optional"/>
+*   <xsd:attribute name="start" type="ST_DecimalNumber" use="optional" default="1"/>
+*   <xsd:attribute name="distance" type="s:ST_TwipsMeasure" use="optional"/>
+*   <xsd:attribute name="restart" type="ST_LineNumberRestart" use="optional" default="newPage"/>
+* </xsd:complexType>
+* ```
+*/
+const createLineNumberType = ({ countBy, start, restart, distance }) => element("w:lnNumType", {
+	"w:countBy": countBy === void 0 ? void 0 : decimalNumber(countBy),
+	"w:distance": distance === void 0 ? void 0 : twipsMeasureValue(distance),
+	"w:restart": restart,
+	"w:start": start === void 0 ? void 0 : decimalNumber(start)
+});
+//#endregion
+//#region src/parts/document/body/section-properties/properties/section-type.ts
+/**
+* Section type module for WordprocessingML section properties.
+*
+* Defines how a section begins relative to the previous section.
+*
+* Reference: http://officeopenxml.com/WPsection.php
+*
+* @module
+*/
+/**
+* Specifies the type of section break.
+*
+* This determines where the section begins relative to the previous section.
+*
+* ## XSD Schema
+* ```xml
+* <xsd:simpleType name="ST_SectionMark">
+*   <xsd:restriction base="xsd:string">
+*     <xsd:enumeration value="nextPage"/>
+*     <xsd:enumeration value="nextColumn"/>
+*     <xsd:enumeration value="continuous"/>
+*     <xsd:enumeration value="evenPage"/>
+*     <xsd:enumeration value="oddPage"/>
+*   </xsd:restriction>
+* </xsd:simpleType>
+* ```
+*
+* @publicApi
+*/
+const SectionType = {
+	/** Section begins on the next page */
+	NEXT_PAGE: "nextPage",
+	/** Section begins on the next column */
+	NEXT_COLUMN: "nextColumn",
+	/** Section begins immediately following the previous section */
+	CONTINUOUS: "continuous",
+	/** Section begins on the next even-numbered page */
+	EVEN_PAGE: "evenPage",
+	/** Section begins on the next odd-numbered page */
+	ODD_PAGE: "oddPage"
+};
+/**
+* Creates section type (type) for a document section.
+*
+* This element specifies the type of section break, which determines
+* where the new section begins relative to the previous section.
+*
+* Reference: http://officeopenxml.com/WPsection.php
+*
+* ## XSD Schema
+* ```xml
+* <xsd:complexType name="CT_SectType">
+*   <xsd:attribute name="val" type="ST_SectionMark"/>
+* </xsd:complexType>
+* ```
+*
+* @example
+* ```typescript
+* // Create a continuous section (no page break)
+* createSectionType(SectionType.CONTINUOUS);
+*
+* // Create a section that starts on next odd page
+* createSectionType(SectionType.ODD_PAGE);
+* ```
+*/
+const createSectionType = (value) => `<w:type w:val="${value}"/>`;
+//#endregion
+//#region src/parts/document/body/section-properties/properties/header-footer-reference.ts
+/**
+* This simple type specifies the possible types of headers and footers which may be specified for a given header or footer reference in a document. This value determines the page(s) on which the current header or footer shall be displayed.
+*
+* Reference: https://c-rex.net/samples/ooxml/e1/Part4/OOXML_P4_DOCX_ST_HdrFtr_topic_ID0E2UW2.html
+*
+* ## XSD Schema
+* ```xml
+* <xsd:simpleType name="ST_HdrFtr">
+*   <xsd:restriction base="xsd:string">
+*     <xsd:enumeration value="even"/>
+*     <xsd:enumeration value="default"/>
+*     <xsd:enumeration value="first"/>
+*   </xsd:restriction>
+* </xsd:simpleType>
+* ```
+*/
+const HeaderFooterReferenceType = {
+	/** Specifies that this header or footer shall appear on every page in this section which is not overridden with a specific `even` or `first` page header/footer. In a section with all three types specified, this type shall be used on all odd numbered pages (counting from the `first` page in the section, not the section numbering). */
+	DEFAULT: "default",
+	/** Specifies that this header or footer shall appear on the first page in this section. The appearance of this header or footer is contingent on the setting of the `titlePg` element (§2.10.6). */
+	FIRST: "first",
+	/** Specifies that this header or footer shall appear on all even numbered pages in this section (counting from the first page in the section, not the section numbering). The appearance of this header or footer is contingent on the setting of the `evenAndOddHeaders` element (§2.10.1). */
+	EVEN: "even"
+};
+const HeaderFooterType = {
+	FOOTER: "w:footerReference",
+	HEADER: "w:headerReference"
+};
+const createHeaderFooterReference = (type, options) => `<${type} r:id="rId${options.id}" w:type="${options.type || HeaderFooterReferenceType.DEFAULT}"/>`;
+//#endregion
+//#region src/parts/document/body/section-properties/descriptor.ts
+/**
+* Section properties descriptor for DOCX documents.
+*
+* Produces `<w:sectPr>` XML directly from options, eliminating all
+* intermediate XmlComponent instances (create* + toXml pattern).
+*
+* Reference: ISO/IEC 29500-4, wml.xsd, CT_SectPr
+*
+* @module
+*/
+function stringifyBorderXml(tag, opts) {
+	const attrs = [];
+	if (opts.style !== void 0) attrs.push(`w:val="${opts.style}"`);
+	if (opts.color !== void 0) attrs.push(`w:color="${opts.color}"`);
+	if (opts.size !== void 0) attrs.push(`w:sz="${opts.size}"`);
+	if (opts.space !== void 0) attrs.push(`w:space="${opts.space}"`);
+	if (opts.themeColor !== void 0) attrs.push(`w:themeColor="${opts.themeColor}"`);
+	if (opts.themeTint !== void 0) attrs.push(`w:themeTint="${opts.themeTint}"`);
+	if (opts.themeShade !== void 0) attrs.push(`w:themeShade="${opts.themeShade}"`);
+	if (opts.shadow !== void 0) attrs.push(`w:shadow="${opts.shadow ? 1 : 0}"`);
+	if (opts.frame !== void 0) attrs.push(`w:frame="${opts.frame ? 1 : 0}"`);
+	return `<${tag} ${attrs.join(" ")}/>`;
+}
+function pageSizeXml(w, h, orient, code) {
+	const attrs = [`w:w="${w}"`, `w:h="${h}"`];
+	if (orient) attrs.push(`w:orient="${orient}"`);
+	if (code !== void 0) attrs.push(`w:code="${code}"`);
+	return `<w:pgSz ${attrs.join(" ")}/>`;
+}
+function pageMarginXml(top, right, bottom, left, header, footer, gutter) {
+	return `<w:pgMar w:top="${top}" w:right="${right}" w:bottom="${bottom}" w:left="${left}" w:header="${header}" w:footer="${footer}" w:gutter="${gutter}"/>`;
+}
+function headerFooterRefXml(tag, id, type) {
+	return `<${tag} r:id="rId${id}" w:type="${type}"/>`;
+}
+function sectionTypeXml(val) {
+	return `<w:type w:val="${val}"/>`;
+}
+function verticalAlignXml(val) {
+	return `<w:vAlign w:val="${val}"/>`;
+}
+function lineNumberXml(opts) {
+	const attrs = [];
+	if (opts.countBy !== void 0) attrs.push(`w:countBy="${opts.countBy}"`);
+	if (opts.start !== void 0) attrs.push(`w:start="${opts.start}"`);
+	if (opts.restart !== void 0) attrs.push(`w:restart="${opts.restart}"`);
+	if (opts.distance !== void 0) attrs.push(`w:distance="${opts.distance}"`);
+	return attrs.length ? `<w:lnNumType ${attrs.join(" ")}/>` : "<w:lnNumType/>";
+}
+function pageNumberXml(opts) {
+	const attrs = [];
+	if (opts.start !== void 0) attrs.push(`w:start="${opts.start}"`);
+	if (opts.formatType !== void 0) attrs.push(`w:fmt="${opts.formatType}"`);
+	if (opts.separator !== void 0) attrs.push(`w:chapSep="${opts.separator}"`);
+	if (opts.chapStyle !== void 0) attrs.push(`w:chapStyle="${opts.chapStyle}"`);
+	return attrs.length ? `<w:pgNumType ${attrs.join(" ")}/>` : "<w:pgNumType/>";
+}
+function docGridXml(linePitch, charSpace, type) {
+	const attrs = [`w:linePitch="${linePitch}"`];
+	if (charSpace !== void 0) attrs.push(`w:charSpace="${charSpace}"`);
+	if (type !== void 0) attrs.push(`w:type="${type}"`);
+	return `<w:docGrid ${attrs.join(" ")}/>`;
+}
+function columnsXml(opts) {
+	const attrs = [];
+	if (opts.space !== void 0) attrs.push(`w:space="${twipsMeasureValue(opts.space)}"`);
+	if (opts.count !== void 0) attrs.push(`w:num="${opts.count}"`);
+	if (opts.separate !== void 0) attrs.push(`w:sep="${opts.separate ? 1 : 0}"`);
+	if (opts.equalWidth !== void 0) attrs.push(`w:equalWidth="${opts.equalWidth ? 1 : 0}"`);
+	const attrStr = attrs.join(" ");
+	if (!opts.equalWidth && opts.children) {
+		const colParts = [];
+		for (const col of opts.children) {
+			const colAttrs = [`w:w="${twipsMeasureValue(col.width)}"`];
+			if (col.space !== void 0) colAttrs.push(`w:space="${twipsMeasureValue(col.space)}"`);
+			colParts.push(`<w:col ${colAttrs.join(" ")}/>`);
+		}
+		return `<w:cols ${attrStr}>${colParts.join("")}</w:cols>`;
+	}
+	return `<w:cols ${attrStr}/>`;
+}
+function footnotePrXml(tag, opts) {
+	const parts = [];
+	if (opts.pos !== void 0) parts.push(`<w:pos w:val="${opts.pos}"/>`);
+	if (opts.formatType !== void 0 || opts.format !== void 0) {
+		const fmtAttrs = [];
+		if (opts.formatType !== void 0) fmtAttrs.push(`w:fmt="${opts.formatType}"`);
+		if (opts.format !== void 0) fmtAttrs.push(`w:format="${opts.format}"`);
+		parts.push(`<w:numFmt ${fmtAttrs.join(" ")}/>`);
+	}
+	if (opts.numStart !== void 0) parts.push(`<w:numStart w:val="${opts.numStart}"/>`);
+	if (opts.numRestart !== void 0) parts.push(`<w:numRestart w:val="${opts.numRestart}"/>`);
+	const body = parts.join("");
+	return body ? `<${tag}>${body}</${tag}>` : `<${tag}/>`;
+}
+function pageBordersXml(opts) {
+	const attrs = [];
+	if (opts.display !== void 0) attrs.push(`w:display="${opts.display}"`);
+	if (opts.offsetFrom !== void 0) attrs.push(`w:offsetFrom="${opts.offsetFrom}"`);
+	if (opts.zOrder !== void 0) attrs.push(`w:zOrder="${opts.zOrder}"`);
+	const parts = [];
+	if (opts.top) parts.push(stringifyBorderXml("w:top", opts.top));
+	if (opts.left) parts.push(stringifyBorderXml("w:left", opts.left));
+	if (opts.bottom) parts.push(stringifyBorderXml("w:bottom", opts.bottom));
+	if (opts.right) parts.push(stringifyBorderXml("w:right", opts.right));
+	const attrStr = attrs.join(" ");
+	const body = parts.join("");
+	if (!body && !attrStr) return "<w:pgBorders/>";
+	return body ? `<w:pgBorders ${attrStr}>${body}</w:pgBorders>` : `<w:pgBorders ${attrStr}/>`;
+}
+function appendHeaderFooterRefs(parts, type, group) {
+	if (!group) return;
+	if (group.default) parts.push(headerFooterRefXml(type, group.default.referenceId, "default"));
+	if (group.first) parts.push(headerFooterRefXml(type, group.first.referenceId, "first"));
+	if (group.even) parts.push(headerFooterRefXml(type, group.even.referenceId, "even"));
+}
+function stringifySectionPropertiesChange(opts) {
+	const { author, date, id, ...inner } = opts;
+	return `<w:sectPrChange w:author="${author}" w:date="${date}" w:id="${id}"><w:sectPr>${stringifySectionPropertiesInner(inner)}</w:sectPr></w:sectPrChange>`;
+}
+function stringifySectionPropertiesInner(opts) {
+	const parts = [];
+	appendHeaderFooterRefs(parts, "w:headerReference", opts.headerWrapperGroup);
+	appendHeaderFooterRefs(parts, "w:footerReference", opts.footerWrapperGroup);
+	const { size: { width = sectionPageSizeDefaults.WIDTH, height = sectionPageSizeDefaults.HEIGHT, orientation = sectionPageSizeDefaults.ORIENTATION } = {}, margin: { top = sectionMarginDefaults.TOP, right = sectionMarginDefaults.RIGHT, bottom = sectionMarginDefaults.BOTTOM, left = sectionMarginDefaults.LEFT, header = sectionMarginDefaults.HEADER, footer = sectionMarginDefaults.FOOTER, gutter = sectionMarginDefaults.GUTTER } = {}, pageNumbers = {}, borders, textDirection } = opts.page ?? {};
+	const { linePitch = 312, charSpace = 0, type: gridType = "lines" } = opts.grid ?? {};
+	if (opts.footnotePr) parts.push(footnotePrXml("w:footnotePr", opts.footnotePr));
+	if (opts.endnotePr) parts.push(footnotePrXml("w:endnotePr", opts.endnotePr));
+	if (opts.type) parts.push(sectionTypeXml(opts.type));
+	const pgW = orientation === "landscape" ? convertToTwip(height) : width;
+	const pgH = orientation === "landscape" ? convertToTwip(width) : height;
+	parts.push(pageSizeXml(pgW, pgH, orientation));
+	parts.push(pageMarginXml(top, right, bottom, left, header, footer, gutter));
+	if (borders) parts.push(pageBordersXml(borders));
+	if (opts.lineNumbers) parts.push(lineNumberXml(opts.lineNumbers));
+	parts.push(pageNumberXml(pageNumbers));
+	if (opts.column) parts.push(columnsXml(opts.column));
+	if (opts.verticalAlign) parts.push(verticalAlignXml(opts.verticalAlign));
+	if (opts.titlePage !== void 0) parts.push(opts.titlePage ? "<w:titlePg/>" : "<w:titlePg w:val=\"0\"/>");
+	if (textDirection) parts.push(`<w:textDirection w:val="${textDirection}"/>`);
+	if (opts.noEndnote !== void 0) parts.push(opts.noEndnote ? "<w:noEndnote/>" : "<w:noEndnote w:val=\"0\"/>");
+	if (opts.formProtection !== void 0) parts.push(opts.formProtection ? "<w:formProt/>" : "<w:formProt w:val=\"0\"/>");
+	if (opts.bidi !== void 0) parts.push(opts.bidi ? "<w:bidi/>" : "<w:bidi w:val=\"0\"/>");
+	if (opts.rtlGutter !== void 0) parts.push(opts.rtlGutter ? "<w:rtlGutter/>" : "<w:rtlGutter w:val=\"0\"/>");
+	if (opts.paperSrc) {
+		const psAttr = [];
+		if (opts.paperSrc.first !== void 0) psAttr.push(`w:first="${opts.paperSrc.first}"`);
+		if (opts.paperSrc.other !== void 0) psAttr.push(`w:other="${opts.paperSrc.other}"`);
+		parts.push(`<w:paperSrc ${psAttr.join(" ")}/>`);
+	}
+	if (opts.printerSettingsId !== void 0) parts.push(`<w:printerSettings r:id="${opts.printerSettingsId}"/>`);
+	parts.push(docGridXml(linePitch, charSpace, gridType));
+	if (opts.revision) parts.push(stringifySectionPropertiesChange(opts.revision));
+	return parts.join("");
+}
+/**
+* Section properties descriptor for DOCX `<w:sectPr>` elements.
+*
+* Produces complete XML directly from options — zero XmlComponent instances
+* in the hot path. All `create*()` + `.toXml()` calls eliminated in favor
+* of direct string concatenation.
+*
+* @example
+* ```typescript
+* const xml = sectionPropertiesDesc.stringify(sectPrOpts, ctx);
+* ```
+*/
+const sectionPropertiesDesc = {
+	kind: "custom",
+	stringify(opts, _ctx) {
+		return stringifySectionPropertiesXml(opts);
+	},
+	parse(el, _ctx) {
+		return parseSectionPropertiesEl(el);
+	}
+};
+/** Standalone stringify — no context needed, pure options → XML. */
+function stringifySectionPropertiesXml(opts) {
+	const inner = stringifySectionPropertiesInner(opts);
+	const attrs = [];
+	if (opts.rsidRPr !== void 0) attrs.push(`w:rsidRPr="${opts.rsidRPr}"`);
+	if (opts.rsidDel !== void 0) attrs.push(`w:rsidDel="${opts.rsidDel}"`);
+	if (opts.rsidR !== void 0) attrs.push(`w:rsidR="${opts.rsidR}"`);
+	if (opts.rsidSect !== void 0) attrs.push(`w:rsidSect="${opts.rsidSect}"`);
+	return `<w:sectPr${attrs.length ? " " + attrs.join(" ") : ""}>${inner}</w:sectPr>`;
+}
+/** Parse a w:sectPr element into ISectionPropertiesOptions. */
+function parseSectionPropertiesEl(el) {
+	const opts = {};
+	for (const [attrName, optKey] of [
+		["w:rsidR", "rsidR"],
+		["w:rsidRPr", "rsidRPr"],
+		["w:rsidDel", "rsidDel"],
+		["w:rsidSect", "rsidSect"]
+	]) {
+		const val = attr(el, attrName);
+		if (val) opts[optKey] = val;
+	}
+	const pgSz = findChild(el, "w:pgSz");
+	if (pgSz) {
+		const page = {};
+		const size = {};
+		const w = attrNum(pgSz, "w:w");
+		const h = attrNum(pgSz, "w:h");
+		const orient = attr(pgSz, "w:orient");
+		if (orient === "landscape" && w !== void 0 && h !== void 0) {
+			size.width = h;
+			size.height = w;
+		} else {
+			if (w !== void 0) size.width = w;
+			if (h !== void 0) size.height = h;
+		}
+		if (orient) size.orientation = orient;
+		if (Object.keys(size).length > 0) page.size = size;
+		const pgMar = findChild(el, "w:pgMar");
+		if (pgMar) {
+			const margin = {};
+			for (const [a, o] of [
+				["w:top", "top"],
+				["w:right", "right"],
+				["w:bottom", "bottom"],
+				["w:left", "left"],
+				["w:header", "header"],
+				["w:footer", "footer"],
+				["w:gutter", "gutter"]
+			]) {
+				const val = attrNum(pgMar, a);
+				if (val !== void 0) margin[o] = val;
+			}
+			if (Object.keys(margin).length > 0) page.margin = margin;
+		}
+		const pgNumType = findChild(el, "w:pgNumType");
+		if (pgNumType) {
+			const pageNumbers = {};
+			const start = attrNum(pgNumType, "w:start");
+			if (start !== void 0) pageNumbers.start = start;
+			const fmt = attr(pgNumType, "w:fmt");
+			if (fmt) pageNumbers.formatType = fmt;
+			if (Object.keys(pageNumbers).length > 0) page.pageNumbers = pageNumbers;
+		}
+		if (Object.keys(page).length > 0) opts.page = page;
+	}
+	const cols = findChild(el, "w:cols");
+	if (cols) {
+		const column = {};
+		const count = attrNum(cols, "w:num");
+		if (count !== void 0) column.count = count;
+		const space = attrNum(cols, "w:space");
+		if (space !== void 0) column.space = space;
+		if (attrBool(cols, "w:sep")) column.separator = true;
+		if (Object.keys(column).length > 0) opts.column = column;
+	}
+	const type = findChild(el, "w:type");
+	if (type) {
+		const val = attr(type, "w:val");
+		if (val) opts.type = val;
+	}
+	const titlePg = findChild(el, "w:titlePg");
+	if (titlePg) opts.titlePage = attrBool(titlePg, "w:val") ?? true;
+	for (const [name, optKey] of [
+		["w:noEndnote", "noEndnote"],
+		["w:formProt", "formProtection"],
+		["w:bidi", "bidi"],
+		["w:rtlGutter", "rtlGutter"]
+	]) {
+		const child = findChild(el, name);
+		if (child) opts[optKey] = attrBool(child, "w:val") ?? true;
+	}
+	const docGrid = findChild(el, "w:docGrid");
+	if (docGrid) {
+		const grid = {};
+		const type = attr(docGrid, "w:type");
+		if (type) grid.type = type;
+		const linePitch = attrNum(docGrid, "w:linePitch");
+		if (linePitch !== void 0) grid.linePitch = linePitch;
+		const charSpace = attrNum(docGrid, "w:charSpace");
+		if (charSpace !== void 0) grid.charSpace = charSpace;
+		if (Object.keys(grid).length > 0) opts.grid = grid;
+	}
+	const lnNumType = findChild(el, "w:lnNumType");
+	if (lnNumType) {
+		const lineNumbers = {};
+		const countBy = attrNum(lnNumType, "w:countBy");
+		if (countBy !== void 0) lineNumbers.countBy = countBy;
+		const start = attrNum(lnNumType, "w:start");
+		if (start !== void 0) lineNumbers.start = start;
+		const restart = attr(lnNumType, "w:restart");
+		if (restart) lineNumbers.restart = restart;
+		const distance = attrNum(lnNumType, "w:distance");
+		if (distance !== void 0) lineNumbers.distance = distance;
+		if (Object.keys(lineNumbers).length > 0) opts.lineNumbers = lineNumbers;
+	}
+	const pgBorders = findChild(el, "w:pgBorders");
+	if (pgBorders) {
+		const borders = {};
+		for (const side of [
+			"top",
+			"left",
+			"bottom",
+			"right"
+		]) {
+			const sideEl = findChild(pgBorders, `w:${side}`);
+			if (sideEl) {
+				const b = {};
+				const val = attr(sideEl, "w:val");
+				if (val) b.style = val;
+				const color = attr(sideEl, "w:color");
+				if (color) b.color = color;
+				const sz = attrNum(sideEl, "w:sz");
+				if (sz !== void 0) b.size = sz;
+				const space = attrNum(sideEl, "w:space");
+				if (space !== void 0) b.space = space;
+				borders[side] = b;
+			}
+		}
+		const display = attr(pgBorders, "w:display");
+		if (display) borders.display = display;
+		const offsetFrom = attr(pgBorders, "w:offsetFrom");
+		if (offsetFrom) borders.offsetFrom = offsetFrom;
+		const zOrder = attr(pgBorders, "w:zOrder");
+		if (zOrder) borders.zOrder = zOrder;
+		if (Object.keys(borders).length > 0) {
+			const page = opts.page ?? {};
+			page.borders = borders;
+			opts.page = page;
+		}
+	}
+	const vAlign = findChild(el, "w:vAlign");
+	if (vAlign) {
+		const val = attr(vAlign, "w:val");
+		if (val) opts.verticalAlign = val;
+	}
+	const textDirection = findChild(el, "w:textDirection");
+	if (textDirection) {
+		const val = attr(textDirection, "w:val");
+		if (val) {
+			const page = opts.page ?? {};
+			page.textDirection = val;
+			opts.page = page;
+		}
+	}
+	const footnotePr = findChild(el, "w:footnotePr");
+	if (footnotePr) opts.footnotePr = parseNotePropertiesEl(footnotePr);
+	const endnotePr = findChild(el, "w:endnotePr");
+	if (endnotePr) opts.endnotePr = parseNotePropertiesEl(endnotePr);
+	const paperSrc = findChild(el, "w:paperSrc");
+	if (paperSrc) {
+		const ps = {};
+		const first = attrNum(paperSrc, "w:first");
+		if (first !== void 0) ps.first = first;
+		const other = attrNum(paperSrc, "w:other");
+		if (other !== void 0) ps.other = other;
+		if (Object.keys(ps).length > 0) opts.paperSrc = ps;
+	}
+	const printerSettings = findChild(el, "w:printerSettings");
+	if (printerSettings) {
+		const rId = attr(printerSettings, "r:id");
+		if (rId) opts.printerSettingsId = rId;
+	}
+	return opts;
+}
+function parseNotePropertiesEl(el) {
+	const opts = {};
+	const posEl = findChild(el, "w:pos");
+	if (posEl) {
+		const val = attr(posEl, "w:val");
+		if (val) opts.pos = val;
+	}
+	const numFmt = findChild(el, "w:numFmt");
+	if (numFmt) {
+		const fmt = attr(numFmt, "w:fmt");
+		if (fmt) opts.formatType = fmt;
+		const format = attr(numFmt, "w:format");
+		if (format) opts.format = format;
+	}
+	const numStart = findChild(el, "w:numStart");
+	if (numStart) {
+		const val = attrNum(numStart, "w:val");
+		if (val !== void 0) opts.numStart = val;
+	}
+	const numRestart = findChild(el, "w:numRestart");
+	if (numRestart) {
+		const val = attr(numRestart, "w:val");
+		if (val) opts.numRestart = val;
+	}
+	return opts;
+}
+//#endregion
+export { TextHorzOverflowType as $, stringifyParagraphProperties as A, HorizontalPositionAlign as B, createPageSize as C, stringifyJsonChild as D, tableDesc as E, parseDrawingRun as F, createWrapTight as G, SpaceType as H, createVerticalPosition as I, WidthType as J, TextWrappingSide as K, createHorizontalPosition as L, parseMathChildren as M, drawingDesc as N, stringifyParagraphInline as O, resetDrawingIdGen as P, TextBodyWrappingType as Q, HorizontalPositionRelativeFrom as R, PageOrientation as S, setTableParseChild as T, VerticalPositionAlign as U, NumberFormat as V, createWrapThrough as W, TextDirection as X, BorderStyle as Y, VerticalMergeType as Z, DocumentGridType as _, HeaderFooterType as a, Media as at, sectionPageSizeDefaults as b, createSectionType as c, createPageMargin as d, TextVertOverflowType as et, PageBorderDisplay as f, createPageNumberType as g, PageNumberSeparator as h, HeaderFooterReferenceType as i, WORKAROUND2 as it, stringifyRunProperties as j, stringifyRunInline as k, LineNumberRestartFormat as l, PageBorderZOrder as m, sectionPropertiesDesc as n, VerticalAnchor as nt, createHeaderFooterReference as o, createTransformation as ot, PageBorderOffsetFrom as p, TextWrappingType as q, stringifySectionPropertiesXml as r, createBodyProperties as rt, SectionType as s, parseSectionPropertiesEl as t, TextVerticalType as tt, createLineNumberType as u, createDocumentGrid as v, DocumentAttributeNamespaces as w, PageTextDirectionType as x, sectionMarginDefaults as y, VerticalPositionRelativeFrom as z };
+
+//# sourceMappingURL=document-CWr8C_OX.mjs.map