reamkit 1.30.0 → 1.31.0

package/dist/esm/word/docx-writer.js

@@ -6,6 +6,7 @@ import { buildOpcPackage } from "../core/opc/opc-writer.js";
 import "../core/opc/index.js";
 import { omathXml } from "./omml-serializer.js";
 import { chartSpaceXml } from "../core/drawingml/chart-serializer.js";
+import { OBFUSCATED_FONT_CONTENT_TYPE, embedFaces } from "./font-embed.js";
 //#region src/word/docx-writer.ts
 var encoder = new TextEncoder();
 var DEFAULT_RUN = resolveRunProperties({}, {}, EMPTY_STYLE_SHEET);
@@ -20,6 +21,12 @@ var NUMBERING_PART = "word/numbering.xml";
 var REL_FONT_TABLE = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/fontTable";
 var FONT_TABLE_CONTENT_TYPE = "application/vnd.openxmlformats-officedocument.wordprocessingml.fontTable+xml";
 var FONT_TABLE_PART = "word/fontTable.xml";
+var REL_SETTINGS = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/settings";
+var SETTINGS_CONTENT_TYPE = "application/vnd.openxmlformats-officedocument.wordprocessingml.settings+xml";
+var SETTINGS_PART = "word/settings.xml";
+var REL_STYLES = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/styles";
+var STYLES_CONTENT_TYPE = "application/vnd.openxmlformats-officedocument.wordprocessingml.styles+xml";
+var STYLES_PART = "word/styles.xml";
 var REL_FOOTNOTES = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/footnotes";
 var REL_ENDNOTES = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/endnotes";
 var FOOTNOTES_CONTENT_TYPE = "application/vnd.openxmlformats-officedocument.wordprocessingml.footnotes+xml";
@@ -33,6 +40,20 @@ var REL_COMMENTS_EXTENDED = "http://schemas.microsoft.com/office/2011/relationsh
 var COMMENTS_EXTENDED_CONTENT_TYPE = "application/vnd.openxmlformats-officedocument.wordprocessingml.commentsExtended+xml";
 var COMMENTS_EXTENDED_PART = "word/commentsExtended.xml";
 var W14_NS = "http://schemas.microsoft.com/office/word/2010/wordml";
+var MC_NS = "http://schemas.openxmlformats.org/markup-compatibility/2006";
+/**
+* The namespaces a part's root declares: WordprocessingML's and the
+* relationships', and — where the part uses one — Word 2010's `w14`, which a
+* reader that does not know it is told to pass over (ECMA-376 Part 3
+* `mc:Ignorable`) rather than to refuse the file.
+*
+* @param inner The part's content, to see whether it uses `w14`.
+* @returns The attributes, each with its leading space.
+*/
+function rootNamespaces(inner) {
+	const base = " xmlns:w=\"http://schemas.openxmlformats.org/wordprocessingml/2006/main\" xmlns:r=\"http://schemas.openxmlformats.org/officeDocument/2006/relationships\"";
+	return inner.includes("<w14:") ? `${base} xmlns:w14="${W14_NS}" xmlns:mc="${MC_NS}" mc:Ignorable="w14"` : base;
+}
 var W15_NS = "http://schemas.microsoft.com/office/word/2012/wordml";
 var REL_CHART = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/chart";
 var CHART_CONTENT_TYPE = "application/vnd.openxmlformats-officedocument.drawingml.chart+xml";
@@ -133,6 +154,8 @@ function writeDocx(flow) {
 		...flow.charts ? { charts: flow.charts } : {},
 		...flow.faceFamilies ? { faceFamilies: flow.faceFamilies } : {},
 		familiesUsed: /* @__PURE__ */ new Map(),
+		...flow.faceOutlines ? { faceOutlines: flow.faceOutlines } : {},
+		facesUsed: /* @__PURE__ */ new Set(),
 		zRanks: zRanksOf(flow)
 	};
 	const docScope = newScope();
@@ -153,7 +176,8 @@ function writeDocx(flow) {
 	});
 	emitBody(body, flow.body, losses, state, docScope, sectPrByClosingIndex);
 	if (finalSectPr) body.push(finalSectPr);
-	const documentXml = `<?xml version="1.0" encoding="UTF-8" standalone="yes"?><w:document xmlns:w="http://schemas.openxmlformats.org/wordprocessingml/2006/main" xmlns:r="http://schemas.openxmlformats.org/officeDocument/2006/relationships"><w:body>${body.join("")}</w:body></w:document>`;
+	const bodyXml = body.join("");
+	const documentXml = `<?xml version="1.0" encoding="UTF-8" standalone="yes"?><w:document${rootNamespaces(bodyXml)}><w:body>${bodyXml}</w:body></w:document>`;
 	const numberingPart = flow.body.some((el) => el.kind === "paragraph" && el.paragraph.properties.numbering !== void 0) && flow.numbering ? {
 		path: NUMBERING_PART,
 		data: encoder.encode(numberingXml(flow.numbering)),
@@ -185,9 +209,14 @@ function writeDocx(flow) {
 	}, state, losses, docScope, extraParts, extraPartRels);
 	const commentParaIds = emitComments(flow.comments, state, losses, docScope, extraParts, extraPartRels);
 	emitCommentsExtended(flow.comments, commentParaIds, docScope, extraParts);
+	const embedded = state.faceOutlines && state.faceFamilies ? embedFaces(state.facesUsed, state.faceOutlines, state.faceFamilies, losses) : void 0;
+	if (embedded && embedded.relationships.length > 0) extraPartRels.push({
+		sourcePart: FONT_TABLE_PART,
+		relationships: [...embedded.relationships]
+	});
 	const fontTablePart = state.familiesUsed.size > 0 ? {
 		path: FONT_TABLE_PART,
-		data: encoder.encode(fontTableXml(state.familiesUsed)),
+		data: encoder.encode(fontTableXml(state.familiesUsed, embedded?.elements)),
 		contentType: FONT_TABLE_CONTENT_TYPE
 	} : void 0;
 	if (fontTablePart) docScope.rels.push({
@@ -196,6 +225,29 @@ function writeDocx(flow) {
 		target: "fontTable.xml",
 		targetMode: "Internal"
 	});
+	const settings = settingsXml(flow, sections, (embedded?.parts.length ?? 0) > 0);
+	const settingsPart = settings !== void 0 ? {
+		path: SETTINGS_PART,
+		data: encoder.encode(settings),
+		contentType: SETTINGS_CONTENT_TYPE
+	} : void 0;
+	if (settingsPart) docScope.rels.push({
+		id: `rId${++docScope.relSeq}`,
+		type: REL_SETTINGS,
+		target: "settings.xml",
+		targetMode: "Internal"
+	});
+	const stylesPart = {
+		path: STYLES_PART,
+		data: encoder.encode(stylesXml()),
+		contentType: STYLES_CONTENT_TYPE
+	};
+	docScope.rels.push({
+		id: `rId${++docScope.relSeq}`,
+		type: REL_STYLES,
+		target: "styles.xml",
+		targetMode: "Internal"
+	});
 	const partRelationships = [...docScope.rels.length > 0 ? [{
 		sourcePart: "word/document.xml",
 		relationships: docScope.rels
@@ -208,12 +260,16 @@ function writeDocx(flow) {
 					data: encoder.encode(documentXml),
 					contentType: DOC_CONTENT_TYPE
 				},
+				stylesPart,
 				...numberingPart ? [numberingPart] : [],
 				...fontTablePart ? [fontTablePart] : [],
+				...settingsPart ? [settingsPart] : [],
 				...extraParts,
 				...state.chartParts,
-				...state.mediaParts
+				...state.mediaParts,
+				...embedded?.parts ?? []
 			],
+			...(embedded?.parts.length ?? 0) > 0 ? { defaultsByExtension: { odttf: OBFUSCATED_FONT_CONTENT_TYPE } } : {},
 			rootRelationships: [{
 				id: "rId1",
 				type: REL_OFFICE_DOCUMENT,
@@ -225,8 +281,50 @@ function writeDocx(flow) {
 		losses
 	};
 }
-function fontTableXml(families) {
-	return `<?xml version="1.0" encoding="UTF-8" standalone="yes"?><w:fonts xmlns:w="http://schemas.openxmlformats.org/wordprocessingml/2006/main">${[...families.values()].map((f) => `<w:font w:name="${escapeAttr(f.family)}"><w:family w:val="${f.generic}"/><w:pitch w:val="${f.generic === "modern" ? "fixed" : "variable"}"/></w:font>`).join("")}</w:fonts>`;
+/**
+* §17.15.1.78 `w:settings` — the document-wide settings the model carries, in
+* the order CT_Settings declares them: `w:embedTrueTypeFonts` and
+* `w:saveSubsetFonts` (§17.15.1.42, .74) where the package embeds its faces,
+* `w:gutterAtTop` (§17.15.1.49), `w:evenAndOddHeaders` (§17.15.1.36, which a
+* section carries in the model), and inside `w:compat` §17.15.3.4's
+* `w:doNotExpandShiftReturn` before the version of Word the document is laid
+* out for ([MS-DOCX] `w:compatSetting` `compatibilityMode`), which CT_Compat
+* keeps last.
+*
+* @param flow        The document.
+* @param sections    The sections being written.
+* @param embedsFonts Whether the package embeds fonts — which then stay
+*                    embedded, as subsets, when the document is saved again.
+* @returns The part's XML, or undefined where the document states none.
+*/
+function settingsXml(flow, sections, embedsFonts) {
+	const parts = [];
+	if (embedsFonts) parts.push("<w:embedTrueTypeFonts/><w:saveSubsetFonts/>");
+	if (flow.gutterAtTop === true) parts.push("<w:gutterAtTop/>");
+	if (sections.some((sec) => sec.properties.evenAndOddHeaders === true)) parts.push("<w:evenAndOddHeaders/>");
+	const compat = [...flow.doNotExpandShiftReturn === true ? ["<w:doNotExpandShiftReturn/>"] : [], ...flow.compatibilityMode !== void 0 ? [`<w:compatSetting w:name="compatibilityMode" w:uri="http://schemas.microsoft.com/office/word" w:val="${String(flow.compatibilityMode)}"/>`] : []];
+	if (compat.length > 0) parts.push(`<w:compat>${compat.join("")}</w:compat>`);
+	if (parts.length === 0) return void 0;
+	return `<?xml version="1.0" encoding="UTF-8" standalone="yes"?><w:settings xmlns:w="http://schemas.openxmlformats.org/wordprocessingml/2006/main">${parts.join("")}</w:settings>`;
+}
+/**
+* §17.7.2 `w:styles` — what a property the document states nowhere IS: the
+* values the model resolves an empty sheet to (`DEFAULT_RUN`, `DEFAULT_PARA`
+* — the very values a run or paragraph is written without), as §17.7.5
+* `w:docDefaults`, under an empty default paragraph style (§17.7.4.17).
+*
+* A package with no styles part leaves them to its reader, and Word fills
+* them from its own template's Normal: 8pt after every paragraph, lines 1.08
+* apart, runs in 12pt — so every paragraph of a reconstruction stood 8pt
+* further down than its page set it, and a run of the model's own 11pt, which
+* states no size, was set in 12.
+*/
+function stylesXml() {
+	const size = Math.round(DEFAULT_RUN.fontSizePt * 2);
+	return `<?xml version="1.0" encoding="UTF-8" standalone="yes"?><w:styles xmlns:w="http://schemas.openxmlformats.org/wordprocessingml/2006/main"><w:docDefaults><w:rPrDefault><w:rPr><w:sz w:val="${size}"/><w:szCs w:val="${size}"/></w:rPr></w:rPrDefault><w:pPrDefault><w:pPr>${DEFAULT_PARA.widowControl ? "<w:widowControl/>" : "<w:widowControl w:val=\"0\"/>"}${`<w:spacing w:before="${twips(DEFAULT_PARA.spacingBefore)}" w:after="${twips(DEFAULT_PARA.spacingAfter)}" w:line="${twips(DEFAULT_PARA.spacingLine)}" w:lineRule="${DEFAULT_PARA.spacingLineRule}"/>`}</w:pPr></w:pPrDefault></w:docDefaults><w:style w:type="paragraph" w:default="1" w:styleId="Normal"><w:name w:val="Normal"/></w:style></w:styles>`;
+}
+function fontTableXml(families, embeds) {
+	return `<?xml version="1.0" encoding="UTF-8" standalone="yes"?><w:fonts xmlns:w="http://schemas.openxmlformats.org/wordprocessingml/2006/main" xmlns:r="http://schemas.openxmlformats.org/officeDocument/2006/relationships">${[...families.values()].map((f) => `<w:font w:name="${escapeAttr(f.family)}"><w:family w:val="${f.generic}"/><w:pitch w:val="${f.generic === "modern" ? "fixed" : "variable"}"/>${embeds?.get(f.family) ?? ""}</w:font>`).join("")}</w:fonts>`;
 }
 /**
 * §20.4.2.3 `relativeHeight` — a float's z-order, written the way Word writes
@@ -277,7 +375,8 @@ function emitNotes(notes, cfg, state, losses, docScope, extraParts, extraPartRel
 		for (const el of content) emitBlock(inner, el, losses, state, scope);
 		noteXmls.push(`<${cfg.noteTag} w:id="${escapeAttr(id)}">${inner.join("") || "<w:p/>"}</${cfg.noteTag}>`);
 	}
-	const xml = `<?xml version="1.0" encoding="UTF-8" standalone="yes"?><${cfg.rootTag} xmlns:w="http://schemas.openxmlformats.org/wordprocessingml/2006/main" xmlns:r="http://schemas.openxmlformats.org/officeDocument/2006/relationships">` + stub("separator", -1, "<w:separator/>") + stub("continuationSeparator", 0, "<w:continuationSeparator/>") + noteXmls.join("") + `</${cfg.rootTag}>`;
+	const notesXml = noteXmls.join("");
+	const xml = `<?xml version="1.0" encoding="UTF-8" standalone="yes"?><${cfg.rootTag}${rootNamespaces(notesXml)}>` + stub("separator", -1, "<w:separator/>") + stub("continuationSeparator", 0, "<w:continuationSeparator/>") + notesXml + `</${cfg.rootTag}>`;
 	extraParts.push({
 		path: cfg.partPath,
 		data: encoder.encode(xml),
@@ -383,7 +482,8 @@ function emitHeadersFooters(flow, section, state, docScope, extraParts, extraPar
 		const scope = newScope();
 		const inner = [];
 		for (const el of content) emitBlock(inner, el, losses, state, scope);
-		const xml = `<?xml version="1.0" encoding="UTF-8" standalone="yes"?><${root} xmlns:w="http://schemas.openxmlformats.org/wordprocessingml/2006/main" xmlns:r="http://schemas.openxmlformats.org/officeDocument/2006/relationships">${inner.join("")}</${root}>`;
+		const bandXml = inner.join("");
+		const xml = `<?xml version="1.0" encoding="UTF-8" standalone="yes"?><${root}${rootNamespaces(bandXml)}>${bandXml}</${root}>`;
 		extraParts.push({
 			path,
 			data: encoder.encode(xml),
@@ -427,7 +527,7 @@ function emitHeadersFooters(flow, section, state, docScope, extraParts, extraPar
 var docxWriter = {
 	id: "docx",
 	consumes: "flow",
-	supports: new Set([FEATURES.text]),
+	supports: new Set([FEATURES.text, FEATURES.fontsEmbedding]),
 	write: (doc) => writeDocx(doc)
 };
 /**
@@ -636,13 +736,76 @@ function shapeDrawingXml(shape, losses, state, scope) {
 	const cy = Math.round(shape.height * EMU_PER_PT);
 	const id = ++state.drawingSeq;
 	const descr = shape.altText ? ` descr="${escapeAttr(shape.altText)}"` : "";
-	const spPr = `<wps:spPr>${xfrmXml(shape.transform, cx, cy)}${geomXml(shape.geometry)}${fillXml(shape.fill)}${shape.line ? lineXml(shape.line) : ""}</wps:spPr>`;
-	const txbx = shape.text ? txbxXml(shape.text, losses, state, scope) : "";
-	const graphic = `<a:graphic xmlns:a="http://schemas.openxmlformats.org/drawingml/2006/main"><a:graphicData uri="${WPS_URI}"><wps:wsp xmlns:wps="http://schemas.microsoft.com/office/word/2010/wordprocessingShape"><wps:cNvSpPr/>` + spPr + txbx + bodyPrXml(shape.text) + "</wps:wsp></a:graphicData></a:graphic>";
+	const members = shape.children ?? [];
+	const graphic = "<a:graphic xmlns:a=\"http://schemas.openxmlformats.org/drawingml/2006/main\">" + (members.length > 0 ? `<a:graphicData uri="${WPG_URI}">` + groupXml("wpg:wgp", members, {
+		x: 0,
+		y: 0,
+		cx,
+		cy
+	}, losses, state, scope) : `<a:graphicData uri="${WPS_URI}">` + wspXml(shape, cx, cy, void 0, losses, state, scope)) + "</a:graphicData></a:graphic>";
 	return drawingFrame(shape.float, cx, cy, `<wp:docPr id="${id}" name="Shape ${id}"${descr}/>`, graphic, state, shape.transform?.rotation60k);
 }
-function xfrmXml(t, cx, cy) {
-	return `<a:xfrm${t?.rotation60k !== void 0 ? ` rot="${t.rotation60k}"` : ""}${t?.flipH ? " flipH=\"1\"" : ""}${t?.flipV ? " flipV=\"1\"" : ""}><a:off x="0" y="0"/><a:ext cx="${cx}" cy="${cy}"/></a:xfrm>`;
+/**
+* `wps:wsp` — one shape: its box, geometry, fill and outline, and the text it
+* holds. `id` is its own `wps:cNvPr` inside a group, where the members name
+* themselves; a shape alone is named by the frame's `wp:docPr`.
+*/
+function wspXml(shape, cx, cy, member, losses, state, scope) {
+	const spPr = `<wps:spPr>${xfrmXml(shape.transform, cx, cy, member)}${geomXml(shape.geometry)}${fillXml(shape.fill)}${shape.line ? lineXml(shape.line) : ""}</wps:spPr>`;
+	const txbx = shape.text ? txbxXml(shape.text, losses, state, scope) : "";
+	return `<wps:wsp xmlns:wps="${WPS_URI}">` + (member ? `<wps:cNvPr id="${member.id}" name="Shape ${member.id}"/>` : "") + "<wps:cNvSpPr/>" + spPr + txbx + bodyPrXml(shape.text) + "</wps:wsp>";
+}
+var WPG_URI = "http://schemas.microsoft.com/office/word/2010/wordprocessingGroup";
+/**
+* §20.5.2.17 `wpg:wgp` / `wpg:grpSp` — a group: its box, and its members in
+* the order they are painted. The members are placed in a child space the
+* same as the box, so a member's offset from the group's corner is its offset
+* in the file. The inverse of drawing-parser's `groupChildren`.
+*
+* Written as one shape, the group came back an empty box: a figure's paths
+* and labels were thrown away with it.
+*/
+function groupXml(tag, members, box, losses, state, scope) {
+	return `<${tag}${tag === "wpg:wgp" ? ` xmlns:wpg="${WPG_URI}"` : ""}><wpg:cNvGrpSpPr/><wpg:grpSpPr>${`<a:xfrm><a:off x="${box.x}" y="${box.y}"/><a:ext cx="${box.cx}" cy="${box.cy}"/><a:chOff x="0" y="0"/><a:chExt cx="${box.cx}" cy="${box.cy}"/></a:xfrm>`}</wpg:grpSpPr>${members.map((m) => memberXml(m, losses, state, scope)).join("")}</${tag}>`;
+}
+/**
+* One member of a group: a group of its own, a picture (`pic:pic`, a shape
+* whose fill is the picture — how the reader brings one in), or a shape.
+*/
+function memberXml(member, losses, state, scope) {
+	const s = member.shape;
+	const x = Math.round(member.xPt * EMU_PER_PT);
+	const y = Math.round(member.yPt * EMU_PER_PT);
+	const cx = Math.round(s.width * EMU_PER_PT);
+	const cy = Math.round(s.height * EMU_PER_PT);
+	if (s.children !== void 0 && s.children.length > 0) return groupXml("wpg:grpSp", s.children, {
+		x,
+		y,
+		cx,
+		cy
+	}, losses, state, scope);
+	const id = ++state.drawingSeq;
+	if (s.fill.kind !== "picture") return wspXml(s, cx, cy, {
+		id,
+		x,
+		y
+	}, losses, state, scope);
+	const relId = s.fill.imageResource !== void 0 ? mediaRelId(s.fill.imageResource, state, scope) : void 0;
+	if (relId === void 0) {
+		losses.push({
+			severity: "dropped",
+			feature: FEATURES.images,
+			detail: imageRefusal(s.fill.imageResource, state)
+		});
+		return "";
+	}
+	return `<pic:pic xmlns:pic="http://schemas.openxmlformats.org/drawingml/2006/picture"><pic:nvPicPr><pic:cNvPr id="${id}" name="Image ${id}"/><pic:cNvPicPr/></pic:nvPicPr><pic:blipFill><a:blip r:embed="${relId}">${s.fill.alpha !== void 0 && s.fill.alpha < 1 ? `<a:alphaModFix amt="${String(Math.round(Math.max(0, s.fill.alpha) * 1e5))}"/>` : ""}</a:blip>${srcRectXml(s.fill.imageCrop)}<a:stretch><a:fillRect/></a:stretch></pic:blipFill><pic:spPr>${xfrmXml(s.transform, cx, cy, {
+		x,
+		y
+	})}<a:prstGeom prst="rect"><a:avLst/></a:prstGeom></pic:spPr></pic:pic>`;
+}
+function xfrmXml(t, cx, cy, at) {
+	return `<a:xfrm${t?.rotation60k !== void 0 ? ` rot="${t.rotation60k}"` : ""}${t?.flipH ? " flipH=\"1\"" : ""}${t?.flipV ? " flipV=\"1\"" : ""}><a:off x="${at?.x ?? 0}" y="${at?.y ?? 0}"/><a:ext cx="${cx}" cy="${cy}"/></a:xfrm>`;
 }
 /**
 * The factor that carries a path into whole units, and the space it lands in.
@@ -668,7 +831,7 @@ function pathScale(g) {
 	else if (c.cmd === "quad") values.push(c.x1, c.y1, c.x, c.y);
 	else if (c.cmd === "arc") values.push(c.wR, c.hR);
 	if (values.every((v) => Number.isInteger(v))) return 1;
-	const span = Math.max(...values.map((v) => Number.isFinite(v) ? Math.abs(v) : 0), 1);
+	const span = values.reduce((most, v) => Number.isFinite(v) ? Math.max(most, Math.abs(v)) : most, 1);
 	return Math.max(1, Math.floor(PATH_SPACE / span));
 }
 function geomXml(g) {
@@ -736,7 +899,7 @@ function bodyPrXml(text) {
 	if (!text) return "<wps:bodyPr/>";
 	const ins = (v, name) => v !== void 0 ? ` ${name}="${Math.round(v * EMU_PER_PT)}"` : "";
 	const anchor = text.anchor ? ` anchor="${text.anchor}"` : "";
-	return "<wps:bodyPr" + ins(text.insetLeft, "lIns") + ins(text.insetTop, "tIns") + ins(text.insetRight, "rIns") + ins(text.insetBottom, "bIns") + anchor + "/>";
+	return "<wps:bodyPr" + (text.noWrap === true ? " wrap=\"none\"" : "") + ins(text.insetLeft, "lIns") + ins(text.insetTop, "tIns") + ins(text.insetRight, "rIns") + ins(text.insetBottom, "bIns") + anchor + "/>";
 }
 function mediaRelId(resource, state, scope) {
 	const existingRel = scope.relIdByResource.get(resource);
@@ -787,6 +950,7 @@ function tblPrXml(p) {
 		out.push(`<w:tblW w:w="${w}" w:type="${p.widthType}"/>`);
 	}
 	if (p.alignment && p.alignment !== "left") out.push(`<w:jc w:val="${p.alignment}"/>`);
+	if (p.indentPt !== void 0 && p.indentPt !== 0) out.push(`<w:tblInd w:w="${twips(p.indentPt)}" w:type="dxa"/>`);
 	const borders = bordersXml("w:tblBorders", p.borders);
 	if (borders) out.push(borders);
 	if (p.layout === "fixed") out.push("<w:tblLayout w:type=\"fixed\"/>");
@@ -839,11 +1003,14 @@ function bordersXml(tag, borders) {
 		if (tag === "w:pBdr" && key === "insideV") return "";
 		const el = tag === "w:pBdr" && key === "insideH" ? "w:between" : name;
 		const sz = b.width !== void 0 ? ` w:sz="${Math.round(b.width * 8)}"` : "";
+		const space = b.spacePt !== void 0 && Math.round(b.spacePt) > 0 ? ` w:space="${Math.min(Math.round(b.spacePt), MOST_BORDER_SPACE_PT)}"` : "";
 		const color = b.colorHex !== void 0 ? ` w:color="${b.colorHex}"` : "";
-		return `<${el} w:val="${b.style}"${sz}${color}/>`;
+		return `<${el} w:val="${b.style}"${sz}${space}${color}/>`;
 	}).join("");
 	return sides ? `<${tag}>${sides}</${tag}>` : "";
 }
+/** §17.3.4 — the farthest a border may stand off its text, in points. */
+var MOST_BORDER_SPACE_PT = 31;
 function cellMarginsXml(tag, margins) {
 	if (!margins) return "";
 	const inner = [
@@ -914,7 +1081,8 @@ function runXml(run, state, scope) {
 		return piece("<w:fldChar w:fldCharType=\"begin\"/>") + piece(`<w:instrText xml:space="preserve"> ${run.field} </w:instrText>`) + piece("<w:fldChar w:fldCharType=\"separate\"/>") + piece(`<w:t xml:space="preserve">${escapeXml(run.text)}</w:t>`) + piece("<w:fldChar w:fldCharType=\"end\"/>") + brk;
 	}
 	if (run.text === "") return brk ? `<w:r>${rPr}${brk}</w:r>` : "";
-	return `<w:r>${rPr}${run.text.split("	").map((piece) => piece === "" ? "" : `<w:t xml:space="preserve">${escapeXml(piece)}</w:t>`).join("<w:tab/>")}${brk}</w:r>`;
+	const lineBreak = run.columnBreak ? "<w:br w:type=\"column\"/>" : "<w:br/>";
+	return `<w:r>${rPr}${run.text.split("	").map((piece) => piece.split("\n").map((line) => line === "" ? "" : `<w:t xml:space="preserve">${escapeXml(line)}</w:t>`).join(lineBreak)).join("<w:tab/>")}${brk}</w:r>`;
 }
 function rPrXml(r, state) {
 	const out = [];
@@ -925,6 +1093,15 @@ function rPrXml(r, state) {
 	if (states("italic")) out.push(toggle("w:i", r.italic), toggle("w:iCs", r.italic));
 	if (states("strike")) out.push(toggle("w:strike", r.strike));
 	if (states("colorHex")) out.push(`<w:color w:val="${r.colorHex}"/>`);
+	if (r.letterSpacingPt !== void 0 && r.letterSpacingPt !== 0) {
+		const twips = Math.round(r.letterSpacingPt * 20);
+		if (twips !== 0) out.push(`<w:spacing w:val="${String(twips)}"/>`);
+	}
+	if (r.widthScale !== void 0) {
+		const percent = Math.min(600, Math.max(1, Math.round(r.widthScale * 100)));
+		if (percent !== 100) out.push(`<w:w w:val="${String(percent)}"/>`);
+	}
+	if (r.kerningMinPt !== void 0 && states("kerningMinPt")) out.push(`<w:kern w:val="${Math.round(r.kerningMinPt * 2)}"/>`);
 	if (states("fontSizePt")) {
 		const half = Math.round(r.fontSizePt * 2);
 		out.push(`<w:sz w:val="${half}"/>`, `<w:szCs w:val="${half}"/>`);
@@ -934,6 +1111,7 @@ function rPrXml(r, state) {
 	if (states("verticalAlign")) out.push(`<w:vertAlign w:val="${r.verticalAlign}"/>`);
 	if (states("rtl")) out.push(toggle("w:rtl", r.rtl));
 	if (r.lang !== void 0) out.push(`<w:lang w:val="${escapeAttr(r.lang)}"/>`);
+	if (r.ligatures !== void 0 && states("ligatures")) out.push(`<w14:ligatures w14:val="${r.ligatures}"/>`);
 	return out.length > 0 ? `<w:rPr>${out.join("")}</w:rPr>` : "";
 }
 function underlineXml(r) {
@@ -945,10 +1123,14 @@ function runShdXml(fill) {
 }
 function pPrBody(p) {
 	const out = [];
+	if (p.keepNext) out.push("<w:keepNext/>");
+	if (p.keepLines) out.push("<w:keepLines/>");
 	if (p.pageBreakBefore) out.push("<w:pageBreakBefore/>");
+	if (p.widowControl === false) out.push("<w:widowControl w:val=\"0\"/>");
 	if (p.numbering) out.push(`<w:numPr><w:ilvl w:val="${p.numbering.ilvl}"/><w:numId w:val="${escapeAttr(p.numbering.numId)}"/></w:numPr>`);
 	const pBdr = bordersXml("w:pBdr", p.borders);
 	if (pBdr) out.push(pBdr);
+	if (p.shading) out.push(`<w:shd w:val="clear" w:color="auto" w:fill="${p.shading.colorHex}"/>`);
 	const tabs = p.tabs ?? [];
 	if (tabs.length > 0) {
 		const stops = tabs.map((t) => {
@@ -1005,10 +1187,7 @@ function spacingXml(p) {
 	const attrs = [];
 	if (stated(p.spacingBefore) && p.spacingBefore !== DEFAULT_PARA.spacingBefore) attrs.push(`w:before="${twips(p.spacingBefore)}"`);
 	if (stated(p.spacingAfter) && p.spacingAfter !== DEFAULT_PARA.spacingAfter) attrs.push(`w:after="${twips(p.spacingAfter)}"`);
-	if ((p.spacingLineRule !== DEFAULT_PARA.spacingLineRule || p.spacingLine !== DEFAULT_PARA.spacingLine) && p.spacingLine > 0) {
-		const lineVal = p.spacingLineRule === "auto" ? Math.round(p.spacingLine * 12) : twips(p.spacingLine);
-		attrs.push(`w:line="${lineVal}"`, `w:lineRule="${p.spacingLineRule}"`);
-	}
+	if ((p.spacingLineRule !== DEFAULT_PARA.spacingLineRule || p.spacingLine !== DEFAULT_PARA.spacingLine) && p.spacingLine > 0) attrs.push(`w:line="${twips(p.spacingLine)}"`, `w:lineRule="${p.spacingLineRule}"`);
 	return attrs.length > 0 ? `<w:spacing ${attrs.join(" ")}/>` : "";
 }
 function rFontsXml(fonts, state) {
@@ -1018,6 +1197,7 @@ function rFontsXml(fonts, state) {
 		const known = state?.faceFamilies?.get(name);
 		if (known === void 0) return name;
 		state?.familiesUsed.set(known.family, known);
+		if (state?.faceOutlines?.has(name) === true) state.facesUsed.add(name);
 		return known.family;
 	};
 	const attrs = [];
@@ -1104,8 +1284,14 @@ function sectPrXml(s, hf) {
 		const footer = m.footer !== void 0 ? ` w:footer="${twips(m.footer)}"` : "";
 		parts.push(`<w:pgMar w:top="${twips(m.top)}" w:right="${twips(m.right)}" w:bottom="${twips(m.bottom)}" w:left="${twips(m.left)}"${header}${footer}/>`);
 	}
+	if (s.pageNumberFormat !== void 0 || s.pageNumberStart !== void 0) {
+		const fmt = s.pageNumberFormat !== void 0 ? ` w:fmt="${s.pageNumberFormat}"` : "";
+		const start = s.pageNumberStart !== void 0 ? ` w:start="${String(s.pageNumberStart)}"` : "";
+		parts.push(`<w:pgNumType${fmt}${start}/>`);
+	}
 	if (s.columns) parts.push(colsXml(s.columns));
 	if (s.titlePg) parts.push("<w:titlePg/>");
+	if (s.textDirection) parts.push(`<w:textDirection w:val="${s.textDirection}"/>`);
 	if (parts.length === 0) return "";
 	return `<w:sectPr>${parts.join("")}</w:sectPr>`;
 }

package/dist/esm/word/drawing-parser.d.ts

@@ -104,7 +104,9 @@ export type DrawingContent = {
  * ECMA-376 Part 3 (Markup Compatibility) — resolve an `<mc:AlternateContent>` to
  * the children of the first `<mc:Choice>` whose `Requires` lists only namespaces
  * we understand, else the `<mc:Fallback>` children, else nothing. (`Requires`
- * holds space-separated namespace prefixes as declared in the document.)
+ * holds space-separated namespace prefixes as declared in the document.) The
+ * elements are known by their local names, whatever prefix the producer bound
+ * the namespace to: Word 2008 for Mac wrote `ve:`.
  *
  * @param altContent The `mc:AlternateContent` node.
  * @returns The chosen branch's children.
@@ -126,12 +128,12 @@ export declare function expandMcChildren(children: ReadonlyArray<PoNode>): Array
  * SmartArt diagram, or — falling through — an embedded picture from
  * `a:blip @r:embed`.
  *
- * @param drawing      The `w:drawing` node.
+ * @param drawingNode  The `w:drawing` node.
  * @param resolveColor Resolver for theme/scheme colours used by shape fills/lines.
  * @param parseBody    Optional body parser for a shape's text box (omitted ⇒ no text).
  * @returns The parsed content, or `null` when no anchor / recognizable graphic is found.
  */
-export declare function parseDrawing(drawing: PoNode, resolveColor: ColorResolver, parseBody?: ParseBody, resolveImage?: (relId: string) => ResourceId | undefined, resolveChartPart?: (relId: string) => string | undefined, themeLineWidths?: ReadonlyArray<number>, themeStyles?: ThemeStyles, parseDrawingText?: ParseDrawingText): DrawingContent | null;
+export declare function parseDrawing(drawingNode: PoNode, resolveColor: ColorResolver, parseBody?: ParseBody, resolveImage?: (relId: string) => ResourceId | undefined, resolveChartPart?: (relId: string) => string | undefined, themeLineWidths?: ReadonlyArray<number>, themeStyles?: ThemeStyles, parseDrawingText?: ParseDrawingText): DrawingContent | null;
 /**
  * Parse a legacy `<w:pict>`/`<w:object>` VML picture (ISO/IEC 29500-1 §14, VML
  * transitional) into an `image` {@link DrawingContent}. Modern files use

package/dist/esm/word/drawing-parser.js

@@ -22,8 +22,6 @@ var UNDERSTOOD_NS = new Set([
 ]);
 function parseFloatAnchor(anchor) {
 	if (!poIs(anchor, "wp:anchor")) return void 0;
-	const behindRaw = poAttr(anchor, "behindDoc");
-	const behind = behindRaw === "1" || behindRaw === "true";
 	let wrap = "none";
 	let wrapSide;
 	for (const child of poChildren(anchor)) {
@@ -35,6 +33,8 @@ function parseFloatAnchor(anchor) {
 		const side = poAttr(child, "wrapText");
 		wrapSide = side === "left" || side === "right" || side === "largest" ? side : "bothSides";
 	}
+	const behindRaw = poAttr(anchor, "behindDoc");
+	const behind = (behindRaw === "1" || behindRaw === "true") && wrap === "none";
 	const zOrder = poIntAttr(anchor, "relativeHeight");
 	const posH = parseAnchorPos(anchor, "wp:positionH", [
 		"margin",
@@ -163,18 +163,20 @@ function parseAnchorPos(anchor, tag, allowed) {
 * ECMA-376 Part 3 (Markup Compatibility) — resolve an `<mc:AlternateContent>` to
 * the children of the first `<mc:Choice>` whose `Requires` lists only namespaces
 * we understand, else the `<mc:Fallback>` children, else nothing. (`Requires`
-* holds space-separated namespace prefixes as declared in the document.)
+* holds space-separated namespace prefixes as declared in the document.) The
+* elements are known by their local names, whatever prefix the producer bound
+* the namespace to: Word 2008 for Mac wrote `ve:`.
 *
 * @param altContent The `mc:AlternateContent` node.
 * @returns The chosen branch's children.
 */
 function resolveMc(altContent) {
 	for (const choice of poChildren(altContent)) {
-		if (!poIs(choice, "mc:Choice")) continue;
+		if (!poIsLocal(choice, "Choice")) continue;
 		const requires = (poAttr(choice, "Requires") ?? "").split(/\s+/).filter(Boolean);
 		if (requires.length > 0 && requires.every((r) => UNDERSTOOD_NS.has(r))) return poChildren(choice);
 	}
-	const fallback = poChildren(altContent).find((c) => poIs(c, "mc:Fallback"));
+	const fallback = poChildren(altContent).find((c) => poIsLocal(c, "Fallback"));
 	return fallback ? poChildren(fallback) : [];
 }
 /**
@@ -188,22 +190,55 @@ function resolveMc(altContent) {
 */
 function expandMcChildren(children) {
 	const out = [];
-	for (const c of children) if (poIs(c, "mc:AlternateContent")) out.push(...resolveMc(c));
+	for (const c of children) if (poIsLocal(c, "AlternateContent")) out.push(...resolveMc(c));
 	else out.push(c);
 	return out;
 }
 /**
+* The node with every markup-compatibility block beneath it resolved (see
+* {@link resolveMc}), so that a search through its descendants finds only
+* the content a reader like this one is to take. Bug51170.docx's header offers
+* its logo twice — a PDF for Word for Mac as the Choice, a PNG as the Fallback
+* — and the first `a:blip` in document order was the PDF, which is not a
+* picture a page can show: the logo was left out.
+*
+* @param node The node to resolve.
+* @returns The node itself where nothing beneath it needed resolving.
+*/
+function resolveMcTree(node) {
+	const tag = poTag(node);
+	const children = poChildren(node);
+	if (tag === void 0 || children.length === 0) return node;
+	let changed = false;
+	const resolved = [];
+	for (const child of children) {
+		if (poIsLocal(child, "AlternateContent")) {
+			changed = true;
+			for (const chosen of resolveMc(child)) resolved.push(resolveMcTree(chosen));
+			continue;
+		}
+		const inner = resolveMcTree(child);
+		if (inner !== child) changed = true;
+		resolved.push(inner);
+	}
+	return changed ? {
+		...node,
+		[tag]: resolved
+	} : node;
+}
+/**
 * Parse a `<w:drawing>` (ECMA-376 Part 1 §20) into a {@link DrawingContent}. The
 * `a:graphicData` `@uri` selects the branch: a `wps:wsp` shape, a chart, a
 * SmartArt diagram, or — falling through — an embedded picture from
 * `a:blip @r:embed`.
 *
-* @param drawing      The `w:drawing` node.
+* @param drawingNode  The `w:drawing` node.
 * @param resolveColor Resolver for theme/scheme colours used by shape fills/lines.
 * @param parseBody    Optional body parser for a shape's text box (omitted ⇒ no text).
 * @returns The parsed content, or `null` when no anchor / recognizable graphic is found.
 */
-function parseDrawing(drawing, resolveColor, parseBody, resolveImage, resolveChartPart, themeLineWidths, themeStyles, parseDrawingText) {
+function parseDrawing(drawingNode, resolveColor, parseBody, resolveImage, resolveChartPart, themeLineWidths, themeStyles, parseDrawingText) {
+	const drawing = resolveMcTree(drawingNode);
 	const anchor = poChildren(drawing).find((c) => poIs(c, "wp:inline")) ?? poChildren(drawing).find((c) => poIs(c, "wp:anchor"));
 	if (!anchor) return null;
 	const extent = poFindDescendant(anchor, "wp:extent");
@@ -1083,6 +1118,12 @@ function vmlFloat(style, zIndexAttr, shape) {
 	const zIndex = prop("z-index") ?? zIndexAttr;
 	return {
 		wrap: vmlWrap(shape),
+		wrapDist: {
+			topPt: pt(prop("mso-wrap-distance-top") ?? 0),
+			bottomPt: pt(prop("mso-wrap-distance-bottom") ?? 0),
+			leftPt: pt(prop("mso-wrap-distance-left") ?? 9),
+			rightPt: pt(prop("mso-wrap-distance-right") ?? 9)
+		},
 		...poAttrLocal(shape, "allowincell") === "f" ? { inCell: false } : {},
 		...zIndex !== void 0 && zIndex < 0 ? { behind: true } : {},
 		...zIndex !== void 0 ? { zOrder: Math.abs(zIndex) } : {},

package/dist/esm/word/font-embed.d.ts

@@ -0,0 +1,30 @@
+import { FaceFamily, FaceOutlines } from '../core/ir/flow.js';
+import { Loss } from '../core/ir/index.js';
+import { OpcPart, Relationship } from '../core/opc/index.js';
+/** §17.8.1 — the content type of an obfuscated embedded font. */
+export declare const OBFUSCATED_FONT_CONTENT_TYPE = "application/vnd.openxmlformats-officedocument.obfuscatedFont";
+/** The faces written into a package, and how the font table reaches them. */
+export interface EmbeddedFaces {
+    /** Family → the `w:embed*` elements its `w:font` carries (§17.8.3.3–6). */
+    readonly elements: ReadonlyMap<string, string>;
+    /** The obfuscated font parts, under `word/fonts/`. */
+    readonly parts: ReadonlyArray<OpcPart>;
+    /** The font table's relationships to them. */
+    readonly relationships: ReadonlyArray<Relationship>;
+}
+/**
+ * Build the embedded fonts for the faces the runs name (§17.8.1).
+ *
+ * The faces are gathered by family and by slot — the style each face IS. Two
+ * faces in one slot (a SemiBold and a Bold, both written bold) become one font:
+ * the face with the most characters, and the other's characters it lacks.
+ *
+ * A face its licence keeps out is reported, not written.
+ *
+ * @param used     The run font names the document's runs carry.
+ * @param outlines Run font name → the face's outlines.
+ * @param families Run font name → the family a word processor knows it by.
+ * @param losses   Appended to for every face left out.
+ * @returns The fonts to write and the font table's references to them.
+ */
+export declare function embedFaces(used: Iterable<string>, outlines: ReadonlyMap<string, FaceOutlines>, families: ReadonlyMap<string, FaceFamily>, losses: Array<Loss>): EmbeddedFaces;