@office-open/docx 0.9.4 → 0.9.6

package/dist/{document-B_uvEH8b.mjs → document-D2OTVcbX.mjs}

@@ -1,5 +1,5 @@
 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, element, escapeXml, findChild, findDeep, textOf } from "@office-open/xml";
+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,207 +632,1489 @@ 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$1(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$1(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.
-*
-* Reference: http://officeopenxml.com/drwPicFloating-textWrap.php
+* 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.
 *
-* ## 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",
+/** 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$1(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$1(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"
 };
@@ -2081,681 +3363,304 @@ function stringifyMathInput(value) {
 		let pr = "";
 		if (opts.properties) {
 			const p = opts.properties;
-			const parts = [];
-			if (p.baseJc) parts.push(`<m:baseJc m:val="${p.baseJc}"/>`);
-			if (p.maxDist) parts.push("<m:maxDist m:val=\"1\"/>");
-			if (p.objDist) parts.push("<m:objDist m:val=\"1\"/>");
-			if (p.rSpRule) parts.push(`<m:rSpRule m:val="${p.rSpRule}"/>`);
-			if (p.rSp) parts.push(`<m:rSp m:val="${p.rSp}"/>`);
-			if (parts.length) pr = `<m:eqArrPr>${parts.join("")}</m:eqArrPr>`;
-		}
-		const rows = opts.rows.map((row) => `<m:e>${stringifyChildren(row)}</m:e>`).join("");
-		return `<m:eqArr>${pr}${rows}</m:eqArr>`;
-	}
-	if ("accent" in value) {
-		const opts = value.accent;
-		return `<m:acc>${opts.accentCharacter ? `<m:accPr><m:chr m:val="${opts.accentCharacter}"/></m:accPr>` : ""}<m:e>${stringifyChildren(opts.children)}</m:e></m:acc>`;
-	}
-	if ("bar" in value) {
-		const opts = value.bar;
-		return `<m:bar><m:barPr><m:pos m:val="${opts.type}"/></m:barPr><m:e>${stringifyChildren(opts.children)}</m:e></m:bar>`;
-	}
-	if ("text" in value) return `<m:r>${value.properties ? mathRunPropsStr(value.properties) : ""}<m:t>${escapeXml(value.text)}</m:t></m:r>`;
-	return "";
-}
-function stringifyNAry(opts, chr) {
-	const hasSub = opts.subScript && opts.subScript.length > 0;
-	const hasSup = opts.superScript && opts.superScript.length > 0;
-	const prParts = [`<m:chr m:val="${chr}"/>`];
-	if (!hasSub) prParts.push("<m:subHide m:val=\"1\"/>");
-	if (!hasSup) prParts.push("<m:supHide m:val=\"1\"/>");
-	return `<m:nary>${`<m:naryPr>${prParts.join("")}</m:naryPr>`}${hasSub ? `<m:sub>${stringifyChildren(opts.subScript)}</m:sub>` : "<m:sub/>"}${hasSup ? `<m:sup>${stringifyChildren(opts.superScript)}</m:sup>` : "<m:sup/>"}<m:e>${stringifyChildren(opts.children)}</m:e></m:nary>`;
-}
-function stringifyDelimiters(children, begChr, endChr) {
-	return `<m:d><m:dPr><m:begChr m:val="${begChr}"/><m:endChr m:val="${endChr}"/></m:dPr><m:e>${stringifyChildren(children)}</m:e></m:d>`;
-}
-function bracketChildren(v) {
-	if (Array.isArray(v)) return v;
-	return v.children;
-}
-function stringifyMath(children) {
-	return `<m:oMath>${children.map((c) => stringifyMathInput(c)).join("")}</m:oMath>`;
-}
-/**
-* Parse all math children from an m:oMath (or similar container) element.
-*/
-function parseMathChildren(el) {
-	const result = [];
-	for (const child of el.elements ?? []) {
-		const parsed = parseMathElement(child);
-		if (parsed !== void 0) result.push(parsed);
-	}
-	return result;
-}
-function parseMathElement(el) {
-	switch (el.name) {
-		case "m:r": return parseMathRun(el);
-		case "m:f": return parseMathFraction(el);
-		case "m:rad": return parseMathRadical(el);
-		case "m:sSup": return parseMathSuperScript(el);
-		case "m:sSub": return parseMathSubScript(el);
-		case "m:sSubSup": return parseMathSubSuperScript(el);
-		case "m:nary": return parseMathNAry(el);
-		case "m:func": return parseMathFunction(el);
-		case "m:d": return parseMathDelimiter(el);
-		case "m:m": return parseMathMatrix(el);
-		case "m:acc": return parseMathAccent(el);
-		case "m:bar": return parseMathBar(el);
-		case "m:borderBox": return { borderBox: { children: parseMathArg(el, "m:e") } };
-		case "m:box": return { box: { children: parseMathArg(el, "m:e") } };
-		case "m:groupChr": return { groupChr: { children: parseMathArg(el, "m:e") } };
-		case "m:phant": return { phant: { children: parseMathArg(el, "m:e") } };
-		case "m:eqArr": return parseMathEqArr(el);
-		case "m:limLow": return parseMathLimitLower(el);
-		case "m:limUpp": return parseMathLimitUpper(el);
-		case "m:rPr":
-		case "m:fPr":
-		case "m:radPr":
-		case "m:sSupPr":
-		case "m:sSubPr":
-		case "m:sSubSupPr":
-		case "m:naryPr":
-		case "m:funcPr":
-		case "m:dPr":
-		case "m:mPr":
-		case "m:accPr":
-		case "m:barPr":
-		case "m:borderBoxPr":
-		case "m:boxPr":
-		case "m:groupChrPr":
-		case "m:phantPr":
-		case "m:eqArrPr":
-		case "m:limLowPr":
-		case "m:limUppPr":
-		case "m:ctrlPr": return;
-		default: return;
+			const parts = [];
+			if (p.baseJc) parts.push(`<m:baseJc m:val="${p.baseJc}"/>`);
+			if (p.maxDist) parts.push("<m:maxDist m:val=\"1\"/>");
+			if (p.objDist) parts.push("<m:objDist m:val=\"1\"/>");
+			if (p.rSpRule) parts.push(`<m:rSpRule m:val="${p.rSpRule}"/>`);
+			if (p.rSp) parts.push(`<m:rSp m:val="${p.rSp}"/>`);
+			if (parts.length) pr = `<m:eqArrPr>${parts.join("")}</m:eqArrPr>`;
+		}
+		const rows = opts.rows.map((row) => `<m:e>${stringifyChildren(row)}</m:e>`).join("");
+		return `<m:eqArr>${pr}${rows}</m:eqArr>`;
 	}
-}
-function parseMathRun(el) {
-	return textOf(findChild(el, "m:t")) ?? "";
-}
-function parseMathFraction(el) {
-	return { fraction: {
-		numerator: parseMathArg(el, "m:num"),
-		denominator: parseMathArg(el, "m:den")
-	} };
-}
-function parseMathRadical(el) {
-	const degree = parseMathArg(el, "m:deg");
-	return { radical: {
-		children: parseMathArg(el, "m:e"),
-		...degree.length > 0 ? { degree } : {}
-	} };
-}
-function parseMathSuperScript(el) {
-	return { superScript: {
-		children: parseMathArg(el, "m:e"),
-		superScript: parseMathArg(el, "m:sup")
-	} };
-}
-function parseMathSubScript(el) {
-	return { subScript: {
-		children: parseMathArg(el, "m:e"),
-		subScript: parseMathArg(el, "m:sub")
-	} };
-}
-function parseMathSubSuperScript(el) {
-	return { subSuperScript: {
-		children: parseMathArg(el, "m:e"),
-		subScript: parseMathArg(el, "m:sub"),
-		superScript: parseMathArg(el, "m:sup")
-	} };
-}
-function parseMathNAry(el) {
-	const naryPr = findChild(el, "m:naryPr");
-	const chrEl = naryPr ? findChild(naryPr, "m:chr") : void 0;
-	const chrVal = chrEl ? attr(chrEl, "m:val") : void 0;
-	const baseChildren = parseMathArg(el, "m:e");
-	const sub = parseMathArg(el, "m:sub");
-	const sup = parseMathArg(el, "m:sup");
-	const common = {
-		children: baseChildren,
-		...sub.length > 0 ? { subScript: sub } : {},
-		...sup.length > 0 ? { superScript: sup } : {}
-	};
-	if (chrVal === "∑") return { sum: common };
-	return { integral: common };
-}
-function parseMathFunction(el) {
-	return { function: {
-		name: parseMathArg(el, "m:fName"),
-		children: parseMathArg(el, "m:e")
-	} };
-}
-function parseMathDelimiter(el) {
-	const dPr = findChild(el, "m:dPr");
-	const begChrEl = dPr ? findChild(dPr, "m:begChr") : void 0;
-	const begChr = begChrEl ? attr(begChrEl, "m:val") : "(";
-	const mathChildren = parseMathArg(el, "m:e");
-	switch (begChr) {
-		case "[": return { squareBrackets: mathChildren };
-		case "{": return { curlyBrackets: mathChildren };
-		case "<":
-		case "⟨": return { angledBrackets: mathChildren };
-		default: return { roundBrackets: mathChildren };
+	if ("accent" in value) {
+		const opts = value.accent;
+		return `<m:acc>${opts.accentCharacter ? `<m:accPr><m:chr m:val="${opts.accentCharacter}"/></m:accPr>` : ""}<m:e>${stringifyChildren(opts.children)}</m:e></m:acc>`;
 	}
+	if ("bar" in value) {
+		const opts = value.bar;
+		return `<m:bar><m:barPr><m:pos m:val="${opts.type}"/></m:barPr><m:e>${stringifyChildren(opts.children)}</m:e></m:bar>`;
+	}
+	if ("text" in value) return `<m:r>${value.properties ? mathRunPropsStr(value.properties) : ""}<m:t>${escapeXml(value.text)}</m:t></m:r>`;
+	return "";
 }
-function parseMathMatrix(el) {
-	const rows = [];
-	for (const mr of children(el, "m:mr")) rows.push(parseMathArg(mr, "m:e"));
-	return { matrix: { rows } };
-}
-function parseMathAccent(el) {
-	const accPr = findChild(el, "m:accPr");
-	const chrEl = accPr ? findChild(accPr, "m:chr") : void 0;
-	const accentChar = chrEl ? attr(chrEl, "m:val") : void 0;
-	return { accent: {
-		children: parseMathArg(el, "m:e"),
-		...accentChar ? { accentCharacter: accentChar } : {}
-	} };
-}
-function parseMathBar(el) {
-	const barPr = findChild(el, "m:barPr");
-	const posEl = barPr ? findChild(barPr, "m:pos") : void 0;
-	const pos = posEl ? attr(posEl, "m:val") : "top";
-	return { bar: {
-		children: parseMathArg(el, "m:e"),
-		type: pos ?? "top"
-	} };
-}
-function parseMathEqArr(el) {
-	const rows = [];
-	for (const e of children(el, "m:e")) rows.push(parseMathChildren(e));
-	return { eqArr: { rows } };
+function stringifyNAry(opts, chr) {
+	const hasSub = opts.subScript && opts.subScript.length > 0;
+	const hasSup = opts.superScript && opts.superScript.length > 0;
+	const prParts = [`<m:chr m:val="${chr}"/>`];
+	if (!hasSub) prParts.push("<m:subHide m:val=\"1\"/>");
+	if (!hasSup) prParts.push("<m:supHide m:val=\"1\"/>");
+	return `<m:nary>${`<m:naryPr>${prParts.join("")}</m:naryPr>`}${hasSub ? `<m:sub>${stringifyChildren(opts.subScript)}</m:sub>` : "<m:sub/>"}${hasSup ? `<m:sup>${stringifyChildren(opts.superScript)}</m:sup>` : "<m:sup/>"}<m:e>${stringifyChildren(opts.children)}</m:e></m:nary>`;
 }
-function parseMathLimitLower(el) {
-	return { limitLower: {
-		children: parseMathArg(el, "m:e"),
-		limit: parseMathArg(el, "m:lim")
-	} };
+function stringifyDelimiters(children, begChr, endChr) {
+	return `<m:d><m:dPr><m:begChr m:val="${begChr}"/><m:endChr m:val="${endChr}"/></m:dPr><m:e>${stringifyChildren(children)}</m:e></m:d>`;
 }
-function parseMathLimitUpper(el) {
-	return { limitUpper: {
-		children: parseMathArg(el, "m:e"),
-		limit: parseMathArg(el, "m:lim")
-	} };
+function bracketChildren(v) {
+	if (Array.isArray(v)) return v;
+	return v.children;
 }
-function parseMathArg(parent, childName) {
-	const container = findChild(parent, childName);
-	if (!container) return [];
-	return parseMathChildren(container);
+function stringifyMath(children) {
+	return `<m:oMath>${children.map((c) => stringifyMathInput(c)).join("")}</m:oMath>`;
 }
-//#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
+* Parse all math children from an m:oMath (or similar container) element.
 */
-/** On/off: `<w:name/>` for true, `<w:name w:val="0"/>` for false */
-function onOff(name, val) {
-	return val ? `<${name}/>` : `<${name} w:val="0"/>`;
+function parseMathChildren(el) {
+	const result = [];
+	for (const child of el.elements ?? []) {
+		const parsed = parseMathElement(child);
+		if (parsed !== void 0) result.push(parsed);
+	}
+	return result;
+}
+function parseMathElement(el) {
+	switch (el.name) {
+		case "m:r": return parseMathRun(el);
+		case "m:f": return parseMathFraction(el);
+		case "m:rad": return parseMathRadical(el);
+		case "m:sSup": return parseMathSuperScript(el);
+		case "m:sSub": return parseMathSubScript(el);
+		case "m:sSubSup": return parseMathSubSuperScript(el);
+		case "m:nary": return parseMathNAry(el);
+		case "m:func": return parseMathFunction(el);
+		case "m:d": return parseMathDelimiter(el);
+		case "m:m": return parseMathMatrix(el);
+		case "m:acc": return parseMathAccent(el);
+		case "m:bar": return parseMathBar(el);
+		case "m:borderBox": return { borderBox: { children: parseMathArg(el, "m:e") } };
+		case "m:box": return { box: { children: parseMathArg(el, "m:e") } };
+		case "m:groupChr": return { groupChr: { children: parseMathArg(el, "m:e") } };
+		case "m:phant": return { phant: { children: parseMathArg(el, "m:e") } };
+		case "m:eqArr": return parseMathEqArr(el);
+		case "m:limLow": return parseMathLimitLower(el);
+		case "m:limUpp": return parseMathLimitUpper(el);
+		case "m:rPr":
+		case "m:fPr":
+		case "m:radPr":
+		case "m:sSupPr":
+		case "m:sSubPr":
+		case "m:sSubSupPr":
+		case "m:naryPr":
+		case "m:funcPr":
+		case "m:dPr":
+		case "m:mPr":
+		case "m:accPr":
+		case "m:barPr":
+		case "m:borderBoxPr":
+		case "m:boxPr":
+		case "m:groupChrPr":
+		case "m:phantPr":
+		case "m:eqArrPr":
+		case "m:limLowPr":
+		case "m:limUppPr":
+		case "m:ctrlPr": return;
+		default: return;
+	}
 }
-/** 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 parseMathRun(el) {
+	return textOf(findChild(el, "m:t")) ?? "";
 }
-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 parseMathFraction(el) {
+	return { fraction: {
+		numerator: parseMathArg(el, "m:num"),
+		denominator: parseMathArg(el, "m:den")
+	} };
 }
-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 parseMathRadical(el) {
+	const degree = parseMathArg(el, "m:deg");
+	return { radical: {
+		children: parseMathArg(el, "m:e"),
+		...degree.length > 0 ? { degree } : {}
+	} };
 }
-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 parseMathSuperScript(el) {
+	return { superScript: {
+		children: parseMathArg(el, "m:e"),
+		superScript: parseMathArg(el, "m:sup")
+	} };
 }
-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 parseMathSubScript(el) {
+	return { subScript: {
+		children: parseMathArg(el, "m:e"),
+		subScript: parseMathArg(el, "m:sub")
+	} };
 }
-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 parseMathSubSuperScript(el) {
+	return { subSuperScript: {
+		children: parseMathArg(el, "m:e"),
+		subScript: parseMathArg(el, "m:sub"),
+		superScript: parseMathArg(el, "m:sup")
+	} };
 }
-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 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 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 parseMathFunction(el) {
+	return { function: {
+		name: parseMathArg(el, "m:fName"),
+		children: parseMathArg(el, "m:e")
+	} };
 }
-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 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 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 underlineStr(type, color) {
-	return `<w:u ${attrParts({
-		"w:val": type ?? "single",
-		"w:color": color !== void 0 ? hexColorValue(color) : void 0
-	})}/>`;
+function parseMathEqArr(el) {
+	const rows = [];
+	for (const e of children(el, "m:e")) rows.push(parseMathChildren(e));
+	return { eqArr: { rows } };
 }
-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 parseMathLimitLower(el) {
+	return { limitLower: {
+		children: parseMathArg(el, "m:e"),
+		limit: parseMathArg(el, "m:lim")
+	} };
 }
-function languageStr(opts) {
-	return `<w:lang ${attrParts({
-		"w:val": opts.value,
-		"w:eastAsia": opts.eastAsia,
-		"w:bidi": opts.bidirectional
-	})}/>`;
+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
 */
-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 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);
+};
 /**
-* 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
 /**
@@ -3115,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. */
@@ -3175,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.
@@ -3195,24 +4249,20 @@ function tableWidthStr(name, opts) {
 	})}/>`;
 }
 function cellMarginChildrenStr(opts) {
-	const unitType = opts.marginUnitType ?? WidthType.DXA;
 	const parts = [];
-	if (opts.top !== void 0) parts.push(tableWidthStr("w:top", {
-		size: opts.top,
-		type: unitType
-	}));
-	if (opts.left !== void 0) parts.push(tableWidthStr("w:left", {
-		size: opts.left,
-		type: unitType
-	}));
-	if (opts.bottom !== void 0) parts.push(tableWidthStr("w:bottom", {
-		size: opts.bottom,
-		type: unitType
-	}));
-	if (opts.right !== void 0) parts.push(tableWidthStr("w:right", {
-		size: opts.right,
-		type: unitType
-	}));
+	const side = (name, w) => {
+		if (w === void 0) return;
+		parts.push(tableWidthStr(name, {
+			size: w.size,
+			type: w.type ?? WidthType.DXA
+		}));
+	};
+	side("w:top", opts.top);
+	side("w:start", opts.start);
+	side("w:left", opts.left);
+	side("w:bottom", opts.bottom);
+	side("w:end", opts.end);
+	side("w:right", opts.right);
 	return parts.join("");
 }
 function cellMarginStr(tag, opts) {
@@ -3237,6 +4287,8 @@ function cellBordersStr(opts) {
 	if (opts.bottom) parts.push(borderStr("w:bottom", opts.bottom));
 	if (opts.end) parts.push(borderStr("w:end", opts.end));
 	if (opts.right) parts.push(borderStr("w:right", opts.right));
+	if (opts.insideHorizontal) parts.push(borderStr("w:insideH", opts.insideHorizontal));
+	if (opts.insideVertical) parts.push(borderStr("w:insideV", opts.insideVertical));
 	if (opts.topLeftToBottomRight) parts.push(borderStr("w:tl2br", opts.topLeftToBottomRight));
 	if (opts.topRightToBottomLeft) parts.push(borderStr("w:tr2bl", opts.topRightToBottomLeft));
 	return parts.length > 0 ? `<w:tcBorders>${parts.join("")}</w:tcBorders>` : void 0;
@@ -3265,6 +4317,23 @@ function tableLookStr(opts) {
 		"w:noVBand": opts.noVBand
 	})}/>`;
 }
+function cnfStyleStr(opts) {
+	return `<w:cnfStyle ${attrParts({
+		"w:val": opts.val,
+		"w:firstRow": opts.firstRow,
+		"w:lastRow": opts.lastRow,
+		"w:firstColumn": opts.firstColumn,
+		"w:lastColumn": opts.lastColumn,
+		"w:oddVBand": opts.oddVBand,
+		"w:evenVBand": opts.evenVBand,
+		"w:oddHBand": opts.oddHBand,
+		"w:evenHBand": opts.evenHBand,
+		"w:firstRowFirstColumn": opts.firstRowFirstColumn,
+		"w:firstRowLastColumn": opts.firstRowLastColumn,
+		"w:lastRowFirstColumn": opts.lastRowFirstColumn,
+		"w:lastRowLastColumn": opts.lastRowLastColumn
+	})}/>`;
+}
 function changeAttrStr(tag, opts) {
 	return `<${tag} ${attrParts({
 		"w:author": opts.author,
@@ -3285,7 +4354,7 @@ function cellMergeStr(opts) {
 function cellSpacingStr(opts) {
 	return `<w:tblCellSpacing ${attrParts({
 		"w:type": opts.type,
-		"w:w": measurementOrPercentValue(opts.value)
+		"w:w": measurementOrPercentValue(opts.size)
 	})}/>`;
 }
 function stringifyTablePropertiesChangeInner(options) {
@@ -3311,6 +4380,7 @@ function stringifyTablePropertiesInner(options) {
 	if (options.styleColBandSize !== void 0) parts.push(`<w:tblStyleColBandSize w:val="${options.styleColBandSize}"/>`);
 	if (options.width) parts.push(tableWidthStr("w:tblW", options.width));
 	if (options.alignment) parts.push(`<w:jc w:val="${options.alignment}"/>`);
+	if (options.cellSpacing) parts.push(cellSpacingStr(options.cellSpacing));
 	if (options.indent) parts.push(tableWidthStr("w:tblInd", options.indent));
 	if (options.borders) {
 		const bs = tableBordersStr(options.borders);
@@ -3323,7 +4393,6 @@ function stringifyTablePropertiesInner(options) {
 		if (cm) parts.push(cm);
 	}
 	if (options.tableLook) parts.push(tableLookStr(options.tableLook));
-	if (options.cellSpacing) parts.push(cellSpacingStr(options.cellSpacing));
 	if (options.caption !== void 0) parts.push(`<w:tblCaption w:val="${options.caption}"/>`);
 	if (options.description !== void 0) parts.push(`<w:tblDescription w:val="${options.description}"/>`);
 	if (options.revision) parts.push(stringifyTablePropertiesChangeInner(options.revision));
@@ -3346,13 +4415,7 @@ function stringifyTableRowPropertiesChangeInner(options) {
 }
 function stringifyTableRowPropertiesInner(options) {
 	const parts = [];
-	if (options.cnfStyle !== void 0) {
-		const a = attrParts({
-			"w:val": options.cnfStyle.val,
-			"w:changed": options.cnfStyle.changed
-		});
-		parts.push(`<w:cnfStyle ${a}/>`);
-	}
+	if (options.cnfStyle !== void 0) parts.push(cnfStyleStr(options.cnfStyle));
 	if (options.divId !== void 0) parts.push(`<w:divId w:val="${options.divId}"/>`);
 	if (options.gridBefore !== void 0) parts.push(`<w:gridBefore w:val="${options.gridBefore}"/>`);
 	if (options.gridAfter !== void 0) parts.push(`<w:gridAfter w:val="${options.gridAfter}"/>`);
@@ -3392,15 +4455,11 @@ function stringifyTableCellPropertiesChangeInner(options) {
 }
 function stringifyTableCellPropertiesInner(options) {
 	const parts = [];
-	if (options.cnfStyle !== void 0) {
-		const a = attrParts({
-			"w:val": options.cnfStyle.val,
-			"w:changed": options.cnfStyle.changed
-		});
-		parts.push(`<w:cnfStyle ${a}/>`);
-	}
+	if (options.cnfStyle !== void 0) parts.push(cnfStyleStr(options.cnfStyle));
 	if (options.width) parts.push(tableWidthStr("w:tcW", options.width));
 	if (options.columnSpan) parts.push(`<w:gridSpan w:val="${options.columnSpan}"/>`);
+	if (options.horizontalMerge !== void 0) if (options.horizontalMerge === "restart") parts.push(`<w:hMerge w:val="restart"/>`);
+	else parts.push(`<w:hMerge/>`);
 	if (options.verticalMerge) parts.push(`<w:vMerge w:val="${options.verticalMerge}"/>`);
 	else if (options.rowSpan && options.rowSpan > 1) parts.push(`<w:vMerge w:val="${VerticalMergeType.RESTART}"/>`);
 	if (options.borders) {
@@ -3408,16 +4467,14 @@ function stringifyTableCellPropertiesInner(options) {
 		if (bs) parts.push(bs);
 	}
 	if (options.shading) parts.push(shadingStr(options.shading));
+	if (options.noWrap !== void 0) parts.push(onOff("w:noWrap", options.noWrap));
 	if (options.margins) {
 		const cm = cellMarginStr("w:tcMar", options.margins);
 		if (cm) parts.push(cm);
 	}
 	if (options.textDirection) parts.push(`<w:textDirection w:val="${options.textDirection}"/>`);
-	if (options.verticalAlign) parts.push(`<w:vAlign w:val="${options.verticalAlign}"/>`);
-	if (options.horizontalMerge !== void 0) if (options.horizontalMerge === "restart") parts.push(`<w:hMerge w:val="restart"/>`);
-	else parts.push(`<w:hMerge/>`);
-	if (options.noWrap !== void 0) parts.push(onOff("w:noWrap", options.noWrap));
 	if (options.fitText !== void 0) parts.push(onOff("w:tcFitText", options.fitText));
+	if (options.verticalAlign) parts.push(`<w:vAlign w:val="${options.verticalAlign}"/>`);
 	if (options.hideMark !== void 0) parts.push(onOff("w:hideMark", options.hideMark));
 	if (options.headers !== void 0) {
 		const headerParts = options.headers.map((h) => `<w:header w:val="${h}"/>`).join("");
@@ -3425,15 +4482,15 @@ function stringifyTableCellPropertiesInner(options) {
 	}
 	if (options.insertion) parts.push(changeAttrStr("w:cellIns", options.insertion));
 	if (options.deletion) parts.push(changeAttrStr("w:cellDel", options.deletion));
-	if (options.revision) parts.push(stringifyTableCellPropertiesChangeInner(options.revision));
 	if (options.cellMerge) parts.push(cellMergeStr(options.cellMerge));
+	if (options.revision) parts.push(stringifyTableCellPropertiesChangeInner(options.revision));
 	return parts.join("");
 }
 function stringifyTableCellProperties(options) {
 	const inner = stringifyTableCellPropertiesInner(options);
 	if (options.includeIfEmpty || inner) return `<w:tcPr>${inner}</w:tcPr>`;
 }
-function stringifyTablePropertyExceptions(options) {
+function stringifyTablePropertyExceptionsInner(options) {
 	const parts = [];
 	if (options.width) parts.push(tableWidthStr("w:tblW", options.width));
 	if (options.alignment) parts.push(`<w:jc w:val="${options.alignment}"/>`);
@@ -3452,15 +4509,18 @@ function stringifyTablePropertyExceptions(options) {
 	if (options.tableLook) parts.push(tableLookStr(options.tableLook));
 	if (options.tblPrExChange) {
 		const change = options.tblPrExChange;
-		const attrs = {
+		const a = attrParts({
 			"w:author": change.author,
+			"w:date": change.date,
 			"w:id": change.id
-		};
-		if (change.date !== void 0) attrs["w:date"] = change.date;
-		const a = attrParts(attrs);
-		parts.push(`<w:tblPrExChange ${a}/>`);
+		});
+		const revInner = stringifyTablePropertyExceptionsInner(change);
+		parts.push(`<w:tblPrExChange ${a}><w:tblPrEx>${revInner}</w:tblPrEx></w:tblPrExChange>`);
 	}
-	return `<w:tblPrEx>${parts.join("")}</w:tblPrEx>`;
+	return parts.join("");
+}
+function stringifyTablePropertyExceptions(options) {
+	return `<w:tblPrEx>${stringifyTablePropertyExceptionsInner(options)}</w:tblPrEx>`;
 }
 //#endregion
 //#region src/parts/table/descriptor.ts
@@ -3526,7 +4586,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));
@@ -3540,10 +4608,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;
 	}
@@ -3555,9 +4633,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) {
@@ -3579,6 +4660,137 @@ function computeVerticalMergeCells(rows) {
 	}
 	return extraMap;
 }
+/** Parse a w:tblCellMar / w:tcMar container into TableCellMarginOptions. */
+function parseCellMargins(marginEl) {
+	const margins = {};
+	for (const side of [
+		"top",
+		"start",
+		"left",
+		"bottom",
+		"end",
+		"right"
+	]) {
+		const sideEl = findChild(marginEl, `w:${side}`);
+		if (sideEl) {
+			const size = attrNum(sideEl, "w:w");
+			if (size !== void 0) {
+				const type = attr(sideEl, "w:type");
+				margins[side] = type ? {
+					size,
+					type
+				} : { size };
+			}
+		}
+	}
+	if (Object.keys(margins).length === 0) return void 0;
+	return margins;
+}
+/** Parse a w:shd (CT_Shd) element into ShadingAttributesProperties. */
+function parseShading(shd) {
+	const shading = {};
+	const fill = attr(shd, "w:fill");
+	if (fill) shading.fill = fill;
+	const color = attr(shd, "w:color");
+	if (color) shading.color = color;
+	const val = attr(shd, "w:val");
+	if (val) shading.type = val;
+	const themeColor = attr(shd, "w:themeColor");
+	if (themeColor && THEME_COLORS.includes(themeColor)) shading.themeColor = themeColor;
+	const themeTint = attr(shd, "w:themeTint");
+	if (themeTint) shading.themeTint = themeTint;
+	const themeShade = attr(shd, "w:themeShade");
+	if (themeShade) shading.themeShade = themeShade;
+	const themeFill = attr(shd, "w:themeFill");
+	if (themeFill && THEME_COLORS.includes(themeFill)) shading.themeFill = themeFill;
+	const themeFillTint = attr(shd, "w:themeFillTint");
+	if (themeFillTint) shading.themeFillTint = themeFillTint;
+	const themeFillShade = attr(shd, "w:themeFillShade");
+	if (themeFillShade) shading.themeFillShade = themeFillShade;
+	if (Object.keys(shading).length === 0) return void 0;
+	return shading;
+}
+/** Parse a w:cnfStyle (CT_Cnf) element into CnfStyleOptions. */
+function parseCnfStyle(cnfEl) {
+	const cnf = {};
+	const val = attr(cnfEl, "w:val");
+	if (val) cnf.val = val;
+	const firstRow = attrBool(cnfEl, "w:firstRow");
+	if (firstRow !== void 0) cnf.firstRow = firstRow;
+	const lastRow = attrBool(cnfEl, "w:lastRow");
+	if (lastRow !== void 0) cnf.lastRow = lastRow;
+	const firstColumn = attrBool(cnfEl, "w:firstColumn");
+	if (firstColumn !== void 0) cnf.firstColumn = firstColumn;
+	const lastColumn = attrBool(cnfEl, "w:lastColumn");
+	if (lastColumn !== void 0) cnf.lastColumn = lastColumn;
+	const oddVBand = attrBool(cnfEl, "w:oddVBand");
+	if (oddVBand !== void 0) cnf.oddVBand = oddVBand;
+	const evenVBand = attrBool(cnfEl, "w:evenVBand");
+	if (evenVBand !== void 0) cnf.evenVBand = evenVBand;
+	const oddHBand = attrBool(cnfEl, "w:oddHBand");
+	if (oddHBand !== void 0) cnf.oddHBand = oddHBand;
+	const evenHBand = attrBool(cnfEl, "w:evenHBand");
+	if (evenHBand !== void 0) cnf.evenHBand = evenHBand;
+	const firstRowFirstColumn = attrBool(cnfEl, "w:firstRowFirstColumn");
+	if (firstRowFirstColumn !== void 0) cnf.firstRowFirstColumn = firstRowFirstColumn;
+	const firstRowLastColumn = attrBool(cnfEl, "w:firstRowLastColumn");
+	if (firstRowLastColumn !== void 0) cnf.firstRowLastColumn = firstRowLastColumn;
+	const lastRowFirstColumn = attrBool(cnfEl, "w:lastRowFirstColumn");
+	if (lastRowFirstColumn !== void 0) cnf.lastRowFirstColumn = lastRowFirstColumn;
+	const lastRowLastColumn = attrBool(cnfEl, "w:lastRowLastColumn");
+	if (lastRowLastColumn !== void 0) cnf.lastRowLastColumn = lastRowLastColumn;
+	if (Object.keys(cnf).length === 0) return void 0;
+	return cnf;
+}
+/**
+* Parse a w:tblPrEx (CT_TblPrEx) element into TablePropertyExOptions.
+* CT_TblPrExBase shares its child elements with CT_TblPrBase, so this reuses
+* parseTablePropertiesEl and maps the table-level margins field to cellMargin.
+*/
+function parseTablePropertyExceptions(el) {
+	const base = parseTablePropertiesEl(el);
+	const opts = {};
+	if (base.width !== void 0) opts.width = base.width;
+	if (base.indent !== void 0) opts.indent = base.indent;
+	if (base.layout !== void 0) opts.layout = base.layout;
+	if (base.borders !== void 0) opts.borders = base.borders;
+	if (base.shading !== void 0) opts.shading = base.shading;
+	if (base.alignment !== void 0) opts.alignment = base.alignment;
+	if (base.margins !== void 0) opts.cellMargin = base.margins;
+	if (base.tableLook !== void 0) opts.tableLook = base.tableLook;
+	if (base.cellSpacing !== void 0) opts.cellSpacing = base.cellSpacing;
+	const tblPrExChange = findChild(el, "w:tblPrExChange");
+	if (tblPrExChange) {
+		const change = parseTablePropertyExChange(tblPrExChange);
+		if (change) opts.tblPrExChange = change;
+	}
+	return opts;
+}
+/** Parse a w:tblPrExChange (CT_TblPrExChange) — track-change wrapper around the previous tblPrEx. */
+function parseTablePropertyExChange(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;
+	const innerTblPrEx = findChild(el, "w:tblPrEx");
+	if (innerTblPrEx) {
+		const inner = parseTablePropertyExceptions(innerTblPrEx);
+		if (inner.width !== void 0) change.width = inner.width;
+		if (inner.indent !== void 0) change.indent = inner.indent;
+		if (inner.layout !== void 0) change.layout = inner.layout;
+		if (inner.borders !== void 0) change.borders = inner.borders;
+		if (inner.shading !== void 0) change.shading = inner.shading;
+		if (inner.alignment !== void 0) change.alignment = inner.alignment;
+		if (inner.cellMargin !== void 0) change.cellMargin = inner.cellMargin;
+		if (inner.tableLook !== void 0) change.tableLook = inner.tableLook;
+		if (inner.cellSpacing !== void 0) change.cellSpacing = inner.cellSpacing;
+	}
+	if (change.id === void 0 || change.author === void 0) return void 0;
+	return change;
+}
 const tableDesc = {
 	kind: "custom",
 	stringify(opts, ctx) {
@@ -3594,6 +4806,7 @@ const tableDesc = {
 			indent: opts.indent,
 			layout: opts.layout,
 			revision: opts.revision,
+			shading: opts.shading,
 			style: opts.style,
 			styleColBandSize: opts.styleColBandSize,
 			styleRowBandSize: opts.styleRowBandSize,
@@ -3603,13 +4816,23 @@ const tableDesc = {
 			includeIfEmpty: true
 		};
 		parts.push(stringifyTableProperties(tblPrOpts));
-		const columnWidths = opts.columnWidths ?? Array(Math.max(...opts.rows.map((r) => r.cells.length))).fill(100);
+		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>`;
 	},
@@ -3689,35 +4912,13 @@ function parseTablePropertiesEl(el) {
 	}
 	const tblCellMar = findChild(el, "w:tblCellMar");
 	if (tblCellMar) {
-		const margins = {};
-		for (const side of [
-			"top",
-			"bottom",
-			"left",
-			"right"
-		]) {
-			const sideEl = findChild(tblCellMar, `w:${side}`);
-			if (sideEl) {
-				const size = attrNum(sideEl, "w:w");
-				const type = attr(sideEl, "w:type");
-				if (size !== void 0) margins[side] = {
-					size,
-					type: type ?? "dxa"
-				};
-			}
-		}
-		if (Object.keys(margins).length > 0) opts.margins = margins;
+		const margins = parseCellMargins(tblCellMar);
+		if (margins) opts.margins = margins;
 	}
 	const shd = findChild(el, "w:shd");
 	if (shd) {
-		const shading = {};
-		const fill = attr(shd, "w:fill");
-		if (fill) shading.fill = fill;
-		const color = attr(shd, "w:color");
-		if (color) shading.color = color;
-		const val = attr(shd, "w:val");
-		if (val) shading.type = val;
-		if (Object.keys(shading).length > 0) opts.shading = shading;
+		const shading = parseShading(shd);
+		if (shading) opts.shading = shading;
 	}
 	const tblDesc = findChild(el, "w:tblDescription");
 	if (tblDesc) {
@@ -3725,28 +4926,35 @@ function parseTablePropertiesEl(el) {
 		if (val) opts.description = val;
 	}
 	const tblpPr = findChild(el, "w:tblpPr");
-	if (tblpPr) {
+	const tblOverlap = findChild(el, "w:tblOverlap");
+	if (tblpPr || tblOverlap) {
 		const floatOpts = {};
-		const horzAnchor = attr(tblpPr, "w:horzAnchor");
-		if (horzAnchor) floatOpts.horizontalAnchor = horzAnchor;
-		const vertAnchor = attr(tblpPr, "w:vertAnchor");
-		if (vertAnchor) floatOpts.verticalAnchor = vertAnchor;
-		const tblpX = attrNum(tblpPr, "w:tblpX");
-		if (tblpX !== void 0) floatOpts.absoluteHorizontalPosition = tblpX;
-		const tblpXSpec = attr(tblpPr, "w:tblpXSpec");
-		if (tblpXSpec) floatOpts.relativeHorizontalPosition = tblpXSpec;
-		const tblpY = attrNum(tblpPr, "w:tblpY");
-		if (tblpY !== void 0) floatOpts.absoluteVerticalPosition = tblpY;
-		const tblpYSpec = attr(tblpPr, "w:tblpYSpec");
-		if (tblpYSpec) floatOpts.relativeVerticalPosition = tblpYSpec;
-		const bottomFromText = attrNum(tblpPr, "w:bottomFromText");
-		if (bottomFromText !== void 0) floatOpts.bottomFromText = bottomFromText;
-		const topFromText = attrNum(tblpPr, "w:topFromText");
-		if (topFromText !== void 0) floatOpts.topFromText = topFromText;
-		const leftFromText = attrNum(tblpPr, "w:leftFromText");
-		if (leftFromText !== void 0) floatOpts.leftFromText = leftFromText;
-		const rightFromText = attrNum(tblpPr, "w:rightFromText");
-		if (rightFromText !== void 0) floatOpts.rightFromText = rightFromText;
+		if (tblpPr) {
+			const horzAnchor = attr(tblpPr, "w:horzAnchor");
+			if (horzAnchor) floatOpts.horizontalAnchor = horzAnchor;
+			const vertAnchor = attr(tblpPr, "w:vertAnchor");
+			if (vertAnchor) floatOpts.verticalAnchor = vertAnchor;
+			const tblpX = attrNum(tblpPr, "w:tblpX");
+			if (tblpX !== void 0) floatOpts.absoluteHorizontalPosition = tblpX;
+			const tblpXSpec = attr(tblpPr, "w:tblpXSpec");
+			if (tblpXSpec) floatOpts.relativeHorizontalPosition = tblpXSpec;
+			const tblpY = attrNum(tblpPr, "w:tblpY");
+			if (tblpY !== void 0) floatOpts.absoluteVerticalPosition = tblpY;
+			const tblpYSpec = attr(tblpPr, "w:tblpYSpec");
+			if (tblpYSpec) floatOpts.relativeVerticalPosition = tblpYSpec;
+			const bottomFromText = attrNum(tblpPr, "w:bottomFromText");
+			if (bottomFromText !== void 0) floatOpts.bottomFromText = bottomFromText;
+			const topFromText = attrNum(tblpPr, "w:topFromText");
+			if (topFromText !== void 0) floatOpts.topFromText = topFromText;
+			const leftFromText = attrNum(tblpPr, "w:leftFromText");
+			if (leftFromText !== void 0) floatOpts.leftFromText = leftFromText;
+			const rightFromText = attrNum(tblpPr, "w:rightFromText");
+			if (rightFromText !== void 0) floatOpts.rightFromText = rightFromText;
+		}
+		if (tblOverlap) {
+			const overlap = attr(tblOverlap, "w:val");
+			if (overlap) floatOpts.overlap = overlap;
+		}
 		if (Object.keys(floatOpts).length > 0) opts.float = floatOpts;
 	}
 	const tblInd = findChild(el, "w:tblInd");
@@ -3780,7 +4988,7 @@ function parseTablePropertiesEl(el) {
 		const type = attr(tblCellSpacing, "w:type");
 		const w = attrNum(tblCellSpacing, "w:w");
 		if (w !== void 0) opts.cellSpacing = {
-			value: w,
+			size: w,
 			...type ? { type } : {}
 		};
 	}
@@ -3797,17 +5005,51 @@ function parseTablePropertiesEl(el) {
 		if (innerTblPr) Object.assign(rev, parseTablePropertiesEl(innerTblPr));
 		if (Object.keys(rev).length > 0) opts.revision = rev;
 	}
+	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 parseColumnWidthsEl(el) {
-	const cols = [];
+	const widths = [];
 	const tblGrid = findChild(el, "w:tblGrid");
-	if (!tblGrid) return cols;
+	if (!tblGrid) return { widths };
 	for (const col of children(tblGrid, "w:gridCol")) {
 		const w = attrNum(col, "w:w");
-		cols.push(w ?? 100);
+		widths.push(w ?? 100);
+	}
+	const tblGridChange = findChild(tblGrid, "w:tblGridChange");
+	if (tblGridChange) {
+		const id = attrNum(tblGridChange, "w:id");
+		const innerGrid = findChild(tblGridChange, "w:tblGrid");
+		const revWidths = [];
+		if (innerGrid) for (const col of children(innerGrid, "w:gridCol")) {
+			const w = attrNum(col, "w:w");
+			revWidths.push(w ?? 100);
+		}
+		if (id !== void 0) return {
+			widths,
+			revision: {
+				id,
+				columnWidths: revWidths
+			}
+		};
 	}
-	return cols;
+	return { widths };
 }
 function parseTableRowPropertiesEl(el) {
 	const opts = {};
@@ -3817,18 +5059,13 @@ function parseTableRowPropertiesEl(el) {
 		const rule = attr(trHeight, "w:hRule");
 		if (val !== void 0) opts.height = {
 			value: val,
-			rule: rule ?? "atLeast"
+			...rule ? { rule } : {}
 		};
 	}
 	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 cnf = parseCnfStyle(cnfStyle);
+		if (cnf) opts.cnfStyle = cnf;
 	}
 	const divId = findChild(el, "w:divId");
 	if (divId) {
@@ -3877,7 +5114,7 @@ function parseTableRowPropertiesEl(el) {
 		const type = attr(tblCellSpacing, "w:type");
 		const w = attrNum(tblCellSpacing, "w:w");
 		if (w !== void 0) opts.cellSpacing = {
-			value: w,
+			size: w,
 			...type ? { type } : {}
 		};
 	}
@@ -3902,34 +5139,22 @@ function parseTableRowPropertiesEl(el) {
 	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) {
 	const opts = {};
+	const cnfStyle = findChild(el, "w:cnfStyle");
+	if (cnfStyle) {
+		const cnf = parseCnfStyle(cnfStyle);
+		if (cnf) opts.cnfStyle = cnf;
+	}
 	const tcW = findChild(el, "w:tcW");
 	if (tcW) {
 		const size = attrNum(tcW, "w:w");
 		const type = attr(tcW, "w:type");
 		if (size !== void 0) opts.width = {
 			size,
-			type: type ?? "dxa"
+			...type ? { type } : {}
 		};
 	}
 	const gridSpan = findChild(el, "w:gridSpan");
@@ -3946,39 +5171,47 @@ function parseTableCellPropertiesEl(el) {
 	}
 	const shd = findChild(el, "w:shd");
 	if (shd) {
-		const shading = {};
-		const fill = attr(shd, "w:fill");
-		if (fill) shading.fill = fill;
-		const color = attr(shd, "w:color");
-		if (color) shading.color = color;
-		const val = attr(shd, "w:val");
-		if (val) shading.type = val;
-		if (Object.keys(shading).length > 0) opts.shading = shading;
+		const shading = parseShading(shd);
+		if (shading) opts.shading = shading;
 	}
 	const tcBorders = findChild(el, "w:tcBorders");
 	if (tcBorders) {
-		const borders = {};
-		for (const [xmlSide, key] of [
+		const SIDE_KEYS = [
 			["top", "top"],
 			["start", "start"],
 			["left", "left"],
 			["bottom", "bottom"],
 			["end", "end"],
 			["right", "right"],
+			["insideH", "insideHorizontal"],
+			["insideV", "insideVertical"],
 			["tl2br", "topLeftToBottomRight"],
 			["tr2bl", "topRightToBottomLeft"]
-		]) {
+		];
+		const borders = {};
+		for (const [xmlSide, key] of SIDE_KEYS) {
 			const sideEl = findChild(tcBorders, `w:${xmlSide}`);
-			if (sideEl) {
-				const b = {};
-				const val = attr(sideEl, "w:val");
-				if (val) b.style = val;
-				const color = attr(sideEl, "w:color");
-				if (color) b.color = color;
-				const sz = attrNum(sideEl, "w:sz");
-				if (sz !== void 0) b.size = sz;
-				borders[key] = b;
-			}
+			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;
 	}
@@ -3986,26 +5219,8 @@ function parseTableCellPropertiesEl(el) {
 	if (noWrap) opts.noWrap = attrBool(noWrap, "w:val") ?? true;
 	const tcMar = findChild(el, "w:tcMar");
 	if (tcMar) {
-		const margins = {};
-		let marginUnitType;
-		for (const side of [
-			"top",
-			"bottom",
-			"left",
-			"right"
-		]) {
-			const sideEl = findChild(tcMar, `w:${side}`);
-			if (sideEl) {
-				const size = attrNum(sideEl, "w:w");
-				const type = attr(sideEl, "w:type");
-				if (size !== void 0) {
-					margins[side] = size;
-					if (type && !marginUnitType) marginUnitType = type;
-				}
-			}
-		}
-		if (marginUnitType) margins.marginUnitType = marginUnitType;
-		if (Object.keys(margins).length > 0) opts.margins = margins;
+		const margins = parseCellMargins(tcMar);
+		if (margins) opts.margins = margins;
 	}
 	const textDirection = findChild(el, "w:textDirection");
 	if (textDirection) {
@@ -4076,6 +5291,11 @@ function parseTableRowEl(el, ctx) {
 	const opts = {};
 	const trPr = findChild(el, "w:trPr");
 	if (trPr) Object.assign(opts, parseTableRowPropertiesEl(trPr));
+	const tblPrEx = findChild(el, "w:tblPrEx");
+	if (tblPrEx) {
+		const exceptions = parseTablePropertyExceptions(tblPrEx);
+		if (Object.keys(exceptions).length > 0) opts.propertyExceptions = exceptions;
+	}
 	for (const [attrName, optKey] of [
 		["w:rsidRPr", "rsidRPr"],
 		["w:rsidR", "rsidR"],
@@ -4087,6 +5307,34 @@ function parseTableRowEl(el, ctx) {
 	}
 	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;
 }
@@ -4094,10 +5342,39 @@ function parseTableEl(el, ctx) {
 	const opts = {};
 	const tblPr = findChild(el, "w:tblPr");
 	if (tblPr) Object.assign(opts, parseTablePropertiesEl(tblPr));
-	const colWidths = parseColumnWidthsEl(el);
-	if (colWidths.length > 0) opts.columnWidths = colWidths;
+	const grid = parseColumnWidthsEl(el);
+	if (grid.widths.length > 0) opts.columnWidths = grid.widths;
+	if (grid.revision) opts.columnWidthsRevision = grid.revision;
 	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;
 }
@@ -5081,6 +6358,6 @@ function parseNotePropertiesEl(el) {
 	return opts;
 }
 //#endregion
-export { FormFieldTextType as $, stringifyParagraphProperties as A, VerticalPositionRelativeFrom as B, createPageSize as C, stringifyChildDispatch as D, tableDesc as E, resetDrawingIdGen as F, createWrapThrough as G, NumberFormat as H, parseDrawingRun as I, TextWrappingType as J, createWrapTight as K, createVerticalPosition as L, stringifyRunPropertiesInner as M, parseMathChildren as N, stringifyParagraphInline as O, drawingDesc as P, VerticalMergeType as Q, createHorizontalPosition as R, PageOrientation as S, setTableParseChild as T, SpaceType as U, HorizontalPositionAlign as V, VerticalPositionAlign as W, BorderStyle as X, WidthType as Y, TextDirection as Z, DocumentGridType as _, HeaderFooterType as a, TextVerticalType as at, sectionPageSizeDefaults as b, createSectionType as c, WORKAROUND2 as ct, createPageMargin as d, createFormFieldData as et, PageBorderDisplay as f, createPageNumberType as g, PageNumberSeparator as h, HeaderFooterReferenceType as i, TextVertOverflowType as it, stringifyRunProperties as j, stringifyRunInline as k, LineNumberRestartFormat as l, Media as lt, PageBorderZOrder as m, sectionPropertiesDesc as n, TextBodyWrappingType as nt, createHeaderFooterReference as o, VerticalAnchor as ot, PageBorderOffsetFrom as p, TextWrappingSide as q, stringifySectionPropertiesXml as r, TextHorzOverflowType as rt, SectionType as s, createBodyProperties as st, parseSectionPropertiesEl as t, parseFormFieldData as tt, createLineNumberType as u, createTransformation as ut, createDocumentGrid as v, DocumentAttributeNamespaces as w, PageTextDirectionType as x, sectionMarginDefaults as y, HorizontalPositionRelativeFrom 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-B_uvEH8b.mjs.map
+//# sourceMappingURL=document-D2OTVcbX.mjs.map