@stll/folio-core 0.59.0 → 0.61.0

package/dist/docx/rezip.js

@@ -2,6 +2,7 @@ import { consumeTrackedSectionEndpointRemoval } from "../internal/sectionEndpoin
 import { consumeSectionReferenceResolution } from "../internal/sectionReferenceResolution.js";
 import { CANONICAL_GAP } from "../types/canonicalCapabilities.js";
 import { canonicalJson } from "../utils/canonicalJson.js";
+import { base64ToBytes, decodeText, encodeUtf8 } from "../utils/textEncoding.js";
 import { isAllowedExternalWatermarkImageUrl } from "../watermark/index.js";
 import { appVersionInSchemaForm, normalizeAppVersionInExtendedProperties } from "./appVersionNormalization.js";
 import { withoutOrphanCommentRanges } from "./commentRangeIntegrity.js";
@@ -25,7 +26,7 @@ import { RELATIONSHIP_TYPES, parseRelationships, resolveRelativePath } from "./r
 import { removeResolvedHeaderFooterParts } from "./removeHeaderFooterParts.js";
 import { normalizeRevisionIdsInXmlParts } from "./revisionIdNormalization.js";
 import { buildPatchedNotePartXml, collectChangedNoteParaIds, collectParaIds, patchNumberingDefinitions, spliceXml } from "./selectiveXmlPatch.js";
-import { hasOwnedCommentsPart, planCommentParts, serializeComments, serializeCommentsExtended } from "./serializer/commentSerializer.js";
+import { canReplayCommentsPart, hasOwnedCommentsPart, planCommentParts, serializeComments, serializeCommentsExtended } from "./serializer/commentSerializer.js";
 import { serializeDocument } from "./serializer/documentSerializer.js";
 import { serializeFontTableXml } from "./serializer/fontTableSerializer.js";
 import { serializeHeaderFooter } from "./serializer/headerFooterSerializer.js";
@@ -200,7 +201,8 @@ function assertDocumentPackageFidelity({ originalDocumentFacts, serializedDocume
 async function serializeCommentsToZip(doc, zip, compressionLevel) {
 	const comments = doc.package.document.comments ?? [];
 	const sourceCommentsFile = findZipEntryCaseInsensitive(zip, "word/comments.xml");
-	const sourceCommentsXml = sourceCommentsFile ? await sourceCommentsFile.async("text") : void 0;
+	const sourceCommentsXml = sourceCommentsFile ? await sourceCommentsFile.async("uint8array").then((bytes) => decodeText(bytes, { ignoreBOM: true })) : void 0;
+	if (sourceCommentsXml !== void 0 && canReplayCommentsPart(doc, sourceCommentsXml)) return;
 	if (comments.length === 0) {
 		const ownsCommentsPart = hasOwnedCommentsPart(doc);
 		if (sourceCommentsXml === void 0 ? !ownsCommentsPart : !hasCommentEntries(sourceCommentsXml)) return;
@@ -210,7 +212,7 @@ async function serializeCommentsToZip(doc, zip, compressionLevel) {
 	writeZipPart({
 		zip,
 		path: sourceCommentsFile?.name ?? "word/comments.xml",
-		data: commentsXml,
+		data: encodeUtf8(commentsXml),
 		options: {
 			compression: "DEFLATE",
 			compressionOptions: { level: compressionLevel }
@@ -246,7 +248,7 @@ async function syncCommentsExtendedPart(plan, zip, compressionLevel) {
 	writeZipPart({
 		zip,
 		path: existing?.name ?? "word/commentsExtended.xml",
-		data: xml,
+		data: encodeUtf8(xml),
 		options: {
 			compression: "DEFLATE",
 			compressionOptions: { level: compressionLevel }
@@ -259,12 +261,12 @@ async function syncCommentsExtendedPart(plan, zip, compressionLevel) {
 async function transformPackagingFile(zip, path, transform, compressionLevel) {
 	const file = zip.file(path);
 	if (!file) return;
-	const xml = await file.async("text");
+	const xml = await file.async("uint8array").then((bytes) => decodeText(bytes, { ignoreBOM: true }));
 	const next = transform(xml);
 	if (next !== xml) writeZipPart({
 		zip,
 		path,
-		data: next,
+		data: encodeUtf8(next),
 		options: {
 			compression: "DEFLATE",
 			compressionOptions: { level: compressionLevel }
@@ -350,7 +352,7 @@ function collectDocxParts(doc, zip) {
 }
 async function readRelsOrStub(zip, relsPath) {
 	const file = zip.file(relsPath);
-	return (file ? await file.async("text") : EMPTY_RELS_XML).replace(/<Relationships(?<attrs>[^>]*)\/>/u, "<Relationships$<attrs>></Relationships>");
+	return (file ? await file.async("uint8array").then((bytes) => decodeText(bytes, { ignoreBOM: true })) : EMPTY_RELS_XML).replace(/<Relationships(?<attrs>[^>]*)\/>/u, "<Relationships$<attrs>></Relationships>");
 }
 function findMaxImageNum(zip) {
 	let maxImageNum = 0;
@@ -367,7 +369,7 @@ async function registerImageExtensions(zip, extensions, compressionLevel) {
 	if (extensions.size === 0) return;
 	const ctFile = zip.file("[Content_Types].xml");
 	if (!ctFile) return;
-	let ctXml = await ctFile.async("text");
+	let ctXml = await ctFile.async("uint8array").then((bytes) => decodeText(bytes, { ignoreBOM: true }));
 	let changed = false;
 	for (const ext of extensions) {
 		if (ctXml.includes(`Extension="${ext}"`)) continue;
@@ -379,7 +381,7 @@ async function registerImageExtensions(zip, extensions, compressionLevel) {
 	writeZipPart({
 		zip,
 		path: "[Content_Types].xml",
-		data: ctXml,
+		data: encodeUtf8(ctXml),
 		options: {
 			compression: "DEFLATE",
 			compressionOptions: { level: compressionLevel }
@@ -419,11 +421,8 @@ function decodeDataUrl(dataUrl) {
 	const payload = match.groups["data"];
 	const parameters = match.groups["parameters"];
 	let bytes;
-	if (parameters.split(";").some((parameter) => parameter.toLowerCase() === "base64")) {
-		const binary = atob(payload);
-		bytes = new Uint8Array(binary.length);
-		for (let i = 0; i < binary.length; i++) bytes[i] = binary.codePointAt(i) ?? 0;
-	} else bytes = new TextEncoder().encode(decodeURIComponent(payload));
+	if (parameters.split(";").some((parameter) => parameter.toLowerCase() === "base64")) bytes = base64ToBytes(payload);
+	else bytes = encodeUtf8(decodeURIComponent(payload));
 	return {
 		data: bytes.slice().buffer,
 		extension: MIME_TO_EXT[match.groups["mime"]] ?? "png"
@@ -457,7 +456,7 @@ async function processNewImages(parts, zip, compressionLevel) {
 			writeZipPart({
 				zip,
 				path: mediaPath,
-				data,
+				data: new Uint8Array(data),
 				options: {
 					compression: "DEFLATE",
 					compressionOptions: { level: compressionLevel }
@@ -475,7 +474,7 @@ async function processNewImages(parts, zip, compressionLevel) {
 		if (relEntries.length > 0) writeZipPart({
 			zip,
 			path: relsPath,
-			data: relsXml.replace("</Relationships>", `${relEntries.join("")}</Relationships>`),
+			data: encodeUtf8(relsXml.replace("</Relationships>", `${relEntries.join("")}</Relationships>`)),
 			options: {
 				compression: "DEFLATE",
 				compressionOptions: { level: compressionLevel }
@@ -495,7 +494,7 @@ const materializeEmbeddedMedia = async ({ document, zip, compressionLevel }) =>
 		writeZipPart({
 			zip,
 			path: media.path,
-			data: media.data,
+			data: new Uint8Array(media.data),
 			options: {
 				compression: "DEFLATE",
 				compressionOptions: { level: compressionLevel }
@@ -557,7 +556,7 @@ const publishCanonicalImageResources = async ({ document, zip, compressionLevel
 				writeZipPart({
 					zip,
 					path: absolute,
-					data: media.data,
+					data: new Uint8Array(media.data),
 					options: {
 						compression: "DEFLATE",
 						compressionOptions: { level: compressionLevel }
@@ -587,7 +586,7 @@ const publishCanonicalImageResources = async ({ document, zip, compressionLevel
 		if (changed) writeZipPart({
 			zip,
 			path: relsPath,
-			data: xml,
+			data: encodeUtf8(xml),
 			options: {
 				compression: "DEFLATE",
 				compressionOptions: { level: compressionLevel }
@@ -738,7 +737,7 @@ async function processNewHyperlinks(parts, zip, compressionLevel) {
 			writeZipPart({
 				zip,
 				path: relsPath,
-				data: captureVerbatimXml(root),
+				data: encodeUtf8(captureVerbatimXml(root)),
 				options: {
 					compression: "DEFLATE",
 					compressionOptions: { level: compressionLevel }
@@ -762,7 +761,7 @@ async function processNewHyperlinks(parts, zip, compressionLevel) {
 const normalizePackageIdsInZip = async (zip, compressionLevel) => {
 	const xmlParts = /* @__PURE__ */ new Map();
 	for (const [path, file] of Object.entries(zip.files)) if (!file.dir && path.startsWith("word/") && path.endsWith(".xml")) {
-		const xml = await file.async("text");
+		const xml = await file.async("uint8array").then((bytes) => decodeText(bytes, { ignoreBOM: true }));
 		assertValidOoxmlNumericIds(xml, path);
 		xmlParts.set(path, xml);
 	}
@@ -772,7 +771,7 @@ const normalizePackageIdsInZip = async (zip, compressionLevel) => {
 		writeZipPart({
 			zip,
 			path,
-			data: xml,
+			data: encodeUtf8(xml),
 			options: {
 				compression: "DEFLATE",
 				compressionOptions: { level: compressionLevel }
@@ -789,12 +788,12 @@ const EXTENDED_PROPERTIES_PATH = "docProps/app.xml";
 const normalizeAppVersionInZip = async (zip, compressionLevel) => {
 	const extendedProperties = zip.file(EXTENDED_PROPERTIES_PATH);
 	if (!extendedProperties) return;
-	const xml = await extendedProperties.async("text");
+	const xml = await extendedProperties.async("uint8array").then((bytes) => decodeText(bytes, { ignoreBOM: true }));
 	const normalized = normalizeAppVersionInExtendedProperties(xml);
 	if (normalized !== xml) writeZipPart({
 		zip,
 		path: EXTENDED_PROPERTIES_PATH,
-		data: normalized,
+		data: encodeUtf8(normalized),
 		options: {
 			compression: "DEFLATE",
 			compressionOptions: { level: compressionLevel }
@@ -853,7 +852,7 @@ const loadParsedZipSource = async (document, buffer) => {
 	if (cached?.buffer === buffer) return cached;
 	const zip = await JSZip.loadAsync(buffer);
 	removeUnsafeEntries(zip);
-	const [documentXml, corePropertiesXml] = await Promise.all([zip.file("word/document.xml")?.async("text"), zip.file("docProps/core.xml")?.async("text")]);
+	const [documentXml, corePropertiesXml] = await Promise.all([zip.file("word/document.xml")?.async("uint8array").then((bytes) => decodeText(bytes, { ignoreBOM: true })), zip.file("docProps/core.xml")?.async("uint8array").then((bytes) => decodeText(bytes, { ignoreBOM: true }))]);
 	const source = {
 		buffer,
 		zip,
@@ -924,7 +923,7 @@ const finishRepack = async ({ document: sourceDocument, originalZip, outputZip,
 	writeZipPart({
 		zip: outputZip,
 		path: "word/document.xml",
-		data: documentXml,
+		data: encodeUtf8(documentXml),
 		options: {
 			compression: "DEFLATE",
 			compressionOptions: { level: compressionLevel }
@@ -957,10 +956,10 @@ const finishRepack = async ({ document: sourceDocument, originalZip, outputZip,
 	if (updateModifiedDate && originalCorePropertiesXml) writeZipPart({
 		zip: outputZip,
 		path: "docProps/core.xml",
-		data: updateCoreProperties(originalCorePropertiesXml, {
+		data: encodeUtf8(updateCoreProperties(originalCorePropertiesXml, {
 			updateModifiedDate,
 			...modifiedBy !== void 0 ? { modifiedBy } : {}
-		}),
+		})),
 		options: {
 			compression: "DEFLATE",
 			compressionOptions: { level: compressionLevel }
@@ -973,7 +972,7 @@ async function repackDocxWithSectionEndpointRemoval({ document: doc, options, se
 	const { compressionLevel = 6, updateModifiedDate = true, modifiedBy, changedNoteParaIds } = options;
 	const exportDocument = withoutOrphanCommentRanges(doc);
 	const originalZip = await JSZip.loadAsync(doc.originalBuffer);
-	const [originalDocumentXml, originalCorePropertiesXml] = await Promise.all([originalZip.file("word/document.xml")?.async("text"), originalZip.file("docProps/core.xml")?.async("text")]);
+	const [originalDocumentXml, originalCorePropertiesXml] = await Promise.all([originalZip.file("word/document.xml")?.async("uint8array").then((bytes) => decodeText(bytes, { ignoreBOM: true })), originalZip.file("docProps/core.xml")?.async("uint8array").then((bytes) => decodeText(bytes, { ignoreBOM: true }))]);
 	removeUnsafeEntries(originalZip);
 	const newZip = cloneDocxZip(originalZip);
 	return finishRepack({
@@ -1019,7 +1018,7 @@ async function repackDocxFromRaw(doc, rawContent, options = {}) {
 			writeZipPart({
 				zip: newZip,
 				path,
-				data: "",
+				data: /* @__PURE__ */ new Uint8Array(),
 				options: {
 					dir: true,
 					date: file.date
@@ -1028,10 +1027,11 @@ async function repackDocxFromRaw(doc, rawContent, options = {}) {
 			continue;
 		}
 		if (isUnsafePackagePath(path)) continue;
+		const content = await file.async("arraybuffer");
 		writeZipPart({
 			zip: newZip,
 			path,
-			data: await file.async("arraybuffer"),
+			data: new Uint8Array(content),
 			options: {
 				compression: "DEFLATE",
 				compressionOptions: { level: compressionLevel }
@@ -1068,7 +1068,7 @@ async function repackDocxFromRaw(doc, rawContent, options = {}) {
 	writeZipPart({
 		zip: newZip,
 		path: "word/document.xml",
-		data: documentXml,
+		data: encodeUtf8(documentXml),
 		options: {
 			compression: "DEFLATE",
 			compressionOptions: { level: compressionLevel }
@@ -1101,10 +1101,10 @@ async function repackDocxFromRaw(doc, rawContent, options = {}) {
 	if (updateModifiedDate && rawContent.corePropsXml) writeZipPart({
 		zip: newZip,
 		path: "docProps/core.xml",
-		data: updateCoreProperties(rawContent.corePropsXml, {
+		data: encodeUtf8(updateCoreProperties(rawContent.corePropsXml, {
 			updateModifiedDate,
 			...modifiedBy !== void 0 ? { modifiedBy } : {}
-		}),
+		})),
 		options: {
 			compression: "DEFLATE",
 			compressionOptions: { level: compressionLevel }
@@ -1197,11 +1197,11 @@ async function dropAttachedTemplateReference(zip, compressionLevel) {
 	const settingsFile = zip.file(SETTINGS_PART);
 	if (!settingsFile) return;
 	const relsFile = zip.file(SETTINGS_RELS_PART);
-	const filtered = withoutAttachedTemplate(await settingsFile.async("text"), await relsFile?.async("text"));
+	const filtered = withoutAttachedTemplate(await settingsFile.async("uint8array").then((bytes) => decodeText(bytes, { ignoreBOM: true })), await relsFile?.async("uint8array").then((bytes) => decodeText(bytes, { ignoreBOM: true })));
 	if (filtered.settingsXml !== void 0) writeZipPart({
 		zip,
 		path: SETTINGS_PART,
-		data: filtered.settingsXml,
+		data: encodeUtf8(filtered.settingsXml),
 		options: {
 			compression: "DEFLATE",
 			compressionOptions: { level: compressionLevel }
@@ -1210,7 +1210,7 @@ async function dropAttachedTemplateReference(zip, compressionLevel) {
 	if (filtered.relsXml !== void 0) writeZipPart({
 		zip,
 		path: SETTINGS_RELS_PART,
-		data: filtered.relsXml,
+		data: encodeUtf8(filtered.relsXml),
 		options: {
 			compression: "DEFLATE",
 			compressionOptions: { level: compressionLevel }
@@ -1224,14 +1224,14 @@ async function dropAttachedTemplateReference(zip, compressionLevel) {
 async function ensureCommentsContentType(zip, compressionLevel) {
 	const ctFile = zip.file("[Content_Types].xml");
 	if (!ctFile) return;
-	let ctXml = await ctFile.async("text");
+	let ctXml = await ctFile.async("uint8array").then((bytes) => decodeText(bytes, { ignoreBOM: true }));
 	if (ctXml.toLowerCase().includes("/word/comments.xml")) return;
 	const commentsPartPath = findZipEntryCaseInsensitive(zip, "word/comments.xml")?.name ?? "word/comments.xml";
 	ctXml = ctXml.replace("</Types>", `<Override PartName="/${commentsPartPath}" ContentType="${COMMENTS_CONTENT_TYPE}"/></Types>`);
 	writeZipPart({
 		zip,
 		path: "[Content_Types].xml",
-		data: ctXml,
+		data: encodeUtf8(ctXml),
 		options: {
 			compression: "DEFLATE",
 			compressionOptions: { level: compressionLevel }
@@ -1246,7 +1246,7 @@ async function ensureCommentsRelationship(zip, compressionLevel) {
 	const relsPath = "word/_rels/document.xml.rels";
 	const relsFile = zip.file(relsPath);
 	if (!relsFile) return;
-	let relsXml = await relsFile.async("text");
+	let relsXml = await relsFile.async("uint8array").then((bytes) => decodeText(bytes, { ignoreBOM: true }));
 	if (relsXml.toLowerCase().includes("comments.xml")) return;
 	const commentsPartPath = findZipEntryCaseInsensitive(zip, "word/comments.xml")?.name ?? "word/comments.xml";
 	const newRId = `rId${findMaxRId(relsXml) + 1}`;
@@ -1254,7 +1254,7 @@ async function ensureCommentsRelationship(zip, compressionLevel) {
 	writeZipPart({
 		zip,
 		path: relsPath,
-		data: relsXml,
+		data: encodeUtf8(relsXml),
 		options: {
 			compression: "DEFLATE",
 			compressionOptions: { level: compressionLevel }
@@ -1275,7 +1275,7 @@ async function updateDocumentXml(originalBuffer, newDocumentXml, options = {}) {
 	writeZipPart({
 		zip,
 		path: "word/document.xml",
-		data: newDocumentXml,
+		data: encodeUtf8(newDocumentXml),
 		options: {
 			compression: "DEFLATE",
 			compressionOptions: { level: compressionLevel }
@@ -1302,7 +1302,7 @@ async function updateXmlFile(originalBuffer, path, content, options = {}) {
 	writeZipPart({
 		zip,
 		path,
-		data: content,
+		data: encodeUtf8(content),
 		options: {
 			compression: "DEFLATE",
 			compressionOptions: { level: compressionLevel }
@@ -1340,7 +1340,7 @@ async function applyUpdatesToZip(zip, updates, options = {}) {
 	for (const [path, content] of updates) writeZipPart({
 		zip,
 		path,
-		data: content,
+		data: typeof content === "string" ? encodeUtf8(content) : new Uint8Array(content),
 		options: {
 			compression: "DEFLATE",
 			compressionOptions: { level: compressionLevel }
@@ -1365,14 +1365,14 @@ async function addRelationship(originalBuffer, relationship) {
 	const relsPath = "word/_rels/document.xml.rels";
 	const relsFile = zip.file(relsPath);
 	if (!relsFile) panic("document.xml.rels not found in DOCX");
-	const relsXml = await relsFile.async("text");
+	const relsXml = await relsFile.async("uint8array").then((bytes) => decodeText(bytes, { ignoreBOM: true }));
 	const newRId = `rId${findMaxRId(relsXml) + 1}`;
 	const targetModeAttr = relationship.targetMode === "External" ? " TargetMode=\"External\"" : "";
 	const newRelElement = `<Relationship Id="${newRId}" Type="${relationship.type}" Target="${escapeXmlAttribute(relationship.target)}"${targetModeAttr}/>`;
 	writeZipPart({
 		zip,
 		path: relsPath,
-		data: relsXml.replace("</Relationships>", `${newRelElement}</Relationships>`)
+		data: encodeUtf8(relsXml.replace("</Relationships>", `${newRelElement}</Relationships>`))
 	});
 	return {
 		buffer: await zip.generateAsync({
@@ -1398,7 +1398,7 @@ async function addMedia(originalBuffer, filename, data, mimeType) {
 	writeZipPart({
 		zip,
 		path: mediaPath,
-		data
+		data: new Uint8Array(data)
 	});
 	const relResult = await addRelationship(await zip.generateAsync({ type: "arraybuffer" }), {
 		type: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/image",
@@ -1406,7 +1406,7 @@ async function addMedia(originalBuffer, filename, data, mimeType) {
 	});
 	const contentTypesFile = zip.file("[Content_Types].xml");
 	if (contentTypesFile) {
-		const contentTypesXml = await contentTypesFile.async("text");
+		const contentTypesXml = await contentTypesFile.async("uint8array").then((bytes) => decodeText(bytes, { ignoreBOM: true }));
 		const extension = filename.split(".").pop()?.toLowerCase() || "";
 		if (!contentTypesXml.includes(`Extension="${extension}"`) && extension) {
 			const extensionElement = `<Default Extension="${extension}" ContentType="${getContentTypeForExtension(extension, mimeType)}"/>`;
@@ -1415,7 +1415,7 @@ async function addMedia(originalBuffer, filename, data, mimeType) {
 			writeZipPart({
 				zip: finalZip,
 				path: "[Content_Types].xml",
-				data: updatedContentTypes
+				data: encodeUtf8(updatedContentTypes)
 			});
 			return {
 				buffer: await finalZip.generateAsync({
@@ -1565,7 +1565,7 @@ async function materializeNewHeaderFooterParts(doc, zip, compressionLevel) {
 	if (relEntries.length > 0) writeZipPart({
 		zip,
 		path: relsPath,
-		data: relsXml.replace("</Relationships>", `${relEntries.join("")}</Relationships>`),
+		data: encodeUtf8(relsXml.replace("</Relationships>", `${relEntries.join("")}</Relationships>`)),
 		options: {
 			compression: "DEFLATE",
 			compressionOptions
@@ -1573,12 +1573,12 @@ async function materializeNewHeaderFooterParts(doc, zip, compressionLevel) {
 	});
 	const ctFile = zip.file("[Content_Types].xml");
 	if (ctFile) {
-		const original = await ctFile.async("text");
+		const original = await ctFile.async("uint8array").then((bytes) => decodeText(bytes, { ignoreBOM: true }));
 		const updated = registerContentTypeParts(original, contentTypeParts);
 		if (updated !== original) writeZipPart({
 			zip,
 			path: "[Content_Types].xml",
-			data: updated,
+			data: encodeUtf8(updated),
 			options: {
 				compression: "DEFLATE",
 				compressionOptions
@@ -1731,7 +1731,7 @@ async function rebindWatermarkRelIds({ document: doc, zip, compressionLevel, bod
 		if (xml) writeZipPart({
 			zip,
 			path,
-			data: xml,
+			data: encodeUtf8(xml),
 			options: {
 				compression: "DEFLATE",
 				compressionOptions
@@ -1758,7 +1758,7 @@ async function collectHeaderFooterUpdates(doc, { sourceZip, onDiagnostic }) {
 			if (rel && rel.type === type && rel.target) {
 				const path = resolveRelativePath(documentRelsPath, rel.target);
 				const sourceFile = findZipEntryCaseInsensitive(sourceZip, path.toLowerCase());
-				const bindings = sourceFile ? readRootNamespaceBindings(await sourceFile.async("text")) : /* @__PURE__ */ new Map();
+				const bindings = sourceFile ? readRootNamespaceBindings(await sourceFile.async("uint8array").then((bytes) => decodeText(bytes, { ignoreBOM: true }))) : /* @__PURE__ */ new Map();
 				updates.set(path, serializeHeaderFooter(headerFooter, {
 					path,
 					bindings,
@@ -1778,7 +1778,7 @@ async function serializeHeadersFootersToZip({ doc, zip, compressionLevel, onDiag
 	})) writeZipPart({
 		zip,
 		path: filename,
-		data: xml,
+		data: encodeUtf8(xml),
 		options: {
 			compression: "DEFLATE",
 			compressionOptions
@@ -1834,25 +1834,25 @@ async function materializeNewNotePart({ contentType, newZip, partPath, relations
 	const relationshipsFile = findNotePartEntry(newZip, "word/_rels/document.xml.rels");
 	if (!contentTypesFile || !relationshipsFile) throw new DocxPackageFidelityError(`Cannot create ${partPath}: the DOCX package is missing content types or document relationships`);
 	const compressionOptions = { level: compressionLevel };
-	const contentTypesXml = await contentTypesFile.async("text");
+	const contentTypesXml = await contentTypesFile.async("uint8array").then((bytes) => decodeText(bytes, { ignoreBOM: true }));
 	const partName = `/${partPath}`;
 	if (!contentTypesXml.toLowerCase().includes(partName.toLowerCase())) writeZipPart({
 		zip: newZip,
 		path: contentTypesFile.name,
-		data: contentTypesXml.replace("</Types>", () => `<Override PartName="${partName}" ContentType="${contentType}"/></Types>`),
+		data: encodeUtf8(contentTypesXml.replace("</Types>", () => `<Override PartName="${partName}" ContentType="${contentType}"/></Types>`)),
 		options: {
 			compression: "DEFLATE",
 			compressionOptions
 		}
 	});
-	const relationshipsXml = await relationshipsFile.async("text");
+	const relationshipsXml = await relationshipsFile.async("uint8array").then((bytes) => decodeText(bytes, { ignoreBOM: true }));
 	if (!relationshipsXml.includes(relationshipType)) {
 		const relationshipId = `rId${findMaxRId(relationshipsXml) + 1}`;
 		const target = partPath.slice(5);
 		writeZipPart({
 			zip: newZip,
 			path: relationshipsFile.name,
-			data: relationshipsXml.replace("</Relationships>", () => `<Relationship Id="${relationshipId}" Type="${relationshipType}" Target="${target}"/></Relationships>`),
+			data: encodeUtf8(relationshipsXml.replace("</Relationships>", () => `<Relationship Id="${relationshipId}" Type="${relationshipType}" Target="${target}"/></Relationships>`)),
 			options: {
 				compression: "DEFLATE",
 				compressionOptions
@@ -1862,7 +1862,7 @@ async function materializeNewNotePart({ contentType, newZip, partPath, relations
 	writeZipPart({
 		zip: newZip,
 		path: partPath,
-		data: serializedPart,
+		data: encodeUtf8(serializedPart),
 		options: {
 			compression: "DEFLATE",
 			compressionOptions
@@ -1886,14 +1886,14 @@ async function serializeHeaderFooterSettingsIntoZip(doc, zip, compressionLevel)
 		});
 		return;
 	}
-	const xml = await file.async("text");
+	const xml = await file.async("uint8array").then((bytes) => decodeText(bytes, { ignoreBOM: true }));
 	if (parseSettings(xml).evenAndOddHeaders === enabled) return;
 	const patched = updateEvenAndOddHeaders(xml, enabled);
 	if (patched === null) throw new DocxPackageFidelityError("Cannot update malformed header/footer settings");
 	writeZipPart({
 		zip,
 		path: file.name,
-		data: patched,
+		data: encodeUtf8(patched),
 		options: {
 			compression: "DEFLATE",
 			compressionOptions: { level: compressionLevel }
@@ -1918,7 +1918,7 @@ async function serializeNumberingIntoZip(doc, originalZip, newZip, compressionLe
 	}
 	let baseline = doc.originalBuffer ? numberingBaselines.get(doc) : void 0;
 	if (!baseline || baseline.originalBuffer !== doc.originalBuffer) {
-		const originalXml = await file.async("text");
+		const originalXml = await file.async("uint8array").then((bytes) => decodeText(bytes, { ignoreBOM: true }));
 		baseline = {
 			originalBuffer: doc.originalBuffer,
 			originalXml,
@@ -1936,7 +1936,7 @@ async function serializeNumberingIntoZip(doc, originalZip, newZip, compressionLe
 	writeZipPart({
 		zip: newZip,
 		path: file.name,
-		data: patched,
+		data: encodeUtf8(patched),
 		options: {
 			compression: "DEFLATE",
 			compressionOptions: { level: compressionLevel }
@@ -2053,7 +2053,7 @@ async function planAddedStyles(doc, originalZip) {
 	const styles = doc.package.styles;
 	if (!styles || styles.styles.length === 0) return { type: "unchanged" };
 	const file = findNotePartEntry(originalZip, STYLES_PART_PATH);
-	const originalXml = file ? await file.async("text") : null;
+	const originalXml = file ? await file.async("uint8array").then((bytes) => decodeText(bytes, { ignoreBOM: true })) : null;
 	const rootName = originalXml === null ? void 0 : /<(?![?!])(?<name>[^\s/>]+)/u.exec(originalXml)?.groups?.["name"];
 	const rootClose = originalXml !== null && rootName !== void 0 && getLocalName(rootName) === "styles" ? originalXml.lastIndexOf(`</${rootName}>`) : -1;
 	if (file === null || originalXml === null || rootClose < 0) return {
@@ -2094,7 +2094,7 @@ async function serializeAddedStylesIntoZip(doc, originalZip, newZip, compression
 			writeZipPart({
 				zip: newZip,
 				path: plan.path,
-				data: plan.xml,
+				data: encodeUtf8(plan.xml),
 				options: {
 					compression: "DEFLATE",
 					compressionOptions: { level: compressionLevel }
@@ -2137,7 +2137,7 @@ const notePartXmlFor = ({ patch, originalXml, replacementXml, hasDirtyParagraph,
 async function patchNotePartIntoZip({ conventionalLowerPath, currentXml, replacementXml, baselineFrom, elementName, changedNoteParaIds, originalZip, newZip, compressionLevel }) {
 	const file = findNotePartEntry(originalZip, conventionalLowerPath);
 	if (!file) return;
-	const originalXml = await file.async("text");
+	const originalXml = await file.async("uint8array").then((bytes) => decodeText(bytes, { ignoreBOM: true }));
 	const baselineXml = baselineFrom(originalXml);
 	const effectiveChangedNoteParaIds = changedNoteParaIds ?? collectChangedNoteParaIds(baselineXml, currentXml);
 	const currentParaIds = collectParaIds(currentXml);
@@ -2160,7 +2160,7 @@ async function patchNotePartIntoZip({ conventionalLowerPath, currentXml, replace
 	writeZipPart({
 		zip: newZip,
 		path: file.name,
-		data: patchedXml,
+		data: encodeUtf8(patchedXml),
 		options: {
 			compression: "DEFLATE",
 			compressionOptions: { level: compressionLevel }
@@ -2265,7 +2265,7 @@ const createEmptyDocxZip = ({ creator, application }) => {
 	writeZipPart({
 		zip,
 		path: "[Content_Types].xml",
-		data: `<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
+		data: encodeUtf8(`<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
 <Types xmlns="http://schemas.openxmlformats.org/package/2006/content-types">
   <Default Extension="rels" ContentType="application/vnd.openxmlformats-package.relationships+xml"/>
   <Default Extension="xml" ContentType="application/xml"/>
@@ -2273,30 +2273,30 @@ const createEmptyDocxZip = ({ creator, application }) => {
   <Override PartName="/word/styles.xml" ContentType="application/vnd.openxmlformats-officedocument.wordprocessingml.styles+xml"/>
   <Override PartName="/docProps/core.xml" ContentType="application/vnd.openxmlformats-package.core-properties+xml"/>
   <Override PartName="/docProps/app.xml" ContentType="application/vnd.openxmlformats-officedocument.extended-properties+xml"/>
-</Types>`
+</Types>`)
 	});
 	writeZipPart({
 		zip,
 		path: "_rels/.rels",
-		data: `<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
+		data: encodeUtf8(`<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
 <Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships">
   <Relationship Id="rId1" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/officeDocument" Target="word/document.xml"/>
   <Relationship Id="rId2" Type="http://schemas.openxmlformats.org/package/2006/relationships/metadata/core-properties" Target="docProps/core.xml"/>
   <Relationship Id="rId3" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/extended-properties" Target="docProps/app.xml"/>
-</Relationships>`
+</Relationships>`)
 	});
 	writeZipPart({
 		zip,
 		path: "word/_rels/document.xml.rels",
-		data: `<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
+		data: encodeUtf8(`<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
 <Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships">
   <Relationship Id="rId1" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/styles" Target="styles.xml"/>
-</Relationships>`
+</Relationships>`)
 	});
 	writeZipPart({
 		zip,
 		path: "word/document.xml",
-		data: `<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
+		data: encodeUtf8(`<?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>
     <w:p>
@@ -2309,29 +2309,29 @@ const createEmptyDocxZip = ({ creator, application }) => {
       <w:pgMar w:top="1440" w:right="1440" w:bottom="1440" w:left="1440" w:header="720" w:footer="720" w:gutter="0"/>
     </w:sectPr>
   </w:body>
-</w:document>`
+</w:document>`)
 	});
 	writeZipPart({
 		zip,
 		path: STYLES_PART_PATH,
-		data: SEED_STYLES_XML
+		data: encodeUtf8(SEED_STYLES_XML)
 	});
 	const now = (/* @__PURE__ */ new Date()).toISOString();
 	writeZipPart({
 		zip,
 		path: "docProps/core.xml",
-		data: `<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
+		data: encodeUtf8(`<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
 <cp:coreProperties xmlns:cp="http://schemas.openxmlformats.org/package/2006/metadata/core-properties" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:dcterms="http://purl.org/dc/terms/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">${creator === void 0 ? "" : `\n  <dc:creator>${escapeXmlText(creator)}</dc:creator>`}
   <dcterms:created xsi:type="dcterms:W3CDTF">${now}</dcterms:created>
   <dcterms:modified xsi:type="dcterms:W3CDTF">${now}</dcterms:modified>
-</cp:coreProperties>`
+</cp:coreProperties>`)
 	});
 	writeZipPart({
 		zip,
 		path: "docProps/app.xml",
-		data: `<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
+		data: encodeUtf8(`<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
 <Properties xmlns="http://schemas.openxmlformats.org/officeDocument/2006/extended-properties">${application === void 0 ? "" : `\n  <Application>${escapeXmlText(application)}</Application>\n  <AppVersion>${CREATED_APP_VERSION}</AppVersion>`}
-</Properties>`
+</Properties>`)
 	});
 	return zip;
 };
@@ -2364,7 +2364,7 @@ async function createDocx(doc, properties = {}) {
 		originalZip: zip,
 		outputZip: zip,
 		originalDocument: void 0,
-		originalCorePropertiesXml: await zip.file("docProps/core.xml")?.async("text"),
+		originalCorePropertiesXml: await zip.file("docProps/core.xml")?.async("uint8array").then((bytes) => decodeText(bytes, { ignoreBOM: true })),
 		compressionLevel: 6,
 		updateModifiedDate: true,
 		onDiagnostic: properties.onDiagnostic,
@@ -2382,19 +2382,19 @@ const createDocumentSeedZip = async (doc, properties) => {
 		writeZipPart({
 			zip,
 			path: STYLES_PART_PATH,
-			data: serializeStylesXml(styleDefinitions)
+			data: encodeUtf8(serializeStylesXml(styleDefinitions))
 		});
 	} else writeZipPart({
 		zip,
 		path: STYLES_PART_PATH,
-		data: seedStylesXmlWith(missingNoteReferenceStyles(void 0, noteReferenceNeeds(doc.package)))
+		data: encodeUtf8(seedStylesXmlWith(missingNoteReferenceStyles(void 0, noteReferenceNeeds(doc.package))))
 	});
 	const numbering = doc.package.numbering;
 	if (numbering && (numbering.abstractNums.length > 0 || numbering.nums.length > 0)) {
 		writeZipPart({
 			zip,
 			path: "word/numbering.xml",
-			data: serializeNumberingXml(numbering)
+			data: encodeUtf8(serializeNumberingXml(numbering))
 		});
 		relationships.push(relationshipXml(nextRelationshipId, "numbering", "numbering.xml"));
 		overrides.push(overrideXml("/word/numbering.xml", "application/vnd.openxmlformats-officedocument.wordprocessingml.numbering+xml"));
@@ -2404,7 +2404,7 @@ const createDocumentSeedZip = async (doc, properties) => {
 		writeZipPart({
 			zip,
 			path: "word/theme/theme1.xml",
-			data: serializeThemeXml(doc.package.theme)
+			data: encodeUtf8(serializeThemeXml(doc.package.theme))
 		});
 		relationships.push(relationshipXml(nextRelationshipId, "theme", "theme/theme1.xml"));
 		overrides.push(overrideXml("/word/theme/theme1.xml", "application/vnd.openxmlformats-officedocument.theme+xml"));
@@ -2414,7 +2414,7 @@ const createDocumentSeedZip = async (doc, properties) => {
 		writeZipPart({
 			zip,
 			path: "word/fontTable.xml",
-			data: serializeFontTableXml(doc.package.fontTable)
+			data: encodeUtf8(serializeFontTableXml(doc.package.fontTable))
 		});
 		relationships.push(relationshipXml(nextRelationshipId, "fontTable", "fontTable.xml"));
 		overrides.push(overrideXml("/word/fontTable.xml", "application/vnd.openxmlformats-officedocument.wordprocessingml.fontTable+xml"));
@@ -2424,7 +2424,7 @@ const createDocumentSeedZip = async (doc, properties) => {
 		writeZipPart({
 			zip,
 			path: "word/settings.xml",
-			data: serializeSettingsXml(doc.package.settings)
+			data: encodeUtf8(serializeSettingsXml(doc.package.settings))
 		});
 		relationships.push(relationshipXml(nextRelationshipId, "settings", "settings.xml"));
 		overrides.push(overrideXml("/word/settings.xml", "application/vnd.openxmlformats-officedocument.wordprocessingml.settings+xml"));
@@ -2432,7 +2432,7 @@ const createDocumentSeedZip = async (doc, properties) => {
 	writeZipPart({
 		zip,
 		path: "word/_rels/document.xml.rels",
-		data: `<?xml version="1.0" encoding="UTF-8" standalone="yes"?>\n<Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships">${relationships.join("")}</Relationships>`
+		data: encodeUtf8(`<?xml version="1.0" encoding="UTF-8" standalone="yes"?>\n<Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships">${relationships.join("")}</Relationships>`)
 	});
 	if (overrides.length > 0) {
 		const contentTypesFile = zip.file("[Content_Types].xml");
@@ -2440,7 +2440,7 @@ const createDocumentSeedZip = async (doc, properties) => {
 		writeZipPart({
 			zip,
 			path: "[Content_Types].xml",
-			data: (await contentTypesFile.async("string")).replace("</Types>", `${overrides.join("")}\n</Types>`)
+			data: encodeUtf8((await contentTypesFile.async("uint8array").then((bytes) => decodeText(bytes, { ignoreBOM: true }))).replace("</Types>", `${overrides.join("")}\n</Types>`))
 		});
 	}
 	return zip;