xls-codec 4.12.5 → 4.13.0

package/dist/workbook/globals.cjs

@@ -1,10 +1,11 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_biff_record_types = require("../biff/record-types.cjs");
 const require_biff_records = require("../biff/records.cjs");
-const require_biff_substreams = require("../biff/substreams.cjs");
-const require_biff_xf_colors = require("../biff/xf-colors.cjs");
 const require_biff_cursor = require("../biff/cursor.cjs");
 const require_biff_strings = require("../biff/strings.cjs");
+const require_biff_xf_colors = require("../biff/xf-colors.cjs");
+const require_biff_font = require("../biff/font.cjs");
+const require_biff_substreams = require("../biff/substreams.cjs");
 const require_workbook_print_names = require("./print-names.cjs");
 let excel_number_format = require("excel-number-format");
 //#region src/workbook/globals.ts
@@ -19,6 +20,7 @@ const MIN_SST_ENTRY_BYTES = 3;
 function readWorkbookGlobals(records) {
 	const sheets = [];
 	const cellFormats = [];
+	const fonts = [];
 	const customFormats = /* @__PURE__ */ new Map();
 	const supBooks = [];
 	let sharedStrings = [];
@@ -40,6 +42,9 @@ function readWorkbookGlobals(records) {
 		case 224:
 			cellFormats.push(readCellFormat(record));
 			break;
+		case 49:
+			fonts.push(require_biff_font.readFontRecord(record));
+			break;
 		case 34:
 			date1904 = readDate1904(record);
 			break;
@@ -58,6 +63,7 @@ function readWorkbookGlobals(records) {
 		sheets,
 		sharedStrings,
 		cellFormats,
+		fonts,
 		numberFormats,
 		date1904,
 		sheetRanges,

package/dist/workbook/globals.d.cts

@@ -1,5 +1,6 @@
-import { a as SheetRange, t as ExternalSheetLabel } from "../ptg-75v7MhaA.cjs";
 import { t as RecordGroup } from "../substreams-XDNgDvRJ.cjs";
+import { r as XfFontFields } from "../font-CBvAGxD8.cjs";
+import { a as SheetRange, t as ExternalSheetLabel } from "../ptg-75v7MhaA.cjs";
 import { E as XfDecorationFields, w as XfAlignmentFields } from "../xf-colors-aeH9Ax3Q.cjs";
 import { n as SheetPrintNames } from "../print-names-B2OR0fvs.cjs";
 import { Color } from "document-schema.js";
@@ -36,6 +37,10 @@ interface WorkbookGlobals {
   readonly sharedStrings: readonly string[];
   /** The XF table, indexed by a cell's own ixfe. */
   readonly cellFormats: readonly CellFormat[];
+  /**
+   * The font table, indexed by an XF record's own ifnt ([MS-XLS] 2.4.122). Entry 0 is the Normal style's font -- the workbook's own default, which content.ts diffs each cell's font against to decide which of its properties the cell genuinely states (a cell has no way to say "no font", only an index into this table, so entry 0 is what "the format's default" concretely means here).
+   */
+  readonly fonts: readonly XfFontFields[];
   /** Number-format codes by identifier: the file's own Format records laid over the built-in table. */
   readonly numberFormats: ReadonlyMap<number, string>;
   /** Whether serials count from the 1904 epoch rather than the 1900 one ([MS-XLS] 2.4.77). */

package/dist/workbook/globals.d.ts

@@ -1,5 +1,6 @@
-import { a as SheetRange, t as ExternalSheetLabel } from "../ptg-75v7MhaA.js";
 import { t as RecordGroup } from "../substreams-CgTHx5kX.js";
+import { r as XfFontFields } from "../font-DcXHYgZ2.js";
+import { a as SheetRange, t as ExternalSheetLabel } from "../ptg-75v7MhaA.js";
 import { E as XfDecorationFields, w as XfAlignmentFields } from "../xf-colors-kdNsiNYt.js";
 import { n as SheetPrintNames } from "../print-names-BXcmmwVi.js";
 import { Color } from "document-schema.js";
@@ -36,6 +37,10 @@ interface WorkbookGlobals {
   readonly sharedStrings: readonly string[];
   /** The XF table, indexed by a cell's own ixfe. */
   readonly cellFormats: readonly CellFormat[];
+  /**
+   * The font table, indexed by an XF record's own ifnt ([MS-XLS] 2.4.122). Entry 0 is the Normal style's font -- the workbook's own default, which content.ts diffs each cell's font against to decide which of its properties the cell genuinely states (a cell has no way to say "no font", only an index into this table, so entry 0 is what "the format's default" concretely means here).
+   */
+  readonly fonts: readonly XfFontFields[];
   /** Number-format codes by identifier: the file's own Format records laid over the built-in table. */
   readonly numberFormats: ReadonlyMap<number, string>;
   /** Whether serials count from the 1904 epoch rather than the 1900 one ([MS-XLS] 2.4.77). */

package/dist/workbook/globals.js

@@ -1,9 +1,10 @@
 import { RECORD_FORMAT } from "../biff/record-types.js";
 import { BiffFormatError } from "../biff/records.js";
-import { recordByteLength } from "../biff/substreams.js";
-import { readLongRgbColor, unpackXfAlignment, unpackXfDecoration } from "../biff/xf-colors.js";
 import { BlockCursor } from "../biff/cursor.js";
 import { readRichExtendedString, readShortXLUnicodeString, readXLUnicodeString, readXLUnicodeStringNoCch } from "../biff/strings.js";
+import { readLongRgbColor, unpackXfAlignment, unpackXfDecoration } from "../biff/xf-colors.js";
+import { readFontRecord } from "../biff/font.js";
+import { recordByteLength } from "../biff/substreams.js";
 import { readPrintNames } from "./print-names.js";
 import { BUILTIN_NUMBER_FORMATS } from "excel-number-format";
 //#region src/workbook/globals.ts
@@ -18,6 +19,7 @@ const MIN_SST_ENTRY_BYTES = 3;
 function readWorkbookGlobals(records) {
 	const sheets = [];
 	const cellFormats = [];
+	const fonts = [];
 	const customFormats = /* @__PURE__ */ new Map();
 	const supBooks = [];
 	let sharedStrings = [];
@@ -39,6 +41,9 @@ function readWorkbookGlobals(records) {
 		case 224:
 			cellFormats.push(readCellFormat(record));
 			break;
+		case 49:
+			fonts.push(readFontRecord(record));
+			break;
 		case 34:
 			date1904 = readDate1904(record);
 			break;
@@ -57,6 +62,7 @@ function readWorkbookGlobals(records) {
 		sheets,
 		sharedStrings,
 		cellFormats,
+		fonts,
 		numberFormats,
 		date1904,
 		sheetRanges,

package/dist/workbook/print-names.cjs

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 require("../biff/record-types.cjs");
-const require_biff_cursor = require("../biff/cursor.cjs");
 const require_biff_builder = require("../biff/builder.cjs");
+const require_biff_cursor = require("../biff/cursor.cjs");
 const require_biff_record_writer = require("../biff/record-writer.cjs");
 //#region src/workbook/print-names.ts
 /** The built-in name index a Print_Area Lbl carries in place of a name ([MS-XLS] 2.4.150's own built-in name table). */

package/dist/workbook/print-names.js

@@ -1,6 +1,6 @@
 import "../biff/record-types.js";
-import { BlockCursor } from "../biff/cursor.js";
 import { RecordBuilder } from "../biff/builder.js";
+import { BlockCursor } from "../biff/cursor.js";
 import { writeRecord } from "../biff/record-writer.js";
 //#region src/workbook/print-names.ts
 /** The built-in name index a Print_Area Lbl carries in place of a name ([MS-XLS] 2.4.150's own built-in name table). */

package/dist/workbook/sheet-writer.cjs

@@ -2,13 +2,13 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_biff_record_types = require("../biff/record-types.cjs");
 const require_units = require("../units.cjs");
 const require_biff_print_setup = require("../biff/print-setup.cjs");
-const require_biff_errors = require("../biff/errors.cjs");
-const require_biff_write_errors = require("../biff/write-errors.cjs");
-const require_serial = require("../serial.cjs");
 const require_biff_builder = require("../biff/builder.cjs");
+const require_biff_write_errors = require("../biff/write-errors.cjs");
 const require_biff_record_writer = require("../biff/record-writer.cjs");
-const require_biff_bof_writer = require("../biff/bof-writer.cjs");
+const require_biff_errors = require("../biff/errors.cjs");
 const require_biff_string_writer = require("../biff/string-writer.cjs");
+const require_serial = require("../serial.cjs");
+const require_biff_bof_writer = require("../biff/bof-writer.cjs");
 const require_workbook_globals_writer = require("./globals-writer.cjs");
 const require_biff_ptg_writer = require("../biff/ptg-writer.cjs");
 const require_written_cells = require("../written-cells.cjs");

package/dist/workbook/sheet-writer.js

@@ -1,13 +1,13 @@
 import { RECORD_BOF } from "../biff/record-types.js";
 import { pointsToColumnWidth, pointsToInches, pointsToTwips } from "../units.js";
 import { packSetupFlags, paperSelectionFor } from "../biff/print-setup.js";
-import { errorCodeOf } from "../biff/errors.js";
-import { BiffWriteError } from "../biff/write-errors.js";
-import { isoDateTimeToSerial, isoDateToSerial, isoTimeToSerial } from "../serial.js";
 import { RecordBuilder } from "../biff/builder.js";
+import { BiffWriteError } from "../biff/write-errors.js";
 import { concatRecords, writeRecord } from "../biff/record-writer.js";
-import { writeBofData } from "../biff/bof-writer.js";
+import { errorCodeOf } from "../biff/errors.js";
 import { writeXLUnicodeString } from "../biff/string-writer.js";
+import { isoDateTimeToSerial, isoDateToSerial, isoTimeToSerial } from "../serial.js";
+import { writeBofData } from "../biff/bof-writer.js";
 import { GENERAL_CELL_XF_INDEX } from "./globals-writer.js";
 import { compileFormulaText } from "../biff/ptg-writer.js";
 import { cellCarriesFormatting, writesCellRecord } from "../written-cells.js";

package/dist/workbook/sheet.cjs

@@ -3,9 +3,9 @@ const require_biff_record_types = require("../biff/record-types.cjs");
 const require_biff_records = require("../biff/records.cjs");
 const require_units = require("../units.cjs");
 const require_biff_print_setup = require("../biff/print-setup.cjs");
-const require_biff_substreams = require("../biff/substreams.cjs");
 const require_biff_cursor = require("../biff/cursor.cjs");
 const require_biff_strings = require("../biff/strings.cjs");
+const require_biff_substreams = require("../biff/substreams.cjs");
 const require_biff_errors = require("../biff/errors.cjs");
 const require_biff_ptg = require("../biff/ptg.cjs");
 const require_biff_rk = require("../biff/rk.cjs");

package/dist/workbook/sheet.d.cts

@@ -1,9 +1,9 @@
+import { t as RecordGroup } from "../substreams-XDNgDvRJ.cjs";
 import { n as SetupFields } from "../print-setup-B_ihDvm5.cjs";
 import { r as FormulaSheetContext } from "../ptg-75v7MhaA.cjs";
-import { t as RecordGroup } from "../substreams-XDNgDvRJ.cjs";
-import { r as RawConditionalFormat } from "../conditional-format-Cth_afMy.cjs";
-import { a as RawConditionalFormat12 } from "../conditional-format-12-D65-ruTq.cjs";
-import { t as RawDataValidation } from "../data-validation-BgUt8CbE.cjs";
+import { r as RawConditionalFormat } from "../conditional-format-BzTJe8Fm.cjs";
+import { a as RawConditionalFormat12 } from "../conditional-format-12-ZkrPfAP4.cjs";
+import { t as RawDataValidation } from "../data-validation-CTeIudWM.cjs";
 //#region src/workbook/sheet.d.ts
 /** A cell's value as its own record carries it, before number-format classification decides whether a number is really a date, a percentage, or an amount of money. */
 type RawCellValue = {

package/dist/workbook/sheet.d.ts

@@ -1,9 +1,9 @@
+import { t as RecordGroup } from "../substreams-CgTHx5kX.js";
 import { n as SetupFields } from "../print-setup-B_ihDvm5.js";
 import { r as FormulaSheetContext } from "../ptg-75v7MhaA.js";
-import { t as RecordGroup } from "../substreams-CgTHx5kX.js";
-import { r as RawConditionalFormat } from "../conditional-format-BRMUTRP1.js";
-import { a as RawConditionalFormat12 } from "../conditional-format-12-C3nwy1f8.js";
-import { t as RawDataValidation } from "../data-validation-Cq6iD8lB.js";
+import { r as RawConditionalFormat } from "../conditional-format-D4U0eLcY.js";
+import { a as RawConditionalFormat12 } from "../conditional-format-12-BTN59oHJ.js";
+import { t as RawDataValidation } from "../data-validation-Cjdk9imN.js";
 //#region src/workbook/sheet.d.ts
 /** A cell's value as its own record carries it, before number-format classification decides whether a number is really a date, a percentage, or an amount of money. */
 type RawCellValue = {

package/dist/workbook/sheet.js

@@ -2,9 +2,9 @@ import { RECORD_CFEX, RECORD_CONDFMT12 } from "../biff/record-types.js";
 import { BiffFormatError } from "../biff/records.js";
 import { columnWidthToPoints, inchesToPoints, twipsToPoints } from "../units.js";
 import { unpackSetupFlags } from "../biff/print-setup.js";
-import { recordByteLength } from "../biff/substreams.js";
 import { BlockCursor } from "../biff/cursor.js";
 import { readXLUnicodeString } from "../biff/strings.js";
+import { recordByteLength } from "../biff/substreams.js";
 import { errorTextOf } from "../biff/errors.js";
 import { parseFormulaText, readPtgExpBase } from "../biff/ptg.js";
 import { decodeRkNumber } from "../biff/rk.js";

package/dist/write.cjs

@@ -1,7 +1,9 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_container = require("./container.cjs");
-const require_biff_xf_colors = require("./biff/xf-colors.cjs");
 const require_biff_write_errors = require("./biff/write-errors.cjs");
+const require_biff_xf_colors = require("./biff/xf-colors.cjs");
+const require_biff_font = require("./biff/font.cjs");
+const require_workbook_defined_names = require("./workbook/defined-names.cjs");
 const require_workbook_print_names = require("./workbook/print-names.cjs");
 const require_metadata = require("./metadata.cjs");
 const require_workbook_globals_writer = require("./workbook/globals-writer.cjs");
@@ -41,8 +43,16 @@ function defaultFormatIdForKind(kind) {
 		case "empty": return GENERAL_FORMAT_ID;
 	}
 }
-/** The number-format code a cell resolves through -- its own explicit numberFormatCode, or the built-in code for its value kind's own default identifier. This is called identically during the workbook-wide format scan and later per cell, so the two can never resolve a cell to different codes. */
+/**
+* The number-format code a cell resolves through -- its own explicit numberFormatCode, a `[$USD]#,##0.00`-shaped code for a currency cell that names an ISO 4217 code of its own (see below), or the built-in code for its value kind's own default identifier. This is called identically during the workbook-wide format scan and later per cell, so the two can never resolve a cell to different codes.
+*
+* The ISO-code bracket is the one carrier a currency code survives the round trip through: the format string IS where BIFF8 states a cell's currency, and the classifier this package's own reader reads it back through recovers the code from exactly that bracket -- writing the symbol instead would render identically and lose the code permanently, since no faithful symbol-to-code mapping exists on the way back ('$' alone is USD, CAD, AUD and a dozen others). That is the identical encoding ooxml.js's own typed/xlsx/number-format.ts currencyNumberFormat already states for the same schema field, so an amount round-trips through either legacy format under the same spelling. A currency string that is not an ISO-code shape (a display symbol like "£") cannot go inside that bracket without producing a malformed format code, so it falls back to the plain built-in currency format -- the value kind preserved, the code honestly lost, since inventing a code for a symbol would state a currency the cell never named.
+*/
 function formatCodeForCell(cell) {
+	if (cell.numberFormatCode === void 0 && cell.value.kind === "currency") {
+		const currency = cell.value.currency;
+		if (currency !== void 0 && (0, excel_number_format.isIsoCurrencyCodeShape)(currency)) return `[$${currency.toUpperCase()}]#,##0.00`;
+	}
 	return cell.numberFormatCode ?? builtinCode(defaultFormatIdForKind(cell.value.kind));
 }
 /** Scans every sheet's cells once, assigning each distinct number-format code a formatId: reusing a built-in id for a code matching one of excel-number-format's own BUILTIN_NUMBER_FORMATS strings exactly, minting a new custom id from FIRST_CUSTOM_FORMAT_ID otherwise. Cell XF index assignment is a separate, later pass (buildCellXfPlan below) -- a formatId alone no longer determines a cell's XF index once decoration exists, since two cells sharing a format but differing in background/borders need two distinct XFs. */
@@ -103,6 +113,7 @@ function buildPalettePlan(sheets) {
 		for (const cell of sheet.cells) {
 			if (!require_written_cells.writesCellRecord(cell)) continue;
 			recordFill(cell.background);
+			record(cell.font?.color);
 			record(cell.borders?.left?.color);
 			record(cell.borders?.right?.color);
 			record(cell.borders?.top?.color);
@@ -201,33 +212,63 @@ function resolveDecorationForCell(cell, icvOf) {
 		bottom: resolveWriteEdge(cell.borders?.bottom, icvOf)
 	};
 }
-/** A deterministic signature for one cell XF's own (formatId, alignment, verticalAlignment, decoration) tuple, so two cells sharing all four share one XF record -- the interning key buildCellXfPlan below dedupes on, mirroring how CellFormatTable in ooxml.js's typed/xlsx/styles.ts dedupes an <xf> on (number format, decoration) together rather than on format alone, widened here by the cell's own alignment. */
-function signatureOfCellXf(formatId, alignment, verticalAlignment, decoration) {
-	let signature = `f${formatId}|a${alignment ?? ""}|v${verticalAlignment ?? ""}`;
+/** A deterministic signature for one cell XF's own (formatId, fontIndex, alignment, verticalAlignment, decoration) tuple, so two cells sharing all five share one XF record -- the interning key buildCellXfPlan below dedupes on, mirroring how CellFormatTable in ooxml.js's typed/xlsx/styles.ts dedupes an <xf> on (number format, decoration) together rather than on format alone, widened here by the cell's own font and alignment. */
+function signatureOfCellXf(formatId, fontIndex, alignment, verticalAlignment, decoration) {
+	let signature = `f${formatId}|n${fontIndex}|a${alignment ?? ""}|v${verticalAlignment ?? ""}`;
 	if (decoration === void 0) return signature;
 	signature += `|p${decoration.fillPattern}:${decoration.fillForegroundIcv}:${decoration.fillBackgroundIcv}|l${decoration.left.style}:${decoration.left.icv}|r${decoration.right.style}:${decoration.right.icv}|t${decoration.top.style}:${decoration.top.icv}|b${decoration.bottom.style}:${decoration.bottom.icv}`;
 	return signature;
 }
+/** A deterministic signature for one font-table entry, the interning key below dedupes on -- name, height, the four flags, and the colour index, since those are the whole record as far as this package's reader is concerned. */
+function signatureOfFont(fields) {
+	return `${fields.name}|${fields.heightTwips}|${fields.bold ? 1 : 0}${fields.italic ? 1 : 0}${fields.strikeout ? 1 : 0}${fields.underline ? 1 : 0}|${fields.colorIcv}`;
+}
+/**
+* Scans every sheet's cells once, interning each distinct cell font into its own font-table entry: the Normal font is always entry 0 (every style XF and the implicit General cell XF reference it, whether or not any cell states a font of its own), and each distinct ContentFont the workbook's cells resolve to mints one further entry the first time it is seen. A ContentFont that normalises back to the Normal font's own fields -- absent, empty, or restating only default values -- resolves to entry 0 and mints nothing, the write-side mirror of the reader's own diff against entry 0.
+*/
+function buildFontPlan(sheets, palettePlan) {
+	const fontEntries = [require_biff_font.NORMAL_FONT_FIELDS];
+	const indexBySignature = /* @__PURE__ */ new Map([[signatureOfFont(require_biff_font.NORMAL_FONT_FIELDS), 0]]);
+	const fieldsOf = (cell) => require_biff_font.xfFontFieldsOf(cell.font, palettePlan.icvOf);
+	for (const sheet of sheets) for (const cell of sheet.cells) {
+		if (!require_written_cells.writesCellRecord(cell)) continue;
+		const fields = fieldsOf(cell);
+		const signature = signatureOfFont(fields);
+		if (indexBySignature.has(signature)) continue;
+		indexBySignature.set(signature, fontEntries.length);
+		fontEntries.push(fields);
+	}
+	return {
+		fontEntries,
+		fontIndexForCell: (cell) => {
+			const index = indexBySignature.get(signatureOfFont(fieldsOf(cell)));
+			if (index === void 0) throw new require_biff_write_errors.BiffWriteError(`internal error: the cell at row ${cell.row}, column ${cell.column} resolves to a font the workbook-wide font scan never saw -- the writer's own "does this cell get a record" predicate and its font-interning pass disagree about this cell`);
+			return index;
+		}
+	};
+}
 /**
-* Scans every sheet's cells once, interning each distinct (number format, decoration) combination into its own cell XF index -- a cell with General formatting and no decoration resolves to the workbook's own implicit GENERAL_CELL_XF_INDEX with no new XF record at all, exactly as before; every other combination mints one XF record the first time it is seen and is reused by every later cell sharing it.
+* Scans every sheet's cells once, interning each distinct (number format, font, alignment, decoration) combination into its own cell XF index -- a cell with General formatting, the Normal font, and no decoration resolves to the workbook's own implicit GENERAL_CELL_XF_INDEX with no new XF record at all, exactly as before; every other combination mints one XF record the first time it is seen and is reused by every later cell sharing it.
 *
 * The returned xfIndexForCell only ever LOOKS UP -- it cannot mint an entry, and refuses a signature this scan never saw. buildWorkbookGlobals is handed cellXfEntries before any sheet's records are built, so an entry minted later than this scan would be one no XF record was written for, and the cell record naming its index would point past the end of the workbook's XF table. Nothing about the resulting bytes says so: a reader resolves that index to whatever XF happens to sit there, or to none, and the cell's format is silently wrong either way. Refusing the lookup is the only place that divergence can still be caught.
 */
-function buildCellXfPlan(sheets, formatPlan, palettePlan) {
+function buildCellXfPlan(sheets, formatPlan, palettePlan, fontPlan) {
 	const cellXfEntries = [];
-	const xfIndexBySignature = /* @__PURE__ */ new Map([[signatureOfCellXf(GENERAL_FORMAT_ID, void 0, void 0, void 0), require_workbook_globals_writer.GENERAL_CELL_XF_INDEX]]);
+	const xfIndexBySignature = /* @__PURE__ */ new Map([[signatureOfCellXf(GENERAL_FORMAT_ID, 0, void 0, void 0, void 0), require_workbook_globals_writer.GENERAL_CELL_XF_INDEX]]);
 	let nextXfIndex = require_workbook_globals_writer.GENERAL_CELL_XF_INDEX + 1;
-	const signatureOf = (cell) => signatureOfCellXf(formatPlan.formatIdOf(formatCodeForCell(cell)), cell.alignment, cell.verticalAlignment, resolveDecorationForCell(cell, palettePlan.icvOf));
+	const signatureOf = (cell) => signatureOfCellXf(formatPlan.formatIdOf(formatCodeForCell(cell)), fontPlan.fontIndexForCell(cell), cell.alignment, cell.verticalAlignment, resolveDecorationForCell(cell, palettePlan.icvOf));
 	for (const sheet of sheets) for (const cell of sheet.cells) {
 		if (!require_written_cells.writesCellRecord(cell)) continue;
 		const formatId = formatPlan.formatIdOf(formatCodeForCell(cell));
+		const fontIndex = fontPlan.fontIndexForCell(cell);
 		const decoration = resolveDecorationForCell(cell, palettePlan.icvOf);
-		const signature = signatureOfCellXf(formatId, cell.alignment, cell.verticalAlignment, decoration);
+		const signature = signatureOfCellXf(formatId, fontIndex, cell.alignment, cell.verticalAlignment, decoration);
 		if (xfIndexBySignature.has(signature)) continue;
 		xfIndexBySignature.set(signature, nextXfIndex);
 		nextXfIndex += 1;
 		cellXfEntries.push({
 			formatId,
+			fontIndex,
 			alignment: cell.alignment,
 			verticalAlignment: cell.verticalAlignment,
 			decoration
@@ -297,15 +338,18 @@ function buildWorkbookStream(content) {
 	const formatPlan = buildFormatPlan(content.sheets);
 	const sstPlan = buildSstPlan(content.sheets);
 	const palettePlan = buildPalettePlan(content.sheets);
-	const cellXfPlan = buildCellXfPlan(content.sheets, formatPlan, palettePlan);
+	const fontPlan = buildFontPlan(content.sheets, palettePlan);
+	const cellXfPlan = buildCellXfPlan(content.sheets, formatPlan, palettePlan, fontPlan);
 	const globalsPlan = {
 		sheetNames: content.sheets.map((sheet) => sheet.name),
+		fonts: fontPlan.fontEntries,
 		customFormats: formatPlan.customFormats,
 		cellXfEntries: cellXfPlan.cellXfEntries,
 		sharedStrings: sstPlan.strings,
 		sharedStringTotalCount: sstPlan.totalCount,
 		paletteColors: palettePlan.paletteColors,
-		printNames: buildPrintNamePlan(content.sheets)
+		printNames: buildPrintNamePlan(content.sheets),
+		definedNames: require_workbook_defined_names.definedNameEntriesFor(content.names ?? [], content.sheets)
 	};
 	const globals = require_workbook_globals_writer.buildWorkbookGlobals(globalsPlan);
 	const sheetContext = {

package/dist/write.js

@@ -1,6 +1,8 @@
 import { SUMMARY_INFORMATION_STREAM } from "./container.js";
-import { DEFAULT_PALETTE_HEX_TO_ICV, PATTERN_TYPE_TO_FILL_PATTERN, borderStyleTokenFor } from "./biff/xf-colors.js";
 import { BiffWriteError } from "./biff/write-errors.js";
+import { DEFAULT_PALETTE_HEX_TO_ICV, PATTERN_TYPE_TO_FILL_PATTERN, borderStyleTokenFor } from "./biff/xf-colors.js";
+import { NORMAL_FONT_FIELDS, xfFontFieldsOf } from "./biff/font.js";
+import { definedNameEntriesFor } from "./workbook/defined-names.js";
 import { printNameEntriesFor } from "./workbook/print-names.js";
 import { layoutMetadataToSummaryInformation as layoutMetadataToSummaryInformation$1 } from "./metadata.js";
 import { GENERAL_CELL_XF_INDEX, buildWorkbookGlobals } from "./workbook/globals-writer.js";
@@ -8,7 +10,7 @@ import { cellCarriesFormatting, writesCellRecord } from "./written-cells.js";
 import { buildWorksheetSubstream } from "./workbook/sheet-writer.js";
 import { hasSummaryInformationFields, writeCompoundFile, writeSummaryInformationStream } from "archive-codec";
 import { colorToRgbHex, flattenTree, unrecognizedFillKind } from "document-schema.js";
-import { BUILTIN_NUMBER_FORMATS } from "excel-number-format";
+import { BUILTIN_NUMBER_FORMATS, isIsoCurrencyCodeShape } from "excel-number-format";
 //#region src/write.ts
 const WORKBOOK_STREAM_NAME = "Workbook";
 /** [MS-XLS] 2.4.126: a Format record's own ifmt is constrained to the ranges 5-8, 23-26, 41-44, 63-66, and 164-382 for a custom (non-built-in) code; 164 is the first identifier every real producer actually uses for a custom code, and this writer follows suit, incrementing sequentially and refusing to exceed the range's own ceiling. */
@@ -40,8 +42,16 @@ function defaultFormatIdForKind(kind) {
 		case "empty": return GENERAL_FORMAT_ID;
 	}
 }
-/** The number-format code a cell resolves through -- its own explicit numberFormatCode, or the built-in code for its value kind's own default identifier. This is called identically during the workbook-wide format scan and later per cell, so the two can never resolve a cell to different codes. */
+/**
+* The number-format code a cell resolves through -- its own explicit numberFormatCode, a `[$USD]#,##0.00`-shaped code for a currency cell that names an ISO 4217 code of its own (see below), or the built-in code for its value kind's own default identifier. This is called identically during the workbook-wide format scan and later per cell, so the two can never resolve a cell to different codes.
+*
+* The ISO-code bracket is the one carrier a currency code survives the round trip through: the format string IS where BIFF8 states a cell's currency, and the classifier this package's own reader reads it back through recovers the code from exactly that bracket -- writing the symbol instead would render identically and lose the code permanently, since no faithful symbol-to-code mapping exists on the way back ('$' alone is USD, CAD, AUD and a dozen others). That is the identical encoding ooxml.js's own typed/xlsx/number-format.ts currencyNumberFormat already states for the same schema field, so an amount round-trips through either legacy format under the same spelling. A currency string that is not an ISO-code shape (a display symbol like "£") cannot go inside that bracket without producing a malformed format code, so it falls back to the plain built-in currency format -- the value kind preserved, the code honestly lost, since inventing a code for a symbol would state a currency the cell never named.
+*/
 function formatCodeForCell(cell) {
+	if (cell.numberFormatCode === void 0 && cell.value.kind === "currency") {
+		const currency = cell.value.currency;
+		if (currency !== void 0 && isIsoCurrencyCodeShape(currency)) return `[$${currency.toUpperCase()}]#,##0.00`;
+	}
 	return cell.numberFormatCode ?? builtinCode(defaultFormatIdForKind(cell.value.kind));
 }
 /** Scans every sheet's cells once, assigning each distinct number-format code a formatId: reusing a built-in id for a code matching one of excel-number-format's own BUILTIN_NUMBER_FORMATS strings exactly, minting a new custom id from FIRST_CUSTOM_FORMAT_ID otherwise. Cell XF index assignment is a separate, later pass (buildCellXfPlan below) -- a formatId alone no longer determines a cell's XF index once decoration exists, since two cells sharing a format but differing in background/borders need two distinct XFs. */
@@ -102,6 +112,7 @@ function buildPalettePlan(sheets) {
 		for (const cell of sheet.cells) {
 			if (!writesCellRecord(cell)) continue;
 			recordFill(cell.background);
+			record(cell.font?.color);
 			record(cell.borders?.left?.color);
 			record(cell.borders?.right?.color);
 			record(cell.borders?.top?.color);
@@ -200,33 +211,63 @@ function resolveDecorationForCell(cell, icvOf) {
 		bottom: resolveWriteEdge(cell.borders?.bottom, icvOf)
 	};
 }
-/** A deterministic signature for one cell XF's own (formatId, alignment, verticalAlignment, decoration) tuple, so two cells sharing all four share one XF record -- the interning key buildCellXfPlan below dedupes on, mirroring how CellFormatTable in ooxml.js's typed/xlsx/styles.ts dedupes an <xf> on (number format, decoration) together rather than on format alone, widened here by the cell's own alignment. */
-function signatureOfCellXf(formatId, alignment, verticalAlignment, decoration) {
-	let signature = `f${formatId}|a${alignment ?? ""}|v${verticalAlignment ?? ""}`;
+/** A deterministic signature for one cell XF's own (formatId, fontIndex, alignment, verticalAlignment, decoration) tuple, so two cells sharing all five share one XF record -- the interning key buildCellXfPlan below dedupes on, mirroring how CellFormatTable in ooxml.js's typed/xlsx/styles.ts dedupes an <xf> on (number format, decoration) together rather than on format alone, widened here by the cell's own font and alignment. */
+function signatureOfCellXf(formatId, fontIndex, alignment, verticalAlignment, decoration) {
+	let signature = `f${formatId}|n${fontIndex}|a${alignment ?? ""}|v${verticalAlignment ?? ""}`;
 	if (decoration === void 0) return signature;
 	signature += `|p${decoration.fillPattern}:${decoration.fillForegroundIcv}:${decoration.fillBackgroundIcv}|l${decoration.left.style}:${decoration.left.icv}|r${decoration.right.style}:${decoration.right.icv}|t${decoration.top.style}:${decoration.top.icv}|b${decoration.bottom.style}:${decoration.bottom.icv}`;
 	return signature;
 }
+/** A deterministic signature for one font-table entry, the interning key below dedupes on -- name, height, the four flags, and the colour index, since those are the whole record as far as this package's reader is concerned. */
+function signatureOfFont(fields) {
+	return `${fields.name}|${fields.heightTwips}|${fields.bold ? 1 : 0}${fields.italic ? 1 : 0}${fields.strikeout ? 1 : 0}${fields.underline ? 1 : 0}|${fields.colorIcv}`;
+}
+/**
+* Scans every sheet's cells once, interning each distinct cell font into its own font-table entry: the Normal font is always entry 0 (every style XF and the implicit General cell XF reference it, whether or not any cell states a font of its own), and each distinct ContentFont the workbook's cells resolve to mints one further entry the first time it is seen. A ContentFont that normalises back to the Normal font's own fields -- absent, empty, or restating only default values -- resolves to entry 0 and mints nothing, the write-side mirror of the reader's own diff against entry 0.
+*/
+function buildFontPlan(sheets, palettePlan) {
+	const fontEntries = [NORMAL_FONT_FIELDS];
+	const indexBySignature = /* @__PURE__ */ new Map([[signatureOfFont(NORMAL_FONT_FIELDS), 0]]);
+	const fieldsOf = (cell) => xfFontFieldsOf(cell.font, palettePlan.icvOf);
+	for (const sheet of sheets) for (const cell of sheet.cells) {
+		if (!writesCellRecord(cell)) continue;
+		const fields = fieldsOf(cell);
+		const signature = signatureOfFont(fields);
+		if (indexBySignature.has(signature)) continue;
+		indexBySignature.set(signature, fontEntries.length);
+		fontEntries.push(fields);
+	}
+	return {
+		fontEntries,
+		fontIndexForCell: (cell) => {
+			const index = indexBySignature.get(signatureOfFont(fieldsOf(cell)));
+			if (index === void 0) throw new BiffWriteError(`internal error: the cell at row ${cell.row}, column ${cell.column} resolves to a font the workbook-wide font scan never saw -- the writer's own "does this cell get a record" predicate and its font-interning pass disagree about this cell`);
+			return index;
+		}
+	};
+}
 /**
-* Scans every sheet's cells once, interning each distinct (number format, decoration) combination into its own cell XF index -- a cell with General formatting and no decoration resolves to the workbook's own implicit GENERAL_CELL_XF_INDEX with no new XF record at all, exactly as before; every other combination mints one XF record the first time it is seen and is reused by every later cell sharing it.
+* Scans every sheet's cells once, interning each distinct (number format, font, alignment, decoration) combination into its own cell XF index -- a cell with General formatting, the Normal font, and no decoration resolves to the workbook's own implicit GENERAL_CELL_XF_INDEX with no new XF record at all, exactly as before; every other combination mints one XF record the first time it is seen and is reused by every later cell sharing it.
 *
 * The returned xfIndexForCell only ever LOOKS UP -- it cannot mint an entry, and refuses a signature this scan never saw. buildWorkbookGlobals is handed cellXfEntries before any sheet's records are built, so an entry minted later than this scan would be one no XF record was written for, and the cell record naming its index would point past the end of the workbook's XF table. Nothing about the resulting bytes says so: a reader resolves that index to whatever XF happens to sit there, or to none, and the cell's format is silently wrong either way. Refusing the lookup is the only place that divergence can still be caught.
 */
-function buildCellXfPlan(sheets, formatPlan, palettePlan) {
+function buildCellXfPlan(sheets, formatPlan, palettePlan, fontPlan) {
 	const cellXfEntries = [];
-	const xfIndexBySignature = /* @__PURE__ */ new Map([[signatureOfCellXf(GENERAL_FORMAT_ID, void 0, void 0, void 0), GENERAL_CELL_XF_INDEX]]);
+	const xfIndexBySignature = /* @__PURE__ */ new Map([[signatureOfCellXf(GENERAL_FORMAT_ID, 0, void 0, void 0, void 0), GENERAL_CELL_XF_INDEX]]);
 	let nextXfIndex = GENERAL_CELL_XF_INDEX + 1;
-	const signatureOf = (cell) => signatureOfCellXf(formatPlan.formatIdOf(formatCodeForCell(cell)), cell.alignment, cell.verticalAlignment, resolveDecorationForCell(cell, palettePlan.icvOf));
+	const signatureOf = (cell) => signatureOfCellXf(formatPlan.formatIdOf(formatCodeForCell(cell)), fontPlan.fontIndexForCell(cell), cell.alignment, cell.verticalAlignment, resolveDecorationForCell(cell, palettePlan.icvOf));
 	for (const sheet of sheets) for (const cell of sheet.cells) {
 		if (!writesCellRecord(cell)) continue;
 		const formatId = formatPlan.formatIdOf(formatCodeForCell(cell));
+		const fontIndex = fontPlan.fontIndexForCell(cell);
 		const decoration = resolveDecorationForCell(cell, palettePlan.icvOf);
-		const signature = signatureOfCellXf(formatId, cell.alignment, cell.verticalAlignment, decoration);
+		const signature = signatureOfCellXf(formatId, fontIndex, cell.alignment, cell.verticalAlignment, decoration);
 		if (xfIndexBySignature.has(signature)) continue;
 		xfIndexBySignature.set(signature, nextXfIndex);
 		nextXfIndex += 1;
 		cellXfEntries.push({
 			formatId,
+			fontIndex,
 			alignment: cell.alignment,
 			verticalAlignment: cell.verticalAlignment,
 			decoration
@@ -296,15 +337,18 @@ function buildWorkbookStream(content) {
 	const formatPlan = buildFormatPlan(content.sheets);
 	const sstPlan = buildSstPlan(content.sheets);
 	const palettePlan = buildPalettePlan(content.sheets);
-	const cellXfPlan = buildCellXfPlan(content.sheets, formatPlan, palettePlan);
+	const fontPlan = buildFontPlan(content.sheets, palettePlan);
+	const cellXfPlan = buildCellXfPlan(content.sheets, formatPlan, palettePlan, fontPlan);
 	const globalsPlan = {
 		sheetNames: content.sheets.map((sheet) => sheet.name),
+		fonts: fontPlan.fontEntries,
 		customFormats: formatPlan.customFormats,
 		cellXfEntries: cellXfPlan.cellXfEntries,
 		sharedStrings: sstPlan.strings,
 		sharedStringTotalCount: sstPlan.totalCount,
 		paletteColors: palettePlan.paletteColors,
-		printNames: buildPrintNamePlan(content.sheets)
+		printNames: buildPrintNamePlan(content.sheets),
+		definedNames: definedNameEntriesFor(content.names ?? [], content.sheets)
 	};
 	const globals = buildWorkbookGlobals(globalsPlan);
 	const sheetContext = {

package/dist/written-cells.cjs

@@ -1,14 +1,16 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_biff_font = require("./biff/font.cjs");
 //#region src/written-cells.ts
 /**
-* Whether a cell carries real formatting beyond General/bottom-aligned/undecorated: a background fill, a border on at least one side, a non-default horizontal alignment, or a non-default vertical alignment.
+* Whether a cell carries real formatting beyond General/bottom-aligned/undecorated/default-font: a background fill, a border on at least one side, a non-default horizontal alignment, a non-default vertical alignment, or a font that differs from the workbook's own Normal font.
 *
-* A present `borders` object is not enough on its own -- one with no side set describes no border at all, and treating it as formatting would mint an XF byte-identical to the undecorated one and, for an empty cell, a Blank record the reader would then correctly drop again. write.ts's own resolveDecorationForCell answers "no decoration" for exactly this set through this same predicate, so the two cannot disagree about what an empty-but-present borders object means.
+* A present `borders` object is not enough on its own -- one with no side set describes no border at all, and treating it as formatting would mint an XF byte-identical to the undecorated one and, for an empty cell, a Blank record the reader would then correctly drop again. write.ts's own resolveDecorationForCell answers "no decoration" for exactly this set through this same predicate, so the two cannot disagree about what an empty-but-present borders object means. A font is held to the identical standard through biff/font.ts's cellFontDiffersFromNormal, so a ContentFont that merely restates a default value (fontFamily "Arial", sizePt 10, bold false) is none either, for the same reason.
 */
 function cellCarriesFormatting(cell) {
 	if (cell.background !== void 0) return true;
 	if (cell.alignment !== void 0) return true;
 	if (cell.verticalAlignment !== void 0) return true;
+	if (cell.font !== void 0 && require_biff_font.cellFontDiffersFromNormal(cell.font)) return true;
 	const { borders } = cell;
 	if (borders === void 0) return false;
 	return borders.left !== void 0 || borders.right !== void 0 || borders.top !== void 0 || borders.bottom !== void 0;

package/dist/written-cells.d.cts

@@ -1,9 +1,9 @@
 import { ContentSheetCell } from "document-schema.js";
 //#region src/written-cells.d.ts
 /**
- * Whether a cell carries real formatting beyond General/bottom-aligned/undecorated: a background fill, a border on at least one side, a non-default horizontal alignment, or a non-default vertical alignment.
+ * Whether a cell carries real formatting beyond General/bottom-aligned/undecorated/default-font: a background fill, a border on at least one side, a non-default horizontal alignment, a non-default vertical alignment, or a font that differs from the workbook's own Normal font.
  *
- * A present `borders` object is not enough on its own -- one with no side set describes no border at all, and treating it as formatting would mint an XF byte-identical to the undecorated one and, for an empty cell, a Blank record the reader would then correctly drop again. write.ts's own resolveDecorationForCell answers "no decoration" for exactly this set through this same predicate, so the two cannot disagree about what an empty-but-present borders object means.
+ * A present `borders` object is not enough on its own -- one with no side set describes no border at all, and treating it as formatting would mint an XF byte-identical to the undecorated one and, for an empty cell, a Blank record the reader would then correctly drop again. write.ts's own resolveDecorationForCell answers "no decoration" for exactly this set through this same predicate, so the two cannot disagree about what an empty-but-present borders object means. A font is held to the identical standard through biff/font.ts's cellFontDiffersFromNormal, so a ContentFont that merely restates a default value (fontFamily "Arial", sizePt 10, bold false) is none either, for the same reason.
  */
 declare function cellCarriesFormatting(cell: ContentSheetCell): boolean;
 /**

package/dist/written-cells.d.ts

@@ -1,9 +1,9 @@
 import { ContentSheetCell } from "document-schema.js";
 //#region src/written-cells.d.ts
 /**
- * Whether a cell carries real formatting beyond General/bottom-aligned/undecorated: a background fill, a border on at least one side, a non-default horizontal alignment, or a non-default vertical alignment.
+ * Whether a cell carries real formatting beyond General/bottom-aligned/undecorated/default-font: a background fill, a border on at least one side, a non-default horizontal alignment, a non-default vertical alignment, or a font that differs from the workbook's own Normal font.
  *
- * A present `borders` object is not enough on its own -- one with no side set describes no border at all, and treating it as formatting would mint an XF byte-identical to the undecorated one and, for an empty cell, a Blank record the reader would then correctly drop again. write.ts's own resolveDecorationForCell answers "no decoration" for exactly this set through this same predicate, so the two cannot disagree about what an empty-but-present borders object means.
+ * A present `borders` object is not enough on its own -- one with no side set describes no border at all, and treating it as formatting would mint an XF byte-identical to the undecorated one and, for an empty cell, a Blank record the reader would then correctly drop again. write.ts's own resolveDecorationForCell answers "no decoration" for exactly this set through this same predicate, so the two cannot disagree about what an empty-but-present borders object means. A font is held to the identical standard through biff/font.ts's cellFontDiffersFromNormal, so a ContentFont that merely restates a default value (fontFamily "Arial", sizePt 10, bold false) is none either, for the same reason.
  */
 declare function cellCarriesFormatting(cell: ContentSheetCell): boolean;
 /**

package/dist/written-cells.js

@@ -1,13 +1,15 @@
+import { cellFontDiffersFromNormal } from "./biff/font.js";
 //#region src/written-cells.ts
 /**
-* Whether a cell carries real formatting beyond General/bottom-aligned/undecorated: a background fill, a border on at least one side, a non-default horizontal alignment, or a non-default vertical alignment.
+* Whether a cell carries real formatting beyond General/bottom-aligned/undecorated/default-font: a background fill, a border on at least one side, a non-default horizontal alignment, a non-default vertical alignment, or a font that differs from the workbook's own Normal font.
 *
-* A present `borders` object is not enough on its own -- one with no side set describes no border at all, and treating it as formatting would mint an XF byte-identical to the undecorated one and, for an empty cell, a Blank record the reader would then correctly drop again. write.ts's own resolveDecorationForCell answers "no decoration" for exactly this set through this same predicate, so the two cannot disagree about what an empty-but-present borders object means.
+* A present `borders` object is not enough on its own -- one with no side set describes no border at all, and treating it as formatting would mint an XF byte-identical to the undecorated one and, for an empty cell, a Blank record the reader would then correctly drop again. write.ts's own resolveDecorationForCell answers "no decoration" for exactly this set through this same predicate, so the two cannot disagree about what an empty-but-present borders object means. A font is held to the identical standard through biff/font.ts's cellFontDiffersFromNormal, so a ContentFont that merely restates a default value (fontFamily "Arial", sizePt 10, bold false) is none either, for the same reason.
 */
 function cellCarriesFormatting(cell) {
 	if (cell.background !== void 0) return true;
 	if (cell.alignment !== void 0) return true;
 	if (cell.verticalAlignment !== void 0) return true;
+	if (cell.font !== void 0 && cellFontDiffersFromNormal(cell.font)) return true;
 	const { borders } = cell;
 	if (borders === void 0) return false;
 	return borders.left !== void 0 || borders.right !== void 0 || borders.top !== void 0 || borders.bottom !== void 0;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xls-codec",
-  "version": "4.12.5",
+  "version": "4.13.0",
   "description": "Hand-written reader for the legacy Excel Binary File Format (.xls, BIFF8) as specified by [MS-XLS], mapping a workbook's record stream onto the shared document-schema.js spreadsheet model - the .xls codec for the documents.js family.",
   "type": "module",
   "repository": {
@@ -70,8 +70,8 @@
   },
   "packageManager": "pnpm@11.6.0",
   "dependencies": {
-    "archive-codec": "1.10.6",
-    "document-schema.js": "7.9.0",
+    "archive-codec": "1.10.8",
+    "document-schema.js": "7.10.0",
     "excel-number-format": "1.1.1"
   },
   "devDependencies": {