odf.js 6.2.1 → 6.4.0

package/dist/typed/odt/write.cjs

@@ -0,0 +1,278 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_media_type = require("../../media-type.cjs");
+const require_xml_fragment = require("../../xml/fragment.cjs");
+const require_xml_entities = require("../../xml/entities.cjs");
+const require_manifest = require("../../manifest.cjs");
+const require_typed_shared_units = require("../shared/units.cjs");
+const require_styles_registry = require("../../styles/registry.cjs");
+const require_typed_shared_metadata = require("../shared/metadata.cjs");
+const require_typed_shared_list = require("../shared/list.cjs");
+const require_typed_shared_paragraph = require("../shared/paragraph.cjs");
+const require_typed_shared_table = require("../shared/table.cjs");
+const require_package_io_scaffold = require("../../package-io/scaffold.cjs");
+const require_typed_shared_canonicalise = require("../shared/canonicalise.cjs");
+let document_schema_js = require("document-schema.js");
+//#region src/typed/odt/write.ts
+const CONTENT_PART = "content.xml";
+const STYLES_PART = "styles.xml";
+const PICTURES_DIRECTORY = "Pictures";
+function unsupported(what, where) {
+	return /* @__PURE__ */ new Error(`writeOdt: ${where} carries ${what}, which this writer does not write yet -- refusing rather than producing an .odt that silently lost it. See ExaDev/documents.js for the tracked follow-up covering the fidelity constructs and embedded objects.`);
+}
+function assertWritableParagraph(paragraph) {
+	if (paragraph.constructs !== void 0 && paragraph.constructs.length > 0) throw unsupported("run-level construct extents (a field, bookmark, note, annotation, or tracked change)", "a paragraph");
+}
+function assertWritableBlock(block) {
+	if (block.kind === "constructStart" || block.kind === "constructEnd") throw unsupported("a construct boundary marker", "a section's block flow");
+	if (block.kind === "embeddedObject") throw unsupported("an embedded object", "a section's block flow");
+	if (block.kind === "paragraph") assertWritableParagraph(block);
+}
+function emptyAnchorParagraph(pageBreakBefore) {
+	return pageBreakBefore ? {
+		kind: "paragraph",
+		runs: [],
+		pageBreakBefore: true
+	} : {
+		kind: "paragraph",
+		runs: []
+	};
+}
+function planSection(section, needsLeadingParagraph, listState) {
+	const blocks = [];
+	let pendingPageBreak = false;
+	const pushParagraph = (paragraph) => {
+		blocks.push({
+			kind: "paragraph",
+			paragraph
+		});
+	};
+	const hasPlannedParagraph = () => {
+		for (let index = blocks.length - 1; index >= 0; index -= 1) if (blocks[index].kind === "paragraph") return true;
+		return false;
+	};
+	const closeListRun = () => {
+		require_typed_shared_list.closeListPlan(listState);
+	};
+	const flushPendingPageBreak = () => {
+		if (pendingPageBreak) {
+			pushParagraph(emptyAnchorParagraph(true));
+			closeListRun();
+			pendingPageBreak = false;
+		}
+	};
+	if (needsLeadingParagraph) {
+		if (section.blocks.find((block) => block.kind !== "constructStart" && block.kind !== "constructEnd")?.kind !== "paragraph") pushParagraph(emptyAnchorParagraph(false));
+	}
+	for (const block of section.blocks) {
+		assertWritableBlock(block);
+		if (block.kind === "pageBreak") {
+			flushPendingPageBreak();
+			pendingPageBreak = true;
+			continue;
+		}
+		if (block.kind === "paragraph") {
+			const canonicalId = require_typed_shared_list.planListMembership(block.list, listState);
+			const paragraph = require_typed_shared_canonicalise.canonicalParagraph(block, canonicalId);
+			pushParagraph(pendingPageBreak ? {
+				...paragraph,
+				pageBreakBefore: true
+			} : paragraph);
+			pendingPageBreak = false;
+			continue;
+		}
+		if (block.kind === "table") {
+			flushPendingPageBreak();
+			closeListRun();
+			blocks.push({
+				kind: "table",
+				table: block
+			});
+			continue;
+		}
+		flushPendingPageBreak();
+		if (!hasPlannedParagraph()) pushParagraph(emptyAnchorParagraph(false));
+		blocks.push({
+			kind: "image",
+			image: block
+		});
+	}
+	flushPendingPageBreak();
+	return {
+		pageSize: section.pageSize,
+		margins: section.margins,
+		blocks
+	};
+}
+function planDocument(sections) {
+	if (sections.length === 0) throw new Error("writeOdt: a wordprocessing document with no sections has no page geometry to write -- an .odt always carries at least one page style, and inventing one would report back a section the document never had");
+	const listState = { next: 1 };
+	return sections.map((section, index) => planSection(section, index > 0, listState));
+}
+function normaliseOdtContent(document) {
+	if (document.kind !== "wordprocessing") throw new Error(`normaliseOdtContent: expected a 'wordprocessing' document, got '${document.kind}'`);
+	const planned = planDocument(document.sections);
+	return {
+		kind: "wordprocessing",
+		metadata: require_typed_shared_canonicalise.canonicalMetadata(document.metadata),
+		sections: planned.map((section, index) => {
+			const blocks = section.blocks.map((block) => {
+				switch (block.kind) {
+					case "paragraph": return block.paragraph;
+					case "table": return require_typed_shared_canonicalise.canonicalTable(block.table);
+					case "image": return require_typed_shared_canonicalise.canonicalImage(block.image);
+				}
+			});
+			return index === 0 ? {
+				pageSize: section.pageSize,
+				margins: section.margins,
+				blocks
+			} : {
+				pageSize: section.pageSize,
+				margins: section.margins,
+				blocks,
+				breakType: "nextPage"
+			};
+		})
+	};
+}
+function pageLayoutElement(name, pageSize, margins) {
+	return require_xml_fragment.el("style:page-layout", { "style:name": require_xml_entities.encodeXmlText(name) }, [require_xml_fragment.el("style:page-layout-properties", {
+		"fo:page-width": require_typed_shared_units.formatOdfLength(pageSize.widthPt),
+		"fo:page-height": require_typed_shared_units.formatOdfLength(pageSize.heightPt),
+		"style:print-orientation": pageSize.widthPt > pageSize.heightPt ? "landscape" : "portrait",
+		"fo:margin-top": require_typed_shared_units.formatOdfLength(margins.topPt),
+		"fo:margin-right": require_typed_shared_units.formatOdfLength(margins.rightPt),
+		"fo:margin-bottom": require_typed_shared_units.formatOdfLength(margins.bottomPt),
+		"fo:margin-left": require_typed_shared_units.formatOdfLength(margins.leftPt)
+	})]);
+}
+function sectionBreakStyleElement(name, masterPageName) {
+	return require_xml_fragment.el("style:style", {
+		"style:name": require_xml_entities.encodeXmlText(name),
+		"style:family": "paragraph",
+		"style:master-page-name": require_xml_entities.encodeXmlText(masterPageName)
+	});
+}
+function listStyleNameFor(kind, state) {
+	const existing = state.listStyleByKind.get(kind);
+	if (existing !== void 0) return existing;
+	const name = `L${state.nextListStyle}`;
+	state.nextListStyle += 1;
+	state.listStyleByKind.set(kind, name);
+	state.contentAutomaticStyles.children.push(require_typed_shared_list.buildOdfListStyle(name, kind));
+	return name;
+}
+function writeImageFrame(image, state) {
+	const extension = image.format === "png" ? "png" : "jpg";
+	const path = `${PICTURES_DIRECTORY}/image${state.nextImage}.${extension}`;
+	state.nextImage += 1;
+	state.pkg.parts[path] = {
+		kind: "binary",
+		base64: image.base64
+	};
+	const children = [require_xml_fragment.el("draw:image", {
+		"xlink:href": require_xml_entities.encodeXmlText(path),
+		"xlink:type": "simple",
+		"xlink:show": "embed",
+		"xlink:actuate": "onLoad"
+	})];
+	if (image.altText !== void 0) children.push(require_xml_fragment.el("svg:title", {}, [require_xml_fragment.txt(require_xml_entities.encodeXmlText(image.altText))]));
+	return require_xml_fragment.el("draw:frame", {
+		"text:anchor-type": "as-char",
+		"svg:width": require_typed_shared_units.formatOdfLength(image.widthPt),
+		"svg:height": require_typed_shared_units.formatOdfLength(image.heightPt)
+	}, children);
+}
+function writeSectionBlocks(section, parentStyleName, state, out) {
+	let anchorParagraph;
+	let openList;
+	const closeList = () => {
+		if (openList === void 0) return;
+		const kind = require_typed_shared_list.listKindOf(openList.numId);
+		const built = require_typed_shared_list.writeOdfList(openList.entries, kind === void 0 ? void 0 : listStyleNameFor(kind, state));
+		openList.element.attributes = built.attributes;
+		openList.element.children = built.children;
+		openList = void 0;
+	};
+	for (const [index, block] of section.blocks.entries()) {
+		if (block.kind === "paragraph") {
+			const paragraph = block.paragraph;
+			const element = require_typed_shared_paragraph.writeOdfParagraph(paragraph, state.registry, { ...index === 0 && parentStyleName !== void 0 ? { parentStyleName } : {} });
+			anchorParagraph = element;
+			const membership = paragraph.list;
+			if (membership?.numId === void 0) {
+				closeList();
+				out.push(element);
+				continue;
+			}
+			if (openList !== void 0 && openList.numId !== membership.numId) closeList();
+			if (openList === void 0) {
+				const listElement = require_xml_fragment.el("text:list");
+				openList = {
+					numId: membership.numId,
+					entries: [],
+					element: listElement
+				};
+				out.push(listElement);
+			}
+			openList.entries.push({
+				level: membership.level,
+				element
+			});
+			continue;
+		}
+		if (block.kind === "table") {
+			closeList();
+			anchorParagraph = void 0;
+			out.push(require_typed_shared_table.writeOdfTable(block.table, state.registry, `Table${state.nextTable}`));
+			state.nextTable += 1;
+			continue;
+		}
+		if (anchorParagraph === void 0) throw new Error("writeOdt: internal error -- an image block reached the writer with no anchor paragraph before it, which planSection is supposed to guarantee");
+		anchorParagraph.children.push(writeImageFrame(block.image, state));
+	}
+	closeList();
+}
+function writeOdtContent(document, options = {}) {
+	if (document.kind !== "wordprocessing") throw new Error(`writeOdtContent: expected a 'wordprocessing' document, got '${document.kind}' -- odf.js writes .odt from the wordprocessing arm only`);
+	const version = options.version ?? "1.3";
+	const textElement = require_xml_fragment.el("office:text");
+	const pkg = require_package_io_scaffold.createOdfPackage(options.template ? require_media_type.ODF_MEDIA_TYPES.ott : require_media_type.ODF_MEDIA_TYPES.odt, textElement, version);
+	const state = {
+		pkg,
+		registry: require_styles_registry.StyleRegistry.forPart(pkg, CONTENT_PART, { otherPart: {
+			pkg,
+			partPath: STYLES_PART
+		} }),
+		contentAutomaticStyles: require_package_io_scaffold.odfPartContainer(pkg, CONTENT_PART, "office:automatic-styles"),
+		stylesNamedStyles: require_package_io_scaffold.odfPartContainer(pkg, STYLES_PART, "office:styles"),
+		stylesAutomaticStyles: require_package_io_scaffold.odfPartContainer(pkg, STYLES_PART, "office:automatic-styles"),
+		masterStyles: require_package_io_scaffold.odfPartContainer(pkg, STYLES_PART, "office:master-styles"),
+		nextTable: 1,
+		nextImage: 1,
+		nextListStyle: 1,
+		listStyleByKind: /* @__PURE__ */ new Map()
+	};
+	const planned = planDocument(document.sections);
+	for (const [index, section] of planned.entries()) {
+		const masterPageName = `MP${index + 1}`;
+		const pageLayoutName = `PM${index + 1}`;
+		state.stylesAutomaticStyles.children.push(pageLayoutElement(pageLayoutName, section.pageSize, section.margins));
+		state.masterStyles.children.push(require_xml_fragment.el("style:master-page", {
+			"style:name": require_xml_entities.encodeXmlText(masterPageName),
+			"style:page-layout-name": require_xml_entities.encodeXmlText(pageLayoutName)
+		}));
+		if (index > 0) state.stylesNamedStyles.children.push(sectionBreakStyleElement(`${masterPageName}Start`, masterPageName));
+	}
+	for (const [index, section] of planned.entries()) writeSectionBlocks(section, index === 0 ? void 0 : `MP${index + 1}Start`, state, textElement.children);
+	require_typed_shared_metadata.writeOdfMetadata(pkg, document.metadata, version);
+	require_manifest.syncManifest(pkg, { version });
+	return pkg;
+}
+function writeOdt(document, options = {}) {
+	return writeOdtContent((0, document_schema_js.flattenTree)(document), options);
+}
+//#endregion
+exports.normaliseOdtContent = normaliseOdtContent;
+exports.writeOdt = writeOdt;
+exports.writeOdtContent = writeOdtContent;

package/dist/typed/odt/write.d.cts

@@ -0,0 +1,2 @@
+import { i as writeOdtContent, n as normaliseOdtContent, r as writeOdt, t as OdtWriteOptions } from "../../write-CPATqG4v.cjs";
+export { OdtWriteOptions, normaliseOdtContent, writeOdt, writeOdtContent };

package/dist/typed/odt/write.d.ts

@@ -0,0 +1,2 @@
+import { i as writeOdtContent, n as normaliseOdtContent, r as writeOdt, t as OdtWriteOptions } from "../../write-JERychL3.js";
+export { OdtWriteOptions, normaliseOdtContent, writeOdt, writeOdtContent };

package/dist/typed/odt/write.js

@@ -0,0 +1,275 @@
+import { ODF_MEDIA_TYPES } from "../../media-type.js";
+import { el, txt } from "../../xml/fragment.js";
+import { encodeXmlText } from "../../xml/entities.js";
+import { syncManifest } from "../../manifest.js";
+import { formatOdfLength } from "../shared/units.js";
+import { StyleRegistry } from "../../styles/registry.js";
+import { writeOdfMetadata } from "../shared/metadata.js";
+import { buildOdfListStyle, closeListPlan, listKindOf, planListMembership, writeOdfList } from "../shared/list.js";
+import { writeOdfParagraph } from "../shared/paragraph.js";
+import { writeOdfTable } from "../shared/table.js";
+import { createOdfPackage, odfPartContainer } from "../../package-io/scaffold.js";
+import { canonicalImage, canonicalMetadata, canonicalParagraph, canonicalTable } from "../shared/canonicalise.js";
+import { flattenTree } from "document-schema.js";
+//#region src/typed/odt/write.ts
+const CONTENT_PART = "content.xml";
+const STYLES_PART = "styles.xml";
+const PICTURES_DIRECTORY = "Pictures";
+function unsupported(what, where) {
+	return /* @__PURE__ */ new Error(`writeOdt: ${where} carries ${what}, which this writer does not write yet -- refusing rather than producing an .odt that silently lost it. See ExaDev/documents.js for the tracked follow-up covering the fidelity constructs and embedded objects.`);
+}
+function assertWritableParagraph(paragraph) {
+	if (paragraph.constructs !== void 0 && paragraph.constructs.length > 0) throw unsupported("run-level construct extents (a field, bookmark, note, annotation, or tracked change)", "a paragraph");
+}
+function assertWritableBlock(block) {
+	if (block.kind === "constructStart" || block.kind === "constructEnd") throw unsupported("a construct boundary marker", "a section's block flow");
+	if (block.kind === "embeddedObject") throw unsupported("an embedded object", "a section's block flow");
+	if (block.kind === "paragraph") assertWritableParagraph(block);
+}
+function emptyAnchorParagraph(pageBreakBefore) {
+	return pageBreakBefore ? {
+		kind: "paragraph",
+		runs: [],
+		pageBreakBefore: true
+	} : {
+		kind: "paragraph",
+		runs: []
+	};
+}
+function planSection(section, needsLeadingParagraph, listState) {
+	const blocks = [];
+	let pendingPageBreak = false;
+	const pushParagraph = (paragraph) => {
+		blocks.push({
+			kind: "paragraph",
+			paragraph
+		});
+	};
+	const hasPlannedParagraph = () => {
+		for (let index = blocks.length - 1; index >= 0; index -= 1) if (blocks[index].kind === "paragraph") return true;
+		return false;
+	};
+	const closeListRun = () => {
+		closeListPlan(listState);
+	};
+	const flushPendingPageBreak = () => {
+		if (pendingPageBreak) {
+			pushParagraph(emptyAnchorParagraph(true));
+			closeListRun();
+			pendingPageBreak = false;
+		}
+	};
+	if (needsLeadingParagraph) {
+		if (section.blocks.find((block) => block.kind !== "constructStart" && block.kind !== "constructEnd")?.kind !== "paragraph") pushParagraph(emptyAnchorParagraph(false));
+	}
+	for (const block of section.blocks) {
+		assertWritableBlock(block);
+		if (block.kind === "pageBreak") {
+			flushPendingPageBreak();
+			pendingPageBreak = true;
+			continue;
+		}
+		if (block.kind === "paragraph") {
+			const canonicalId = planListMembership(block.list, listState);
+			const paragraph = canonicalParagraph(block, canonicalId);
+			pushParagraph(pendingPageBreak ? {
+				...paragraph,
+				pageBreakBefore: true
+			} : paragraph);
+			pendingPageBreak = false;
+			continue;
+		}
+		if (block.kind === "table") {
+			flushPendingPageBreak();
+			closeListRun();
+			blocks.push({
+				kind: "table",
+				table: block
+			});
+			continue;
+		}
+		flushPendingPageBreak();
+		if (!hasPlannedParagraph()) pushParagraph(emptyAnchorParagraph(false));
+		blocks.push({
+			kind: "image",
+			image: block
+		});
+	}
+	flushPendingPageBreak();
+	return {
+		pageSize: section.pageSize,
+		margins: section.margins,
+		blocks
+	};
+}
+function planDocument(sections) {
+	if (sections.length === 0) throw new Error("writeOdt: a wordprocessing document with no sections has no page geometry to write -- an .odt always carries at least one page style, and inventing one would report back a section the document never had");
+	const listState = { next: 1 };
+	return sections.map((section, index) => planSection(section, index > 0, listState));
+}
+function normaliseOdtContent(document) {
+	if (document.kind !== "wordprocessing") throw new Error(`normaliseOdtContent: expected a 'wordprocessing' document, got '${document.kind}'`);
+	const planned = planDocument(document.sections);
+	return {
+		kind: "wordprocessing",
+		metadata: canonicalMetadata(document.metadata),
+		sections: planned.map((section, index) => {
+			const blocks = section.blocks.map((block) => {
+				switch (block.kind) {
+					case "paragraph": return block.paragraph;
+					case "table": return canonicalTable(block.table);
+					case "image": return canonicalImage(block.image);
+				}
+			});
+			return index === 0 ? {
+				pageSize: section.pageSize,
+				margins: section.margins,
+				blocks
+			} : {
+				pageSize: section.pageSize,
+				margins: section.margins,
+				blocks,
+				breakType: "nextPage"
+			};
+		})
+	};
+}
+function pageLayoutElement(name, pageSize, margins) {
+	return el("style:page-layout", { "style:name": encodeXmlText(name) }, [el("style:page-layout-properties", {
+		"fo:page-width": formatOdfLength(pageSize.widthPt),
+		"fo:page-height": formatOdfLength(pageSize.heightPt),
+		"style:print-orientation": pageSize.widthPt > pageSize.heightPt ? "landscape" : "portrait",
+		"fo:margin-top": formatOdfLength(margins.topPt),
+		"fo:margin-right": formatOdfLength(margins.rightPt),
+		"fo:margin-bottom": formatOdfLength(margins.bottomPt),
+		"fo:margin-left": formatOdfLength(margins.leftPt)
+	})]);
+}
+function sectionBreakStyleElement(name, masterPageName) {
+	return el("style:style", {
+		"style:name": encodeXmlText(name),
+		"style:family": "paragraph",
+		"style:master-page-name": encodeXmlText(masterPageName)
+	});
+}
+function listStyleNameFor(kind, state) {
+	const existing = state.listStyleByKind.get(kind);
+	if (existing !== void 0) return existing;
+	const name = `L${state.nextListStyle}`;
+	state.nextListStyle += 1;
+	state.listStyleByKind.set(kind, name);
+	state.contentAutomaticStyles.children.push(buildOdfListStyle(name, kind));
+	return name;
+}
+function writeImageFrame(image, state) {
+	const extension = image.format === "png" ? "png" : "jpg";
+	const path = `${PICTURES_DIRECTORY}/image${state.nextImage}.${extension}`;
+	state.nextImage += 1;
+	state.pkg.parts[path] = {
+		kind: "binary",
+		base64: image.base64
+	};
+	const children = [el("draw:image", {
+		"xlink:href": encodeXmlText(path),
+		"xlink:type": "simple",
+		"xlink:show": "embed",
+		"xlink:actuate": "onLoad"
+	})];
+	if (image.altText !== void 0) children.push(el("svg:title", {}, [txt(encodeXmlText(image.altText))]));
+	return el("draw:frame", {
+		"text:anchor-type": "as-char",
+		"svg:width": formatOdfLength(image.widthPt),
+		"svg:height": formatOdfLength(image.heightPt)
+	}, children);
+}
+function writeSectionBlocks(section, parentStyleName, state, out) {
+	let anchorParagraph;
+	let openList;
+	const closeList = () => {
+		if (openList === void 0) return;
+		const kind = listKindOf(openList.numId);
+		const built = writeOdfList(openList.entries, kind === void 0 ? void 0 : listStyleNameFor(kind, state));
+		openList.element.attributes = built.attributes;
+		openList.element.children = built.children;
+		openList = void 0;
+	};
+	for (const [index, block] of section.blocks.entries()) {
+		if (block.kind === "paragraph") {
+			const paragraph = block.paragraph;
+			const element = writeOdfParagraph(paragraph, state.registry, { ...index === 0 && parentStyleName !== void 0 ? { parentStyleName } : {} });
+			anchorParagraph = element;
+			const membership = paragraph.list;
+			if (membership?.numId === void 0) {
+				closeList();
+				out.push(element);
+				continue;
+			}
+			if (openList !== void 0 && openList.numId !== membership.numId) closeList();
+			if (openList === void 0) {
+				const listElement = el("text:list");
+				openList = {
+					numId: membership.numId,
+					entries: [],
+					element: listElement
+				};
+				out.push(listElement);
+			}
+			openList.entries.push({
+				level: membership.level,
+				element
+			});
+			continue;
+		}
+		if (block.kind === "table") {
+			closeList();
+			anchorParagraph = void 0;
+			out.push(writeOdfTable(block.table, state.registry, `Table${state.nextTable}`));
+			state.nextTable += 1;
+			continue;
+		}
+		if (anchorParagraph === void 0) throw new Error("writeOdt: internal error -- an image block reached the writer with no anchor paragraph before it, which planSection is supposed to guarantee");
+		anchorParagraph.children.push(writeImageFrame(block.image, state));
+	}
+	closeList();
+}
+function writeOdtContent(document, options = {}) {
+	if (document.kind !== "wordprocessing") throw new Error(`writeOdtContent: expected a 'wordprocessing' document, got '${document.kind}' -- odf.js writes .odt from the wordprocessing arm only`);
+	const version = options.version ?? "1.3";
+	const textElement = el("office:text");
+	const pkg = createOdfPackage(options.template ? ODF_MEDIA_TYPES.ott : ODF_MEDIA_TYPES.odt, textElement, version);
+	const state = {
+		pkg,
+		registry: StyleRegistry.forPart(pkg, CONTENT_PART, { otherPart: {
+			pkg,
+			partPath: STYLES_PART
+		} }),
+		contentAutomaticStyles: odfPartContainer(pkg, CONTENT_PART, "office:automatic-styles"),
+		stylesNamedStyles: odfPartContainer(pkg, STYLES_PART, "office:styles"),
+		stylesAutomaticStyles: odfPartContainer(pkg, STYLES_PART, "office:automatic-styles"),
+		masterStyles: odfPartContainer(pkg, STYLES_PART, "office:master-styles"),
+		nextTable: 1,
+		nextImage: 1,
+		nextListStyle: 1,
+		listStyleByKind: /* @__PURE__ */ new Map()
+	};
+	const planned = planDocument(document.sections);
+	for (const [index, section] of planned.entries()) {
+		const masterPageName = `MP${index + 1}`;
+		const pageLayoutName = `PM${index + 1}`;
+		state.stylesAutomaticStyles.children.push(pageLayoutElement(pageLayoutName, section.pageSize, section.margins));
+		state.masterStyles.children.push(el("style:master-page", {
+			"style:name": encodeXmlText(masterPageName),
+			"style:page-layout-name": encodeXmlText(pageLayoutName)
+		}));
+		if (index > 0) state.stylesNamedStyles.children.push(sectionBreakStyleElement(`${masterPageName}Start`, masterPageName));
+	}
+	for (const [index, section] of planned.entries()) writeSectionBlocks(section, index === 0 ? void 0 : `MP${index + 1}Start`, state, textElement.children);
+	writeOdfMetadata(pkg, document.metadata, version);
+	syncManifest(pkg, { version });
+	return pkg;
+}
+function writeOdt(document, options = {}) {
+	return writeOdtContent(flattenTree(document), options);
+}
+//#endregion
+export { normaliseOdtContent, writeOdt, writeOdtContent };

package/dist/typed/shared/canonicalise.cjs

@@ -0,0 +1,126 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_typed_shared_paragraph = require("./paragraph.cjs");
+let document_schema_js = require("document-schema.js");
+//#region src/typed/shared/canonicalise.ts
+function unsupportedContent(what, where) {
+	return /* @__PURE__ */ new Error(`${where} carries ${what}, which no ODF writer in this package can produce yet -- refusing to state a canonical form for content that would be silently lost on write. See ExaDev/documents.js for the tracked follow-up covering the fidelity constructs and embedded objects.`);
+}
+function canonicalColor(color) {
+	return (0, document_schema_js.rgbHexToColor)((0, document_schema_js.colorToRgbHex)(color));
+}
+function canonicalRun(run) {
+	const canonical = { text: run.text };
+	if (run.bold !== void 0) canonical.bold = run.bold;
+	if (run.italic !== void 0) canonical.italic = run.italic;
+	if (run.underline !== void 0) canonical.underline = run.underline;
+	if (run.strike !== void 0) canonical.strike = run.strike;
+	if (run.fontFamily !== void 0) canonical.fontFamily = run.fontFamily;
+	if (run.sizePt !== void 0) canonical.sizePt = run.sizePt;
+	if (run.color !== void 0) canonical.color = canonicalColor(run.color);
+	if (run.hyperlink !== void 0) canonical.hyperlink = run.hyperlink;
+	return canonical;
+}
+function canonicalParagraph(paragraph, listNumId) {
+	if (paragraph.constructs !== void 0 && paragraph.constructs.length > 0) throw unsupportedContent("run-level construct extents (a field, bookmark, note, annotation, or tracked change)", "a paragraph");
+	const canonical = {
+		kind: "paragraph",
+		runs: require_typed_shared_paragraph.segmentOdfParagraphRuns(paragraph.runs).map(canonicalRun)
+	};
+	if (paragraph.headingLevel !== void 0) {
+		canonical.headingLevel = paragraph.headingLevel;
+		canonical.styleId = `Heading${paragraph.headingLevel}`;
+	}
+	if (paragraph.alignment !== void 0) canonical.alignment = paragraph.alignment;
+	if (listNumId !== void 0 && paragraph.list !== void 0) canonical.list = {
+		numId: listNumId,
+		level: paragraph.list.level
+	};
+	if (paragraph.spacingBeforePt !== void 0) canonical.spacingBeforePt = paragraph.spacingBeforePt;
+	if (paragraph.spacingAfterPt !== void 0) canonical.spacingAfterPt = paragraph.spacingAfterPt;
+	if (paragraph.lineSpacing !== void 0) canonical.lineSpacing = paragraph.lineSpacing;
+	if (paragraph.indentLeftPt !== void 0) canonical.indentLeftPt = paragraph.indentLeftPt;
+	if (paragraph.indentFirstLinePt !== void 0) canonical.indentFirstLinePt = paragraph.indentFirstLinePt;
+	if (paragraph.pageBreakBefore !== void 0) canonical.pageBreakBefore = paragraph.pageBreakBefore;
+	if (paragraph.pageBreakAfter !== void 0) canonical.pageBreakAfter = paragraph.pageBreakAfter;
+	return canonical;
+}
+function canonicalCell(cell, covered) {
+	if (covered) return { blocks: [] };
+	const canonical = { blocks: cell.blocks.map((block) => {
+		if (block.kind !== "paragraph") throw unsupportedContent(`a "${block.kind}" block`, "a table cell");
+		return canonicalParagraph(block, void 0);
+	}) };
+	if (cell.colSpan !== void 0) canonical.colSpan = cell.colSpan;
+	if (cell.rowSpan !== void 0) canonical.rowSpan = cell.rowSpan;
+	if (cell.background !== void 0) canonical.background = canonicalColor(cell.background);
+	if (cell.borders !== void 0) {
+		const borders = {};
+		for (const edge of [
+			"left",
+			"right",
+			"top",
+			"bottom"
+		]) {
+			const border = cell.borders[edge];
+			if (border !== void 0) borders[edge] = {
+				color: canonicalColor(border.color),
+				widthPt: border.widthPt,
+				style: border.style ?? "solid"
+			};
+		}
+		canonical.borders = borders;
+	}
+	return canonical;
+}
+function canonicalTable(table) {
+	const covered = /* @__PURE__ */ new Set();
+	return {
+		kind: "table",
+		columnWidthsPt: [...table.columnWidthsPt],
+		rows: table.rows.map((row, rowIndex) => {
+			const cells = row.cells.map((cell, columnIndex) => {
+				const key = `${rowIndex},${columnIndex}`;
+				const isCovered = covered.has(key);
+				if (!isCovered) {
+					const colSpan = cell.colSpan ?? 1;
+					const rowSpan = cell.rowSpan ?? 1;
+					for (let r = rowIndex; r < rowIndex + rowSpan; r += 1) for (let c = columnIndex; c < columnIndex + colSpan; c += 1) if (r !== rowIndex || c !== columnIndex) covered.add(`${r},${c}`);
+				}
+				return canonicalCell(cell, isCovered);
+			});
+			return row.heightPt === void 0 ? { cells } : {
+				cells,
+				heightPt: row.heightPt
+			};
+		})
+	};
+}
+function canonicalMetadata(metadata) {
+	const canonical = {};
+	if (metadata.title !== void 0) canonical.title = metadata.title;
+	if (metadata.author !== void 0) canonical.author = metadata.author;
+	if (metadata.subject !== void 0) canonical.subject = metadata.subject;
+	if (metadata.keywords !== void 0 && metadata.keywords.length > 0) canonical.keywords = [...metadata.keywords];
+	if (metadata.creator !== void 0) canonical.creator = metadata.creator;
+	if (metadata.createdIso !== void 0) canonical.createdIso = metadata.createdIso;
+	if (metadata.modifiedIso !== void 0) canonical.modifiedIso = metadata.modifiedIso;
+	return canonical;
+}
+function canonicalImage(image) {
+	const canonical = {
+		kind: "image",
+		format: image.format,
+		base64: image.base64,
+		widthPt: image.widthPt,
+		heightPt: image.heightPt
+	};
+	if (image.altText !== void 0) canonical.altText = image.altText;
+	return canonical;
+}
+//#endregion
+exports.canonicalColor = canonicalColor;
+exports.canonicalImage = canonicalImage;
+exports.canonicalMetadata = canonicalMetadata;
+exports.canonicalParagraph = canonicalParagraph;
+exports.canonicalRun = canonicalRun;
+exports.canonicalTable = canonicalTable;