xls-codec 1.0.2 → 2.0.0

package/dist/index.cjs

@@ -2,31 +2,47 @@ 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_container = require("./container.cjs");
+const require_units = require("./units.cjs");
 const require_biff_substreams = require("./biff/substreams.cjs");
-const require_number_format = require("./number-format.cjs");
+const require_biff_write_errors = require("./biff/write-errors.cjs");
 const require_serial = require("./serial.cjs");
 const require_biff_cursor = require("./biff/cursor.cjs");
 const require_biff_strings = require("./biff/strings.cjs");
+const require_biff_builder = require("./biff/builder.cjs");
+const require_biff_record_writer = require("./biff/record-writer.cjs");
 const require_workbook_globals = require("./workbook/globals.cjs");
 const require_biff_errors = require("./biff/errors.cjs");
 const require_biff_rk = require("./biff/rk.cjs");
-const require_units = require("./units.cjs");
 const require_workbook_sheet = require("./workbook/sheet.cjs");
 const require_content = require("./content.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");
+const require_metadata = require("./metadata.cjs");
+const require_workbook_globals_writer = require("./workbook/globals-writer.cjs");
+const require_workbook_sheet_writer = require("./workbook/sheet-writer.cjs");
+const require_write = require("./write.cjs");
 exports.BIFF8_VERSION = require_biff_record_types.BIFF8_VERSION;
 exports.BOF_TYPE_CHART = require_biff_record_types.BOF_TYPE_CHART;
 exports.BOF_TYPE_MACRO = require_biff_record_types.BOF_TYPE_MACRO;
 exports.BOF_TYPE_WORKBOOK = require_biff_record_types.BOF_TYPE_WORKBOOK;
 exports.BOF_TYPE_WORKSHEET = require_biff_record_types.BOF_TYPE_WORKSHEET;
-exports.BUILTIN_NUMBER_FORMATS = require_number_format.BUILTIN_NUMBER_FORMATS;
 exports.BiffFormatError = require_biff_records.BiffFormatError;
+exports.BiffWriteError = require_biff_write_errors.BiffWriteError;
 exports.BlockCursor = require_biff_cursor.BlockCursor;
+exports.GENERAL_CELL_XF_INDEX = require_workbook_globals_writer.GENERAL_CELL_XF_INDEX;
 exports.MAX_RECORD_DATA_SIZE = require_biff_record_types.MAX_RECORD_DATA_SIZE;
 exports.RECORD_ARRAY = require_biff_record_types.RECORD_ARRAY;
 exports.RECORD_BLANK = require_biff_record_types.RECORD_BLANK;
 exports.RECORD_BOF = require_biff_record_types.RECORD_BOF;
 exports.RECORD_BOOLERR = require_biff_record_types.RECORD_BOOLERR;
+exports.RECORD_BOTTOMMARGIN = require_biff_record_types.RECORD_BOTTOMMARGIN;
 exports.RECORD_BOUNDSHEET8 = require_biff_record_types.RECORD_BOUNDSHEET8;
+exports.RECORD_CALCCOUNT = require_biff_record_types.RECORD_CALCCOUNT;
+exports.RECORD_CALCDELTA = require_biff_record_types.RECORD_CALCDELTA;
+exports.RECORD_CALCITER = require_biff_record_types.RECORD_CALCITER;
+exports.RECORD_CALCREFMODE = require_biff_record_types.RECORD_CALCREFMODE;
+exports.RECORD_CALCSAVERECALC = require_biff_record_types.RECORD_CALCSAVERECALC;
 exports.RECORD_COLINFO = require_biff_record_types.RECORD_COLINFO;
 exports.RECORD_CONTINUE = require_biff_record_types.RECORD_CONTINUE;
 exports.RECORD_DATE1904 = require_biff_record_types.RECORD_DATE1904;
@@ -34,36 +50,64 @@ exports.RECORD_DEFAULTROWHEIGHT = require_biff_record_types.RECORD_DEFAULTROWHEI
 exports.RECORD_DEFCOLWIDTH = require_biff_record_types.RECORD_DEFCOLWIDTH;
 exports.RECORD_DIMENSIONS = require_biff_record_types.RECORD_DIMENSIONS;
 exports.RECORD_EOF = require_biff_record_types.RECORD_EOF;
+exports.RECORD_EXTERNSHEET = require_biff_record_types.RECORD_EXTERNSHEET;
 exports.RECORD_FILEPASS = require_biff_record_types.RECORD_FILEPASS;
 exports.RECORD_FONT = require_biff_record_types.RECORD_FONT;
 exports.RECORD_FORMAT = require_biff_record_types.RECORD_FORMAT;
 exports.RECORD_FORMULA = require_biff_record_types.RECORD_FORMULA;
+exports.RECORD_HORIZONTALPAGEBREAKS = require_biff_record_types.RECORD_HORIZONTALPAGEBREAKS;
 exports.RECORD_LABEL = require_biff_record_types.RECORD_LABEL;
 exports.RECORD_LABELSST = require_biff_record_types.RECORD_LABELSST;
+exports.RECORD_LBL = require_biff_record_types.RECORD_LBL;
+exports.RECORD_LEFTMARGIN = require_biff_record_types.RECORD_LEFTMARGIN;
 exports.RECORD_MERGECELLS = require_biff_record_types.RECORD_MERGECELLS;
 exports.RECORD_MULBLANK = require_biff_record_types.RECORD_MULBLANK;
 exports.RECORD_MULRK = require_biff_record_types.RECORD_MULRK;
 exports.RECORD_NUMBER = require_biff_record_types.RECORD_NUMBER;
+exports.RECORD_PALETTE = require_biff_record_types.RECORD_PALETTE;
+exports.RECORD_PRINTGRID = require_biff_record_types.RECORD_PRINTGRID;
+exports.RECORD_PRINTROWCOL = require_biff_record_types.RECORD_PRINTROWCOL;
+exports.RECORD_RIGHTMARGIN = require_biff_record_types.RECORD_RIGHTMARGIN;
 exports.RECORD_RK = require_biff_record_types.RECORD_RK;
 exports.RECORD_ROW = require_biff_record_types.RECORD_ROW;
+exports.RECORD_SETUP = require_biff_record_types.RECORD_SETUP;
 exports.RECORD_SHRFMLA = require_biff_record_types.RECORD_SHRFMLA;
 exports.RECORD_SST = require_biff_record_types.RECORD_SST;
 exports.RECORD_STRING = require_biff_record_types.RECORD_STRING;
+exports.RECORD_STYLE = require_biff_record_types.RECORD_STYLE;
+exports.RECORD_SUPBOOK = require_biff_record_types.RECORD_SUPBOOK;
 exports.RECORD_TABLE = require_biff_record_types.RECORD_TABLE;
+exports.RECORD_TOPMARGIN = require_biff_record_types.RECORD_TOPMARGIN;
+exports.RECORD_VERTICALPAGEBREAKS = require_biff_record_types.RECORD_VERTICALPAGEBREAKS;
+exports.RECORD_WSBOOL = require_biff_record_types.RECORD_WSBOOL;
 exports.RECORD_XF = require_biff_record_types.RECORD_XF;
-exports.classifyNumberFormat = require_number_format.classifyNumberFormat;
+exports.RecordBuilder = require_biff_builder.RecordBuilder;
+exports.SUMMARY_INFORMATION_STREAM = require_container.SUMMARY_INFORMATION_STREAM;
+exports.buildWorkbookGlobals = require_workbook_globals_writer.buildWorkbookGlobals;
+exports.buildWorksheetSubstream = require_workbook_sheet_writer.buildWorksheetSubstream;
 exports.columnWidthToPoints = require_units.columnWidthToPoints;
+exports.concatRecords = require_biff_record_writer.concatRecords;
 exports.decodeRkNumber = require_biff_rk.decodeRkNumber;
+exports.errorCodeOf = require_biff_errors.errorCodeOf;
 exports.errorTextOf = require_biff_errors.errorTextOf;
 exports.formatCodeOf = require_workbook_globals.formatCodeOf;
 exports.groupRecords = require_biff_substreams.groupRecords;
+exports.inchesToPoints = require_units.inchesToPoints;
 exports.isXlsFile = require_container.isXlsFile;
+exports.isoDateTimeToSerial = require_serial.isoDateTimeToSerial;
+exports.isoDateToSerial = require_serial.isoDateToSerial;
+exports.isoTimeToSerial = require_serial.isoTimeToSerial;
+exports.layoutMetadataToSummaryInformation = require_metadata.layoutMetadataToSummaryInformation;
+exports.millimetresToPoints = require_units.millimetresToPoints;
+exports.pointsToColumnWidth = require_units.pointsToColumnWidth;
+exports.pointsToInches = require_units.pointsToInches;
+exports.pointsToTwips = require_units.pointsToTwips;
 exports.readRecords = require_biff_records.readRecords;
 exports.readRichExtendedString = require_biff_strings.readRichExtendedString;
 exports.readSheetRecords = require_workbook_sheet.readSheetRecords;
 exports.readShortXLUnicodeString = require_biff_strings.readShortXLUnicodeString;
 exports.readWorkbookGlobals = require_workbook_globals.readWorkbookGlobals;
-exports.readWorkbookStream = require_container.readWorkbookStream;
+exports.readWorkbookStreams = require_container.readWorkbookStreams;
 exports.readXLUnicodeString = require_biff_strings.readXLUnicodeString;
 exports.readXls = require_content.readXls;
 exports.readXlsContent = require_content.readXlsContent;
@@ -72,3 +116,25 @@ exports.serialToIsoDateTime = require_serial.serialToIsoDateTime;
 exports.serialToIsoTime = require_serial.serialToIsoTime;
 exports.splitSubstreams = require_biff_substreams.splitSubstreams;
 exports.twipsToPoints = require_units.twipsToPoints;
+exports.writeBofData = require_biff_bof_writer.writeBofData;
+exports.writeCellXfRecord = require_biff_xf_writer.writeCellXfRecord;
+exports.writeFontRecord = require_biff_xf_writer.writeFontRecord;
+exports.writeFormatRecord = require_biff_xf_writer.writeFormatRecord;
+exports.writePaletteRecord = require_biff_xf_writer.writePaletteRecord;
+exports.writeRecord = require_biff_record_writer.writeRecord;
+exports.writeRichExtendedString = require_biff_string_writer.writeRichExtendedString;
+exports.writeShortXLUnicodeString = require_biff_string_writer.writeShortXLUnicodeString;
+exports.writeStyleRecord = require_biff_xf_writer.writeStyleRecord;
+exports.writeStyleXfRecord = require_biff_xf_writer.writeStyleXfRecord;
+exports.writeXLUnicodeString = require_biff_string_writer.writeXLUnicodeString;
+exports.writeXls = require_write.writeXls;
+exports.writeXlsContent = require_write.writeXlsContent;
+var excel_number_format = require("excel-number-format");
+Object.keys(excel_number_format).forEach(function(k) {
+	if (k !== "default" && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
+		enumerable: true,
+		get: function() {
+			return excel_number_format[k];
+		}
+	});
+});

package/dist/index.d.cts

@@ -1,15 +1,25 @@
-import { BlockCursor } from "./biff/cursor.cjs";
-import { errorTextOf } from "./biff/errors.cjs";
-import { BIFF8_VERSION, BOF_TYPE_CHART, BOF_TYPE_MACRO, BOF_TYPE_WORKBOOK, BOF_TYPE_WORKSHEET, MAX_RECORD_DATA_SIZE, RECORD_ARRAY, RECORD_BLANK, RECORD_BOF, RECORD_BOOLERR, RECORD_BOUNDSHEET8, RECORD_COLINFO, RECORD_CONTINUE, RECORD_DATE1904, RECORD_DEFAULTROWHEIGHT, RECORD_DEFCOLWIDTH, RECORD_DIMENSIONS, RECORD_EOF, RECORD_FILEPASS, RECORD_FONT, RECORD_FORMAT, RECORD_FORMULA, RECORD_LABEL, RECORD_LABELSST, RECORD_MERGECELLS, RECORD_MULBLANK, RECORD_MULRK, RECORD_NUMBER, RECORD_RK, RECORD_ROW, RECORD_SHRFMLA, RECORD_SST, RECORD_STRING, RECORD_TABLE, RECORD_XF } from "./biff/record-types.cjs";
+import { writeBofData } from "./biff/bof-writer.cjs";
+import { RecordBuilder } from "./biff/builder.cjs";
+import { t as BlockCursor } from "./cursor-VMtw9uVP.cjs";
+import { errorCodeOf, errorTextOf } from "./biff/errors.cjs";
+import { BIFF8_VERSION, BOF_TYPE_CHART, BOF_TYPE_MACRO, BOF_TYPE_WORKBOOK, BOF_TYPE_WORKSHEET, MAX_RECORD_DATA_SIZE, RECORD_ARRAY, RECORD_BLANK, RECORD_BOF, RECORD_BOOLERR, RECORD_BOTTOMMARGIN, RECORD_BOUNDSHEET8, RECORD_CALCCOUNT, RECORD_CALCDELTA, RECORD_CALCITER, RECORD_CALCREFMODE, RECORD_CALCSAVERECALC, RECORD_COLINFO, RECORD_CONTINUE, RECORD_DATE1904, RECORD_DEFAULTROWHEIGHT, RECORD_DEFCOLWIDTH, RECORD_DIMENSIONS, RECORD_EOF, RECORD_EXTERNSHEET, RECORD_FILEPASS, RECORD_FONT, RECORD_FORMAT, RECORD_FORMULA, RECORD_HORIZONTALPAGEBREAKS, RECORD_LABEL, RECORD_LABELSST, RECORD_LBL, RECORD_LEFTMARGIN, RECORD_MERGECELLS, RECORD_MULBLANK, RECORD_MULRK, RECORD_NUMBER, RECORD_PALETTE, RECORD_PRINTGRID, RECORD_PRINTROWCOL, RECORD_RIGHTMARGIN, RECORD_RK, RECORD_ROW, RECORD_SETUP, RECORD_SHRFMLA, RECORD_SST, RECORD_STRING, RECORD_STYLE, RECORD_SUPBOOK, RECORD_TABLE, RECORD_TOPMARGIN, RECORD_VERTICALPAGEBREAKS, RECORD_WSBOOL, RECORD_XF } from "./biff/record-types.cjs";
+import { concatRecords, writeRecord } from "./biff/record-writer.cjs";
 import { n as BiffRecord, r as readRecords, t as BiffFormatError } from "./records-DVIqXFKk.cjs";
 import { decodeRkNumber } from "./biff/rk.cjs";
+import { writeRichExtendedString, writeShortXLUnicodeString, writeXLUnicodeString } from "./biff/string-writer.cjs";
 import { readRichExtendedString, readShortXLUnicodeString, readXLUnicodeString } from "./biff/strings.cjs";
-import { RecordGroup, Substream, groupRecords, splitSubstreams } from "./biff/substreams.cjs";
-import { isXlsFile, readWorkbookStream } from "./container.cjs";
+import { i as splitSubstreams, n as Substream, r as groupRecords, t as RecordGroup } from "./substreams-Ddtvn_Vr.cjs";
+import { BiffWriteError } from "./biff/write-errors.cjs";
+import { writeCellXfRecord, writeFontRecord, writeFormatRecord, writePaletteRecord, writeStyleRecord, writeStyleXfRecord } from "./biff/xf-writer.cjs";
+import { SUMMARY_INFORMATION_STREAM, WorkbookStreams, isXlsFile, readWorkbookStreams } from "./container.cjs";
 import { XlsContentDocument, readXls, readXlsContent } from "./content.cjs";
-import { BUILTIN_NUMBER_FORMATS, NumberFormatClass, classifyNumberFormat } from "./number-format.cjs";
-import { serialToIsoDate, serialToIsoDateTime, serialToIsoTime } from "./serial.cjs";
-import { columnWidthToPoints, twipsToPoints } from "./units.cjs";
+import { layoutMetadataToSummaryInformation } from "./metadata.cjs";
+import { isoDateTimeToSerial, isoDateToSerial, isoTimeToSerial, serialToIsoDate, serialToIsoDateTime, serialToIsoTime } from "./serial.cjs";
+import { columnWidthToPoints, inchesToPoints, millimetresToPoints, pointsToColumnWidth, pointsToInches, pointsToTwips, twipsToPoints } from "./units.cjs";
 import { CellFormat, SheetEntry, WorkbookGlobals, formatCodeOf, readWorkbookGlobals } from "./workbook/globals.cjs";
-import { RawCell, RawCellValue, RawColumn, RawRange, RawRow, RawSheet, readSheetRecords } from "./workbook/sheet.cjs";
-export { BIFF8_VERSION, BOF_TYPE_CHART, BOF_TYPE_MACRO, BOF_TYPE_WORKBOOK, BOF_TYPE_WORKSHEET, BUILTIN_NUMBER_FORMATS, BiffFormatError, BiffRecord, BlockCursor, CellFormat, MAX_RECORD_DATA_SIZE, NumberFormatClass, RECORD_ARRAY, RECORD_BLANK, RECORD_BOF, RECORD_BOOLERR, RECORD_BOUNDSHEET8, RECORD_COLINFO, RECORD_CONTINUE, RECORD_DATE1904, RECORD_DEFAULTROWHEIGHT, RECORD_DEFCOLWIDTH, RECORD_DIMENSIONS, RECORD_EOF, RECORD_FILEPASS, RECORD_FONT, RECORD_FORMAT, RECORD_FORMULA, RECORD_LABEL, RECORD_LABELSST, RECORD_MERGECELLS, RECORD_MULBLANK, RECORD_MULRK, RECORD_NUMBER, RECORD_RK, RECORD_ROW, RECORD_SHRFMLA, RECORD_SST, RECORD_STRING, RECORD_TABLE, RECORD_XF, RawCell, RawCellValue, RawColumn, RawRange, RawRow, RawSheet, RecordGroup, SheetEntry, Substream, WorkbookGlobals, XlsContentDocument, classifyNumberFormat, columnWidthToPoints, decodeRkNumber, errorTextOf, formatCodeOf, groupRecords, isXlsFile, readRecords, readRichExtendedString, readSheetRecords, readShortXLUnicodeString, readWorkbookGlobals, readWorkbookStream, readXLUnicodeString, readXls, readXlsContent, serialToIsoDate, serialToIsoDateTime, serialToIsoTime, splitSubstreams, twipsToPoints };
+import { CellXfPlanEntry, GENERAL_CELL_XF_INDEX, WorkbookGlobalsBuild, WorkbookGlobalsPlan, buildWorkbookGlobals } from "./workbook/globals-writer.cjs";
+import { RawCell, RawCellValue, RawColumn, RawPrintSettings, RawRange, RawRow, RawSheet, readSheetRecords } from "./workbook/sheet.cjs";
+import { SheetWriteContext, buildWorksheetSubstream } from "./workbook/sheet-writer.cjs";
+import { writeXls, writeXlsContent } from "./write.cjs";
+export * from "excel-number-format";
+export { BIFF8_VERSION, BOF_TYPE_CHART, BOF_TYPE_MACRO, BOF_TYPE_WORKBOOK, BOF_TYPE_WORKSHEET, BiffFormatError, BiffRecord, BiffWriteError, BlockCursor, CellFormat, CellXfPlanEntry, GENERAL_CELL_XF_INDEX, MAX_RECORD_DATA_SIZE, RECORD_ARRAY, RECORD_BLANK, RECORD_BOF, RECORD_BOOLERR, RECORD_BOTTOMMARGIN, RECORD_BOUNDSHEET8, RECORD_CALCCOUNT, RECORD_CALCDELTA, RECORD_CALCITER, RECORD_CALCREFMODE, RECORD_CALCSAVERECALC, RECORD_COLINFO, RECORD_CONTINUE, RECORD_DATE1904, RECORD_DEFAULTROWHEIGHT, RECORD_DEFCOLWIDTH, RECORD_DIMENSIONS, RECORD_EOF, RECORD_EXTERNSHEET, RECORD_FILEPASS, RECORD_FONT, RECORD_FORMAT, RECORD_FORMULA, RECORD_HORIZONTALPAGEBREAKS, RECORD_LABEL, RECORD_LABELSST, RECORD_LBL, RECORD_LEFTMARGIN, RECORD_MERGECELLS, RECORD_MULBLANK, RECORD_MULRK, RECORD_NUMBER, RECORD_PALETTE, RECORD_PRINTGRID, RECORD_PRINTROWCOL, RECORD_RIGHTMARGIN, RECORD_RK, RECORD_ROW, RECORD_SETUP, RECORD_SHRFMLA, RECORD_SST, RECORD_STRING, RECORD_STYLE, RECORD_SUPBOOK, RECORD_TABLE, RECORD_TOPMARGIN, RECORD_VERTICALPAGEBREAKS, RECORD_WSBOOL, RECORD_XF, RawCell, RawCellValue, RawColumn, RawPrintSettings, RawRange, RawRow, RawSheet, RecordBuilder, RecordGroup, SUMMARY_INFORMATION_STREAM, SheetEntry, SheetWriteContext, Substream, WorkbookGlobals, WorkbookGlobalsBuild, WorkbookGlobalsPlan, WorkbookStreams, XlsContentDocument, buildWorkbookGlobals, buildWorksheetSubstream, columnWidthToPoints, concatRecords, decodeRkNumber, errorCodeOf, errorTextOf, formatCodeOf, groupRecords, inchesToPoints, isXlsFile, isoDateTimeToSerial, isoDateToSerial, isoTimeToSerial, layoutMetadataToSummaryInformation, millimetresToPoints, pointsToColumnWidth, pointsToInches, pointsToTwips, readRecords, readRichExtendedString, readSheetRecords, readShortXLUnicodeString, readWorkbookGlobals, readWorkbookStreams, readXLUnicodeString, readXls, readXlsContent, serialToIsoDate, serialToIsoDateTime, serialToIsoTime, splitSubstreams, twipsToPoints, writeBofData, writeCellXfRecord, writeFontRecord, writeFormatRecord, writePaletteRecord, writeRecord, writeRichExtendedString, writeShortXLUnicodeString, writeStyleRecord, writeStyleXfRecord, writeXLUnicodeString, writeXls, writeXlsContent };

package/dist/index.d.ts

@@ -1,15 +1,25 @@
-import { BlockCursor } from "./biff/cursor.js";
-import { errorTextOf } from "./biff/errors.js";
-import { BIFF8_VERSION, BOF_TYPE_CHART, BOF_TYPE_MACRO, BOF_TYPE_WORKBOOK, BOF_TYPE_WORKSHEET, MAX_RECORD_DATA_SIZE, RECORD_ARRAY, RECORD_BLANK, RECORD_BOF, RECORD_BOOLERR, RECORD_BOUNDSHEET8, RECORD_COLINFO, RECORD_CONTINUE, RECORD_DATE1904, RECORD_DEFAULTROWHEIGHT, RECORD_DEFCOLWIDTH, RECORD_DIMENSIONS, RECORD_EOF, RECORD_FILEPASS, RECORD_FONT, RECORD_FORMAT, RECORD_FORMULA, RECORD_LABEL, RECORD_LABELSST, RECORD_MERGECELLS, RECORD_MULBLANK, RECORD_MULRK, RECORD_NUMBER, RECORD_RK, RECORD_ROW, RECORD_SHRFMLA, RECORD_SST, RECORD_STRING, RECORD_TABLE, RECORD_XF } from "./biff/record-types.js";
+import { writeBofData } from "./biff/bof-writer.js";
+import { RecordBuilder } from "./biff/builder.js";
+import { t as BlockCursor } from "./cursor-VMtw9uVP.js";
+import { errorCodeOf, errorTextOf } from "./biff/errors.js";
+import { BIFF8_VERSION, BOF_TYPE_CHART, BOF_TYPE_MACRO, BOF_TYPE_WORKBOOK, BOF_TYPE_WORKSHEET, MAX_RECORD_DATA_SIZE, RECORD_ARRAY, RECORD_BLANK, RECORD_BOF, RECORD_BOOLERR, RECORD_BOTTOMMARGIN, RECORD_BOUNDSHEET8, RECORD_CALCCOUNT, RECORD_CALCDELTA, RECORD_CALCITER, RECORD_CALCREFMODE, RECORD_CALCSAVERECALC, RECORD_COLINFO, RECORD_CONTINUE, RECORD_DATE1904, RECORD_DEFAULTROWHEIGHT, RECORD_DEFCOLWIDTH, RECORD_DIMENSIONS, RECORD_EOF, RECORD_EXTERNSHEET, RECORD_FILEPASS, RECORD_FONT, RECORD_FORMAT, RECORD_FORMULA, RECORD_HORIZONTALPAGEBREAKS, RECORD_LABEL, RECORD_LABELSST, RECORD_LBL, RECORD_LEFTMARGIN, RECORD_MERGECELLS, RECORD_MULBLANK, RECORD_MULRK, RECORD_NUMBER, RECORD_PALETTE, RECORD_PRINTGRID, RECORD_PRINTROWCOL, RECORD_RIGHTMARGIN, RECORD_RK, RECORD_ROW, RECORD_SETUP, RECORD_SHRFMLA, RECORD_SST, RECORD_STRING, RECORD_STYLE, RECORD_SUPBOOK, RECORD_TABLE, RECORD_TOPMARGIN, RECORD_VERTICALPAGEBREAKS, RECORD_WSBOOL, RECORD_XF } from "./biff/record-types.js";
+import { concatRecords, writeRecord } from "./biff/record-writer.js";
 import { n as BiffRecord, r as readRecords, t as BiffFormatError } from "./records-DVIqXFKk.js";
 import { decodeRkNumber } from "./biff/rk.js";
+import { writeRichExtendedString, writeShortXLUnicodeString, writeXLUnicodeString } from "./biff/string-writer.js";
 import { readRichExtendedString, readShortXLUnicodeString, readXLUnicodeString } from "./biff/strings.js";
-import { RecordGroup, Substream, groupRecords, splitSubstreams } from "./biff/substreams.js";
-import { isXlsFile, readWorkbookStream } from "./container.js";
+import { i as splitSubstreams, n as Substream, r as groupRecords, t as RecordGroup } from "./substreams-D7dQiJbp.js";
+import { BiffWriteError } from "./biff/write-errors.js";
+import { writeCellXfRecord, writeFontRecord, writeFormatRecord, writePaletteRecord, writeStyleRecord, writeStyleXfRecord } from "./biff/xf-writer.js";
+import { SUMMARY_INFORMATION_STREAM, WorkbookStreams, isXlsFile, readWorkbookStreams } from "./container.js";
 import { XlsContentDocument, readXls, readXlsContent } from "./content.js";
-import { BUILTIN_NUMBER_FORMATS, NumberFormatClass, classifyNumberFormat } from "./number-format.js";
-import { serialToIsoDate, serialToIsoDateTime, serialToIsoTime } from "./serial.js";
-import { columnWidthToPoints, twipsToPoints } from "./units.js";
+import { layoutMetadataToSummaryInformation } from "./metadata.js";
+import { isoDateTimeToSerial, isoDateToSerial, isoTimeToSerial, serialToIsoDate, serialToIsoDateTime, serialToIsoTime } from "./serial.js";
+import { columnWidthToPoints, inchesToPoints, millimetresToPoints, pointsToColumnWidth, pointsToInches, pointsToTwips, twipsToPoints } from "./units.js";
 import { CellFormat, SheetEntry, WorkbookGlobals, formatCodeOf, readWorkbookGlobals } from "./workbook/globals.js";
-import { RawCell, RawCellValue, RawColumn, RawRange, RawRow, RawSheet, readSheetRecords } from "./workbook/sheet.js";
-export { BIFF8_VERSION, BOF_TYPE_CHART, BOF_TYPE_MACRO, BOF_TYPE_WORKBOOK, BOF_TYPE_WORKSHEET, BUILTIN_NUMBER_FORMATS, BiffFormatError, BiffRecord, BlockCursor, CellFormat, MAX_RECORD_DATA_SIZE, NumberFormatClass, RECORD_ARRAY, RECORD_BLANK, RECORD_BOF, RECORD_BOOLERR, RECORD_BOUNDSHEET8, RECORD_COLINFO, RECORD_CONTINUE, RECORD_DATE1904, RECORD_DEFAULTROWHEIGHT, RECORD_DEFCOLWIDTH, RECORD_DIMENSIONS, RECORD_EOF, RECORD_FILEPASS, RECORD_FONT, RECORD_FORMAT, RECORD_FORMULA, RECORD_LABEL, RECORD_LABELSST, RECORD_MERGECELLS, RECORD_MULBLANK, RECORD_MULRK, RECORD_NUMBER, RECORD_RK, RECORD_ROW, RECORD_SHRFMLA, RECORD_SST, RECORD_STRING, RECORD_TABLE, RECORD_XF, RawCell, RawCellValue, RawColumn, RawRange, RawRow, RawSheet, RecordGroup, SheetEntry, Substream, WorkbookGlobals, XlsContentDocument, classifyNumberFormat, columnWidthToPoints, decodeRkNumber, errorTextOf, formatCodeOf, groupRecords, isXlsFile, readRecords, readRichExtendedString, readSheetRecords, readShortXLUnicodeString, readWorkbookGlobals, readWorkbookStream, readXLUnicodeString, readXls, readXlsContent, serialToIsoDate, serialToIsoDateTime, serialToIsoTime, splitSubstreams, twipsToPoints };
+import { CellXfPlanEntry, GENERAL_CELL_XF_INDEX, WorkbookGlobalsBuild, WorkbookGlobalsPlan, buildWorkbookGlobals } from "./workbook/globals-writer.js";
+import { RawCell, RawCellValue, RawColumn, RawPrintSettings, RawRange, RawRow, RawSheet, readSheetRecords } from "./workbook/sheet.js";
+import { SheetWriteContext, buildWorksheetSubstream } from "./workbook/sheet-writer.js";
+import { writeXls, writeXlsContent } from "./write.js";
+export * from "excel-number-format";
+export { BIFF8_VERSION, BOF_TYPE_CHART, BOF_TYPE_MACRO, BOF_TYPE_WORKBOOK, BOF_TYPE_WORKSHEET, BiffFormatError, BiffRecord, BiffWriteError, BlockCursor, CellFormat, CellXfPlanEntry, GENERAL_CELL_XF_INDEX, MAX_RECORD_DATA_SIZE, RECORD_ARRAY, RECORD_BLANK, RECORD_BOF, RECORD_BOOLERR, RECORD_BOTTOMMARGIN, RECORD_BOUNDSHEET8, RECORD_CALCCOUNT, RECORD_CALCDELTA, RECORD_CALCITER, RECORD_CALCREFMODE, RECORD_CALCSAVERECALC, RECORD_COLINFO, RECORD_CONTINUE, RECORD_DATE1904, RECORD_DEFAULTROWHEIGHT, RECORD_DEFCOLWIDTH, RECORD_DIMENSIONS, RECORD_EOF, RECORD_EXTERNSHEET, RECORD_FILEPASS, RECORD_FONT, RECORD_FORMAT, RECORD_FORMULA, RECORD_HORIZONTALPAGEBREAKS, RECORD_LABEL, RECORD_LABELSST, RECORD_LBL, RECORD_LEFTMARGIN, RECORD_MERGECELLS, RECORD_MULBLANK, RECORD_MULRK, RECORD_NUMBER, RECORD_PALETTE, RECORD_PRINTGRID, RECORD_PRINTROWCOL, RECORD_RIGHTMARGIN, RECORD_RK, RECORD_ROW, RECORD_SETUP, RECORD_SHRFMLA, RECORD_SST, RECORD_STRING, RECORD_STYLE, RECORD_SUPBOOK, RECORD_TABLE, RECORD_TOPMARGIN, RECORD_VERTICALPAGEBREAKS, RECORD_WSBOOL, RECORD_XF, RawCell, RawCellValue, RawColumn, RawPrintSettings, RawRange, RawRow, RawSheet, RecordBuilder, RecordGroup, SUMMARY_INFORMATION_STREAM, SheetEntry, SheetWriteContext, Substream, WorkbookGlobals, WorkbookGlobalsBuild, WorkbookGlobalsPlan, WorkbookStreams, XlsContentDocument, buildWorkbookGlobals, buildWorksheetSubstream, columnWidthToPoints, concatRecords, decodeRkNumber, errorCodeOf, errorTextOf, formatCodeOf, groupRecords, inchesToPoints, isXlsFile, isoDateTimeToSerial, isoDateToSerial, isoTimeToSerial, layoutMetadataToSummaryInformation, millimetresToPoints, pointsToColumnWidth, pointsToInches, pointsToTwips, readRecords, readRichExtendedString, readSheetRecords, readShortXLUnicodeString, readWorkbookGlobals, readWorkbookStreams, readXLUnicodeString, readXls, readXlsContent, serialToIsoDate, serialToIsoDateTime, serialToIsoTime, splitSubstreams, twipsToPoints, writeBofData, writeCellXfRecord, writeFontRecord, writeFormatRecord, writePaletteRecord, writeRecord, writeRichExtendedString, writeShortXLUnicodeString, writeStyleRecord, writeStyleXfRecord, writeXLUnicodeString, writeXls, writeXlsContent };

package/dist/index.js

@@ -1,15 +1,25 @@
-import { BIFF8_VERSION, BOF_TYPE_CHART, BOF_TYPE_MACRO, BOF_TYPE_WORKBOOK, BOF_TYPE_WORKSHEET, MAX_RECORD_DATA_SIZE, RECORD_ARRAY, RECORD_BLANK, RECORD_BOF, RECORD_BOOLERR, RECORD_BOUNDSHEET8, RECORD_COLINFO, RECORD_CONTINUE, RECORD_DATE1904, RECORD_DEFAULTROWHEIGHT, RECORD_DEFCOLWIDTH, RECORD_DIMENSIONS, RECORD_EOF, RECORD_FILEPASS, RECORD_FONT, RECORD_FORMAT, RECORD_FORMULA, RECORD_LABEL, RECORD_LABELSST, RECORD_MERGECELLS, RECORD_MULBLANK, RECORD_MULRK, RECORD_NUMBER, RECORD_RK, RECORD_ROW, RECORD_SHRFMLA, RECORD_SST, RECORD_STRING, RECORD_TABLE, RECORD_XF } from "./biff/record-types.js";
+import { BIFF8_VERSION, BOF_TYPE_CHART, BOF_TYPE_MACRO, BOF_TYPE_WORKBOOK, BOF_TYPE_WORKSHEET, MAX_RECORD_DATA_SIZE, RECORD_ARRAY, RECORD_BLANK, RECORD_BOF, RECORD_BOOLERR, RECORD_BOTTOMMARGIN, RECORD_BOUNDSHEET8, RECORD_CALCCOUNT, RECORD_CALCDELTA, RECORD_CALCITER, RECORD_CALCREFMODE, RECORD_CALCSAVERECALC, RECORD_COLINFO, RECORD_CONTINUE, RECORD_DATE1904, RECORD_DEFAULTROWHEIGHT, RECORD_DEFCOLWIDTH, RECORD_DIMENSIONS, RECORD_EOF, RECORD_EXTERNSHEET, RECORD_FILEPASS, RECORD_FONT, RECORD_FORMAT, RECORD_FORMULA, RECORD_HORIZONTALPAGEBREAKS, RECORD_LABEL, RECORD_LABELSST, RECORD_LBL, RECORD_LEFTMARGIN, RECORD_MERGECELLS, RECORD_MULBLANK, RECORD_MULRK, RECORD_NUMBER, RECORD_PALETTE, RECORD_PRINTGRID, RECORD_PRINTROWCOL, RECORD_RIGHTMARGIN, RECORD_RK, RECORD_ROW, RECORD_SETUP, RECORD_SHRFMLA, RECORD_SST, RECORD_STRING, RECORD_STYLE, RECORD_SUPBOOK, RECORD_TABLE, RECORD_TOPMARGIN, RECORD_VERTICALPAGEBREAKS, RECORD_WSBOOL, RECORD_XF } from "./biff/record-types.js";
 import { BiffFormatError, readRecords } from "./biff/records.js";
-import { isXlsFile, readWorkbookStream } from "./container.js";
+import { SUMMARY_INFORMATION_STREAM, isXlsFile, readWorkbookStreams } from "./container.js";
+import { columnWidthToPoints, inchesToPoints, millimetresToPoints, pointsToColumnWidth, pointsToInches, pointsToTwips, twipsToPoints } from "./units.js";
 import { groupRecords, splitSubstreams } from "./biff/substreams.js";
-import { BUILTIN_NUMBER_FORMATS, classifyNumberFormat } from "./number-format.js";
-import { serialToIsoDate, serialToIsoDateTime, serialToIsoTime } from "./serial.js";
+import { BiffWriteError } from "./biff/write-errors.js";
+import { isoDateTimeToSerial, isoDateToSerial, isoTimeToSerial, serialToIsoDate, serialToIsoDateTime, serialToIsoTime } from "./serial.js";
 import { BlockCursor } from "./biff/cursor.js";
 import { readRichExtendedString, readShortXLUnicodeString, readXLUnicodeString } from "./biff/strings.js";
+import { RecordBuilder } from "./biff/builder.js";
+import { concatRecords, writeRecord } from "./biff/record-writer.js";
 import { formatCodeOf, readWorkbookGlobals } from "./workbook/globals.js";
-import { errorTextOf } from "./biff/errors.js";
+import { errorCodeOf, errorTextOf } from "./biff/errors.js";
 import { decodeRkNumber } from "./biff/rk.js";
-import { columnWidthToPoints, twipsToPoints } from "./units.js";
 import { readSheetRecords } from "./workbook/sheet.js";
 import { readXls, readXlsContent } from "./content.js";
-export { BIFF8_VERSION, BOF_TYPE_CHART, BOF_TYPE_MACRO, BOF_TYPE_WORKBOOK, BOF_TYPE_WORKSHEET, BUILTIN_NUMBER_FORMATS, BiffFormatError, BlockCursor, MAX_RECORD_DATA_SIZE, RECORD_ARRAY, RECORD_BLANK, RECORD_BOF, RECORD_BOOLERR, RECORD_BOUNDSHEET8, RECORD_COLINFO, RECORD_CONTINUE, RECORD_DATE1904, RECORD_DEFAULTROWHEIGHT, RECORD_DEFCOLWIDTH, RECORD_DIMENSIONS, RECORD_EOF, RECORD_FILEPASS, RECORD_FONT, RECORD_FORMAT, RECORD_FORMULA, RECORD_LABEL, RECORD_LABELSST, RECORD_MERGECELLS, RECORD_MULBLANK, RECORD_MULRK, RECORD_NUMBER, RECORD_RK, RECORD_ROW, RECORD_SHRFMLA, RECORD_SST, RECORD_STRING, RECORD_TABLE, RECORD_XF, classifyNumberFormat, columnWidthToPoints, decodeRkNumber, errorTextOf, formatCodeOf, groupRecords, isXlsFile, readRecords, readRichExtendedString, readSheetRecords, readShortXLUnicodeString, readWorkbookGlobals, readWorkbookStream, readXLUnicodeString, readXls, readXlsContent, serialToIsoDate, serialToIsoDateTime, serialToIsoTime, splitSubstreams, twipsToPoints };
+import { writeBofData } from "./biff/bof-writer.js";
+import { writeRichExtendedString, writeShortXLUnicodeString, writeXLUnicodeString } from "./biff/string-writer.js";
+import { writeCellXfRecord, writeFontRecord, writeFormatRecord, writePaletteRecord, writeStyleRecord, writeStyleXfRecord } from "./biff/xf-writer.js";
+import { layoutMetadataToSummaryInformation } from "./metadata.js";
+import { GENERAL_CELL_XF_INDEX, buildWorkbookGlobals } from "./workbook/globals-writer.js";
+import { buildWorksheetSubstream } from "./workbook/sheet-writer.js";
+import { writeXls, writeXlsContent } from "./write.js";
+export * from "excel-number-format";
+export { BIFF8_VERSION, BOF_TYPE_CHART, BOF_TYPE_MACRO, BOF_TYPE_WORKBOOK, BOF_TYPE_WORKSHEET, BiffFormatError, BiffWriteError, BlockCursor, GENERAL_CELL_XF_INDEX, MAX_RECORD_DATA_SIZE, RECORD_ARRAY, RECORD_BLANK, RECORD_BOF, RECORD_BOOLERR, RECORD_BOTTOMMARGIN, RECORD_BOUNDSHEET8, RECORD_CALCCOUNT, RECORD_CALCDELTA, RECORD_CALCITER, RECORD_CALCREFMODE, RECORD_CALCSAVERECALC, RECORD_COLINFO, RECORD_CONTINUE, RECORD_DATE1904, RECORD_DEFAULTROWHEIGHT, RECORD_DEFCOLWIDTH, RECORD_DIMENSIONS, RECORD_EOF, RECORD_EXTERNSHEET, RECORD_FILEPASS, RECORD_FONT, RECORD_FORMAT, RECORD_FORMULA, RECORD_HORIZONTALPAGEBREAKS, RECORD_LABEL, RECORD_LABELSST, RECORD_LBL, RECORD_LEFTMARGIN, RECORD_MERGECELLS, RECORD_MULBLANK, RECORD_MULRK, RECORD_NUMBER, RECORD_PALETTE, RECORD_PRINTGRID, RECORD_PRINTROWCOL, RECORD_RIGHTMARGIN, RECORD_RK, RECORD_ROW, RECORD_SETUP, RECORD_SHRFMLA, RECORD_SST, RECORD_STRING, RECORD_STYLE, RECORD_SUPBOOK, RECORD_TABLE, RECORD_TOPMARGIN, RECORD_VERTICALPAGEBREAKS, RECORD_WSBOOL, RECORD_XF, RecordBuilder, SUMMARY_INFORMATION_STREAM, buildWorkbookGlobals, buildWorksheetSubstream, columnWidthToPoints, concatRecords, decodeRkNumber, errorCodeOf, errorTextOf, formatCodeOf, groupRecords, inchesToPoints, isXlsFile, isoDateTimeToSerial, isoDateToSerial, isoTimeToSerial, layoutMetadataToSummaryInformation, millimetresToPoints, pointsToColumnWidth, pointsToInches, pointsToTwips, readRecords, readRichExtendedString, readSheetRecords, readShortXLUnicodeString, readWorkbookGlobals, readWorkbookStreams, readXLUnicodeString, readXls, readXlsContent, serialToIsoDate, serialToIsoDateTime, serialToIsoTime, splitSubstreams, twipsToPoints, writeBofData, writeCellXfRecord, writeFontRecord, writeFormatRecord, writePaletteRecord, writeRecord, writeRichExtendedString, writeShortXLUnicodeString, writeStyleRecord, writeStyleXfRecord, writeXLUnicodeString, writeXls, writeXlsContent };

package/dist/metadata.cjs

@@ -0,0 +1,14 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_biff_write_errors = require("./biff/write-errors.cjs");
+let archive_codec = require("archive-codec");
+//#region src/metadata.ts
+function requireValidIsoDate(value, field) {
+	if (value !== void 0 && Number.isNaN(new Date(value).getTime())) throw new require_biff_write_errors.BiffWriteError(`LayoutMetadata.${field} "${value}" is not a valid date string, so it cannot be written as a SummaryInformation FILETIME property`);
+}
+function layoutMetadataToSummaryInformation(metadata) {
+	requireValidIsoDate(metadata.createdIso, "createdIso");
+	requireValidIsoDate(metadata.modifiedIso, "modifiedIso");
+	return (0, archive_codec.layoutMetadataToSummaryInformation)(metadata);
+}
+//#endregion
+exports.layoutMetadataToSummaryInformation = layoutMetadataToSummaryInformation;

package/dist/metadata.d.cts

@@ -0,0 +1,6 @@
+import { LayoutMetadata } from "document-schema.js";
+import { SummaryInformationProperties } from "archive-codec";
+//#region src/metadata.d.ts
+declare function layoutMetadataToSummaryInformation(metadata: LayoutMetadata): SummaryInformationProperties;
+//#endregion
+export { layoutMetadataToSummaryInformation };

package/dist/metadata.d.ts

@@ -0,0 +1,6 @@
+import { SummaryInformationProperties } from "archive-codec";
+import { LayoutMetadata } from "document-schema.js";
+//#region src/metadata.d.ts
+declare function layoutMetadataToSummaryInformation(metadata: LayoutMetadata): SummaryInformationProperties;
+//#endregion
+export { layoutMetadataToSummaryInformation };

package/dist/metadata.js

@@ -0,0 +1,13 @@
+import { BiffWriteError } from "./biff/write-errors.js";
+import { layoutMetadataToSummaryInformation as layoutMetadataToSummaryInformation$1 } from "archive-codec";
+//#region src/metadata.ts
+function requireValidIsoDate(value, field) {
+	if (value !== void 0 && Number.isNaN(new Date(value).getTime())) throw new BiffWriteError(`LayoutMetadata.${field} "${value}" is not a valid date string, so it cannot be written as a SummaryInformation FILETIME property`);
+}
+function layoutMetadataToSummaryInformation(metadata) {
+	requireValidIsoDate(metadata.createdIso, "createdIso");
+	requireValidIsoDate(metadata.modifiedIso, "modifiedIso");
+	return layoutMetadataToSummaryInformation$1(metadata);
+}
+//#endregion
+export { layoutMetadataToSummaryInformation };

package/dist/print-names-D-njuzVw.d.cts

@@ -0,0 +1,41 @@
+import { t as RecordGroup } from "./substreams-Ddtvn_Vr.cjs";
+import { ContentSheetPrintRange, ContentSheetRepeatRange } from "document-schema.js";
+//#region src/workbook/print-names.d.ts
+/** One sheet's print names, as the Lbl records of the globals substream carry them. Every field is absent when the workbook declares no such name for that sheet. */
+interface SheetPrintNames {
+  readonly printRange?: ContentSheetPrintRange;
+  readonly repeatRows?: ContentSheetRepeatRange;
+  readonly repeatColumns?: ContentSheetRepeatRange;
+}
+/** A rectangular area exactly as a PtgArea3d/PtgRef3d token states it, before deciding what it means. */
+interface RawArea {
+  readonly rowFirst: number;
+  readonly rowLast: number;
+  readonly columnFirst: number;
+  readonly columnLast: number;
+}
+/**
+ * Reads every Lbl record in a globals substream into per-sheet print names, keyed by ZERO-based sheet index -- Lbl's own itab is one-based, and a sheet index everywhere else in this package is not.
+ *
+ * A name this reader does not act on leaves nothing behind rather than failing the workbook: a user-defined name (fBuiltin clear), a built-in name other than the two below, a workbook-scoped one (itab 0, which no real producer uses for a print area since a print area belongs to a sheet), and a name whose token stream holds a construct outside the narrow vocabulary parsePrintAreas resolves are all simply not carried. The sheet then reads with no printRange or repeat bands, which is the same answer a sheet that genuinely declares none gives.
+ */
+declare function readPrintNames(records: readonly RecordGroup[]): ReadonlyMap<number, SheetPrintNames>;
+/** One Lbl record to write: which sheet it is scoped to, and the areas its own token stream names. */
+interface PrintNamePlanEntry {
+  /** Zero-based; written out as Lbl's own one-based itab. */
+  readonly sheetIndex: number;
+  /** The ixti a PtgArea3d in this name's token stream refers to -- an index into the ExternSheet record's own XTI array, which globals-writer.ts writes one entry of per sheet. */
+  readonly ixti: number;
+  readonly builtinName: number;
+  readonly areas: readonly RawArea[];
+}
+/** The Print_Area and Print_Titles entries one sheet's print settings need, or an empty list when it declares neither a print range nor a repeated band. */
+declare function printNameEntriesFor(sheetIndex: number, ixti: number, settings: {
+  readonly printRange?: ContentSheetPrintRange;
+  readonly repeatRows?: ContentSheetRepeatRange;
+  readonly repeatColumns?: ContentSheetRepeatRange;
+}): PrintNamePlanEntry[];
+/** Every planned print name as its own Lbl record, in the order given. */
+declare function writePrintNameRecords(entries: readonly PrintNamePlanEntry[]): Uint8Array<ArrayBuffer>[];
+//#endregion
+export { writePrintNameRecords as a, readPrintNames as i, SheetPrintNames as n, printNameEntriesFor as r, PrintNamePlanEntry as t };

package/dist/print-names-DUlpVE00.d.ts

@@ -0,0 +1,41 @@
+import { t as RecordGroup } from "./substreams-D7dQiJbp.js";
+import { ContentSheetPrintRange, ContentSheetRepeatRange } from "document-schema.js";
+//#region src/workbook/print-names.d.ts
+/** One sheet's print names, as the Lbl records of the globals substream carry them. Every field is absent when the workbook declares no such name for that sheet. */
+interface SheetPrintNames {
+  readonly printRange?: ContentSheetPrintRange;
+  readonly repeatRows?: ContentSheetRepeatRange;
+  readonly repeatColumns?: ContentSheetRepeatRange;
+}
+/** A rectangular area exactly as a PtgArea3d/PtgRef3d token states it, before deciding what it means. */
+interface RawArea {
+  readonly rowFirst: number;
+  readonly rowLast: number;
+  readonly columnFirst: number;
+  readonly columnLast: number;
+}
+/**
+ * Reads every Lbl record in a globals substream into per-sheet print names, keyed by ZERO-based sheet index -- Lbl's own itab is one-based, and a sheet index everywhere else in this package is not.
+ *
+ * A name this reader does not act on leaves nothing behind rather than failing the workbook: a user-defined name (fBuiltin clear), a built-in name other than the two below, a workbook-scoped one (itab 0, which no real producer uses for a print area since a print area belongs to a sheet), and a name whose token stream holds a construct outside the narrow vocabulary parsePrintAreas resolves are all simply not carried. The sheet then reads with no printRange or repeat bands, which is the same answer a sheet that genuinely declares none gives.
+ */
+declare function readPrintNames(records: readonly RecordGroup[]): ReadonlyMap<number, SheetPrintNames>;
+/** One Lbl record to write: which sheet it is scoped to, and the areas its own token stream names. */
+interface PrintNamePlanEntry {
+  /** Zero-based; written out as Lbl's own one-based itab. */
+  readonly sheetIndex: number;
+  /** The ixti a PtgArea3d in this name's token stream refers to -- an index into the ExternSheet record's own XTI array, which globals-writer.ts writes one entry of per sheet. */
+  readonly ixti: number;
+  readonly builtinName: number;
+  readonly areas: readonly RawArea[];
+}
+/** The Print_Area and Print_Titles entries one sheet's print settings need, or an empty list when it declares neither a print range nor a repeated band. */
+declare function printNameEntriesFor(sheetIndex: number, ixti: number, settings: {
+  readonly printRange?: ContentSheetPrintRange;
+  readonly repeatRows?: ContentSheetRepeatRange;
+  readonly repeatColumns?: ContentSheetRepeatRange;
+}): PrintNamePlanEntry[];
+/** Every planned print name as its own Lbl record, in the order given. */
+declare function writePrintNameRecords(entries: readonly PrintNamePlanEntry[]): Uint8Array<ArrayBuffer>[];
+//#endregion
+export { writePrintNameRecords as a, readPrintNames as i, SheetPrintNames as n, printNameEntriesFor as r, PrintNamePlanEntry as t };

package/dist/print-setup-B_ihDvm5.d.cts

@@ -0,0 +1,57 @@
+import { PageSize } from "document-schema.js";
+//#region src/biff/print-setup.d.ts
+/** WsBool's own fFitToPage bit -- field G of [MS-XLS] 2.4.351, the ninth bit of its single 16-bit field (fShowAutoBreaks, reserved1 (3 bits), fDialog, fApplyStyles, fRowSumsBelow, fColSumsRight, fFitToPage, ...). */
+declare const WSBOOL_FLAG_FIT_TO_PAGE = 256;
+/**
+ * The Setup record's fields, as this package reads and writes them.
+ *
+ * `noPls` is carried rather than resolved away, because [MS-XLS] 2.4.257 makes it govern whether five of the others mean anything at all: "A bit that specifies whether the iPaperSize, iScale, iRes, iVRes, iCopies, fNoOrient, and fPortrait data are undefined and ignored." A reader that ignored it would confidently report a paper size and a scale percentage the file itself declares meaningless.
+ */
+interface SetupFields {
+  /** iPaperSize: an index into the paper-size code table below. Undefined and to be ignored when `noPls` is true. */
+  readonly paperCode: number;
+  /** iScale: the print scale as a whole percentage ("if the value is 107 then the scaling factor is 107%"). Undefined and to be ignored when `noPls` is true. */
+  readonly scalePercent: number;
+  /** iFitWidth: how many pages wide the sheet is fitted to. 0 is [MS-XLS]'s own "use as many pages as necessary". Meaningful only when WsBool's fFitToPage is set. */
+  readonly fitWidth: number;
+  /** iFitHeight: the same for the sheet's height. */
+  readonly fitHeight: number;
+  /** fLeftToRight: pages printed left-to-right first (true) or top-to-bottom first (false). */
+  readonly leftToRight: boolean;
+  /** fPortrait. Undefined and to be ignored when `noPls` or `noOrientation` is true -- in the latter case [MS-XLS] states the sheet prints portrait regardless. */
+  readonly portrait: boolean;
+  /** fNoPls: the paper size, scale, resolution, copy count, and both orientation bits are undefined. */
+  readonly noPls: boolean;
+  /** fNoOrient: "whether the paper orientation is set" -- when true, fPortrait is undefined and "Pages are printed using portrait mode". */
+  readonly noOrientation: boolean;
+}
+/** Packs a SetupFields' own four flags back into the record's grbit word. Every bit this package does not model is written as zero, which is what [MS-XLS] 2.4.257's own reserved field requires and what its remaining optional behaviours (black-and-white, draft quality, comment printing, error rendering, a custom starting page number) default to. */
+declare function packSetupFlags(fields: SetupFields): number;
+/** The read-side inverse of packSetupFlags: the four flags this package acts on, taken out of the record's grbit word. */
+declare function unpackSetupFlags(grbit: number): {
+  leftToRight: boolean;
+  portrait: boolean;
+  noPls: boolean;
+  noOrientation: boolean;
+};
+/**
+ * The page size a Setup record's own iPaperSize and orientation flags describe, or undefined when the code is not one this package maps.
+ *
+ * A paper code names the sheet's paper in its PORTRAIT dimensions regardless of how the sheet actually prints, so the orientation flags decide whether those dimensions are used as-is or transposed. [MS-XLS] 2.4.257 defines that in two steps: fNoOrient set means "Pages are printed using portrait mode" outright, and only when it is clear does fPortrait itself select portrait (1) or landscape (0).
+ */
+declare function pageSizeFromSetup(fields: SetupFields): PageSize | undefined;
+/** How a Setup record can name a given page size: the paper code, and whether the sheet must be declared portrait or landscape for that code's own portrait dimensions to come out as the size asked for. */
+interface PaperSelection {
+  readonly code: number;
+  readonly portrait: boolean;
+}
+/**
+ * The write-side inverse of pageSizeFromSetup: the paper code and orientation whose resolved page size matches this one, or undefined when no code in the table does.
+ *
+ * Undefined is a real answer with no fallback behind it. Unlike xlsx's own pageSetup element, which can state an explicit paperWidth/paperHeight pair when no code fits, [MS-XLS] 2.4.257's Setup record addresses paper only by code -- its own escape hatch for a size outside the table is a printer-defined custom size carried in a separate Pls record ([MS-XLS] 2.4.199), a printer driver's opaque DEVMODE blob rather than a pair of dimensions any reader could recover the size from. So a page size no code names genuinely cannot be written; the caller refuses rather than silently substituting a paper the document never asked for.
+ *
+ * A portrait match is preferred over a landscape one wherever both exist, which is what keeps the choice deterministic for the handful of codes in the table that are each other's transpose (US Tabloid 11x17in and US Ledger 17x11in are the same sheet of paper entered twice, once each way round).
+ */
+declare function paperSelectionFor(pageSize: PageSize): PaperSelection | undefined;
+//#endregion
+export { pageSizeFromSetup as a, packSetupFlags as i, SetupFields as n, paperSelectionFor as o, WSBOOL_FLAG_FIT_TO_PAGE as r, unpackSetupFlags as s, PaperSelection as t };

package/dist/print-setup-B_ihDvm5.d.ts

@@ -0,0 +1,57 @@
+import { PageSize } from "document-schema.js";
+//#region src/biff/print-setup.d.ts
+/** WsBool's own fFitToPage bit -- field G of [MS-XLS] 2.4.351, the ninth bit of its single 16-bit field (fShowAutoBreaks, reserved1 (3 bits), fDialog, fApplyStyles, fRowSumsBelow, fColSumsRight, fFitToPage, ...). */
+declare const WSBOOL_FLAG_FIT_TO_PAGE = 256;
+/**
+ * The Setup record's fields, as this package reads and writes them.
+ *
+ * `noPls` is carried rather than resolved away, because [MS-XLS] 2.4.257 makes it govern whether five of the others mean anything at all: "A bit that specifies whether the iPaperSize, iScale, iRes, iVRes, iCopies, fNoOrient, and fPortrait data are undefined and ignored." A reader that ignored it would confidently report a paper size and a scale percentage the file itself declares meaningless.
+ */
+interface SetupFields {
+  /** iPaperSize: an index into the paper-size code table below. Undefined and to be ignored when `noPls` is true. */
+  readonly paperCode: number;
+  /** iScale: the print scale as a whole percentage ("if the value is 107 then the scaling factor is 107%"). Undefined and to be ignored when `noPls` is true. */
+  readonly scalePercent: number;
+  /** iFitWidth: how many pages wide the sheet is fitted to. 0 is [MS-XLS]'s own "use as many pages as necessary". Meaningful only when WsBool's fFitToPage is set. */
+  readonly fitWidth: number;
+  /** iFitHeight: the same for the sheet's height. */
+  readonly fitHeight: number;
+  /** fLeftToRight: pages printed left-to-right first (true) or top-to-bottom first (false). */
+  readonly leftToRight: boolean;
+  /** fPortrait. Undefined and to be ignored when `noPls` or `noOrientation` is true -- in the latter case [MS-XLS] states the sheet prints portrait regardless. */
+  readonly portrait: boolean;
+  /** fNoPls: the paper size, scale, resolution, copy count, and both orientation bits are undefined. */
+  readonly noPls: boolean;
+  /** fNoOrient: "whether the paper orientation is set" -- when true, fPortrait is undefined and "Pages are printed using portrait mode". */
+  readonly noOrientation: boolean;
+}
+/** Packs a SetupFields' own four flags back into the record's grbit word. Every bit this package does not model is written as zero, which is what [MS-XLS] 2.4.257's own reserved field requires and what its remaining optional behaviours (black-and-white, draft quality, comment printing, error rendering, a custom starting page number) default to. */
+declare function packSetupFlags(fields: SetupFields): number;
+/** The read-side inverse of packSetupFlags: the four flags this package acts on, taken out of the record's grbit word. */
+declare function unpackSetupFlags(grbit: number): {
+  leftToRight: boolean;
+  portrait: boolean;
+  noPls: boolean;
+  noOrientation: boolean;
+};
+/**
+ * The page size a Setup record's own iPaperSize and orientation flags describe, or undefined when the code is not one this package maps.
+ *
+ * A paper code names the sheet's paper in its PORTRAIT dimensions regardless of how the sheet actually prints, so the orientation flags decide whether those dimensions are used as-is or transposed. [MS-XLS] 2.4.257 defines that in two steps: fNoOrient set means "Pages are printed using portrait mode" outright, and only when it is clear does fPortrait itself select portrait (1) or landscape (0).
+ */
+declare function pageSizeFromSetup(fields: SetupFields): PageSize | undefined;
+/** How a Setup record can name a given page size: the paper code, and whether the sheet must be declared portrait or landscape for that code's own portrait dimensions to come out as the size asked for. */
+interface PaperSelection {
+  readonly code: number;
+  readonly portrait: boolean;
+}
+/**
+ * The write-side inverse of pageSizeFromSetup: the paper code and orientation whose resolved page size matches this one, or undefined when no code in the table does.
+ *
+ * Undefined is a real answer with no fallback behind it. Unlike xlsx's own pageSetup element, which can state an explicit paperWidth/paperHeight pair when no code fits, [MS-XLS] 2.4.257's Setup record addresses paper only by code -- its own escape hatch for a size outside the table is a printer-defined custom size carried in a separate Pls record ([MS-XLS] 2.4.199), a printer driver's opaque DEVMODE blob rather than a pair of dimensions any reader could recover the size from. So a page size no code names genuinely cannot be written; the caller refuses rather than silently substituting a paper the document never asked for.
+ *
+ * A portrait match is preferred over a landscape one wherever both exist, which is what keeps the choice deterministic for the handful of codes in the table that are each other's transpose (US Tabloid 11x17in and US Ledger 17x11in are the same sheet of paper entered twice, once each way round).
+ */
+declare function paperSelectionFor(pageSize: PageSize): PaperSelection | undefined;
+//#endregion
+export { pageSizeFromSetup as a, packSetupFlags as i, SetupFields as n, paperSelectionFor as o, WSBOOL_FLAG_FIT_TO_PAGE as r, unpackSetupFlags as s, PaperSelection as t };

package/dist/ptg-B2K8t3js.d.cts

@@ -0,0 +1,21 @@
+//#region src/biff/ptg.d.ts
+/** A 3D reference's sheet scope, resolved from its ixti through EXTERNSHEET and a self-referencing SupBook ([MS-XLS] 2.4.271, 2.4.106, 2.5.344): the first and last sheet of the reference, both direct BoundSheet8 indices into FormulaSheetContext.sheets. A single-sheet 3D reference has `firstSheetIndex === lastSheetIndex`. Defined here rather than alongside the globals reader that produces it, since resolving it into reference text is what this module exists to do. */
+interface SheetRange {
+  readonly firstSheetIndex: number;
+  readonly lastSheetIndex: number;
+}
+/** What a 3D reference's own ixti resolves against: the workbook's sheets in BoundSheet8 order (only the name is needed here), and each ixti's own resolved sheet range (undefined where this reader does not resolve it -- see WorkbookGlobals.sheetRanges, which this type's own sheetRanges field matches field-for-field). */
+interface FormulaSheetContext {
+  readonly sheets: readonly {
+    readonly name: string;
+  }[];
+  readonly sheetRanges: readonly (SheetRange | undefined)[];
+}
+/**
+ * Parses a Formula record's compiled expression into the text a spreadsheet application would show, or returns undefined for a token this reader does not resolve -- a shared formula's PtgExp, an array constant's PtgArray, a defined name, a natural-language reference, or a 3D reference into a genuinely external workbook (see the module comment for the full list). The caller leaves ContentSheetCell.formula absent in that case, exactly as for any other unsupported construct.
+ *
+ * `rgce` is the formula's own token bytes, already sliced to their declared length (CellParsedFormula.cce) by the caller -- this function reads exactly that many bytes and nothing past them.
+ */
+declare function parseFormulaText(rgce: Uint8Array<ArrayBuffer>, context: FormulaSheetContext): string | undefined;
+//#endregion
+export { SheetRange as n, parseFormulaText as r, FormulaSheetContext as t };

package/dist/ptg-B2K8t3js.d.ts

@@ -0,0 +1,21 @@
+//#region src/biff/ptg.d.ts
+/** A 3D reference's sheet scope, resolved from its ixti through EXTERNSHEET and a self-referencing SupBook ([MS-XLS] 2.4.271, 2.4.106, 2.5.344): the first and last sheet of the reference, both direct BoundSheet8 indices into FormulaSheetContext.sheets. A single-sheet 3D reference has `firstSheetIndex === lastSheetIndex`. Defined here rather than alongside the globals reader that produces it, since resolving it into reference text is what this module exists to do. */
+interface SheetRange {
+  readonly firstSheetIndex: number;
+  readonly lastSheetIndex: number;
+}
+/** What a 3D reference's own ixti resolves against: the workbook's sheets in BoundSheet8 order (only the name is needed here), and each ixti's own resolved sheet range (undefined where this reader does not resolve it -- see WorkbookGlobals.sheetRanges, which this type's own sheetRanges field matches field-for-field). */
+interface FormulaSheetContext {
+  readonly sheets: readonly {
+    readonly name: string;
+  }[];
+  readonly sheetRanges: readonly (SheetRange | undefined)[];
+}
+/**
+ * Parses a Formula record's compiled expression into the text a spreadsheet application would show, or returns undefined for a token this reader does not resolve -- a shared formula's PtgExp, an array constant's PtgArray, a defined name, a natural-language reference, or a 3D reference into a genuinely external workbook (see the module comment for the full list). The caller leaves ContentSheetCell.formula absent in that case, exactly as for any other unsupported construct.
+ *
+ * `rgce` is the formula's own token bytes, already sliced to their declared length (CellParsedFormula.cce) by the caller -- this function reads exactly that many bytes and nothing past them.
+ */
+declare function parseFormulaText(rgce: Uint8Array<ArrayBuffer>, context: FormulaSheetContext): string | undefined;
+//#endregion
+export { SheetRange as n, parseFormulaText as r, FormulaSheetContext as t };