@office-open/docx 0.9.4 → 0.9.5

package/dist/{document-B_uvEH8b.mjs → document-DYH7tGnw.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,6 +632,1288 @@ const WidthType = {
 	PERCENTAGE: "pct"
 };
 //#endregion
+//#region src/parts/paragraph/run/run-parse.ts
+/**
+* Run properties parser for DOCX documents.
+*
+* Parses w:rPr Element trees into RunPropertiesOptions objects.
+*
+* @module
+*/
+/**
+* Parse a w:rPr element into RunPropertiesOptions.
+*/
+function parseRunProperties(el) {
+	const opts = {};
+	const rStyle = findChild(el, "w:rStyle");
+	if (rStyle) opts.style = attr(rStyle, "w:val");
+	const font = findChild(el, "w:rFonts");
+	if (font) {
+		const ascii = attr(font, "w:ascii");
+		const eastAsia = attr(font, "w:eastAsia");
+		const hAnsi = attr(font, "w:hAnsi");
+		const cs = attr(font, "w:cs");
+		const hint = attr(font, "w:hint");
+		if (ascii && !eastAsia && !hAnsi && !cs) opts.font = hint ? {
+			name: ascii,
+			hint
+		} : ascii;
+		else {
+			const fontObj = {};
+			if (ascii) fontObj.ascii = ascii;
+			if (eastAsia) fontObj.eastAsia = eastAsia;
+			if (hAnsi) fontObj.hAnsi = hAnsi;
+			if (cs) fontObj.cs = cs;
+			if (hint) fontObj.hint = hint;
+			opts.font = fontObj;
+		}
+	}
+	const bold = findChild(el, "w:b");
+	if (bold) opts.bold = attrBool(bold, "w:val") ?? true;
+	const boldCs = findChild(el, "w:bCs");
+	if (boldCs) opts.boldComplexScript = attrBool(boldCs, "w:val") ?? true;
+	const italic = findChild(el, "w:i");
+	if (italic) opts.italic = attrBool(italic, "w:val") ?? true;
+	const italicCs = findChild(el, "w:iCs");
+	if (italicCs) opts.italicComplexScript = attrBool(italicCs, "w:val") ?? true;
+	const underline = findChild(el, "w:u");
+	if (underline) {
+		const ul = {};
+		const uType = attr(underline, "w:val");
+		if (uType) ul.type = uType;
+		const uColor = colorAttr(underline, "w:color");
+		if (uColor) ul.color = uColor;
+		opts.underline = ul;
+	}
+	for (const [name, optKey] of [
+		["w:strike", "strike"],
+		["w:dstrike", "doubleStrike"],
+		["w:outline", "outline"],
+		["w:shadow", "shadow"],
+		["w:emboss", "emboss"],
+		["w:imprint", "imprint"],
+		["w:vanish", "vanish"],
+		["w:webHidden", "webHidden"],
+		["w:noProof", "noProof"],
+		["w:snapToGrid", "snapToGrid"],
+		["w:smallCaps", "smallCaps"],
+		["w:caps", "allCaps"],
+		["w:rtl", "rightToLeft"],
+		["w:cs", "complexScript"],
+		["w:specVanish", "specVanish"],
+		["w:oMath", "math"]
+	]) {
+		const child = findChild(el, name);
+		if (child) opts[optKey] = attrBool(child, "w:val") ?? true;
+	}
+	const color = findChild(el, "w:color");
+	if (color) {
+		const c = colorAttr(color, "w:val");
+		const themeColor = attr(color, "w:themeColor");
+		const themeTint = attr(color, "w:themeTint");
+		const themeShade = attr(color, "w:themeShade");
+		if (themeColor || themeTint || themeShade) {
+			const colorObj = {};
+			if (c) colorObj.val = c;
+			if (themeColor) colorObj.themeColor = themeColor;
+			if (themeTint) colorObj.themeTint = themeTint;
+			if (themeShade) colorObj.themeShade = themeShade;
+			opts.color = colorObj;
+		} else if (c) opts.color = c;
+	}
+	const sz = findChild(el, "w:sz");
+	if (sz) {
+		const halfPts = attrNum(sz, "w:val");
+		if (halfPts !== void 0) opts.size = halfPts / 2;
+	}
+	const szCs = findChild(el, "w:szCs");
+	if (szCs) {
+		const halfPts = attrNum(szCs, "w:val");
+		if (halfPts !== void 0) opts.sizeComplexScript = halfPts / 2;
+	}
+	const highlight = findChild(el, "w:highlight");
+	if (highlight) {
+		const val = attr(highlight, "w:val");
+		if (val) opts.highlight = val;
+	}
+	const highlightCs = findChild(el, "w:highlightCs");
+	if (highlightCs) {
+		const val = attr(highlightCs, "w:val");
+		if (val) opts.highlightComplexScript = val;
+	}
+	const vertAlign = findChild(el, "w:vertAlign");
+	if (vertAlign) {
+		const val = attr(vertAlign, "w:val");
+		if (val === "subscript") opts.subScript = true;
+		else if (val === "superscript") opts.superScript = true;
+	}
+	const effect = findChild(el, "w:effect");
+	if (effect) {
+		const val = attr(effect, "w:val");
+		if (val) opts.effect = val;
+	}
+	const emphasisMark = findChild(el, "w:em");
+	if (emphasisMark) {
+		const val = attr(emphasisMark, "w:val");
+		if (val) opts.emphasisMark = { type: val };
+	}
+	const spacing = findChild(el, "w:spacing");
+	if (spacing) {
+		const val = attrNum(spacing, "w:val");
+		if (val !== void 0) opts.characterSpacing = val;
+	}
+	const scale = findChild(el, "w:w");
+	if (scale) {
+		const val = attrNum(scale, "w:val");
+		if (val !== void 0) opts.scale = val;
+	}
+	const kern = findChild(el, "w:kern");
+	if (kern) {
+		const val = attrNum(kern, "w:val");
+		if (val !== void 0) opts.kern = val;
+	}
+	const position = findChild(el, "w:position");
+	if (position) {
+		const val = attr(position, "w:val");
+		if (val !== void 0) opts.position = val;
+	}
+	const fitText = findChild(el, "w:fitText");
+	if (fitText) {
+		const val = attrNum(fitText, "w:val");
+		if (val !== void 0) opts.fitText = val;
+	}
+	const lang = findChild(el, "w:lang");
+	if (lang) {
+		const langObj = {};
+		const val = attr(lang, "w:val");
+		if (val) langObj.value = val;
+		const eastAsia = attr(lang, "w:eastAsia");
+		if (eastAsia) langObj.eastAsia = eastAsia;
+		const bidi = attr(lang, "w:bidi");
+		if (bidi) langObj.bidirectional = bidi;
+		if (Object.keys(langObj).length > 0) opts.language = langObj;
+	}
+	const bdr = findChild(el, "w:bdr");
+	if (bdr) opts.border = parseBorder(bdr);
+	const shd = findChild(el, "w:shd");
+	if (shd) opts.shading = parseShading(shd);
+	const eastAsianLayout = findChild(el, "w:eastAsianLayout");
+	if (eastAsianLayout) opts.eastAsianLayout = parseEastAsianLayout(eastAsianLayout);
+	const contentPart = findChild(el, "w:contentPart");
+	if (contentPart) {
+		const rId = attr(contentPart, "r:id");
+		if (rId) opts.contentPartRId = rId;
+	}
+	const rPrChange = findChild(el, "w:rPrChange");
+	if (rPrChange) {
+		const rev = {};
+		const author = attr(rPrChange, "w:author");
+		if (author) rev.author = author;
+		const date = attr(rPrChange, "w:date");
+		if (date) rev.date = date;
+		const id = attrNum(rPrChange, "w:id");
+		if (id !== void 0) rev.id = id;
+		const innerRPr = findChild(rPrChange, "w:rPr");
+		if (innerRPr) Object.assign(rev, parseRunProperties(innerRPr));
+		if (Object.keys(rev).length > 0) opts.revision = rev;
+	}
+	return opts;
+}
+/**
+* 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;
+}
+/**
+* Parse a w:shd element into ShadingAttributesProperties.
+*/
+function parseShading(el) {
+	const opts = {};
+	const fill = colorAttr(el, "w:fill");
+	if (fill) opts.fill = fill;
+	const color = colorAttr(el, "w:color");
+	if (color) opts.color = color;
+	const type = attr(el, "w:val");
+	if (type) opts.type = type;
+	return opts;
+}
+/**
+* Parse a w:eastAsianLayout element into EastAsianLayoutOptions.
+*/
+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");
+/**
+* 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
+	};
+}
+/**
+* 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.
+*
+* When empty run elements (tab, noBreakHyphen, date fields, etc.) are present,
+* uses children[] format to preserve them for round-trip fidelity.
+*/
+/** 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 }]
+]);
+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/parts/paragraph/stringify.ts
+/**
+* Direct XML string builders for paragraph and run properties.
+*
+* Replaces `buildParagraphProperties() + xml()` and `buildRunProperties() + xml()`
+* with direct string concatenation — zero intermediate IXmlableObject allocation,
+* zero recursive xml() traversal. Follows PPTX/XLSX pattern.
+*
+* @module
+*/
+/** On/off: `<w:name/>` for true, `<w:name w:val="0"/>` for false */
+function onOff(name, val) {
+	return val ? `<${name}/>` : `<${name} w:val="0"/>`;
+}
+/** Build attrs string from key-value pairs, skipping undefined */
+function attrParts(attrs) {
+	const parts = [];
+	for (const [key, val] of Object.entries(attrs)) if (val !== void 0) parts.push(`${key}="${val}"`);
+	return parts.join(" ");
+}
+function borderStr(name, opts) {
+	return `<${name} ${attrParts({
+		"w:val": opts.style,
+		"w:color": opts.color !== void 0 ? hexColorValue(opts.color) : void 0,
+		"w:sz": opts.size !== void 0 ? eighthPointMeasureValue(opts.size) : void 0,
+		"w:space": opts.space !== void 0 ? pointMeasureValue(opts.space) : void 0,
+		"w:themeColor": opts.themeColor,
+		"w:themeTint": opts.themeTint !== void 0 ? uCharHexNumber(opts.themeTint) : void 0,
+		"w:themeShade": opts.themeShade !== void 0 ? uCharHexNumber(opts.themeShade) : void 0,
+		"w:shadow": opts.shadow !== void 0 ? opts.shadow ? 1 : 0 : void 0,
+		"w:frame": opts.frame !== void 0 ? opts.frame ? 1 : 0 : void 0
+	})}/>`;
+}
+function shadingStr(opts) {
+	return `<w:shd ${attrParts({
+		"w:val": opts.type ?? "clear",
+		"w:color": opts.color !== void 0 ? hexColorValue(opts.color) : void 0,
+		"w:fill": opts.fill !== void 0 ? hexColorValue(opts.fill) : void 0,
+		"w:themeColor": opts.themeColor,
+		"w:themeTint": opts.themeTint !== void 0 ? uCharHexNumber(opts.themeTint) : void 0,
+		"w:themeShade": opts.themeShade !== void 0 ? uCharHexNumber(opts.themeShade) : void 0,
+		"w:themeFill": opts.themeFill,
+		"w:themeFillTint": opts.themeFillTint !== void 0 ? uCharHexNumber(opts.themeFillTint) : void 0,
+		"w:themeFillShade": opts.themeFillShade !== void 0 ? uCharHexNumber(opts.themeFillShade) : void 0
+	})}/>`;
+}
+function spacingStr(opts) {
+	return `<w:spacing ${attrParts({
+		"w:after": opts.after,
+		"w:afterAutospacing": opts.afterAutoSpacing !== void 0 ? opts.afterAutoSpacing ? 1 : 0 : void 0,
+		"w:afterLines": opts.afterLines !== void 0 ? decimalNumber(opts.afterLines) : void 0,
+		"w:before": opts.before,
+		"w:beforeAutospacing": opts.beforeAutoSpacing !== void 0 ? opts.beforeAutoSpacing ? 1 : 0 : void 0,
+		"w:beforeLines": opts.beforeLines !== void 0 ? decimalNumber(opts.beforeLines) : void 0,
+		"w:line": opts.line,
+		"w:lineRule": opts.lineRule
+	})}/>`;
+}
+function indentStr(opts) {
+	return `<w:ind ${attrParts({
+		"w:start": opts.start !== void 0 ? signedTwipsMeasureValue(opts.start) : void 0,
+		"w:startChars": opts.startChars !== void 0 ? decimalNumber(opts.startChars) : void 0,
+		"w:end": opts.end !== void 0 ? signedTwipsMeasureValue(opts.end) : void 0,
+		"w:endChars": opts.endChars !== void 0 ? decimalNumber(opts.endChars) : void 0,
+		"w:left": opts.left !== void 0 ? signedTwipsMeasureValue(opts.left) : void 0,
+		"w:leftChars": opts.leftChars !== void 0 ? decimalNumber(opts.leftChars) : void 0,
+		"w:right": opts.right !== void 0 ? signedTwipsMeasureValue(opts.right) : void 0,
+		"w:rightChars": opts.rightChars !== void 0 ? decimalNumber(opts.rightChars) : void 0,
+		"w:hanging": opts.hanging !== void 0 ? twipsMeasureValue(opts.hanging) : void 0,
+		"w:hangingChars": opts.hangingChars !== void 0 ? decimalNumber(opts.hangingChars) : void 0,
+		"w:firstLine": opts.firstLine !== void 0 ? twipsMeasureValue(opts.firstLine) : void 0,
+		"w:firstLineChars": opts.firstLineChars !== void 0 ? decimalNumber(opts.firstLineChars) : void 0
+	})}/>`;
+}
+function tabStopsStr(defs) {
+	return `<w:tabs>${defs.map(({ type, position, leader }) => {
+		return `<w:tab ${attrParts({
+			"w:val": type,
+			"w:pos": position,
+			"w:leader": leader
+		})}/>`;
+	}).join("")}</w:tabs>`;
+}
+function cnfStyleStr(opts) {
+	return `<w:cnfStyle ${attrParts({
+		"w:firstRow": opts.firstRow ? "1" : "0",
+		"w:lastRow": opts.lastRow ? "1" : "0",
+		"w:firstColumn": opts.firstColumn ? "1" : "0",
+		"w:lastColumn": opts.lastColumn ? "1" : "0",
+		"w:oddVBand": opts.oddVBand ? "1" : "0",
+		"w:evenVBand": opts.evenVBand ? "1" : "0",
+		"w:oddHBand": opts.oddHBand ? "1" : "0",
+		"w:evenHBand": opts.evenHBand ? "1" : "0",
+		"w:firstRowFirstColumn": opts.firstRowFirstColumn ? "1" : "0",
+		"w:firstRowLastColumn": opts.firstRowLastColumn ? "1" : "0",
+		"w:lastRowFirstColumn": opts.lastRowFirstColumn ? "1" : "0",
+		"w:lastRowLastColumn": opts.lastRowLastColumn ? "1" : "0"
+	})}/>`;
+}
+function framePrStr(opts) {
+	const alignment = opts.alignment;
+	const position = opts.position;
+	return `<w:framePr ${attrParts({
+		"w:xAlign": alignment?.x,
+		"w:yAlign": alignment?.y,
+		"w:hAnchor": opts.anchor?.horizontal,
+		"w:anchorLock": opts.anchorLock,
+		"w:vAnchor": opts.anchor?.vertical,
+		"w:dropCap": opts.dropCap,
+		"w:h": opts.height,
+		"w:lines": opts.lines,
+		"w:hRule": opts.rule,
+		"w:hSpace": opts.space?.horizontal,
+		"w:vSpace": opts.space?.vertical,
+		"w:w": opts.width,
+		"w:wrap": opts.wrap,
+		"w:x": position?.x,
+		"w:y": position?.y
+	})}/>`;
+}
+function numPrStr(numberId, indentLevel, numberingChange) {
+	const idVal = typeof numberId === "string" ? `{${numberId}}` : numberId;
+	const parts = [`<w:ilvl w:val="${Math.min(indentLevel, 9)}"/>`, `<w:numId w:val="${idVal}"/>`];
+	if (numberingChange) {
+		const a = attrParts({
+			"w:original": numberingChange.original,
+			"w:id": numberingChange.id,
+			"w:author": numberingChange.author,
+			"w:date": numberingChange.date
+		});
+		parts.push(`<w:numberingChange ${a}/>`);
+	}
+	return `<w:numPr>${parts.join("")}</w:numPr>`;
+}
+function colorStr(colorOrOptions) {
+	if (typeof colorOrOptions === "string") return `<w:color w:val="${hexColorValue(colorOrOptions)}"/>`;
+	const opts = colorOrOptions;
+	return `<w:color ${attrParts({
+		"w:val": opts.val !== void 0 ? hexColorValue(opts.val) : void 0,
+		"w:themeColor": opts.themeColor,
+		"w:themeTint": opts.themeTint !== void 0 ? uCharHexNumber(opts.themeTint) : void 0,
+		"w:themeShade": opts.themeShade !== void 0 ? uCharHexNumber(opts.themeShade) : void 0
+	})}/>`;
+}
+function runFontsStr(nameOrAttrs, hint) {
+	if (typeof nameOrAttrs === "string") return `<w:rFonts ${attrParts({
+		"w:ascii": nameOrAttrs,
+		"w:cs": nameOrAttrs,
+		"w:eastAsia": nameOrAttrs,
+		"w:hAnsi": nameOrAttrs,
+		"w:hint": hint
+	})}/>`;
+	const attrs = nameOrAttrs;
+	return `<w:rFonts ${attrParts({
+		"w:ascii": attrs.ascii,
+		"w:asciiTheme": attrs.asciiTheme,
+		"w:cs": attrs.cs,
+		"w:cstheme": attrs.cstheme,
+		"w:eastAsia": attrs.eastAsia,
+		"w:eastAsiaTheme": attrs.eastAsiaTheme,
+		"w:hAnsi": attrs.hAnsi,
+		"w:hAnsiTheme": attrs.hAnsiTheme,
+		"w:hint": attrs.hint
+	})}/>`;
+}
+function underlineStr(type, color) {
+	return `<w:u ${attrParts({
+		"w:val": type ?? "single",
+		"w:color": color !== void 0 ? hexColorValue(color) : void 0
+	})}/>`;
+}
+function eastAsianLayoutStr(opts) {
+	return `<w:eastAsianLayout ${attrParts({
+		"w:id": opts.id !== void 0 ? decimalNumber(opts.id) : void 0,
+		"w:combine": opts.combine !== void 0 ? opts.combine ? 1 : 0 : void 0,
+		"w:combineBrackets": opts.combineBrackets,
+		"w:vert": opts.vert !== void 0 ? opts.vert ? 1 : 0 : void 0,
+		"w:vertCompress": opts.vertCompress !== void 0 ? opts.vertCompress ? 1 : 0 : void 0
+	})}/>`;
+}
+function languageStr(opts) {
+	return `<w:lang ${attrParts({
+		"w:val": opts.value,
+		"w:eastAsia": opts.eastAsia,
+		"w:bidi": opts.bidirectional
+	})}/>`;
+}
+/**
+* Build `<w:pPr>` XML string directly from options — zero IXmlableObject allocation.
+*
+* Replaces `buildParagraphProperties() + xml()` with a single-pass string builder.
+*/
+function stringifyParagraphProperties(options) {
+	const numberingReferences = [];
+	if (!options) return {
+		xml: void 0,
+		numberingReferences
+	};
+	const parts = [];
+	if (options.heading) parts.push(`<w:pStyle w:val="${escapeXml(options.heading)}"/>`);
+	if (options.bullet) parts.push("<w:pStyle w:val=\"ListParagraph\"/>");
+	if (options.numbering) {
+		if (!options.style && !options.heading) {
+			if (!options.numbering.custom) parts.push("<w:pStyle w:val=\"ListParagraph\"/>");
+		}
+	}
+	if (options.style) parts.push(`<w:pStyle w:val="${escapeXml(options.style)}"/>`);
+	if (options.keepNext !== void 0) parts.push(onOff("w:keepNext", options.keepNext));
+	if (options.keepLines !== void 0) parts.push(onOff("w:keepLines", options.keepLines));
+	if (options.pageBreakBefore) parts.push("<w:pageBreakBefore/>");
+	if (options.frame) parts.push(framePrStr(options.frame));
+	if (options.widowControl !== void 0) parts.push(onOff("w:widowControl", options.widowControl));
+	if (options.bullet) parts.push(`<w:numPr><w:ilvl w:val="${Math.min(options.bullet.level, 9)}"/><w:numId w:val="1"/></w:numPr>`);
+	if (options.numbering) {
+		numberingReferences.push({
+			instance: options.numbering.instance ?? 0,
+			reference: options.numbering.reference
+		});
+		const numId = `${options.numbering.reference}-${options.numbering.instance ?? 0}`;
+		parts.push(numPrStr(numId, options.numbering.level, options.numbering.numberingChange));
+	} else if (options.numbering === false) parts.push(numPrStr(0, 0));
+	if (options.border) {
+		const bParts = [];
+		if (options.border.top) bParts.push(borderStr("w:top", options.border.top));
+		if (options.border.left) bParts.push(borderStr("w:left", options.border.left));
+		if (options.border.bottom) bParts.push(borderStr("w:bottom", options.border.bottom));
+		if (options.border.right) bParts.push(borderStr("w:right", options.border.right));
+		if (options.border.between) bParts.push(borderStr("w:between", options.border.between));
+		if (options.border.bar) bParts.push(borderStr("w:bar", options.border.bar));
+		if (bParts.length) parts.push(`<w:pBdr>${bParts.join("")}</w:pBdr>`);
+	}
+	if (options.thematicBreak) parts.push(`<w:pBdr>${borderStr("w:bottom", {
+		color: "auto",
+		size: 6,
+		space: 1,
+		style: BorderStyle.SINGLE
+	})}</w:pBdr>`);
+	if (options.shading) parts.push(shadingStr(options.shading));
+	if (options.wordWrap) parts.push("<w:wordWrap w:val=\"0\"/>");
+	if (options.overflowPunctuation) parts.push(onOff("w:overflowPunct", options.overflowPunctuation));
+	const tabDefs = [
+		...options.rightTabStop !== void 0 ? [{
+			position: options.rightTabStop,
+			type: "right"
+		}] : [],
+		...options.tabStops ? options.tabStops : [],
+		...options.leftTabStop !== void 0 ? [{
+			position: options.leftTabStop,
+			type: "left"
+		}] : []
+	];
+	if (tabDefs.length > 0) parts.push(tabStopsStr(tabDefs));
+	if (options.bidirectional !== void 0) parts.push(onOff("w:bidi", options.bidirectional));
+	if (options.spacing) parts.push(spacingStr(options.spacing));
+	if (options.indent) parts.push(indentStr(options.indent));
+	if (options.contextualSpacing !== void 0) parts.push(onOff("w:contextualSpacing", options.contextualSpacing));
+	if (options.alignment) parts.push(`<w:jc w:val="${options.alignment}"/>`);
+	if (options.outlineLevel !== void 0) parts.push(`<w:outlineLvl w:val="${options.outlineLevel}"/>`);
+	if (options.divId !== void 0) parts.push(`<w:divId w:val="${options.divId}"/>`);
+	if (options.cnfStyle) parts.push(cnfStyleStr(options.cnfStyle));
+	if (options.suppressLineNumbers !== void 0) parts.push(onOff("w:suppressLineNumbers", options.suppressLineNumbers));
+	if (options.autoSpaceEastAsianText !== void 0) parts.push(onOff("w:autoSpaceDN", options.autoSpaceEastAsianText));
+	if (options.suppressAutoHyphens !== void 0) parts.push(onOff("w:suppressAutoHyphens", options.suppressAutoHyphens));
+	if (options.adjustRightInd !== void 0) parts.push(onOff("w:adjustRightInd", options.adjustRightInd));
+	if (options.snapToGrid !== void 0) parts.push(onOff("w:snapToGrid", options.snapToGrid));
+	if (options.mirrorIndents !== void 0) parts.push(onOff("w:mirrorIndents", options.mirrorIndents));
+	if (options.kinsoku !== void 0) parts.push(onOff("w:kinsoku", options.kinsoku));
+	if (options.topLinePunct !== void 0) parts.push(onOff("w:topLinePunct", options.topLinePunct));
+	if (options.autoSpaceDE !== void 0) parts.push(onOff("w:autoSpaceDE", options.autoSpaceDE));
+	if (options.textAlignment !== void 0) parts.push(`<w:textAlignment w:val="${options.textAlignment}"/>`);
+	if (options.textboxTightWrap !== void 0) parts.push(`<w:textboxTightWrap w:val="${options.textboxTightWrap}"/>`);
+	if (options.textDirection !== void 0) parts.push(`<w:textDirection w:val="${options.textDirection}"/>`);
+	if (options.suppressOverlap !== void 0) parts.push(onOff("w:suppressOverlap", options.suppressOverlap));
+	if (options.run) {
+		const inner = stringifyRunPropertiesInner(options.run);
+		if (inner !== void 0) {
+			const extra = [];
+			const runOpts = options.run;
+			if (runOpts.insertion) {
+				const { id, author, date } = runOpts.insertion;
+				extra.push(`<w:ins w:id="${id}" w:author="${escapeXml(author)}" w:date="${date}"/>`);
+			}
+			if (runOpts.deletion) {
+				const { id, author, date } = runOpts.deletion;
+				extra.push(`<w:del w:id="${id}" w:author="${escapeXml(author)}" w:date="${date}"/>`);
+			}
+			const body = inner + extra.join("");
+			parts.push(`<w:rPr>${body}</w:rPr>`);
+		}
+	}
+	if (options.revision) {
+		const rev = options.revision;
+		const { author: _a, date: _d, id: _i, ...originalProps } = rev;
+		const inner = stringifyParagraphProperties({
+			...originalProps,
+			includeIfEmpty: true
+		});
+		parts.push(`<w:pPrChange w:author="${escapeXml(rev.author)}" w:date="${rev.date}" w:id="${rev.id}">${inner.xml ?? "<w:pPr/>"}</w:pPrChange>`);
+	}
+	const body = parts.join("");
+	return {
+		xml: options.includeIfEmpty || body.length > 0 ? `<w:pPr>${body}</w:pPr>` : void 0,
+		numberingReferences
+	};
+}
+/**
+* Build the inner content of `<w:rPr>` as a string.
+* Returns undefined if no properties are set.
+*/
+function stringifyRunPropertiesInner(opts) {
+	if (!opts) return void 0;
+	const parts = [];
+	if (opts.style) parts.push(`<w:rStyle w:val="${escapeXml(opts.style)}"/>`);
+	if (opts.font) if (typeof opts.font === "string") parts.push(runFontsStr(opts.font));
+	else if ("name" in opts.font) parts.push(runFontsStr(opts.font.name, opts.font.hint));
+	else parts.push(runFontsStr(opts.font));
+	if (opts.bold !== void 0) parts.push(onOff("w:b", opts.bold));
+	if ((opts.boldComplexScript === void 0 && opts.bold !== void 0 || opts.boldComplexScript) !== void 0) parts.push(onOff("w:bCs", opts.boldComplexScript ?? opts.bold));
+	if (opts.italic !== void 0) parts.push(onOff("w:i", opts.italic));
+	if ((opts.italicComplexScript === void 0 && opts.italic !== void 0 || opts.italicComplexScript) !== void 0) parts.push(onOff("w:iCs", opts.italicComplexScript ?? opts.italic));
+	if (opts.smallCaps !== void 0) parts.push(onOff("w:smallCaps", opts.smallCaps));
+	else if (opts.allCaps !== void 0) parts.push(onOff("w:caps", opts.allCaps));
+	if (opts.strike !== void 0) parts.push(onOff("w:strike", opts.strike));
+	if (opts.doubleStrike !== void 0) parts.push(onOff("w:dstrike", opts.doubleStrike));
+	if (opts.emboss !== void 0) parts.push(onOff("w:emboss", opts.emboss));
+	if (opts.imprint !== void 0) parts.push(onOff("w:imprint", opts.imprint));
+	if (opts.outline !== void 0) parts.push(onOff("w:outline", opts.outline));
+	if (opts.shadow !== void 0) parts.push(onOff("w:shadow", opts.shadow));
+	if (opts.webHidden !== void 0) parts.push(onOff("w:webHidden", opts.webHidden));
+	if (opts.noProof !== void 0) parts.push(onOff("w:noProof", opts.noProof));
+	if (opts.snapToGrid !== void 0) parts.push(onOff("w:snapToGrid", opts.snapToGrid));
+	if (opts.vanish) parts.push(onOff("w:vanish", opts.vanish));
+	if (opts.color) parts.push(colorStr(opts.color));
+	if (opts.characterSpacing) parts.push(`<w:spacing w:val="${signedTwipsMeasureValue(opts.characterSpacing)}"/>`);
+	if (opts.scale !== void 0) parts.push(`<w:w w:val="${opts.scale}"/>`);
+	if (opts.kern) parts.push(`<w:kern w:val="${hpsMeasureValue(opts.kern)}"/>`);
+	if (opts.position) parts.push(`<w:position w:val="${opts.position}"/>`);
+	if (opts.size !== void 0) parts.push(`<w:sz w:val="${hpsMeasureValue(opts.size * 2)}"/>`);
+	const szCs = opts.sizeComplexScript === void 0 || opts.sizeComplexScript === true ? opts.size : opts.sizeComplexScript;
+	if (szCs) parts.push(`<w:szCs w:val="${hpsMeasureValue(szCs * 2)}"/>`);
+	if (opts.highlight) parts.push(`<w:highlight w:val="${opts.highlight}"/>`);
+	if (opts.highlightComplexScript === true) {
+		if (opts.highlight) parts.push(`<w:highlightCs w:val="${opts.highlight}"/>`);
+	} else if (opts.highlightComplexScript !== void 0 && opts.highlightComplexScript !== false) parts.push(`<w:highlightCs w:val="${opts.highlightComplexScript}"/>`);
+	if (opts.underline) parts.push(underlineStr(opts.underline.type, opts.underline.color));
+	if (opts.effect) parts.push(`<w:effect w:val="${opts.effect}"/>`);
+	if (opts.border) parts.push(borderStr("w:bdr", opts.border));
+	if (opts.shading) parts.push(shadingStr(opts.shading));
+	if (opts.subScript) parts.push("<w:vertAlign w:val=\"subscript\"/>");
+	if (opts.superScript) parts.push("<w:vertAlign w:val=\"superscript\"/>");
+	if (opts.rightToLeft !== void 0) parts.push(onOff("w:rtl", opts.rightToLeft));
+	if (opts.emphasisMark) parts.push(`<w:em w:val="${opts.emphasisMark.type ?? "dot"}"/>`);
+	if (opts.language) parts.push(languageStr(opts.language));
+	if (opts.specVanish) parts.push("<w:specVanish/>");
+	if (opts.math) parts.push(onOff("w:oMath", opts.math));
+	if (opts.fitText !== void 0) parts.push(`<w:fitText w:val="${opts.fitText}"/>`);
+	if (opts.complexScript !== void 0) parts.push(onOff("w:cs", opts.complexScript));
+	if (opts.eastAsianLayout) parts.push(eastAsianLayoutStr(opts.eastAsianLayout));
+	if (opts.contentPartRId) parts.push(`<w:contentPart r:id="${opts.contentPartRId}"/>`);
+	if (opts.revision) {
+		const rev = opts.revision;
+		const { author: _a, date: _d, id: _i, ...originalProps } = rev;
+		const inner = stringifyRunPropertiesInner(originalProps);
+		parts.push(`<w:rPrChange w:author="${escapeXml(rev.author)}" w:date="${rev.date}" w:id="${rev.id}"><w:rPr>${inner ?? ""}</w:rPr></w:rPrChange>`);
+	}
+	return parts.length > 0 ? parts.join("") : void 0;
+}
+/**
+* Build `<w:rPr>` XML string directly from options — zero IXmlableObject allocation.
+*
+* Replaces `buildRunProperties() + xml()` with a single-pass string builder.
+*/
+function stringifyRunProperties(opts) {
+	const inner = stringifyRunPropertiesInner(opts);
+	return inner ? `<w:rPr>${inner}</w:rPr>` : void 0;
+}
+//#endregion
+//#region src/parts/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.
@@ -2342,420 +3624,43 @@ const createFieldChar = (type, dirty, ffData, fldData, fieldLock) => {
 	}, children.length > 0 ? children : void 0);
 };
 /**
-* Creates the beginning of a complex field.
-*
-* The Begin element marks the start of a field. A field consists of a begin character,
-* field instructions, an optional separate character, field result, and an end character.
-*
-* For form fields, pass `formField` to embed `w:ffData` within the begin `w:fldChar`.
-*
-* @param dirty - Whether the field should be recalculated
-* @param formField - Optional form field data to embed in the begin character
-*
-* @example
-* ```typescript
-* // Simple field begin
-* createBegin();
-*
-* // Form field (checkbox)
-* createBegin(false, {
-*   name: "Check1",
-*   checkBox: { checked: true, sizeAuto: true },
-* });
-* ```
-*/
-const createBegin = (dirty, formField, fieldLock) => createFieldChar(FieldCharacterType.BEGIN, dirty, formField ? createFormFieldData(formField) : void 0, void 0, fieldLock);
-/**
-* Creates the separator between field code and field result in a complex field.
-*
-* The Separate element divides the field code (instructions) from the field result
-* (the computed value).
-*/
-const createSeparate = (dirty) => createFieldChar(FieldCharacterType.SEPARATE, dirty);
-/**
-* Creates the end of a complex field.
-*
-* The End element marks the end of a field. Every field that begins with a Begin
-* element must be terminated with an End element.
-*/
-const createEnd = (dirty) => createFieldChar(FieldCharacterType.END, dirty);
-//#endregion
-//#region src/parts/paragraph/stringify.ts
-/**
-* Direct XML string builders for paragraph and run properties.
-*
-* Replaces `buildParagraphProperties() + xml()` and `buildRunProperties() + xml()`
-* with direct string concatenation — zero intermediate IXmlableObject allocation,
-* zero recursive xml() traversal. Follows PPTX/XLSX pattern.
-*
-* @module
-*/
-/** On/off: `<w:name/>` for true, `<w:name w:val="0"/>` for false */
-function onOff(name, val) {
-	return val ? `<${name}/>` : `<${name} w:val="0"/>`;
-}
-/** Build attrs string from key-value pairs, skipping undefined */
-function attrParts(attrs) {
-	const parts = [];
-	for (const [key, val] of Object.entries(attrs)) if (val !== void 0) parts.push(`${key}="${val}"`);
-	return parts.join(" ");
-}
-function borderStr(name, opts) {
-	return `<${name} ${attrParts({
-		"w:val": opts.style,
-		"w:color": opts.color !== void 0 ? hexColorValue(opts.color) : void 0,
-		"w:sz": opts.size !== void 0 ? eighthPointMeasureValue(opts.size) : void 0,
-		"w:space": opts.space !== void 0 ? pointMeasureValue(opts.space) : void 0,
-		"w:themeColor": opts.themeColor,
-		"w:themeTint": opts.themeTint !== void 0 ? uCharHexNumber(opts.themeTint) : void 0,
-		"w:themeShade": opts.themeShade !== void 0 ? uCharHexNumber(opts.themeShade) : void 0,
-		"w:shadow": opts.shadow !== void 0 ? opts.shadow ? 1 : 0 : void 0,
-		"w:frame": opts.frame !== void 0 ? opts.frame ? 1 : 0 : void 0
-	})}/>`;
-}
-function shadingStr(opts) {
-	return `<w:shd ${attrParts({
-		"w:val": opts.type ?? "clear",
-		"w:color": opts.color !== void 0 ? hexColorValue(opts.color) : void 0,
-		"w:fill": opts.fill !== void 0 ? hexColorValue(opts.fill) : void 0,
-		"w:themeColor": opts.themeColor,
-		"w:themeTint": opts.themeTint !== void 0 ? uCharHexNumber(opts.themeTint) : void 0,
-		"w:themeShade": opts.themeShade !== void 0 ? uCharHexNumber(opts.themeShade) : void 0,
-		"w:themeFill": opts.themeFill,
-		"w:themeFillTint": opts.themeFillTint !== void 0 ? uCharHexNumber(opts.themeFillTint) : void 0,
-		"w:themeFillShade": opts.themeFillShade !== void 0 ? uCharHexNumber(opts.themeFillShade) : void 0
-	})}/>`;
-}
-function spacingStr(opts) {
-	return `<w:spacing ${attrParts({
-		"w:after": opts.after,
-		"w:afterAutospacing": opts.afterAutoSpacing !== void 0 ? opts.afterAutoSpacing ? 1 : 0 : void 0,
-		"w:afterLines": opts.afterLines !== void 0 ? decimalNumber(opts.afterLines) : void 0,
-		"w:before": opts.before,
-		"w:beforeAutospacing": opts.beforeAutoSpacing !== void 0 ? opts.beforeAutoSpacing ? 1 : 0 : void 0,
-		"w:beforeLines": opts.beforeLines !== void 0 ? decimalNumber(opts.beforeLines) : void 0,
-		"w:line": opts.line,
-		"w:lineRule": opts.lineRule
-	})}/>`;
-}
-function indentStr(opts) {
-	return `<w:ind ${attrParts({
-		"w:start": opts.start !== void 0 ? signedTwipsMeasureValue(opts.start) : void 0,
-		"w:startChars": opts.startChars !== void 0 ? decimalNumber(opts.startChars) : void 0,
-		"w:end": opts.end !== void 0 ? signedTwipsMeasureValue(opts.end) : void 0,
-		"w:endChars": opts.endChars !== void 0 ? decimalNumber(opts.endChars) : void 0,
-		"w:left": opts.left !== void 0 ? signedTwipsMeasureValue(opts.left) : void 0,
-		"w:leftChars": opts.leftChars !== void 0 ? decimalNumber(opts.leftChars) : void 0,
-		"w:right": opts.right !== void 0 ? signedTwipsMeasureValue(opts.right) : void 0,
-		"w:rightChars": opts.rightChars !== void 0 ? decimalNumber(opts.rightChars) : void 0,
-		"w:hanging": opts.hanging !== void 0 ? twipsMeasureValue(opts.hanging) : void 0,
-		"w:hangingChars": opts.hangingChars !== void 0 ? decimalNumber(opts.hangingChars) : void 0,
-		"w:firstLine": opts.firstLine !== void 0 ? twipsMeasureValue(opts.firstLine) : void 0,
-		"w:firstLineChars": opts.firstLineChars !== void 0 ? decimalNumber(opts.firstLineChars) : void 0
-	})}/>`;
-}
-function tabStopsStr(defs) {
-	return `<w:tabs>${defs.map(({ type, position, leader }) => {
-		return `<w:tab ${attrParts({
-			"w:val": type,
-			"w:pos": position,
-			"w:leader": leader
-		})}/>`;
-	}).join("")}</w:tabs>`;
-}
-function cnfStyleStr(opts) {
-	return `<w:cnfStyle ${attrParts({
-		"w:firstRow": opts.firstRow ? "1" : "0",
-		"w:lastRow": opts.lastRow ? "1" : "0",
-		"w:firstColumn": opts.firstColumn ? "1" : "0",
-		"w:lastColumn": opts.lastColumn ? "1" : "0",
-		"w:oddVBand": opts.oddVBand ? "1" : "0",
-		"w:evenVBand": opts.evenVBand ? "1" : "0",
-		"w:oddHBand": opts.oddHBand ? "1" : "0",
-		"w:evenHBand": opts.evenHBand ? "1" : "0",
-		"w:firstRowFirstColumn": opts.firstRowFirstColumn ? "1" : "0",
-		"w:firstRowLastColumn": opts.firstRowLastColumn ? "1" : "0",
-		"w:lastRowFirstColumn": opts.lastRowFirstColumn ? "1" : "0",
-		"w:lastRowLastColumn": opts.lastRowLastColumn ? "1" : "0"
-	})}/>`;
-}
-function framePrStr(opts) {
-	const alignment = opts.alignment;
-	const position = opts.position;
-	return `<w:framePr ${attrParts({
-		"w:xAlign": alignment?.x,
-		"w:yAlign": alignment?.y,
-		"w:hAnchor": opts.anchor?.horizontal,
-		"w:anchorLock": opts.anchorLock,
-		"w:vAnchor": opts.anchor?.vertical,
-		"w:dropCap": opts.dropCap,
-		"w:h": opts.height,
-		"w:lines": opts.lines,
-		"w:hRule": opts.rule,
-		"w:hSpace": opts.space?.horizontal,
-		"w:vSpace": opts.space?.vertical,
-		"w:w": opts.width,
-		"w:wrap": opts.wrap,
-		"w:x": position?.x,
-		"w:y": position?.y
-	})}/>`;
-}
-function 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.
+* Creates the beginning of a complex field.
 *
-* Replaces `buildParagraphProperties() + 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 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
-	};
-}
+const createBegin = (dirty, formField, fieldLock) => createFieldChar(FieldCharacterType.BEGIN, dirty, formField ? createFormFieldData(formField) : void 0, void 0, fieldLock);
 /**
-* Build the inner content of `<w:rPr>` as a string.
-* Returns undefined if no properties are set.
+* 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).
 */
-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 createSeparate = (dirty) => createFieldChar(FieldCharacterType.SEPARATE, dirty);
 /**
-* Build `<w:rPr>` XML string directly from options — zero IXmlableObject allocation.
+* Creates the end of a complex field.
 *
-* Replaces `buildRunProperties() + xml()` with a single-pass string builder.
+* The End element marks the end of a field. Every field that begins with a Begin
+* element must be terminated with an End element.
 */
-function stringifyRunProperties(opts) {
-	const inner = stringifyRunPropertiesInner(opts);
-	return inner ? `<w:rPr>${inner}</w:rPr>` : void 0;
-}
+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.
@@ -3526,7 +4580,15 @@ function stringifyTableRow(row, ctx, extraCells) {
 	const trPr = stringifyTableRowProperties(row);
 	if (trPr) parts.push(trPr);
 	const prefixCount = parts.length;
-	for (const cell of row.cells) parts.push(stringifyTableCell(cell, ctx));
+	for (const cell of row.cells) if ("sdt" in cell) {
+		const s = cell.sdt;
+		const contentXml = (s.cells ?? []).map((c) => stringifyTableCell(c, ctx)).join("");
+		parts.push(stringifySdtShell(s.properties, s.endProperties, contentXml));
+	} else if ("customXml" in cell) {
+		const cx = cell.customXml;
+		const contentXml = (cx.children ?? []).map((c) => stringifyTableCell(c, ctx)).join("");
+		parts.push(stringifyCustomXmlShell(cx, contentXml));
+	} else parts.push(stringifyTableCell(cell, ctx));
 	if (extraCells && extraCells.length > 0) for (const { cell, columnIndex } of extraCells) {
 		const insertIdx = findInsertIndex(row.cells, columnIndex, prefixCount);
 		parts.splice(insertIdx, 0, stringifyTableCell(cell, ctx));
@@ -3540,10 +4602,20 @@ function stringifyTableRow(row, ctx, extraCells) {
 	const body = parts.join("");
 	return body ? `<w:tr${attr}>${body}</w:tr>` : attr ? `<w:tr${attr}/>` : "<w:tr/>";
 }
+/** Type guard: a plain row (not SDT/customXml-wrapped). */
+function isPlainRow(r) {
+	return !("sdt" in r) && !("customXml" in r);
+}
+/** Type guard: a plain cell (not SDT/customXml-wrapped). */
+function isPlainCell(c) {
+	return !("sdt" in c) && !("customXml" in c);
+}
 function findInsertIndex(cells, columnIndex, prefixCount) {
 	let colIdx = 0;
 	for (let i = 0; i < cells.length; i++) {
-		const { columnSpan } = getCellSpans(cells[i]);
+		const c = cells[i];
+		if (!isPlainCell(c)) continue;
+		const { columnSpan } = getCellSpans(c);
 		colIdx += columnSpan;
 		if (colIdx > columnIndex) return i + prefixCount;
 	}
@@ -3555,9 +4627,12 @@ function findInsertIndex(cells, columnIndex, prefixCount) {
 function computeVerticalMergeCells(rows) {
 	const extraMap = /* @__PURE__ */ new Map();
 	for (let ri = 0; ri < rows.length - 1; ri++) {
-		const cells = rows[ri].cells;
+		const row = rows[ri];
+		if (!isPlainRow(row)) continue;
+		const cells = row.cells;
 		let colIdx = 0;
 		for (const cell of cells) {
+			if (!isPlainCell(cell)) continue;
 			const typedCell = cell;
 			const { columnSpan, rowSpan } = getCellSpans(typedCell);
 			if (rowSpan > 1) {
@@ -3603,13 +4678,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>`;
 	},
@@ -4087,6 +5172,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;
 }
@@ -4098,6 +5211,34 @@ function parseTableEl(el, ctx) {
 	if (colWidths.length > 0) opts.columnWidths = colWidths;
 	const rows = [];
 	for (const child of el.elements ?? []) if (child.name === "w:tr") rows.push(parseTableRowEl(child, ctx));
+	else if (child.name === "w:sdt") {
+		const sdtPr = findChild(child, "w:sdtPr");
+		const properties = sdtPr ? parseSdtProperties(sdtPr) : {};
+		const sdtEndPr = findChild(child, "w:sdtEndPr");
+		const endProperties = sdtEndPr ? parseRunProperties(sdtEndPr) : void 0;
+		const sdtContent = findChild(child, "w:sdtContent");
+		const sdtRows = [];
+		if (sdtContent) {
+			for (const sub of sdtContent.elements ?? []) if (sub.name === "w:tr") sdtRows.push(parseTableRowEl(sub, ctx));
+		}
+		const sdt = { properties };
+		if (sdtRows.length > 0) sdt.rows = sdtRows;
+		if (endProperties) sdt.endProperties = endProperties;
+		rows.push({ sdt });
+	} else if (child.name === "w:customXml") {
+		const cx = { element: attr(child, "w:element") ?? "" };
+		const cxUri = attr(child, "w:uri");
+		if (cxUri) cx.uri = cxUri;
+		const xmlPr = findChild(child, "w:customXmlPr");
+		if (xmlPr) {
+			const parsed = parseCustomXmlPr(xmlPr);
+			if (parsed.placeholder !== void 0 || parsed.attributes !== void 0) cx.customXmlPr = parsed;
+		}
+		const cxRows = [];
+		for (const sub of child.elements ?? []) if (sub.name === "w:tr") cxRows.push(parseTableRowEl(sub, ctx));
+		if (cxRows.length > 0) cx.children = cxRows;
+		rows.push({ customXml: cx });
+	}
 	opts.rows = rows;
 	return opts;
 }
@@ -5081,6 +6222,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-DYH7tGnw.mjs.map