@office-open/docx 0.9.3 → 0.9.5

package/dist/{document-D8HDkCHs.mjs → document-DYH7tGnw.mjs}

@@ -1,5 +1,5 @@
-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 { TargetModeType, ThemeColor, 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, colorAttr, 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";
@@ -632,213 +632,1495 @@ const WidthType = {
 	PERCENTAGE: "pct"
 };
 //#endregion
-//#region src/parts/drawing/text-wrap/text-wrapping.ts
+//#region src/parts/paragraph/run/run-parse.ts
 /**
-* Enumeration of text wrapping types for floating drawings.
+* Run properties parser for DOCX documents.
 *
-* Reference: http://officeopenxml.com/drwPicFloating-textWrap.php
+* Parses w:rPr Element trees into RunPropertiesOptions objects.
 *
-* @publicApi
+* @module
 */
-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
+* Parse a w:rPr element into RunPropertiesOptions.
 */
-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
+function parseRunProperties(el) {
+	const opts = {};
+	const rStyle = findChild(el, "w:rStyle");
+	if (rStyle) opts.style = attr(rStyle, "w:val");
+	const font = findChild(el, "w:rFonts");
+	if (font) {
+		const ascii = attr(font, "w:ascii");
+		const eastAsia = attr(font, "w:eastAsia");
+		const hAnsi = attr(font, "w:hAnsi");
+		const cs = attr(font, "w:cs");
+		const hint = attr(font, "w:hint");
+		if (ascii && !eastAsia && !hAnsi && !cs) opts.font = hint ? {
+			name: ascii,
+			hint
+		} : ascii;
+		else {
+			const fontObj = {};
+			if (ascii) fontObj.ascii = ascii;
+			if (eastAsia) fontObj.eastAsia = eastAsia;
+			if (hAnsi) fontObj.hAnsi = hAnsi;
+			if (cs) fontObj.cs = cs;
+			if (hint) fontObj.hint = hint;
+			opts.font = fontObj;
+		}
+	}
+	const bold = findChild(el, "w:b");
+	if (bold) opts.bold = attrBool(bold, "w:val") ?? true;
+	const boldCs = findChild(el, "w:bCs");
+	if (boldCs) opts.boldComplexScript = attrBool(boldCs, "w:val") ?? true;
+	const italic = findChild(el, "w:i");
+	if (italic) opts.italic = attrBool(italic, "w:val") ?? true;
+	const italicCs = findChild(el, "w:iCs");
+	if (italicCs) opts.italicComplexScript = attrBool(italicCs, "w:val") ?? true;
+	const underline = findChild(el, "w:u");
+	if (underline) {
+		const ul = {};
+		const uType = attr(underline, "w:val");
+		if (uType) ul.type = uType;
+		const uColor = colorAttr(underline, "w:color");
+		if (uColor) ul.color = uColor;
+		opts.underline = ul;
+	}
+	for (const [name, optKey] of [
+		["w:strike", "strike"],
+		["w:dstrike", "doubleStrike"],
+		["w:outline", "outline"],
+		["w:shadow", "shadow"],
+		["w:emboss", "emboss"],
+		["w:imprint", "imprint"],
+		["w:vanish", "vanish"],
+		["w:webHidden", "webHidden"],
+		["w:noProof", "noProof"],
+		["w:snapToGrid", "snapToGrid"],
+		["w:smallCaps", "smallCaps"],
+		["w:caps", "allCaps"],
+		["w:rtl", "rightToLeft"],
+		["w:cs", "complexScript"],
+		["w:specVanish", "specVanish"],
+		["w:oMath", "math"]
+	]) {
+		const child = findChild(el, name);
+		if (child) opts[optKey] = attrBool(child, "w:val") ?? true;
+	}
+	const color = findChild(el, "w:color");
+	if (color) {
+		const c = colorAttr(color, "w:val");
+		const themeColor = attr(color, "w:themeColor");
+		const themeTint = attr(color, "w:themeTint");
+		const themeShade = attr(color, "w:themeShade");
+		if (themeColor || themeTint || themeShade) {
+			const colorObj = {};
+			if (c) colorObj.val = c;
+			if (themeColor) colorObj.themeColor = themeColor;
+			if (themeTint) colorObj.themeTint = themeTint;
+			if (themeShade) colorObj.themeShade = themeShade;
+			opts.color = colorObj;
+		} else if (c) opts.color = c;
+	}
+	const sz = findChild(el, "w:sz");
+	if (sz) {
+		const halfPts = attrNum(sz, "w:val");
+		if (halfPts !== void 0) opts.size = halfPts / 2;
+	}
+	const szCs = findChild(el, "w:szCs");
+	if (szCs) {
+		const halfPts = attrNum(szCs, "w:val");
+		if (halfPts !== void 0) opts.sizeComplexScript = halfPts / 2;
+	}
+	const highlight = findChild(el, "w:highlight");
+	if (highlight) {
+		const val = attr(highlight, "w:val");
+		if (val) opts.highlight = val;
+	}
+	const highlightCs = findChild(el, "w:highlightCs");
+	if (highlightCs) {
+		const val = attr(highlightCs, "w:val");
+		if (val) opts.highlightComplexScript = val;
+	}
+	const vertAlign = findChild(el, "w:vertAlign");
+	if (vertAlign) {
+		const val = attr(vertAlign, "w:val");
+		if (val === "subscript") opts.subScript = true;
+		else if (val === "superscript") opts.superScript = true;
+	}
+	const effect = findChild(el, "w:effect");
+	if (effect) {
+		const val = attr(effect, "w:val");
+		if (val) opts.effect = val;
+	}
+	const emphasisMark = findChild(el, "w:em");
+	if (emphasisMark) {
+		const val = attr(emphasisMark, "w:val");
+		if (val) opts.emphasisMark = { type: val };
+	}
+	const spacing = findChild(el, "w:spacing");
+	if (spacing) {
+		const val = attrNum(spacing, "w:val");
+		if (val !== void 0) opts.characterSpacing = val;
+	}
+	const scale = findChild(el, "w:w");
+	if (scale) {
+		const val = attrNum(scale, "w:val");
+		if (val !== void 0) opts.scale = val;
+	}
+	const kern = findChild(el, "w:kern");
+	if (kern) {
+		const val = attrNum(kern, "w:val");
+		if (val !== void 0) opts.kern = val;
+	}
+	const position = findChild(el, "w:position");
+	if (position) {
+		const val = attr(position, "w:val");
+		if (val !== void 0) opts.position = val;
+	}
+	const fitText = findChild(el, "w:fitText");
+	if (fitText) {
+		const val = attrNum(fitText, "w:val");
+		if (val !== void 0) opts.fitText = val;
+	}
+	const lang = findChild(el, "w:lang");
+	if (lang) {
+		const langObj = {};
+		const val = attr(lang, "w:val");
+		if (val) langObj.value = val;
+		const eastAsia = attr(lang, "w:eastAsia");
+		if (eastAsia) langObj.eastAsia = eastAsia;
+		const bidi = attr(lang, "w:bidi");
+		if (bidi) langObj.bidirectional = bidi;
+		if (Object.keys(langObj).length > 0) opts.language = langObj;
+	}
+	const bdr = findChild(el, "w:bdr");
+	if (bdr) opts.border = parseBorder(bdr);
+	const shd = findChild(el, "w:shd");
+	if (shd) opts.shading = parseShading(shd);
+	const eastAsianLayout = findChild(el, "w:eastAsianLayout");
+	if (eastAsianLayout) opts.eastAsianLayout = parseEastAsianLayout(eastAsianLayout);
+	const contentPart = findChild(el, "w:contentPart");
+	if (contentPart) {
+		const rId = attr(contentPart, "r:id");
+		if (rId) opts.contentPartRId = rId;
+	}
+	const rPrChange = findChild(el, "w:rPrChange");
+	if (rPrChange) {
+		const rev = {};
+		const author = attr(rPrChange, "w:author");
+		if (author) rev.author = author;
+		const date = attr(rPrChange, "w:date");
+		if (date) rev.date = date;
+		const id = attrNum(rPrChange, "w:id");
+		if (id !== void 0) rev.id = id;
+		const innerRPr = findChild(rPrChange, "w:rPr");
+		if (innerRPr) Object.assign(rev, parseRunProperties(innerRPr));
+		if (Object.keys(rev).length > 0) opts.revision = rev;
+	}
+	return opts;
+}
 /**
-* 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
+* Parse a w:bdr element into BorderOptions.
 */
+function parseBorder(el) {
+	const opts = {};
+	const style = attr(el, "w:val");
+	if (style) opts.style = style;
+	const color = colorAttr(el, "w:color");
+	if (color) opts.color = color;
+	const size = attrNum(el, "w:sz");
+	if (size !== void 0) opts.size = size;
+	const space = attrNum(el, "w:space");
+	if (space !== void 0) opts.space = space;
+	const shadow = attrBool(el, "w:shadow");
+	if (shadow !== void 0) opts.shadow = shadow;
+	const frame = attrBool(el, "w:frame");
+	if (frame !== void 0) opts.frame = frame;
+	return opts;
+}
 /**
-* 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>
-* ```
+* Parse a w:shd element into ShadingAttributesProperties.
 */
-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"/>`
-]);
+function parseShading(el) {
+	const opts = {};
+	const fill = colorAttr(el, "w:fill");
+	if (fill) opts.fill = fill;
+	const color = colorAttr(el, "w:color");
+	if (color) opts.color = color;
+	const type = attr(el, "w:val");
+	if (type) opts.type = type;
+	return opts;
+}
 /**
-* 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>
-* ```
+* Parse a w:eastAsianLayout element into EastAsianLayoutOptions.
 */
-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
+function parseEastAsianLayout(el) {
+	const opts = {};
+	const id = attrNum(el, "w:id");
+	if (id !== void 0) opts.id = id;
+	const combine = attrBool(el, "w:combine");
+	if (combine !== void 0) opts.combine = combine;
+	const combineBrackets = attr(el, "w:combineBrackets");
+	if (combineBrackets) opts.combineBrackets = combineBrackets;
+	const vert = attrBool(el, "w:vert");
+	if (vert !== void 0) opts.vert = vert;
+	const vertCompress = attrBool(el, "w:vertCompress");
+	if (vertCompress !== void 0) opts.vertCompress = vertCompress;
+	return opts;
+}
+/** Matches w:br[@w:type="page"] → PageBreak */
+const PARSED_PAGE_BREAK = Symbol("PageBreak");
+/** Matches w:br (line break) */
+const PARSED_LINE_BREAK = Symbol("LineBreak");
+/** Matches w:tab */
+const PARSED_TAB = Symbol("Tab");
+/** Matches w:cr */
+const PARSED_CR = Symbol("CarriageReturn");
+/** Matches w:noBreakHyphen */
+const PARSED_NO_BREAK_HYPHEN = Symbol("NoBreakHyphen");
+/** Matches w:softHyphen */
+const PARSED_SOFT_HYPHEN = Symbol("SoftHyphen");
+/** Matches w:footnoteRef — auto-generated by Footnote class */
+const PARSED_FOOTNOTE_REF = Symbol("FootnoteRef");
+/** Matches w:br[@w:type="column"] */
+const PARSED_COLUMN_BREAK = Symbol("ColumnBreak");
+/** Matches w:dayShort */
+const PARSED_DAY_SHORT = Symbol("DayShort");
+/** Matches w:monthShort */
+const PARSED_MONTH_SHORT = Symbol("MonthShort");
+/** Matches w:yearShort */
+const PARSED_YEAR_SHORT = Symbol("YearShort");
+/** Matches w:dayLong */
+const PARSED_DAY_LONG = Symbol("DayLong");
+/** Matches w:monthLong */
+const PARSED_MONTH_LONG = Symbol("MonthLong");
+/** Matches w:yearLong */
+const PARSED_YEAR_LONG = Symbol("YearLong");
+/** Matches w:annotationRef */
+const PARSED_ANNOTATION_REF = Symbol("AnnotationRef");
+/** Matches w:separator */
+const PARSED_SEPARATOR = Symbol("Separator");
+/** Matches w:continuationSeparator */
+const PARSED_CONTINUATION_SEPARATOR = Symbol("ContinuationSeparator");
+/** Matches w:pgNum */
+const PARSED_PG_NUM = Symbol("PgNum");
+/** Matches w:lastRenderedPageBreak */
+const PARSED_LAST_RENDERED_PAGE_BREAK = Symbol("LastRenderedPageBreak");
 /**
-* 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
+* Parse a w:r element into run data.
+* Returns { properties, children } where children are parsed run content items.
 */
+function parseRun(el, _ctx) {
+	const rPr = findChild(el, "w:rPr");
+	const properties = rPr ? parseRunProperties(rPr) : void 0;
+	const children = [];
+	for (const child of el.elements ?? []) switch (child.name) {
+		case "w:rPr": break;
+		case "w:t": {
+			const preserveSpace = attrBool(child, "xml:space");
+			let text = textOf(child);
+			if (preserveSpace && text) {}
+			children.push(text);
+			break;
+		}
+		case "w:delText": {
+			const text = textOf(child);
+			if (text) children.push(text);
+			break;
+		}
+		case "w:br": {
+			const brType = attr(child, "w:type");
+			if (brType === "page") children.push(PARSED_PAGE_BREAK);
+			else if (brType === "column") children.push(PARSED_COLUMN_BREAK);
+			else children.push(PARSED_LINE_BREAK);
+			break;
+		}
+		case "w:tab":
+			children.push(PARSED_TAB);
+			break;
+		case "w:cr":
+			children.push(PARSED_CR);
+			break;
+		case "w:noBreakHyphen":
+			children.push(PARSED_NO_BREAK_HYPHEN);
+			break;
+		case "w:softHyphen":
+			children.push(PARSED_SOFT_HYPHEN);
+			break;
+		case "w:commentReference": {
+			const id = attrNum(child, "w:id");
+			if (id !== void 0) children.push({ commentReference: id });
+			break;
+		}
+		case "w:drawing":
+		case "w:pict": break;
+		case "w:sym": {
+			const charVal = attr(child, "w:char");
+			const fontVal = attr(child, "w:font");
+			if (charVal) children.push({ symbolRun: {
+				char: charVal,
+				symbolfont: fontVal ?? "Wingdings"
+			} });
+			break;
+		}
+		case "w:footnoteReference": {
+			const id = attrNum(child, "w:id");
+			if (id !== void 0) children.push({ footnoteReference: id });
+			break;
+		}
+		case "w:endnoteReference": {
+			const id = attrNum(child, "w:id");
+			if (id !== void 0) children.push({ endnoteReference: id });
+			break;
+		}
+		case "w:footnoteRef":
+		case "w:endnoteRef":
+			children.push(PARSED_FOOTNOTE_REF);
+			break;
+		case "w:dayShort":
+			children.push(PARSED_DAY_SHORT);
+			break;
+		case "w:monthShort":
+			children.push(PARSED_MONTH_SHORT);
+			break;
+		case "w:yearShort":
+			children.push(PARSED_YEAR_SHORT);
+			break;
+		case "w:dayLong":
+			children.push(PARSED_DAY_LONG);
+			break;
+		case "w:monthLong":
+			children.push(PARSED_MONTH_LONG);
+			break;
+		case "w:yearLong":
+			children.push(PARSED_YEAR_LONG);
+			break;
+		case "w:annotationRef":
+			children.push(PARSED_ANNOTATION_REF);
+			break;
+		case "w:separator":
+			children.push(PARSED_SEPARATOR);
+			break;
+		case "w:continuationSeparator":
+			children.push(PARSED_CONTINUATION_SEPARATOR);
+			break;
+		case "w:pgNum":
+			children.push(PARSED_PG_NUM);
+			break;
+		case "w:lastRenderedPageBreak":
+			children.push(PARSED_LAST_RENDERED_PAGE_BREAK);
+			break;
+		default: break;
+	}
+	return {
+		properties,
+		children
+	};
+}
 /**
-* Creates a default rectangular wrap polygon matching the image extent.
+* Convert parsed run data into an RunOptions suitable for the Document constructor.
+* Simplifies the parsed children into text + break format.
+* If the run contains only a commentReference, returns { commentReference: id } instead.
+* If the run only contains footnoteRef/endnoteRef (auto-generated), returns empty options.
 *
-* 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>
-* ```
+* When empty run elements (tab, noBreakHyphen, date fields, etc.) are present,
+* uses children[] format to preserve them for round-trip fidelity.
 */
-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"/>`
+/** Mapping from parse symbols to RunOptions child objects for empty elements. */
+const SYMBOL_TO_CHILD = new Map([
+	[PARSED_TAB, { tab: true }],
+	[PARSED_CR, { carriageReturn: true }],
+	[PARSED_NO_BREAK_HYPHEN, { noBreakHyphen: true }],
+	[PARSED_SOFT_HYPHEN, { softHyphen: true }],
+	[PARSED_DAY_SHORT, { dayShort: true }],
+	[PARSED_MONTH_SHORT, { monthShort: true }],
+	[PARSED_YEAR_SHORT, { yearShort: true }],
+	[PARSED_DAY_LONG, { dayLong: true }],
+	[PARSED_MONTH_LONG, { monthLong: true }],
+	[PARSED_YEAR_LONG, { yearLong: true }],
+	[PARSED_ANNOTATION_REF, { annotationRef: true }],
+	[PARSED_SEPARATOR, { separator: true }],
+	[PARSED_CONTINUATION_SEPARATOR, { continuationSeparator: true }],
+	[PARSED_PG_NUM, { pgNum: true }],
+	[PARSED_LAST_RENDERED_PAGE_BREAK, { lastRenderedPageBreak: true }]
 ]);
-/**
-* 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)]);
+function parsedRunToOptions(parsed) {
+	const contentChildren = parsed.children.filter((c) => c !== PARSED_FOOTNOTE_REF);
+	if (contentChildren.length === 0 && parsed.children.some((c) => c === PARSED_FOOTNOTE_REF)) return null;
+	const opts = { ...parsed.properties };
+	const isRefChild = (c) => typeof c === "object" && c !== null && ("commentReference" in c || "footnoteReference" in c || "endnoteReference" in c);
+	const refChildren = contentChildren.filter(isRefChild);
+	const nonRefChildren = contentChildren.filter((c) => !isRefChild(c));
+	if (refChildren.length > 0 && nonRefChildren.length === 0) return refChildren[0];
+	const symbolIdx = nonRefChildren.findIndex((c) => typeof c === "object" && c !== null && "symbolRun" in c);
+	if (symbolIdx >= 0 && nonRefChildren.length === 1 && !parsed.properties) return nonRefChildren[symbolIdx];
+	const textParts = [];
+	let breakCount = 0;
+	let hasPageBreak = false;
+	let hasColumnBreak = false;
+	const extraChildren = [];
+	for (const child of nonRefChildren) if (typeof child === "string") textParts.push(child);
+	else if (child === PARSED_LINE_BREAK) breakCount++;
+	else if (child === PARSED_PAGE_BREAK) hasPageBreak = true;
+	else if (child === PARSED_COLUMN_BREAK) hasColumnBreak = true;
+	else {
+		const mapped = SYMBOL_TO_CHILD.get(child);
+		if (mapped) extraChildren.push(mapped);
+	}
+	if (extraChildren.length > 0) {
+		const children = [];
+		for (const child of nonRefChildren) if (typeof child === "string") children.push(child);
+		else if (child === PARSED_LINE_BREAK) children.push({ break: 1 });
+		else if (child === PARSED_PAGE_BREAK) children.push({ pageBreak: true });
+		else if (child === PARSED_COLUMN_BREAK) children.push({ columnBreak: true });
+		else {
+			const mapped = SYMBOL_TO_CHILD.get(child);
+			if (mapped) children.push(mapped);
+		}
+		opts.children = children;
+	} else {
+		if (textParts.length > 0) opts.text = textParts.join("");
+		if (breakCount > 0) opts.break = breakCount;
+		if (hasPageBreak) opts.pageBreak = true;
+		if (hasColumnBreak) opts.columnBreak = true;
+	}
+	if (Object.keys(opts).length === 0 && textParts.length === 0 && breakCount === 0 && !hasPageBreak && !hasColumnBreak && extraChildren.length === 0) return null;
+	return opts;
+}
 //#endregion
-//#region src/shared/constants.ts
+//#region src/parts/paragraph/stringify.ts
 /**
-* Shared constants for WordprocessingML documents.
+* Direct XML string builders for paragraph and run properties.
 *
-* Provides alignment, number format, and space type constants
-* used across multiple document components.
+* Replaces `buildParagraphProperties() + xml()` and `buildRunProperties() + xml()`
+* with direct string concatenation — zero intermediate IXmlableObject allocation,
+* zero recursive xml() traversal. Follows PPTX/XLSX pattern.
 *
 * @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.
-*
+/** 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/bodychildren.ts
+/**
+* Body-level child descriptors for DOCX.
+*
+* Provides descriptor-based stringification for section children.
+* All types use pure string builders — zero class instantiation, zero toXml().
+*
+* @module
+*/
+function escapeAttr(s) {
+	return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
+}
+const ALTCHUNK_REL_TYPE = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/aFChunk";
+function wrapHtmlDocument(fragment) {
+	if (/<(!DOCTYPE|html|HTML)/i.test(fragment)) return fragment;
+	return `<!DOCTYPE html>\n<html><head><meta charset="utf-8"></head>\n<body>${fragment}</body></html>`;
+}
+const altChunkDesc = {
+	kind: "custom",
+	stringify(opts, ctx) {
+		const relId = uniqueId();
+		const extension = opts.extension;
+		const partPath = `afchunks/afchunk${relId}.${extension}`;
+		const rawData = typeof opts.data === "string" ? new TextEncoder().encode(opts.data) : opts.data;
+		const data = opts.contentType === "text/html" && typeof opts.data === "string" ? new TextEncoder().encode(wrapHtmlDocument(opts.data)) : rawData;
+		ctx.fileData.document.relationships.addRelationship(relId, ALTCHUNK_REL_TYPE, partPath);
+		ctx.fileData.altChunks.addAltChunk(relId, {
+			key: relId,
+			data,
+			path: partPath,
+			extension,
+			contentType: opts.contentType
+		});
+		const rId = `rId${relId}`;
+		if (opts.matchSrc) return `<w:altChunk r:id="${rId}"><w:altChunkPr><w:matchSrc/></w:altChunkPr></w:altChunk>`;
+		return `<w:altChunk r:id="${rId}"/>`;
+	},
+	parse(el, ctx) {
+		const rId = attr(el, "r:id");
+		const opts = {};
+		const altChunkPr = findChild(el, "w:altChunkPr");
+		if (altChunkPr && findChild(altChunkPr, "w:matchSrc")) opts.matchSrc = true;
+		const dctx = ctx;
+		if (rId) {
+			const path = dctx.resolveRelationship(rId);
+			if (path) {
+				const data = dctx.getRaw(path);
+				if (data) {
+					opts.data = data;
+					switch (path.split(".").pop() ?? "txt") {
+						case "html":
+							opts.contentType = "text/html";
+							opts.extension = "html";
+							break;
+						case "rtf":
+							opts.contentType = "application/rtf";
+							opts.extension = "rtf";
+							break;
+						default:
+							opts.contentType = "text/plain";
+							opts.extension = "txt";
+							break;
+					}
+				}
+			}
+		}
+		return opts;
+	}
+};
+const SUBDOC_REL_TYPE = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/subDocument";
+const subDocDesc = {
+	kind: "custom",
+	stringify(opts, ctx) {
+		const relId = uniqueId();
+		const partPath = `subdocs/subdoc${relId}.docx`;
+		const data = typeof opts.data === "string" ? new TextEncoder().encode(opts.data) : opts.data;
+		ctx.fileData.document.relationships.addRelationship(relId, SUBDOC_REL_TYPE, partPath);
+		ctx.fileData.subDocs.addSubDoc(relId, {
+			data,
+			path: partPath
+		});
+		return `<w:subDoc r:id="rId${relId}"/>`;
+	},
+	parse(el, ctx) {
+		const rId = attr(el, "r:id");
+		const dctx = ctx;
+		if (rId) {
+			const path = dctx.resolveRelationship(rId);
+			if (path) {
+				const data = dctx.getRaw(path);
+				if (data) return { data };
+			}
+		}
+		return { data: new Uint8Array(0) };
+	}
+};
+function escapeXml$1(s) {
+	return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
+}
+function sdtListItemXml(item, forceValue) {
+	const attrs = [];
+	if (item.displayText !== void 0) attrs.push(`w:displayText="${escapeXml$1(item.displayText)}"`);
+	const value = item.value ?? (forceValue ? item.displayText : void 0);
+	if (value !== void 0) attrs.push(`w:value="${escapeXml$1(value)}"`);
+	return `<w:listItem ${attrs.join(" ")}/>`;
+}
+function sdtListTypeXml(name, options) {
+	const parts = [];
+	if (options.items) for (const item of options.items) parts.push(sdtListItemXml(item, name === "w:dropDownList"));
+	const attrs = [];
+	if (options.lastValue !== void 0) attrs.push(`w:lastValue="${escapeXml$1(options.lastValue)}"`);
+	const attrStr = attrs.length ? " " + attrs.join(" ") : "";
+	return parts.length ? `<${name}${attrStr}>${parts.join("")}</${name}>` : `<${name}${attrStr}/>`;
+}
+function sdtDateXml(options) {
+	const parts = [];
+	if (options.dateFormat !== void 0) parts.push(`<w:dateFormat w:val="${escapeXml$1(options.dateFormat)}"/>`);
+	if (options.languageId !== void 0) parts.push(`<w:lid w:val="${escapeXml$1(options.languageId)}"/>`);
+	if (options.storeMappedDataAs !== void 0) parts.push(`<w:storeMappedDataAs w:val="${options.storeMappedDataAs}"/>`);
+	if (options.calendar !== void 0) parts.push(`<w:calendar w:val="${options.calendar}"/>`);
+	const attrs = [];
+	if (options.fullDate !== void 0) attrs.push(`w:fullDate="${options.fullDate}"`);
+	const attrStr = attrs.length ? " " + attrs.join(" ") : "";
+	return parts.length ? `<w:date${attrStr}>${parts.join("")}</w:date>` : `<w:date${attrStr}/>`;
+}
+function sdtDataBindingXml(options) {
+	const attrs = [`w:xpath="${escapeXml$1(options.xpath)}"`, `w:storeItemID="${escapeXml$1(options.storeItemID)}"`];
+	if (options.prefixMappings !== void 0) attrs.push(`w:prefixMappings="${escapeXml$1(options.prefixMappings)}"`);
+	return `<w:dataBinding ${attrs.join(" ")}/>`;
+}
+function sdtDocPartXml(name, options) {
+	const parts = [];
+	if (options.gallery !== void 0) parts.push(`<w:docPartGallery w:val="${escapeXml$1(options.gallery)}"/>`);
+	if (options.category !== void 0) parts.push(`<w:docPartCategory w:val="${escapeXml$1(options.category)}"/>`);
+	if (options.unique !== void 0) parts.push(options.unique ? "<w:docPartUnique/>" : "<w:docPartUnique w:val=\"0\"/>");
+	return parts.length ? `<${name}>${parts.join("")}</${name}>` : `<${name}/>`;
+}
+function onOffAttr(name, val) {
+	return val ? `<${name}/>` : `<${name} w:val="0"/>`;
+}
+const W14_NS = "xmlns:w14=\"http://schemas.microsoft.com/office/word/2010/wordml\"";
+/** Default symbol font for checkbox content controls (CT_SdtCheckboxSymbol). */
+const CHECKBOX_FONT = "MS Gothic";
+const DEFAULT_CHECKED = {
+	val: "2612",
+	font: CHECKBOX_FONT
+};
+const DEFAULT_UNCHECKED = {
+	val: "2610",
+	font: CHECKBOX_FONT
+};
+/**
+* Build a w14:checkbox element (Word 2010+ content control checkbox).
+*
+* Lives in the w14 extension namespace; emitted with an inline xmlns:w14 so it
+* is valid wherever w:sdtPr appears. validate.ts tolerates the w14 namespace.
+*/
+function sdtCheckboxXml(opts) {
+	const checked = opts.checkedState ?? DEFAULT_CHECKED;
+	const unchecked = opts.uncheckedState ?? DEFAULT_UNCHECKED;
+	return `<w14:checkbox ${W14_NS}>${(opts.checked ? "<w14:checked/>" : "<w14:checked w14:val=\"0\"/>") + `<w14:checkedState w14:val="${escapeXml$1(checked.val)}" w14:font="${escapeXml$1(checked.font ?? CHECKBOX_FONT)}"/><w14:uncheckedState w14:val="${escapeXml$1(unchecked.val)}" w14:font="${escapeXml$1(unchecked.font ?? CHECKBOX_FONT)}"/>`}</w14:checkbox>`;
+}
+/** Build the run that renders a checkbox content control's current state symbol. */
+function checkboxSymbolRunInner(cb) {
+	const symbol = cb.checked ?? false ? cb.checkedState ?? DEFAULT_CHECKED : cb.uncheckedState ?? DEFAULT_UNCHECKED;
+	const font = escapeXml$1(symbol.font ?? CHECKBOX_FONT);
+	return `<w:r><w:rPr><w:rFonts w:ascii="${font}" w:hAnsi="${font}"/></w:rPr><w:t>${escapeXml$1(String.fromCodePoint(parseInt(symbol.val, 16)))}</w:t></w:r>`;
+}
+function stringifySdtPr(opts) {
+	const parts = [];
+	if (opts.alias !== void 0) parts.push(`<w:alias w:val="${escapeXml$1(opts.alias)}"/>`);
+	if (opts.tag !== void 0) parts.push(`<w:tag w:val="${escapeXml$1(opts.tag)}"/>`);
+	if (opts.id !== void 0) parts.push(`<w:id w:val="${opts.id}"/>`);
+	if (opts.lock !== void 0) parts.push(`<w:lock w:val="${opts.lock}"/>`);
+	if (opts.temporary !== void 0) parts.push(onOffAttr("w:temporary", opts.temporary));
+	const effectiveShowingPlcHdr = opts.showingPlaceholder ?? false;
+	if (opts.showingPlaceholder !== void 0 || effectiveShowingPlcHdr) parts.push(onOffAttr("w:showingPlcHdr", effectiveShowingPlcHdr));
+	if (opts.dataBinding) parts.push(sdtDataBindingXml(opts.dataBinding));
+	if (opts.label !== void 0) parts.push(`<w:label w:val="${opts.label}"/>`);
+	if (opts.tabIndex !== void 0) parts.push(`<w:tabIndex w:val="${opts.tabIndex}"/>`);
+	if (opts.equation) parts.push("<w:equation/>");
+	else if (opts.comboBox) parts.push(sdtListTypeXml("w:comboBox", opts.comboBox));
+	else if (opts.date) parts.push(sdtDateXml(opts.date));
+	else if (opts.docPartObj) parts.push(sdtDocPartXml("w:docPartObj", opts.docPartObj));
+	else if (opts.docPartList) parts.push(sdtDocPartXml("w:docPartList", opts.docPartList));
+	else if (opts.dropDownList) parts.push(sdtListTypeXml("w:dropDownList", opts.dropDownList));
+	else if (opts.picture) parts.push("<w:picture/>");
+	else if (opts.richText) parts.push("<w:richText/>");
+	else if (opts.text !== void 0) {
+		const multiLine = opts.text.multiLine ?? false;
+		parts.push(`<w:text w:multiLine="${multiLine}"/>`);
+	} else if (opts.citation) parts.push("<w:citation/>");
+	else if (opts.group) parts.push("<w:group/>");
+	else if (opts.bibliography) parts.push("<w:bibliography/>");
+	else if (opts.checkbox) parts.push(sdtCheckboxXml(opts.checkbox));
+	return parts.length ? `<w:sdtPr>${parts.join("")}</w:sdtPr>` : "<w:sdtPr/>";
+}
+/**
+* Build the <w:sdt> shell shared by all four SDT levels (block/run/cell/row).
+* The caller supplies the sdtContent body; sdtPr/sdtEndPr are handled uniformly.
+*/
+function stringifySdtShell(properties, endProperties, contentXml) {
+	const endPrInner = endProperties ? stringifyRunPropertiesInner(endProperties) : void 0;
+	const endPr = endPrInner ? `<w:sdtEndPr>${endPrInner}</w:sdtEndPr>` : "<w:sdtEndPr/>";
+	const content = contentXml ? `<w:sdtContent>${contentXml}</w:sdtContent>` : "<w:sdtContent/>";
+	return `<w:sdt>${stringifySdtPr(properties)}${endPr}${content}</w:sdt>`;
+}
+/** Parse w:sdtPr element into SdtPropertiesOptions. */
+function parseSdtPr(el) {
+	const opts = {};
+	const alias = findChild(el, "w:alias");
+	if (alias) opts.alias = attr(alias, "w:val");
+	const tag = findChild(el, "w:tag");
+	if (tag) {
+		const val = attr(tag, "w:val");
+		if (val) opts.tag = val;
+	}
+	const id = findChild(el, "w:id");
+	if (id) {
+		const val = attrNum(id, "w:val");
+		if (val !== void 0) opts.id = val;
+	}
+	const lock = findChild(el, "w:lock");
+	if (lock) {
+		const val = attr(lock, "w:val");
+		if (val) opts.lock = val;
+	}
+	const temporary = findChild(el, "w:temporary");
+	if (temporary) opts.temporary = attrBool(temporary, "w:val") ?? true;
+	const showingPlcHdr = findChild(el, "w:showingPlcHdr");
+	if (showingPlcHdr) opts.showingPlaceholder = attrBool(showingPlcHdr, "w:val") ?? true;
+	const label = findChild(el, "w:label");
+	if (label) {
+		const val = attrNum(label, "w:val");
+		if (val !== void 0) opts.label = val;
+	}
+	const tabIndex = findChild(el, "w:tabIndex");
+	if (tabIndex) {
+		const val = attrNum(tabIndex, "w:val");
+		if (val !== void 0) opts.tabIndex = val;
+	}
+	const dataBinding = findChild(el, "w:dataBinding");
+	if (dataBinding) opts.dataBinding = {
+		xpath: attr(dataBinding, "w:xpath") ?? "",
+		storeItemID: attr(dataBinding, "w:storeItemID") ?? "",
+		prefixMappings: attr(dataBinding, "w:prefixMappings")
+	};
+	if (findChild(el, "w:equation")) opts.equation = true;
+	else if (findChild(el, "w:comboBox")) {
+		const comboBox = findChild(el, "w:comboBox");
+		const items = [];
+		for (const li of children(comboBox, "w:listItem")) items.push({
+			displayText: attr(li, "w:displayText"),
+			value: attr(li, "w:value")
+		});
+		opts.comboBox = {
+			items: items.length > 0 ? items : void 0,
+			lastValue: attr(comboBox, "w:lastValue")
+		};
+	} else if (findChild(el, "w:date")) {
+		const date = findChild(el, "w:date");
+		const dateOpts = {};
+		const dateFormat = findChild(date, "w:dateFormat");
+		if (dateFormat) dateOpts.dateFormat = textOf(dateFormat);
+		const lid = findChild(date, "w:lid");
+		if (lid) dateOpts.languageId = textOf(lid);
+		const storeMapped = findChild(date, "w:storeMappedDataAs");
+		if (storeMapped) dateOpts.storeMappedDataAs = attr(storeMapped, "w:val");
+		const calendar = findChild(date, "w:calendar");
+		if (calendar) dateOpts.calendar = attr(calendar, "w:val");
+		const fullDate = attr(date, "w:fullDate");
+		if (fullDate) dateOpts.fullDate = fullDate;
+		opts.date = dateOpts;
+	} else if (findChild(el, "w:docPartObj")) {
+		const dp = findChild(el, "w:docPartObj");
+		const dpObj = {};
+		const gallery = findChild(dp, "w:docPartGallery");
+		if (gallery) dpObj.gallery = attr(gallery, "w:val");
+		const category = findChild(dp, "w:docPartCategory");
+		if (category) dpObj.category = attr(category, "w:val");
+		if (findChild(dp, "w:docPartUnique")) dpObj.unique = true;
+		opts.docPartObj = dpObj;
+	} else if (findChild(el, "w:docPartList")) {
+		const dp = findChild(el, "w:docPartList");
+		const dpObj = {};
+		const gallery = findChild(dp, "w:docPartGallery");
+		if (gallery) dpObj.gallery = attr(gallery, "w:val");
+		const category = findChild(dp, "w:docPartCategory");
+		if (category) dpObj.category = attr(category, "w:val");
+		if (findChild(dp, "w:docPartUnique")) dpObj.unique = true;
+		opts.docPartList = dpObj;
+	} else if (findChild(el, "w:dropDownList")) {
+		const ddl = findChild(el, "w:dropDownList");
+		const items = [];
+		for (const li of children(ddl, "w:listItem")) items.push({
+			displayText: attr(li, "w:displayText"),
+			value: attr(li, "w:value")
+		});
+		opts.dropDownList = {
+			items: items.length > 0 ? items : void 0,
+			lastValue: attr(ddl, "w:lastValue")
+		};
+	} else if (findChild(el, "w:picture")) opts.picture = true;
+	else if (findChild(el, "w:richText")) opts.richText = true;
+	else if (findChild(el, "w:text")) opts.text = { multiLine: attrBool(findChild(el, "w:text"), "w:multiLine") };
+	else if (findChild(el, "w:citation")) opts.citation = true;
+	else if (findChild(el, "w:group")) opts.group = true;
+	else if (findChild(el, "w:bibliography")) opts.bibliography = true;
+	else if (findChild(el, "w14:checkbox")) {
+		const cb = findChild(el, "w14:checkbox");
+		const cbObj = {};
+		const checked = findChild(cb, "w14:checked");
+		if (checked) cbObj.checked = attrBool(checked, "w14:val") ?? true;
+		const checkedState = findChild(cb, "w14:checkedState");
+		if (checkedState) cbObj.checkedState = {
+			val: attr(checkedState, "w14:val") ?? "",
+			font: attr(checkedState, "w14:font")
+		};
+		const uncheckedState = findChild(cb, "w14:uncheckedState");
+		if (uncheckedState) cbObj.uncheckedState = {
+			val: attr(uncheckedState, "w14:val") ?? "",
+			font: attr(uncheckedState, "w14:font")
+		};
+		opts.checkbox = cbObj;
+	}
+	return opts;
+}
+/** Parse w:customXmlPr element into CustomXmlPrOptions. */
+function parseCustomXmlPr(el) {
+	const opts = {};
+	const placeholder = findChild(el, "w:placeholder");
+	if (placeholder) {
+		const val = attr(placeholder, "w:val");
+		if (val) opts.placeholder = val;
+	}
+	const attributes = [];
+	for (const child of el.elements ?? []) {
+		if (child.name !== "w:attr") continue;
+		const name = attr(child, "w:name");
+		const val = attr(child, "w:val");
+		if (name && val) {
+			const attrOpts = {
+				name,
+				val
+			};
+			const uriVal = attr(child, "w:uri");
+			if (uriVal) attrOpts.uri = uriVal;
+			attributes.push(attrOpts);
+		}
+	}
+	if (attributes.length > 0) opts.attributes = attributes;
+	return opts;
+}
+/** Body child element parsing callback for SDT/customXml content. */
+let _parseBodyChild;
+/** Register the body child parser (called from parse/body.ts to break circular dependency). */
+function setBodyParseChild(parser) {
+	_parseBodyChild = parser;
+}
+function parseBodyChildren(elements, ctx) {
+	if (!_parseBodyChild) return [];
+	const result = [];
+	for (const el of elements) result.push(_parseBodyChild(el, ctx));
+	return result;
+}
+const sdtBlockDesc = {
+	kind: "custom",
+	stringify(opts, ctx) {
+		const parts = ["<w:sdt>"];
+		parts.push(stringifySdtPr(opts.properties));
+		const endPrInner = opts.endProperties ? stringifyRunPropertiesInner(opts.endProperties) : void 0;
+		parts.push(endPrInner ? `<w:sdtEndPr>${endPrInner}</w:sdtEndPr>` : "<w:sdtEndPr/>");
+		if (opts.properties.checkbox) parts.push(`<w:sdtContent><w:p>${checkboxSymbolRunInner(opts.properties.checkbox)}</w:p></w:sdtContent>`);
+		else if (opts.children && opts.children.length > 0) {
+			const contentParts = [];
+			for (const child of opts.children) contentParts.push(ctx.stringifyChild(child, ctx));
+			const contentBody = contentParts.join("");
+			parts.push(contentBody ? `<w:sdtContent>${contentBody}</w:sdtContent>` : "<w:sdtContent/>");
+		}
+		parts.push("</w:sdt>");
+		return parts.join("");
+	},
+	parse(el, ctx) {
+		const dctx = ctx;
+		const sdtPr = findChild(el, "w:sdtPr");
+		const properties = sdtPr ? parseSdtPr(sdtPr) : {};
+		let endProperties;
+		const sdtEndPr = findChild(el, "w:sdtEndPr");
+		if (sdtEndPr) endProperties = parseRunProperties(sdtEndPr);
+		const sdtContent = findChild(el, "w:sdtContent");
+		let childList;
+		if (sdtContent && sdtContent.elements?.length) {
+			childList = parseBodyChildren(sdtContent.elements, dctx);
+			if (childList.length === 0) childList = void 0;
+		}
+		return {
+			properties,
+			children: childList,
+			endProperties
+		};
+	}
+};
+function buildCustomXmlPrXml(pr) {
+	const parts = ["<w:customXmlPr>"];
+	if (pr.placeholder !== void 0) parts.push(`<w:placeholder w:val="${escapeAttr(pr.placeholder)}"/>`);
+	if (pr.attributes) for (const attr of pr.attributes) {
+		const attrParts = [`w:name="${escapeAttr(attr.name)}"`, `w:val="${escapeAttr(attr.val)}"`];
+		if (attr.uri !== void 0) attrParts.push(`w:uri="${escapeAttr(attr.uri)}"`);
+		parts.push(`<w:attr ${attrParts.join(" ")}/>`);
+	}
+	parts.push("</w:customXmlPr>");
+	return parts.join("");
+}
+/**
+* Serialize the common customXml shell (element/uri/customXmlPr) wrapping
+* arbitrary content. Shared by all four customXml levels (block/run/row/cell).
+*/
+function stringifyCustomXmlShell(opts, contentXml) {
+	const attrs = [`w:element="${escapeAttr(opts.element)}"`];
+	if (opts.uri !== void 0) attrs.push(`w:uri="${escapeAttr(opts.uri)}"`);
+	const prXml = opts.customXmlPr ? buildCustomXmlPrXml(opts.customXmlPr) : "";
+	return `<w:customXml ${attrs.join(" ")}>${prXml}${contentXml}</w:customXml>`;
+}
+const customXmlBlockDesc = {
+	kind: "custom",
+	stringify(opts, ctx) {
+		const contentParts = [];
+		if (opts.children) for (const child of opts.children) contentParts.push(ctx.stringifyChild(child, ctx));
+		return stringifyCustomXmlShell(opts, contentParts.join(""));
+	},
+	parse(el, ctx) {
+		const dctx = ctx;
+		const opts = {};
+		const element = attr(el, "w:element");
+		if (element) opts.element = element;
+		const uri = attr(el, "w:uri");
+		if (uri) opts.uri = uri;
+		const xmlPr = findChild(el, "w:customXmlPr");
+		if (xmlPr) opts.customXmlPr = parseCustomXmlPr(xmlPr);
+		const childList = [];
+		for (const child of el.elements ?? []) {
+			if (child.name === "w:customXmlPr") continue;
+			if (_parseBodyChild) childList.push(_parseBodyChild(child, dctx));
+		}
+		if (childList.length > 0) opts.children = childList;
+		return opts;
+	}
+};
+//#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
@@ -1259,40 +2541,76 @@ function parseImageRun(el, ctx) {
 	}
 	if (anchor && !inline) {
 		const floating = {};
+		const margins = {};
+		const distT = attrNum(anchor, "distT");
+		if (distT !== void 0) margins.top = distT;
+		const distB = attrNum(anchor, "distB");
+		if (distB !== void 0) margins.bottom = distB;
+		const distL = attrNum(anchor, "distL");
+		if (distL !== void 0) margins.left = distL;
+		const distR = attrNum(anchor, "distR");
+		if (distR !== void 0) margins.right = distR;
+		if (Object.keys(margins).length > 0) floating.margins = margins;
 		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 hp = readPosition(posH);
+			if (hp) floating.horizontalPosition = hp;
 		}
 		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;
+			const vp = readPosition(posV);
+			if (vp) floating.verticalPosition = vp;
 		}
-		if (attrBool(anchor, "behindDoc")) floating.behindDocument = true;
+		const wrap = readWrap(anchor);
+		if (wrap) floating.wrap = wrap;
+		const allowOverlap = attrBool(anchor, "allowOverlap");
+		if (allowOverlap !== void 0) floating.allowOverlap = allowOverlap;
+		const behindDoc = attrBool(anchor, "behindDoc");
+		if (behindDoc !== void 0) floating.behindDocument = behindDoc;
+		const locked = attrBool(anchor, "locked");
+		if (locked !== void 0) floating.lockAnchor = locked;
+		const layoutInCell = attrBool(anchor, "layoutInCell");
+		if (layoutInCell !== void 0) floating.layoutInCell = layoutInCell;
+		const relativeHeight = attrNum(anchor, "relativeHeight");
+		if (relativeHeight !== void 0) floating.zIndex = relativeHeight;
 		if (Object.keys(floating).length > 0) imageOpts.floating = floating;
 	}
 	return { image: imageOpts };
 }
+/** Map wp:positionH/V children + relativeFrom into a position-options object. */
+function readPosition(posEl) {
+	const relative = attr(posEl, "relativeFrom");
+	const alignEl = findChild(posEl, "wp:align");
+	const posOffset = findChild(posEl, "wp:posOffset");
+	const result = {};
+	if (relative) result.relative = relative;
+	if (alignEl) {
+		const a = textOf(alignEl);
+		if (a) result.align = a;
+	} else if (posOffset) {
+		const val = Number(textOf(posOffset));
+		if (!isNaN(val)) result.offset = val;
+	}
+	return Object.keys(result).length > 0 ? result : void 0;
+}
+/** Map the wp:anchor wrap child element into a TextWrapping ({ type, side? }). */
+function readWrap(anchor) {
+	const WRAP_TYPE = [
+		["wrapNone", TextWrappingType.NONE],
+		["wrapSquare", TextWrappingType.SQUARE],
+		["wrapTight", TextWrappingType.TIGHT],
+		["wrapTopAndBottom", TextWrappingType.TOP_AND_BOTTOM],
+		["wrapThrough", TextWrappingType.THROUGH]
+	];
+	for (const [name, type] of WRAP_TYPE) {
+		const el = findChild(anchor, `wp:${name}`);
+		if (!el) continue;
+		const wrap = { type };
+		const side = attr(el, "wrapText");
+		if (side) wrap.side = side;
+		return wrap;
+	}
+}
 function getDrawingExtent(el) {
 	const inline = findDeep(el, "wp:inline")[0];
 	const anchor = inline ? void 0 : findDeep(el, "wp:anchor")[0];
@@ -2149,577 +3467,200 @@ function parseMathFraction(el) {
 		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: {
+function parseMathRadical(el) {
+	const degree = parseMathArg(el, "m:deg");
+	return { radical: {
 		children: parseMathArg(el, "m:e"),
-		...accentChar ? { accentCharacter: accentChar } : {}
+		...degree.length > 0 ? { degree } : {}
 	} };
 }
-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: {
+function parseMathSuperScript(el) {
+	return { superScript: {
 		children: parseMathArg(el, "m:e"),
-		type: pos ?? "top"
+		superScript: parseMathArg(el, "m:sup")
 	} };
 }
-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: {
+function parseMathSubScript(el) {
+	return { subScript: {
 		children: parseMathArg(el, "m:e"),
-		limit: parseMathArg(el, "m:lim")
+		subScript: parseMathArg(el, "m:sub")
 	} };
 }
-function parseMathLimitUpper(el) {
-	return { limitUpper: {
+function parseMathSubSuperScript(el) {
+	return { subSuperScript: {
 		children: parseMathArg(el, "m:e"),
-		limit: parseMathArg(el, "m:lim")
+		subScript: parseMathArg(el, "m:sub"),
+		superScript: parseMathArg(el, "m:sup")
 	} };
 }
-function parseMathArg(parent, childName) {
-	const container = findChild(parent, childName);
-	if (!container) return [];
-	return parseMathChildren(container);
-}
-//#endregion
-//#region src/parts/paragraph/run/field.ts
-/**
-* Field module for WordprocessingML documents.
-*
-* This module provides support for complex fields, which are regions of text
-* that can contain dynamic content such as page numbers, dates, or mail merge fields.
-* Fields are delimited by field character elements (begin, separate, end).
-*
-* Reference: http://officeopenxml.com/WPrun.php
-*
-* @module
-*/
-/**
-* Field character types that delimit field regions.
-*
-* @internal
-*/
-const FieldCharacterType = {
-	BEGIN: "begin",
-	END: "end",
-	SEPARATE: "separate"
-};
-/**
-* Creates a field character element.
-*
-* ## XSD Schema
-* ```xml
-* <xsd:complexType name="CT_FldChar">
-*   <xsd:sequence>
-*     <xsd:element name="fldData" type="CT_Text" minOccurs="0"/>
-*     <xsd:element name="ffData" type="CT_FFData" minOccurs="0"/>
-*     <xsd:element name="numberingChange" type="CT_TrackChangeNumbering" minOccurs="0"/>
-*   </xsd:sequence>
-*   <xsd:attribute name="fldCharType" type="ST_FldCharType" use="required"/>
-*   <xsd:attribute name="fldLock" type="s:ST_OnOff"/>
-*   <xsd:attribute name="dirty" type="s:ST_OnOff"/>
-* </xsd:complexType>
-* ```
-* @internal
-*/
-const createFieldChar = (type, dirty, ffData, fldData, fieldLock) => {
-	const children = [];
-	if (fldData !== void 0) children.push(element("w:fldData", { "xml:space": "preserve" }, [fldData]));
-	if (ffData) children.push(ffData);
-	return element("w:fldChar", {
-		"w:dirty": dirty,
-		"w:fldLock": fieldLock,
-		"w:fldCharType": type
-	}, children.length > 0 ? children : void 0);
-};
-/**
-* Creates the beginning of a complex field.
-*
-* The Begin element marks the start of a field. A field consists of a begin character,
-* field instructions, an optional separate character, field result, and an end character.
-*
-* For form fields, pass `formField` to embed `w:ffData` within the begin `w:fldChar`.
-*
-* @param dirty - Whether the field should be recalculated
-* @param formField - Optional form field data to embed in the begin character
-*
-* @example
-* ```typescript
-* // Simple field begin
-* createBegin();
-*
-* // Form field (checkbox)
-* createBegin(false, {
-*   name: "Check1",
-*   checkBox: { checked: true, sizeAuto: true },
-* });
-* ```
-*/
-const createBegin = (dirty, formField, fieldLock) => createFieldChar(FieldCharacterType.BEGIN, dirty, formField ? createFormFieldData(formField) : void 0, void 0, fieldLock);
-/**
-* Creates the separator between field code and field result in a complex field.
-*
-* The Separate element divides the field code (instructions) from the field result
-* (the computed value).
-*/
-const createSeparate = (dirty) => createFieldChar(FieldCharacterType.SEPARATE, dirty);
-/**
-* Creates the end of a complex field.
-*
-* The End element marks the end of a field. Every field that begins with a Begin
-* element must be terminated with an End element.
-*/
-const createEnd = (dirty) => createFieldChar(FieldCharacterType.END, dirty);
-//#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 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 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}/>`);
+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 };
 	}
-	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 parseMathMatrix(el) {
+	const rows = [];
+	for (const mr of children(el, "m:mr")) rows.push(parseMathArg(mr, "m:e"));
+	return { matrix: { rows } };
 }
-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 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 underlineStr(type, color) {
-	return `<w:u ${attrParts({
-		"w:val": type ?? "single",
-		"w:color": color !== void 0 ? hexColorValue(color) : void 0
-	})}/>`;
+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 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 parseMathEqArr(el) {
+	const rows = [];
+	for (const e of children(el, "m:e")) rows.push(parseMathChildren(e));
+	return { eqArr: { rows } };
 }
-function languageStr(opts) {
-	return `<w:lang ${attrParts({
-		"w:val": opts.value,
-		"w:eastAsia": opts.eastAsia,
-		"w:bidi": opts.bidirectional
-	})}/>`;
+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/run/field.ts
 /**
-* Build `<w:pPr>` XML string directly from options — zero IXmlableObject allocation.
+* Field module for WordprocessingML documents.
 *
-* Replaces `buildParagraphProperties() + xml()` with a single-pass string builder.
+* This module provides support for complex fields, which are regions of text
+* that can contain dynamic content such as page numbers, dates, or mail merge fields.
+* Fields are delimited by field character elements (begin, separate, end).
+*
+* Reference: http://officeopenxml.com/WPrun.php
+*
+* @module
 */
-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.
+* Field character types that delimit field regions.
+*
+* @internal
+*/
+const FieldCharacterType = {
+	BEGIN: "begin",
+	END: "end",
+	SEPARATE: "separate"
+};
+/**
+* Creates a field character element.
+*
+* ## XSD Schema
+* ```xml
+* <xsd:complexType name="CT_FldChar">
+*   <xsd:sequence>
+*     <xsd:element name="fldData" type="CT_Text" minOccurs="0"/>
+*     <xsd:element name="ffData" type="CT_FFData" minOccurs="0"/>
+*     <xsd:element name="numberingChange" type="CT_TrackChangeNumbering" minOccurs="0"/>
+*   </xsd:sequence>
+*   <xsd:attribute name="fldCharType" type="ST_FldCharType" use="required"/>
+*   <xsd:attribute name="fldLock" type="s:ST_OnOff"/>
+*   <xsd:attribute name="dirty" type="s:ST_OnOff"/>
+* </xsd:complexType>
+* ```
+* @internal
 */
-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;
-}
+const createFieldChar = (type, dirty, ffData, fldData, fieldLock) => {
+	const children = [];
+	if (fldData !== void 0) children.push(element("w:fldData", { "xml:space": "preserve" }, [fldData]));
+	if (ffData) children.push(ffData);
+	return element("w:fldChar", {
+		"w:dirty": dirty,
+		"w:fldLock": fieldLock,
+		"w:fldCharType": type
+	}, children.length > 0 ? children : void 0);
+};
 /**
-* Build `<w:rPr>` XML string directly from options — zero IXmlableObject allocation.
+* Creates the beginning of a complex field.
 *
-* Replaces `buildRunProperties() + xml()` with a single-pass string builder.
+* The Begin element marks the start of a field. A field consists of a begin character,
+* field instructions, an optional separate character, field result, and an end character.
+*
+* For form fields, pass `formField` to embed `w:ffData` within the begin `w:fldChar`.
+*
+* @param dirty - Whether the field should be recalculated
+* @param formField - Optional form field data to embed in the begin character
+*
+* @example
+* ```typescript
+* // Simple field begin
+* createBegin();
+*
+* // Form field (checkbox)
+* createBegin(false, {
+*   name: "Check1",
+*   checkBox: { checked: true, sizeAuto: true },
+* });
+* ```
 */
-function stringifyRunProperties(opts) {
-	const inner = stringifyRunPropertiesInner(opts);
-	return inner ? `<w:rPr>${inner}</w:rPr>` : void 0;
-}
+const createBegin = (dirty, formField, fieldLock) => createFieldChar(FieldCharacterType.BEGIN, dirty, formField ? createFormFieldData(formField) : void 0, void 0, fieldLock);
+/**
+* Creates the separator between field code and field result in a complex field.
+*
+* The Separate element divides the field code (instructions) from the field result
+* (the computed value).
+*/
+const createSeparate = (dirty) => createFieldChar(FieldCharacterType.SEPARATE, dirty);
+/**
+* Creates the end of a complex field.
+*
+* The End element marks the end of a field. Every field that begins with a Begin
+* element must be terminated with an End element.
+*/
+const createEnd = (dirty) => createFieldChar(FieldCharacterType.END, dirty);
 //#endregion
 //#region src/parts/inline.ts
 /**
@@ -3032,6 +3973,11 @@ function stringifyChildDispatch(child, ctx) {
 		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 ("complexField" in child) {
+		const cf = child.complexField;
+		const resultXml = cf.result !== void 0 ? `<w:r><w:fldChar w:fldCharType="separate"/></w:r><w:r><w:t xml:space="preserve">${escapeXml(cf.result)}</w:t></w:r>` : "";
+		return `<w:r><w:fldChar w:fldCharType="begin"/></w:r><w:r><w:instrText xml:space="preserve">${escapeXml(cf.instruction)}</w:instrText></w:r>` + resultXml + "<w:r><w:fldChar w:fldCharType=\"end\"/></w:r>";
+	}
 	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>`;
@@ -3074,26 +4020,30 @@ function stringifyChildDispatch(child, ctx) {
 	}
 	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));
+		const contentParts = [];
+		if (cx.children) for (const c of cx.children) if (typeof c === "string") contentParts.push(stringifyRunInline({ text: c }, ctx));
 		else {
 			const jr = stringifyChildDispatch(c, ctx);
-			if (jr !== void 0) parts.push(Array.isArray(jr) ? jr.join("") : jr);
-			else parts.push(stringifyRunInline(c, ctx));
+			if (jr !== void 0) contentParts.push(Array.isArray(jr) ? jr.join("") : jr);
+			else contentParts.push(stringifyRunInline(c, ctx));
+		}
+		return stringifyCustomXmlShell(cx, contentParts.join(""));
+	}
+	if ("sdt" in child) {
+		const s = child.sdt;
+		let contentXml = "";
+		if (s.properties.checkbox) contentXml = checkboxSymbolRunInner(s.properties.checkbox);
+		else if (s.children && s.children.length > 0) {
+			const cparts = [];
+			for (const c of s.children) if (typeof c === "string") cparts.push(stringifyRunInline({ text: c }, ctx));
+			else {
+				const jr = stringifyChildDispatch(c, ctx);
+				if (jr !== void 0) cparts.push(Array.isArray(jr) ? jr.join("") : jr);
+				else if ("text" in c || "children" in c || "break" in c) cparts.push(stringifyRunInline(c, ctx));
+			}
+			contentXml = cparts.join("");
 		}
-		return `<w:customXml ${attrs.join(" ")}>${parts.join("")}</w:customXml>`;
+		return stringifySdtShell(s.properties, s.endProperties, contentXml);
 	}
 }
 /** Serialize children of Dir/Bdo containers. */
@@ -3134,6 +4084,151 @@ function stringifyParagraphInline(opts, ctx) {
 	return body ? `<w:p>${body}</w:p>` : "<w:p/>";
 }
 //#endregion
+//#region src/parts/sdt/sdt-parse.ts
+/**
+* Structured Document Tag parser for DOCX documents.
+*
+* Parses w:sdt elements into SdtPropertiesOptions + children.
+*
+* @module
+*/
+/**
+* Parse w:sdtPr element into SdtPropertiesOptions.
+*/
+function parseSdtProperties(el) {
+	const opts = {};
+	const alias = findChild(el, "w:alias");
+	if (alias) opts.alias = attr(alias, "w:val");
+	const tag = findChild(el, "w:tag");
+	if (tag) {
+		const val = attr(tag, "w:val");
+		if (val) opts.tag = val;
+	}
+	const id = findChild(el, "w:id");
+	if (id) {
+		const val = attrNum(id, "w:val");
+		if (val !== void 0) opts.id = val;
+	}
+	const lock = findChild(el, "w:lock");
+	if (lock) {
+		const val = attr(lock, "w:val");
+		if (val) opts.lock = val;
+	}
+	const temporary = findChild(el, "w:temporary");
+	if (temporary) opts.temporary = attrBool(temporary, "w:val") ?? true;
+	const showingPlcHdr = findChild(el, "w:showingPlcHdr");
+	if (showingPlcHdr) opts.showingPlaceholder = attrBool(showingPlcHdr, "w:val") ?? true;
+	const label = findChild(el, "w:label");
+	if (label) {
+		const val = attrNum(label, "w:val");
+		if (val !== void 0) opts.label = val;
+	}
+	const tabIndex = findChild(el, "w:tabIndex");
+	if (tabIndex) {
+		const val = attrNum(tabIndex, "w:val");
+		if (val !== void 0) opts.tabIndex = val;
+	}
+	const dataBinding = findChild(el, "w:dataBinding");
+	if (dataBinding) opts.dataBinding = {
+		xpath: attr(dataBinding, "w:xpath") ?? "",
+		storeItemID: attr(dataBinding, "w:storeItemID") ?? "",
+		prefixMappings: attr(dataBinding, "w:prefixMappings")
+	};
+	if (findChild(el, "w:equation")) opts.equation = true;
+	else if (findChild(el, "w:comboBox")) {
+		const comboBox = findChild(el, "w:comboBox");
+		const items = [];
+		for (const li of children(comboBox, "w:listItem")) items.push({
+			displayText: attr(li, "w:displayText"),
+			value: attr(li, "w:value")
+		});
+		opts.comboBox = {
+			items: items.length > 0 ? items : void 0,
+			lastValue: attr(comboBox, "w:lastValue")
+		};
+	} else if (findChild(el, "w:date")) {
+		const date = findChild(el, "w:date");
+		const dateOpts = {};
+		const dateFormat = findChild(date, "w:dateFormat");
+		if (dateFormat) dateOpts.dateFormat = textOf(dateFormat);
+		const lid = findChild(date, "w:lid");
+		if (lid) dateOpts.languageId = textOf(lid);
+		const storeMapped = findChild(date, "w:storeMappedDataAs");
+		if (storeMapped) dateOpts.storeMappedDataAs = attr(storeMapped, "w:val");
+		const calendar = findChild(date, "w:calendar");
+		if (calendar) dateOpts.calendar = attr(calendar, "w:val");
+		const fullDate = attr(date, "w:fullDate");
+		if (fullDate) dateOpts.fullDate = fullDate;
+		opts.date = dateOpts;
+	} else if (findChild(el, "w:dropDownList")) {
+		const ddl = findChild(el, "w:dropDownList");
+		const items = [];
+		for (const li of children(ddl, "w:listItem")) items.push({
+			displayText: attr(li, "w:displayText"),
+			value: attr(li, "w:value")
+		});
+		opts.dropDownList = {
+			items: items.length > 0 ? items : void 0,
+			lastValue: attr(ddl, "w:lastValue")
+		};
+	} else if (findChild(el, "w:picture")) opts.picture = true;
+	else if (findChild(el, "w:richText")) opts.richText = true;
+	else if (findChild(el, "w:text")) opts.text = { multiLine: attrBool(findChild(el, "w:text"), "w:multiLine") };
+	else if (findChild(el, "w:citation")) opts.citation = true;
+	else if (findChild(el, "w:group")) opts.group = true;
+	else if (findChild(el, "w:bibliography")) opts.bibliography = true;
+	else if (findChild(el, "w:docPartObj")) {
+		const dp = findChild(el, "w:docPartObj");
+		opts.docPartObj = {};
+		const gallery = findChild(dp, "w:docPartGallery");
+		if (gallery) opts.docPartObj.gallery = attr(gallery, "w:val");
+		const category = findChild(dp, "w:docPartCategory");
+		if (category) opts.docPartObj.category = attr(category, "w:val");
+	} else if (findChild(el, "w:docPartList")) {
+		const dp = findChild(el, "w:docPartList");
+		opts.docPartList = {};
+		const gallery = findChild(dp, "w:docPartGallery");
+		if (gallery) opts.docPartList.gallery = attr(gallery, "w:val");
+		const category = findChild(dp, "w:docPartCategory");
+		if (category) opts.docPartList.category = attr(category, "w:val");
+	} else if (findChild(el, "w14:checkbox")) {
+		const cb = findChild(el, "w14:checkbox");
+		const cbObj = {};
+		const checked = findChild(cb, "w14:checked");
+		if (checked) cbObj.checked = attrBool(checked, "w14:val") ?? true;
+		const checkedState = findChild(cb, "w14:checkedState");
+		if (checkedState) cbObj.checkedState = {
+			val: attr(checkedState, "w14:val") ?? "",
+			font: attr(checkedState, "w14:font")
+		};
+		const uncheckedState = findChild(cb, "w14:uncheckedState");
+		if (uncheckedState) cbObj.uncheckedState = {
+			val: attr(uncheckedState, "w14:val") ?? "",
+			font: attr(uncheckedState, "w14:font")
+		};
+		opts.checkbox = cbObj;
+	}
+	return opts;
+}
+/**
+* Parse a block-level w:sdt element.
+* Returns an object suitable for the { sdt: ... } SectionChild variant.
+*/
+function parseSdtBlock(el, ctx, parseChildren) {
+	const sdtPr = findChild(el, "w:sdtPr");
+	const properties = sdtPr ? parseSdtProperties(sdtPr) : {};
+	const sdtContent = findChild(el, "w:sdtContent");
+	let childList;
+	if (sdtContent) {
+		childList = parseChildren(sdtContent.elements ?? [], ctx);
+		if (childList.length === 0) childList = void 0;
+	}
+	return {
+		properties,
+		children: childList
+	};
+}
+//#endregion
 //#region src/parts/table/stringify.ts
 /**
 * Direct XML string builders for table properties.
@@ -3178,20 +4273,15 @@ 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>`;
+	if (opts.top) parts.push(borderStr("w:top", opts.top));
+	if (opts.left) parts.push(borderStr("w:left", opts.left));
+	if (opts.bottom) parts.push(borderStr("w:bottom", opts.bottom));
+	if (opts.right) parts.push(borderStr("w:right", opts.right));
+	if (opts.insideHorizontal) parts.push(borderStr("w:insideH", opts.insideHorizontal));
+	if (opts.insideVertical) parts.push(borderStr("w:insideV", opts.insideVertical));
+	return parts.length > 0 ? `<w:tblBorders>${parts.join("")}</w:tblBorders>` : void 0;
 }
 function cellBordersStr(opts) {
 	const parts = [];
@@ -3276,7 +4366,10 @@ function stringifyTablePropertiesInner(options) {
 	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.borders) {
+		const bs = tableBordersStr(options.borders);
+		if (bs) parts.push(bs);
+	}
 	if (options.shading) parts.push(shadingStr(options.shading));
 	if (options.layout) parts.push(`<w:tblLayout w:type="${options.layout}"/>`);
 	if (options.cellMargin) {
@@ -3400,7 +4493,10 @@ function stringifyTablePropertyExceptions(options) {
 	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.borders) {
+		const bs = tableBordersStr(options.borders);
+		if (bs) parts.push(bs);
+	}
 	if (options.shading) parts.push(shadingStr(options.shading));
 	if (options.layout) parts.push(`<w:tblLayout w:type="${options.layout}"/>`);
 	if (options.cellMargin) {
@@ -3422,6 +4518,27 @@ function stringifyTablePropertyExceptions(options) {
 }
 //#endregion
 //#region src/parts/table/descriptor.ts
+/**
+* Table (w:tbl) descriptor for DOCX.
+*
+* Stringifies pure JSON TableOptions into XML using direct string
+* concatenation — zero IXmlableObject, zero xml(), zero BaseXmlComponent.
+*
+* @module
+*/
+const BORDER_STYLES = Object.values(BorderStyle);
+const THEME_COLORS = Object.values(ThemeColor);
+/** Parse track-change attributes (id/author/date) from w:ins/w:del/w:cellIns/w:cellDel. */
+function parseChangeAttrs(el) {
+	const change = {};
+	const id = attrNum(el, "w:id");
+	if (id !== void 0) change.id = id;
+	const author = attr(el, "w:author");
+	if (author) change.author = author;
+	const date = attr(el, "w:date");
+	if (date) change.date = date;
+	return change;
+}
 function buildTableGridXml(widths, revision) {
 	const cols = widths.map((w) => `<w:gridCol w:w="${w}"/>`).join("");
 	if (revision) {
@@ -3463,7 +4580,15 @@ function stringifyTableRow(row, ctx, extraCells) {
 	const trPr = stringifyTableRowProperties(row);
 	if (trPr) parts.push(trPr);
 	const prefixCount = parts.length;
-	for (const cell of row.cells) parts.push(stringifyTableCell(cell, ctx));
+	for (const cell of row.cells) if ("sdt" in cell) {
+		const s = cell.sdt;
+		const contentXml = (s.cells ?? []).map((c) => stringifyTableCell(c, ctx)).join("");
+		parts.push(stringifySdtShell(s.properties, s.endProperties, contentXml));
+	} else if ("customXml" in cell) {
+		const cx = cell.customXml;
+		const contentXml = (cx.children ?? []).map((c) => stringifyTableCell(c, ctx)).join("");
+		parts.push(stringifyCustomXmlShell(cx, contentXml));
+	} else 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));
@@ -3477,10 +4602,20 @@ function stringifyTableRow(row, ctx, extraCells) {
 	const body = parts.join("");
 	return body ? `<w:tr${attr}>${body}</w:tr>` : attr ? `<w:tr${attr}/>` : "<w:tr/>";
 }
+/** Type guard: a plain row (not SDT/customXml-wrapped). */
+function isPlainRow(r) {
+	return !("sdt" in r) && !("customXml" in r);
+}
+/** Type guard: a plain cell (not SDT/customXml-wrapped). */
+function isPlainCell(c) {
+	return !("sdt" in c) && !("customXml" in c);
+}
 function findInsertIndex(cells, columnIndex, prefixCount) {
 	let colIdx = 0;
 	for (let i = 0; i < cells.length; i++) {
-		const { columnSpan } = getCellSpans(cells[i]);
+		const c = cells[i];
+		if (!isPlainCell(c)) continue;
+		const { columnSpan } = getCellSpans(c);
 		colIdx += columnSpan;
 		if (colIdx > columnIndex) return i + prefixCount;
 	}
@@ -3492,9 +4627,12 @@ function findInsertIndex(cells, columnIndex, prefixCount) {
 function computeVerticalMergeCells(rows) {
 	const extraMap = /* @__PURE__ */ new Map();
 	for (let ri = 0; ri < rows.length - 1; ri++) {
-		const cells = rows[ri].cells;
+		const row = rows[ri];
+		if (!isPlainRow(row)) continue;
+		const cells = row.cells;
 		let colIdx = 0;
 		for (const cell of cells) {
+			if (!isPlainCell(cell)) continue;
 			const typedCell = cell;
 			const { columnSpan, rowSpan } = getCellSpans(typedCell);
 			if (rowSpan > 1) {
@@ -3520,9 +4658,9 @@ const tableDesc = {
 	kind: "custom",
 	stringify(opts, ctx) {
 		const parts = [];
-		const tblPr = stringifyTableProperties({
+		const tblPrOpts = {
 			alignment: opts.alignment,
-			borders: opts.borders ?? {},
+			borders: opts.borders,
 			caption: opts.caption,
 			cellMargin: opts.margins,
 			cellSpacing: opts.cellSpacing,
@@ -3536,16 +4674,27 @@ const tableDesc = {
 			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);
+			width: opts.width,
+			includeIfEmpty: true
+		};
+		parts.push(stringifyTableProperties(tblPrOpts));
+		const columnWidths = opts.columnWidths ?? Array(Math.max(1, ...opts.rows.map((r) => isPlainRow(r) ? r.cells.length : 0))).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));
+			const r = opts.rows[ri];
+			if ("sdt" in r) {
+				const sdt = r.sdt;
+				const contentXml = (sdt.rows ?? []).map((rr) => stringifyTableRow(rr, ctx)).join("");
+				parts.push(stringifySdtShell(sdt.properties, sdt.endProperties, contentXml));
+			} else if ("customXml" in r) {
+				const cx = r.customXml;
+				const contentXml = (cx.children ?? []).map((rr) => stringifyTableRow(rr, ctx)).join("");
+				parts.push(stringifyCustomXmlShell(cx, contentXml));
+			} else {
+				const extras = extraCells.get(ri);
+				parts.push(stringifyTableRow(r, ctx, extras));
+			}
 		}
 		return `<w:tbl>${parts.join("")}</w:tbl>`;
 	},
@@ -3588,28 +4737,38 @@ function parseTablePropertiesEl(el) {
 	}
 	const tblBorders = findChild(el, "w:tblBorders");
 	if (tblBorders) {
+		const SIDE_KEYS = [
+			["top", "top"],
+			["left", "left"],
+			["bottom", "bottom"],
+			["right", "right"],
+			["insideH", "insideHorizontal"],
+			["insideV", "insideVertical"]
+		];
 		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;
-			}
+		for (const [xmlSide, key] of SIDE_KEYS) {
+			const sideEl = findChild(tblBorders, `w:${xmlSide}`);
+			if (!sideEl) continue;
+			const style = attr(sideEl, "w:val");
+			if (!style || !BORDER_STYLES.includes(style)) continue;
+			const sideOpts = { style };
+			const color = attr(sideEl, "w:color");
+			if (color) sideOpts.color = color;
+			const size = attrNum(sideEl, "w:sz");
+			if (size !== void 0) sideOpts.size = size;
+			const space = attrNum(sideEl, "w:space");
+			if (space !== void 0) sideOpts.space = space;
+			const themeColor = attr(sideEl, "w:themeColor");
+			if (themeColor && THEME_COLORS.includes(themeColor)) sideOpts.themeColor = themeColor;
+			const themeTint = attr(sideEl, "w:themeTint");
+			if (themeTint) sideOpts.themeTint = themeTint;
+			const themeShade = attr(sideEl, "w:themeShade");
+			if (themeShade) sideOpts.themeShade = themeShade;
+			const shadow = attrBool(sideEl, "w:shadow");
+			if (shadow !== void 0) sideOpts.shadow = shadow;
+			const frame = attrBool(sideEl, "w:frame");
+			if (frame !== void 0) sideOpts.frame = frame;
+			borders[key] = sideOpts;
 		}
 		if (Object.keys(borders).length > 0) opts.borders = borders;
 	}
@@ -3684,6 +4843,45 @@ function parseTablePropertiesEl(el) {
 			...type ? { type } : {}
 		};
 	}
+	const bidiVisual = findChild(el, "w:bidiVisual");
+	if (bidiVisual) opts.visuallyRightToLeft = attrBool(bidiVisual, "w:val") ?? true;
+	const tblStyleRowBandSize = findChild(el, "w:tblStyleRowBandSize");
+	if (tblStyleRowBandSize) {
+		const val = attrNum(tblStyleRowBandSize, "w:val");
+		if (val !== void 0) opts.styleRowBandSize = val;
+	}
+	const tblStyleColBandSize = findChild(el, "w:tblStyleColBandSize");
+	if (tblStyleColBandSize) {
+		const val = attrNum(tblStyleColBandSize, "w:val");
+		if (val !== void 0) opts.styleColBandSize = val;
+	}
+	const tblCaption = findChild(el, "w:tblCaption");
+	if (tblCaption) {
+		const val = attr(tblCaption, "w:val");
+		if (val) opts.caption = val;
+	}
+	const tblCellSpacing = findChild(el, "w:tblCellSpacing");
+	if (tblCellSpacing) {
+		const type = attr(tblCellSpacing, "w:type");
+		const w = attrNum(tblCellSpacing, "w:w");
+		if (w !== void 0) opts.cellSpacing = {
+			value: w,
+			...type ? { type } : {}
+		};
+	}
+	const tblPrChange = findChild(el, "w:tblPrChange");
+	if (tblPrChange) {
+		const rev = {};
+		const author = attr(tblPrChange, "w:author");
+		if (author) rev.author = author;
+		const date = attr(tblPrChange, "w:date");
+		if (date) rev.date = date;
+		const id = attrNum(tblPrChange, "w:id");
+		if (id !== void 0) rev.id = id;
+		const innerTblPr = findChild(tblPrChange, "w:tblPr");
+		if (innerTblPr) Object.assign(rev, parseTablePropertiesEl(innerTblPr));
+		if (Object.keys(rev).length > 0) opts.revision = rev;
+	}
 	return opts;
 }
 function parseColumnWidthsEl(el) {
@@ -3707,10 +4905,105 @@ function parseTableRowPropertiesEl(el) {
 			rule: rule ?? "atLeast"
 		};
 	}
+	const cnfStyle = findChild(el, "w:cnfStyle");
+	if (cnfStyle) {
+		const val = attr(cnfStyle, "w:val");
+		if (val) {
+			const cnf = { val };
+			const changed = attrBool(cnfStyle, "w:changed");
+			if (changed !== void 0) cnf.changed = changed;
+			opts.cnfStyle = cnf;
+		}
+	}
+	const divId = findChild(el, "w:divId");
+	if (divId) {
+		const val = attrNum(divId, "w:val");
+		if (val !== void 0) opts.divId = val;
+	}
+	const gridBefore = findChild(el, "w:gridBefore");
+	if (gridBefore) {
+		const val = attrNum(gridBefore, "w:val");
+		if (val !== void 0) opts.gridBefore = val;
+	}
+	const gridAfter = findChild(el, "w:gridAfter");
+	if (gridAfter) {
+		const val = attrNum(gridAfter, "w:val");
+		if (val !== void 0) opts.gridAfter = val;
+	}
+	const wBefore = findChild(el, "w:wBefore");
+	if (wBefore) {
+		const rawSize = attr(wBefore, "w:w");
+		const type = attr(wBefore, "w:type");
+		const size = type === "pct" ? rawSize : attrNum(wBefore, "w:w");
+		if (size !== void 0) opts.widthBefore = {
+			size,
+			...type ? { type } : {}
+		};
+	}
+	const wAfter = findChild(el, "w:wAfter");
+	if (wAfter) {
+		const rawSize = attr(wAfter, "w:w");
+		const type = attr(wAfter, "w:type");
+		const size = type === "pct" ? rawSize : attrNum(wAfter, "w:w");
+		if (size !== void 0) opts.widthAfter = {
+			size,
+			...type ? { type } : {}
+		};
+	}
+	const jc = findChild(el, "w:jc");
+	if (jc) {
+		const val = attr(jc, "w:val");
+		if (val) opts.rowAlignment = val;
+	}
+	const hidden = findChild(el, "w:hidden");
+	if (hidden) opts.hidden = attrBool(hidden, "w:val") ?? true;
+	const tblCellSpacing = findChild(el, "w:tblCellSpacing");
+	if (tblCellSpacing) {
+		const type = attr(tblCellSpacing, "w:type");
+		const w = attrNum(tblCellSpacing, "w:w");
+		if (w !== void 0) opts.cellSpacing = {
+			value: w,
+			...type ? { type } : {}
+		};
+	}
+	const ins = findChild(el, "w:ins");
+	if (ins) opts.insertion = parseChangeAttrs(ins);
+	const del = findChild(el, "w:del");
+	if (del) opts.deletion = parseChangeAttrs(del);
+	const trPrChange = findChild(el, "w:trPrChange");
+	if (trPrChange) {
+		const rev = {};
+		const author = attr(trPrChange, "w:author");
+		if (author) rev.author = author;
+		const date = attr(trPrChange, "w:date");
+		if (date) rev.date = date;
+		const id = attrNum(trPrChange, "w:id");
+		if (id !== void 0) rev.id = id;
+		const innerTrPr = findChild(trPrChange, "w:trPr");
+		if (innerTrPr) Object.assign(rev, parseTableRowPropertiesEl(innerTrPr));
+		if (Object.keys(rev).length > 0) opts.revision = rev;
+	}
 	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;
+	const tblLook = findChild(el, "w:tblLook");
+	if (tblLook) {
+		const look = {};
+		const firstRow = attrBool(tblLook, "w:firstRow");
+		if (firstRow !== void 0) look.firstRow = firstRow;
+		const lastRow = attrBool(tblLook, "w:lastRow");
+		if (lastRow !== void 0) look.lastRow = lastRow;
+		const firstColumn = attrBool(tblLook, "w:firstColumn");
+		if (firstColumn !== void 0) look.firstColumn = firstColumn;
+		const lastColumn = attrBool(tblLook, "w:lastColumn");
+		if (lastColumn !== void 0) look.lastColumn = lastColumn;
+		const noHBand = attrBool(tblLook, "w:noHBand");
+		if (noHBand !== void 0) look.noHBand = noHBand;
+		const noVBand = attrBool(tblLook, "w:noVBand");
+		if (noVBand !== void 0) look.noVBand = noVBand;
+		if (Object.keys(look).length > 0) opts.tableLook = look;
+	}
 	return opts;
 }
 function parseTableCellPropertiesEl(el) {
@@ -3750,13 +5043,17 @@ function parseTableCellPropertiesEl(el) {
 	const tcBorders = findChild(el, "w:tcBorders");
 	if (tcBorders) {
 		const borders = {};
-		for (const side of [
-			"top",
-			"bottom",
-			"left",
-			"right"
+		for (const [xmlSide, key] of [
+			["top", "top"],
+			["start", "start"],
+			["left", "left"],
+			["bottom", "bottom"],
+			["end", "end"],
+			["right", "right"],
+			["tl2br", "topLeftToBottomRight"],
+			["tr2bl", "topRightToBottomLeft"]
 		]) {
-			const sideEl = findChild(tcBorders, `w:${side}`);
+			const sideEl = findChild(tcBorders, `w:${xmlSide}`);
 			if (sideEl) {
 				const b = {};
 				const val = attr(sideEl, "w:val");
@@ -3765,12 +5062,13 @@ function parseTableCellPropertiesEl(el) {
 				if (color) b.color = color;
 				const sz = attrNum(sideEl, "w:sz");
 				if (sz !== void 0) b.size = sz;
-				borders[side] = b;
+				borders[key] = b;
 			}
 		}
 		if (Object.keys(borders).length > 0) opts.borders = borders;
 	}
-	if (findChild(el, "w:noWrap")) opts.noWrap = true;
+	const noWrap = findChild(el, "w:noWrap");
+	if (noWrap) opts.noWrap = attrBool(noWrap, "w:val") ?? true;
 	const tcMar = findChild(el, "w:tcMar");
 	if (tcMar) {
 		const margins = {};
@@ -3799,6 +5097,48 @@ function parseTableCellPropertiesEl(el) {
 		const val = attr(textDirection, "w:val");
 		if (val) opts.textDirection = val;
 	}
+	const hMerge = findChild(el, "w:hMerge");
+	if (hMerge) opts.horizontalMerge = attr(hMerge, "w:val") === "restart" ? "restart" : "continue";
+	const tcFitText = findChild(el, "w:tcFitText");
+	if (tcFitText) opts.fitText = attrBool(tcFitText, "w:val") ?? true;
+	const hideMark = findChild(el, "w:hideMark");
+	if (hideMark) opts.hideMark = attrBool(hideMark, "w:val") ?? true;
+	const headersEl = findChild(el, "w:headers");
+	if (headersEl) {
+		const headerVals = [];
+		for (const h of headersEl.elements ?? []) {
+			if (h.name !== "w:header") continue;
+			const val = attr(h, "w:val");
+			if (val) headerVals.push(val);
+		}
+		if (headerVals.length > 0) opts.headers = headerVals;
+	}
+	const cellIns = findChild(el, "w:cellIns");
+	if (cellIns) opts.insertion = parseChangeAttrs(cellIns);
+	const cellDel = findChild(el, "w:cellDel");
+	if (cellDel) opts.deletion = parseChangeAttrs(cellDel);
+	const tcPrChange = findChild(el, "w:tcPrChange");
+	if (tcPrChange) {
+		const rev = {};
+		const author = attr(tcPrChange, "w:author");
+		if (author) rev.author = author;
+		const date = attr(tcPrChange, "w:date");
+		if (date) rev.date = date;
+		const id = attrNum(tcPrChange, "w:id");
+		if (id !== void 0) rev.id = id;
+		const innerTcPr = findChild(tcPrChange, "w:tcPr");
+		if (innerTcPr) Object.assign(rev, parseTableCellPropertiesEl(innerTcPr));
+		if (Object.keys(rev).length > 0) opts.revision = rev;
+	}
+	const cellMerge = findChild(el, "w:cellMerge");
+	if (cellMerge) {
+		const cm = parseChangeAttrs(cellMerge);
+		const vMerge = attr(cellMerge, "w:vMerge");
+		if (vMerge) cm.verticalMerge = xsdVerticalMergeRev.from(vMerge);
+		const vMergeOrig = attr(cellMerge, "w:vMergeOrig");
+		if (vMergeOrig) cm.verticalMergeOriginal = xsdVerticalMergeRev.from(vMergeOrig);
+		if (Object.keys(cm).length > 0) opts.cellMerge = cm;
+	}
 	return opts;
 }
 function parseTableCellEl(el, ctx) {
@@ -3821,8 +5161,45 @@ function parseTableRowEl(el, ctx) {
 	const opts = {};
 	const trPr = findChild(el, "w:trPr");
 	if (trPr) Object.assign(opts, parseTableRowPropertiesEl(trPr));
+	for (const [attrName, optKey] of [
+		["w:rsidRPr", "rsidRPr"],
+		["w:rsidR", "rsidR"],
+		["w:rsidDel", "rsidDel"],
+		["w:rsidTr", "rsidTr"]
+	]) {
+		const val = attr(el, attrName);
+		if (val) opts[optKey] = val;
+	}
 	const childCells = [];
 	for (const child of el.elements ?? []) if (child.name === "w:tc") childCells.push(parseTableCellEl(child, ctx));
+	else if (child.name === "w:sdt") {
+		const sdtPr = findChild(child, "w:sdtPr");
+		const properties = sdtPr ? parseSdtProperties(sdtPr) : {};
+		const sdtEndPr = findChild(child, "w:sdtEndPr");
+		const endProperties = sdtEndPr ? parseRunProperties(sdtEndPr) : void 0;
+		const sdtContent = findChild(child, "w:sdtContent");
+		const sdtCells = [];
+		if (sdtContent) {
+			for (const sub of sdtContent.elements ?? []) if (sub.name === "w:tc") sdtCells.push(parseTableCellEl(sub, ctx));
+		}
+		const sdt = { properties };
+		if (sdtCells.length > 0) sdt.cells = sdtCells;
+		if (endProperties) sdt.endProperties = endProperties;
+		childCells.push({ sdt });
+	} else if (child.name === "w:customXml") {
+		const cx = { element: attr(child, "w:element") ?? "" };
+		const cxUri = attr(child, "w:uri");
+		if (cxUri) cx.uri = cxUri;
+		const xmlPr = findChild(child, "w:customXmlPr");
+		if (xmlPr) {
+			const parsed = parseCustomXmlPr(xmlPr);
+			if (parsed.placeholder !== void 0 || parsed.attributes !== void 0) cx.customXmlPr = parsed;
+		}
+		const cxCells = [];
+		for (const sub of child.elements ?? []) if (sub.name === "w:tc") cxCells.push(parseTableCellEl(sub, ctx));
+		if (cxCells.length > 0) cx.children = cxCells;
+		childCells.push({ customXml: cx });
+	}
 	opts.cells = childCells;
 	return opts;
 }
@@ -3834,6 +5211,34 @@ function parseTableEl(el, ctx) {
 	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));
+	else if (child.name === "w:sdt") {
+		const sdtPr = findChild(child, "w:sdtPr");
+		const properties = sdtPr ? parseSdtProperties(sdtPr) : {};
+		const sdtEndPr = findChild(child, "w:sdtEndPr");
+		const endProperties = sdtEndPr ? parseRunProperties(sdtEndPr) : void 0;
+		const sdtContent = findChild(child, "w:sdtContent");
+		const sdtRows = [];
+		if (sdtContent) {
+			for (const sub of sdtContent.elements ?? []) if (sub.name === "w:tr") sdtRows.push(parseTableRowEl(sub, ctx));
+		}
+		const sdt = { properties };
+		if (sdtRows.length > 0) sdt.rows = sdtRows;
+		if (endProperties) sdt.endProperties = endProperties;
+		rows.push({ sdt });
+	} else if (child.name === "w:customXml") {
+		const cx = { element: attr(child, "w:element") ?? "" };
+		const cxUri = attr(child, "w:uri");
+		if (cxUri) cx.uri = cxUri;
+		const xmlPr = findChild(child, "w:customXmlPr");
+		if (xmlPr) {
+			const parsed = parseCustomXmlPr(xmlPr);
+			if (parsed.placeholder !== void 0 || parsed.attributes !== void 0) cx.customXmlPr = parsed;
+		}
+		const cxRows = [];
+		for (const sub of child.elements ?? []) if (sub.name === "w:tr") cxRows.push(parseTableRowEl(sub, ctx));
+		if (cxRows.length > 0) cx.children = cxRows;
+		rows.push({ customXml: cx });
+	}
 	opts.rows = rows;
 	return opts;
 }
@@ -4402,6 +5807,10 @@ const createHeaderFooterReference = (type, options) => `<${type} r:id="rId${opti
 *
 * @module
 */
+/** Valid page-number @w:fmt values (ST_NumberFormat). */
+const PAGE_NUMBER_FORMATS = Object.values(NumberFormat);
+/** Valid page-number @w:chapSep values (ST_ChapterSep). */
+const PAGE_NUMBER_SEPARATORS = Object.values(PageNumberSeparator);
 function stringifyBorderXml(tag, opts) {
 	const attrs = [];
 	if (opts.style !== void 0) attrs.push(`w:val="${opts.style}"`);
@@ -4516,14 +5925,14 @@ 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 { size: { width = sectionPageSizeDefaults.WIDTH, height = sectionPageSizeDefaults.HEIGHT, orientation = sectionPageSizeDefaults.ORIENTATION, code } = {}, 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(pageSizeXml(pgW, pgH, orientation, code));
 	parts.push(pageMarginXml(top, right, bottom, left, header, footer, gutter));
 	if (borders) parts.push(pageBordersXml(borders));
 	if (opts.lineNumbers) parts.push(lineNumberXml(opts.lineNumbers));
@@ -4605,6 +6014,8 @@ function parseSectionPropertiesEl(el) {
 			if (h !== void 0) size.height = h;
 		}
 		if (orient) size.orientation = orient;
+		const code = attrNum(pgSz, "w:code");
+		if (code !== void 0) size.code = code;
 		if (Object.keys(size).length > 0) page.size = size;
 		const pgMar = findChild(el, "w:pgMar");
 		if (pgMar) {
@@ -4629,7 +6040,11 @@ function parseSectionPropertiesEl(el) {
 			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 (fmt && PAGE_NUMBER_FORMATS.includes(fmt)) pageNumbers.formatType = fmt;
+			const chapSep = attr(pgNumType, "w:chapSep");
+			if (chapSep && PAGE_NUMBER_SEPARATORS.includes(chapSep)) pageNumbers.separator = chapSep;
+			const chapStyle = attrNum(pgNumType, "w:chapStyle");
+			if (chapStyle !== void 0) pageNumbers.chapStyle = chapStyle;
 			if (Object.keys(pageNumbers).length > 0) page.pageNumbers = pageNumbers;
 		}
 		if (Object.keys(page).length > 0) opts.page = page;
@@ -4641,7 +6056,21 @@ function parseSectionPropertiesEl(el) {
 		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;
+		const separate = attrBool(cols, "w:sep");
+		if (separate !== void 0) column.separate = separate;
+		const equalWidth = attrBool(cols, "w:equalWidth");
+		if (equalWidth !== void 0) column.equalWidth = equalWidth;
+		const colChildren = [];
+		for (const colEl of cols.elements ?? []) {
+			if (colEl.name !== "w:col") continue;
+			const width = attrNum(colEl, "w:w");
+			if (width === void 0) continue;
+			const colAttr = { width };
+			const colSpace = attrNum(colEl, "w:space");
+			if (colSpace !== void 0) colAttr.space = colSpace;
+			colChildren.push(colAttr);
+		}
+		if (colChildren.length > 0) column.children = colChildren;
 		if (Object.keys(column).length > 0) opts.column = column;
 	}
 	const type = findChild(el, "w:type");
@@ -4793,6 +6222,6 @@ function parseNotePropertiesEl(el) {
 	return opts;
 }
 //#endregion
-export { createFormFieldData as $, stringifyParagraphProperties as A, HorizontalPositionAlign as B, createPageSize as C, stringifyChildDispatch 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, FormFieldTextType 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, VerticalAnchor as at, sectionPageSizeDefaults as b, createSectionType as c, Media as ct, createPageMargin as d, parseFormFieldData as et, PageBorderDisplay as f, createPageNumberType as g, PageNumberSeparator as h, HeaderFooterReferenceType as i, TextVerticalType as it, stringifyRunProperties as j, stringifyRunInline as k, LineNumberRestartFormat as l, createTransformation as lt, PageBorderZOrder as m, sectionPropertiesDesc as n, TextHorzOverflowType as nt, createHeaderFooterReference as o, createBodyProperties as ot, PageBorderOffsetFrom as p, TextWrappingType as q, stringifySectionPropertiesXml as r, TextVertOverflowType as rt, SectionType as s, WORKAROUND2 as st, parseSectionPropertiesEl as t, TextBodyWrappingType as tt, createLineNumberType as u, createDocumentGrid as v, DocumentAttributeNamespaces as w, PageTextDirectionType as x, sectionMarginDefaults as y, VerticalPositionRelativeFrom as z };
+export { setBodyParseChild as $, stringifyParagraphInline as A, HorizontalPositionAlign as B, createPageSize as C, Media as Ct, parseSdtBlock as D, tableDesc as E, parseDrawingRun as F, createWrapTight as G, SpaceType as H, createVerticalPosition as I, altChunkDesc as J, TextWrappingSide as K, createHorizontalPosition as L, parseMathChildren as M, drawingDesc as N, parseSdtProperties as O, resetDrawingIdGen as P, sdtBlockDesc as Q, HorizontalPositionRelativeFrom as R, PageOrientation as S, WORKAROUND2 as St, setTableParseChild as T, VerticalPositionAlign as U, NumberFormat as V, createWrapThrough as W, customXmlBlockDesc as X, checkboxSymbolRunInner as Y, parseCustomXmlPr as Z, DocumentGridType as _, TextHorzOverflowType as _t, HeaderFooterType as a, stringifyRunProperties as at, sectionPageSizeDefaults as b, VerticalAnchor as bt, createSectionType as c, parsedRunToOptions as ct, createPageMargin as d, TextDirection as dt, stringifyCustomXmlShell as et, PageBorderDisplay as f, VerticalMergeType as ft, createPageNumberType as g, TextBodyWrappingType as gt, PageNumberSeparator as h, parseFormFieldData as ht, HeaderFooterReferenceType as i, stringifyParagraphProperties as it, stringifyRunInline as j, stringifyChildDispatch as k, LineNumberRestartFormat as l, WidthType as lt, PageBorderZOrder as m, createFormFieldData as mt, sectionPropertiesDesc as n, stringifySdtShell as nt, createHeaderFooterReference as o, parseRun as ot, PageBorderOffsetFrom as p, FormFieldTextType as pt, TextWrappingType as q, stringifySectionPropertiesXml as r, subDocDesc as rt, SectionType as s, parseRunProperties as st, parseSectionPropertiesEl as t, stringifySdtPr as tt, createLineNumberType as u, BorderStyle as ut, createDocumentGrid as v, TextVertOverflowType as vt, DocumentAttributeNamespaces as w, createTransformation as wt, PageTextDirectionType as x, createBodyProperties as xt, sectionMarginDefaults as y, TextVerticalType as yt, VerticalPositionRelativeFrom as z };
 
-//# sourceMappingURL=document-D8HDkCHs.mjs.map
+//# sourceMappingURL=document-DYH7tGnw.mjs.map