xls-codec 4.12.6 → 4.14.0

package/dist/workbook/data-validation-write.js

@@ -1,6 +1,6 @@
 import "../biff/record-types.js";
-import { BiffWriteError } from "../biff/write-errors.js";
 import { RecordBuilder } from "../biff/builder.js";
+import { BiffWriteError } from "../biff/write-errors.js";
 import { writeRecord } from "../biff/record-writer.js";
 import { writeXLUnicodeString } from "../biff/string-writer.js";
 import { compileFormulaText } from "../biff/ptg-writer.js";

package/dist/workbook/data-validation.d.cts

@@ -1,2 +1,2 @@
-import { n as readDv, t as RawDataValidation } from "../data-validation-BgUt8CbE.cjs";
+import { n as readDv, t as RawDataValidation } from "../data-validation-CTeIudWM.cjs";
 export { RawDataValidation, readDv };

package/dist/workbook/data-validation.d.ts

@@ -1,2 +1,2 @@
-import { n as readDv, t as RawDataValidation } from "../data-validation-Cq6iD8lB.js";
+import { n as readDv, t as RawDataValidation } from "../data-validation-Cjdk9imN.js";
 export { RawDataValidation, readDv };

package/dist/workbook/defined-names.cjs

@@ -0,0 +1,186 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+require("../biff/record-types.cjs");
+const require_biff_records = require("../biff/records.cjs");
+const require_biff_builder = require("../biff/builder.cjs");
+const require_biff_cursor = require("../biff/cursor.cjs");
+const require_biff_write_errors = require("../biff/write-errors.cjs");
+const require_biff_record_writer = require("../biff/record-writer.cjs");
+const require_biff_strings = require("../biff/strings.cjs");
+const require_biff_ptg = require("../biff/ptg.cjs");
+const require_biff_string_writer = require("../biff/string-writer.cjs");
+let document_schema_js = require("document-schema.js");
+//#region src/workbook/defined-names.ts
+/** Lbl.grbit's fBuiltin bit -- field F of [MS-XLS] 2.4.150's own grbit layout. */
+const LBL_FLAG_BUILTIN = 32;
+/** [MS-XLS] 2.4.150's own built-in name table: the index a built-in name's single-character Name field carries, and the name it spells. The `_xlnm.` prefix is ECMA-376's own reserved spelling for the identical names in an xlsx (the two print ones confirmed against real LibreOffice-written markup in ooxml.js's own fixture), so a built-in rides through the shared schema under the spelling every other member of this format family already uses for it. */
+const BUILTIN_NAME_SPELLINGS = [
+	"_xlnm.Consolidate_Area",
+	"_xlnm.Auto_Open",
+	"_xlnm.Auto_Close",
+	"_xlnm.Extract",
+	"_xlnm.Database",
+	"_xlnm.Criteria",
+	"_xlnm.Print_Area",
+	"_xlnm.Print_Titles",
+	"_xlnm.Recorder",
+	"_xlnm.Data_Form",
+	"_xlnm.Auto_Activate",
+	"_xlnm.Auto_Deactivate",
+	"_xlnm.Sheet_Title",
+	"_xlnm._FilterDatabase"
+];
+/** The two built-in names print-names.ts owns end to end: read there onto ContentSheetPrintSettings, written there from them, and therefore skipped here rather than stated twice. */
+const BUILTIN_NAME_PRINT_AREA = 6;
+const BUILTIN_NAME_PRINT_TITLES = 7;
+/** The `_xlnm.` prefix ECMA-376 reserves for built-in defined names, which is also the spelling this package reads them under -- so a name carrying it on write resolves back through the built-in table below, and one the table does not know is refused rather than written as a user name Excel itself forbids the prefix for. */
+const XLNM_PREFIX = "_xlnm.";
+/**
+* Reads every Lbl record in a globals substream into a defined name, or skips it: the two print built-ins (print-names.ts owns them), a built-in index past the table above (no spelling to give it), a name whose rgce resolves to no formula text (a construct outside parseFormulaText's vocabulary, or a stream too malformed to walk -- ContentDefinedNameSchema requires refersTo, and a fabricated placeholder is not formula text), and a record whose own bytes overrun (caught per record rather than letting one malformed Lbl abort every other name, the identical per-record boundary sheet.ts's resolveFormulaText draws for a malformed cell formula).
+*/
+function readDefinedNames(records, formulaSheets) {
+	const names = [];
+	for (const record of records) {
+		if (record.type !== 24) continue;
+		const parsed = readLblRecord(record, formulaSheets);
+		if (parsed !== void 0) names.push(parsed);
+	}
+	return names;
+}
+/** Lbl ([MS-XLS] 2.4.150): grbit, chKey, cch, cce, reserved3, itab, four reserved bytes, the Name as an XLUnicodeStringNoCch, then cce bytes of rgce (NameParsedFormula) and whatever rgcb trailer follows. */
+function readLblRecord(record, formulaSheets) {
+	try {
+		const cursor = new require_biff_cursor.BlockCursor(record.blocks);
+		const isBuiltin = (cursor.u16() & LBL_FLAG_BUILTIN) !== 0;
+		cursor.skip(1);
+		const cch = cursor.u8();
+		const cce = cursor.u16();
+		cursor.skip(2);
+		const itab = cursor.u16();
+		cursor.skip(4);
+		let name;
+		if (isBuiltin) {
+			const highByte = (cursor.u8() & 1) !== 0;
+			if (cch !== 1 || highByte) return;
+			const builtinIndex = cursor.u8();
+			if (builtinIndex === BUILTIN_NAME_PRINT_AREA || builtinIndex === BUILTIN_NAME_PRINT_TITLES) return;
+			const spelling = BUILTIN_NAME_SPELLINGS[builtinIndex];
+			if (spelling === void 0) return;
+			name = spelling;
+		} else name = require_biff_strings.readXLUnicodeStringNoCch(cursor, cch);
+		const rgce = cursor.take(cce);
+		const rgcb = cursor.take(cursor.remainingInBlock());
+		const refersTo = require_biff_ptg.parseFormulaText(rgce, formulaSheets, { rgcb });
+		return refersTo === void 0 ? void 0 : {
+			name,
+			refersTo,
+			sheetIndex: itab === 0 ? void 0 : itab - 1
+		};
+	} catch (error) {
+		if (!(error instanceof require_biff_records.BiffFormatError)) throw error;
+		return;
+	}
+}
+/** The reverse of BUILTIN_NAME_SPELLINGS: an _xlnm spelling back to the built-in index a single-character Name field would carry. */
+const BUILTIN_INDEX_BY_NAME = new Map(BUILTIN_NAME_SPELLINGS.map((spelling, index) => [spelling, index]));
+/** A single A1-style corner, with or without its $ markers -- the identical shape biff/ptg.ts's own formatPoint produces, parsed back the other way. A `$` is honoured per coordinate rather than normalised away, because a relative coordinate in a defined name is genuine, retypeable formula semantics Excel re-interprets against the name's own scope, not a display detail. */
+const REFERENCE_CORNER_RE = /^(\$?)([A-Za-z]{1,3})(\$?)([0-9]{1,5})$/;
+/** A full refersTo this writer can compile: one sheet-qualified corner or corner pair, nothing more. */
+const SHEET_QUALIFIED_REFERENCE_RE = /^(.*)!((?:\$?[A-Za-z]{1,3}\$?[0-9]{1,5})(?::(?:\$?[A-Za-z]{1,3}\$?[0-9]{1,5}))?)$/;
+/** A user-defined name shaped like a cell reference ("A1", "$B$2", "A1:B2") is forbidden by [MS-XLS] 2.5.295's own name restrictions, since a formula using it would be indistinguishable from the reference itself. */
+const CELL_REFERENCE_NAME_RE = /^\$?[A-Za-z]{1,3}\$?[0-9]{1,5}(:\$?[A-Za-z]{1,3}\$?[0-9]{1,5})?$/;
+function parseCorner(text) {
+	const match = REFERENCE_CORNER_RE.exec(text);
+	if (match === null) return;
+	const column = (0, document_schema_js.columnLettersToIndex)(match[2] ?? "");
+	const row = Number.parseInt(match[4] ?? "", 10) - 1;
+	if (column === void 0 || row < 0) return;
+	return {
+		row,
+		column,
+		columnAbsolute: (match[1] ?? "") === "$",
+		rowAbsolute: (match[3] ?? "") === "$"
+	};
+}
+/** BIFF8's own grid ceilings, which a defined name's reference shares with every other reference in the format. */
+const MAX_ROW_INDEX = 65535;
+const MAX_COLUMN_INDEX = 255;
+/** ColRelU's own relative bits ([MS-XLS] 2.5.198.105): bit 14 (0x4000) says the COLUMN coordinate is relative, bit 15 (0x8000) the ROW -- clear means absolute, exactly as biff/ptg.ts's pointFrom decodes them on read. */
+const COLUMN_RELATIVE_BIT = 16384;
+const ROW_RELATIVE_BIT = 32768;
+/** PtgArea3d, reference class ([MS-XLS] 2.5.198.28): opcode 0x3b, the ixti, then an RgceArea -- the same token write-side print-names.ts builds for a print name's range, since a defined name has no other way to say which sheet its reference is on. */
+function writeArea3dToken(ixti, first, last) {
+	const columnFieldOf = (corner) => corner.column | (corner.columnAbsolute ? 0 : COLUMN_RELATIVE_BIT) | (corner.rowAbsolute ? 0 : ROW_RELATIVE_BIT);
+	return new require_biff_builder.RecordBuilder().u8(59).u16(ixti).u16(first.row).u16(last.row).u16(columnFieldOf(first)).u16(columnFieldOf(last)).build();
+}
+/** Strips the single-quote wrapping a sheet label carries when the sheet name is not a bare identifier, unescaping the doubled quote inside -- the inverse of biff/ptg.ts's quoteSheetLabel. A string must actually be quoted on both ends to unwrap; a bare name is taken verbatim. */
+function unquoteSheetLabel(label) {
+	if (label.startsWith("'") && label.endsWith("'") && label.length >= 2) return label.slice(1, -1).replaceAll("''", "'");
+	return label;
+}
+/**
+* Compiles the document's defined names into the Lbl records the workbook stream carries.
+*
+* The refersTo vocabulary this writer can compile is exactly one sheet-qualified A1 reference -- `Sheet1!$A$1`, `Sheet1!$A$1:$B$2`, the sheet name quoted when it is not a bare identifier -- which is the shape every named range carries and the shape this package's own reader produces for one. A refersTo outside that vocabulary (a computed formula, a constant, an external-workbook reference) throws a BiffWriteError naming the construct rather than emitting a token stream this writer cannot prove round-trips, the identical refusal the cell-formula writer draws for the constructs outside its own vocabulary.
+*/
+function definedNameEntriesFor(names, sheets) {
+	return names.map((defined) => {
+		const builtinName = defined.name.startsWith(XLNM_PREFIX) ? builtinIndexOf(defined.name) : void 0;
+		if (builtinName === void 0) validateUserName(defined.name);
+		return {
+			name: defined.name,
+			builtinName,
+			sheetIndex: scopeOf(defined, sheets.length),
+			rgce: compileRefersTo(defined, sheets).rgce
+		};
+	});
+}
+/** Resolves an _xlnm spelling to its built-in index, refusing the two print built-ins (print-names.ts owns them -- a document stating its print area as a names entry is stating a fact the print settings already carry, and writing both would emit the same Lbl record twice) and any spelling the table does not know. */
+function builtinIndexOf(name) {
+	const index = BUILTIN_INDEX_BY_NAME.get(name);
+	if (index === void 0) throw new require_biff_write_errors.BiffWriteError(`xls-codec cannot write the defined name ${JSON.stringify(name)}: the "_xlnm." prefix is reserved for built-in names, and this one is not in [MS-XLS] 2.4.150's own built-in name table`);
+	if (index === BUILTIN_NAME_PRINT_AREA || index === BUILTIN_NAME_PRINT_TITLES) throw new require_biff_write_errors.BiffWriteError(`xls-codec cannot write the defined name ${JSON.stringify(name)}: the print built-ins are print-settings facts, stated through a sheet's printSettings (printRange/repeatRows/repeatColumns) rather than as document-level names -- writing both would emit the same Lbl record twice`);
+	return index;
+}
+/** A user-defined name must fit the record's own one-byte cch and must not be shaped like a cell reference, the one restriction of [MS-XLS] 2.5.295's own name grammar a writer can enforce without guessing at Excel's full validity table. */
+function validateUserName(name) {
+	if (name.length < 1 || name.length > 255) throw new require_biff_write_errors.BiffWriteError(`xls-codec cannot write a defined name of ${name.length} characters: Lbl's own cch field is one byte, so a name must be 1-255 UTF-16 code units`);
+	if (CELL_REFERENCE_NAME_RE.test(name)) throw new require_biff_write_errors.BiffWriteError(`xls-codec cannot write the defined name ${JSON.stringify(name)}: a name shaped like a cell reference is forbidden, since a formula using it would be indistinguishable from the reference itself`);
+}
+/** A scopeSheetIndex past the end of the document's own sheets array names a sheet that does not exist, so it is refused rather than written as an itab no BoundSheet8 answers to. */
+function scopeOf(defined, sheetCount) {
+	if (defined.scopeSheetIndex === void 0) return;
+	if (defined.scopeSheetIndex >= sheetCount) throw new require_biff_write_errors.BiffWriteError(`xls-codec cannot write the defined name ${JSON.stringify(defined.name)}: its scopeSheetIndex ${defined.scopeSheetIndex} is past the end of the document's own ${sheetCount}-sheet array`);
+	return defined.scopeSheetIndex;
+}
+/** Parses and compiles one entry's refersTo, throwing for anything outside the single sheet-qualified reference vocabulary documented on definedNameEntriesFor. */
+function compileRefersTo(defined, sheets) {
+	const match = SHEET_QUALIFIED_REFERENCE_RE.exec(defined.refersTo);
+	if (match === null) throw new require_biff_write_errors.BiffWriteError(`xls-codec cannot write the defined name ${JSON.stringify(defined.name)}: its refersTo ${JSON.stringify(defined.refersTo)} is not a sheet-qualified cell or range reference, the one vocabulary this writer compiles for a name`);
+	const sheetName = unquoteSheetLabel(match[1] ?? "");
+	const sheetIndex = sheets.findIndex((sheet) => sheet.name === sheetName);
+	if (sheetIndex === -1) throw new require_biff_write_errors.BiffWriteError(`xls-codec cannot write the defined name ${JSON.stringify(defined.name)}: its refersTo names the sheet ${JSON.stringify(sheetName)}, which the document's own sheets do not carry`);
+	const [firstText, lastText] = (match[2] ?? "").split(":");
+	const first = parseCorner(firstText ?? "");
+	const last = lastText === void 0 ? first : parseCorner(lastText);
+	if (first === void 0 || last === void 0) throw new require_biff_write_errors.BiffWriteError(`xls-codec cannot write the defined name ${JSON.stringify(defined.name)}: its refersTo ${JSON.stringify(defined.refersTo)} does not name an A1-style reference this writer can compile`);
+	if (first.row > MAX_ROW_INDEX || last.row > MAX_ROW_INDEX || first.column > MAX_COLUMN_INDEX || last.column > MAX_COLUMN_INDEX) throw new require_biff_write_errors.BiffWriteError(`xls-codec cannot write the defined name ${JSON.stringify(defined.name)}: its refersTo ${JSON.stringify(defined.refersTo)} reaches outside BIFF8's own grid (rows 0-${MAX_ROW_INDEX}, columns 0-${MAX_COLUMN_INDEX})`);
+	return {
+		sheetIndex,
+		rgce: writeArea3dToken(sheetIndex, first, last)
+	};
+}
+/** One Lbl record ([MS-XLS] 2.4.150) for a planned defined name, the write-side mirror of readLblRecord above: grbit carries only fBuiltin when it is set, the Name is a compressed single character for a built-in and a real XLUnicodeStringNoCch otherwise, and itab restates the entry's scope one-based. */
+function writeDefinedNameRecord(entry) {
+	const nameBytes = entry.builtinName === void 0 ? require_biff_string_writer.writeXLUnicodeStringNoCch(entry.name) : new require_biff_builder.RecordBuilder().u8(0).u8(entry.builtinName).build();
+	const data = new require_biff_builder.RecordBuilder().u16(entry.builtinName === void 0 ? 0 : LBL_FLAG_BUILTIN).u8(0).u8(entry.builtinName === void 0 ? entry.name.length : 1).u16(entry.rgce.length).u16(0).u16(entry.sheetIndex === void 0 ? 0 : entry.sheetIndex + 1).u32(0).bytes(nameBytes).bytes(entry.rgce).build();
+	return require_biff_record_writer.writeRecord(24, data);
+}
+/** Every planned defined name as its own Lbl record, in the order given. */
+function writeDefinedNameRecords(entries) {
+	return entries.map(writeDefinedNameRecord);
+}
+//#endregion
+exports.definedNameEntriesFor = definedNameEntriesFor;
+exports.readDefinedNames = readDefinedNames;
+exports.writeDefinedNameRecord = writeDefinedNameRecord;
+exports.writeDefinedNameRecords = writeDefinedNameRecords;

package/dist/workbook/defined-names.d.cts

@@ -0,0 +1,2 @@
+import { a as writeDefinedNameRecord, i as readDefinedNames, n as RawDefinedName, o as writeDefinedNameRecords, r as definedNameEntriesFor, t as DefinedNamePlanEntry } from "../defined-names-CqBJJmOJ.cjs";
+export { DefinedNamePlanEntry, RawDefinedName, definedNameEntriesFor, readDefinedNames, writeDefinedNameRecord, writeDefinedNameRecords };

package/dist/workbook/defined-names.d.ts

@@ -0,0 +1,2 @@
+import { a as writeDefinedNameRecord, i as readDefinedNames, n as RawDefinedName, o as writeDefinedNameRecords, r as definedNameEntriesFor, t as DefinedNamePlanEntry } from "../defined-names-DJZ27hRp.js";
+export { DefinedNamePlanEntry, RawDefinedName, definedNameEntriesFor, readDefinedNames, writeDefinedNameRecord, writeDefinedNameRecords };

package/dist/workbook/defined-names.js

@@ -0,0 +1,182 @@
+import "../biff/record-types.js";
+import { BiffFormatError } from "../biff/records.js";
+import { RecordBuilder } from "../biff/builder.js";
+import { BlockCursor } from "../biff/cursor.js";
+import { BiffWriteError } from "../biff/write-errors.js";
+import { writeRecord } from "../biff/record-writer.js";
+import { readXLUnicodeStringNoCch } from "../biff/strings.js";
+import { parseFormulaText } from "../biff/ptg.js";
+import { writeXLUnicodeStringNoCch } from "../biff/string-writer.js";
+import { columnLettersToIndex } from "document-schema.js";
+//#region src/workbook/defined-names.ts
+/** Lbl.grbit's fBuiltin bit -- field F of [MS-XLS] 2.4.150's own grbit layout. */
+const LBL_FLAG_BUILTIN = 32;
+/** [MS-XLS] 2.4.150's own built-in name table: the index a built-in name's single-character Name field carries, and the name it spells. The `_xlnm.` prefix is ECMA-376's own reserved spelling for the identical names in an xlsx (the two print ones confirmed against real LibreOffice-written markup in ooxml.js's own fixture), so a built-in rides through the shared schema under the spelling every other member of this format family already uses for it. */
+const BUILTIN_NAME_SPELLINGS = [
+	"_xlnm.Consolidate_Area",
+	"_xlnm.Auto_Open",
+	"_xlnm.Auto_Close",
+	"_xlnm.Extract",
+	"_xlnm.Database",
+	"_xlnm.Criteria",
+	"_xlnm.Print_Area",
+	"_xlnm.Print_Titles",
+	"_xlnm.Recorder",
+	"_xlnm.Data_Form",
+	"_xlnm.Auto_Activate",
+	"_xlnm.Auto_Deactivate",
+	"_xlnm.Sheet_Title",
+	"_xlnm._FilterDatabase"
+];
+/** The two built-in names print-names.ts owns end to end: read there onto ContentSheetPrintSettings, written there from them, and therefore skipped here rather than stated twice. */
+const BUILTIN_NAME_PRINT_AREA = 6;
+const BUILTIN_NAME_PRINT_TITLES = 7;
+/** The `_xlnm.` prefix ECMA-376 reserves for built-in defined names, which is also the spelling this package reads them under -- so a name carrying it on write resolves back through the built-in table below, and one the table does not know is refused rather than written as a user name Excel itself forbids the prefix for. */
+const XLNM_PREFIX = "_xlnm.";
+/**
+* Reads every Lbl record in a globals substream into a defined name, or skips it: the two print built-ins (print-names.ts owns them), a built-in index past the table above (no spelling to give it), a name whose rgce resolves to no formula text (a construct outside parseFormulaText's vocabulary, or a stream too malformed to walk -- ContentDefinedNameSchema requires refersTo, and a fabricated placeholder is not formula text), and a record whose own bytes overrun (caught per record rather than letting one malformed Lbl abort every other name, the identical per-record boundary sheet.ts's resolveFormulaText draws for a malformed cell formula).
+*/
+function readDefinedNames(records, formulaSheets) {
+	const names = [];
+	for (const record of records) {
+		if (record.type !== 24) continue;
+		const parsed = readLblRecord(record, formulaSheets);
+		if (parsed !== void 0) names.push(parsed);
+	}
+	return names;
+}
+/** Lbl ([MS-XLS] 2.4.150): grbit, chKey, cch, cce, reserved3, itab, four reserved bytes, the Name as an XLUnicodeStringNoCch, then cce bytes of rgce (NameParsedFormula) and whatever rgcb trailer follows. */
+function readLblRecord(record, formulaSheets) {
+	try {
+		const cursor = new BlockCursor(record.blocks);
+		const isBuiltin = (cursor.u16() & LBL_FLAG_BUILTIN) !== 0;
+		cursor.skip(1);
+		const cch = cursor.u8();
+		const cce = cursor.u16();
+		cursor.skip(2);
+		const itab = cursor.u16();
+		cursor.skip(4);
+		let name;
+		if (isBuiltin) {
+			const highByte = (cursor.u8() & 1) !== 0;
+			if (cch !== 1 || highByte) return;
+			const builtinIndex = cursor.u8();
+			if (builtinIndex === BUILTIN_NAME_PRINT_AREA || builtinIndex === BUILTIN_NAME_PRINT_TITLES) return;
+			const spelling = BUILTIN_NAME_SPELLINGS[builtinIndex];
+			if (spelling === void 0) return;
+			name = spelling;
+		} else name = readXLUnicodeStringNoCch(cursor, cch);
+		const rgce = cursor.take(cce);
+		const rgcb = cursor.take(cursor.remainingInBlock());
+		const refersTo = parseFormulaText(rgce, formulaSheets, { rgcb });
+		return refersTo === void 0 ? void 0 : {
+			name,
+			refersTo,
+			sheetIndex: itab === 0 ? void 0 : itab - 1
+		};
+	} catch (error) {
+		if (!(error instanceof BiffFormatError)) throw error;
+		return;
+	}
+}
+/** The reverse of BUILTIN_NAME_SPELLINGS: an _xlnm spelling back to the built-in index a single-character Name field would carry. */
+const BUILTIN_INDEX_BY_NAME = new Map(BUILTIN_NAME_SPELLINGS.map((spelling, index) => [spelling, index]));
+/** A single A1-style corner, with or without its $ markers -- the identical shape biff/ptg.ts's own formatPoint produces, parsed back the other way. A `$` is honoured per coordinate rather than normalised away, because a relative coordinate in a defined name is genuine, retypeable formula semantics Excel re-interprets against the name's own scope, not a display detail. */
+const REFERENCE_CORNER_RE = /^(\$?)([A-Za-z]{1,3})(\$?)([0-9]{1,5})$/;
+/** A full refersTo this writer can compile: one sheet-qualified corner or corner pair, nothing more. */
+const SHEET_QUALIFIED_REFERENCE_RE = /^(.*)!((?:\$?[A-Za-z]{1,3}\$?[0-9]{1,5})(?::(?:\$?[A-Za-z]{1,3}\$?[0-9]{1,5}))?)$/;
+/** A user-defined name shaped like a cell reference ("A1", "$B$2", "A1:B2") is forbidden by [MS-XLS] 2.5.295's own name restrictions, since a formula using it would be indistinguishable from the reference itself. */
+const CELL_REFERENCE_NAME_RE = /^\$?[A-Za-z]{1,3}\$?[0-9]{1,5}(:\$?[A-Za-z]{1,3}\$?[0-9]{1,5})?$/;
+function parseCorner(text) {
+	const match = REFERENCE_CORNER_RE.exec(text);
+	if (match === null) return;
+	const column = columnLettersToIndex(match[2] ?? "");
+	const row = Number.parseInt(match[4] ?? "", 10) - 1;
+	if (column === void 0 || row < 0) return;
+	return {
+		row,
+		column,
+		columnAbsolute: (match[1] ?? "") === "$",
+		rowAbsolute: (match[3] ?? "") === "$"
+	};
+}
+/** BIFF8's own grid ceilings, which a defined name's reference shares with every other reference in the format. */
+const MAX_ROW_INDEX = 65535;
+const MAX_COLUMN_INDEX = 255;
+/** ColRelU's own relative bits ([MS-XLS] 2.5.198.105): bit 14 (0x4000) says the COLUMN coordinate is relative, bit 15 (0x8000) the ROW -- clear means absolute, exactly as biff/ptg.ts's pointFrom decodes them on read. */
+const COLUMN_RELATIVE_BIT = 16384;
+const ROW_RELATIVE_BIT = 32768;
+/** PtgArea3d, reference class ([MS-XLS] 2.5.198.28): opcode 0x3b, the ixti, then an RgceArea -- the same token write-side print-names.ts builds for a print name's range, since a defined name has no other way to say which sheet its reference is on. */
+function writeArea3dToken(ixti, first, last) {
+	const columnFieldOf = (corner) => corner.column | (corner.columnAbsolute ? 0 : COLUMN_RELATIVE_BIT) | (corner.rowAbsolute ? 0 : ROW_RELATIVE_BIT);
+	return new RecordBuilder().u8(59).u16(ixti).u16(first.row).u16(last.row).u16(columnFieldOf(first)).u16(columnFieldOf(last)).build();
+}
+/** Strips the single-quote wrapping a sheet label carries when the sheet name is not a bare identifier, unescaping the doubled quote inside -- the inverse of biff/ptg.ts's quoteSheetLabel. A string must actually be quoted on both ends to unwrap; a bare name is taken verbatim. */
+function unquoteSheetLabel(label) {
+	if (label.startsWith("'") && label.endsWith("'") && label.length >= 2) return label.slice(1, -1).replaceAll("''", "'");
+	return label;
+}
+/**
+* Compiles the document's defined names into the Lbl records the workbook stream carries.
+*
+* The refersTo vocabulary this writer can compile is exactly one sheet-qualified A1 reference -- `Sheet1!$A$1`, `Sheet1!$A$1:$B$2`, the sheet name quoted when it is not a bare identifier -- which is the shape every named range carries and the shape this package's own reader produces for one. A refersTo outside that vocabulary (a computed formula, a constant, an external-workbook reference) throws a BiffWriteError naming the construct rather than emitting a token stream this writer cannot prove round-trips, the identical refusal the cell-formula writer draws for the constructs outside its own vocabulary.
+*/
+function definedNameEntriesFor(names, sheets) {
+	return names.map((defined) => {
+		const builtinName = defined.name.startsWith(XLNM_PREFIX) ? builtinIndexOf(defined.name) : void 0;
+		if (builtinName === void 0) validateUserName(defined.name);
+		return {
+			name: defined.name,
+			builtinName,
+			sheetIndex: scopeOf(defined, sheets.length),
+			rgce: compileRefersTo(defined, sheets).rgce
+		};
+	});
+}
+/** Resolves an _xlnm spelling to its built-in index, refusing the two print built-ins (print-names.ts owns them -- a document stating its print area as a names entry is stating a fact the print settings already carry, and writing both would emit the same Lbl record twice) and any spelling the table does not know. */
+function builtinIndexOf(name) {
+	const index = BUILTIN_INDEX_BY_NAME.get(name);
+	if (index === void 0) throw new BiffWriteError(`xls-codec cannot write the defined name ${JSON.stringify(name)}: the "_xlnm." prefix is reserved for built-in names, and this one is not in [MS-XLS] 2.4.150's own built-in name table`);
+	if (index === BUILTIN_NAME_PRINT_AREA || index === BUILTIN_NAME_PRINT_TITLES) throw new BiffWriteError(`xls-codec cannot write the defined name ${JSON.stringify(name)}: the print built-ins are print-settings facts, stated through a sheet's printSettings (printRange/repeatRows/repeatColumns) rather than as document-level names -- writing both would emit the same Lbl record twice`);
+	return index;
+}
+/** A user-defined name must fit the record's own one-byte cch and must not be shaped like a cell reference, the one restriction of [MS-XLS] 2.5.295's own name grammar a writer can enforce without guessing at Excel's full validity table. */
+function validateUserName(name) {
+	if (name.length < 1 || name.length > 255) throw new BiffWriteError(`xls-codec cannot write a defined name of ${name.length} characters: Lbl's own cch field is one byte, so a name must be 1-255 UTF-16 code units`);
+	if (CELL_REFERENCE_NAME_RE.test(name)) throw new BiffWriteError(`xls-codec cannot write the defined name ${JSON.stringify(name)}: a name shaped like a cell reference is forbidden, since a formula using it would be indistinguishable from the reference itself`);
+}
+/** A scopeSheetIndex past the end of the document's own sheets array names a sheet that does not exist, so it is refused rather than written as an itab no BoundSheet8 answers to. */
+function scopeOf(defined, sheetCount) {
+	if (defined.scopeSheetIndex === void 0) return;
+	if (defined.scopeSheetIndex >= sheetCount) throw new BiffWriteError(`xls-codec cannot write the defined name ${JSON.stringify(defined.name)}: its scopeSheetIndex ${defined.scopeSheetIndex} is past the end of the document's own ${sheetCount}-sheet array`);
+	return defined.scopeSheetIndex;
+}
+/** Parses and compiles one entry's refersTo, throwing for anything outside the single sheet-qualified reference vocabulary documented on definedNameEntriesFor. */
+function compileRefersTo(defined, sheets) {
+	const match = SHEET_QUALIFIED_REFERENCE_RE.exec(defined.refersTo);
+	if (match === null) throw new BiffWriteError(`xls-codec cannot write the defined name ${JSON.stringify(defined.name)}: its refersTo ${JSON.stringify(defined.refersTo)} is not a sheet-qualified cell or range reference, the one vocabulary this writer compiles for a name`);
+	const sheetName = unquoteSheetLabel(match[1] ?? "");
+	const sheetIndex = sheets.findIndex((sheet) => sheet.name === sheetName);
+	if (sheetIndex === -1) throw new BiffWriteError(`xls-codec cannot write the defined name ${JSON.stringify(defined.name)}: its refersTo names the sheet ${JSON.stringify(sheetName)}, which the document's own sheets do not carry`);
+	const [firstText, lastText] = (match[2] ?? "").split(":");
+	const first = parseCorner(firstText ?? "");
+	const last = lastText === void 0 ? first : parseCorner(lastText);
+	if (first === void 0 || last === void 0) throw new BiffWriteError(`xls-codec cannot write the defined name ${JSON.stringify(defined.name)}: its refersTo ${JSON.stringify(defined.refersTo)} does not name an A1-style reference this writer can compile`);
+	if (first.row > MAX_ROW_INDEX || last.row > MAX_ROW_INDEX || first.column > MAX_COLUMN_INDEX || last.column > MAX_COLUMN_INDEX) throw new BiffWriteError(`xls-codec cannot write the defined name ${JSON.stringify(defined.name)}: its refersTo ${JSON.stringify(defined.refersTo)} reaches outside BIFF8's own grid (rows 0-${MAX_ROW_INDEX}, columns 0-${MAX_COLUMN_INDEX})`);
+	return {
+		sheetIndex,
+		rgce: writeArea3dToken(sheetIndex, first, last)
+	};
+}
+/** One Lbl record ([MS-XLS] 2.4.150) for a planned defined name, the write-side mirror of readLblRecord above: grbit carries only fBuiltin when it is set, the Name is a compressed single character for a built-in and a real XLUnicodeStringNoCch otherwise, and itab restates the entry's scope one-based. */
+function writeDefinedNameRecord(entry) {
+	const nameBytes = entry.builtinName === void 0 ? writeXLUnicodeStringNoCch(entry.name) : new RecordBuilder().u8(0).u8(entry.builtinName).build();
+	const data = new RecordBuilder().u16(entry.builtinName === void 0 ? 0 : LBL_FLAG_BUILTIN).u8(0).u8(entry.builtinName === void 0 ? entry.name.length : 1).u16(entry.rgce.length).u16(0).u16(entry.sheetIndex === void 0 ? 0 : entry.sheetIndex + 1).u32(0).bytes(nameBytes).bytes(entry.rgce).build();
+	return writeRecord(24, data);
+}
+/** Every planned defined name as its own Lbl record, in the order given. */
+function writeDefinedNameRecords(entries) {
+	return entries.map(writeDefinedNameRecord);
+}
+//#endregion
+export { definedNameEntriesFor, readDefinedNames, writeDefinedNameRecord, writeDefinedNameRecords };

package/dist/workbook/drawing.d.cts

@@ -1,5 +1,5 @@
-import { r as FormulaSheetContext } from "../ptg-75v7MhaA.cjs";
 import { n as Substream, t as RecordGroup } from "../substreams-XDNgDvRJ.cjs";
+import { r as FormulaSheetContext } from "../ptg-75v7MhaA.cjs";
 import { BlipImage } from "../drawing/blips.cjs";
 import { RawColumn, RawRow } from "./sheet.cjs";
 import { ContentEmbeddedObject, ContentSheetCell, ContentSheetImage, LayoutMetadata } from "document-schema.js";

package/dist/workbook/drawing.d.ts

@@ -1,5 +1,5 @@
-import { r as FormulaSheetContext } from "../ptg-75v7MhaA.js";
 import { n as Substream, t as RecordGroup } from "../substreams-CgTHx5kX.js";
+import { r as FormulaSheetContext } from "../ptg-75v7MhaA.js";
 import { BlipImage } from "../drawing/blips.js";
 import { RawColumn, RawRow } from "./sheet.js";
 import { ContentEmbeddedObject, ContentSheetCell, ContentSheetImage, LayoutMetadata } from "document-schema.js";

package/dist/workbook/globals-writer.cjs

@@ -2,16 +2,15 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_biff_record_types = require("../biff/record-types.cjs");
 const require_biff_builder = require("../biff/builder.cjs");
 const require_biff_record_writer = require("../biff/record-writer.cjs");
+const require_biff_font = require("../biff/font.cjs");
+const require_biff_string_writer = require("../biff/string-writer.cjs");
+const require_workbook_defined_names = require("./defined-names.cjs");
 const require_workbook_print_names = require("./print-names.cjs");
 const require_biff_bof_writer = require("../biff/bof-writer.cjs");
-const require_biff_string_writer = require("../biff/string-writer.cjs");
 const require_biff_xf_writer = require("../biff/xf-writer.cjs");
 //#region src/workbook/globals-writer.ts
 const GENERAL_FORMAT_ID = 0;
 const NORMAL_FONT_INDEX = 0;
-const NORMAL_FONT_NAME = "Arial";
-/** Excel 97-2003's own Normal-style default: 10pt, in twips (dyHeight's own unit, [MS-XLS] 2.4.122). */
-const NORMAL_FONT_HEIGHT_TWIPS = 200;
 /** [MS-XLS] "BuiltInStyle" istyBuiltIn values (ECMA-376 Part 1 18.8.7's cellStyle builtinId table): 0 Normal, 1 RowLevel, 2 ColLevel -- the only three this writer emits, since it never groups rows/columns into an outline. */
 const BUILTIN_STYLE_NORMAL = 0;
 const BUILTIN_STYLE_ROW_LEVEL = 1;
@@ -72,7 +71,7 @@ function buildWorkbookGlobals(plan) {
 		offset += piece.length;
 	};
 	push(require_biff_record_writer.writeRecord(require_biff_record_types.RECORD_BOF, require_biff_bof_writer.writeBofData(5)));
-	push(require_biff_xf_writer.writeFontRecord(NORMAL_FONT_NAME, NORMAL_FONT_HEIGHT_TWIPS));
+	for (const fields of plan.fonts) push(require_biff_font.writeFontRecord(fields));
 	for (const code of plan.customFormats) push(require_biff_xf_writer.writeFormatRecord(code.id, code.code));
 	BUILTIN_STYLES.forEach(() => {
 		push(require_biff_xf_writer.writeStyleXfRecord({
@@ -85,7 +84,7 @@ function buildWorkbookGlobals(plan) {
 		formatId: GENERAL_FORMAT_ID
 	}));
 	for (const entry of plan.cellXfEntries) push(require_biff_xf_writer.writeCellXfRecord({
-		fontIndex: NORMAL_FONT_INDEX,
+		fontIndex: entry.fontIndex,
 		formatId: entry.formatId,
 		alignment: entry.alignment,
 		verticalAlignment: entry.verticalAlignment,
@@ -105,10 +104,11 @@ function buildWorkbookGlobals(plan) {
 		lbPlyPosOffsets.push(recordStart + 4);
 		push(writeBoundSheet8Placeholder(name));
 	}
-	if (plan.printNames.length > 0) {
+	if (plan.printNames.length > 0 || plan.definedNames.length > 0) {
 		push(writeSupBookRecord(plan.sheetNames.length));
 		push(writeExternSheetRecord(plan.sheetNames.length));
 		for (const record of require_workbook_print_names.writePrintNameRecords(plan.printNames)) push(record);
+		for (const record of require_workbook_defined_names.writeDefinedNameRecords(plan.definedNames)) push(record);
 	}
 	if (plan.sharedStrings.length > 0) push(writeSstRecord(plan.sharedStrings, plan.sharedStringTotalCount));
 	push(require_biff_record_writer.writeRecord(10, /* @__PURE__ */ new Uint8Array(0)));

package/dist/workbook/globals-writer.d.cts

@@ -1,18 +1,23 @@
+import { r as XfFontFields } from "../font-CBvAGxD8.cjs";
 import { E as XfDecorationFields } from "../xf-colors-aeH9Ax3Q.cjs";
 import { t as PrintNamePlanEntry } from "../print-names-B2OR0fvs.cjs";
+import { t as DefinedNamePlanEntry } from "../defined-names-CqBJJmOJ.cjs";
 import { Alignment, Color } from "document-schema.js";
 //#region src/workbook/globals-writer.d.ts
 /** [MS-XLS] 2.1.7.20.3's own XFS production requires at least sixteen XF records before any cell can reference one: BUILTIN_STYLES.length built-in cell styles, then at least one cell XF -- the "General, no declared format" one every workbook needs unconditionally, written immediately after them. Derived from BUILTIN_STYLES's own length rather than restated as a literal, so the two can never drift apart. */
 declare const GENERAL_CELL_XF_INDEX: number;
-/** One cell XF beyond the implicit General one at GENERAL_CELL_XF_INDEX: the number-format identifier it displays through, the cell's own horizontal/vertical alignment (general/bottom, this writer's own defaults, when omitted), and -- when the cell it serves carries a background or borders -- the fill/border fields its CellXF payload packs. Undefined decoration writes the same undecorated defaults this writer always wrote before decoration existed. */
+/** One cell XF beyond the implicit General one at GENERAL_CELL_XF_INDEX: the number-format identifier it displays through, the font-table index its cell's own font resolves to (0, the Normal font, for a cell stating none), the cell's own horizontal/vertical alignment (general/bottom, this writer's own defaults, when omitted), and -- when the cell it serves carries a background or borders -- the fill/border fields its CellXF payload packs. Undefined decoration writes the same undecorated defaults this writer always wrote before decoration existed. */
 interface CellXfPlanEntry {
   readonly formatId: number;
+  readonly fontIndex: number;
   readonly alignment?: Alignment;
   readonly verticalAlignment?: "top" | "middle" | "bottom";
   readonly decoration?: XfDecorationFields;
 }
 interface WorkbookGlobalsPlan {
   readonly sheetNames: readonly string[];
+  /** The workbook's font table, in the order its Font records are written: entry 0 is always the Normal font (a cell stating no font of its own references it), and every later entry is one distinct cell font the workbook's cells actually state -- write.ts's own font-interning pass assigns those. */
+  readonly fonts: readonly XfFontFields[];
   /** Custom number-format codes needing their own Format record, each with the identifier already assigned to it (always >= 164, [MS-XLS] 2.4.126's own custom-identifier floor). A code equal to one of the built-in table's own strings needs no Format record here -- number-format.ts's BUILTIN_NUMBER_FORMATS already covers ids 0-49 for both this package's reader and any other. */
   readonly customFormats: readonly {
     readonly id: number;
@@ -26,8 +31,10 @@ interface WorkbookGlobalsPlan {
   readonly sharedStringTotalCount: number;
   /** The workbook's own custom colour table (56 entries, icv 8 first), when write.ts's own palette-interning pass decided the workbook needs one -- undefined when every decoration colour the workbook's cells use already matches the fixed default table, in which case no Palette record is written at all and those colours resolve through the default table instead ([MS-XLS] "Icv"'s own documented fallback). */
   readonly paletteColors?: readonly Color[];
-  /** The built-in Print_Area/Print_Titles defined names the workbook's sheets declare, one Lbl record each. Empty when no sheet declares a print range or a repeated header band, in which case no SupBook, ExternSheet, or Lbl record is written at all -- exactly like Palette above, a workbook that needs none stays as minimal as it always was. */
+  /** The built-in Print_Area/Print_Titles defined names the workbook's sheets declare, one Lbl record each. Empty when no sheet declares a print range or a repeated header band -- see the SupBook/ExternSheet note below for what that and `definedNames` both empty means. */
   readonly printNames: readonly PrintNamePlanEntry[];
+  /** The document-level defined names the workbook declares, one Lbl record each, from workbook/defined-names.ts's own compile of the document's names array. */
+  readonly definedNames: readonly DefinedNamePlanEntry[];
 }
 interface WorkbookGlobalsBuild {
   readonly bytes: Uint8Array<ArrayBuffer>;

package/dist/workbook/globals-writer.d.ts

@@ -1,18 +1,23 @@
+import { r as XfFontFields } from "../font-DcXHYgZ2.js";
 import { E as XfDecorationFields } from "../xf-colors-kdNsiNYt.js";
 import { t as PrintNamePlanEntry } from "../print-names-BXcmmwVi.js";
+import { t as DefinedNamePlanEntry } from "../defined-names-DJZ27hRp.js";
 import { Alignment, Color } from "document-schema.js";
 //#region src/workbook/globals-writer.d.ts
 /** [MS-XLS] 2.1.7.20.3's own XFS production requires at least sixteen XF records before any cell can reference one: BUILTIN_STYLES.length built-in cell styles, then at least one cell XF -- the "General, no declared format" one every workbook needs unconditionally, written immediately after them. Derived from BUILTIN_STYLES's own length rather than restated as a literal, so the two can never drift apart. */
 declare const GENERAL_CELL_XF_INDEX: number;
-/** One cell XF beyond the implicit General one at GENERAL_CELL_XF_INDEX: the number-format identifier it displays through, the cell's own horizontal/vertical alignment (general/bottom, this writer's own defaults, when omitted), and -- when the cell it serves carries a background or borders -- the fill/border fields its CellXF payload packs. Undefined decoration writes the same undecorated defaults this writer always wrote before decoration existed. */
+/** One cell XF beyond the implicit General one at GENERAL_CELL_XF_INDEX: the number-format identifier it displays through, the font-table index its cell's own font resolves to (0, the Normal font, for a cell stating none), the cell's own horizontal/vertical alignment (general/bottom, this writer's own defaults, when omitted), and -- when the cell it serves carries a background or borders -- the fill/border fields its CellXF payload packs. Undefined decoration writes the same undecorated defaults this writer always wrote before decoration existed. */
 interface CellXfPlanEntry {
   readonly formatId: number;
+  readonly fontIndex: number;
   readonly alignment?: Alignment;
   readonly verticalAlignment?: "top" | "middle" | "bottom";
   readonly decoration?: XfDecorationFields;
 }
 interface WorkbookGlobalsPlan {
   readonly sheetNames: readonly string[];
+  /** The workbook's font table, in the order its Font records are written: entry 0 is always the Normal font (a cell stating no font of its own references it), and every later entry is one distinct cell font the workbook's cells actually state -- write.ts's own font-interning pass assigns those. */
+  readonly fonts: readonly XfFontFields[];
   /** Custom number-format codes needing their own Format record, each with the identifier already assigned to it (always >= 164, [MS-XLS] 2.4.126's own custom-identifier floor). A code equal to one of the built-in table's own strings needs no Format record here -- number-format.ts's BUILTIN_NUMBER_FORMATS already covers ids 0-49 for both this package's reader and any other. */
   readonly customFormats: readonly {
     readonly id: number;
@@ -26,8 +31,10 @@ interface WorkbookGlobalsPlan {
   readonly sharedStringTotalCount: number;
   /** The workbook's own custom colour table (56 entries, icv 8 first), when write.ts's own palette-interning pass decided the workbook needs one -- undefined when every decoration colour the workbook's cells use already matches the fixed default table, in which case no Palette record is written at all and those colours resolve through the default table instead ([MS-XLS] "Icv"'s own documented fallback). */
   readonly paletteColors?: readonly Color[];
-  /** The built-in Print_Area/Print_Titles defined names the workbook's sheets declare, one Lbl record each. Empty when no sheet declares a print range or a repeated header band, in which case no SupBook, ExternSheet, or Lbl record is written at all -- exactly like Palette above, a workbook that needs none stays as minimal as it always was. */
+  /** The built-in Print_Area/Print_Titles defined names the workbook's sheets declare, one Lbl record each. Empty when no sheet declares a print range or a repeated header band -- see the SupBook/ExternSheet note below for what that and `definedNames` both empty means. */
   readonly printNames: readonly PrintNamePlanEntry[];
+  /** The document-level defined names the workbook declares, one Lbl record each, from workbook/defined-names.ts's own compile of the document's names array. */
+  readonly definedNames: readonly DefinedNamePlanEntry[];
 }
 interface WorkbookGlobalsBuild {
   readonly bytes: Uint8Array<ArrayBuffer>;

package/dist/workbook/globals-writer.js

@@ -1,16 +1,15 @@
 import { RECORD_BOF } from "../biff/record-types.js";
 import { RecordBuilder } from "../biff/builder.js";
 import { concatRecords, writeRecord } from "../biff/record-writer.js";
+import { writeFontRecord } from "../biff/font.js";
+import { writeRichExtendedString, writeShortXLUnicodeString } from "../biff/string-writer.js";
+import { writeDefinedNameRecords } from "./defined-names.js";
 import { writePrintNameRecords } from "./print-names.js";
 import { writeBofData } from "../biff/bof-writer.js";
-import { writeRichExtendedString, writeShortXLUnicodeString } from "../biff/string-writer.js";
-import { writeCellXfRecord, writeFontRecord, writeFormatRecord, writePaletteRecord, writeStyleRecord, writeStyleXfRecord } from "../biff/xf-writer.js";
+import { writeCellXfRecord, writeFormatRecord, writePaletteRecord, writeStyleRecord, writeStyleXfRecord } from "../biff/xf-writer.js";
 //#region src/workbook/globals-writer.ts
 const GENERAL_FORMAT_ID = 0;
 const NORMAL_FONT_INDEX = 0;
-const NORMAL_FONT_NAME = "Arial";
-/** Excel 97-2003's own Normal-style default: 10pt, in twips (dyHeight's own unit, [MS-XLS] 2.4.122). */
-const NORMAL_FONT_HEIGHT_TWIPS = 200;
 /** [MS-XLS] "BuiltInStyle" istyBuiltIn values (ECMA-376 Part 1 18.8.7's cellStyle builtinId table): 0 Normal, 1 RowLevel, 2 ColLevel -- the only three this writer emits, since it never groups rows/columns into an outline. */
 const BUILTIN_STYLE_NORMAL = 0;
 const BUILTIN_STYLE_ROW_LEVEL = 1;
@@ -71,7 +70,7 @@ function buildWorkbookGlobals(plan) {
 		offset += piece.length;
 	};
 	push(writeRecord(RECORD_BOF, writeBofData(5)));
-	push(writeFontRecord(NORMAL_FONT_NAME, NORMAL_FONT_HEIGHT_TWIPS));
+	for (const fields of plan.fonts) push(writeFontRecord(fields));
 	for (const code of plan.customFormats) push(writeFormatRecord(code.id, code.code));
 	BUILTIN_STYLES.forEach(() => {
 		push(writeStyleXfRecord({
@@ -84,7 +83,7 @@ function buildWorkbookGlobals(plan) {
 		formatId: GENERAL_FORMAT_ID
 	}));
 	for (const entry of plan.cellXfEntries) push(writeCellXfRecord({
-		fontIndex: NORMAL_FONT_INDEX,
+		fontIndex: entry.fontIndex,
 		formatId: entry.formatId,
 		alignment: entry.alignment,
 		verticalAlignment: entry.verticalAlignment,
@@ -104,10 +103,11 @@ function buildWorkbookGlobals(plan) {
 		lbPlyPosOffsets.push(recordStart + 4);
 		push(writeBoundSheet8Placeholder(name));
 	}
-	if (plan.printNames.length > 0) {
+	if (plan.printNames.length > 0 || plan.definedNames.length > 0) {
 		push(writeSupBookRecord(plan.sheetNames.length));
 		push(writeExternSheetRecord(plan.sheetNames.length));
 		for (const record of writePrintNameRecords(plan.printNames)) push(record);
+		for (const record of writeDefinedNameRecords(plan.definedNames)) push(record);
 	}
 	if (plan.sharedStrings.length > 0) push(writeSstRecord(plan.sharedStrings, plan.sharedStringTotalCount));
 	push(writeRecord(10, /* @__PURE__ */ new Uint8Array(0)));