@office-open/docx 0.3.0 → 0.3.1

package/dist/index.mjs

@@ -1,10 +1,10 @@
 import { n as __reExport, t as __exportAll } from "./_chunks/chunk-DmsbSTSH.mjs";
-import { AppProperties, BaseXmlComponent, BuilderElement, BuilderElement as BuilderElement$1, EMPTY_OBJECT, EmptyElement, Formatter, HpsMeasureElement, IgnoreIfEmptyXmlComponent, ImportedRootElementAttributes, ImportedXmlComponent, InitializableXmlComponent, NextAttributeComponent, NumberValueElement, OnOffElement, Relationships, StringContainer, StringEnumValueElement, StringValueElement, TargetModeType, XmlAttributeComponent, XmlAttributeComponent as XmlAttributeComponent$1, XmlComponent, chartAttr, convertInchesToTwip, convertMillimetersToTwip, convertPixelsToEmu, convertToXmlComponent, getImageType, hashedId, hpsMeasureObj, numberValObj, onOffObj, parseCoreProperties, parseRels, readXmlFromZip, stringEnumValObj, stringValObj, uint8ToBase64, uniqueId, uniqueNumericIdCreator, uniqueNumericIdCreator as uniqueNumericIdCreator$1, uniqueUuid, unzipToMap, wrapEl } from "@office-open/core";
+import { AppProperties, BaseXmlComponent, BuilderElement, BuilderElement as BuilderElement$1, EMPTY_OBJECT, EmptyElement, Formatter, HpsMeasureElement, IgnoreIfEmptyXmlComponent, ImportedRootElementAttributes, ImportedXmlComponent, InitializableXmlComponent, NextAttributeComponent, NumberValueElement, OnOffElement, RawPassthrough, Relationships, StringContainer, StringEnumValueElement, StringValueElement, TargetModeType, XmlAttributeComponent, XmlAttributeComponent as XmlAttributeComponent$1, XmlComponent, chartAttr, convertInchesToTwip, convertMillimetersToTwip, convertPixelsToEmu, convertToXmlComponent, getImageType, hashedId, hpsMeasureObj, isRaw, numberValObj, onOffObj, parseCoreProperties, parseRels, readAllXmlParts, readXmlFromZip, stringEnumValObj, stringValObj, uint8ToBase64, uniqueId, uniqueNumericIdCreator, uniqueNumericIdCreator as uniqueNumericIdCreator$1, uniqueUuid, unzipToMap, wrapEl } from "@office-open/core";
 import { textToUint8Array, toUint8Array } from "undio";
 import { PresetGeometry, buildFill, createBlipFill, createCustomGeometry, createEffectDag, createEffectList, createOutline, createScene3D, createShape3D, extractBlipFillMedia } from "@office-open/core/drawingml";
 import { ChartCollection, ChartTitle, createChartType } from "@office-open/core/chart";
 import { COLOR_CATEGORIES, COLOR_CATEGORIES as COLOR_CATEGORIES$1, LAYOUT_CATEGORIES, LAYOUT_CATEGORIES as LAYOUT_CATEGORIES$1, STYLE_CATEGORIES, STYLE_CATEGORIES as STYLE_CATEGORIES$1, SmartArtCollection, createDataModel } from "@office-open/core/smartart";
-import { attr, attrNum, children, findChild, findDeep, js2xml, textOf, xml, xml2js } from "@office-open/xml";
+import { attr, attrNum, children, colorAttr, findChild, findDeep, js2xml, textOf, xml, xml2js } from "@office-open/xml";
 import { Readable } from "stream";
 import { Zip, ZipDeflate, ZipPassThrough, strFromU8, unzipSync, zipSync } from "fflate";
 export * from "@office-open/core/values";
@@ -24130,24 +24130,201 @@ function createDocxParseContext(zip) {
 	const hyperlinks = /* @__PURE__ */ new Map();
 	const media = /* @__PURE__ */ new Map();
 	const documentRels = /* @__PURE__ */ new Map();
+	const mediaPaths = /* @__PURE__ */ new Set();
 	const rels = parseRels(zip, "word/_rels/document.xml.rels");
 	for (const rel of rels) {
 		documentRels.set(rel.id, rel);
 		if (rel.targetMode === "External" || rel.type.includes("hyperlink")) hyperlinks.set(rel.id, rel.target);
 	}
-	for (const [path, data] of zip) if (path.startsWith("word/media/")) {
-		const fileName = path.split("/").pop() ?? path;
-		media.set(path, {
-			data: uint8ToBase64(data),
-			type: getImageType(fileName)
-		});
-	}
+	for (const path of zip.keys()) if (path.startsWith("word/media/")) mediaPaths.add(path);
 	return {
 		zip,
 		hyperlinks,
 		media,
-		documentRels
+		documentRels,
+		mediaPaths
+	};
+}
+function getMediaData(ctx, path) {
+	let entry = ctx.media.get(path);
+	if (entry) return entry;
+	const raw = ctx.zip.get(path);
+	if (!raw || !ctx.mediaPaths.has(path)) return void 0;
+	const fileName = path.split("/").pop() ?? path;
+	entry = {
+		data: uint8ToBase64(raw),
+		type: getImageType(fileName)
 	};
+	ctx.media.set(path, entry);
+	return entry;
+}
+//#endregion
+//#region src/parse/numbering.ts
+function parseNumbering(zip) {
+	const xml = readXmlFromZip(zip, "word/numbering.xml");
+	if (!xml) return {
+		abstractNums: [],
+		nums: []
+	};
+	const abstractNums = [];
+	const nums = [];
+	for (const child of xml.elements ?? []) if (child.name === "w:abstractNum") {
+		const id = attr(child, "w:abstractNumId");
+		if (id !== void 0) abstractNums.push({
+			id,
+			levels: parseLevels(child)
+		});
+	} else if (child.name === "w:num") {
+		const numId = attr(child, "w:numId");
+		const abstractNumIdEl = findChild(child, "w:abstractNumId");
+		const abstractNumId = abstractNumIdEl ? attr(abstractNumIdEl, "w:val") : void 0;
+		if (numId !== void 0 && abstractNumId !== void 0) nums.push({
+			numId,
+			abstractNumId,
+			levelOverrides: parseLevelOverrides(child)
+		});
+	}
+	return {
+		abstractNums,
+		nums
+	};
+}
+function parseLevels(abstractNum) {
+	const levels = [];
+	for (const child of abstractNum.elements ?? []) if (child.name === "w:lvl") {
+		const level = parseLevel(child);
+		if (level) levels.push(level);
+	}
+	return levels;
+}
+function parseLevel(lvl) {
+	const result = { level: attrNum(lvl, "w:ilvl") ?? 0 };
+	const numFmt = findChild(lvl, "w:numFmt");
+	if (numFmt) {
+		const val = attr(numFmt, "w:val");
+		if (val) result.format = val;
+	}
+	const lvlText = findChild(lvl, "w:lvlText");
+	if (lvlText) {
+		const val = attr(lvlText, "w:val");
+		if (val) result.text = val;
+	}
+	const lvlJc = findChild(lvl, "w:lvlJc");
+	if (lvlJc) {
+		const val = attr(lvlJc, "w:val");
+		if (val) result.alignment = val;
+	}
+	const start = findChild(lvl, "w:start");
+	if (start) {
+		const val = attrNum(start, "w:val");
+		if (val !== void 0) result.start = val;
+	}
+	const suff = findChild(lvl, "w:suff");
+	if (suff) {
+		const val = attr(suff, "w:val");
+		if (val) result.suffix = val;
+	}
+	const isLgl = findChild(lvl, "w:isLgl");
+	if (isLgl) {
+		const val = attr(isLgl, "w:val");
+		if (val === "1" || val === "true") result.isLegalNumberingStyle = true;
+	}
+	const pPr = findChild(lvl, "w:pPr");
+	if (pPr) {
+		const ind = findChild(pPr, "w:ind");
+		if (ind) {
+			const left = attrNum(ind, "w:left");
+			const hanging = attrNum(ind, "w:hanging");
+			if (left !== void 0 || hanging !== void 0) {
+				if (!result.style) result.style = {};
+				result.style.paragraph = {};
+				if (left !== void 0) result.style.paragraph.indent = {
+					...result.style.paragraph.indent,
+					left
+				};
+				if (hanging !== void 0) result.style.paragraph.indent = {
+					...result.style.paragraph.indent,
+					hanging
+				};
+			}
+		}
+	}
+	return result;
+}
+function parseLevelOverrides(num) {
+	const overrides = [];
+	for (const child of num.elements ?? []) if (child.name === "w:lvlOverride") {
+		const ilvl = attrNum(child, "w:ilvl");
+		const startOverride = findChild(child, "w:startOverride");
+		const start = startOverride ? attrNum(startOverride, "w:val") : void 0;
+		if (ilvl !== void 0) overrides.push({
+			ilvl,
+			...start !== void 0 && { startOverride: start }
+		});
+	}
+	return overrides.length > 0 ? overrides : void 0;
+}
+/**
+* Build numbering config from parsed data and remap paragraph references.
+* Only includes numIds that are actually used by paragraphs.
+*/
+function buildNumberingConfig(data, sections) {
+	if (data.abstractNums.length === 0) return [];
+	const abstractMap = new Map(data.abstractNums.map((a) => [a.id, a]));
+	const numToAbstract = new Map(data.nums.map((n) => [n.numId, n.abstractNumId]));
+	const usedNumIds = /* @__PURE__ */ new Set();
+	for (const section of sections) collectUsedNumIds(section.children, usedNumIds);
+	if (usedNumIds.size === 0) return [];
+	const config = [];
+	const numIdToReference = /* @__PURE__ */ new Map();
+	for (const numId of usedNumIds) {
+		const abstractId = numToAbstract.get(numId);
+		if (!abstractId) continue;
+		const abstract = abstractMap.get(abstractId);
+		if (!abstract) continue;
+		const reference = `num-${numId}`;
+		numIdToReference.set(numId, reference);
+		const levels = abstract.levels.map((l) => ({
+			...l,
+			style: l.style ? {
+				...l.style,
+				paragraph: l.style.paragraph ? {
+					...l.style.paragraph,
+					indent: { ...l.style.paragraph.indent }
+				} : void 0
+			} : void 0
+		}));
+		const num = data.nums.find((n) => n.numId === numId);
+		if (num?.levelOverrides) for (const override of num.levelOverrides) {
+			const level = levels.find((l) => l.level === override.ilvl);
+			if (level && override.startOverride !== void 0) level.start = override.startOverride;
+		}
+		config.push({
+			reference,
+			levels
+		});
+	}
+	for (const section of sections) remapNumberingReferences(section.children, numIdToReference);
+	return config;
+}
+function collectUsedNumIds(children, used) {
+	for (const child of children) {
+		const c = child;
+		if (c.$type === "paragraph" && c.numbering) {
+			const n = c.numbering;
+			if (n.reference) used.add(n.reference);
+		}
+	}
+}
+function remapNumberingReferences(children, numIdToReference) {
+	for (const child of children) {
+		const c = child;
+		if (c.$type === "paragraph" && c.numbering) {
+			const n = c.numbering;
+			const newRef = numIdToReference.get(n.reference);
+			if (newRef) n.reference = newRef;
+		}
+	}
 }
 //#endregion
 //#region src/parse/run.ts
@@ -24155,7 +24332,10 @@ function parseRun(run, ctx) {
 	const rPr = findChild(run, "w:rPr");
 	const br = findChild(run, "w:br");
 	if (br) {
-		if (attr(br, "w:type") === "page") return { $type: "pageBreak" };
+		const brType = attr(br, "w:type");
+		if (brType === "page" || brType === void 0) return { $type: "pageBreak" };
+		if (brType === "column") return { $type: "columnBreak" };
+		if (brType === "line" || brType === "textWrapping") return { $type: "lineBreak" };
 	}
 	const drawing = findChild(run, "w:drawing") ?? findChild(run, "mc:AlternateContent");
 	if (drawing) {
@@ -24168,14 +24348,20 @@ function parseRun(run, ctx) {
 		if (image) return image;
 	}
 	if (findChild(run, "w:tab")) return { $type: "tab" };
-	if (findChild(run, "w:footnoteReference")) return;
+	const footnoteRef = findChild(run, "w:footnoteReference");
+	const endnoteRef = findChild(run, "w:endnoteReference");
+	if (footnoteRef || endnoteRef) return {
+		$raw: true,
+		element: footnoteRef ?? endnoteRef
+	};
 	const t = findChild(run, "w:t");
 	const delText = findChild(run, "w:delText");
 	const text = textOf(t ?? delText);
 	if (!text && !rPr) return void 0;
 	const result = {
 		$type: "textRun",
-		text
+		text,
+		...delText && !t && { deletedText: true }
 	};
 	if (rPr) parseRunProperties(rPr, result);
 	return result;
@@ -24191,10 +24377,20 @@ function parseRunProperties(rPr, out) {
 		const val = attr(i, "w:val");
 		out.italics = val !== "0" && val !== "false";
 	}
+	const bCs = findChild(rPr, "w:bCs");
+	if (bCs) {
+		const val = attr(bCs, "w:val");
+		if (val !== "0" && val !== "false") out.boldCs = true;
+	}
+	const iCs = findChild(rPr, "w:iCs");
+	if (iCs) {
+		const val = attr(iCs, "w:val");
+		if (val !== "0" && val !== "false") out.italicCs = true;
+	}
 	const u = findChild(rPr, "w:u");
 	if (u) {
 		const val = attr(u, "w:val");
-		const color = attr(u, "w:color");
+		const color = colorAttr(u, "w:color");
 		if (val && val !== "none" && val !== "false") {
 			out.underline = { type: val };
 			if (color) out.underline.color = color;
@@ -24231,15 +24427,31 @@ function parseRunProperties(rPr, out) {
 		const val = attrNum(sz, "w:val");
 		if (val !== void 0) out.size = val;
 	}
-	const color = findChild(rPr, "w:color");
-	if (color) {
-		const val = attr(color, "w:val");
+	const szCs = findChild(rPr, "w:szCs");
+	if (szCs) {
+		const val = attrNum(szCs, "w:val");
+		if (val !== void 0) out.sizeCs = val;
+	}
+	const colorEl = findChild(rPr, "w:color");
+	if (colorEl) {
+		const val = colorAttr(colorEl, "w:val");
 		if (val && val !== "auto") out.color = val;
 	}
 	const rFonts = findChild(rPr, "w:rFonts");
 	if (rFonts) {
 		const ascii = attr(rFonts, "w:ascii");
-		if (ascii) out.font = ascii;
+		const hAnsi = attr(rFonts, "w:hAnsi");
+		const eastAsia = attr(rFonts, "w:eastAsia");
+		const cs = attr(rFonts, "w:cs");
+		const hint = attr(rFonts, "w:hint");
+		if (hAnsi || eastAsia || cs || hint) out.font = {
+			...ascii && { ascii },
+			...hAnsi && { hAnsi },
+			...eastAsia && { eastAsia },
+			...cs && { cs },
+			...hint && hint !== "default" && { hint }
+		};
+		else if (ascii) out.font = ascii;
 	}
 	const highlight = findChild(rPr, "w:highlight");
 	if (highlight) {
@@ -24259,7 +24471,11 @@ function parseRunProperties(rPr, out) {
 	const shd = findChild(rPr, "w:shd");
 	if (shd) {
 		const fill = attr(shd, "w:fill");
-		if (fill && fill !== "auto") out.shading = { fill };
+		const val = attr(shd, "w:val");
+		if (fill && fill !== "auto") out.shading = {
+			fill,
+			...val && val !== "clear" && { type: val }
+		};
 	}
 	const kern = findChild(rPr, "w:kern");
 	if (kern) {
@@ -24297,6 +24513,11 @@ function parseRunProperties(rPr, out) {
 		if (val !== "0" && val !== "false") out.vanish = true;
 	}
 	if (findChild(rPr, "w:noProof")) out.noProof = true;
+	const lang = findChild(rPr, "w:lang");
+	if (lang) {
+		const val = attr(lang, "w:val");
+		if (val) out.lang = val;
+	}
 	if (findChild(rPr, "w:oMath")) out.math = true;
 }
 function parseDrawingImage(drawing, ctx) {
@@ -24307,8 +24528,7 @@ function parseDrawingImage(drawing, ctx) {
 	if (!embedId) return void 0;
 	const rel = ctx.documentRels.get(embedId);
 	if (!rel) return void 0;
-	const mediaPath = rel.target.startsWith("../") ? rel.target.replace("../", "word/") : `word/${rel.target}`;
-	const mediaEntry = ctx.media.get(mediaPath);
+	const mediaEntry = getMediaData(ctx, rel.target.startsWith("../") ? rel.target.replace("../", "word/") : `word/${rel.target}`);
 	if (!mediaEntry) return void 0;
 	const extent = findDeep(drawing, "wp:extent")[0] ?? findDeep(drawing, "wp:inline")[0];
 	const cx = extent ? attrNum(extent, "cx") : void 0;
@@ -24331,8 +24551,7 @@ function parsePictImage(pict, ctx) {
 	if (!rid) return void 0;
 	const rel = ctx.documentRels.get(rid);
 	if (!rel) return void 0;
-	const mediaPath = rel.target.startsWith("../") ? rel.target.replace("../", "word/") : `word/${rel.target}`;
-	const mediaEntry = ctx.media.get(mediaPath);
+	const mediaEntry = getMediaData(ctx, rel.target.startsWith("../") ? rel.target.replace("../", "word/") : `word/${rel.target}`);
 	if (!mediaEntry) return void 0;
 	return {
 		$type: "imageRun",
@@ -24341,27 +24560,340 @@ function parsePictImage(pict, ctx) {
 	};
 }
 //#endregion
+//#region src/parse/table.ts
+function parseTable(tbl, ctx) {
+	const result = {
+		$type: "table",
+		rows: []
+	};
+	const tblPr = findChild(tbl, "w:tblPr");
+	if (tblPr) parseTableProperties(tblPr, result);
+	const tblGrid = children(tbl, "w:tblGrid")[0];
+	if (tblGrid) {
+		const gridCols = children(tblGrid, "w:gridCol");
+		if (gridCols.length > 0) result.columnWidths = gridCols.map((col) => attrNum(col, "w:w") ?? 0);
+	}
+	const rows = children(tbl, "w:tr");
+	for (const tr of rows) result.rows.push(parseTableRow(tr, ctx));
+	calculateRowSpans(result);
+	return result;
+}
+function parseTableProperties(tblPr, out) {
+	const tblW = findChild(tblPr, "w:tblW");
+	if (tblW) {
+		const size = attrNum(tblW, "w:w");
+		const type = attr(tblW, "w:type");
+		if (size !== void 0) out.width = {
+			size,
+			type: type ?? "auto"
+		};
+	}
+	const tblStyle = findChild(tblPr, "w:tblStyle");
+	if (tblStyle) {
+		const val = attr(tblStyle, "w:val");
+		if (val) out.style = val;
+	}
+	const jc = findChild(tblPr, "w:jc");
+	if (jc) {
+		const val = attr(jc, "w:val");
+		if (val) out.alignment = val;
+	}
+	const tblBorders = findChild(tblPr, "w:tblBorders");
+	if (tblBorders) {
+		const borders = {};
+		for (const child of tblBorders.elements ?? []) if (child.name && child.name.startsWith("w:")) {
+			const borderName = child.name.replace("w:", "");
+			const val = String(attr(child, "w:val") ?? "");
+			const sz = attrNum(child, "w:sz");
+			const color = colorAttr(child, "w:color");
+			const space = attrNum(child, "w:space");
+			if (val && val !== "none" && val !== "nil") {
+				const borderDef = { style: val };
+				if (sz !== void 0) borderDef.size = sz;
+				if (color) borderDef.color = color;
+				if (space !== void 0) borderDef.space = space;
+				borders[borderName] = borderDef;
+			}
+		}
+		if (Object.keys(borders).length > 0) out.borders = borders;
+	}
+	const tblCellMar = findChild(tblPr, "w:tblCellMar");
+	if (tblCellMar) {
+		const margins = {};
+		for (const child of tblCellMar.elements ?? []) if (child.name && child.name.startsWith("w:")) {
+			const name = child.name.replace("w:", "");
+			const w = attrNum(child, "w:w");
+			const type = attr(child, "w:type");
+			if (w !== void 0) margins[name] = {
+				w,
+				type: type ?? "dxa"
+			};
+		}
+		if (Object.keys(margins).length > 0) out.cellMargins = margins;
+	}
+	const tblInd = findChild(tblPr, "w:tblInd");
+	if (tblInd) {
+		const w = attrNum(tblInd, "w:w");
+		const type = attr(tblInd, "w:type");
+		if (w !== void 0) out.indentation = {
+			w,
+			type: type ?? "dxa"
+		};
+	}
+	const tblLayout = findChild(tblPr, "w:tblLayout");
+	if (tblLayout) {
+		const val = attr(tblLayout, "w:type");
+		if (val) out.layout = val;
+	}
+}
+function parseTableRow(tr, ctx) {
+	const result = { cells: [] };
+	const trPr = findChild(tr, "w:trPr");
+	if (trPr) {
+		const trHeight = findChild(trPr, "w:trHeight");
+		if (trHeight) {
+			const val = attrNum(trHeight, "w:val");
+			const rule = attr(trHeight, "w:hRule");
+			if (val !== void 0) result.height = {
+				value: val,
+				rule: rule ?? void 0
+			};
+		}
+		if (findChild(trPr, "w:tblHeader")) result.isHeader = true;
+	}
+	for (const child of tr.elements ?? []) if (child.name === "w:tc") result.cells.push(parseTableCell(child, ctx));
+	return result;
+}
+function parseTableCell(tc, ctx) {
+	const result = { children: [] };
+	const tcPr = findChild(tc, "w:tcPr");
+	if (tcPr) {
+		const gridSpan = findChild(tcPr, "w:gridSpan");
+		if (gridSpan) {
+			const val = attrNum(gridSpan, "w:val");
+			if (val !== void 0 && val > 1) result.columnSpan = val;
+		}
+		const vMerge = findChild(tcPr, "w:vMerge");
+		if (vMerge) if (attr(vMerge, "w:val") === "restart") result.rowSpan = 1;
+		else result.rowSpan = 0;
+		const tcW = findChild(tcPr, "w:tcW");
+		if (tcW) {
+			const size = attrNum(tcW, "w:w");
+			const type = attr(tcW, "w:type");
+			if (size !== void 0) result.width = {
+				size,
+				type: type ?? "auto"
+			};
+		}
+		const shd = findChild(tcPr, "w:shd");
+		if (shd) {
+			const fill = attr(shd, "w:fill");
+			const val = attr(shd, "w:val");
+			if (fill && fill !== "auto") result.shading = {
+				fill,
+				...val && val !== "clear" && { type: val }
+			};
+		}
+		const vAlign = findChild(tcPr, "w:vAlign");
+		if (vAlign) {
+			const val = attr(vAlign, "w:val");
+			if (val) result.verticalAlign = val;
+		}
+		if (findChild(tcPr, "w:noWrap")) result.noWrap = true;
+		const textDirection = findChild(tcPr, "w:textDirection");
+		if (textDirection) {
+			const val = attr(textDirection, "w:val");
+			if (val) result.textDirection = val;
+		}
+		const tcMar = findChild(tcPr, "w:tcMar");
+		if (tcMar) {
+			const margins = {};
+			for (const child of tcMar.elements ?? []) if (child.name && child.name.startsWith("w:")) {
+				const name = child.name.replace("w:", "");
+				const w = attrNum(child, "w:w");
+				const type = attr(child, "w:type");
+				if (w !== void 0) margins[name] = {
+					w,
+					type: type ?? "dxa"
+				};
+			}
+			if (Object.keys(margins).length > 0) result.margins = margins;
+		}
+		const tcBorders = findChild(tcPr, "w:tcBorders");
+		if (tcBorders) {
+			const borders = {};
+			for (const child of tcBorders.elements ?? []) if (child.name && child.name.startsWith("w:")) {
+				const borderName = child.name.replace("w:", "");
+				const val = String(attr(child, "w:val") ?? "");
+				const sz = attrNum(child, "w:sz");
+				const color = colorAttr(child, "w:color");
+				const space = attrNum(child, "w:space");
+				if (val && val !== "none" && val !== "nil") {
+					const borderDef = { style: val };
+					if (sz !== void 0) borderDef.size = sz;
+					if (color) borderDef.color = color;
+					if (space !== void 0) borderDef.space = space;
+					borders[borderName] = borderDef;
+				}
+			}
+			if (Object.keys(borders).length > 0) result.borders = borders;
+		}
+	}
+	for (const child of tc.elements ?? []) if (child.name === "w:p") result.children.push(parseParagraph(child, ctx));
+	else if (child.name === "w:tcPr") {} else if (child.name === "w:sdt") {
+		const sdt = parseSdtContent(child, ctx);
+		if (sdt) result.children.push(sdt);
+	} else if (child.name === "w:tbl") result.children.push({
+		$raw: true,
+		element: child
+	});
+	else result.children.push({
+		$raw: true,
+		element: child
+	});
+	return result;
+}
+/** Post-process: calculate actual rowSpan values from vMerge patterns */
+function calculateRowSpans(table) {
+	const mergeCounts = [];
+	for (const row of table.rows) {
+		let colIdx = 0;
+		for (const cell of row.cells) {
+			if (cell.rowSpan === 1) mergeCounts[colIdx] = 1;
+			else if (cell.rowSpan === 0 || cell.rowSpan === void 0) {
+				if (mergeCounts[colIdx] !== void 0) mergeCounts[colIdx]++;
+			}
+			const span = cell.columnSpan ?? 1;
+			for (let i = 1; i < span; i++) {
+				colIdx++;
+				mergeCounts[colIdx] = 0;
+			}
+			colIdx++;
+		}
+	}
+	for (const row of table.rows) {
+		let colIdx = 0;
+		for (const cell of row.cells) {
+			if (cell.rowSpan === 1 && mergeCounts[colIdx] !== void 0) cell.rowSpan = mergeCounts[colIdx];
+			else if (cell.rowSpan === 0) cell.rowSpan = void 0;
+			const span = cell.columnSpan ?? 1;
+			colIdx += span;
+		}
+	}
+}
+//#endregion
+//#region src/parse/sdt.ts
+function parseSdtPr(sdt) {
+	return findChild(sdt, "w:sdtPr");
+}
+/** Parse block-level SDT (w:sdt in body or table cell) */
+function parseSdtContent(sdt, ctx) {
+	const sdtPr = parseSdtPr(sdt);
+	const sdtContent = findChild(sdt, "w:sdtContent");
+	if (!sdtContent) return sdtPr ? {
+		$type: "sdt",
+		sdtPr
+	} : void 0;
+	const content = [];
+	for (const child of sdtContent.elements ?? []) if (child.name === "w:p") content.push(parseParagraph(child, ctx));
+	else if (child.name === "w:tbl") content.push(parseTable(child, ctx));
+	else if (child.name === "w:sdt") {
+		const nested = parseSdtContent(child, ctx);
+		if (nested) content.push(nested);
+	}
+	const result = { $type: "sdt" };
+	if (sdtPr) result.sdtPr = sdtPr;
+	if (content.length > 0) result.content = content;
+	return result;
+}
+/** Parse inline-level SDT (w:sdt inside w:p) */
+function parseSdtRun(sdt, ctx) {
+	const sdtPr = parseSdtPr(sdt);
+	const sdtContent = findChild(sdt, "w:sdtContent");
+	if (!sdtContent) return sdtPr ? {
+		$type: "sdtRun",
+		sdtPr
+	} : void 0;
+	const content = [];
+	for (const child of sdtContent.elements ?? []) if (child.name === "w:r") {
+		const run = parseRun(child, ctx);
+		if (run) content.push(run);
+	} else if (child.name === "w:sdt") {
+		const nested = parseSdtRun(child, ctx);
+		if (nested) content.push(nested);
+	}
+	const result = { $type: "sdtRun" };
+	if (sdtPr) result.sdtPr = sdtPr;
+	if (content.length > 0) result.content = content;
+	return result;
+}
+//#endregion
 //#region src/parse/paragraph.ts
 function parseParagraph(p, ctx) {
 	const result = { $type: "paragraph" };
 	const pPr = findChild(p, "w:pPr");
 	if (pPr) parseParagraphProperties(pPr, result);
 	const children = [];
-	for (const child of p.elements ?? []) if (child.name === "w:r") {
-		const run = parseRun(child, ctx);
-		if (run) children.push(run);
-	} else if (child.name === "w:hyperlink") {
-		const hyperlink = parseHyperlink(child, ctx);
-		if (hyperlink) children.push(hyperlink);
-	} else if (child.name === "w:bookmarkStart") {
-		const name = attr(child, "w:name");
-		if (name) children.push({
-			$type: "bookmark",
-			name
+	const elements = p.elements ?? [];
+	let i = 0;
+	while (i < elements.length) {
+		const child = elements[i];
+		if (child.name === "w:r") {
+			const fldChar = findChild(child, "w:fldChar");
+			if (fldChar) {
+				const fldCharType = attr(fldChar, "w:fldCharType");
+				if (fldCharType === "begin") {
+					const field = collectField(elements, i, ctx);
+					if (field) children.push(field);
+					while (i < elements.length) {
+						const next = elements[i];
+						if (next.name === "w:r") {
+							const fc = findChild(next, "w:fldChar");
+							if (fc && attr(fc, "w:fldCharType") === "end") {
+								i++;
+								break;
+							}
+						}
+						i++;
+					}
+					continue;
+				}
+				if (fldCharType === "separate" || fldCharType === "end") {
+					i++;
+					continue;
+				}
+			}
+			const run = parseRun(child, ctx);
+			if (run) children.push(run);
+		} else if (child.name === "w:hyperlink") {
+			const hyperlink = parseHyperlink(child, ctx);
+			if (hyperlink) children.push(hyperlink);
+		} else if (child.name === "w:bookmarkStart") {
+			const name = attr(child, "w:name");
+			if (name) children.push({
+				$type: "bookmark",
+				name
+			});
+		} else if (child.name === "w:bookmarkEnd") {} else if (child.name === "w:sdt") {
+			const sdt = parseSdtRun(child, ctx);
+			if (sdt) children.push(sdt);
+			else children.push({
+				$raw: true,
+				element: child
+			});
+		} else if (child.name === "w:oMath" || child.name === "w:oMathPara") children.push({
+			$type: "math",
+			element: child
+		});
+		else if (child.name === "w:pPr") {} else children.push({
+			$raw: true,
+			element: child
 		});
+		i++;
 	}
-	if (children.length === 1 && children[0].$type === "textRun") {
-		const textRun = children[0];
+	const first = children[0];
+	if (children.length === 1 && !isRaw(first) && first.$type === "textRun") {
+		const textRun = first;
 		if (!Object.keys(textRun).some((k) => k !== "$type" && k !== "text") && textRun.text !== void 0) result.text = textRun.text;
 		else result.children = children;
 	} else if (children.length > 0) result.children = children;
@@ -24449,16 +24981,115 @@ function parseParagraphProperties(pPr, out) {
 	const shd = findChild(pPr, "w:shd");
 	if (shd) {
 		const fill = attr(shd, "w:fill");
-		if (fill && fill !== "auto") out.shading = { fill };
+		const val = attr(shd, "w:val");
+		if (fill && fill !== "auto") out.shading = {
+			fill,
+			...val && val !== "clear" && { type: val }
+		};
 	}
 	const pBdr = findChild(pPr, "w:pBdr");
 	if (pBdr) {
-		const bottom = findChild(pBdr, "w:bottom");
-		if (bottom) {
-			const val = attr(bottom, "w:val");
-			if (val && val !== "none" && val !== "nil") out.thematicBreak = true;
+		const borderSides = [
+			"top",
+			"bottom",
+			"left",
+			"right",
+			"between"
+		];
+		const borders = {};
+		let hasNonNoneBorder = false;
+		for (const side of borderSides) {
+			const borderEl = findChild(pBdr, `w:${side}`);
+			if (borderEl && borderEl.attributes && Object.keys(borderEl.attributes).length > 0) {
+				const val = String(attr(borderEl, "w:val") ?? "");
+				const sz = attrNum(borderEl, "w:sz");
+				const color = colorAttr(borderEl, "w:color");
+				const space = attrNum(borderEl, "w:space");
+				if (val && val !== "none" && val !== "nil") {
+					hasNonNoneBorder = true;
+					const borderDef = { style: val };
+					if (sz !== void 0) borderDef.size = sz;
+					if (color) borderDef.color = color;
+					if (space !== void 0) borderDef.space = space;
+					borders[side] = borderDef;
+				}
+			}
+		}
+		if (Object.keys(borders).length > 0) out.border = borders;
+		if (hasNonNoneBorder) out.thematicBreak = true;
+	}
+	const tabs = findChild(pPr, "w:tabs");
+	if (tabs) {
+		const tabList = [];
+		for (const tab of tabs.elements ?? []) if (tab.name === "w:tab") {
+			const pos = attrNum(tab, "w:pos");
+			const align = attr(tab, "w:val");
+			const leader = attr(tab, "w:leader");
+			if (pos !== void 0) tabList.push({
+				pos,
+				...align && align !== "left" && { align },
+				...leader && leader !== "none" && { leader }
+			});
+		}
+		if (tabList.length > 0) out.tabs = tabList;
+	}
+	const suppressLineNumbers = findChild(pPr, "w:suppressLineNumbers");
+	if (suppressLineNumbers) {
+		const val = attr(suppressLineNumbers, "w:val");
+		if (val === void 0 || val !== "0" && val !== "false") out.suppressLineNumbers = true;
+	}
+	const contextualSpacing = findChild(pPr, "w:contextualSpacing");
+	if (contextualSpacing) {
+		const val = attr(contextualSpacing, "w:val");
+		if (val === void 0 || val !== "0" && val !== "false") out.contextualSpacing = true;
+	}
+	const mirrorIndents = findChild(pPr, "w:mirrorIndents");
+	if (mirrorIndents) {
+		const val = attr(mirrorIndents, "w:val");
+		if (val === void 0 || val !== "0" && val !== "false") out.mirrorIndents = true;
+	}
+}
+/** Collect field code (begin → separate → end) into a FieldJson */
+function collectField(elements, startIndex, ctx) {
+	let instruction = "";
+	let locked = false;
+	let dirty = false;
+	const fieldChildren = [];
+	let pastSeparate = false;
+	for (let i = startIndex + 1; i < elements.length; i++) {
+		const el = elements[i];
+		if (el.name !== "w:r") continue;
+		const fldChar = findChild(el, "w:fldChar");
+		if (fldChar) {
+			const type = attr(fldChar, "w:fldCharType");
+			if (type === "end") break;
+			if (type === "separate") {
+				pastSeparate = true;
+				continue;
+			}
+		}
+		if (fldChar) {
+			const fldLock = findChild(el, "w:fldChar");
+			if (fldLock) {
+				if (attr(fldLock, "w:fldLock") === "true") locked = true;
+				if (attr(fldLock, "w:dirty") === "true") dirty = true;
+			}
+			continue;
+		}
+		if (!pastSeparate) {
+			const instrText = findChild(el, "w:instrText");
+			if (instrText) instruction += textOf(instrText);
+		} else {
+			const run = parseRun(el, ctx);
+			if (run) fieldChildren.push(run);
 		}
 	}
+	const field = { $type: "field" };
+	if (instruction) field.instruction = instruction;
+	if (locked) field.locked = true;
+	if (dirty) field.dirty = true;
+	if (fieldChildren.length > 0) field.children = fieldChildren;
+	return field;
 }
 function parseHyperlink(hl, ctx) {
 	const rid = attr(hl, "r:id");
@@ -24591,9 +25222,9 @@ function parseSectionProperties(sectPr) {
 		const borders = {};
 		for (const border of pgBorders.elements ?? []) if (border.name?.startsWith("w:")) {
 			const borderName = border.name?.replace("w:", "") ?? "";
-			const val = attr(border, "w:val");
+			const val = String(attr(border, "w:val") ?? "");
 			const sz = attrNum(border, "w:sz");
-			const color = attr(border, "w:color");
+			const color = colorAttr(border, "w:color");
 			if (val && val !== "none" && val !== "nil") {
 				const borderDef = { style: val };
 				if (sz !== void 0) borderDef.size = sz;
@@ -24609,92 +25240,116 @@ function parseSectionProperties(sectPr) {
 	return Object.keys(props).length > 0 ? props : void 0;
 }
 //#endregion
-//#region src/parse/table.ts
-function parseTable(tbl, ctx) {
-	const result = {
-		$type: "table",
-		rows: []
-	};
-	const tblPr = findChild(tbl, "w:tblPr");
-	if (tblPr) parseTableProperties(tblPr, result);
-	const rows = children(tbl, "w:tr");
-	for (const tr of rows) result.rows.push(parseTableRow(tr, ctx));
-	return result;
-}
-function parseTableProperties(tblPr, out) {
-	const tblW = findChild(tblPr, "w:tblW");
-	if (tblW) {
-		const size = attrNum(tblW, "w:w");
-		const type = attr(tblW, "w:type");
-		if (size !== void 0) out.width = {
-			size,
-			type: type ?? "auto"
-		};
+//#region src/parse/structural.ts
+/**
+* Parse footnotes.xml into FootnoteEntry[].
+*/
+function parseFootnotes(zip) {
+	const xml = readXmlFromZip(zip, "word/footnotes.xml");
+	if (!xml) return [];
+	const entries = [];
+	for (const child of xml.elements ?? []) if (child.name === "w:footnote") {
+		const id = attr(child, "w:id");
+		const type = getFootnoteType(child);
+		const children = parseNoteContent(child, zip, "footnote");
+		entries.push({
+			id: id ?? "",
+			...type && { type },
+			...children && { children }
+		});
 	}
-	const tblStyle = findChild(tblPr, "w:tblStyle");
-	if (tblStyle) {
-		const val = attr(tblStyle, "w:val");
-		if (val) out.style = val;
+	return entries;
+}
+/**
+* Parse endnotes.xml into FootnoteEntry[].
+*/
+function parseEndnotes(zip) {
+	const xml = readXmlFromZip(zip, "word/endnotes.xml");
+	if (!xml) return [];
+	const entries = [];
+	for (const child of xml.elements ?? []) if (child.name === "w:endnote") {
+		const id = attr(child, "w:id");
+		const type = getFootnoteType(child);
+		const children = parseNoteContent(child, zip, "endnote");
+		entries.push({
+			id: id ?? "",
+			...type && { type },
+			...children && { children }
+		});
 	}
-	const jc = findChild(tblPr, "w:jc");
-	if (jc) {
-		const val = attr(jc, "w:val");
-		if (val) out.alignment = val;
+	return entries;
+}
+/**
+* Parse comments.xml into CommentEntry[].
+*/
+function parseComments(zip) {
+	const xml = readXmlFromZip(zip, "word/comments.xml");
+	if (!xml) return [];
+	const entries = [];
+	for (const child of xml.elements ?? []) if (child.name === "w:comment") {
+		const id = attr(child, "w:id");
+		const author = attr(child, "w:author");
+		const date = attr(child, "w:date");
+		const initials = attr(child, "w:initials");
+		const children = [];
+		for (const p of child.elements ?? []) if (p.name === "w:p") children.push(parseParagraph(p, createNoteContext(zip)));
+		entries.push({
+			id: id ?? "",
+			...author && { author },
+			...date && { date },
+			...initials && { initials },
+			...children.length > 0 && { children }
+		});
 	}
+	return entries;
 }
-function parseTableRow(tr, ctx) {
-	const cells = [];
-	for (const child of tr.elements ?? []) if (child.name === "w:tc") cells.push(parseTableCell(child, ctx));
-	return { cells };
+function getFootnoteType(note) {
+	const type = attr(note, "w:type");
+	if (type === "separator") return "separator";
+	if (type === "continuationSeparator") return "continuationSeparator";
 }
-function parseTableCell(tc, ctx) {
-	const result = { children: [] };
-	const tcPr = findChild(tc, "w:tcPr");
-	if (tcPr) {
-		const gridSpan = findChild(tcPr, "w:gridSpan");
-		if (gridSpan) {
-			const val = attrNum(gridSpan, "w:val");
-			if (val !== void 0 && val > 1) result.columnSpan = val;
-		}
-		const vMerge = findChild(tcPr, "w:vMerge");
-		if (vMerge) {
-			if (attr(vMerge, "w:val") === "restart") {}
-		}
-		const tcW = findChild(tcPr, "w:tcW");
-		if (tcW) {
-			const size = attrNum(tcW, "w:w");
-			const type = attr(tcW, "w:type");
-			if (size !== void 0) result.width = {
-				size,
-				type: type ?? "auto"
-			};
-		}
-		const shd = findChild(tcPr, "w:shd");
-		if (shd) {
-			const fill = attr(shd, "w:fill");
-			if (fill && fill !== "auto") result.shading = { fill };
-		}
-		const vAlign = findChild(tcPr, "w:vAlign");
-		if (vAlign) {
-			const val = attr(vAlign, "w:val");
-			if (val) result.verticalAlign = val;
-		}
-	}
-	for (const child of tc.elements ?? []) if (child.name === "w:p") result.children.push(parseParagraph(child, ctx));
-	return result;
+function parseNoteContent(note, zip, _partType) {
+	const ctx = createNoteContext(zip);
+	const children = [];
+	for (const child of note.elements ?? []) if (child.name === "w:p") children.push(parseParagraph(child, ctx));
+	return children;
+}
+/** Create a minimal parse context for note parsing (no hyperlinks/media) */
+function createNoteContext(zip) {
+	return {
+		zip,
+		hyperlinks: /* @__PURE__ */ new Map(),
+		media: /* @__PURE__ */ new Map(),
+		documentRels: /* @__PURE__ */ new Map(),
+		mediaPaths: /* @__PURE__ */ new Set()
+	};
 }
 //#endregion
 //#region src/parse/document.ts
-async function parseDocx(data) {
+async function parseDocx(data, options) {
 	const zip = unzipToMap(data);
 	const ctx = createDocxParseContext(zip);
+	const includeRawParts = options?.includeRawParts !== false;
 	const coreProps = parseCoreProperties(zip);
 	const documentXml = readXmlFromZip(zip, "word/document.xml");
 	if (!documentXml) throw new Error("Invalid DOCX file: missing word/document.xml");
 	const body = findChild(documentXml, "w:body");
 	if (!body) throw new Error("Invalid DOCX file: missing w:body element");
+	const sections = parseBodySections(body, ctx);
+	resolveHeadersFooters(sections, ctx);
+	const numberingConfig = buildNumberingConfig(parseNumbering(zip), sections);
+	const footnotes = parseFootnotes(zip);
+	const endnotes = parseEndnotes(zip);
+	const comments = parseComments(zip);
+	let $parts;
+	if (includeRawParts) $parts = readAllXmlParts(zip, { skipPaths: ["word/document.xml"] });
 	return {
-		sections: parseBodySections(body, ctx),
+		sections,
+		...$parts && { $parts },
+		...numberingConfig.length > 0 && { numbering: numberingConfig },
+		...footnotes.length > 0 && { footnotes },
+		...endnotes.length > 0 && { endnotes },
+		...comments.length > 0 && { comments },
 		...coreProps.title && { title: coreProps.title },
 		...coreProps.subject && { subject: coreProps.subject },
 		...coreProps.creator && { creator: coreProps.creator },
@@ -24726,12 +25381,228 @@ function parseBodySections(body, ctx) {
 		}
 		currentChildren.push(parseParagraph(element, ctx));
 	} else if (element.name === "w:tbl") currentChildren.push(parseTable(element, ctx));
+	else if (element.name === "w:sdt") {
+		const sdt = parseSdtContent(element, ctx);
+		if (sdt) currentChildren.push(sdt);
+		else currentChildren.push({
+			$raw: true,
+			element
+		});
+	} else if (element.name === "w:oMath" || element.name === "w:oMathPara") currentChildren.push({
+		$type: "math",
+		element
+	});
+	else currentChildren.push({
+		$raw: true,
+		element
+	});
 	sections.push({
 		properties: finalSectPr ? parseSectionProperties(finalSectPr) : void 0,
 		children: currentChildren
 	});
 	return sections;
 }
+/** Resolve header/footer reference IDs to actual paragraph content */
+function resolveHeadersFooters(sections, ctx) {
+	for (const section of sections) {
+		const props = section.properties;
+		if (!props) continue;
+		const headerRefs = props.headerRefs;
+		const footerRefs = props.footerRefs;
+		if (headerRefs) {
+			section.headers = {};
+			for (const [type, rId] of Object.entries(headerRefs)) {
+				const content = parseHeaderFooterContent(rId, ctx);
+				if (content) section.headers[type] = { children: content };
+			}
+		}
+		if (footerRefs) {
+			section.footers = {};
+			for (const [type, rId] of Object.entries(footerRefs)) {
+				const content = parseHeaderFooterContent(rId, ctx);
+				if (content) section.footers[type] = { children: content };
+			}
+		}
+	}
+}
+function parseHeaderFooterContent(rId, ctx) {
+	const rel = ctx.documentRels.get(rId);
+	if (!rel) return void 0;
+	const path = rel.target.startsWith("../") ? rel.target.replace("../", "word/") : `word/${rel.target}`;
+	const xml = readXmlFromZip(ctx.zip, path);
+	if (!xml) return void 0;
+	const children = [];
+	for (const child of xml.elements ?? []) if (child.name === "w:p") children.push(parseParagraph(child, ctx));
+	else if (child.name === "w:tbl") children.push(parseTable(child, ctx));
+	return children.length > 0 ? children : void 0;
+}
+//#endregion
+//#region src/parse/convert.ts
+/**
+* Convert parsed section children to constructor-ready FileChild[].
+*/
+function toSectionChildren(children) {
+	return children.map(convertFileChild);
+}
+/**
+* Convert parsed paragraph children to constructor-ready ParagraphChild[].
+*/
+function toParagraphChildren(children) {
+	return children.map(convertParagraphChild);
+}
+/**
+* Convert parsed DocxDocumentJson to constructor-ready Document options.
+* Handles numbering, headers/footers, and all section properties.
+*/
+function toDocumentOptions(json) {
+	return {
+		...json.title && { title: json.title },
+		...json.creator && { creator: json.creator },
+		...json.subject && { subject: json.subject },
+		...json.description && { description: json.description },
+		...json.keywords && { keywords: json.keywords },
+		...json.lastModifiedBy && { lastModifiedBy: json.lastModifiedBy },
+		...json.revision && { revision: json.revision },
+		...json.numbering && json.numbering.length > 0 && { numbering: { config: json.numbering } },
+		sections: json.sections.map(convertSection)
+	};
+}
+function convertSection(section) {
+	const props = { ...section.properties };
+	delete props.headerRefs;
+	delete props.footerRefs;
+	const result = {
+		properties: props,
+		children: toSectionChildren(section.children)
+	};
+	if (section.headers) {
+		const headers = {};
+		for (const [type, content] of Object.entries(section.headers)) headers[type] = new Header({ children: toSectionChildren(content.children) });
+		result.headers = headers;
+	}
+	if (section.footers) {
+		const footers = {};
+		for (const [type, content] of Object.entries(section.footers)) footers[type] = new Footer({ children: toSectionChildren(content.children) });
+		result.footers = footers;
+	}
+	return result;
+}
+function convertFileChild(child) {
+	if (isRaw(child)) return new RawPassthrough(child.element);
+	switch (child.$type) {
+		case "paragraph": return convertParagraph(child);
+		case "table": return convertTable(child);
+		case "imageRun": return convertImageRun(child);
+		case "externalHyperlink": return convertExternalHyperlink(child);
+		case "pageBreak": return new PageBreak();
+		case "sdt": return convertSdt(child);
+		case "math": return new RawPassthrough(child.element);
+		default: return new RawPassthrough(child.element);
+	}
+}
+function convertParagraphChild(child) {
+	if (isRaw(child)) return new RawPassthrough(child.element);
+	switch (child.$type) {
+		case "textRun": return convertRun(child);
+		case "imageRun": return convertImageRun(child);
+		case "externalHyperlink": return convertExternalHyperlink(child);
+		case "pageBreak": return new PageBreak();
+		case "lineBreak": return new ColumnBreak();
+		case "columnBreak": return new ColumnBreak();
+		case "tab": return new Tab();
+		case "bookmark": return new RawPassthrough(child.element);
+		case "sdtRun": return convertSdtRun(child);
+		case "math": return new RawPassthrough(child.element);
+		case "field": return convertField(child);
+		default: return new RawPassthrough(child.element);
+	}
+}
+function convertParagraph(json) {
+	const { children, text, ...rest } = json;
+	const runs = children ? toParagraphChildren(children) : text ? [new Run({ text })] : void 0;
+	return new Paragraph({
+		...rest,
+		children: runs
+	});
+}
+function convertRun(json) {
+	const { underline, strike, doubleStrike, size, sizeCs, ...rest } = json;
+	return new Run({
+		...rest,
+		underline: convertUnderline(underline),
+		strike: strike ? true : void 0,
+		doubleStrike: doubleStrike ? true : void 0,
+		size,
+		sizeComplexScript: sizeCs
+	});
+}
+const EMU_PER_PIXEL = 9525;
+function convertImageRun(json) {
+	const { data, type, transformation, altText } = json;
+	const convertedTransform = transformation ? {
+		width: Math.round(transformation.width / EMU_PER_PIXEL),
+		height: Math.round(transformation.height / EMU_PER_PIXEL),
+		...transformation.flip && { flip: transformation.flip },
+		...transformation.offset && { offset: transformation.offset }
+	} : {
+		width: 100,
+		height: 100
+	};
+	return new ImageRun({
+		data: typeof data === "string" ? Uint8Array.from(atob(data), (c) => c.charCodeAt(0)) : data,
+		type,
+		transformation: convertedTransform,
+		altText
+	});
+}
+function convertExternalHyperlink(json) {
+	const { children, link, tooltip } = json;
+	return new ExternalHyperlink({
+		link,
+		tooltip,
+		children: children ? toParagraphChildren(children) : [new Run({ text: link })]
+	});
+}
+function convertSdt(json) {
+	return new RawPassthrough(json.element);
+}
+function convertSdtRun(json) {
+	return new RawPassthrough(json.element);
+}
+function convertField(json) {
+	const { instruction, children } = json;
+	const cachedText = children?.map((c) => {
+		if (c.$type === "textRun" && c.text) return c.text;
+	}).filter(Boolean).join("") ?? void 0;
+	return new SimpleField(instruction ?? "", cachedText);
+}
+function convertTable(json) {
+	const { rows, ...rest } = json;
+	return new Table({
+		...rest,
+		rows: rows.map(convertTableRow)
+	});
+}
+function convertTableRow(row) {
+	const { cells, height, ...rest } = row;
+	return new TableRow({
+		children: cells.map(convertTableCell),
+		...height && { height },
+		...rest
+	});
+}
+function convertTableCell(cell) {
+	const { children, ...rest } = cell;
+	return new TableCell({
+		...rest,
+		children: children ? toSectionChildren(children) : [new Paragraph({ text: "" })]
+	});
+}
+function convertUnderline(underline) {
+	if (!underline) return void 0;
+	if (typeof underline === "string") return { type: underline };
+	return underline;
+}
 //#endregion
 //#region src/index.ts
 var src_exports = /* @__PURE__ */ __exportAll({
@@ -25090,11 +25961,15 @@ var src_exports = /* @__PURE__ */ __exportAll({
 	getLayoutXml: () => getLayoutXml,
 	getStyleXml: () => getStyleXml,
 	hashedId: () => hashedId,
+	isRaw: () => isRaw,
 	parseDocx: () => parseDocx,
 	patchDetector: () => patchDetector,
 	patchDocument: () => patchDocument,
 	sectionMarginDefaults: () => sectionMarginDefaults,
 	sectionPageSizeDefaults: () => sectionPageSizeDefaults,
+	toDocumentOptions: () => toDocumentOptions,
+	toParagraphChildren: () => toParagraphChildren,
+	toSectionChildren: () => toSectionChildren,
 	uniqueId: () => uniqueId,
 	uniqueNumericIdCreator: () => uniqueNumericIdCreator,
 	uniqueUuid: () => uniqueUuid,
@@ -25103,6 +25978,6 @@ var src_exports = /* @__PURE__ */ __exportAll({
 __reExport(src_exports, file_exports);
 __reExport(src_exports, util_exports);
 //#endregion
-export { AbstractNumbering, AlignmentType, AltChunk, AltChunkCollection, AnnotationReference, Attributes, BaseXmlComponent, Bdo, Bibliography, Body, Bookmark, BookmarkEnd, BookmarkStart, Border, BorderStyle, BuilderElement, COLOR_CATEGORIES, CarriageReturn, CellMerge, CellMergeAttributes, CharacterSet, ChartCollection, ChartRun, ChartSpace, CheckBox, CheckBoxSymbolElement, CheckBoxUtil, Column, ColumnBreak, Comment, CommentRangeEnd, CommentRangeStart, CommentReference, Comments, ConcreteHyperlink, ConcreteNumbering, ContinuationSeparator, DEFAULT_DRAWING_XML, DayLong, DayShort, DeletedTableCell, DeletedTableRow, DeletedTextRun, Dir, File as Document, File, DocumentAttributeNamespaces, DocumentBackground, DocumentBackgroundAttributes, DocumentDefaults, DocumentGridType, Drawing, DropCapType, EMPTY_OBJECT, EditGroupType, EmphasisMarkType, EmptyElement, EndnoteIdReference, EndnoteReference, EndnoteReferenceRun, EndnoteReferenceRunAttributes, Endnotes, ExternalHyperlink, FootNoteReferenceRunAttributes, FootNotes, Footer, FooterWrapper, FootnoteReference, FootnoteReferenceElement, FootnoteReferenceRun, FormFieldTextType, FractionType, FrameAnchorType, FrameWrap, GridSpan, Header, HeaderFooterReferenceType, HeaderFooterType, HeaderWrapper, HeadingLevel, HeightRule, HighlightColor, HorizontalPositionAlign, HorizontalPositionRelativeFrom, HpsMeasureElement, HyperlinkType, IgnoreIfEmptyXmlComponent, ImageRun, ImportedRootElementAttributes, ImportedXmlComponent, InitializableXmlComponent, InsertedTableCell, InsertedTableRow, InsertedTextRun, InternalHyperlink, LAYOUT_CATEGORIES, LastRenderedPageBreak, LeaderType, Level, LevelBase, LevelForOverride, LevelFormat, LevelOverride, LevelSuffix, LineNumberRestartFormat, LineRuleType, Math$1 as Math, MathAngledBrackets, MathBorderBox, MathBox, MathCurlyBrackets, MathDegree, MathDenominator, MathEqArr, MathFraction, MathFunction, MathFunctionName, MathGroupChr, MathIntegral, MathLimit, MathLimitLower, MathLimitUpper, MathMatrix, MathNumerator, MathParagraph, MathPhant, MathPreSubSuperScript, MathRadical, MathRadicalProperties, MathRoundBrackets, MathRun, MathSquareBrackets, MathSubScript, MathSubSuperScript, MathSum, MathSuperScript, Media, MonthLong, MonthShort, MoveFromRangeEnd, MoveFromRangeStart, MoveToRangeEnd, MoveToRangeStart, MovedFromTextRun, MovedToTextRun, NextAttributeComponent, NoBreakHyphen, NumberFormat, NumberProperties, NumberValueElement, NumberedItemReference, NumberedItemReferenceFormat, Numbering, OnOffElement, OverlapType, Packer, PageBorderDisplay, PageBorderOffsetFrom, PageBorderZOrder, PageBorders, PageBreak, PageBreakBefore, PageNumber, PageNumberElement, PageNumberSeparator, PageOrientation, PageReference, PageTextDirection, PageTextDirectionType, Paragraph, ParagraphProperties, ParagraphPropertiesChange, ParagraphPropertiesDefaults, ParagraphRunProperties, PatchType, PermEnd, PermStart, PositionalTab, PositionalTabAlignment, PositionalTabLeader, PositionalTabRelativeTo, PrettifyType, RelativeHorizontalPosition, RelativeVerticalPosition, RubyAlign, Run, RunProperties, RunPropertiesChange, RunPropertiesDefaults, STYLE_CATEGORIES, SdtDateMappingType, SdtLock, SectionProperties, SectionPropertiesChange, SectionType, Separator, SequentialIdentifier, ShadingType, SimpleField, SimpleMailMergeField, SmartArtCollection, SmartArtRun, SoftHyphen, SpaceType, StringContainer, StringEnumValueElement, StringValueElement, StructuredDocumentTagBlock, StructuredDocumentTagCell, StructuredDocumentTagContent, StructuredDocumentTagProperties, StructuredDocumentTagRow, StructuredDocumentTagRun, StyleForCharacter, StyleForParagraph, StyleLevel, Styles, SubDoc, SubDocCollection, SymbolRun, TDirection, Tab, TabStopPosition, TabStopType, Table, TableAnchorType, TableBorders, TableCell, TableCellBorders, TableLayoutType, TableOfContents, TableProperties, TablePropertyExceptions, TableRow, TableRowProperties, TableRowPropertiesChange, TextAlignmentType, TextBodyWrappingType, TextDirection, TextEffect, TextHorzOverflowType, TextRun, TextVertOverflowType, TextVerticalType, TextWrappingSide, TextWrappingType, Textbox, TextboxTightWrapType, ThematicBreak, UnderlineType, VerticalAlign, VerticalAlignSection, VerticalAlignTable, VerticalAnchor, VerticalMerge, VerticalMergeRevisionType, VerticalMergeType, VerticalPositionAlign, VerticalPositionRelativeFrom, WORKAROUND2, WORKAROUND4, WidthType, WpgGroupRun, WpsShapeRun, XmlAttributeComponent, XmlComponent, YearLong, YearShort, abstractNumUniqueNumericIdGen, bookmarkUniqueNumericIdGen, buildDocumentAttributes, buildRunProperties, chartAttr, concreteNumUniqueNumericIdGen, convertInchesToTwip, convertMillimetersToTwip, convertToXmlComponent, createAlignment, createBodyProperties, createBorderElement, createBreak, createCnfStyle, createColumns, createDataModel, createDivId, createDocumentGrid, createDotEmphasisMark, createEmphasisMark, createFormFieldData, createFrameProperties, createHeaderFooterReference, createHorizontalPosition, createIndent, createLineNumberType, createMathAccent, createMathAccentCharacter, createMathAccentProperties, createMathBar, createMathBarProperties, createMathBase, createMathBorderBoxProperties, createMathBoxProperties, createMathControlProperties, createMathEqArrProperties, createMathFractionProperties, createMathFunctionProperties, createMathGroupChrProperties, createMathLimitLocation, createMathLimitLowProperties, createMathLimitUpperProperties, createMathMatrixProperties, createMathNAryProperties, createMathPhantProperties, createMathPreSubSuperScriptProperties, createMathProperties, createMathRunProperties, createMathSubScriptElement, createMathSubScriptProperties, createMathSubSuperScriptProperties, createMathSuperScriptElement, createMathSuperScriptProperties, createOutlineLevel, createPageMargin, createPageNumberType, createPageSize, createParagraphStyle, createRuby, createRunFonts, createSectionType, createShading, createSimplePos, createSpacing, createStringElement, createTabStop, createTabStopItem, createTableFloatProperties, createTableLayout, createTableLook, createTableOverlap, createTableRowHeight, createTableWidthElement, createTransformation, createUnderline, createVerticalAlign, createVerticalPosition, createWrapNone, createWrapSquare, createWrapThrough, createWrapTight, createWrapTopAndBottom, docPropertiesUniqueNumericIdGen, getColorXml, getLayoutXml, getStyleXml, hashedId, parseDocx, patchDetector, patchDocument, sectionMarginDefaults, sectionPageSizeDefaults, uniqueId, uniqueNumericIdCreator, uniqueUuid, wrapEl };
+export { AbstractNumbering, AlignmentType, AltChunk, AltChunkCollection, AnnotationReference, Attributes, BaseXmlComponent, Bdo, Bibliography, Body, Bookmark, BookmarkEnd, BookmarkStart, Border, BorderStyle, BuilderElement, COLOR_CATEGORIES, CarriageReturn, CellMerge, CellMergeAttributes, CharacterSet, ChartCollection, ChartRun, ChartSpace, CheckBox, CheckBoxSymbolElement, CheckBoxUtil, Column, ColumnBreak, Comment, CommentRangeEnd, CommentRangeStart, CommentReference, Comments, ConcreteHyperlink, ConcreteNumbering, ContinuationSeparator, DEFAULT_DRAWING_XML, DayLong, DayShort, DeletedTableCell, DeletedTableRow, DeletedTextRun, Dir, File as Document, File, DocumentAttributeNamespaces, DocumentBackground, DocumentBackgroundAttributes, DocumentDefaults, DocumentGridType, Drawing, DropCapType, EMPTY_OBJECT, EditGroupType, EmphasisMarkType, EmptyElement, EndnoteIdReference, EndnoteReference, EndnoteReferenceRun, EndnoteReferenceRunAttributes, Endnotes, ExternalHyperlink, FootNoteReferenceRunAttributes, FootNotes, Footer, FooterWrapper, FootnoteReference, FootnoteReferenceElement, FootnoteReferenceRun, FormFieldTextType, FractionType, FrameAnchorType, FrameWrap, GridSpan, Header, HeaderFooterReferenceType, HeaderFooterType, HeaderWrapper, HeadingLevel, HeightRule, HighlightColor, HorizontalPositionAlign, HorizontalPositionRelativeFrom, HpsMeasureElement, HyperlinkType, IgnoreIfEmptyXmlComponent, ImageRun, ImportedRootElementAttributes, ImportedXmlComponent, InitializableXmlComponent, InsertedTableCell, InsertedTableRow, InsertedTextRun, InternalHyperlink, LAYOUT_CATEGORIES, LastRenderedPageBreak, LeaderType, Level, LevelBase, LevelForOverride, LevelFormat, LevelOverride, LevelSuffix, LineNumberRestartFormat, LineRuleType, Math$1 as Math, MathAngledBrackets, MathBorderBox, MathBox, MathCurlyBrackets, MathDegree, MathDenominator, MathEqArr, MathFraction, MathFunction, MathFunctionName, MathGroupChr, MathIntegral, MathLimit, MathLimitLower, MathLimitUpper, MathMatrix, MathNumerator, MathParagraph, MathPhant, MathPreSubSuperScript, MathRadical, MathRadicalProperties, MathRoundBrackets, MathRun, MathSquareBrackets, MathSubScript, MathSubSuperScript, MathSum, MathSuperScript, Media, MonthLong, MonthShort, MoveFromRangeEnd, MoveFromRangeStart, MoveToRangeEnd, MoveToRangeStart, MovedFromTextRun, MovedToTextRun, NextAttributeComponent, NoBreakHyphen, NumberFormat, NumberProperties, NumberValueElement, NumberedItemReference, NumberedItemReferenceFormat, Numbering, OnOffElement, OverlapType, Packer, PageBorderDisplay, PageBorderOffsetFrom, PageBorderZOrder, PageBorders, PageBreak, PageBreakBefore, PageNumber, PageNumberElement, PageNumberSeparator, PageOrientation, PageReference, PageTextDirection, PageTextDirectionType, Paragraph, ParagraphProperties, ParagraphPropertiesChange, ParagraphPropertiesDefaults, ParagraphRunProperties, PatchType, PermEnd, PermStart, PositionalTab, PositionalTabAlignment, PositionalTabLeader, PositionalTabRelativeTo, PrettifyType, RelativeHorizontalPosition, RelativeVerticalPosition, RubyAlign, Run, RunProperties, RunPropertiesChange, RunPropertiesDefaults, STYLE_CATEGORIES, SdtDateMappingType, SdtLock, SectionProperties, SectionPropertiesChange, SectionType, Separator, SequentialIdentifier, ShadingType, SimpleField, SimpleMailMergeField, SmartArtCollection, SmartArtRun, SoftHyphen, SpaceType, StringContainer, StringEnumValueElement, StringValueElement, StructuredDocumentTagBlock, StructuredDocumentTagCell, StructuredDocumentTagContent, StructuredDocumentTagProperties, StructuredDocumentTagRow, StructuredDocumentTagRun, StyleForCharacter, StyleForParagraph, StyleLevel, Styles, SubDoc, SubDocCollection, SymbolRun, TDirection, Tab, TabStopPosition, TabStopType, Table, TableAnchorType, TableBorders, TableCell, TableCellBorders, TableLayoutType, TableOfContents, TableProperties, TablePropertyExceptions, TableRow, TableRowProperties, TableRowPropertiesChange, TextAlignmentType, TextBodyWrappingType, TextDirection, TextEffect, TextHorzOverflowType, TextRun, TextVertOverflowType, TextVerticalType, TextWrappingSide, TextWrappingType, Textbox, TextboxTightWrapType, ThematicBreak, UnderlineType, VerticalAlign, VerticalAlignSection, VerticalAlignTable, VerticalAnchor, VerticalMerge, VerticalMergeRevisionType, VerticalMergeType, VerticalPositionAlign, VerticalPositionRelativeFrom, WORKAROUND2, WORKAROUND4, WidthType, WpgGroupRun, WpsShapeRun, XmlAttributeComponent, XmlComponent, YearLong, YearShort, abstractNumUniqueNumericIdGen, bookmarkUniqueNumericIdGen, buildDocumentAttributes, buildRunProperties, chartAttr, concreteNumUniqueNumericIdGen, convertInchesToTwip, convertMillimetersToTwip, convertToXmlComponent, createAlignment, createBodyProperties, createBorderElement, createBreak, createCnfStyle, createColumns, createDataModel, createDivId, createDocumentGrid, createDotEmphasisMark, createEmphasisMark, createFormFieldData, createFrameProperties, createHeaderFooterReference, createHorizontalPosition, createIndent, createLineNumberType, createMathAccent, createMathAccentCharacter, createMathAccentProperties, createMathBar, createMathBarProperties, createMathBase, createMathBorderBoxProperties, createMathBoxProperties, createMathControlProperties, createMathEqArrProperties, createMathFractionProperties, createMathFunctionProperties, createMathGroupChrProperties, createMathLimitLocation, createMathLimitLowProperties, createMathLimitUpperProperties, createMathMatrixProperties, createMathNAryProperties, createMathPhantProperties, createMathPreSubSuperScriptProperties, createMathProperties, createMathRunProperties, createMathSubScriptElement, createMathSubScriptProperties, createMathSubSuperScriptProperties, createMathSuperScriptElement, createMathSuperScriptProperties, createOutlineLevel, createPageMargin, createPageNumberType, createPageSize, createParagraphStyle, createRuby, createRunFonts, createSectionType, createShading, createSimplePos, createSpacing, createStringElement, createTabStop, createTabStopItem, createTableFloatProperties, createTableLayout, createTableLook, createTableOverlap, createTableRowHeight, createTableWidthElement, createTransformation, createUnderline, createVerticalAlign, createVerticalPosition, createWrapNone, createWrapSquare, createWrapThrough, createWrapTight, createWrapTopAndBottom, docPropertiesUniqueNumericIdGen, getColorXml, getLayoutXml, getStyleXml, hashedId, isRaw, parseDocx, patchDetector, patchDocument, sectionMarginDefaults, sectionPageSizeDefaults, toDocumentOptions, toParagraphChildren, toSectionChildren, uniqueId, uniqueNumericIdCreator, uniqueUuid, wrapEl };
 
 //# sourceMappingURL=index.mjs.map