ooxml.js 3.0.1 → 3.1.0

package/dist/typed/docx/write.js

@@ -0,0 +1,675 @@
+import { el, txt } from "../../xml/fragment.js";
+import { encodeXmlText } from "../../xml/entities.js";
+import { ptToEighthPoints, ptToEmu, ptToHalfPoints, ptToTwips } from "../shared/units.js";
+import { TABLE_OF_CONTENTS_GALLERY, isDeletedChange } from "./constructs.js";
+import { colorToRgbHex, findConstructMarkerImbalance } from "document-schema.js";
+//#region src/typed/docx/write.ts
+const WML_NS = "http://schemas.openxmlformats.org/wordprocessingml/2006/main";
+const REL_NS = "http://schemas.openxmlformats.org/officeDocument/2006/relationships";
+const PKG_RELS_NS = "http://schemas.openxmlformats.org/package/2006/relationships";
+const CONTENT_TYPES_NS = "http://schemas.openxmlformats.org/package/2006/content-types";
+const CORE_PROPS_NS = "http://schemas.openxmlformats.org/package/2006/metadata/core-properties";
+const DC_NS = "http://purl.org/dc/elements/1.1/";
+const DCTERMS_NS = "http://purl.org/dc/terms/";
+const XSI_NS = "http://www.w3.org/2001/XMLSchema-instance";
+const EXTENDED_PROPS_NS = "http://schemas.openxmlformats.org/officeDocument/2006/extended-properties";
+const DRAWINGML_NS = "http://schemas.openxmlformats.org/drawingml/2006/main";
+const DRAWING_WP_NS = "http://schemas.openxmlformats.org/drawingml/2006/wordprocessingDrawing";
+const DRAWING_PIC_NS = "http://schemas.openxmlformats.org/drawingml/2006/picture";
+const MARKUP_COMPAT_NS = "http://schemas.openxmlformats.org/markup-compatibility/2006";
+const W14_NS = "http://schemas.microsoft.com/office/word/2010/wordml";
+const W15_NS = "http://schemas.microsoft.com/office/word/2012/wordml";
+const CT_DOCUMENT = "application/vnd.openxmlformats-officedocument.wordprocessingml.document.main+xml";
+const CT_CORE_PROPS = "application/vnd.openxmlformats-package.core-properties+xml";
+const CT_EXTENDED_PROPS = "application/vnd.openxmlformats-officedocument.extended-properties+xml";
+const REL_OFFICE_DOCUMENT = `${REL_NS}/officeDocument`;
+const REL_CORE_PROPS = `${PKG_RELS_NS}/metadata/core-properties`;
+const REL_EXTENDED_PROPS = `${REL_NS}/extended-properties`;
+const REL_HYPERLINK = `${REL_NS}/hyperlink`;
+const REL_IMAGE = `${REL_NS}/image`;
+const DOCUMENT_PART_PATH = "word/document.xml";
+function newWriteState() {
+	return {
+		relationships: [],
+		hyperlinkIds: /* @__PURE__ */ new Map(),
+		mediaIds: /* @__PURE__ */ new Map(),
+		mediaParts: /* @__PURE__ */ new Map(),
+		nextDrawingId: 1,
+		nextMarkerId: 1
+	};
+}
+function addRelationship(state, type, target, external) {
+	const id = `rId${state.relationships.length + 1}`;
+	state.relationships.push({
+		id,
+		type,
+		target,
+		external
+	});
+	return id;
+}
+function hyperlinkRelationshipId(state, uri) {
+	const existing = state.hyperlinkIds.get(uri);
+	if (existing !== void 0) return existing;
+	const id = addRelationship(state, REL_HYPERLINK, encodeXmlText(uri), true);
+	state.hyperlinkIds.set(uri, id);
+	return id;
+}
+function imageRelationshipId(state, image) {
+	const key = `${image.format}:${image.base64}`;
+	const existing = state.mediaIds.get(key);
+	if (existing !== void 0) return existing;
+	const name = `image${state.mediaParts.size + 1}.${image.format === "png" ? "png" : "jpeg"}`;
+	state.mediaParts.set(name, {
+		format: image.format,
+		base64: image.base64
+	});
+	const id = addRelationship(state, REL_IMAGE, `media/${name}`, false);
+	state.mediaIds.set(key, id);
+	return id;
+}
+function xmlDeclaration() {
+	return {
+		type: "declaration",
+		attributes: [
+			{
+				name: "version",
+				value: "1.0"
+			},
+			{
+				name: "encoding",
+				value: "UTF-8"
+			},
+			{
+				name: "standalone",
+				value: "yes"
+			}
+		]
+	};
+}
+function xmlPart(root) {
+	return {
+		kind: "xml",
+		nodes: [xmlDeclaration(), root]
+	};
+}
+function toggleElement(tag, value) {
+	return el(tag, { "w:val": value ? "1" : "0" });
+}
+function buildRunProperties(run) {
+	const children = [];
+	if (run.fontFamily !== void 0) {
+		const font = encodeXmlText(run.fontFamily);
+		children.push(el("w:rFonts", {
+			"w:ascii": font,
+			"w:hAnsi": font
+		}));
+	}
+	if (run.bold !== void 0) children.push(toggleElement("w:b", run.bold));
+	if (run.italic !== void 0) children.push(toggleElement("w:i", run.italic));
+	if (run.strike !== void 0) children.push(toggleElement("w:strike", run.strike));
+	if (run.color !== void 0) children.push(el("w:color", { "w:val": colorToRgbHex(run.color) }));
+	if (run.sizePt !== void 0) children.push(el("w:sz", { "w:val": String(ptToHalfPoints(run.sizePt)) }));
+	if (run.underline !== void 0) children.push(el("w:u", { "w:val": run.underline ? "single" : "none" }));
+	return children.length === 0 ? void 0 : el("w:rPr", {}, children);
+}
+function buildRunContent(text, deleted) {
+	const textTag = deleted ? "w:delText" : "w:t";
+	const children = [];
+	for (const piece of text.split(/(\t|\n)/)) if (piece === "	") children.push(el("w:tab"));
+	else if (piece === "\n") children.push(el("w:br"));
+	else if (piece.length > 0) children.push(el(textTag, { "xml:space": "preserve" }, [txt(encodeXmlText(piece))]));
+	if (children.length === 0) children.push(el(textTag, { "xml:space": "preserve" }));
+	return children;
+}
+function buildRun(run, state, deleted) {
+	const rPr = buildRunProperties(run);
+	const runElement = el("w:r", {}, [...rPr === void 0 ? [] : [rPr], ...buildRunContent(run.text, deleted)]);
+	if (run.hyperlink === void 0) return runElement;
+	return el("w:hyperlink", { "r:id": hyperlinkRelationshipId(state, run.hyperlink) }, [runElement]);
+}
+const JUSTIFICATION_BY_ALIGNMENT = {
+	left: "left",
+	center: "center",
+	right: "right",
+	justify: "both"
+};
+function buildParagraphProperties(paragraph, pageBreakBefore) {
+	const children = [];
+	if (paragraph.styleId !== void 0) children.push(el("w:pStyle", { "w:val": encodeXmlText(paragraph.styleId) }));
+	if (pageBreakBefore) children.push(el("w:pageBreakBefore"));
+	if (paragraph.list !== void 0) {
+		const numPrChildren = [el("w:ilvl", { "w:val": String(paragraph.list.level) })];
+		if (paragraph.list.numId !== void 0) numPrChildren.push(el("w:numId", { "w:val": encodeXmlText(paragraph.list.numId) }));
+		children.push(el("w:numPr", {}, numPrChildren));
+	}
+	const spacing = {};
+	if (paragraph.spacingBeforePt !== void 0) spacing["w:before"] = String(ptToTwips(paragraph.spacingBeforePt));
+	if (paragraph.spacingAfterPt !== void 0) spacing["w:after"] = String(ptToTwips(paragraph.spacingAfterPt));
+	if (paragraph.lineSpacing !== void 0) {
+		spacing["w:line"] = String(Math.round(paragraph.lineSpacing * LINE_UNITS_PER_LINE));
+		spacing["w:lineRule"] = "auto";
+	}
+	if (Object.keys(spacing).length > 0) children.push(el("w:spacing", spacing));
+	const indent = {};
+	if (paragraph.indentLeftPt !== void 0) indent["w:left"] = String(ptToTwips(paragraph.indentLeftPt));
+	if (paragraph.indentFirstLinePt !== void 0) if (paragraph.indentFirstLinePt < 0) indent["w:hanging"] = String(ptToTwips(-paragraph.indentFirstLinePt));
+	else indent["w:firstLine"] = String(ptToTwips(paragraph.indentFirstLinePt));
+	if (Object.keys(indent).length > 0) children.push(el("w:ind", indent));
+	if (paragraph.alignment !== void 0) children.push(el("w:jc", { "w:val": JUSTIFICATION_BY_ALIGNMENT[paragraph.alignment] }));
+	if (paragraph.headingLevel !== void 0) children.push(el("w:outlineLvl", { "w:val": String(paragraph.headingLevel - 1) }));
+	return children.length === 0 ? void 0 : el("w:pPr", {}, children);
+}
+const LINE_UNITS_PER_LINE = 240;
+function buildParagraph(paragraph, state, pageBreakBefore, deleted, provenance) {
+	const properties = buildParagraphProperties(paragraph, pageBreakBefore);
+	const changeTag = provenance === void 0 ? void 0 : TRACKED_CHANGE_TAG_BY_CHANGE[provenance.change];
+	const pPr = properties === void 0 && changeTag !== void 0 ? el("w:pPr", {}, []) : properties;
+	if (pPr !== void 0 && changeTag !== void 0 && provenance !== void 0) pPr.children.push(el("w:rPr", {}, [el(changeTag, trackChangeAttrs(state, provenance))]));
+	const runs = paragraph.runs.map((run) => buildRun(run, state, deleted));
+	const content = changeTag === void 0 || provenance === void 0 ? runs : [el(changeTag, trackChangeAttrs(state, provenance), runs)];
+	return el("w:p", {}, [...pPr === void 0 ? [] : [pPr], ...content]);
+}
+function trailingEmptyRunElements(paragraph, element) {
+	const runElements = [];
+	for (const child of element.children) if (child.type === "element" && (child.tag === "w:r" || child.tag === "w:hyperlink")) runElements.push(child);
+	const trailing = [];
+	for (let index = paragraph.runs.length - 1; index >= 0; index--) {
+		const run = paragraph.runs[index];
+		const runElement = runElements[index];
+		if (run === void 0 || runElement === void 0 || run.text !== "" || run.hyperlink !== void 0 || runElement.tag !== "w:r") break;
+		trailing.unshift(runElement);
+	}
+	return trailing;
+}
+function buildCellBorders(borders) {
+	const edges = [];
+	const edge = (tag, border) => {
+		if (border === void 0) return;
+		const style = border.style ?? "solid";
+		edges.push(el(tag, {
+			"w:val": STROKE_STYLE_KEYWORD[style],
+			"w:sz": String(ptToEighthPoints(border.widthPt)),
+			"w:color": colorToRgbHex(border.color)
+		}));
+	};
+	edge("w:top", borders.top);
+	edge("w:left", borders.left);
+	edge("w:bottom", borders.bottom);
+	edge("w:right", borders.right);
+	return el("w:tcBorders", {}, edges);
+}
+const STROKE_STYLE_KEYWORD = {
+	solid: "single",
+	dashed: "dashed",
+	dotted: "dotted",
+	double: "double"
+};
+function buildCell(cell, state, deleted, gridSpan, vMerge) {
+	const tcPrChildren = [];
+	if (gridSpan > 1) tcPrChildren.push(el("w:gridSpan", { "w:val": String(gridSpan) }));
+	if (vMerge === "restart") tcPrChildren.push(el("w:vMerge", { "w:val": "restart" }));
+	else if (vMerge === "continue") tcPrChildren.push(el("w:vMerge"));
+	if (cell.background !== void 0) tcPrChildren.push(el("w:shd", {
+		"w:val": "clear",
+		"w:color": "auto",
+		"w:fill": colorToRgbHex(cell.background)
+	}));
+	if (cell.borders !== void 0) tcPrChildren.push(buildCellBorders(cell.borders));
+	const content = buildBlockFlow(cell.blocks, state, deleted);
+	const body = content.length === 0 ? [el("w:p")] : content;
+	return el("w:tc", {}, [...tcPrChildren.length === 0 ? [] : [el("w:tcPr", {}, tcPrChildren)], ...body]);
+}
+function buildTable(table, state, deleted) {
+	const grid = el("w:tblGrid", {}, table.columnWidthsPt.map((widthPt) => el("w:gridCol", { "w:w": String(ptToTwips(widthPt)) })));
+	const active = /* @__PURE__ */ new Map();
+	const rows = table.rows.map((row) => {
+		const cells = [];
+		let column = 0;
+		for (const cell of row.cells) {
+			const covered = active.get(column);
+			if (covered !== void 0 && covered.remaining > 0) {
+				covered.remaining--;
+				cells.push(buildCell(cell, state, deleted, covered.span, "continue"));
+				column += covered.span;
+				continue;
+			}
+			const gridSpan = cell.colSpan ?? 1;
+			const rowSpan = cell.rowSpan ?? 1;
+			cells.push(buildCell(cell, state, deleted, gridSpan, rowSpan > 1 ? "restart" : void 0));
+			if (rowSpan > 1) active.set(column, {
+				remaining: rowSpan - 1,
+				span: gridSpan
+			});
+			column += gridSpan;
+		}
+		const trPr = row.heightPt === void 0 ? void 0 : el("w:trPr", {}, [el("w:trHeight", { "w:val": String(ptToTwips(row.heightPt)) })]);
+		return el("w:tr", {}, [...trPr === void 0 ? [] : [trPr], ...cells]);
+	});
+	const tblPr = el("w:tblPr", {}, [el("w:tblW", {
+		"w:w": "0",
+		"w:type": "auto"
+	})]);
+	return el("w:tbl", {}, [
+		tblPr,
+		grid,
+		...rows
+	]);
+}
+function buildDrawing(image, state) {
+	const relId = imageRelationshipId(state, image);
+	const drawingId = state.nextDrawingId++;
+	const cx = String(ptToEmu(image.widthPt));
+	const cy = String(ptToEmu(image.heightPt));
+	const docPrAttrs = {
+		id: String(drawingId),
+		name: `Picture ${String(drawingId)}`
+	};
+	if (image.altText !== void 0) docPrAttrs.descr = encodeXmlText(image.altText);
+	const picture = el("pic:pic", { "xmlns:pic": DRAWING_PIC_NS }, [
+		el("pic:nvPicPr", {}, [el("pic:cNvPr", {
+			id: String(drawingId),
+			name: `Picture ${String(drawingId)}`
+		}), el("pic:cNvPicPr")]),
+		el("pic:blipFill", {}, [el("a:blip", { "r:embed": relId }), el("a:stretch", {}, [el("a:fillRect")])]),
+		el("pic:spPr", {}, [el("a:xfrm", {}, [el("a:off", {
+			x: "0",
+			y: "0"
+		}), el("a:ext", {
+			cx,
+			cy
+		})]), el("a:prstGeom", { prst: "rect" }, [el("a:avLst")])])
+	]);
+	return el("w:drawing", {}, [el("wp:inline", {
+		distT: "0",
+		distB: "0",
+		distL: "0",
+		distR: "0"
+	}, [
+		el("wp:extent", {
+			cx,
+			cy
+		}),
+		el("wp:docPr", docPrAttrs),
+		el("a:graphic", { "xmlns:a": DRAWINGML_NS }, [el("a:graphicData", { uri: DRAWING_PIC_NS }, [picture])])
+	])]);
+}
+const TRACKED_CHANGE_TAG_BY_CHANGE = {
+	insertion: "w:ins",
+	deletion: "w:del",
+	moveFrom: "w:moveFrom",
+	moveTo: "w:moveTo",
+	formatChange: void 0
+};
+const UNKNOWN_PROVENANCE_AUTHOR = "Unknown";
+function trackChangeAttrs(state, descriptor) {
+	const attrs = {
+		"w:id": String(state.nextMarkerId++),
+		"w:author": encodeXmlText(descriptor.author ?? UNKNOWN_PROVENANCE_AUTHOR)
+	};
+	if (descriptor.dateIso !== void 0) attrs["w:date"] = encodeXmlText(descriptor.dateIso);
+	return attrs;
+}
+const SDT_TYPE_ELEMENT = {
+	richText: "w:richText",
+	plainText: "w:text",
+	checkbox: "w14:checkbox",
+	dropDown: "w:dropDownList",
+	comboBox: "w:comboBox",
+	date: "w:date",
+	picture: "w:picture",
+	repeatingSection: "w15:repeatingSection",
+	group: "w:group",
+	button: void 0,
+	index: void 0
+};
+const SDT_LOCK_VALUE = {
+	content: "contentLocked",
+	container: "sdtLocked",
+	both: "sdtContentLocked"
+};
+function buildSdtProperties(descriptor) {
+	const children = [];
+	if (descriptor.alias !== void 0) children.push(el("w:alias", { "w:val": encodeXmlText(descriptor.alias) }));
+	if (descriptor.tag !== void 0) children.push(el("w:tag", { "w:val": encodeXmlText(descriptor.tag) }));
+	if (descriptor.lock !== void 0) children.push(el("w:lock", { "w:val": SDT_LOCK_VALUE[descriptor.lock] }));
+	if (descriptor.controlType === "index") {
+		children.push(el("w:docPartObj", {}, [el("w:docPartGallery", { "w:val": TABLE_OF_CONTENTS_GALLERY }), el("w:docPartUnique")]));
+		return el("w:sdtPr", {}, children);
+	}
+	const options = descriptor.options ?? [];
+	if (descriptor.controlType === "dropDown" || descriptor.controlType === "comboBox") {
+		const items = options.map((option) => el("w:listItem", {
+			"w:displayText": encodeXmlText(option),
+			"w:value": encodeXmlText(option)
+		}));
+		children.push(el(descriptor.controlType === "dropDown" ? "w:dropDownList" : "w:comboBox", {}, items));
+		return el("w:sdtPr", {}, children);
+	}
+	if (descriptor.controlType === "checkbox") {
+		children.push(el("w14:checkbox", {}, [el("w14:checked", { "w14:val": descriptor.checked === true ? "1" : "0" })]));
+		return el("w:sdtPr", {}, children);
+	}
+	if (descriptor.controlType === "date") {
+		children.push(el("w:date", descriptor.value === void 0 ? {} : { "w:fullDate": encodeXmlText(descriptor.value) }));
+		return el("w:sdtPr", {}, children);
+	}
+	const typeTag = SDT_TYPE_ELEMENT[descriptor.controlType];
+	children.push(el(typeTag ?? "w:richText"));
+	return el("w:sdtPr", {}, children);
+}
+function parseFlow(blocks) {
+	const imbalance = findConstructMarkerImbalance(blocks);
+	if (imbalance !== void 0) throw new Error(`buildDocxPackage: construct markers do not balance (${imbalance.kind} at block ${String(imbalance.index)})`);
+	const roots = [];
+	const stack = [roots];
+	for (const block of blocks) {
+		const current = stack[stack.length - 1];
+		if (block.kind === "constructStart") {
+			const item = {
+				kind: "construct",
+				descriptor: block.descriptor,
+				children: []
+			};
+			current.push(item);
+			stack.push(item.children);
+			continue;
+		}
+		if (block.kind === "constructEnd") {
+			stack.pop();
+			continue;
+		}
+		current.push({
+			kind: "block",
+			block
+		});
+	}
+	return roots;
+}
+function findParagraph(nodes, last) {
+	const ordered = last ? [...nodes].reverse() : nodes;
+	for (const node of ordered) {
+		if (node.type !== "element") continue;
+		if (node.tag === "w:p") return node;
+		if (node.tag === "w:tbl") continue;
+		const nested = findParagraph(node.children, last);
+		if (nested !== void 0) return nested;
+	}
+}
+function fieldCharRun(type) {
+	return el("w:r", {}, [el("w:fldChar", { "w:fldCharType": type })]);
+}
+function fieldOpeningRuns(instruction) {
+	return [
+		fieldCharRun("begin"),
+		el("w:r", {}, [el("w:instrText", { "xml:space": "preserve" }, [txt(encodeXmlText(instruction))])]),
+		fieldCharRun("separate")
+	];
+}
+function insertAfterProperties(paragraph, runs) {
+	const first = paragraph.children[0];
+	const offset = first?.type === "element" && first.tag === "w:pPr" ? 1 : 0;
+	paragraph.children.splice(offset, 0, ...runs);
+}
+function buildFieldNodes(instruction, content) {
+	const first = findParagraph(content, false);
+	const last = findParagraph(content, true);
+	if (first === void 0 || last === void 0) return [
+		el("w:p", {}, fieldOpeningRuns(instruction)),
+		...content,
+		el("w:p", {}, [fieldCharRun("end")])
+	];
+	insertAfterProperties(first, fieldOpeningRuns(instruction));
+	last.children.push(fieldCharRun("end"));
+	return content;
+}
+function buildConstructNodes(descriptor, children, state, deleted, provenance) {
+	if (descriptor.kind === "contentControl") return [el("w:sdt", {}, [buildSdtProperties(descriptor), el("w:sdtContent", {}, buildFlowItems(children, state, deleted, provenance))])];
+	if (descriptor.kind === "provenance") {
+		if (TRACKED_CHANGE_TAG_BY_CHANGE[descriptor.change] !== void 0) return buildFlowItems(children, state, deleted || isDeletedChange(descriptor.change), descriptor);
+	}
+	if (descriptor.kind === "anchor" && descriptor.anchorType === "bookmark") {
+		const id = String(state.nextMarkerId++);
+		return [
+			el("w:bookmarkStart", {
+				"w:id": id,
+				"w:name": encodeXmlText(descriptor.name)
+			}),
+			...buildFlowItems(children, state, deleted, provenance),
+			el("w:bookmarkEnd", { "w:id": id })
+		];
+	}
+	if (descriptor.kind === "field") return buildFieldNodes(descriptor.instruction, buildFlowItems(children, state, deleted, provenance));
+	return buildFlowItems(children, state, deleted, provenance);
+}
+function buildFlowItems(items, state, deleted, provenance) {
+	const nodes = [];
+	let pendingPageBreak = false;
+	let lastParagraph;
+	let availableImageRuns = [];
+	for (const item of items) {
+		if (item.kind === "construct") {
+			const constructChildren = pendingPageBreak ? [{
+				kind: "block",
+				block: { kind: "pageBreak" }
+			}, ...item.children] : item.children;
+			nodes.push(...buildConstructNodes(item.descriptor, constructChildren, state, deleted, provenance));
+			pendingPageBreak = false;
+			lastParagraph = void 0;
+			availableImageRuns = [];
+			continue;
+		}
+		const block = item.block;
+		if (block.kind === "pageBreak") {
+			pendingPageBreak = true;
+			continue;
+		}
+		if (block.kind === "paragraph") {
+			const paragraph = buildParagraph(block, state, pendingPageBreak, deleted, provenance);
+			pendingPageBreak = false;
+			lastParagraph = paragraph;
+			availableImageRuns = trailingEmptyRunElements(block, paragraph);
+			nodes.push(paragraph);
+			continue;
+		}
+		if (block.kind === "image") {
+			if (pendingPageBreak) {
+				const breakParagraph = el("w:p", {}, [el("w:pPr", {}, [el("w:pageBreakBefore")])]);
+				nodes.push(breakParagraph);
+				lastParagraph = breakParagraph;
+				availableImageRuns = [];
+				pendingPageBreak = false;
+			}
+			const drawing = buildDrawing(block, state);
+			const reusable = availableImageRuns.shift();
+			if (reusable !== void 0) reusable.children.push(drawing);
+			else if (lastParagraph !== void 0) lastParagraph.children.push(el("w:r", {}, [drawing]));
+			else {
+				const paragraph = el("w:p", {}, [el("w:r", {}, [drawing])]);
+				lastParagraph = paragraph;
+				nodes.push(paragraph);
+			}
+			continue;
+		}
+		if (block.kind === "table") {
+			if (pendingPageBreak) {
+				nodes.push(el("w:p", {}, [el("w:pPr", {}, [el("w:pageBreakBefore")])]));
+				pendingPageBreak = false;
+			}
+			nodes.push(buildTable(block, state, deleted));
+			lastParagraph = void 0;
+			availableImageRuns = [];
+			continue;
+		}
+		lastParagraph = void 0;
+		availableImageRuns = [];
+	}
+	if (pendingPageBreak) nodes.push(el("w:p", {}, [el("w:pPr", {}, [el("w:pageBreakBefore")])]));
+	return nodes;
+}
+function buildBlockFlow(blocks, state, deleted) {
+	return buildFlowItems(parseFlow(blocks), state, deleted, void 0);
+}
+function buildSectionProperties(section) {
+	return el("w:sectPr", {}, [el("w:pgSz", {
+		"w:w": String(ptToTwips(section.pageSize.widthPt)),
+		"w:h": String(ptToTwips(section.pageSize.heightPt))
+	}), el("w:pgMar", {
+		"w:top": String(ptToTwips(section.margins.topPt)),
+		"w:right": String(ptToTwips(section.margins.rightPt)),
+		"w:bottom": String(ptToTwips(section.margins.bottomPt)),
+		"w:left": String(ptToTwips(section.margins.leftPt))
+	})]);
+}
+function attachSectionBreak(nodes, section) {
+	const target = findParagraph(nodes, true);
+	if (target === void 0) {
+		nodes.push(el("w:p", {}, [el("w:pPr", {}, [buildSectionProperties(section)])]));
+		return;
+	}
+	const first = target.children[0];
+	if (first?.type === "element" && first.tag === "w:pPr") {
+		first.children.push(buildSectionProperties(section));
+		return;
+	}
+	target.children.unshift(el("w:pPr", {}, [buildSectionProperties(section)]));
+}
+function buildDocumentPart(sections, state) {
+	const bodyChildren = [];
+	sections.forEach((section, index) => {
+		const nodes = buildBlockFlow(section.blocks, state, false);
+		if (index === sections.length - 1) {
+			bodyChildren.push(...nodes, buildSectionProperties(section));
+			return;
+		}
+		attachSectionBreak(nodes, section);
+		bodyChildren.push(...nodes);
+	});
+	return xmlPart(el("w:document", {
+		"xmlns:w": WML_NS,
+		"xmlns:r": REL_NS,
+		"xmlns:a": DRAWINGML_NS,
+		"xmlns:wp": DRAWING_WP_NS,
+		"xmlns:pic": DRAWING_PIC_NS,
+		"xmlns:mc": MARKUP_COMPAT_NS,
+		"xmlns:w14": W14_NS,
+		"xmlns:w15": W15_NS,
+		"mc:Ignorable": "w14 w15"
+	}, [el("w:body", {}, bodyChildren)]));
+}
+function buildContentTypesPart(mediaFormats) {
+	const defaults = [el("Default", {
+		Extension: "rels",
+		ContentType: "application/vnd.openxmlformats-package.relationships+xml"
+	}), el("Default", {
+		Extension: "xml",
+		ContentType: "application/xml"
+	})];
+	if (mediaFormats.has("png")) defaults.push(el("Default", {
+		Extension: "png",
+		ContentType: "image/png"
+	}));
+	if (mediaFormats.has("jpeg")) defaults.push(el("Default", {
+		Extension: "jpeg",
+		ContentType: "image/jpeg"
+	}));
+	return xmlPart(el("Types", { xmlns: CONTENT_TYPES_NS }, [
+		...defaults,
+		el("Override", {
+			PartName: `/${DOCUMENT_PART_PATH}`,
+			ContentType: CT_DOCUMENT
+		}),
+		el("Override", {
+			PartName: "/docProps/core.xml",
+			ContentType: CT_CORE_PROPS
+		}),
+		el("Override", {
+			PartName: "/docProps/app.xml",
+			ContentType: CT_EXTENDED_PROPS
+		})
+	]));
+}
+function buildPackageRelsPart() {
+	return xmlPart(el("Relationships", { xmlns: PKG_RELS_NS }, [
+		el("Relationship", {
+			Id: "rId1",
+			Type: REL_OFFICE_DOCUMENT,
+			Target: DOCUMENT_PART_PATH
+		}),
+		el("Relationship", {
+			Id: "rId2",
+			Type: REL_CORE_PROPS,
+			Target: "docProps/core.xml"
+		}),
+		el("Relationship", {
+			Id: "rId3",
+			Type: REL_EXTENDED_PROPS,
+			Target: "docProps/app.xml"
+		})
+	]));
+}
+function buildDocumentRelsPart(state) {
+	const relationships = state.relationships.map((rel) => el("Relationship", rel.external ? {
+		Id: rel.id,
+		Type: rel.type,
+		Target: rel.target,
+		TargetMode: "External"
+	} : {
+		Id: rel.id,
+		Type: rel.type,
+		Target: rel.target
+	}));
+	return xmlPart(el("Relationships", { xmlns: PKG_RELS_NS }, relationships));
+}
+function buildCorePropertiesPart(metadata) {
+	const children = [];
+	if (metadata.title !== void 0) children.push(el("dc:title", {}, [txt(encodeXmlText(metadata.title))]));
+	if (metadata.author !== void 0) children.push(el("dc:creator", {}, [txt(encodeXmlText(metadata.author))]));
+	if (metadata.subject !== void 0) children.push(el("dc:subject", {}, [txt(encodeXmlText(metadata.subject))]));
+	if (metadata.keywords !== void 0 && metadata.keywords.length > 0) children.push(el("cp:keywords", {}, [txt(encodeXmlText(metadata.keywords.join(", ")))]));
+	if (metadata.createdIso !== void 0) children.push(el("dcterms:created", { "xsi:type": "dcterms:W3CDTF" }, [txt(encodeXmlText(metadata.createdIso))]));
+	if (metadata.modifiedIso !== void 0) children.push(el("dcterms:modified", { "xsi:type": "dcterms:W3CDTF" }, [txt(encodeXmlText(metadata.modifiedIso))]));
+	return xmlPart(el("cp:coreProperties", {
+		"xmlns:cp": CORE_PROPS_NS,
+		"xmlns:dc": DC_NS,
+		"xmlns:dcterms": DCTERMS_NS,
+		"xmlns:xsi": XSI_NS
+	}, children));
+}
+function buildExtendedPropertiesPart(metadata) {
+	const children = [];
+	if (metadata.creator !== void 0) children.push(el("Application", {}, [txt(encodeXmlText(metadata.creator))]));
+	return xmlPart(el("Properties", { xmlns: EXTENDED_PROPS_NS }, children));
+}
+function buildDocxPackage(content) {
+	const state = newWriteState();
+	const documentPart = buildDocumentPart(content.sections.length === 0 ? [{
+		pageSize: {
+			widthPt: 612,
+			heightPt: 792
+		},
+		margins: {
+			topPt: 72,
+			rightPt: 72,
+			bottomPt: 72,
+			leftPt: 72
+		},
+		blocks: []
+	}] : content.sections, state);
+	const metadata = content.metadata ?? {};
+	const parts = {
+		"[Content_Types].xml": buildContentTypesPart(new Set([...state.mediaParts.values()].map((media) => media.format))),
+		"_rels/.rels": buildPackageRelsPart(),
+		[DOCUMENT_PART_PATH]: documentPart,
+		"word/_rels/document.xml.rels": buildDocumentRelsPart(state),
+		"docProps/core.xml": buildCorePropertiesPart(metadata),
+		"docProps/app.xml": buildExtendedPropertiesPart(metadata)
+	};
+	for (const [name, media] of state.mediaParts) parts[`word/media/${name}`] = {
+		kind: "binary",
+		base64: media.base64
+	};
+	return { parts };
+}
+//#endregion
+export { buildDocxPackage };

package/dist/typed/shared/source-path.cjs

@@ -2,6 +2,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 //#region src/typed/shared/source-path.ts
 function assignSourcePaths(blocks, prefix) {
 	blocks.forEach((block, blockIndex) => {
+		if (block.kind === "constructStart" || block.kind === "constructEnd") return;
 		const blockPath = `${prefix}.blocks[${blockIndex}]`;
 		block.sourcePath = blockPath;
 		if (block.kind === "paragraph") block.runs.forEach((run, runIndex) => {

package/dist/typed/shared/source-path.js

@@ -1,6 +1,7 @@
 //#region src/typed/shared/source-path.ts
 function assignSourcePaths(blocks, prefix) {
 	blocks.forEach((block, blockIndex) => {
+		if (block.kind === "constructStart" || block.kind === "constructEnd") return;
 		const blockPath = `${prefix}.blocks[${blockIndex}]`;
 		block.sourcePath = blockPath;
 		if (block.kind === "paragraph") block.runs.forEach((run, runIndex) => {