js.documents 1.62.0 → 1.63.0

package/dist/convert/convert.js

@@ -7,6 +7,7 @@ import { buildOdtPackage } from "../edit/odt/content.js";
 import { buildOdpPackage } from "../edit/odp/content.js";
 import { buildOdsPackage } from "../edit/ods/content.js";
 import { buildOdgPackage } from "../edit/odg/content.js";
+import { createDocumentFontRegistry, extractSourceFonts } from "../fonts/registry.js";
 import { layoutFormula } from "../mathml/layout.js";
 import { readDocxContent } from "../ooxml/docx/read.js";
 import { readPptxContent } from "../ooxml/pptx/read.js";
@@ -30,13 +31,17 @@ import { odbTablesToSpreadsheetDocument } from "../odb/spreadsheet.js";
 import { buildXlsxPackage, decodePackage, encodePackage, readXlsxContent } from "ooxml.js";
 import { COLOR_BLACK, CONTENT_FORMAT_VERSION, DOCUMENT_PACKAGE_FORMAT_VERSION, LAYOUT_FORMAT_VERSION } from "document-schema.js";
 import { decodePackage as decodePackage$1, encodePackage as encodePackage$1, readOdfMetadata, readOdfParagraph, readOdfTable, readOdm } from "odf.js";
-import { createStandardFontMeasurer, loadMathFont, readPdf, writePdf } from "pdf-codec";
+import { createFontMeasurer, createFontRegistry, loadMathFont, readPdf, writePdf } from "pdf-codec";
 //#region src/convert/convert.ts
 function docxToPdf(bytes, options) {
 	const pkg = openDocx(bytes).toPackage();
 	const content = readDocxContent(pkg);
 	if (content.kind !== "wordprocessing") throw new Error("readDocxContent returned a non-wordprocessing ContentDocument");
-	const { document: layout, formulas } = convertWordprocessingToLayout(content, { measurer: createStandardFontMeasurer() });
+	const fonts = createDocumentFontRegistry({
+		kind: "docx",
+		package: pkg
+	}, options);
+	const { document: layout, formulas } = convertWordprocessingToLayout(content, { measurer: createFontMeasurer(fonts) });
 	options?.onDocument?.({
 		formatVersion: DOCUMENT_PACKAGE_FORMAT_VERSION,
 		content,
@@ -45,14 +50,19 @@ function docxToPdf(bytes, options) {
 	return writePdf(layout, {
 		signal: options?.signal,
 		onSubstitution: options?.onSubstitution,
-		formulas
+		formulas,
+		fonts
 	});
 }
 function odtToPdf(bytes, options) {
 	const pkg = decodePackage$1(bytes);
 	const content = readOdtContent(pkg);
 	if (content.kind !== "wordprocessing") throw new Error("readOdtContent returned a non-wordprocessing ContentDocument");
-	const { document: layout, formulas } = convertWordprocessingToLayout(content, { measurer: createStandardFontMeasurer() });
+	const fonts = createDocumentFontRegistry({
+		kind: "odf",
+		package: pkg
+	}, options);
+	const { document: layout, formulas } = convertWordprocessingToLayout(content, { measurer: createFontMeasurer(fonts) });
 	options?.onDocument?.({
 		formatVersion: DOCUMENT_PACKAGE_FORMAT_VERSION,
 		content,
@@ -61,14 +71,19 @@ function odtToPdf(bytes, options) {
 	return writePdf(layout, {
 		signal: options?.signal,
 		onSubstitution: options?.onSubstitution,
-		formulas
+		formulas,
+		fonts
 	});
 }
 function pptxToPdf(bytes, options) {
 	const pkg = openPptx(bytes).toPackage();
 	const content = readPptxContent(pkg);
 	if (content.kind !== "presentation") throw new Error("readPptxContent returned a non-presentation ContentDocument");
-	const { document: layout, formulas } = convertPresentationToLayout(content, { measurer: createStandardFontMeasurer() });
+	const fonts = createDocumentFontRegistry({
+		kind: "pptx",
+		package: pkg
+	}, options);
+	const { document: layout, formulas } = convertPresentationToLayout(content, { measurer: createFontMeasurer(fonts) });
 	options?.onDocument?.({
 		formatVersion: DOCUMENT_PACKAGE_FORMAT_VERSION,
 		content,
@@ -77,14 +92,19 @@ function pptxToPdf(bytes, options) {
 	return writePdf(layout, {
 		signal: options?.signal,
 		onSubstitution: options?.onSubstitution,
-		formulas
+		formulas,
+		fonts
 	});
 }
 function odpToPdf(bytes, options) {
 	const pkg = decodePackage$1(bytes);
 	const content = readOdpContent(pkg);
 	if (content.kind !== "presentation") throw new Error("readOdpContent returned a non-presentation ContentDocument");
-	const { document: layout, formulas } = convertPresentationToLayout(content, { measurer: createStandardFontMeasurer() });
+	const fonts = createDocumentFontRegistry({
+		kind: "odf",
+		package: pkg
+	}, options);
+	const { document: layout, formulas } = convertPresentationToLayout(content, { measurer: createFontMeasurer(fonts) });
 	options?.onDocument?.({
 		formatVersion: DOCUMENT_PACKAGE_FORMAT_VERSION,
 		content,
@@ -93,15 +113,20 @@ function odpToPdf(bytes, options) {
 	return writePdf(layout, {
 		signal: options?.signal,
 		onSubstitution: options?.onSubstitution,
-		formulas
+		formulas,
+		fonts
 	});
 }
 function odsToPdf(bytes, options) {
 	const pkg = decodePackage$1(bytes);
 	const content = readOdsContent(pkg);
 	if (content.kind !== "spreadsheet") throw new Error("readOdsContent returned a non-spreadsheet ContentDocument");
+	const fonts = createDocumentFontRegistry({
+		kind: "odf",
+		package: pkg
+	}, options);
 	const layout = convertSpreadsheetToLayout(content, {
-		measurer: createStandardFontMeasurer(),
+		measurer: createFontMeasurer(fonts),
 		signal: options?.signal
 	});
 	options?.onDocument?.({
@@ -111,14 +136,19 @@ function odsToPdf(bytes, options) {
 	});
 	return writePdf(layout, {
 		signal: options?.signal,
-		onSubstitution: options?.onSubstitution
+		onSubstitution: options?.onSubstitution,
+		fonts
 	});
 }
 function odgToPdf(bytes, options) {
 	const pkg = decodePackage$1(bytes);
 	const content = readOdgContent(pkg);
 	if (content.kind !== "drawing") throw new Error("readOdgContent returned a non-drawing ContentDocument");
-	const layout = convertDrawingToLayout(content, { measurer: createStandardFontMeasurer() });
+	const fonts = createDocumentFontRegistry({
+		kind: "odf",
+		package: pkg
+	}, options);
+	const layout = convertDrawingToLayout(content, { measurer: createFontMeasurer(fonts) });
 	options?.onDocument?.({
 		formatVersion: DOCUMENT_PACKAGE_FORMAT_VERSION,
 		content,
@@ -126,7 +156,8 @@ function odgToPdf(bytes, options) {
 	});
 	return writePdf(layout, {
 		signal: options?.signal,
-		onSubstitution: options?.onSubstitution
+		onSubstitution: options?.onSubstitution,
+		fonts
 	});
 }
 function markdownToPdf(bytes, options) {
@@ -134,7 +165,11 @@ function markdownToPdf(bytes, options) {
 	const text = decodeMarkdownText(bytes);
 	const content = readMarkdownContent(text, { signal: options?.signal });
 	if (content.kind !== "wordprocessing") throw new Error("readMarkdownContent returned a non-wordprocessing ContentDocument");
-	const { document: layout, formulas } = convertWordprocessingToLayout(content, { measurer: createStandardFontMeasurer() });
+	const fonts = createFontRegistry({
+		fonts: options?.fonts,
+		onSubstitution: options?.onFontSubstitution
+	});
+	const { document: layout, formulas } = convertWordprocessingToLayout(content, { measurer: createFontMeasurer(fonts) });
 	options?.onDocument?.({
 		formatVersion: DOCUMENT_PACKAGE_FORMAT_VERSION,
 		content,
@@ -143,7 +178,8 @@ function markdownToPdf(bytes, options) {
 	return writePdf(layout, {
 		signal: options?.signal,
 		onSubstitution: options?.onSubstitution,
-		formulas
+		formulas,
+		fonts
 	});
 }
 const STANDALONE_FORMULA_SIZE_PT = 18;
@@ -412,7 +448,9 @@ function xlsxToPdf(bytes, options) {
 	return odsToPdf(odsBytes, {
 		signal: options?.signal,
 		onSubstitution: options?.onSubstitution,
-		onDocument: options?.onDocument
+		onDocument: options?.onDocument,
+		fonts: options?.fonts,
+		onFontSubstitution: options?.onFontSubstitution
 	});
 }
 function pdfToXlsx(bytes, options) {
@@ -468,6 +506,10 @@ function odmToPdf(bytes, options) {
 	const odm = readOdm(pkg);
 	const unresolvedHrefs = [];
 	const chapterSections = [];
+	const sourceFonts = extractSourceFonts({
+		kind: "odf",
+		package: pkg
+	});
 	for (const section of odm.sections) {
 		throwIfAborted(options?.signal);
 		if (section.inlineContent !== void 0) {
@@ -480,6 +522,10 @@ function odmToPdf(bytes, options) {
 			continue;
 		}
 		const chapterPkg = decodePackage$1(chapterBytes);
+		sourceFonts.push(...extractSourceFonts({
+			kind: "odf",
+			package: chapterPkg
+		}));
 		const chapterContent = readOdtContent(chapterPkg);
 		if (chapterContent.kind !== "wordprocessing") throw new Error("readOdtContent returned a non-wordprocessing ContentDocument");
 		chapterSections.push(chapterContent.sections);
@@ -500,11 +546,17 @@ function odmToPdf(bytes, options) {
 		metadata: readOdfMetadata(pkg),
 		sections: combinedSections
 	};
-	const { document: layout, formulas } = convertWordprocessingToLayout(content, { measurer: createStandardFontMeasurer() });
+	const fonts = createFontRegistry({
+		sourceFonts,
+		fonts: options?.fonts,
+		onSubstitution: options?.onFontSubstitution
+	});
+	const { document: layout, formulas } = convertWordprocessingToLayout(content, { measurer: createFontMeasurer(fonts) });
 	return writePdf(layout, {
 		signal: options?.signal,
 		onSubstitution: options?.onSubstitution,
-		formulas
+		formulas,
+		fonts
 	});
 }
 function odbToXlsx(bytes, options) {

package/dist/convert/local.cjs

@@ -13,6 +13,13 @@ function substitutionDiagnostic(substitution, context) {
 		pageIndex: context.pageIndex
 	};
 }
+function fontSubstitutionDiagnostic(substitution) {
+	return {
+		severity: "info",
+		code: "font/substituted",
+		message: `"${`${substitution.requestedFamily}${substitution.requestedBold ? " bold" : ""}${substitution.requestedItalic ? " italic" : ""}`}" is not available; ${substitution.reason === "vendored-substitute" ? `substituted the metric-compatible "${substitution.resolvedFamily}"` : `substituted another face of "${substitution.resolvedFamily}"`}`
+	};
+}
 function fromPdfDiagnostic(diagnostic) {
 	return {
 		severity: diagnostic.severity,
@@ -23,7 +30,7 @@ function fromPdfDiagnostic(diagnostic) {
 }
 function createLocalDocumentConverter() {
 	return {
-		contractVersion: 2,
+		contractVersion: 3,
 		conversions: SUPPORTED_CONVERSIONS,
 		convert(request, options) {
 			const { source, targetFormat } = request;
@@ -32,6 +39,10 @@ function createLocalDocumentConverter() {
 			const onDocument = (pkg) => {
 				documentPackage = pkg;
 			};
+			const onFontSubstitution = (substitution) => {
+				diagnostics.push(fontSubstitutionDiagnostic(substitution));
+				options.onFontSubstitution?.(substitution);
+			};
 			const strategy = require_convert_capability.resolveConversionPath(source.format, targetFormat);
 			if (strategy?.kind !== "direct") return Promise.reject(/* @__PURE__ */ new Error(`unsupported conversion: ${source.format} -> ${targetFormat}`));
 			const edge = strategy.edge;
@@ -39,7 +50,9 @@ function createLocalDocumentConverter() {
 				const bytes = edge.convert(source.bytes, {
 					signal: options.signal,
 					onSubstitution: (s, c) => diagnostics.push(substitutionDiagnostic(s, c)),
-					onDocument
+					onDocument,
+					fonts: options.fonts,
+					onFontSubstitution
 				});
 				return Promise.resolve({
 					document: {

package/dist/convert/local.js

@@ -12,6 +12,13 @@ function substitutionDiagnostic(substitution, context) {
 		pageIndex: context.pageIndex
 	};
 }
+function fontSubstitutionDiagnostic(substitution) {
+	return {
+		severity: "info",
+		code: "font/substituted",
+		message: `"${`${substitution.requestedFamily}${substitution.requestedBold ? " bold" : ""}${substitution.requestedItalic ? " italic" : ""}`}" is not available; ${substitution.reason === "vendored-substitute" ? `substituted the metric-compatible "${substitution.resolvedFamily}"` : `substituted another face of "${substitution.resolvedFamily}"`}`
+	};
+}
 function fromPdfDiagnostic(diagnostic) {
 	return {
 		severity: diagnostic.severity,
@@ -22,7 +29,7 @@ function fromPdfDiagnostic(diagnostic) {
 }
 function createLocalDocumentConverter() {
 	return {
-		contractVersion: 2,
+		contractVersion: 3,
 		conversions: SUPPORTED_CONVERSIONS,
 		convert(request, options) {
 			const { source, targetFormat } = request;
@@ -31,6 +38,10 @@ function createLocalDocumentConverter() {
 			const onDocument = (pkg) => {
 				documentPackage = pkg;
 			};
+			const onFontSubstitution = (substitution) => {
+				diagnostics.push(fontSubstitutionDiagnostic(substitution));
+				options.onFontSubstitution?.(substitution);
+			};
 			const strategy = resolveConversionPath(source.format, targetFormat);
 			if (strategy?.kind !== "direct") return Promise.reject(/* @__PURE__ */ new Error(`unsupported conversion: ${source.format} -> ${targetFormat}`));
 			const edge = strategy.edge;
@@ -38,7 +49,9 @@ function createLocalDocumentConverter() {
 				const bytes = edge.convert(source.bytes, {
 					signal: options.signal,
 					onSubstitution: (s, c) => diagnostics.push(substitutionDiagnostic(s, c)),
-					onDocument
+					onDocument,
+					fonts: options.fonts,
+					onFontSubstitution
 				});
 				return Promise.resolve({
 					document: {

package/dist/convert/port.d.cts

@@ -1,4 +1,5 @@
 import { DocumentPackage } from "document-schema.js";
+import { FontSubstitution, ProvidedFont } from "pdf-codec";
 //#region src/convert/port.d.ts
 type DocumentFormat = 'docx' | 'pptx' | 'xlsx' | 'odt' | 'odp' | 'ods' | 'odg' | 'odf' | 'markdown' | 'pdf';
 interface DocumentPayload {
@@ -20,15 +21,18 @@ interface ConversionResult {
   readonly diagnostics: readonly Diagnostic[];
   readonly package?: DocumentPackage;
 }
+interface ConversionOptions {
+  readonly signal: AbortSignal;
+  readonly fonts?: readonly ProvidedFont[];
+  readonly onFontSubstitution?: (substitution: FontSubstitution) => void;
+}
 interface DocumentConverter {
   readonly contractVersion: number;
   readonly conversions: readonly {
     readonly source: DocumentFormat;
     readonly target: DocumentFormat;
   }[];
-  convert(request: ConversionRequest, options: {
-    readonly signal: AbortSignal;
-  }): Promise<ConversionResult>;
+  convert(request: ConversionRequest, options: ConversionOptions): Promise<ConversionResult>;
 }
 //#endregion
-export { ConversionRequest, ConversionResult, Diagnostic, DocumentConverter, DocumentFormat, DocumentPayload };
+export { ConversionOptions, ConversionRequest, ConversionResult, Diagnostic, DocumentConverter, DocumentFormat, DocumentPayload };

package/dist/convert/port.d.ts

@@ -1,4 +1,5 @@
 import { DocumentPackage } from "document-schema.js";
+import { FontSubstitution, ProvidedFont } from "pdf-codec";
 //#region src/convert/port.d.ts
 type DocumentFormat = 'docx' | 'pptx' | 'xlsx' | 'odt' | 'odp' | 'ods' | 'odg' | 'odf' | 'markdown' | 'pdf';
 interface DocumentPayload {
@@ -20,15 +21,18 @@ interface ConversionResult {
   readonly diagnostics: readonly Diagnostic[];
   readonly package?: DocumentPackage;
 }
+interface ConversionOptions {
+  readonly signal: AbortSignal;
+  readonly fonts?: readonly ProvidedFont[];
+  readonly onFontSubstitution?: (substitution: FontSubstitution) => void;
+}
 interface DocumentConverter {
   readonly contractVersion: number;
   readonly conversions: readonly {
     readonly source: DocumentFormat;
     readonly target: DocumentFormat;
   }[];
-  convert(request: ConversionRequest, options: {
-    readonly signal: AbortSignal;
-  }): Promise<ConversionResult>;
+  convert(request: ConversionRequest, options: ConversionOptions): Promise<ConversionResult>;
 }
 //#endregion
-export { ConversionRequest, ConversionResult, Diagnostic, DocumentConverter, DocumentFormat, DocumentPayload };
+export { ConversionOptions, ConversionRequest, ConversionResult, Diagnostic, DocumentConverter, DocumentFormat, DocumentPayload };

package/dist/fonts/obfuscation.cjs

@@ -0,0 +1,50 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let pdf_codec_sfnt = require("pdf-codec/sfnt");
+//#region src/fonts/obfuscation.ts
+const FONT_KEY_HEX_LENGTH = 32;
+const FONT_KEY_BYTE_LENGTH = 16;
+const OBFUSCATED_PREFIX_LENGTH = 32;
+const SFNT_HEADER_LENGTH = 12;
+const HEX_PAIR_PATTERN = /^[0-9A-Fa-f]{2}$/;
+var FontDeobfuscationError = class extends Error {
+	constructor(detail) {
+		super(`deobfuscateEmbeddedFont: ${detail}`);
+		this.name = "FontDeobfuscationError";
+	}
+};
+function deriveFontKey(fontKey) {
+	const hex = fontKey.replace(/[{}-]/g, "");
+	if (hex.length !== FONT_KEY_HEX_LENGTH) throw new FontDeobfuscationError(`w:fontKey ${JSON.stringify(fontKey)} has ${String(hex.length)} hex digit(s) after stripping braces and hyphens, expected ${String(FONT_KEY_HEX_LENGTH)}`);
+	const key = new Uint8Array(FONT_KEY_BYTE_LENGTH);
+	for (let i = 0; i < FONT_KEY_BYTE_LENGTH; i++) {
+		const start = 30 - i * 2;
+		const pair = hex.slice(start, start + 2);
+		if (!HEX_PAIR_PATTERN.test(pair)) throw new FontDeobfuscationError(`w:fontKey ${JSON.stringify(fontKey)} contains the non-hexadecimal pair ${JSON.stringify(pair)}`);
+		key[i] = Number.parseInt(pair, 16);
+	}
+	return key;
+}
+function looksLikeSfnt(bytes) {
+	return bytes.length >= SFNT_HEADER_LENGTH && (0, pdf_codec_sfnt.parseSfnt)(bytes) !== void 0;
+}
+function deobfuscateEmbeddedFont(bytes, fontKey) {
+	if (looksLikeSfnt(bytes)) return bytes;
+	if (fontKey === void 0) throw new FontDeobfuscationError("the part does not begin with an sfnt signature and carries no font key to deobfuscate it with");
+	if (bytes.length < OBFUSCATED_PREFIX_LENGTH) throw new FontDeobfuscationError(`an obfuscated part must be at least ${String(OBFUSCATED_PREFIX_LENGTH)} bytes long, got ${String(bytes.length)}`);
+	const key = deriveFontKey(fontKey);
+	const clear = new Uint8Array(bytes.length);
+	clear.set(bytes);
+	for (let i = 0; i < OBFUSCATED_PREFIX_LENGTH; i++) {
+		const keyByte = key[i % FONT_KEY_BYTE_LENGTH];
+		const cipherByte = clear[i];
+		if (keyByte === void 0 || cipherByte === void 0) throw new FontDeobfuscationError(`byte ${String(i)} of the obfuscated prefix is out of range`);
+		clear[i] = cipherByte ^ keyByte;
+	}
+	if (!looksLikeSfnt(clear)) throw new FontDeobfuscationError(`deobfuscating with font key ${JSON.stringify(fontKey)} did not produce a recognisable sfnt font`);
+	return clear;
+}
+//#endregion
+exports.FontDeobfuscationError = FontDeobfuscationError;
+exports.deobfuscateEmbeddedFont = deobfuscateEmbeddedFont;
+exports.deriveFontKey = deriveFontKey;
+exports.looksLikeSfnt = looksLikeSfnt;

package/dist/fonts/obfuscation.d.cts

@@ -0,0 +1,9 @@
+//#region src/fonts/obfuscation.d.ts
+declare class FontDeobfuscationError extends Error {
+  constructor(detail: string);
+}
+declare function deriveFontKey(fontKey: string): Uint8Array<ArrayBuffer>;
+declare function looksLikeSfnt(bytes: Uint8Array<ArrayBuffer>): boolean;
+declare function deobfuscateEmbeddedFont(bytes: Uint8Array<ArrayBuffer>, fontKey: string | undefined): Uint8Array<ArrayBuffer>;
+//#endregion
+export { FontDeobfuscationError, deobfuscateEmbeddedFont, deriveFontKey, looksLikeSfnt };

package/dist/fonts/obfuscation.d.ts

@@ -0,0 +1,9 @@
+//#region src/fonts/obfuscation.d.ts
+declare class FontDeobfuscationError extends Error {
+  constructor(detail: string);
+}
+declare function deriveFontKey(fontKey: string): Uint8Array<ArrayBuffer>;
+declare function looksLikeSfnt(bytes: Uint8Array<ArrayBuffer>): boolean;
+declare function deobfuscateEmbeddedFont(bytes: Uint8Array<ArrayBuffer>, fontKey: string | undefined): Uint8Array<ArrayBuffer>;
+//#endregion
+export { FontDeobfuscationError, deobfuscateEmbeddedFont, deriveFontKey, looksLikeSfnt };

package/dist/fonts/obfuscation.js

@@ -0,0 +1,46 @@
+import { parseSfnt } from "pdf-codec/sfnt";
+//#region src/fonts/obfuscation.ts
+const FONT_KEY_HEX_LENGTH = 32;
+const FONT_KEY_BYTE_LENGTH = 16;
+const OBFUSCATED_PREFIX_LENGTH = 32;
+const SFNT_HEADER_LENGTH = 12;
+const HEX_PAIR_PATTERN = /^[0-9A-Fa-f]{2}$/;
+var FontDeobfuscationError = class extends Error {
+	constructor(detail) {
+		super(`deobfuscateEmbeddedFont: ${detail}`);
+		this.name = "FontDeobfuscationError";
+	}
+};
+function deriveFontKey(fontKey) {
+	const hex = fontKey.replace(/[{}-]/g, "");
+	if (hex.length !== FONT_KEY_HEX_LENGTH) throw new FontDeobfuscationError(`w:fontKey ${JSON.stringify(fontKey)} has ${String(hex.length)} hex digit(s) after stripping braces and hyphens, expected ${String(FONT_KEY_HEX_LENGTH)}`);
+	const key = new Uint8Array(FONT_KEY_BYTE_LENGTH);
+	for (let i = 0; i < FONT_KEY_BYTE_LENGTH; i++) {
+		const start = 30 - i * 2;
+		const pair = hex.slice(start, start + 2);
+		if (!HEX_PAIR_PATTERN.test(pair)) throw new FontDeobfuscationError(`w:fontKey ${JSON.stringify(fontKey)} contains the non-hexadecimal pair ${JSON.stringify(pair)}`);
+		key[i] = Number.parseInt(pair, 16);
+	}
+	return key;
+}
+function looksLikeSfnt(bytes) {
+	return bytes.length >= SFNT_HEADER_LENGTH && parseSfnt(bytes) !== void 0;
+}
+function deobfuscateEmbeddedFont(bytes, fontKey) {
+	if (looksLikeSfnt(bytes)) return bytes;
+	if (fontKey === void 0) throw new FontDeobfuscationError("the part does not begin with an sfnt signature and carries no font key to deobfuscate it with");
+	if (bytes.length < OBFUSCATED_PREFIX_LENGTH) throw new FontDeobfuscationError(`an obfuscated part must be at least ${String(OBFUSCATED_PREFIX_LENGTH)} bytes long, got ${String(bytes.length)}`);
+	const key = deriveFontKey(fontKey);
+	const clear = new Uint8Array(bytes.length);
+	clear.set(bytes);
+	for (let i = 0; i < OBFUSCATED_PREFIX_LENGTH; i++) {
+		const keyByte = key[i % FONT_KEY_BYTE_LENGTH];
+		const cipherByte = clear[i];
+		if (keyByte === void 0 || cipherByte === void 0) throw new FontDeobfuscationError(`byte ${String(i)} of the obfuscated prefix is out of range`);
+		clear[i] = cipherByte ^ keyByte;
+	}
+	if (!looksLikeSfnt(clear)) throw new FontDeobfuscationError(`deobfuscating with font key ${JSON.stringify(fontKey)} did not produce a recognisable sfnt font`);
+	return clear;
+}
+//#endregion
+export { FontDeobfuscationError, deobfuscateEmbeddedFont, deriveFontKey, looksLikeSfnt };

package/dist/fonts/odf.cjs

@@ -0,0 +1,86 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_fonts_obfuscation = require("./obfuscation.cjs");
+let odf_js = require("odf.js");
+let pdf_codec_sfnt = require("pdf-codec/sfnt");
+let pdf_codec_font_tables = require("pdf-codec/font-tables");
+//#region src/fonts/odf.ts
+const FONT_FACE_DECL_PARTS = ["content.xml", "styles.xml"];
+const FS_SELECTION_ITALIC = 1;
+const FS_SELECTION_BOLD = 32;
+const BOLD_WEIGHT_THRESHOLD = 600;
+var OdfEmbeddedFontError = class extends Error {
+	constructor(detail) {
+		super(`extractOdfEmbeddedFonts: ${detail}`);
+		this.name = "OdfEmbeddedFontError";
+	}
+};
+function normaliseFamily(value) {
+	const first = (0, odf_js.decodeXmlText)(value).split(",")[0]?.trim() ?? "";
+	const quoted = /^'(.*)'$|^"(.*)"$/.exec(first);
+	return (quoted?.[1] ?? quoted?.[2] ?? first).trim();
+}
+function boldFromWeightAttribute(weight) {
+	const keyword = weight.trim().toLowerCase();
+	if (keyword === "bold" || keyword === "bolder") return true;
+	if (keyword === "normal" || keyword === "lighter") return false;
+	const numeric = Number.parseInt(keyword, 10);
+	return Number.isNaN(numeric) ? void 0 : numeric >= BOLD_WEIGHT_THRESHOLD;
+}
+function italicFromStyleAttribute(style) {
+	const keyword = style.trim().toLowerCase();
+	if (keyword === "italic" || keyword === "oblique") return true;
+	return keyword === "normal" ? false : void 0;
+}
+function styleFromFontBytes(bytes) {
+	const font = (0, pdf_codec_sfnt.parseSfnt)(bytes);
+	if (font === void 0) return;
+	const os2 = (0, pdf_codec_font_tables.parseOs2)(font);
+	if (os2 === void 0) return;
+	return {
+		bold: (os2.fsSelection & FS_SELECTION_BOLD) !== 0,
+		italic: (os2.fsSelection & FS_SELECTION_ITALIC) !== 0
+	};
+}
+function fontPartBytes(pkg, href) {
+	const part = pkg.parts[href];
+	if (part === void 0) throw new OdfEmbeddedFontError(`svg:font-face-uri references ${JSON.stringify(href)}, which is not a part of this package`);
+	if (part.kind !== "binary") throw new OdfEmbeddedFontError(`embedded font part ${JSON.stringify(href)} is an XML part, not binary font data`);
+	return (0, odf_js.base64ToBytes)(part.base64);
+}
+function collectFontFace(pkg, fontFace, seenHrefs, out) {
+	const declaredFamily = (0, odf_js.attrValue)(fontFace, "svg:font-family") ?? (0, odf_js.attrValue)(fontFace, "style:name");
+	for (const src of (0, odf_js.childrenWithTag)(fontFace, "svg:font-face-src")) for (const uri of (0, odf_js.childrenWithTag)(src, "svg:font-face-uri")) {
+		const rawHref = (0, odf_js.attrValue)(uri, "xlink:href");
+		if (rawHref === void 0) throw new OdfEmbeddedFontError("a <svg:font-face-uri> carries no xlink:href");
+		const href = (0, odf_js.decodeXmlText)(rawHref);
+		if (seenHrefs.has(href)) continue;
+		seenHrefs.add(href);
+		if (declaredFamily === void 0) throw new OdfEmbeddedFontError(`the <style:font-face> embedding ${JSON.stringify(href)} declares neither svg:font-family nor style:name`);
+		const bytes = fontPartBytes(pkg, href);
+		if (!require_fonts_obfuscation.looksLikeSfnt(bytes)) throw new OdfEmbeddedFontError(`embedded font part ${JSON.stringify(href)} does not begin with a recognisable sfnt signature`);
+		const declaredWeight = (0, odf_js.attrValue)(uri, "loext:font-weight");
+		const declaredStyle = (0, odf_js.attrValue)(uri, "loext:font-style");
+		const intrinsic = styleFromFontBytes(bytes);
+		out.push({
+			family: normaliseFamily(declaredFamily),
+			bold: (declaredWeight === void 0 ? void 0 : boldFromWeightAttribute(declaredWeight)) ?? intrinsic?.bold ?? false,
+			italic: (declaredStyle === void 0 ? void 0 : italicFromStyleAttribute(declaredStyle)) ?? intrinsic?.italic ?? false,
+			bytes
+		});
+	}
+}
+function extractOdfEmbeddedFonts(pkg) {
+	const out = [];
+	const seenHrefs = /* @__PURE__ */ new Set();
+	for (const partPath of FONT_FACE_DECL_PARTS) {
+		const part = pkg.parts[partPath];
+		if (part?.kind !== "xml") continue;
+		const root = (0, odf_js.rootElement)(part.nodes);
+		if (root === void 0) continue;
+		for (const decls of (0, odf_js.childrenWithTag)(root, "office:font-face-decls")) for (const fontFace of (0, odf_js.childrenWithTag)(decls, "style:font-face")) collectFontFace(pkg, fontFace, seenHrefs, out);
+	}
+	return out;
+}
+//#endregion
+exports.OdfEmbeddedFontError = OdfEmbeddedFontError;
+exports.extractOdfEmbeddedFonts = extractOdfEmbeddedFonts;

package/dist/fonts/odf.d.cts

@@ -0,0 +1,9 @@
+import { Package } from "odf.js";
+import { ProvidedFont } from "pdf-codec";
+//#region src/fonts/odf.d.ts
+declare class OdfEmbeddedFontError extends Error {
+  constructor(detail: string);
+}
+declare function extractOdfEmbeddedFonts(pkg: Package): ProvidedFont[];
+//#endregion
+export { OdfEmbeddedFontError, extractOdfEmbeddedFonts };

package/dist/fonts/odf.d.ts

@@ -0,0 +1,9 @@
+import { Package } from "odf.js";
+import { ProvidedFont } from "pdf-codec";
+//#region src/fonts/odf.d.ts
+declare class OdfEmbeddedFontError extends Error {
+  constructor(detail: string);
+}
+declare function extractOdfEmbeddedFonts(pkg: Package): ProvidedFont[];
+//#endregion
+export { OdfEmbeddedFontError, extractOdfEmbeddedFonts };