ooxml.js 6.3.6 → 7.0.0

package/dist/typed/docx/read.js

@@ -1,2 +1,2 @@
-import { a as SectionHeaderFooterReferencesSchema, i as HeaderFooterPartSchema, n as DocxDocumentSchema, o as readDocxContent, r as FootnoteSchema, t as CommentSchema } from "../../read-BrAuHnvH.js";
+import { a as SectionHeaderFooterReferencesSchema, i as HeaderFooterPartSchema, n as DocxDocumentSchema, o as readDocxContent, r as FootnoteSchema, t as CommentSchema } from "../../read-DlkyVzBP.js";
 export { CommentSchema, DocxDocumentSchema, FootnoteSchema, HeaderFooterPartSchema, SectionHeaderFooterReferencesSchema, readDocxContent };

package/dist/typed/docx/shading.cjs

@@ -0,0 +1,95 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_xml_fragment = require("../../xml/fragment.cjs");
+const require_typed_util = require("../util.cjs");
+let document_schema_js = require("document-schema.js");
+//#region src/typed/docx/shading.ts
+const SHD_VAL_TO_PATTERN_TYPE = {
+	pct5: "percent5",
+	pct10: "percent10",
+	pct12: "percent12",
+	pct15: "percent15",
+	pct20: "percent20",
+	pct25: "percent25",
+	pct30: "percent30",
+	pct35: "percent35",
+	pct37: "percent37",
+	pct40: "percent40",
+	pct45: "percent45",
+	pct50: "percent50",
+	pct55: "percent55",
+	pct60: "percent60",
+	pct62: "percent62",
+	pct65: "percent65",
+	pct70: "percent70",
+	pct75: "percent75",
+	pct80: "percent80",
+	pct85: "percent85",
+	pct87: "percent87",
+	pct90: "percent90",
+	pct95: "percent95",
+	horzStripe: "horizontalStripe",
+	vertStripe: "verticalStripe",
+	reverseDiagStripe: "reverseDiagonalStripe",
+	diagStripe: "diagonalStripe",
+	horzCross: "horizontalCross",
+	diagCross: "diagonalCross",
+	thinHorzStripe: "thinHorizontalStripe",
+	thinVertStripe: "thinVerticalStripe",
+	thinReverseDiagStripe: "thinReverseDiagonalStripe",
+	thinDiagStripe: "thinDiagonalStripe",
+	thinHorzCross: "thinHorizontalCross",
+	thinDiagCross: "thinDiagonalCross"
+};
+/** The inverse of SHD_VAL_TO_PATTERN_TYPE, built from it rather than restated by hand so the two can never drift apart. Every ContentCellPatternType this writer is ever asked to state has an entry, since the Word-family half of the shared vocabulary is exactly SHD_VAL_TO_PATTERN_TYPE's own value set -- the SpreadsheetML-only members (mediumGray through gray0625) are absent, ST_Shd having no equivalent for them at all. */
+const PATTERN_TYPE_TO_SHD_VAL = new Map(Object.entries(SHD_VAL_TO_PATTERN_TYPE).map(([val, patternType]) => [patternType, val]));
+/** w:shd/@w:color and @w:fill share the identical "auto"/"none" spelling for no concrete colour that w:color/@w:val already uses on a run -- both defer rather than asserting one. */
+function shdColor(value) {
+	return value === void 0 || value === "auto" || value === "none" ? void 0 : (0, document_schema_js.rgbHexToColor)(value);
+}
+/** One <w:shd> element -> a ContentCellFill, or undefined where it states none. */
+function readCellShading(tcPr) {
+	const shd = tcPr === void 0 ? void 0 : require_typed_util.childrenWithTag(tcPr, "w:shd")[0];
+	if (shd === void 0) return;
+	const val = require_typed_util.attr(shd, "w:val");
+	const fill = shdColor(require_typed_util.attr(shd, "w:fill"));
+	const color = shdColor(require_typed_util.attr(shd, "w:color"));
+	if (val === void 0 || val === "clear") return fill === void 0 ? void 0 : {
+		kind: "solid",
+		color: fill
+	};
+	if (val === "solid") return color === void 0 ? void 0 : {
+		kind: "solid",
+		color
+	};
+	const patternType = SHD_VAL_TO_PATTERN_TYPE[val];
+	if (patternType === void 0) return;
+	return {
+		kind: "pattern",
+		patternType,
+		...color !== void 0 ? { foregroundColor: color } : {},
+		...fill !== void 0 ? { backgroundColor: fill } : {}
+	};
+}
+/** The inverse of readCellShading: a ContentCellFill's own single <w:shd> element. A 'solid' fill writes w:val="clear" with the colour stated as w:fill (the plain background a real producer's own solid cell fill is spelled with) and w:color left automatic. A 'pattern' fill writes its own token from PATTERN_TYPE_TO_SHD_VAL, with w:color/w:fill stated for whichever of foregroundColor/backgroundColor the fill actually carries and left automatic for the one it does not -- throwing for a SpreadsheetML-only pattern name ST_Shd has no member for, rather than writing the wrong pattern or silently dropping it. */
+function buildCellShading(fill) {
+	switch (fill.kind) {
+		case "solid": return require_xml_fragment.el("w:shd", {
+			"w:val": "clear",
+			"w:color": "auto",
+			"w:fill": (0, document_schema_js.colorToRgbHex)(fill.color)
+		});
+		case "pattern": {
+			const val = PATTERN_TYPE_TO_SHD_VAL.get(fill.patternType);
+			if (val === void 0) throw new Error(`ooxml.js cannot write a '${fill.patternType}' cell fill: ECMA-376's own ST_Shd vocabulary has no member for it, that pattern name belonging only to SpreadsheetML's ST_PatternType half of ContentCellPatternType's shared vocabulary`);
+			return require_xml_fragment.el("w:shd", {
+				"w:val": val,
+				"w:color": fill.foregroundColor === void 0 ? "auto" : (0, document_schema_js.colorToRgbHex)(fill.foregroundColor),
+				"w:fill": fill.backgroundColor === void 0 ? "auto" : (0, document_schema_js.colorToRgbHex)(fill.backgroundColor)
+			});
+		}
+		default: throw new Error(`ooxml.js cannot write a cell fill with kind '${(0, document_schema_js.unrecognizedFillKind)(fill)}': ContentCellFillSchema's discriminated union only defines 'solid' and 'pattern'`);
+	}
+}
+//#endregion
+exports.buildCellShading = buildCellShading;
+exports.readCellShading = readCellShading;

package/dist/typed/docx/shading.d.cts

@@ -0,0 +1,2 @@
+import { n as readCellShading, t as buildCellShading } from "../../shading-DB9hu40o.cjs";
+export { buildCellShading, readCellShading };

package/dist/typed/docx/shading.d.ts

@@ -0,0 +1,2 @@
+import { n as readCellShading, t as buildCellShading } from "../../shading-BF2-DM4L.js";
+export { buildCellShading, readCellShading };

package/dist/typed/docx/shading.js

@@ -0,0 +1,93 @@
+import { el } from "../../xml/fragment.js";
+import { attr, childrenWithTag } from "../util.js";
+import { colorToRgbHex, rgbHexToColor, unrecognizedFillKind } from "document-schema.js";
+//#region src/typed/docx/shading.ts
+const SHD_VAL_TO_PATTERN_TYPE = {
+	pct5: "percent5",
+	pct10: "percent10",
+	pct12: "percent12",
+	pct15: "percent15",
+	pct20: "percent20",
+	pct25: "percent25",
+	pct30: "percent30",
+	pct35: "percent35",
+	pct37: "percent37",
+	pct40: "percent40",
+	pct45: "percent45",
+	pct50: "percent50",
+	pct55: "percent55",
+	pct60: "percent60",
+	pct62: "percent62",
+	pct65: "percent65",
+	pct70: "percent70",
+	pct75: "percent75",
+	pct80: "percent80",
+	pct85: "percent85",
+	pct87: "percent87",
+	pct90: "percent90",
+	pct95: "percent95",
+	horzStripe: "horizontalStripe",
+	vertStripe: "verticalStripe",
+	reverseDiagStripe: "reverseDiagonalStripe",
+	diagStripe: "diagonalStripe",
+	horzCross: "horizontalCross",
+	diagCross: "diagonalCross",
+	thinHorzStripe: "thinHorizontalStripe",
+	thinVertStripe: "thinVerticalStripe",
+	thinReverseDiagStripe: "thinReverseDiagonalStripe",
+	thinDiagStripe: "thinDiagonalStripe",
+	thinHorzCross: "thinHorizontalCross",
+	thinDiagCross: "thinDiagonalCross"
+};
+/** The inverse of SHD_VAL_TO_PATTERN_TYPE, built from it rather than restated by hand so the two can never drift apart. Every ContentCellPatternType this writer is ever asked to state has an entry, since the Word-family half of the shared vocabulary is exactly SHD_VAL_TO_PATTERN_TYPE's own value set -- the SpreadsheetML-only members (mediumGray through gray0625) are absent, ST_Shd having no equivalent for them at all. */
+const PATTERN_TYPE_TO_SHD_VAL = new Map(Object.entries(SHD_VAL_TO_PATTERN_TYPE).map(([val, patternType]) => [patternType, val]));
+/** w:shd/@w:color and @w:fill share the identical "auto"/"none" spelling for no concrete colour that w:color/@w:val already uses on a run -- both defer rather than asserting one. */
+function shdColor(value) {
+	return value === void 0 || value === "auto" || value === "none" ? void 0 : rgbHexToColor(value);
+}
+/** One <w:shd> element -> a ContentCellFill, or undefined where it states none. */
+function readCellShading(tcPr) {
+	const shd = tcPr === void 0 ? void 0 : childrenWithTag(tcPr, "w:shd")[0];
+	if (shd === void 0) return;
+	const val = attr(shd, "w:val");
+	const fill = shdColor(attr(shd, "w:fill"));
+	const color = shdColor(attr(shd, "w:color"));
+	if (val === void 0 || val === "clear") return fill === void 0 ? void 0 : {
+		kind: "solid",
+		color: fill
+	};
+	if (val === "solid") return color === void 0 ? void 0 : {
+		kind: "solid",
+		color
+	};
+	const patternType = SHD_VAL_TO_PATTERN_TYPE[val];
+	if (patternType === void 0) return;
+	return {
+		kind: "pattern",
+		patternType,
+		...color !== void 0 ? { foregroundColor: color } : {},
+		...fill !== void 0 ? { backgroundColor: fill } : {}
+	};
+}
+/** The inverse of readCellShading: a ContentCellFill's own single <w:shd> element. A 'solid' fill writes w:val="clear" with the colour stated as w:fill (the plain background a real producer's own solid cell fill is spelled with) and w:color left automatic. A 'pattern' fill writes its own token from PATTERN_TYPE_TO_SHD_VAL, with w:color/w:fill stated for whichever of foregroundColor/backgroundColor the fill actually carries and left automatic for the one it does not -- throwing for a SpreadsheetML-only pattern name ST_Shd has no member for, rather than writing the wrong pattern or silently dropping it. */
+function buildCellShading(fill) {
+	switch (fill.kind) {
+		case "solid": return el("w:shd", {
+			"w:val": "clear",
+			"w:color": "auto",
+			"w:fill": colorToRgbHex(fill.color)
+		});
+		case "pattern": {
+			const val = PATTERN_TYPE_TO_SHD_VAL.get(fill.patternType);
+			if (val === void 0) throw new Error(`ooxml.js cannot write a '${fill.patternType}' cell fill: ECMA-376's own ST_Shd vocabulary has no member for it, that pattern name belonging only to SpreadsheetML's ST_PatternType half of ContentCellPatternType's shared vocabulary`);
+			return el("w:shd", {
+				"w:val": val,
+				"w:color": fill.foregroundColor === void 0 ? "auto" : colorToRgbHex(fill.foregroundColor),
+				"w:fill": fill.backgroundColor === void 0 ? "auto" : colorToRgbHex(fill.backgroundColor)
+			});
+		}
+		default: throw new Error(`ooxml.js cannot write a cell fill with kind '${unrecognizedFillKind(fill)}': ContentCellFillSchema's discriminated union only defines 'solid' and 'pattern'`);
+	}
+}
+//#endregion
+export { buildCellShading, readCellShading };

package/dist/typed/docx/write.cjs

@@ -5,6 +5,7 @@ const require_codec = require("../../codec.cjs");
 const require_xml_fragment = require("../../xml/fragment.cjs");
 const require_xml_entities = require("../../xml/entities.cjs");
 const require_typed_shared_units = require("../shared/units.cjs");
+const require_typed_docx_shading = require("./shading.cjs");
 const require_typed_docx_constructs = require("./constructs.cjs");
 const require_typed_xlsx_build = require("../xlsx/build.cjs");
 let document_schema_js = require("document-schema.js");
@@ -337,11 +338,7 @@ function buildCell(cell, state, deleted, gridSpan, vMerge) {
 	if (gridSpan > 1) tcPrChildren.push(require_xml_fragment.el("w:gridSpan", { "w:val": String(gridSpan) }));
 	if (vMerge === "restart") tcPrChildren.push(require_xml_fragment.el("w:vMerge", { "w:val": "restart" }));
 	else if (vMerge === "continue") tcPrChildren.push(require_xml_fragment.el("w:vMerge"));
-	if (cell.background !== void 0) tcPrChildren.push(require_xml_fragment.el("w:shd", {
-		"w:val": "clear",
-		"w:color": "auto",
-		"w:fill": (0, document_schema_js.colorToRgbHex)(cell.background)
-	}));
+	if (cell.background !== void 0) tcPrChildren.push(require_typed_docx_shading.buildCellShading(cell.background));
 	if (cell.borders !== void 0) tcPrChildren.push(buildCellBorders(cell.borders));
 	const content = buildBlockFlow(cell.blocks, state, deleted);
 	const body = content.length === 0 ? [require_xml_fragment.el("w:p")] : content;

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

@@ -1,2 +1,2 @@
-import { i as buildDocxPackageFromContent, n as DocxContent, r as EmbeddedPresentationSerialiser, t as BuildDocxContentOptions } from "../../write-BGTpp3RS.cjs";
+import { i as buildDocxPackageFromContent, n as DocxContent, r as EmbeddedPresentationSerialiser, t as BuildDocxContentOptions } from "../../write-C81qQcnp.cjs";
 export { BuildDocxContentOptions, DocxContent, EmbeddedPresentationSerialiser, buildDocxPackageFromContent };

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

@@ -1,2 +1,2 @@
-import { i as buildDocxPackageFromContent, n as DocxContent, r as EmbeddedPresentationSerialiser, t as BuildDocxContentOptions } from "../../write-Cnfu3zdB.js";
+import { i as buildDocxPackageFromContent, n as DocxContent, r as EmbeddedPresentationSerialiser, t as BuildDocxContentOptions } from "../../write-h7kU0YPl.js";
 export { BuildDocxContentOptions, DocxContent, EmbeddedPresentationSerialiser, buildDocxPackageFromContent };

package/dist/typed/docx/write.js

@@ -4,6 +4,7 @@ import { encodePackage } from "../../codec.js";
 import { el, txt } from "../../xml/fragment.js";
 import { encodeXmlText } from "../../xml/entities.js";
 import { ptToEighthPoints, ptToEmu, ptToHalfPoints, ptToTwips } from "../shared/units.js";
+import { buildCellShading } from "./shading.js";
 import { TABLE_OF_CONTENTS_GALLERY, isDeletedChange } from "./constructs.js";
 import { buildXlsxPackageFromContent } from "../xlsx/build.js";
 import { colorToRgbHex, findConstructMarkerImbalance, findRunConstructFault } from "document-schema.js";
@@ -336,11 +337,7 @@ function buildCell(cell, state, deleted, gridSpan, vMerge) {
 	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.background !== void 0) tcPrChildren.push(buildCellShading(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;

package/dist/typed/embedded.cjs

@@ -1,4 +1,4 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_read = require("../read-6whiWc5N.cjs");
+const require_read = require("../read-Bu4DECZB.cjs");
 exports.readEmbeddedOoxmlPayload = require_read.readEmbeddedOoxmlPayload;
 exports.readEmbeddedPayloadPart = require_read.readEmbeddedPayloadPart;

package/dist/typed/embedded.js

@@ -1,2 +1,2 @@
-import { c as readEmbeddedPayloadPart, s as readEmbeddedOoxmlPayload } from "../read-BrAuHnvH.js";
+import { c as readEmbeddedPayloadPart, s as readEmbeddedOoxmlPayload } from "../read-DlkyVzBP.js";
 export { readEmbeddedOoxmlPayload, readEmbeddedPayloadPart };

package/dist/typed/pptx/read.cjs

@@ -1,4 +1,4 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_read = require("../../read-6whiWc5N.cjs");
+const require_read = require("../../read-Bu4DECZB.cjs");
 exports.PptxDocumentSchema = require_read.PptxDocumentSchema;
 exports.readPptxContent = require_read.readPptxContent;

package/dist/typed/pptx/read.js

@@ -1,2 +1,2 @@
-import { l as PptxDocumentSchema, u as readPptxContent } from "../../read-BrAuHnvH.js";
+import { l as PptxDocumentSchema, u as readPptxContent } from "../../read-DlkyVzBP.js";
 export { PptxDocumentSchema, readPptxContent };

package/dist/typed/shared/metadata.cjs

@@ -1,4 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_xml_fragment = require("../../xml/fragment.cjs");
+const require_xml_entities = require("../../xml/entities.cjs");
 const require_typed_util = require("../util.cjs");
 let zod = require("zod");
 //#region src/typed/shared/metadata.ts
@@ -13,6 +15,10 @@ const DocumentMetadataSchema = zod.z.object({
 });
 const CORE_PROPERTIES_PATH = "docProps/core.xml";
 const APP_PROPERTIES_PATH = "docProps/app.xml";
+const CORE_PROPERTIES_NAMESPACE_URI_FOR_PREFIX = {
+	cp: "http://schemas.openxmlformats.org/package/2006/metadata/core-properties",
+	dc: "http://purl.org/dc/elements/1.1/"
+};
 function firstElementText(root, tag) {
 	if (root === void 0) return;
 	const element = require_typed_util.childrenWithTag(root, tag)[0];
@@ -39,6 +45,53 @@ function readCoreProperties(pkg) {
 		modifiedIso: firstElementText(core, "dcterms:modified")
 	};
 }
+function hasCoreProperties(pkg) {
+	return pkg.parts[CORE_PROPERTIES_PATH]?.kind === "xml";
+}
+function namespacePrefixOf(tag) {
+	const colonIndex = tag.indexOf(":");
+	return colonIndex === -1 ? void 0 : tag.slice(0, colonIndex);
+}
+function ensureNamespaceDeclared(root, tag) {
+	const prefix = namespacePrefixOf(tag);
+	if (prefix === void 0) return;
+	const uri = CORE_PROPERTIES_NAMESPACE_URI_FOR_PREFIX[prefix];
+	if (uri === void 0) return;
+	const attrName = `xmlns:${prefix}`;
+	if (root.attributes.some((a) => a.name === attrName)) return;
+	root.attributes.push({
+		name: attrName,
+		value: uri
+	});
+}
+function setElementText(parent, tag, value) {
+	const existing = require_typed_util.childrenWithTag(parent, tag)[0];
+	const textNode = require_xml_fragment.txt(require_xml_entities.encodeXmlText(value));
+	if (existing !== void 0) {
+		existing.children = [textNode];
+		return;
+	}
+	ensureNamespaceDeclared(parent, tag);
+	parent.children.push(require_xml_fragment.el(tag, {}, [textNode]));
+}
+function removeChildrenWithTag(parent, tag) {
+	parent.children = parent.children.filter((child) => !(child.type === "element" && child.tag === tag));
+}
+function patchCoreProperties(pkg, overrides) {
+	const part = pkg.parts[CORE_PROPERTIES_PATH];
+	if (part?.kind !== "xml") throw new Error(`patchCoreProperties: package has no '${CORE_PROPERTIES_PATH}' XML part to patch -- check hasCoreProperties first, or build one from scratch instead`);
+	const core = require_typed_util.rootElement(part);
+	if (core === void 0) throw new Error(`patchCoreProperties: '${CORE_PROPERTIES_PATH}' has no root element`);
+	if (overrides.title !== void 0) setElementText(core, "dc:title", overrides.title);
+	if (overrides.author !== void 0) setElementText(core, "dc:creator", overrides.author);
+	if (overrides.subject !== void 0) setElementText(core, "dc:subject", overrides.subject);
+	if (overrides.keywords !== void 0) {
+		if (overrides.keywords.length > 0) setElementText(core, "cp:keywords", overrides.keywords.join(", "));
+		else removeChildrenWithTag(core, "cp:keywords");
+	}
+}
 //#endregion
 exports.DocumentMetadataSchema = DocumentMetadataSchema;
+exports.hasCoreProperties = hasCoreProperties;
+exports.patchCoreProperties = patchCoreProperties;
 exports.readCoreProperties = readCoreProperties;

package/dist/typed/shared/metadata.d.cts

@@ -1,2 +1,2 @@
-import { n as DocumentMetadataSchema, r as readCoreProperties, t as DocumentMetadata } from "../../metadata-C74-XCrx.cjs";
-export { DocumentMetadata, DocumentMetadataSchema, readCoreProperties };
+import { a as patchCoreProperties, i as hasCoreProperties, n as DocumentMetadata, o as readCoreProperties, r as DocumentMetadataSchema, t as CorePropertiesOverrides } from "../../metadata-Di0PfE5h.cjs";
+export { CorePropertiesOverrides, DocumentMetadata, DocumentMetadataSchema, hasCoreProperties, patchCoreProperties, readCoreProperties };

package/dist/typed/shared/metadata.d.ts

@@ -1,2 +1,2 @@
-import { n as DocumentMetadataSchema, r as readCoreProperties, t as DocumentMetadata } from "../../metadata-Bjfa88HQ.js";
-export { DocumentMetadata, DocumentMetadataSchema, readCoreProperties };
+import { a as patchCoreProperties, i as hasCoreProperties, n as DocumentMetadata, o as readCoreProperties, r as DocumentMetadataSchema, t as CorePropertiesOverrides } from "../../metadata-_k8PRY6p.js";
+export { CorePropertiesOverrides, DocumentMetadata, DocumentMetadataSchema, hasCoreProperties, patchCoreProperties, readCoreProperties };

package/dist/typed/shared/metadata.js

@@ -1,3 +1,5 @@
+import { el, txt } from "../../xml/fragment.js";
+import { encodeXmlText } from "../../xml/entities.js";
 import { childrenWithTag, rootElement, textContent } from "../util.js";
 import { z } from "zod";
 //#region src/typed/shared/metadata.ts
@@ -12,6 +14,10 @@ const DocumentMetadataSchema = z.object({
 });
 const CORE_PROPERTIES_PATH = "docProps/core.xml";
 const APP_PROPERTIES_PATH = "docProps/app.xml";
+const CORE_PROPERTIES_NAMESPACE_URI_FOR_PREFIX = {
+	cp: "http://schemas.openxmlformats.org/package/2006/metadata/core-properties",
+	dc: "http://purl.org/dc/elements/1.1/"
+};
 function firstElementText(root, tag) {
 	if (root === void 0) return;
 	const element = childrenWithTag(root, tag)[0];
@@ -38,5 +44,50 @@ function readCoreProperties(pkg) {
 		modifiedIso: firstElementText(core, "dcterms:modified")
 	};
 }
+function hasCoreProperties(pkg) {
+	return pkg.parts[CORE_PROPERTIES_PATH]?.kind === "xml";
+}
+function namespacePrefixOf(tag) {
+	const colonIndex = tag.indexOf(":");
+	return colonIndex === -1 ? void 0 : tag.slice(0, colonIndex);
+}
+function ensureNamespaceDeclared(root, tag) {
+	const prefix = namespacePrefixOf(tag);
+	if (prefix === void 0) return;
+	const uri = CORE_PROPERTIES_NAMESPACE_URI_FOR_PREFIX[prefix];
+	if (uri === void 0) return;
+	const attrName = `xmlns:${prefix}`;
+	if (root.attributes.some((a) => a.name === attrName)) return;
+	root.attributes.push({
+		name: attrName,
+		value: uri
+	});
+}
+function setElementText(parent, tag, value) {
+	const existing = childrenWithTag(parent, tag)[0];
+	const textNode = txt(encodeXmlText(value));
+	if (existing !== void 0) {
+		existing.children = [textNode];
+		return;
+	}
+	ensureNamespaceDeclared(parent, tag);
+	parent.children.push(el(tag, {}, [textNode]));
+}
+function removeChildrenWithTag(parent, tag) {
+	parent.children = parent.children.filter((child) => !(child.type === "element" && child.tag === tag));
+}
+function patchCoreProperties(pkg, overrides) {
+	const part = pkg.parts[CORE_PROPERTIES_PATH];
+	if (part?.kind !== "xml") throw new Error(`patchCoreProperties: package has no '${CORE_PROPERTIES_PATH}' XML part to patch -- check hasCoreProperties first, or build one from scratch instead`);
+	const core = rootElement(part);
+	if (core === void 0) throw new Error(`patchCoreProperties: '${CORE_PROPERTIES_PATH}' has no root element`);
+	if (overrides.title !== void 0) setElementText(core, "dc:title", overrides.title);
+	if (overrides.author !== void 0) setElementText(core, "dc:creator", overrides.author);
+	if (overrides.subject !== void 0) setElementText(core, "dc:subject", overrides.subject);
+	if (overrides.keywords !== void 0) {
+		if (overrides.keywords.length > 0) setElementText(core, "cp:keywords", overrides.keywords.join(", "));
+		else removeChildrenWithTag(core, "cp:keywords");
+	}
+}
 //#endregion
-export { DocumentMetadataSchema, readCoreProperties };
+export { DocumentMetadataSchema, hasCoreProperties, patchCoreProperties, readCoreProperties };

package/dist/typed/xlsx/build.cjs

@@ -197,11 +197,17 @@ function buildStylesPart(cellFormats, dxfTable) {
 		children.push(require_xml_fragment.el("numFmts", { count: String(numFmtElements.length) }, numFmtElements));
 	}
 	const fillElements = cellFormats.fillDeclarations().map((fill) => {
-		if (fill.patternType === "solid") {
-			const rgb = fill.rgb ?? "000000";
-			return require_xml_fragment.el("fill", {}, [require_xml_fragment.el("patternFill", { patternType: "solid" }, [require_xml_fragment.el("fgColor", { rgb: `FF${rgb}` }), require_xml_fragment.el("bgColor", { indexed: "64" })])]);
+		switch (fill.kind) {
+			case "none": return require_xml_fragment.el("fill", {}, [require_xml_fragment.el("patternFill", { patternType: "none" })]);
+			case "gray125": return require_xml_fragment.el("fill", {}, [require_xml_fragment.el("patternFill", { patternType: "gray125" })]);
+			case "solid": return require_xml_fragment.el("fill", {}, [require_xml_fragment.el("patternFill", { patternType: "solid" }, [require_xml_fragment.el("fgColor", { rgb: `FF${fill.rgb}` }), require_xml_fragment.el("bgColor", { indexed: "64" })])]);
+			case "pattern": {
+				const children = [];
+				if (fill.fgRgb !== void 0) children.push(require_xml_fragment.el("fgColor", { rgb: `FF${fill.fgRgb}` }));
+				if (fill.bgRgb !== void 0) children.push(require_xml_fragment.el("bgColor", { rgb: `FF${fill.bgRgb}` }));
+				return require_xml_fragment.el("fill", {}, [require_xml_fragment.el("patternFill", { patternType: fill.patternType }, children)]);
+			}
 		}
-		return require_xml_fragment.el("fill", {}, [require_xml_fragment.el("patternFill", { patternType: fill.patternType })]);
 	});
 	const borderElements = cellFormats.borderDeclarations().map((border) => {
 		const edgeElements = [];

package/dist/typed/xlsx/build.js

@@ -196,11 +196,17 @@ function buildStylesPart(cellFormats, dxfTable) {
 		children.push(el("numFmts", { count: String(numFmtElements.length) }, numFmtElements));
 	}
 	const fillElements = cellFormats.fillDeclarations().map((fill) => {
-		if (fill.patternType === "solid") {
-			const rgb = fill.rgb ?? "000000";
-			return el("fill", {}, [el("patternFill", { patternType: "solid" }, [el("fgColor", { rgb: `FF${rgb}` }), el("bgColor", { indexed: "64" })])]);
+		switch (fill.kind) {
+			case "none": return el("fill", {}, [el("patternFill", { patternType: "none" })]);
+			case "gray125": return el("fill", {}, [el("patternFill", { patternType: "gray125" })]);
+			case "solid": return el("fill", {}, [el("patternFill", { patternType: "solid" }, [el("fgColor", { rgb: `FF${fill.rgb}` }), el("bgColor", { indexed: "64" })])]);
+			case "pattern": {
+				const children = [];
+				if (fill.fgRgb !== void 0) children.push(el("fgColor", { rgb: `FF${fill.fgRgb}` }));
+				if (fill.bgRgb !== void 0) children.push(el("bgColor", { rgb: `FF${fill.bgRgb}` }));
+				return el("fill", {}, [el("patternFill", { patternType: fill.patternType }, children)]);
+			}
 		}
-		return el("fill", {}, [el("patternFill", { patternType: fill.patternType })]);
 	});
 	const borderElements = cellFormats.borderDeclarations().map((border) => {
 		const edgeElements = [];

package/dist/typed/xlsx/styles.cjs

@@ -18,6 +18,29 @@ function readNumberFormatCodesById(styleSheet) {
 	}
 	return codes;
 }
+const SPREADSHEETML_PATTERN_TYPES = /* @__PURE__ */ new Set([
+	"mediumGray",
+	"darkGray",
+	"lightGray",
+	"darkHorizontal",
+	"darkVertical",
+	"darkDown",
+	"darkUp",
+	"darkGrid",
+	"darkTrellis",
+	"lightHorizontal",
+	"lightVertical",
+	"lightDown",
+	"lightUp",
+	"lightGrid",
+	"lightTrellis",
+	"gray125",
+	"gray0625"
+]);
+/** Whether `value` is one of ST_PatternType's own seventeen non-solid, non-none members -- the only ContentCellPatternType members a `<patternFill>` can ever name, so a value this returns true for can be used as a ContentCellPatternType directly with no further mapping. */
+function isXlsxPatternType(value) {
+	return SPREADSHEETML_PATTERN_TYPES.has(value);
+}
 const XLSX_BORDER_STYLE = {
 	thin: {
 		weight: "thin",
@@ -89,8 +112,24 @@ function readColorRgb(container, colorTag) {
 }
 function readFillBackground(fill) {
 	const patternFill = require_typed_util.childrenWithTag(fill, "patternFill")[0];
-	if (patternFill === void 0 || require_typed_util.attr(patternFill, "patternType") !== "solid") return;
-	return readColorRgb(patternFill, "fgColor") ?? readColorRgb(patternFill, "bgColor");
+	if (patternFill === void 0) return;
+	const patternType = require_typed_util.attr(patternFill, "patternType");
+	if (patternType === "solid") {
+		const color = readColorRgb(patternFill, "fgColor") ?? readColorRgb(patternFill, "bgColor");
+		return color === void 0 ? void 0 : {
+			kind: "solid",
+			color
+		};
+	}
+	if (patternType === void 0 || !isXlsxPatternType(patternType)) return;
+	const foregroundColor = readColorRgb(patternFill, "fgColor");
+	const backgroundColor = readColorRgb(patternFill, "bgColor");
+	return {
+		kind: "pattern",
+		patternType,
+		...foregroundColor !== void 0 ? { foregroundColor } : {},
+		...backgroundColor !== void 0 ? { backgroundColor } : {}
+	};
 }
 function readFills(styleSheet) {
 	const fillsEl = require_typed_util.childrenWithTag(styleSheet, "fills")[0];
@@ -199,9 +238,12 @@ function signatureOfNumberFormat(format) {
 	return format.kind === "builtin" ? `builtin:${format.id}` : `custom:${format.code}`;
 }
 const EMPTY_DECORATION = {};
+function fillSignature(fill) {
+	return fill.kind === "solid" ? `solid:${(0, document_schema_js.colorToRgbHex)(fill.color)}` : `pattern:${fill.patternType}:${fill.foregroundColor === void 0 ? "" : (0, document_schema_js.colorToRgbHex)(fill.foregroundColor)}:${fill.backgroundColor === void 0 ? "" : (0, document_schema_js.colorToRgbHex)(fill.backgroundColor)}`;
+}
 function signatureOfDecoration(decoration) {
 	let sig = "";
-	if (decoration.background !== void 0) sig += `|bg:${(0, document_schema_js.colorToRgbHex)(decoration.background)}`;
+	if (decoration.background !== void 0) sig += `|bg:${fillSignature(decoration.background)}`;
 	const borders = decoration.borders;
 	if (borders !== void 0) for (const edge of [
 		"left",
@@ -236,8 +278,8 @@ var CellFormatTable = class {
 		borderId: EMPTY_BORDER_INDEX
 	}];
 	declared = [];
-	fillIndexByRgb = /* @__PURE__ */ new Map();
-	fills = [{ patternType: "none" }, { patternType: "gray125" }];
+	fillIndexBySignature = /* @__PURE__ */ new Map();
+	fills = [{ kind: "none" }, { kind: "gray125" }];
 	borderIndexBySignature = /* @__PURE__ */ new Map();
 	borders = [{ edges: {} }];
 	intern(format, decoration = EMPTY_DECORATION) {
@@ -282,15 +324,31 @@ var CellFormatTable = class {
 		return id;
 	}
 	internFill(background) {
-		const rgb = (0, document_schema_js.colorToRgbHex)(background);
-		const existing = this.fillIndexByRgb.get(rgb);
+		const signature = fillSignature(background);
+		const existing = this.fillIndexBySignature.get(signature);
 		if (existing !== void 0) return existing;
+		let declared;
+		switch (background.kind) {
+			case "solid":
+				declared = {
+					kind: "solid",
+					rgb: (0, document_schema_js.colorToRgbHex)(background.color)
+				};
+				break;
+			case "pattern":
+				if (!isXlsxPatternType(background.patternType)) throw new Error(`ooxml.js cannot write a '${background.patternType}' cell fill: ECMA-376's own ST_PatternType vocabulary has no member for it, that pattern name belonging only to WordprocessingML's ST_Shd half of ContentCellPatternType's shared vocabulary`);
+				declared = {
+					kind: "pattern",
+					patternType: background.patternType,
+					...background.foregroundColor === void 0 ? {} : { fgRgb: (0, document_schema_js.colorToRgbHex)(background.foregroundColor) },
+					...background.backgroundColor === void 0 ? {} : { bgRgb: (0, document_schema_js.colorToRgbHex)(background.backgroundColor) }
+				};
+				break;
+			default: throw new Error(`ooxml.js cannot write a cell fill with kind '${(0, document_schema_js.unrecognizedFillKind)(background)}': ContentCellFillSchema's discriminated union only defines 'solid' and 'pattern'`);
+		}
 		const index = this.fills.length;
-		this.fills.push({
-			patternType: "solid",
-			rgb
-		});
-		this.fillIndexByRgb.set(rgb, index);
+		this.fills.push(declared);
+		this.fillIndexBySignature.set(signature, index);
 		return index;
 	}
 	internBorder(borders) {