@office-open/docx 0.6.2 → 0.6.3

package/dist/index.mjs

@@ -2004,9 +2004,12 @@ var init_hyperlink = __esmMin((() => {
 	};
 	ConcreteHyperlink = class extends XmlComponent {
 		linkId;
-		constructor(children, relationshipId, anchor, tooltip, tgtFrame) {
+		constructor(children, relationshipId, options) {
 			super("w:hyperlink");
 			this.linkId = relationshipId;
+			const anchor = options?.anchor;
+			const tooltip = options?.tooltip;
+			const tgtFrame = options?.tgtFrame;
 			const props = {
 				anchor: anchor ? anchor : void 0,
 				history: 1,
@@ -2028,7 +2031,10 @@ var init_hyperlink = __esmMin((() => {
 	};
 	InternalHyperlink = class extends ConcreteHyperlink {
 		constructor(options) {
-			super(options.children, uniqueId(), options.anchor, options.tooltip);
+			super(options.children, uniqueId(), {
+				anchor: options.anchor,
+				tooltip: options.tooltip
+			});
 		}
 	};
 	ExternalHyperlink = class extends XmlComponent {
@@ -6358,7 +6364,7 @@ var init_paragraph$1 = __esmMin((() => {
 			}
 			if (this.options.children) for (const rawChild of this.options.children) {
 				if (rawChild instanceof ExternalHyperlink) {
-					const concreteHyperlink = new ConcreteHyperlink(rawChild.options.children, uniqueId());
+					const concreteHyperlink = new ConcreteHyperlink(rawChild.options.children, uniqueId(), { tooltip: rawChild.options.tooltip });
 					context.viewWrapper.Relationships.addRelationship(concreteHyperlink.linkId, "http://schemas.openxmlformats.org/officeDocument/2006/relationships/hyperlink", rawChild.options.link, TargetModeType.EXTERNAL);
 					const obj = concreteHyperlink.prepForXml(context);
 					if (obj) children.push(obj);
@@ -6383,14 +6389,17 @@ var init_paragraph$1 = __esmMin((() => {
 				else if ("image" in rawChild) child = new ImageRun(rawChild.image);
 				else if (typeof rawChild === "object" && rawChild !== null && "hyperlink" in rawChild) {
 					const { hyperlink, ...runOpts } = rawChild;
-					const textRun = new TextRun(runOpts);
+					const hlChildren = hyperlink.children;
+					const textRuns = [];
+					if (hlChildren && hlChildren.length > 0) for (const rc of hlChildren) textRuns.push(new TextRun(rc));
+					else textRuns.push(new TextRun(runOpts));
 					if ("link" in hyperlink) {
 						const ext = new ExternalHyperlink({
 							link: hyperlink.link,
 							tooltip: hyperlink.tooltip,
-							children: [textRun]
+							children: textRuns
 						});
-						const concrete = new ConcreteHyperlink(ext.options.children, uniqueId());
+						const concrete = new ConcreteHyperlink(ext.options.children, uniqueId(), { tooltip: ext.options.tooltip });
 						context.viewWrapper.Relationships.addRelationship(concrete.linkId, "http://schemas.openxmlformats.org/officeDocument/2006/relationships/hyperlink", ext.options.link, TargetModeType.EXTERNAL);
 						const obj = concrete.prepForXml(context);
 						if (obj) children.push(obj);
@@ -6398,7 +6407,7 @@ var init_paragraph$1 = __esmMin((() => {
 						const obj = new InternalHyperlink({
 							anchor: hyperlink.anchor,
 							tooltip: hyperlink.tooltip,
-							children: [textRun]
+							children: textRuns
 						}).prepForXml(context);
 						if (obj) children.push(obj);
 					}
@@ -6414,7 +6423,15 @@ var init_paragraph$1 = __esmMin((() => {
 				else if ("commentRangeStart" in rawChild) child = new CommentRangeStart(rawChild.commentRangeStart);
 				else if ("commentRangeEnd" in rawChild) child = new CommentRangeEnd(rawChild.commentRangeEnd);
 				else if ("commentReference" in rawChild) child = new TextRun({ children: [new CommentReference(rawChild.commentReference)] });
-				else if ("insertion" in rawChild) child = new InsertedTextRun(rawChild.insertion);
+				else if ("bookmarkStart" in rawChild) {
+					const startObj = new BookmarkStart(rawChild.bookmarkStart.name, rawChild.bookmarkStart.id).prepForXml(context);
+					if (startObj) children.push(startObj);
+					continue;
+				} else if ("bookmarkEnd" in rawChild) {
+					const endObj = new BookmarkEnd(rawChild.bookmarkEnd).prepForXml(context);
+					if (endObj) children.push(endObj);
+					continue;
+				} else if ("insertion" in rawChild) child = new InsertedTextRun(rawChild.insertion);
 				else if ("deletion" in rawChild) child = new DeletedTextRun(rawChild.deletion);
 				else child = new TextRun(rawChild);
 				const obj = child.prepForXml(context);
@@ -15857,7 +15874,7 @@ const patchDocument = async ({ outputType, data, patches, keepOriginalStyles, pl
 							...patchValue,
 							children: patchValue.children.map((element) => {
 								if (element instanceof ExternalHyperlink) {
-									const concreteHyperlink = new ConcreteHyperlink(element.options.children, uniqueId());
+									const concreteHyperlink = new ConcreteHyperlink(element.options.children, uniqueId(), { tooltip: element.options.tooltip });
 									hyperlinkRelationshipAdditions.push({
 										hyperlink: {
 											id: concreteHyperlink.linkId,
@@ -15986,916 +16003,941 @@ const findPatchKeys = (text) => {
 	return text.match(/(?<=\{\{).+?(?=\}\})/gs) ?? [];
 };
 //#endregion
-//#region src/file/alt-chunk/alt-chunk-parse.ts
+//#region src/file/paragraph/run/run-parse.ts
 /**
-* AltChunk parser for DOCX documents.
+* Run properties parser for DOCX documents.
 *
-* Parses w:altChunk elements and extracts embedded content from the ZIP.
+* Parses w:rPr Element trees into RunPropertiesOptions objects.
 *
 * @module
 */
 /**
-* Parse a w:altChunk element into AltChunkOptions.
-* Reads the referenced data from the ZIP package.
+* Parse a w:rPr element into RunPropertiesOptions.
 */
-function parseAltChunk(el, ctx) {
-	const rId = attr(el, "r:id");
-	if (!rId) throw new Error("w:altChunk missing r:id attribute");
-	const path = ctx.docx.partRefs.afChunks.get(rId);
-	if (!path) throw new Error(`AltChunk relationship ${rId} not found`);
-	const data = ctx.docx.doc.getRaw(path);
-	if (!data) throw new Error(`AltChunk data not found at ${path}`);
-	const ext = path.split(".").pop() ?? "txt";
-	let contentType;
-	let extension;
-	switch (ext) {
-		case "html":
-			contentType = "text/html";
-			extension = "html";
-			break;
-		case "rtf":
-			contentType = "application/rtf";
-			extension = "rtf";
-			break;
-		default:
-			contentType = "text/plain";
-			extension = "txt";
-			break;
+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;
+		}
 	}
-	return {
-		data,
-		contentType,
-		extension
-	};
+	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 italics = findChild(el, "w:i");
+	if (italics) opts.italics = attrBool(italics, "w:val") ?? true;
+	const italicsCs = findChild(el, "w:iCs");
+	if (italicsCs) opts.italicsComplexScript = attrBool(italicsCs, "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:math", "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");
+		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;
+	}
+	const szCs = findChild(el, "w:szCs");
+	if (szCs) {
+		const halfPts = attrNum(szCs, "w:val");
+		if (halfPts !== void 0) opts.sizeComplexScript = halfPts;
+	}
+	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.val = val;
+		const eastAsia = attr(lang, "w:eastAsia");
+		if (eastAsia) langObj.eastAsia = eastAsia;
+		const bidi = attr(lang, "w:bidi");
+		if (bidi) langObj.bidi = 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);
+	return opts;
 }
-//#endregion
-//#region src/file/drawing/drawing-parse.ts
 /**
-* Drawing parser for DOCX documents.
-*
-* Parses w:drawing elements and extracts image, chart, or SmartArt data.
-*
-* @module
+* Parse a w:bdr element into BorderOptions.
 */
+function parseBorder(el) {
+	const opts = {};
+	const style = attr(el, "w:val");
+	if (style) opts.style = style;
+	const color = colorAttr(el, "w:color");
+	if (color) opts.color = color;
+	const size = attrNum(el, "w:sz");
+	if (size !== void 0) opts.size = size;
+	const space = attrNum(el, "w:space");
+	if (space !== void 0) opts.space = space;
+	const shadow = attrBool(el, "w:shadow");
+	if (shadow !== void 0) opts.shadow = shadow;
+	const frame = attrBool(el, "w:frame");
+	if (frame !== void 0) opts.frame = frame;
+	return opts;
+}
 /**
-* Parse a w:drawing element and dispatch to the correct parser
-* based on the graphicData URI.
+* Parse a w:shd element into ShadingAttributesProperties.
 */
-function parseDrawingRun(el, ctx) {
-	const graphicData = findDeep(el, "a:graphicData")[0];
-	if (!graphicData) return void 0;
-	const uri = attr(graphicData, "uri") ?? "";
-	if (uri.includes("/chart")) return parseChartDrawing(el, ctx);
-	if (uri.includes("/diagram")) return parseSmartArtDrawing(el, ctx);
-	return parseImageRun(el, ctx);
+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;
 }
+/** 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");
 /**
-* Determine image type from file extension or MIME type.
+* Parse a w:r element into run data.
+* Returns { properties, children } where children are parsed run content items.
 */
-function imageTypeFromPath(path) {
-	switch (path.split(".").pop()?.toLowerCase() ?? "") {
-		case "jpg":
-		case "jpeg": return "jpg";
-		case "png": return "png";
-		case "gif": return "gif";
-		case "bmp": return "bmp";
-		case "tif":
-		case "tiff": return "tif";
-		case "ico": return "ico";
-		case "emf": return "emf";
-		case "wmf": return "wmf";
-		default: return "png";
-	}
-}
-/**
-* Parse a w:drawing element and return image data wrapped in { image: ... }.
-*/
-function parseImageRun(el, ctx) {
-	const inline = findDeep(el, "wp:inline")[0];
-	const anchor = inline ? void 0 : findDeep(el, "wp:anchor")[0];
-	const parent = inline ?? anchor;
-	if (!parent) return void 0;
-	const extent = findChild(parent, "wp:extent");
-	let width;
-	let height;
-	if (extent) {
-		const cxEmu = attrNum(extent, "cx");
-		const cyEmu = attrNum(extent, "cy");
-		if (cxEmu !== void 0) width = convertEmuToPixels(cxEmu);
-		if (cyEmu !== void 0) height = convertEmuToPixels(cyEmu);
-	}
-	const blip = findDeep(parent, "a:blip")[0];
-	if (!blip) return void 0;
-	const rEmbed = attr(blip, "r:embed");
-	if (!rEmbed) return void 0;
-	const mediaPath = ctx.docx.partRefs.media.get(rEmbed);
-	if (!mediaPath) return void 0;
-	const imageData = ctx.docx.doc.getRaw(mediaPath);
-	if (!imageData) return void 0;
-	const imageOpts = {
-		type: imageTypeFromPath(mediaPath),
-		data: imageData,
-		transformation: {
-			...width !== void 0 ? { width } : {},
-			...height !== void 0 ? { height } : {}
-		}
-	};
-	const docPr = findChild(parent, "wp:docPr");
-	if (docPr) {
-		const name = attr(docPr, "name");
-		const descr = attr(docPr, "descr");
-		if (name || descr) imageOpts.altText = {
-			...name ? { name } : {},
-			...descr ? { description: descr } : {}
-		};
-	}
-	if (anchor && !inline) {
-		const floating = {};
-		const posH = findChild(anchor, "wp:positionH");
-		if (posH) {
-			const align = findChild(posH, "wp:align");
-			const posOffset = findChild(posH, "wp:posOffset");
-			if (align) floating.horizontalPosition = { align: textOf(align) };
-			else if (posOffset) floating.horizontalPosition = { offset: attrNum(posOffset, "offset") ?? 0 };
+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;
 		}
-		const posV = findChild(anchor, "wp:positionV");
-		if (posV) {
-			const align = findChild(posV, "wp:align");
-			const posOffset = findChild(posV, "wp:posOffset");
-			if (align) floating.verticalPosition = { align: textOf(align) };
-			else if (posOffset) floating.verticalPosition = { offset: attrNum(posOffset, "offset") ?? 0 };
+		case "w:br": {
+			const brType = attr(child, "w:type");
+			if (brType === "page") children.push(PARSED_PAGE_BREAK);
+			else if (brType === "column") children.push(PARSED_PAGE_BREAK);
+			else children.push(PARSED_LINE_BREAK);
+			break;
 		}
-		for (const wrapType of [
-			"wrapSquare",
-			"wrapTight",
-			"wrapTopAndBottom",
-			"wrapNone"
-		]) if (findChild(anchor, `wp:${wrapType}`)) {
-			floating.wrap = wrapType;
+		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;
 		}
-		if (attrBool(anchor, "behindDoc")) floating.behindDocument = true;
-		if (Object.keys(floating).length > 0) imageOpts.floating = floating;
+		case "w:drawing":
+		case "w:pict": break;
+		case "w:footnoteReference":
+		case "w:endnoteReference": break;
+		default:
+			if (child.name && child.elements && child.elements.length > 0) children.push(new RawPassthrough(child));
+			break;
 	}
-	return { image: imageOpts };
-}
-function getDrawingExtent(el) {
-	const inline = findDeep(el, "wp:inline")[0];
-	const anchor = inline ? void 0 : findDeep(el, "wp:anchor")[0];
-	const parent = inline ?? anchor;
-	if (!parent) return {};
-	const extent = findChild(parent, "wp:extent");
-	if (!extent) return {};
-	const cxEmu = attrNum(extent, "cx");
-	const cyEmu = attrNum(extent, "cy");
 	return {
-		...cxEmu !== void 0 ? { width: convertEmuToPixels(cxEmu) } : {},
-		...cyEmu !== void 0 ? { height: convertEmuToPixels(cyEmu) } : {}
+		properties,
+		children
 	};
 }
 /**
-* Look up a relationship ID in a map, with fallback for double "rId" prefix
-* that the library's generation code produces (e.g. "rIdrId7" → "rId7").
+* 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.
 */
-function lookupRId(map, rId) {
-	if (!rId) return void 0;
-	const direct = map.get(rId);
-	if (direct) return direct;
-	if (rId.startsWith("rIdrId")) return map.get(rId.slice(3));
-}
-function parseChartDrawing(el, ctx) {
-	const chartRef = findDeep(el, "c:chart")[0];
-	if (!chartRef) return void 0;
-	const rId = attr(chartRef, "r:id");
-	const chartPath = lookupRId(ctx.docx.partRefs.charts, rId);
-	if (!chartPath) return void 0;
-	const chartXml = ctx.docx.doc.get(chartPath);
-	if (!chartXml) return void 0;
-	const opts = parseChartXml(chartXml);
-	if (!opts) return void 0;
-	const ext = getDrawingExtent(el);
-	if (ext.width !== void 0 || ext.height !== void 0) opts.transformation = { ...ext };
-	return { chart: opts };
+function parsedRunToOptions(parsed) {
+	const opts = { ...parsed.properties };
+	const commentRefs = parsed.children.filter((c) => typeof c === "object" && c !== null && "commentReference" in c);
+	const nonCommentChildren = parsed.children.filter((c) => !(typeof c === "object" && c !== null && "commentReference" in c));
+	if (commentRefs.length > 0 && nonCommentChildren.length === 0 && !parsed.properties) return commentRefs[0];
+	const textParts = [];
+	let breakCount = 0;
+	for (const child of nonCommentChildren) if (typeof child === "string") textParts.push(child);
+	else if (child === PARSED_LINE_BREAK) breakCount++;
+	if (textParts.length > 0) opts.text = textParts.join("");
+	if (breakCount > 0) opts.break = breakCount;
+	return opts;
 }
+//#endregion
+//#region src/file/paragraph/paragraph-parse.ts
 /**
-* Parse c:chartSpace element into ChartOptions.
+* Paragraph parser for DOCX documents.
+*
+* Parses w:p and w:pPr Element trees into ParagraphOptions objects.
+*
+* @module
 */
-function parseChartXml(el) {
-	const chart = findChild(el, "c:chart");
-	if (!chart) return void 0;
+init_style();
+init_math_parse();
+const HEADING_MAP = {
+	Heading1: HeadingLevel.HEADING_1,
+	Heading2: HeadingLevel.HEADING_2,
+	Heading3: HeadingLevel.HEADING_3,
+	Heading4: HeadingLevel.HEADING_4,
+	Heading5: HeadingLevel.HEADING_5,
+	Heading6: HeadingLevel.HEADING_6,
+	Title: HeadingLevel.TITLE
+};
+/**
+* Parse w:pPr element into paragraph properties (without children).
+*/
+function parseParagraphProperties(el, _ctx) {
 	const opts = {};
-	const titleEl = findChild(chart, "c:title");
-	if (titleEl) {
-		const rich = findDeep(titleEl, "c:rich")[0];
-		if (rich) {
-			const t = findDeep(rich, "a:t")[0];
-			if (t) {
-				const title = textOf(t);
-				if (title) opts.title = title;
-			}
-		}
-	}
-	const plotArea = findChild(chart, "c:plotArea");
-	if (!plotArea) return void 0;
-	let chartType;
-	let typeElement;
-	for (const child of plotArea.elements ?? []) {
-		switch (child.name) {
-			case "c:barChart": {
-				const barDir = findChild(child, "c:barDir");
-				chartType = barDir && attr(barDir, "val") === "bar" ? "bar" : "column";
-				typeElement = child;
-				break;
-			}
-			case "c:lineChart":
-				chartType = "line";
-				typeElement = child;
-				break;
-			case "c:pieChart":
-				chartType = "pie";
-				typeElement = child;
-				break;
-			case "c:areaChart":
-				chartType = "area";
-				typeElement = child;
-				break;
-			case "c:scatterChart":
-				chartType = "scatter";
-				typeElement = child;
-				break;
-		}
-		if (chartType) break;
+	const pStyle = findChild(el, "w:pStyle");
+	if (pStyle) {
+		const styleVal = attr(pStyle, "w:val");
+		if (styleVal) if (HEADING_MAP[styleVal]) opts.heading = HEADING_MAP[styleVal];
+		else opts.style = styleVal;
 	}
-	if (!chartType || !typeElement) return void 0;
-	opts.type = chartType;
-	const series = [];
-	let categories;
-	for (const serEl of typeElement.elements ?? []) {
-		if (serEl.name !== "c:ser") continue;
-		const nameParts = extractStrCache(serEl, "c:tx");
-		const cats = extractStrCache(serEl, "c:cat");
-		if (cats.length > 0 && !categories) categories = cats;
-		const vals = extractNumCache(serEl);
-		series.push({
-			name: nameParts[0] ?? "",
-			values: vals
-		});
+	const jc = findChild(el, "w:jc");
+	if (jc) {
+		const val = attr(jc, "w:val");
+		if (val) opts.alignment = val;
 	}
-	opts.data = {
-		categories: categories ?? [],
-		series
-	};
-	opts.showLegend = findChild(chart, "c:legend") !== void 0;
-	const styleEl = findChild(el, "c:style");
-	if (styleEl) {
-		const val = attrNum(styleEl, "val");
-		if (val !== void 0) opts.style = val;
-	}
-	return opts;
-}
-/**
-* Extract string values from c:strCache within a container element.
-*/
-function extractStrCache(parent, containerName) {
-	const container = findChild(parent, containerName);
-	if (!container) return [];
-	const cache = findDeep(container, "c:strCache")[0];
-	if (!cache) return [];
-	const values = [];
-	for (const pt of cache.elements ?? []) {
-		if (pt.name !== "c:pt") continue;
-		const v = findChild(pt, "c:v");
-		if (v) values.push(textOf(v) ?? "");
-	}
-	return values;
-}
-/**
-* Extract numeric values from c:numCache within a c:val container.
-*/
-function extractNumCache(parent) {
-	const valEl = findChild(parent, "c:val");
-	if (!valEl) return [];
-	const cache = findDeep(valEl, "c:numCache")[0];
-	if (!cache) return [];
-	const values = [];
-	for (const pt of cache.elements ?? []) {
-		if (pt.name !== "c:pt") continue;
-		const v = findChild(pt, "c:v");
-		if (v) {
-			const num = Number(textOf(v));
-			if (!isNaN(num)) values.push(num);
-		}
-	}
-	return values;
-}
-function parseSmartArtDrawing(el, ctx) {
-	const relIds = findDeep(el, "dgm:relIds")[0];
-	if (!relIds) return void 0;
-	const rId = attr(relIds, "r:dm");
-	const dataPath = lookupRId(ctx.docx.partRefs.diagramData, rId);
-	if (!dataPath) return void 0;
-	const dataEl = ctx.docx.doc.get(dataPath);
-	if (!dataEl) return void 0;
-	const opts = parseSmartArtDataXml(dataEl);
-	if (!opts) return void 0;
-	const ext = getDrawingExtent(el);
-	if (ext.width !== void 0 || ext.height !== void 0) opts.transformation = { ...ext };
-	return { smartArt: opts };
-}
-/**
-* Parse dgm:dataModel element into SmartArtOptions.
-*/
-function parseSmartArtDataXml(el) {
-	const ptLst = findChild(el, "dgm:ptLst");
-	if (!ptLst) return void 0;
-	const opts = {};
-	const nodeMap = /* @__PURE__ */ new Map();
-	for (const pt of ptLst.elements ?? []) {
-		if (pt.name !== "dgm:pt") continue;
-		const type = attr(pt, "type");
-		const modelId = attr(pt, "modelId");
-		if (type === "doc") {
-			const prSet = findChild(pt, "dgm:prSet");
-			if (prSet) {
-				const loTypeId = attr(prSet, "loTypeId") ?? "";
-				const qsTypeId = attr(prSet, "qsTypeId") ?? "";
-				const csTypeId = attr(prSet, "csTypeId") ?? "";
-				const layout = loTypeId.split("/").pop();
-				if (layout) opts.layout = layout;
-				const style = qsTypeId.split("/").pop();
-				if (style) opts.style = style;
-				const color = csTypeId.split("/").pop();
-				if (color) opts.color = color;
-			}
-		} else if (type === "node" && modelId) {
-			const t = findDeep(pt, "a:t")[0];
-			nodeMap.set(modelId, t ? textOf(t) ?? "" : "");
-		}
+	const spacing = findChild(el, "w:spacing");
+	if (spacing) {
+		const sp = {};
+		const before = attrNum(spacing, "w:before");
+		if (before !== void 0) sp.before = before;
+		const after = attrNum(spacing, "w:after");
+		if (after !== void 0) sp.after = after;
+		const line = attrNum(spacing, "w:line");
+		if (line !== void 0) sp.line = line;
+		const lineRule = attr(spacing, "w:lineRule");
+		if (lineRule) sp.lineRule = lineRule;
+		const beforeAuto = attrBool(spacing, "w:beforeAutospacing") ?? attrBool(spacing, "w:beforeLines");
+		if (beforeAuto !== void 0) sp.beforeAutoSpacing = beforeAuto;
+		const afterAuto = attrBool(spacing, "w:afterAutospacing") ?? attrBool(spacing, "w:afterLines");
+		if (afterAuto !== void 0) sp.afterAutoSpacing = afterAuto;
+		if (Object.keys(sp).length > 0) opts.spacing = sp;
 	}
-	const cxnLst = findChild(el, "dgm:cxnLst");
-	if (!cxnLst) {
-		opts.data = { nodes: [] };
-		return opts;
+	const ind = findChild(el, "w:ind");
+	if (ind) {
+		const indentObj = {};
+		const left = attrNum(ind, "w:left");
+		if (left !== void 0) indentObj.left = left;
+		const right = attrNum(ind, "w:right");
+		if (right !== void 0) indentObj.right = right;
+		const start = attrNum(ind, "w:start");
+		if (start !== void 0) indentObj.start = start;
+		const end = attrNum(ind, "w:end");
+		if (end !== void 0) indentObj.end = end;
+		const hanging = attrNum(ind, "w:hanging");
+		if (hanging !== void 0) indentObj.hanging = hanging;
+		const firstLine = attrNum(ind, "w:firstLine");
+		if (firstLine !== void 0) indentObj.firstLine = firstLine;
+		if (Object.keys(indentObj).length > 0) opts.indent = indentObj;
 	}
-	const childrenMap = /* @__PURE__ */ new Map();
-	for (const cxn of cxnLst.elements ?? []) {
-		if (cxn.name !== "dgm:cxn") continue;
-		const srcId = attr(cxn, "srcId");
-		const destId = attr(cxn, "destId");
-		if (!srcId || !destId || !nodeMap.has(destId)) continue;
-		let arr = childrenMap.get(srcId);
-		if (!arr) {
-			arr = [];
-			childrenMap.set(srcId, arr);
-		}
-		arr.push(destId);
+	const numPr = findChild(el, "w:numPr");
+	if (numPr) {
+		const ilvl = findChild(numPr, "w:ilvl");
+		opts.bullet = { level: ilvl ? attrNum(ilvl, "w:val") ?? 0 : 0 };
 	}
-	opts.data = { nodes: (childrenMap.get("0") ?? []).map((id) => buildSmartArtNode(id, nodeMap, childrenMap)) };
-	return opts;
-}
-function buildSmartArtNode(id, nodeMap, childrenMap) {
-	const text = nodeMap.get(id) ?? "";
-	const childIds = childrenMap.get(id) ?? [];
-	if (childIds.length === 0) return { text };
-	return {
-		text,
-		children: childIds.map((cid) => buildSmartArtNode(cid, nodeMap, childrenMap))
-	};
-}
-//#endregion
-//#region src/file/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 tabs = findChild(el, "w:tabs");
+	if (tabs) {
+		const tabStops = [];
+		for (const tab of children(tabs, "w:tab")) {
+			const tabObj = {};
+			const pos = attrNum(tab, "w:pos");
+			if (pos !== void 0) tabObj.position = pos;
+			const val = attr(tab, "w:val");
+			if (val) tabObj.type = val;
+			const leader = attr(tab, "w:leader");
+			if (leader) tabObj.leader = leader;
+			tabStops.push(tabObj);
 		}
-	}
-	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 italics = findChild(el, "w:i");
-	if (italics) opts.italics = attrBool(italics, "w:val") ?? true;
-	const italicsCs = findChild(el, "w:iCs");
-	if (italicsCs) opts.italicsComplexScript = attrBool(italicsCs, "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;
+		if (tabStops.length > 0) opts.tabStops = tabStops;
 	}
 	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:keepNext", "keepNext"],
+		["w:keepLines", "keepLines"],
+		["w:pageBreakBefore", "pageBreakBefore"],
+		["w:widowControl", "widowControl"],
+		["w:suppressLineNumbers", "suppressLineNumbers"],
+		["w:contextualSpacing", "contextualSpacing"],
+		["w:bidi", "bidirectional"],
+		["w:wordWrap", "wordWrap"],
+		["w:suppressAutoHyphens", "suppressAutoHyphens"],
+		["w:adjustRightInd", "adjustRightInd"],
 		["w:snapToGrid", "snapToGrid"],
-		["w:smallCaps", "smallCaps"],
-		["w:caps", "allCaps"],
-		["w:rtl", "rightToLeft"],
-		["w:cs", "complexScript"],
-		["w:specVanish", "specVanish"],
-		["w:math", "math"]
+		["w:mirrorIndents", "mirrorIndents"],
+		["w:kinsoku", "kinsoku"],
+		["w:topLinePunct", "topLinePunct"],
+		["w:autoSpaceDE", "autoSpaceDE"],
+		["w:overflowPunct", "overflowPunctuation"],
+		["w:suppressOverlap", "suppressOverlap"]
 	]) {
 		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");
-		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;
-	}
-	const szCs = findChild(el, "w:szCs");
-	if (szCs) {
-		const halfPts = attrNum(szCs, "w:val");
-		if (halfPts !== void 0) opts.sizeComplexScript = halfPts;
-	}
-	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;
+	if (findChild(el, "w:pBdr")) {
+		const pBdr = findChild(el, "w:pBdr");
+		const border = {};
+		for (const side of [
+			"top",
+			"bottom",
+			"left",
+			"right"
+		]) {
+			const sideEl = findChild(pBdr, `w:${side}`);
+			if (sideEl) {
+				const sideOpts = {};
+				const style = attr(sideEl, "w:val");
+				if (style) sideOpts.style = style;
+				const color = attr(sideEl, "w:color");
+				if (color) sideOpts.color = color;
+				const size = attrNum(sideEl, "w:sz");
+				if (size !== void 0) sideOpts.size = size;
+				const space = attrNum(sideEl, "w:space");
+				if (space !== void 0) sideOpts.space = space;
+				border[side] = sideOpts;
+			}
+		}
+		if (Object.keys(border).length > 0) opts.border = border;
 	}
-	const kern = findChild(el, "w:kern");
-	if (kern) {
-		const val = attrNum(kern, "w:val");
-		if (val !== void 0) opts.kern = val;
+	const shd = findChild(el, "w:shd");
+	if (shd) {
+		const shdObj = {};
+		const fill = attr(shd, "w:fill");
+		if (fill) shdObj.fill = fill;
+		const color = attr(shd, "w:color");
+		if (color) shdObj.color = color;
+		const val = attr(shd, "w:val");
+		if (val) shdObj.type = val;
+		if (Object.keys(shdObj).length > 0) opts.shading = shdObj;
 	}
-	const position = findChild(el, "w:position");
-	if (position) {
-		const val = attr(position, "w:val");
-		if (val !== void 0) opts.position = val;
+	const textAlignment = findChild(el, "w:textAlignment");
+	if (textAlignment) {
+		const val = attr(textAlignment, "w:val");
+		if (val) opts.textAlignment = val;
 	}
-	const fitText = findChild(el, "w:fitText");
-	if (fitText) {
-		const val = attrNum(fitText, "w:val");
-		if (val !== void 0) opts.fitText = val;
+	const outlineLvl = findChild(el, "w:outlineLvl");
+	if (outlineLvl) {
+		const val = attrNum(outlineLvl, "w:val");
+		if (val !== void 0) opts.outlineLevel = val;
 	}
-	const lang = findChild(el, "w:lang");
-	if (lang) {
-		const langObj = {};
-		const val = attr(lang, "w:val");
-		if (val) langObj.val = val;
-		const eastAsia = attr(lang, "w:eastAsia");
-		if (eastAsia) langObj.eastAsia = eastAsia;
-		const bidi = attr(lang, "w:bidi");
-		if (bidi) langObj.bidi = bidi;
-		if (Object.keys(langObj).length > 0) opts.language = langObj;
+	const cnfStyle = findChild(el, "w:cnfStyle");
+	if (cnfStyle) {
+		const val = attr(cnfStyle, "w:val");
+		if (val) opts.cnfStyle = { val };
 	}
-	const bdr = findChild(el, "w:bdr");
-	if (bdr) opts.border = parseBorder(bdr);
-	const shd = findChild(el, "w:shd");
-	if (shd) opts.shading = parseShading(shd);
-	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;
-}
-/** 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");
+	const rPr = findChild(el, "w:rPr");
+	if (rPr) opts.run = parseRunProperties(rPr);
+	const framePr = findChild(el, "w:framePr");
+	if (framePr) {
+		const frame = {};
+		for (const [attrName, optName] of [
+			["w:dropCap", "dropCap"],
+			["w:lines", "lines"],
+			["w:wrap", "wrap"],
+			["w:vAnchor", "vAnchor"],
+			["w:hAnchor", "hAnchor"],
+			["w:x", "x"],
+			["w:y", "y"],
+			["w:hRule", "hRule"],
+			["w:hSpace", "hSpace"],
+			["w:vSpace", "vSpace"]
+		]) {
+			const val = attr(framePr, attrName);
+			if (val !== void 0) frame[optName] = val;
+		}
+		const w = attrNum(framePr, "w:w");
+		if (w !== void 0) frame.width = w;
+		const h = attrNum(framePr, "w:h");
+		if (h !== void 0) frame.height = h;
+		if (Object.keys(frame).length > 0) opts.frame = frame;
+	}
+	return opts;
+}
 /**
-* Parse a w:r element into run data.
-* Returns { properties, children } where children are parsed run content items.
+* Parse a w:p element into ParagraphOptions.
 */
-function parseRun(el, _ctx) {
-	const rPr = findChild(el, "w:rPr");
-	const properties = rPr ? parseRunProperties(rPr) : void 0;
-	const children = [];
+function parseParagraph(el, ctx) {
+	const opts = {};
+	const pPr = findChild(el, "w:pPr");
+	if (pPr) Object.assign(opts, parseParagraphProperties(pPr, ctx));
+	const childList = [];
 	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);
+		case "w:pPr": break;
+		case "w:r": {
+			const parsed = parseRun(child, ctx);
+			const rawChildren = parsed.children.filter((c) => c instanceof RawPassthrough);
+			const runOpts = parsedRunToOptions({
+				...parsed,
+				children: parsed.children.filter((c) => !(c instanceof RawPassthrough))
+			});
+			childList.push(runOpts);
+			childList.push(...rawChildren);
 			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_PAGE_BREAK);
-			else children.push(PARSED_LINE_BREAK);
+		case "w:hyperlink": {
+			const hl = {};
+			const rId = attr(child, "r:id");
+			if (rId) {
+				const target = ctx.docx.partRefs.hyperlinks.get(rId);
+				if (target) hl.link = target;
+			}
+			const anchor = attr(child, "w:anchor");
+			if (anchor) hl.anchor = anchor;
+			const tooltip = attr(child, "w:tooltip");
+			if (tooltip) hl.tooltip = tooltip;
+			const linkRuns = [];
+			for (const sub of child.elements ?? []) if (sub.name === "w:r") {
+				const runOpts = parsedRunToOptions(parseRun(sub, ctx));
+				linkRuns.push(runOpts);
+			}
+			if (linkRuns.length > 0) {
+				hl.children = linkRuns;
+				childList.push({ hyperlink: hl });
+			}
 			break;
 		}
-		case "w:tab":
-			children.push(PARSED_TAB);
+		case "w:bookmarkStart": {
+			const id = attrNum(child, "w:id");
+			const name = attr(child, "w:name");
+			if (id !== void 0 && name) childList.push({ bookmarkStart: {
+				id,
+				name
+			} });
 			break;
-		case "w:cr":
-			children.push(PARSED_CR);
+		}
+		case "w:bookmarkEnd": {
+			const id = attrNum(child, "w:id");
+			if (id !== void 0) childList.push({ bookmarkEnd: id });
 			break;
-		case "w:noBreakHyphen":
-			children.push(PARSED_NO_BREAK_HYPHEN);
+		}
+		case "w:commentRangeStart": {
+			const id = attrNum(child, "w:id");
+			if (id !== void 0) childList.push({ commentRangeStart: id });
 			break;
-		case "w:softHyphen":
-			children.push(PARSED_SOFT_HYPHEN);
+		}
+		case "w:commentRangeEnd": {
+			const id = attrNum(child, "w:id");
+			if (id !== void 0) childList.push({ commentRangeEnd: id });
 			break;
+		}
 		case "w:commentReference": {
 			const id = attrNum(child, "w:id");
-			if (id !== void 0) children.push({ commentReference: id });
+			if (id !== void 0) childList.push({ commentReference: id });
+			break;
+		}
+		case "m:oMath": {
+			const mathChildren = parseMathChildren(child);
+			childList.push({ math: { children: mathChildren } });
 			break;
 		}
-		case "w:drawing":
-		case "w:pict": break;
-		case "w:footnoteReference":
-		case "w:endnoteReference": break;
 		default:
-			if (child.name && child.elements && child.elements.length > 0) children.push(new RawPassthrough(child));
+			if (child.name && child.elements && child.elements.length > 0) childList.push(new RawPassthrough(child));
+			break;
+	}
+	if (childList.length > 0) {
+		if (childList.every((c) => typeof c === "object" && c !== null && "text" in c && Object.keys(c).length <= 2)) {
+			const combined = childList.map((c) => c.text).join("");
+			if (combined && Object.keys(opts).length === 0) return combined;
+			if (combined) {
+				opts.text = combined;
+				return opts;
+			}
+		}
+		opts.children = childList;
+	}
+	return opts;
+}
+//#endregion
+//#region src/file/alt-chunk/alt-chunk-parse.ts
+/**
+* AltChunk parser for DOCX documents.
+*
+* Parses w:altChunk elements and extracts embedded content from the ZIP.
+*
+* @module
+*/
+/**
+* Parse a w:altChunk element into AltChunkOptions.
+* Reads the referenced data from the ZIP package.
+*/
+function parseAltChunk(el, ctx) {
+	const rId = attr(el, "r:id");
+	if (!rId) throw new Error("w:altChunk missing r:id attribute");
+	const path = ctx.docx.partRefs.afChunks.get(rId);
+	if (!path) throw new Error(`AltChunk relationship ${rId} not found`);
+	const data = ctx.docx.doc.getRaw(path);
+	if (!data) throw new Error(`AltChunk data not found at ${path}`);
+	const ext = path.split(".").pop() ?? "txt";
+	let contentType;
+	let extension;
+	switch (ext) {
+		case "html":
+			contentType = "text/html";
+			extension = "html";
+			break;
+		case "rtf":
+			contentType = "application/rtf";
+			extension = "rtf";
+			break;
+		default:
+			contentType = "text/plain";
+			extension = "txt";
+			break;
+	}
+	return {
+		data,
+		contentType,
+		extension
+	};
+}
+//#endregion
+//#region src/file/drawing/drawing-parse.ts
+/**
+* Drawing parser for DOCX documents.
+*
+* Parses w:drawing elements and extracts image, chart, or SmartArt data.
+*
+* @module
+*/
+/**
+* Parse a w:drawing element and dispatch to the correct parser
+* based on the graphicData URI.
+*/
+function parseDrawingRun(el, ctx) {
+	const graphicData = findDeep(el, "a:graphicData")[0];
+	if (!graphicData) return void 0;
+	const uri = attr(graphicData, "uri") ?? "";
+	if (uri.includes("/chart")) return parseChartDrawing(el, ctx);
+	if (uri.includes("/diagram")) return parseSmartArtDrawing(el, ctx);
+	return parseImageRun(el, ctx);
+}
+/**
+* Determine image type from file extension or MIME type.
+*/
+function imageTypeFromPath(path) {
+	switch (path.split(".").pop()?.toLowerCase() ?? "") {
+		case "jpg":
+		case "jpeg": return "jpg";
+		case "png": return "png";
+		case "gif": return "gif";
+		case "bmp": return "bmp";
+		case "tif":
+		case "tiff": return "tif";
+		case "ico": return "ico";
+		case "emf": return "emf";
+		case "wmf": return "wmf";
+		default: return "png";
+	}
+}
+/**
+* Parse a w:drawing element and return image data wrapped in { image: ... }.
+*/
+function parseImageRun(el, ctx) {
+	const inline = findDeep(el, "wp:inline")[0];
+	const anchor = inline ? void 0 : findDeep(el, "wp:anchor")[0];
+	const parent = inline ?? anchor;
+	if (!parent) return void 0;
+	const extent = findChild(parent, "wp:extent");
+	let width;
+	let height;
+	if (extent) {
+		const cxEmu = attrNum(extent, "cx");
+		const cyEmu = attrNum(extent, "cy");
+		if (cxEmu !== void 0) width = convertEmuToPixels(cxEmu);
+		if (cyEmu !== void 0) height = convertEmuToPixels(cyEmu);
+	}
+	const blip = findDeep(parent, "a:blip")[0];
+	if (!blip) return void 0;
+	const rEmbed = attr(blip, "r:embed");
+	if (!rEmbed) return void 0;
+	const mediaPath = ctx.docx.partRefs.media.get(rEmbed);
+	if (!mediaPath) return void 0;
+	const imageData = ctx.docx.doc.getRaw(mediaPath);
+	if (!imageData) return void 0;
+	const imageOpts = {
+		type: imageTypeFromPath(mediaPath),
+		data: imageData,
+		transformation: {
+			...width !== void 0 ? { width } : {},
+			...height !== void 0 ? { height } : {}
+		}
+	};
+	const docPr = findChild(parent, "wp:docPr");
+	if (docPr) {
+		const name = attr(docPr, "name");
+		const descr = attr(docPr, "descr");
+		if (name || descr) imageOpts.altText = {
+			...name ? { name } : {},
+			...descr ? { description: descr } : {}
+		};
+	}
+	if (anchor && !inline) {
+		const floating = {};
+		const posH = findChild(anchor, "wp:positionH");
+		if (posH) {
+			const align = findChild(posH, "wp:align");
+			const posOffset = findChild(posH, "wp:posOffset");
+			if (align) floating.horizontalPosition = { align: textOf(align) };
+			else if (posOffset) floating.horizontalPosition = { offset: attrNum(posOffset, "offset") ?? 0 };
+		}
+		const posV = findChild(anchor, "wp:positionV");
+		if (posV) {
+			const align = findChild(posV, "wp:align");
+			const posOffset = findChild(posV, "wp:posOffset");
+			if (align) floating.verticalPosition = { align: textOf(align) };
+			else if (posOffset) floating.verticalPosition = { offset: attrNum(posOffset, "offset") ?? 0 };
+		}
+		for (const wrapType of [
+			"wrapSquare",
+			"wrapTight",
+			"wrapTopAndBottom",
+			"wrapNone"
+		]) if (findChild(anchor, `wp:${wrapType}`)) {
+			floating.wrap = wrapType;
 			break;
+		}
+		if (attrBool(anchor, "behindDoc")) floating.behindDocument = true;
+		if (Object.keys(floating).length > 0) imageOpts.floating = floating;
 	}
+	return { image: imageOpts };
+}
+function getDrawingExtent(el) {
+	const inline = findDeep(el, "wp:inline")[0];
+	const anchor = inline ? void 0 : findDeep(el, "wp:anchor")[0];
+	const parent = inline ?? anchor;
+	if (!parent) return {};
+	const extent = findChild(parent, "wp:extent");
+	if (!extent) return {};
+	const cxEmu = attrNum(extent, "cx");
+	const cyEmu = attrNum(extent, "cy");
 	return {
-		properties,
-		children
+		...cxEmu !== void 0 ? { width: convertEmuToPixels(cxEmu) } : {},
+		...cyEmu !== void 0 ? { height: convertEmuToPixels(cyEmu) } : {}
 	};
 }
 /**
-* 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.
+* Look up a relationship ID in a map, with fallback for double "rId" prefix
+* that the library's generation code produces (e.g. "rIdrId7" → "rId7").
 */
-function parsedRunToOptions(parsed) {
-	const opts = { ...parsed.properties };
-	const commentRefs = parsed.children.filter((c) => typeof c === "object" && c !== null && "commentReference" in c);
-	const nonCommentChildren = parsed.children.filter((c) => !(typeof c === "object" && c !== null && "commentReference" in c));
-	if (commentRefs.length > 0 && nonCommentChildren.length === 0 && !parsed.properties) return commentRefs[0];
-	const textParts = [];
-	let breakCount = 0;
-	for (const child of nonCommentChildren) if (typeof child === "string") textParts.push(child);
-	else if (child === PARSED_LINE_BREAK) breakCount++;
-	if (textParts.length > 0) opts.text = textParts.join("");
-	if (breakCount > 0) opts.break = breakCount;
-	return opts;
+function lookupRId(map, rId) {
+	if (!rId) return void 0;
+	const direct = map.get(rId);
+	if (direct) return direct;
+	if (rId.startsWith("rIdrId")) return map.get(rId.slice(3));
+}
+function parseChartDrawing(el, ctx) {
+	const chartRef = findDeep(el, "c:chart")[0];
+	if (!chartRef) return void 0;
+	const rId = attr(chartRef, "r:id");
+	const chartPath = lookupRId(ctx.docx.partRefs.charts, rId);
+	if (!chartPath) return void 0;
+	const chartXml = ctx.docx.doc.get(chartPath);
+	if (!chartXml) return void 0;
+	const opts = parseChartXml(chartXml);
+	if (!opts) return void 0;
+	const ext = getDrawingExtent(el);
+	if (ext.width !== void 0 || ext.height !== void 0) opts.transformation = { ...ext };
+	return { chart: opts };
 }
-//#endregion
-//#region src/file/paragraph/paragraph-parse.ts
-/**
-* Paragraph parser for DOCX documents.
-*
-* Parses w:p and w:pPr Element trees into ParagraphOptions objects.
-*
-* @module
-*/
-init_style();
-init_math_parse();
-const HEADING_MAP = {
-	Heading1: HeadingLevel.HEADING_1,
-	Heading2: HeadingLevel.HEADING_2,
-	Heading3: HeadingLevel.HEADING_3,
-	Heading4: HeadingLevel.HEADING_4,
-	Heading5: HeadingLevel.HEADING_5,
-	Heading6: HeadingLevel.HEADING_6,
-	Title: HeadingLevel.TITLE
-};
 /**
-* Parse w:pPr element into paragraph properties (without children).
+* Parse c:chartSpace element into ChartOptions.
 */
-function parseParagraphProperties(el, _ctx) {
+function parseChartXml(el) {
+	const chart = findChild(el, "c:chart");
+	if (!chart) return void 0;
 	const opts = {};
-	const pStyle = findChild(el, "w:pStyle");
-	if (pStyle) {
-		const styleVal = attr(pStyle, "w:val");
-		if (styleVal) if (HEADING_MAP[styleVal]) opts.heading = HEADING_MAP[styleVal];
-		else opts.style = styleVal;
-	}
-	const jc = findChild(el, "w:jc");
-	if (jc) {
-		const val = attr(jc, "w:val");
-		if (val) opts.alignment = val;
-	}
-	const spacing = findChild(el, "w:spacing");
-	if (spacing) {
-		const sp = {};
-		const before = attrNum(spacing, "w:before");
-		if (before !== void 0) sp.before = before;
-		const after = attrNum(spacing, "w:after");
-		if (after !== void 0) sp.after = after;
-		const line = attrNum(spacing, "w:line");
-		if (line !== void 0) sp.line = line;
-		const lineRule = attr(spacing, "w:lineRule");
-		if (lineRule) sp.lineRule = lineRule;
-		const beforeAuto = attrBool(spacing, "w:beforeAutospacing") ?? attrBool(spacing, "w:beforeLines");
-		if (beforeAuto !== void 0) sp.beforeAutoSpacing = beforeAuto;
-		const afterAuto = attrBool(spacing, "w:afterAutospacing") ?? attrBool(spacing, "w:afterLines");
-		if (afterAuto !== void 0) sp.afterAutoSpacing = afterAuto;
-		if (Object.keys(sp).length > 0) opts.spacing = sp;
-	}
-	const ind = findChild(el, "w:ind");
-	if (ind) {
-		const indentObj = {};
-		const left = attrNum(ind, "w:left");
-		if (left !== void 0) indentObj.left = left;
-		const right = attrNum(ind, "w:right");
-		if (right !== void 0) indentObj.right = right;
-		const start = attrNum(ind, "w:start");
-		if (start !== void 0) indentObj.start = start;
-		const end = attrNum(ind, "w:end");
-		if (end !== void 0) indentObj.end = end;
-		const hanging = attrNum(ind, "w:hanging");
-		if (hanging !== void 0) indentObj.hanging = hanging;
-		const firstLine = attrNum(ind, "w:firstLine");
-		if (firstLine !== void 0) indentObj.firstLine = firstLine;
-		if (Object.keys(indentObj).length > 0) opts.indent = indentObj;
-	}
-	const numPr = findChild(el, "w:numPr");
-	if (numPr) {
-		const ilvl = findChild(numPr, "w:ilvl");
-		opts.bullet = { level: ilvl ? attrNum(ilvl, "w:val") ?? 0 : 0 };
-	}
-	const tabs = findChild(el, "w:tabs");
-	if (tabs) {
-		const tabStops = [];
-		for (const tab of children(tabs, "w:tab")) {
-			const tabObj = {};
-			const pos = attrNum(tab, "w:pos");
-			if (pos !== void 0) tabObj.position = pos;
-			const val = attr(tab, "w:val");
-			if (val) tabObj.type = val;
-			const leader = attr(tab, "w:leader");
-			if (leader) tabObj.leader = leader;
-			tabStops.push(tabObj);
+	const titleEl = findChild(chart, "c:title");
+	if (titleEl) {
+		const rich = findDeep(titleEl, "c:rich")[0];
+		if (rich) {
+			const t = findDeep(rich, "a:t")[0];
+			if (t) {
+				const title = textOf(t);
+				if (title) opts.title = title;
+			}
 		}
-		if (tabStops.length > 0) opts.tabStops = tabStops;
-	}
-	for (const [name, optKey] of [
-		["w:keepNext", "keepNext"],
-		["w:keepLines", "keepLines"],
-		["w:pageBreakBefore", "pageBreakBefore"],
-		["w:widowControl", "widowControl"],
-		["w:suppressLineNumbers", "suppressLineNumbers"],
-		["w:contextualSpacing", "contextualSpacing"],
-		["w:bidi", "bidirectional"],
-		["w:wordWrap", "wordWrap"],
-		["w:suppressAutoHyphens", "suppressAutoHyphens"],
-		["w:adjustRightInd", "adjustRightInd"],
-		["w:snapToGrid", "snapToGrid"],
-		["w:mirrorIndents", "mirrorIndents"],
-		["w:kinsoku", "kinsoku"],
-		["w:topLinePunct", "topLinePunct"],
-		["w:autoSpaceDE", "autoSpaceDE"],
-		["w:overflowPunct", "overflowPunctuation"],
-		["w:suppressOverlap", "suppressOverlap"]
-	]) {
-		const child = findChild(el, name);
-		if (child) opts[optKey] = attrBool(child, "w:val") ?? true;
 	}
-	if (findChild(el, "w:pBdr")) {
-		const pBdr = findChild(el, "w:pBdr");
-		const border = {};
-		for (const side of [
-			"top",
-			"bottom",
-			"left",
-			"right"
-		]) {
-			const sideEl = findChild(pBdr, `w:${side}`);
-			if (sideEl) {
-				const sideOpts = {};
-				const style = attr(sideEl, "w:val");
-				if (style) sideOpts.style = style;
-				const color = attr(sideEl, "w:color");
-				if (color) sideOpts.color = color;
-				const size = attrNum(sideEl, "w:sz");
-				if (size !== void 0) sideOpts.size = size;
-				const space = attrNum(sideEl, "w:space");
-				if (space !== void 0) sideOpts.space = space;
-				border[side] = sideOpts;
+	const plotArea = findChild(chart, "c:plotArea");
+	if (!plotArea) return void 0;
+	let chartType;
+	let typeElement;
+	for (const child of plotArea.elements ?? []) {
+		switch (child.name) {
+			case "c:barChart": {
+				const barDir = findChild(child, "c:barDir");
+				chartType = barDir && attr(barDir, "val") === "bar" ? "bar" : "column";
+				typeElement = child;
+				break;
 			}
+			case "c:lineChart":
+				chartType = "line";
+				typeElement = child;
+				break;
+			case "c:pieChart":
+				chartType = "pie";
+				typeElement = child;
+				break;
+			case "c:areaChart":
+				chartType = "area";
+				typeElement = child;
+				break;
+			case "c:scatterChart":
+				chartType = "scatter";
+				typeElement = child;
+				break;
 		}
-		if (Object.keys(border).length > 0) opts.border = border;
-	}
-	const shd = findChild(el, "w:shd");
-	if (shd) {
-		const shdObj = {};
-		const fill = attr(shd, "w:fill");
-		if (fill) shdObj.fill = fill;
-		const color = attr(shd, "w:color");
-		if (color) shdObj.color = color;
-		const val = attr(shd, "w:val");
-		if (val) shdObj.type = val;
-		if (Object.keys(shdObj).length > 0) opts.shading = shdObj;
+		if (chartType) break;
 	}
-	const textAlignment = findChild(el, "w:textAlignment");
-	if (textAlignment) {
-		const val = attr(textAlignment, "w:val");
-		if (val) opts.textAlignment = val;
+	if (!chartType || !typeElement) return void 0;
+	opts.type = chartType;
+	const series = [];
+	let categories;
+	for (const serEl of typeElement.elements ?? []) {
+		if (serEl.name !== "c:ser") continue;
+		const nameParts = extractStrCache(serEl, "c:tx");
+		const cats = extractStrCache(serEl, "c:cat");
+		if (cats.length > 0 && !categories) categories = cats;
+		const vals = extractNumCache(serEl);
+		series.push({
+			name: nameParts[0] ?? "",
+			values: vals
+		});
 	}
-	const outlineLvl = findChild(el, "w:outlineLvl");
-	if (outlineLvl) {
-		const val = attrNum(outlineLvl, "w:val");
-		if (val !== void 0) opts.outlineLevel = val;
+	opts.data = {
+		categories: categories ?? [],
+		series
+	};
+	opts.showLegend = findChild(chart, "c:legend") !== void 0;
+	const styleEl = findChild(el, "c:style");
+	if (styleEl) {
+		const val = attrNum(styleEl, "val");
+		if (val !== void 0) opts.style = val;
 	}
-	const cnfStyle = findChild(el, "w:cnfStyle");
-	if (cnfStyle) {
-		const val = attr(cnfStyle, "w:val");
-		if (val) opts.cnfStyle = { val };
+	return opts;
+}
+/**
+* Extract string values from c:strCache within a container element.
+*/
+function extractStrCache(parent, containerName) {
+	const container = findChild(parent, containerName);
+	if (!container) return [];
+	const cache = findDeep(container, "c:strCache")[0];
+	if (!cache) return [];
+	const values = [];
+	for (const pt of cache.elements ?? []) {
+		if (pt.name !== "c:pt") continue;
+		const v = findChild(pt, "c:v");
+		if (v) values.push(textOf(v) ?? "");
 	}
-	const rPr = findChild(el, "w:rPr");
-	if (rPr) opts.run = parseRunProperties(rPr);
-	const framePr = findChild(el, "w:framePr");
-	if (framePr) {
-		const frame = {};
-		for (const [attrName, optName] of [
-			["w:dropCap", "dropCap"],
-			["w:lines", "lines"],
-			["w:wrap", "wrap"],
-			["w:vAnchor", "vAnchor"],
-			["w:hAnchor", "hAnchor"],
-			["w:x", "x"],
-			["w:y", "y"],
-			["w:hRule", "hRule"],
-			["w:hSpace", "hSpace"],
-			["w:vSpace", "vSpace"]
-		]) {
-			const val = attr(framePr, attrName);
-			if (val !== void 0) frame[optName] = val;
+	return values;
+}
+/**
+* Extract numeric values from c:numCache within a c:val container.
+*/
+function extractNumCache(parent) {
+	const valEl = findChild(parent, "c:val");
+	if (!valEl) return [];
+	const cache = findDeep(valEl, "c:numCache")[0];
+	if (!cache) return [];
+	const values = [];
+	for (const pt of cache.elements ?? []) {
+		if (pt.name !== "c:pt") continue;
+		const v = findChild(pt, "c:v");
+		if (v) {
+			const num = Number(textOf(v));
+			if (!isNaN(num)) values.push(num);
 		}
-		const w = attrNum(framePr, "w:w");
-		if (w !== void 0) frame.width = w;
-		const h = attrNum(framePr, "w:h");
-		if (h !== void 0) frame.height = h;
-		if (Object.keys(frame).length > 0) opts.frame = frame;
 	}
-	return opts;
+	return values;
+}
+function parseSmartArtDrawing(el, ctx) {
+	const relIds = findDeep(el, "dgm:relIds")[0];
+	if (!relIds) return void 0;
+	const rId = attr(relIds, "r:dm");
+	const dataPath = lookupRId(ctx.docx.partRefs.diagramData, rId);
+	if (!dataPath) return void 0;
+	const dataEl = ctx.docx.doc.get(dataPath);
+	if (!dataEl) return void 0;
+	const opts = parseSmartArtDataXml(dataEl);
+	if (!opts) return void 0;
+	const ext = getDrawingExtent(el);
+	if (ext.width !== void 0 || ext.height !== void 0) opts.transformation = { ...ext };
+	return { smartArt: opts };
 }
 /**
-* Parse a w:p element into ParagraphOptions.
+* Parse dgm:dataModel element into SmartArtOptions.
 */
-function parseParagraph(el, ctx) {
+function parseSmartArtDataXml(el) {
+	const ptLst = findChild(el, "dgm:ptLst");
+	if (!ptLst) return void 0;
 	const opts = {};
-	const pPr = findChild(el, "w:pPr");
-	if (pPr) Object.assign(opts, parseParagraphProperties(pPr, ctx));
-	const childList = [];
-	for (const child of el.elements ?? []) switch (child.name) {
-		case "w:pPr": break;
-		case "w:r": {
-			const parsed = parseRun(child, ctx);
-			const rawChildren = parsed.children.filter((c) => c instanceof RawPassthrough);
-			const runOpts = parsedRunToOptions({
-				...parsed,
-				children: parsed.children.filter((c) => !(c instanceof RawPassthrough))
-			});
-			childList.push(runOpts);
-			childList.push(...rawChildren);
-			break;
-		}
-		case "w:hyperlink": {
-			const linkRuns = [];
-			for (const sub of child.elements ?? []) if (sub.name === "w:r") {
-				const runOpts = parsedRunToOptions(parseRun(sub, ctx));
-				linkRuns.push(runOpts);
+	const nodeMap = /* @__PURE__ */ new Map();
+	for (const pt of ptLst.elements ?? []) {
+		if (pt.name !== "dgm:pt") continue;
+		const type = attr(pt, "type");
+		const modelId = attr(pt, "modelId");
+		if (type === "doc") {
+			const prSet = findChild(pt, "dgm:prSet");
+			if (prSet) {
+				const loTypeId = attr(prSet, "loTypeId") ?? "";
+				const qsTypeId = attr(prSet, "qsTypeId") ?? "";
+				const csTypeId = attr(prSet, "csTypeId") ?? "";
+				const layout = loTypeId.split("/").pop();
+				if (layout) opts.layout = layout;
+				const style = qsTypeId.split("/").pop();
+				if (style) opts.style = style;
+				const color = csTypeId.split("/").pop();
+				if (color) opts.color = color;
 			}
-			childList.push(...linkRuns);
-			break;
-		}
-		case "w:bookmarkStart":
-		case "w:bookmarkEnd": break;
-		case "w:commentRangeStart": {
-			const id = attrNum(child, "w:id");
-			if (id !== void 0) childList.push({ commentRangeStart: id });
-			break;
-		}
-		case "w:commentRangeEnd": {
-			const id = attrNum(child, "w:id");
-			if (id !== void 0) childList.push({ commentRangeEnd: id });
-			break;
-		}
-		case "w:commentReference": {
-			const id = attrNum(child, "w:id");
-			if (id !== void 0) childList.push({ commentReference: id });
-			break;
-		}
-		case "m:oMath": {
-			const mathChildren = parseMathChildren(child);
-			childList.push({ math: { children: mathChildren } });
-			break;
+		} else if (type === "node" && modelId) {
+			const t = findDeep(pt, "a:t")[0];
+			nodeMap.set(modelId, t ? textOf(t) ?? "" : "");
 		}
-		default:
-			if (child.name && child.elements && child.elements.length > 0) childList.push(new RawPassthrough(child));
-			break;
 	}
-	if (childList.length > 0) {
-		if (childList.every((c) => typeof c === "object" && c !== null && "text" in c && Object.keys(c).length <= 2)) {
-			const combined = childList.map((c) => c.text).join("");
-			if (combined && Object.keys(opts).length === 0) return combined;
-			if (combined) {
-				opts.text = combined;
-				return opts;
-			}
+	const cxnLst = findChild(el, "dgm:cxnLst");
+	if (!cxnLst) {
+		opts.data = { nodes: [] };
+		return opts;
+	}
+	const childrenMap = /* @__PURE__ */ new Map();
+	for (const cxn of cxnLst.elements ?? []) {
+		if (cxn.name !== "dgm:cxn") continue;
+		const srcId = attr(cxn, "srcId");
+		const destId = attr(cxn, "destId");
+		if (!srcId || !destId || !nodeMap.has(destId)) continue;
+		let arr = childrenMap.get(srcId);
+		if (!arr) {
+			arr = [];
+			childrenMap.set(srcId, arr);
 		}
-		opts.children = childList;
+		arr.push(destId);
 	}
+	opts.data = { nodes: (childrenMap.get("0") ?? []).map((id) => buildSmartArtNode(id, nodeMap, childrenMap)) };
 	return opts;
 }
+function buildSmartArtNode(id, nodeMap, childrenMap) {
+	const text = nodeMap.get(id) ?? "";
+	const childIds = childrenMap.get(id) ?? [];
+	if (childIds.length === 0) return { text };
+	return {
+		text,
+		children: childIds.map((cid) => buildSmartArtNode(cid, nodeMap, childrenMap))
+	};
+}
 //#endregion
 //#region src/file/sdt/sdt-parse.ts
 /**
@@ -17763,6 +17805,135 @@ function parseCustomProperties(el) {
 	return result;
 }
 //#endregion
+//#region src/parse/numbering.ts
+/**
+* Numbering definition parser for DOCX documents.
+*
+* Parses w:numbering elements into NumberingOptions objects for round-trip fidelity.
+*
+* @module
+*/
+/**
+* Parse w:numbering element into NumberingOptions.
+*/
+function parseNumberingDefinitions(el) {
+	const abstractNums = /* @__PURE__ */ new Map();
+	for (const child of el.elements ?? []) {
+		if (child.name !== "w:abstractNum") continue;
+		const id = attr(child, "w:abstractNumId");
+		if (id !== void 0) abstractNums.set(id, child);
+	}
+	const numToAbstract = /* @__PURE__ */ new Map();
+	for (const child of el.elements ?? []) {
+		if (child.name !== "w:num") continue;
+		const numId = attr(child, "w:numId");
+		const abstractRef = findChild(child, "w:abstractNumId");
+		const abstractId = abstractRef ? attr(abstractRef, "w:val") : void 0;
+		if (numId !== void 0 && abstractId !== void 0) numToAbstract.set(numId, abstractId);
+	}
+	const configs = [];
+	for (const [numId, abstractId] of numToAbstract) {
+		const abstractEl = abstractNums.get(abstractId);
+		if (!abstractEl) continue;
+		const levels = [];
+		for (const child of abstractEl.elements ?? []) {
+			if (child.name !== "w:lvl") continue;
+			const levelOpts = parseLevel(child);
+			if (levelOpts) levels.push(levelOpts);
+		}
+		if (levels.length > 0) configs.push({
+			reference: `list_${numId}`,
+			levels
+		});
+	}
+	if (configs.length === 0) return void 0;
+	return { config: configs };
+}
+function parseLevel(el) {
+	const opts = {};
+	const level = attrNum(el, "w:ilvl");
+	if (level !== void 0) opts.level = level;
+	const start = findChild(el, "w:start");
+	if (start) {
+		const val = attrNum(start, "w:val");
+		if (val !== void 0) opts.start = val;
+	}
+	const numFmt = findChild(el, "w:numFmt");
+	if (numFmt) {
+		const val = attr(numFmt, "w:val");
+		if (val) opts.format = val;
+	}
+	const lvlText = findChild(el, "w:lvlText");
+	if (lvlText) {
+		const val = attr(lvlText, "w:val");
+		if (val) opts.text = val;
+	}
+	const lvlJc = findChild(el, "w:lvlJc");
+	if (lvlJc) {
+		const val = attr(lvlJc, "w:val");
+		if (val) opts.alignment = val;
+	}
+	const suff = findChild(el, "w:suff");
+	if (suff) {
+		const val = attr(suff, "w:val");
+		if (val) opts.suffix = val;
+	}
+	if (findChild(el, "w:isLgl")) opts.isLegalNumberingStyle = true;
+	const rPr = findChild(el, "w:rPr");
+	if (rPr) {
+		const style = {};
+		const sz = findChild(rPr, "w:sz");
+		if (sz) {
+			const val = attrNum(sz, "w:val");
+			if (val !== void 0) {
+				if (!style.run) style.run = {};
+				style.run.size = val;
+			}
+		}
+		const rFonts = findChild(rPr, "w:rFonts");
+		if (rFonts) {
+			const ascii = attr(rFonts, "w:ascii");
+			if (ascii) {
+				if (!style.run) style.run = {};
+				style.run.font = ascii;
+			}
+		}
+		if (Object.keys(style).length > 0) opts.style = style;
+	}
+	const pPr = findChild(el, "w:pPr");
+	if (pPr) {
+		const style = opts.style ?? {};
+		const paraStyle = {};
+		const ind = findChild(pPr, "w:ind");
+		if (ind) {
+			const indent = {};
+			const left = attrNum(ind, "w:left");
+			if (left !== void 0) indent.left = left;
+			const hanging = attrNum(ind, "w:hanging");
+			if (hanging !== void 0) indent.hanging = hanging;
+			if (Object.keys(indent).length > 0) paraStyle.indent = indent;
+		}
+		if (findChild(pPr, "w:tabs")) {
+			const tabStops = [];
+			for (const tab of pPr.elements ?? []) {
+				if (tab.name !== "w:tab") continue;
+				const tabObj = {};
+				const pos = attrNum(tab, "w:pos");
+				if (pos !== void 0) tabObj.position = pos;
+				const val = attr(tab, "w:val");
+				if (val) tabObj.type = val;
+				tabStops.push(tabObj);
+			}
+			if (tabStops.length > 0) paraStyle.tabStops = tabStops;
+		}
+		if (Object.keys(paraStyle).length > 0) {
+			style.paragraph = paraStyle;
+			opts.style = style;
+		}
+	}
+	return Object.keys(opts).length > 0 ? opts : void 0;
+}
+//#endregion
 //#region src/parse/settings.ts
 /**
 * Parse word/settings.xml Element into PropertiesOptions fields.
@@ -17845,10 +18016,11 @@ function parseSettings(el) {
 //#endregion
 //#region src/parse/styles.ts
 /**
-* Style cache builder for DOCX parsing.
+* Style cache builder and definition parser for DOCX documents.
 *
 * Builds lookup maps from parsed styles.xml and numbering.xml elements
 * for efficient style resolution during document parsing.
+* Also parses full style definitions into StylesOptions for round-trip fidelity.
 *
 * @module
 */
@@ -17861,8 +18033,7 @@ function buildStyleCache(docx) {
 	if (!docx.styles) return cache;
 	for (const child of docx.styles.elements ?? []) {
 		if (child.name !== "w:style") continue;
-		const styleIdEl = findChild(child, "w:styleId");
-		const styleId = styleIdEl ? attr(styleIdEl, "w:val") : void 0;
+		const styleId = attr(child, "w:styleId");
 		if (styleId) cache.set(styleId, child);
 	}
 	return cache;
@@ -17881,6 +18052,109 @@ function buildNumberingCache(docx) {
 	}
 	return cache;
 }
+/**
+* Parse w:styles element into StylesOptions.
+*/
+function parseStyleDefinitions(el, ctx) {
+	const opts = {};
+	const paragraphStyles = [];
+	const characterStyles = [];
+	for (const child of el.elements ?? []) if (child.name === "w:docDefaults") {
+		const defOpts = parseDocDefaults(child);
+		if (defOpts) opts.default = defOpts;
+	} else if (child.name === "w:style") {
+		const styleOpts = parseStyleElement(child, ctx);
+		if (!styleOpts) continue;
+		const type = styleOpts._type;
+		delete styleOpts._type;
+		if (type === "paragraph") paragraphStyles.push(styleOpts);
+		else if (type === "character") characterStyles.push(styleOpts);
+	}
+	if (paragraphStyles.length > 0) opts.paragraphStyles = paragraphStyles;
+	if (characterStyles.length > 0) opts.characterStyles = characterStyles;
+	return Object.keys(opts).length > 0 ? opts : void 0;
+}
+function parseDocDefaults(el) {
+	const result = {};
+	const docDefaults = {};
+	const rPrDefault = findChild(el, "w:rPrDefault");
+	if (rPrDefault) {
+		const rPr = findChild(rPrDefault, "w:rPr");
+		if (rPr) {
+			const runDefaults = parseRunProperties(rPr);
+			if (Object.keys(runDefaults).length > 0) docDefaults.run = runDefaults;
+		}
+	}
+	const pPrDefault = findChild(el, "w:pPrDefault");
+	if (pPrDefault) {
+		const pPr = findChild(pPrDefault, "w:pPr");
+		if (pPr) {
+			const paraDefaults = {};
+			const spacing = findChild(pPr, "w:spacing");
+			if (spacing) {
+				const sp = {};
+				const before = attrNum(spacing, "w:before");
+				if (before !== void 0) sp.before = before;
+				const after = attrNum(spacing, "w:after");
+				if (after !== void 0) sp.after = after;
+				const line = attrNum(spacing, "w:line");
+				if (line !== void 0) sp.line = line;
+				if (Object.keys(sp).length > 0) paraDefaults.spacing = sp;
+			}
+			if (Object.keys(paraDefaults).length > 0) docDefaults.paragraph = paraDefaults;
+		}
+	}
+	if (Object.keys(docDefaults).length > 0) result.document = docDefaults;
+	return Object.keys(result).length > 0 ? result : void 0;
+}
+function parseStyleElement(el, ctx) {
+	const opts = {};
+	const type = attr(el, "w:type");
+	if (type) opts._type = type;
+	const id = attr(el, "w:styleId");
+	if (id) opts.id = id;
+	if (attrBool(el, "w:default")) opts.default = true;
+	if (attrBool(el, "w:customStyle")) opts.customStyle = "1";
+	const nameEl = findChild(el, "w:name");
+	if (nameEl) {
+		const name = attr(nameEl, "w:val");
+		if (name) opts.name = name;
+	}
+	const basedOn = findChild(el, "w:basedOn");
+	if (basedOn) {
+		const val = attr(basedOn, "w:val");
+		if (val) opts.basedOn = val;
+	}
+	const next = findChild(el, "w:next");
+	if (next) {
+		const val = attr(next, "w:val");
+		if (val) opts.next = val;
+	}
+	const link = findChild(el, "w:link");
+	if (link) {
+		const val = attr(link, "w:val");
+		if (val) opts.link = val;
+	}
+	const uiPriority = findChild(el, "w:uiPriority");
+	if (uiPriority) {
+		const val = attrNum(uiPriority, "w:val");
+		if (val !== void 0) opts.uiPriority = val;
+	}
+	if (findChild(el, "w:qFormat")) opts.quickFormat = true;
+	if (findChild(el, "w:semiHidden")) opts.semiHidden = true;
+	if (findChild(el, "w:unhideWhenUsed")) opts.unhideWhenUsed = true;
+	const pPr = findChild(el, "w:pPr");
+	if (pPr) {
+		const paraOpts = parseParagraphProperties(pPr, ctx);
+		if (Object.keys(paraOpts).length > 0) opts.paragraph = paraOpts;
+	}
+	const rPr = findChild(el, "w:rPr");
+	if (rPr) {
+		const runOpts = parseRunProperties(rPr);
+		if (Object.keys(runOpts).length > 0) opts.run = runOpts;
+	}
+	return opts;
+}
 //#endregion
 //#region src/parse.ts
 function resolveRelsPath(target) {
@@ -17892,6 +18166,7 @@ function parseDocPartRefs(doc) {
 	const refs = {
 		headers: /* @__PURE__ */ new Map(),
 		footers: /* @__PURE__ */ new Map(),
+		hyperlinks: /* @__PURE__ */ new Map(),
 		charts: /* @__PURE__ */ new Map(),
 		diagramData: /* @__PURE__ */ new Map(),
 		media: /* @__PURE__ */ new Map(),
@@ -17917,6 +18192,7 @@ function parseDocPartRefs(doc) {
 		else if (type.includes("/image") || type.includes("/media")) refs.media.set(id, path);
 		else if (type.includes("/aFChunk")) refs.afChunks.set(id, path);
 		else if (type.includes("/subDocument")) refs.subDocs.set(id, path);
+		else if (type.includes("/hyperlink")) refs.hyperlinks.set(id, target);
 	}
 	return refs;
 }
@@ -17977,10 +18253,43 @@ function parseDocument(data) {
 			if (cpEntries.length > 0) opts.customProperties = cpEntries;
 		}
 	}
+	if (docx.partRefs.comments) {
+		const commentsEl = docx.doc.get(docx.partRefs.comments);
+		if (commentsEl) {
+			const comments = parseComments(commentsEl, ctx);
+			if (comments.length > 0) opts.comments = { children: comments };
+		}
+	}
+	if (docx.partRefs.footnotes) {
+		const footnotesEl = docx.doc.get(docx.partRefs.footnotes);
+		if (footnotesEl) {
+			const footnotes = parseNotesContent(footnotesEl, "w:footnote", ctx);
+			const footnotesMap = {};
+			for (const fn of footnotes) footnotesMap[String(fn.id)] = { children: fn.children };
+			if (Object.keys(footnotesMap).length > 0) opts.footnotes = footnotesMap;
+		}
+	}
+	if (docx.partRefs.endnotes) {
+		const endnotesEl = docx.doc.get(docx.partRefs.endnotes);
+		if (endnotesEl) {
+			const endnotes = parseNotesContent(endnotesEl, "w:endnote", ctx);
+			const endnotesMap = {};
+			for (const en of endnotes) endnotesMap[String(en.id)] = { children: en.children };
+			if (Object.keys(endnotesMap).length > 0) opts.endnotes = endnotesMap;
+		}
+	}
+	if (docx.styles) {
+		const styleOpts = parseStyleDefinitions(docx.styles, ctx);
+		if (styleOpts) opts.styles = styleOpts;
+	}
+	if (docx.numbering) {
+		const numOpts = parseNumberingDefinitions(docx.numbering);
+		if (numOpts) opts.numbering = numOpts;
+	}
 	return opts;
 }
 function parseDocx(data) {
-	const doc = parseArchive(data);
+	const doc = parseArchive(toUint8Array(data));
 	const documentEl = doc.get("word/document.xml");
 	if (!documentEl) throw new Error("word/document.xml not found");
 	const body = documentEl.elements?.find((e) => e.name === "w:body");
@@ -18006,6 +18315,52 @@ function parseDocx(data) {
 		customProps
 	};
 }
+/**
+* Parse w:comments element into CommentOptions array.
+*/
+function parseComments(el, ctx) {
+	const comments = [];
+	for (const child of el.elements ?? []) {
+		if (child.name !== "w:comment") continue;
+		const id = attrNum(child, "w:id");
+		if (id === void 0) continue;
+		const author = attr(child, "w:author");
+		const initials = attr(child, "w:initials");
+		const date = attr(child, "w:date");
+		const children = [];
+		for (const sub of child.elements ?? []) if (sub.name === "w:p") children.push(parseParagraph(sub, ctx));
+		comments.push({
+			id,
+			author: author || void 0,
+			initials: initials || void 0,
+			date: date || void 0,
+			children
+		});
+	}
+	return comments;
+}
+/**
+* Parse footnotes or endnotes content into {id, children} array.
+* Skips system notes (id=-1 for separator, id=0 for continuation separator).
+*/
+function parseNotesContent(el, tagName, ctx) {
+	const notes = [];
+	for (const child of el.elements ?? []) {
+		if (child.name !== tagName) continue;
+		const id = attrNum(child, "w:id");
+		if (id === void 0) continue;
+		if (id < 1) continue;
+		const type = attr(child, "w:type");
+		const children = [];
+		for (const sub of child.elements ?? []) if (sub.name === "w:p") children.push(parseParagraph(sub, ctx));
+		notes.push({
+			id,
+			type: type || void 0,
+			children
+		});
+	}
+	return notes;
+}
 //#endregion
 //#region src/index.ts
 var src_exports = /* @__PURE__ */ __exportAll({