xls-codec 4.7.6 → 4.9.0

package/dist/drawing/shapes.d.ts

@@ -0,0 +1,24 @@
+//#region src/drawing/shapes.d.ts
+/** One drawing shape's own fixed geometry and identity -- what a Sp/Opt/ClientAnchor triple inside one SpContainer states. Nothing about what KIND of content the shape holds (a picture, a chart, an autoshape) lives here: that is the paired Obj record's own ftCmo.ot, resolved by workbook/drawing.ts once shapes and Obj records are matched up. */
+interface DrawingShape {
+  readonly shapeType: number;
+  readonly spid: number;
+  /** 1-based index into the workbook's own Blip Store ([MS-ODRAW] "pib"), present only for a shape whose Opt property table actually states one -- a picture shape, in practice. */
+  readonly blipIndex: number | undefined;
+  readonly anchor: ShapeAnchor;
+}
+/** [MS-XLS] 2.5.163 OfficeArtClientAnchorSheet: a shape's placement as a top-left and bottom-right corner, each a cell plus a fractional offset within it -- dxL/dxR in 1/1024ths of that cell's own width, dyT/dyB in 1/256ths of that cell's own height (the two axes use different denominators; see this record's own field-by-field citation in escher-constants.ts). */
+interface ShapeAnchor {
+  readonly colL: number;
+  readonly dxL: number;
+  readonly rwT: number;
+  readonly dyT: number;
+  readonly colR: number;
+  readonly dxR: number;
+  readonly rwB: number;
+  readonly dyB: number;
+}
+/** Reads one worksheet's own concatenated MsoDrawing bytes into an ordered list of its real (non-patriarch) top-level shapes. A stream this reader cannot make sense of at all (empty, or carrying no DgContainer) yields no shapes rather than throwing -- workbook/drawing.ts already treats "this sheet has a drawing" as optional. */
+declare function readSheetShapes(drawingBytes: Uint8Array<ArrayBuffer>): readonly DrawingShape[];
+//#endregion
+export { DrawingShape, ShapeAnchor, readSheetShapes };

package/dist/drawing/shapes.js

@@ -0,0 +1,79 @@
+import { BiffFormatError } from "../biff/records.js";
+import { BlockCursor } from "../biff/cursor.js";
+import { ESCHER_CLIENT_ANCHOR, ESCHER_OPT, ESCHER_SP, ESCHER_SPGR_CONTAINER } from "./escher-constants.js";
+import { childrenOfType, readEscherRecords } from "./escher.js";
+//#region src/drawing/shapes.ts
+const CLIENT_ANCHOR_SIZE = 18;
+/** Reads one worksheet's own concatenated MsoDrawing bytes into an ordered list of its real (non-patriarch) top-level shapes. A stream this reader cannot make sense of at all (empty, or carrying no DgContainer) yields no shapes rather than throwing -- workbook/drawing.ts already treats "this sheet has a drawing" as optional. */
+function readSheetShapes(drawingBytes) {
+	if (drawingBytes.length === 0) return [];
+	const dg = readEscherRecords(drawingBytes).find((record) => record.kind === "container" && record.recType === 61442);
+	if (dg === void 0) return [];
+	const rootSpgr = childrenOfType(dg, ESCHER_SPGR_CONTAINER)[0];
+	if (rootSpgr?.kind !== "container") return [];
+	return readGroupShapes(rootSpgr);
+}
+/** The root group's own direct children, in document order, restricted to the two kinds a shape tree ever nests: further shape groups and ordinary shape containers. Keeps document order across a mix of the two (a real drawing can place a group between two ordinary shapes) rather than processing every group before every plain shape. */
+function interleaveGroupOrder(group) {
+	return group.children.filter((child) => child.kind === "container" && (child.recType === 61444 || child.recType === 61443));
+}
+/** A nested shape group: its own first child SpContainer is the group's own shape record (no cell anchor, [MS-ODRAW] "fGroup"/"fChild"), and every shape after it -- ordinary or a further nested group -- is a real child shape, read the identical way. */
+function readGroupShapes(group) {
+	const [, ...rest] = interleaveGroupOrder(group);
+	const shapes = [];
+	for (const child of rest) if (child.recType === 61443) shapes.push(...readGroupShapes(child));
+	else {
+		const shape = readShapeContainer(child);
+		if (shape !== void 0) shapes.push(shape);
+	}
+	return shapes;
+}
+/** One SpContainer's own Sp/Opt/ClientAnchor children -- undefined when the shape carries no cell anchor at all (a malformed or unusually authored file; every real placed shape has one). */
+function readShapeContainer(container) {
+	const sp = childrenOfType(container, ESCHER_SP)[0];
+	if (sp?.kind !== "atom") return;
+	const spid = new BlockCursor([sp.data]).u32();
+	const anchorRecord = childrenOfType(container, ESCHER_CLIENT_ANCHOR)[0];
+	if (anchorRecord?.kind !== "atom") return;
+	const anchor = readClientAnchor(anchorRecord.data);
+	if (anchor === void 0) return;
+	const opt = childrenOfType(container, ESCHER_OPT)[0];
+	let blipIndex;
+	if (opt?.kind === "atom") try {
+		blipIndex = readPibProperty(opt.data);
+	} catch (error) {
+		if (!(error instanceof BiffFormatError)) throw error;
+	}
+	return {
+		shapeType: sp.recInstance,
+		spid,
+		blipIndex,
+		anchor
+	};
+}
+function readClientAnchor(data) {
+	if (data.length < CLIENT_ANCHOR_SIZE) return;
+	const cursor = new BlockCursor([data]);
+	cursor.skip(2);
+	return {
+		colL: cursor.u16(),
+		dxL: cursor.i16(),
+		rwT: cursor.u16(),
+		dyT: cursor.i16(),
+		colR: cursor.u16(),
+		dxR: cursor.i16(),
+		rwB: cursor.u16(),
+		dyB: cursor.i16()
+	};
+}
+/** Walks an Opt atom's own FOPTE array looking for the `pib` property ([MS-ODRAW] "pib": opid.opid MUST be 0x0104) -- undefined when the shape states no `pib` at all, or states one through the complex-data trailer form (fComplex set) this reader does not resolve, which is not the common inline-index shape a picture shape's own pib actually takes. */
+function readPibProperty(data) {
+	const cursor = new BlockCursor([data]);
+	while (cursor.hasMore()) {
+		const opid = cursor.u16();
+		const op = cursor.u32();
+		if (opid === 260 && (opid & 32768) === 0) return op;
+	}
+}
+//#endregion
+export { readSheetShapes };

package/dist/index.cjs

@@ -6,12 +6,12 @@ const require_units = require("./units.cjs");
 const require_biff_substreams = require("./biff/substreams.cjs");
 const require_biff_cursor = require("./biff/cursor.cjs");
 const require_biff_strings = require("./biff/strings.cjs");
+const require_biff_errors = require("./biff/errors.cjs");
 const require_biff_write_errors = require("./biff/write-errors.cjs");
 const require_serial = require("./serial.cjs");
 const require_biff_builder = require("./biff/builder.cjs");
 const require_biff_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_workbook_sheet = require("./workbook/sheet.cjs");
 const require_content = require("./content.cjs");
@@ -30,9 +30,12 @@ exports.BOF_TYPE_WORKSHEET = require_biff_record_types.BOF_TYPE_WORKSHEET;
 exports.BiffFormatError = require_biff_records.BiffFormatError;
 exports.BiffWriteError = require_biff_write_errors.BiffWriteError;
 exports.BlockCursor = require_biff_cursor.BlockCursor;
+exports.DEFAULT_COLUMN_WIDTH_CHARS = require_units.DEFAULT_COLUMN_WIDTH_CHARS;
+exports.DEFAULT_ROW_HEIGHT_PT = require_units.DEFAULT_ROW_HEIGHT_PT;
 exports.GENERAL_CELL_XF_INDEX = require_workbook_globals_writer.GENERAL_CELL_XF_INDEX;
 exports.HEADER_SIZE = require_biff_records.HEADER_SIZE;
 exports.MAX_RECORD_DATA_SIZE = require_biff_record_types.MAX_RECORD_DATA_SIZE;
+exports.RECORD_AI = require_biff_record_types.RECORD_AI;
 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;
@@ -46,6 +49,7 @@ exports.RECORD_CALCREFMODE = require_biff_record_types.RECORD_CALCREFMODE;
 exports.RECORD_CALCSAVERECALC = require_biff_record_types.RECORD_CALCSAVERECALC;
 exports.RECORD_CF = require_biff_record_types.RECORD_CF;
 exports.RECORD_CF12 = require_biff_record_types.RECORD_CF12;
+exports.RECORD_CFEX = require_biff_record_types.RECORD_CFEX;
 exports.RECORD_COLINFO = require_biff_record_types.RECORD_COLINFO;
 exports.RECORD_CONDFMT = require_biff_record_types.RECORD_CONDFMT;
 exports.RECORD_CONDFMT12 = require_biff_record_types.RECORD_CONDFMT12;
@@ -71,6 +75,9 @@ 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_MSODRAWING = require_biff_record_types.RECORD_MSODRAWING;
+exports.RECORD_MSODRAWINGGROUP = require_biff_record_types.RECORD_MSODRAWINGGROUP;
+exports.RECORD_MSODRAWINGSELECTION = require_biff_record_types.RECORD_MSODRAWINGSELECTION;
 exports.RECORD_MULBLANK = require_biff_record_types.RECORD_MULBLANK;
 exports.RECORD_MULRK = require_biff_record_types.RECORD_MULRK;
 exports.RECORD_NOTE = require_biff_record_types.RECORD_NOTE;
@@ -84,8 +91,11 @@ exports.RECORD_RK = require_biff_record_types.RECORD_RK;
 exports.RECORD_ROW = require_biff_record_types.RECORD_ROW;
 exports.RECORD_RRDHEAD = require_biff_record_types.RECORD_RRDHEAD;
 exports.RECORD_RRDINFO = require_biff_record_types.RECORD_RRDINFO;
+exports.RECORD_SERIES = require_biff_record_types.RECORD_SERIES;
+exports.RECORD_SERIESTEXT = require_biff_record_types.RECORD_SERIESTEXT;
 exports.RECORD_SETUP = require_biff_record_types.RECORD_SETUP;
 exports.RECORD_SHRFMLA = require_biff_record_types.RECORD_SHRFMLA;
+exports.RECORD_SIINDEX = require_biff_record_types.RECORD_SIINDEX;
 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;

package/dist/index.d.cts

@@ -1,25 +1,25 @@
 import { writeBofData } from "./biff/bof-writer.cjs";
 import { RecordBuilder } from "./biff/builder.cjs";
-import { t as BlockCursor } from "./cursor-VMtw9uVP.cjs";
+import { t as BlockCursor } from "./cursor-CnEuX5qE.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_CF, RECORD_CF12, RECORD_COLINFO, RECORD_CONDFMT, RECORD_CONDFMT12, RECORD_CONTINUE, RECORD_CONTINUEFRT12, RECORD_DATE1904, RECORD_DEFAULTROWHEIGHT, RECORD_DEFCOLWIDTH, RECORD_DIMENSIONS, RECORD_DV, RECORD_DVAL, RECORD_EOF, RECORD_EXTERNSHEET, RECORD_FILELOCK, RECORD_FILEPASS, RECORD_FONT, RECORD_FORMAT, RECORD_FORMULA, RECORD_HORIZONTALPAGEBREAKS, RECORD_INTERFACEHDR, RECORD_LABEL, RECORD_LABELSST, RECORD_LBL, RECORD_LEFTMARGIN, RECORD_MERGECELLS, RECORD_MULBLANK, RECORD_MULRK, RECORD_NOTE, RECORD_NUMBER, RECORD_OBJ, RECORD_PALETTE, RECORD_PRINTGRID, RECORD_PRINTROWCOL, RECORD_RIGHTMARGIN, RECORD_RK, RECORD_ROW, RECORD_RRDHEAD, RECORD_RRDINFO, RECORD_SETUP, RECORD_SHRFMLA, RECORD_SST, RECORD_STRING, RECORD_STYLE, RECORD_SUPBOOK, RECORD_TABLE, RECORD_TOPMARGIN, RECORD_TXO, RECORD_USREXCL, RECORD_VERTICALPAGEBREAKS, RECORD_WSBOOL, RECORD_XF } from "./biff/record-types.cjs";
+import { BIFF8_VERSION, BOF_TYPE_CHART, BOF_TYPE_MACRO, BOF_TYPE_WORKBOOK, BOF_TYPE_WORKSHEET, MAX_RECORD_DATA_SIZE, RECORD_AI, RECORD_ARRAY, RECORD_BLANK, RECORD_BOF, RECORD_BOOLERR, RECORD_BOTTOMMARGIN, RECORD_BOUNDSHEET8, RECORD_CALCCOUNT, RECORD_CALCDELTA, RECORD_CALCITER, RECORD_CALCREFMODE, RECORD_CALCSAVERECALC, RECORD_CF, RECORD_CF12, RECORD_CFEX, RECORD_COLINFO, RECORD_CONDFMT, RECORD_CONDFMT12, RECORD_CONTINUE, RECORD_CONTINUEFRT12, RECORD_DATE1904, RECORD_DEFAULTROWHEIGHT, RECORD_DEFCOLWIDTH, RECORD_DIMENSIONS, RECORD_DV, RECORD_DVAL, RECORD_EOF, RECORD_EXTERNSHEET, RECORD_FILELOCK, RECORD_FILEPASS, RECORD_FONT, RECORD_FORMAT, RECORD_FORMULA, RECORD_HORIZONTALPAGEBREAKS, RECORD_INTERFACEHDR, RECORD_LABEL, RECORD_LABELSST, RECORD_LBL, RECORD_LEFTMARGIN, RECORD_MERGECELLS, RECORD_MSODRAWING, RECORD_MSODRAWINGGROUP, RECORD_MSODRAWINGSELECTION, RECORD_MULBLANK, RECORD_MULRK, RECORD_NOTE, RECORD_NUMBER, RECORD_OBJ, RECORD_PALETTE, RECORD_PRINTGRID, RECORD_PRINTROWCOL, RECORD_RIGHTMARGIN, RECORD_RK, RECORD_ROW, RECORD_RRDHEAD, RECORD_RRDINFO, RECORD_SERIES, RECORD_SERIESTEXT, RECORD_SETUP, RECORD_SHRFMLA, RECORD_SIINDEX, RECORD_SST, RECORD_STRING, RECORD_STYLE, RECORD_SUPBOOK, RECORD_TABLE, RECORD_TOPMARGIN, RECORD_TXO, RECORD_USREXCL, RECORD_VERTICALPAGEBREAKS, RECORD_WSBOOL, RECORD_XF } from "./biff/record-types.cjs";
 import { concatRecords, writeRecord } from "./biff/record-writer.cjs";
 import { i as readRecords, n as BiffRecord, r as HEADER_SIZE, t as BiffFormatError } from "./records-G82UEVq8.cjs";
 import { decodeRkNumber } from "./biff/rk.cjs";
 import { writeRichExtendedString, writeShortXLUnicodeString, writeXLUnicodeString } from "./biff/string-writer.cjs";
 import { readRichExtendedString, readShortXLUnicodeString, readXLUnicodeString, readXLUnicodeStringNoCch } from "./biff/strings.cjs";
-import { a as splitSubstreams, i as recordByteLength, n as Substream, r as groupRecords, t as RecordGroup } from "./substreams-CHv3oWmn.cjs";
+import { a as splitSubstreams, i as recordByteLength, n as Substream, r as groupRecords, t as RecordGroup } from "./substreams-XDNgDvRJ.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 { 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 { DEFAULT_COLUMN_WIDTH_CHARS, DEFAULT_ROW_HEIGHT_PT, columnWidthToPoints, inchesToPoints, millimetresToPoints, pointsToColumnWidth, pointsToInches, pointsToTwips, twipsToPoints } from "./units.cjs";
 import { CellFormat, SheetEntry, WorkbookGlobals, formatCodeOf, readWorkbookGlobals } from "./workbook/globals.cjs";
 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, HEADER_SIZE, 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_CF, RECORD_CF12, RECORD_COLINFO, RECORD_CONDFMT, RECORD_CONDFMT12, RECORD_CONTINUE, RECORD_CONTINUEFRT12, RECORD_DATE1904, RECORD_DEFAULTROWHEIGHT, RECORD_DEFCOLWIDTH, RECORD_DIMENSIONS, RECORD_DV, RECORD_DVAL, RECORD_EOF, RECORD_EXTERNSHEET, RECORD_FILELOCK, RECORD_FILEPASS, RECORD_FONT, RECORD_FORMAT, RECORD_FORMULA, RECORD_HORIZONTALPAGEBREAKS, RECORD_INTERFACEHDR, RECORD_LABEL, RECORD_LABELSST, RECORD_LBL, RECORD_LEFTMARGIN, RECORD_MERGECELLS, RECORD_MULBLANK, RECORD_MULRK, RECORD_NOTE, RECORD_NUMBER, RECORD_OBJ, RECORD_PALETTE, RECORD_PRINTGRID, RECORD_PRINTROWCOL, RECORD_RIGHTMARGIN, RECORD_RK, RECORD_ROW, RECORD_RRDHEAD, RECORD_RRDINFO, RECORD_SETUP, RECORD_SHRFMLA, RECORD_SST, RECORD_STRING, RECORD_STYLE, RECORD_SUPBOOK, RECORD_TABLE, RECORD_TOPMARGIN, RECORD_TXO, RECORD_USREXCL, 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, readXLUnicodeStringNoCch, readXls, readXlsContent, recordByteLength, serialToIsoDate, serialToIsoDateTime, serialToIsoTime, splitSubstreams, twipsToPoints, writeBofData, writeCellXfRecord, writeFontRecord, writeFormatRecord, writePaletteRecord, writeRecord, writeRichExtendedString, writeShortXLUnicodeString, writeStyleRecord, writeStyleXfRecord, writeXLUnicodeString, writeXls, writeXlsContent };
+export { BIFF8_VERSION, BOF_TYPE_CHART, BOF_TYPE_MACRO, BOF_TYPE_WORKBOOK, BOF_TYPE_WORKSHEET, BiffFormatError, BiffRecord, BiffWriteError, BlockCursor, CellFormat, CellXfPlanEntry, DEFAULT_COLUMN_WIDTH_CHARS, DEFAULT_ROW_HEIGHT_PT, GENERAL_CELL_XF_INDEX, HEADER_SIZE, MAX_RECORD_DATA_SIZE, RECORD_AI, RECORD_ARRAY, RECORD_BLANK, RECORD_BOF, RECORD_BOOLERR, RECORD_BOTTOMMARGIN, RECORD_BOUNDSHEET8, RECORD_CALCCOUNT, RECORD_CALCDELTA, RECORD_CALCITER, RECORD_CALCREFMODE, RECORD_CALCSAVERECALC, RECORD_CF, RECORD_CF12, RECORD_CFEX, RECORD_COLINFO, RECORD_CONDFMT, RECORD_CONDFMT12, RECORD_CONTINUE, RECORD_CONTINUEFRT12, RECORD_DATE1904, RECORD_DEFAULTROWHEIGHT, RECORD_DEFCOLWIDTH, RECORD_DIMENSIONS, RECORD_DV, RECORD_DVAL, RECORD_EOF, RECORD_EXTERNSHEET, RECORD_FILELOCK, RECORD_FILEPASS, RECORD_FONT, RECORD_FORMAT, RECORD_FORMULA, RECORD_HORIZONTALPAGEBREAKS, RECORD_INTERFACEHDR, RECORD_LABEL, RECORD_LABELSST, RECORD_LBL, RECORD_LEFTMARGIN, RECORD_MERGECELLS, RECORD_MSODRAWING, RECORD_MSODRAWINGGROUP, RECORD_MSODRAWINGSELECTION, RECORD_MULBLANK, RECORD_MULRK, RECORD_NOTE, RECORD_NUMBER, RECORD_OBJ, RECORD_PALETTE, RECORD_PRINTGRID, RECORD_PRINTROWCOL, RECORD_RIGHTMARGIN, RECORD_RK, RECORD_ROW, RECORD_RRDHEAD, RECORD_RRDINFO, RECORD_SERIES, RECORD_SERIESTEXT, RECORD_SETUP, RECORD_SHRFMLA, RECORD_SIINDEX, RECORD_SST, RECORD_STRING, RECORD_STYLE, RECORD_SUPBOOK, RECORD_TABLE, RECORD_TOPMARGIN, RECORD_TXO, RECORD_USREXCL, 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, readXLUnicodeStringNoCch, readXls, readXlsContent, recordByteLength, serialToIsoDate, serialToIsoDateTime, serialToIsoTime, splitSubstreams, twipsToPoints, writeBofData, writeCellXfRecord, writeFontRecord, writeFormatRecord, writePaletteRecord, writeRecord, writeRichExtendedString, writeShortXLUnicodeString, writeStyleRecord, writeStyleXfRecord, writeXLUnicodeString, writeXls, writeXlsContent };

package/dist/index.d.ts

@@ -1,25 +1,25 @@
 import { writeBofData } from "./biff/bof-writer.js";
 import { RecordBuilder } from "./biff/builder.js";
-import { t as BlockCursor } from "./cursor-VMtw9uVP.js";
+import { t as BlockCursor } from "./cursor-CnEuX5qE.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_CF, RECORD_CF12, RECORD_COLINFO, RECORD_CONDFMT, RECORD_CONDFMT12, RECORD_CONTINUE, RECORD_CONTINUEFRT12, RECORD_DATE1904, RECORD_DEFAULTROWHEIGHT, RECORD_DEFCOLWIDTH, RECORD_DIMENSIONS, RECORD_DV, RECORD_DVAL, RECORD_EOF, RECORD_EXTERNSHEET, RECORD_FILELOCK, RECORD_FILEPASS, RECORD_FONT, RECORD_FORMAT, RECORD_FORMULA, RECORD_HORIZONTALPAGEBREAKS, RECORD_INTERFACEHDR, RECORD_LABEL, RECORD_LABELSST, RECORD_LBL, RECORD_LEFTMARGIN, RECORD_MERGECELLS, RECORD_MULBLANK, RECORD_MULRK, RECORD_NOTE, RECORD_NUMBER, RECORD_OBJ, RECORD_PALETTE, RECORD_PRINTGRID, RECORD_PRINTROWCOL, RECORD_RIGHTMARGIN, RECORD_RK, RECORD_ROW, RECORD_RRDHEAD, RECORD_RRDINFO, RECORD_SETUP, RECORD_SHRFMLA, RECORD_SST, RECORD_STRING, RECORD_STYLE, RECORD_SUPBOOK, RECORD_TABLE, RECORD_TOPMARGIN, RECORD_TXO, RECORD_USREXCL, RECORD_VERTICALPAGEBREAKS, RECORD_WSBOOL, 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_AI, RECORD_ARRAY, RECORD_BLANK, RECORD_BOF, RECORD_BOOLERR, RECORD_BOTTOMMARGIN, RECORD_BOUNDSHEET8, RECORD_CALCCOUNT, RECORD_CALCDELTA, RECORD_CALCITER, RECORD_CALCREFMODE, RECORD_CALCSAVERECALC, RECORD_CF, RECORD_CF12, RECORD_CFEX, RECORD_COLINFO, RECORD_CONDFMT, RECORD_CONDFMT12, RECORD_CONTINUE, RECORD_CONTINUEFRT12, RECORD_DATE1904, RECORD_DEFAULTROWHEIGHT, RECORD_DEFCOLWIDTH, RECORD_DIMENSIONS, RECORD_DV, RECORD_DVAL, RECORD_EOF, RECORD_EXTERNSHEET, RECORD_FILELOCK, RECORD_FILEPASS, RECORD_FONT, RECORD_FORMAT, RECORD_FORMULA, RECORD_HORIZONTALPAGEBREAKS, RECORD_INTERFACEHDR, RECORD_LABEL, RECORD_LABELSST, RECORD_LBL, RECORD_LEFTMARGIN, RECORD_MERGECELLS, RECORD_MSODRAWING, RECORD_MSODRAWINGGROUP, RECORD_MSODRAWINGSELECTION, RECORD_MULBLANK, RECORD_MULRK, RECORD_NOTE, RECORD_NUMBER, RECORD_OBJ, RECORD_PALETTE, RECORD_PRINTGRID, RECORD_PRINTROWCOL, RECORD_RIGHTMARGIN, RECORD_RK, RECORD_ROW, RECORD_RRDHEAD, RECORD_RRDINFO, RECORD_SERIES, RECORD_SERIESTEXT, RECORD_SETUP, RECORD_SHRFMLA, RECORD_SIINDEX, RECORD_SST, RECORD_STRING, RECORD_STYLE, RECORD_SUPBOOK, RECORD_TABLE, RECORD_TOPMARGIN, RECORD_TXO, RECORD_USREXCL, RECORD_VERTICALPAGEBREAKS, RECORD_WSBOOL, RECORD_XF } from "./biff/record-types.js";
 import { concatRecords, writeRecord } from "./biff/record-writer.js";
 import { i as readRecords, n as BiffRecord, r as HEADER_SIZE, t as BiffFormatError } from "./records-G82UEVq8.js";
 import { decodeRkNumber } from "./biff/rk.js";
 import { writeRichExtendedString, writeShortXLUnicodeString, writeXLUnicodeString } from "./biff/string-writer.js";
 import { readRichExtendedString, readShortXLUnicodeString, readXLUnicodeString, readXLUnicodeStringNoCch } from "./biff/strings.js";
-import { a as splitSubstreams, i as recordByteLength, n as Substream, r as groupRecords, t as RecordGroup } from "./substreams-Dp5cZoUo.js";
+import { a as splitSubstreams, i as recordByteLength, n as Substream, r as groupRecords, t as RecordGroup } from "./substreams-CgTHx5kX.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 { 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 { DEFAULT_COLUMN_WIDTH_CHARS, DEFAULT_ROW_HEIGHT_PT, columnWidthToPoints, inchesToPoints, millimetresToPoints, pointsToColumnWidth, pointsToInches, pointsToTwips, twipsToPoints } from "./units.js";
 import { CellFormat, SheetEntry, WorkbookGlobals, formatCodeOf, readWorkbookGlobals } from "./workbook/globals.js";
 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, HEADER_SIZE, 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_CF, RECORD_CF12, RECORD_COLINFO, RECORD_CONDFMT, RECORD_CONDFMT12, RECORD_CONTINUE, RECORD_CONTINUEFRT12, RECORD_DATE1904, RECORD_DEFAULTROWHEIGHT, RECORD_DEFCOLWIDTH, RECORD_DIMENSIONS, RECORD_DV, RECORD_DVAL, RECORD_EOF, RECORD_EXTERNSHEET, RECORD_FILELOCK, RECORD_FILEPASS, RECORD_FONT, RECORD_FORMAT, RECORD_FORMULA, RECORD_HORIZONTALPAGEBREAKS, RECORD_INTERFACEHDR, RECORD_LABEL, RECORD_LABELSST, RECORD_LBL, RECORD_LEFTMARGIN, RECORD_MERGECELLS, RECORD_MULBLANK, RECORD_MULRK, RECORD_NOTE, RECORD_NUMBER, RECORD_OBJ, RECORD_PALETTE, RECORD_PRINTGRID, RECORD_PRINTROWCOL, RECORD_RIGHTMARGIN, RECORD_RK, RECORD_ROW, RECORD_RRDHEAD, RECORD_RRDINFO, RECORD_SETUP, RECORD_SHRFMLA, RECORD_SST, RECORD_STRING, RECORD_STYLE, RECORD_SUPBOOK, RECORD_TABLE, RECORD_TOPMARGIN, RECORD_TXO, RECORD_USREXCL, 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, readXLUnicodeStringNoCch, readXls, readXlsContent, recordByteLength, serialToIsoDate, serialToIsoDateTime, serialToIsoTime, splitSubstreams, twipsToPoints, writeBofData, writeCellXfRecord, writeFontRecord, writeFormatRecord, writePaletteRecord, writeRecord, writeRichExtendedString, writeShortXLUnicodeString, writeStyleRecord, writeStyleXfRecord, writeXLUnicodeString, writeXls, writeXlsContent };
+export { BIFF8_VERSION, BOF_TYPE_CHART, BOF_TYPE_MACRO, BOF_TYPE_WORKBOOK, BOF_TYPE_WORKSHEET, BiffFormatError, BiffRecord, BiffWriteError, BlockCursor, CellFormat, CellXfPlanEntry, DEFAULT_COLUMN_WIDTH_CHARS, DEFAULT_ROW_HEIGHT_PT, GENERAL_CELL_XF_INDEX, HEADER_SIZE, MAX_RECORD_DATA_SIZE, RECORD_AI, RECORD_ARRAY, RECORD_BLANK, RECORD_BOF, RECORD_BOOLERR, RECORD_BOTTOMMARGIN, RECORD_BOUNDSHEET8, RECORD_CALCCOUNT, RECORD_CALCDELTA, RECORD_CALCITER, RECORD_CALCREFMODE, RECORD_CALCSAVERECALC, RECORD_CF, RECORD_CF12, RECORD_CFEX, RECORD_COLINFO, RECORD_CONDFMT, RECORD_CONDFMT12, RECORD_CONTINUE, RECORD_CONTINUEFRT12, RECORD_DATE1904, RECORD_DEFAULTROWHEIGHT, RECORD_DEFCOLWIDTH, RECORD_DIMENSIONS, RECORD_DV, RECORD_DVAL, RECORD_EOF, RECORD_EXTERNSHEET, RECORD_FILELOCK, RECORD_FILEPASS, RECORD_FONT, RECORD_FORMAT, RECORD_FORMULA, RECORD_HORIZONTALPAGEBREAKS, RECORD_INTERFACEHDR, RECORD_LABEL, RECORD_LABELSST, RECORD_LBL, RECORD_LEFTMARGIN, RECORD_MERGECELLS, RECORD_MSODRAWING, RECORD_MSODRAWINGGROUP, RECORD_MSODRAWINGSELECTION, RECORD_MULBLANK, RECORD_MULRK, RECORD_NOTE, RECORD_NUMBER, RECORD_OBJ, RECORD_PALETTE, RECORD_PRINTGRID, RECORD_PRINTROWCOL, RECORD_RIGHTMARGIN, RECORD_RK, RECORD_ROW, RECORD_RRDHEAD, RECORD_RRDINFO, RECORD_SERIES, RECORD_SERIESTEXT, RECORD_SETUP, RECORD_SHRFMLA, RECORD_SIINDEX, RECORD_SST, RECORD_STRING, RECORD_STYLE, RECORD_SUPBOOK, RECORD_TABLE, RECORD_TOPMARGIN, RECORD_TXO, RECORD_USREXCL, 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, readXLUnicodeStringNoCch, readXls, readXlsContent, recordByteLength, serialToIsoDate, serialToIsoDateTime, serialToIsoTime, splitSubstreams, twipsToPoints, writeBofData, writeCellXfRecord, writeFontRecord, writeFormatRecord, writePaletteRecord, writeRecord, writeRichExtendedString, writeShortXLUnicodeString, writeStyleRecord, writeStyleXfRecord, writeXLUnicodeString, writeXls, writeXlsContent };

package/dist/index.js

@@ -1,16 +1,16 @@
-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_CF, RECORD_CF12, RECORD_COLINFO, RECORD_CONDFMT, RECORD_CONDFMT12, RECORD_CONTINUE, RECORD_CONTINUEFRT12, RECORD_DATE1904, RECORD_DEFAULTROWHEIGHT, RECORD_DEFCOLWIDTH, RECORD_DIMENSIONS, RECORD_DV, RECORD_DVAL, RECORD_EOF, RECORD_EXTERNSHEET, RECORD_FILELOCK, RECORD_FILEPASS, RECORD_FONT, RECORD_FORMAT, RECORD_FORMULA, RECORD_HORIZONTALPAGEBREAKS, RECORD_INTERFACEHDR, RECORD_LABEL, RECORD_LABELSST, RECORD_LBL, RECORD_LEFTMARGIN, RECORD_MERGECELLS, RECORD_MULBLANK, RECORD_MULRK, RECORD_NOTE, RECORD_NUMBER, RECORD_OBJ, RECORD_PALETTE, RECORD_PRINTGRID, RECORD_PRINTROWCOL, RECORD_RIGHTMARGIN, RECORD_RK, RECORD_ROW, RECORD_RRDHEAD, RECORD_RRDINFO, RECORD_SETUP, RECORD_SHRFMLA, RECORD_SST, RECORD_STRING, RECORD_STYLE, RECORD_SUPBOOK, RECORD_TABLE, RECORD_TOPMARGIN, RECORD_TXO, RECORD_USREXCL, RECORD_VERTICALPAGEBREAKS, RECORD_WSBOOL, 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_AI, RECORD_ARRAY, RECORD_BLANK, RECORD_BOF, RECORD_BOOLERR, RECORD_BOTTOMMARGIN, RECORD_BOUNDSHEET8, RECORD_CALCCOUNT, RECORD_CALCDELTA, RECORD_CALCITER, RECORD_CALCREFMODE, RECORD_CALCSAVERECALC, RECORD_CF, RECORD_CF12, RECORD_CFEX, RECORD_COLINFO, RECORD_CONDFMT, RECORD_CONDFMT12, RECORD_CONTINUE, RECORD_CONTINUEFRT12, RECORD_DATE1904, RECORD_DEFAULTROWHEIGHT, RECORD_DEFCOLWIDTH, RECORD_DIMENSIONS, RECORD_DV, RECORD_DVAL, RECORD_EOF, RECORD_EXTERNSHEET, RECORD_FILELOCK, RECORD_FILEPASS, RECORD_FONT, RECORD_FORMAT, RECORD_FORMULA, RECORD_HORIZONTALPAGEBREAKS, RECORD_INTERFACEHDR, RECORD_LABEL, RECORD_LABELSST, RECORD_LBL, RECORD_LEFTMARGIN, RECORD_MERGECELLS, RECORD_MSODRAWING, RECORD_MSODRAWINGGROUP, RECORD_MSODRAWINGSELECTION, RECORD_MULBLANK, RECORD_MULRK, RECORD_NOTE, RECORD_NUMBER, RECORD_OBJ, RECORD_PALETTE, RECORD_PRINTGRID, RECORD_PRINTROWCOL, RECORD_RIGHTMARGIN, RECORD_RK, RECORD_ROW, RECORD_RRDHEAD, RECORD_RRDINFO, RECORD_SERIES, RECORD_SERIESTEXT, RECORD_SETUP, RECORD_SHRFMLA, RECORD_SIINDEX, RECORD_SST, RECORD_STRING, RECORD_STYLE, RECORD_SUPBOOK, RECORD_TABLE, RECORD_TOPMARGIN, RECORD_TXO, RECORD_USREXCL, RECORD_VERTICALPAGEBREAKS, RECORD_WSBOOL, RECORD_XF } from "./biff/record-types.js";
 import { BiffFormatError, HEADER_SIZE, readRecords } from "./biff/records.js";
 import { SUMMARY_INFORMATION_STREAM, isXlsFile, readWorkbookStreams } from "./container.js";
-import { columnWidthToPoints, inchesToPoints, millimetresToPoints, pointsToColumnWidth, pointsToInches, pointsToTwips, twipsToPoints } from "./units.js";
+import { DEFAULT_COLUMN_WIDTH_CHARS, DEFAULT_ROW_HEIGHT_PT, columnWidthToPoints, inchesToPoints, millimetresToPoints, pointsToColumnWidth, pointsToInches, pointsToTwips, twipsToPoints } from "./units.js";
 import { groupRecords, recordByteLength, splitSubstreams } from "./biff/substreams.js";
 import { BlockCursor } from "./biff/cursor.js";
 import { readRichExtendedString, readShortXLUnicodeString, readXLUnicodeString, readXLUnicodeStringNoCch } from "./biff/strings.js";
+import { errorCodeOf, errorTextOf } from "./biff/errors.js";
 import { BiffWriteError } from "./biff/write-errors.js";
 import { isoDateTimeToSerial, isoDateToSerial, isoTimeToSerial, serialToIsoDate, serialToIsoDateTime, serialToIsoTime } from "./serial.js";
 import { RecordBuilder } from "./biff/builder.js";
 import { concatRecords, writeRecord } from "./biff/record-writer.js";
 import { formatCodeOf, readWorkbookGlobals } from "./workbook/globals.js";
-import { errorCodeOf, errorTextOf } from "./biff/errors.js";
 import { decodeRkNumber } from "./biff/rk.js";
 import { readSheetRecords } from "./workbook/sheet.js";
 import { readXls, readXlsContent } from "./content.js";
@@ -22,4 +22,4 @@ import { GENERAL_CELL_XF_INDEX, buildWorkbookGlobals } from "./workbook/globals-
 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, HEADER_SIZE, 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_CF, RECORD_CF12, RECORD_COLINFO, RECORD_CONDFMT, RECORD_CONDFMT12, RECORD_CONTINUE, RECORD_CONTINUEFRT12, RECORD_DATE1904, RECORD_DEFAULTROWHEIGHT, RECORD_DEFCOLWIDTH, RECORD_DIMENSIONS, RECORD_DV, RECORD_DVAL, RECORD_EOF, RECORD_EXTERNSHEET, RECORD_FILELOCK, RECORD_FILEPASS, RECORD_FONT, RECORD_FORMAT, RECORD_FORMULA, RECORD_HORIZONTALPAGEBREAKS, RECORD_INTERFACEHDR, RECORD_LABEL, RECORD_LABELSST, RECORD_LBL, RECORD_LEFTMARGIN, RECORD_MERGECELLS, RECORD_MULBLANK, RECORD_MULRK, RECORD_NOTE, RECORD_NUMBER, RECORD_OBJ, RECORD_PALETTE, RECORD_PRINTGRID, RECORD_PRINTROWCOL, RECORD_RIGHTMARGIN, RECORD_RK, RECORD_ROW, RECORD_RRDHEAD, RECORD_RRDINFO, RECORD_SETUP, RECORD_SHRFMLA, RECORD_SST, RECORD_STRING, RECORD_STYLE, RECORD_SUPBOOK, RECORD_TABLE, RECORD_TOPMARGIN, RECORD_TXO, RECORD_USREXCL, 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, readXLUnicodeStringNoCch, readXls, readXlsContent, recordByteLength, serialToIsoDate, serialToIsoDateTime, serialToIsoTime, splitSubstreams, twipsToPoints, writeBofData, writeCellXfRecord, writeFontRecord, writeFormatRecord, writePaletteRecord, writeRecord, writeRichExtendedString, writeShortXLUnicodeString, writeStyleRecord, writeStyleXfRecord, writeXLUnicodeString, writeXls, writeXlsContent };
+export { BIFF8_VERSION, BOF_TYPE_CHART, BOF_TYPE_MACRO, BOF_TYPE_WORKBOOK, BOF_TYPE_WORKSHEET, BiffFormatError, BiffWriteError, BlockCursor, DEFAULT_COLUMN_WIDTH_CHARS, DEFAULT_ROW_HEIGHT_PT, GENERAL_CELL_XF_INDEX, HEADER_SIZE, MAX_RECORD_DATA_SIZE, RECORD_AI, RECORD_ARRAY, RECORD_BLANK, RECORD_BOF, RECORD_BOOLERR, RECORD_BOTTOMMARGIN, RECORD_BOUNDSHEET8, RECORD_CALCCOUNT, RECORD_CALCDELTA, RECORD_CALCITER, RECORD_CALCREFMODE, RECORD_CALCSAVERECALC, RECORD_CF, RECORD_CF12, RECORD_CFEX, RECORD_COLINFO, RECORD_CONDFMT, RECORD_CONDFMT12, RECORD_CONTINUE, RECORD_CONTINUEFRT12, RECORD_DATE1904, RECORD_DEFAULTROWHEIGHT, RECORD_DEFCOLWIDTH, RECORD_DIMENSIONS, RECORD_DV, RECORD_DVAL, RECORD_EOF, RECORD_EXTERNSHEET, RECORD_FILELOCK, RECORD_FILEPASS, RECORD_FONT, RECORD_FORMAT, RECORD_FORMULA, RECORD_HORIZONTALPAGEBREAKS, RECORD_INTERFACEHDR, RECORD_LABEL, RECORD_LABELSST, RECORD_LBL, RECORD_LEFTMARGIN, RECORD_MERGECELLS, RECORD_MSODRAWING, RECORD_MSODRAWINGGROUP, RECORD_MSODRAWINGSELECTION, RECORD_MULBLANK, RECORD_MULRK, RECORD_NOTE, RECORD_NUMBER, RECORD_OBJ, RECORD_PALETTE, RECORD_PRINTGRID, RECORD_PRINTROWCOL, RECORD_RIGHTMARGIN, RECORD_RK, RECORD_ROW, RECORD_RRDHEAD, RECORD_RRDINFO, RECORD_SERIES, RECORD_SERIESTEXT, RECORD_SETUP, RECORD_SHRFMLA, RECORD_SIINDEX, RECORD_SST, RECORD_STRING, RECORD_STYLE, RECORD_SUPBOOK, RECORD_TABLE, RECORD_TOPMARGIN, RECORD_TXO, RECORD_USREXCL, 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, readXLUnicodeStringNoCch, readXls, readXlsContent, recordByteLength, serialToIsoDate, serialToIsoDateTime, serialToIsoTime, splitSubstreams, twipsToPoints, writeBofData, writeCellXfRecord, writeFontRecord, writeFormatRecord, writePaletteRecord, writeRecord, writeRichExtendedString, writeShortXLUnicodeString, writeStyleRecord, writeStyleXfRecord, writeXLUnicodeString, writeXls, writeXlsContent };

package/dist/{print-names-CCwUHAoL.d.cts → print-names-B2OR0fvs.d.cts}

@@ -1,4 +1,4 @@
-import { t as RecordGroup } from "./substreams-CHv3oWmn.cjs";
+import { t as RecordGroup } from "./substreams-XDNgDvRJ.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. */

package/dist/{print-names-CxAbgcjB.d.ts → print-names-BXcmmwVi.d.ts}

@@ -1,4 +1,4 @@
-import { t as RecordGroup } from "./substreams-Dp5cZoUo.js";
+import { t as RecordGroup } from "./substreams-CgTHx5kX.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. */

package/dist/{ptg-CCBbJLZJ.d.cts → ptg-75v7MhaA.d.cts}

@@ -37,8 +37,14 @@ interface ParseFormulaOptions {
   readonly relativeTo?: FormulaOrigin;
   /** The RgbExtra trailer following `rgce` in the same CellParsedFormula/ArrayParsedFormula ([MS-XLS] 7dd67f0a/242bcf20) -- consulted only when `rgce` contains a PtgArray, one PtgExtraArray pulled off the front for each in the order both arrays share ([MS-XLS] 70f743b2: "The order of the structures MUST be the same as the order of the Ptgs"). Absent (or exhausted before a PtgArray needs it) aborts the parse rather than guessing at the array's values. */
   readonly rgcb?: Uint8Array<ArrayBuffer>;
+  /** Invoked with the raw, unquoted text of every PtgStr operand this formula contains, in encounter order -- a side channel for a caller that needs a literal string operand out of a formula whose overall shape it isn't otherwise trying to interpret (conditional-format-12.ts's own readCfTextFilterRule, extracting the search text CFExTextTemplateParams itself has no field for). Does not affect the returned formula text, which still renders the same operand quoted via quoteStringLiteral as it always has. */
+  readonly onStringLiteral?: (value: string) => void;
 }
 declare function parseFormulaText(rgce: Uint8Array<ArrayBuffer>, context: FormulaSheetContext, options?: ParseFormulaOptions): string | undefined;
+/**
+ * Returns the raw text of the first PtgStr operand `rgce` contains, or undefined if it contains none -- a narrower question than parseFormulaText's own "render the whole formula", answerable even when the formula wraps that operand in functions this reader has no other reason to understand. Exists for conditional-format-12.ts's own readCfTextFilterRule: a CF12/CFExNonCF12 containsText-family rule states which of the four text-comparison sub-types it is via CFExTextTemplateParams.ctp, but carries the literal search text nowhere else but as this operand in its own formula (Excel's real generated shape being e.g. NOT(ISERROR(SEARCH("text",A1))) for containsText -- see conditional-format-ex.ts's own top comment for the full citation). Walks the whole token stream via parseFormulaText's own onStringLiteral hook rather than scanning for the PtgStr opcode directly, since a raw byte scan cannot tell an opcode byte from a length or count belonging to some other token's own payload.
+ */
+declare function extractFirstStringLiteral(rgce: Uint8Array<ArrayBuffer>, context: FormulaSheetContext): string | undefined;
 /**
  * If `rgce` is EXACTLY one PtgExp token -- which is the only shape a Formula record belonging to a shared or array formula group ever has, including the group's own base cell, which points at itself -- returns the (row, column) of the Formula record that carries the real expression (a ShrFmla or Array record immediately follows it). Returns undefined for every other rgce, so a caller can try this first and fall back to parseFormulaText for a formula that merely happens to open with byte 0x01 for some other reason (it cannot: no other single-byte-opcode Ptg in this reader's vocabulary is 0x01, but a malformed or foreign rgce is not assumed well-formed here either) or is simply longer than five bytes.
  *
@@ -46,4 +52,4 @@ declare function parseFormulaText(rgce: Uint8Array<ArrayBuffer>, context: Formul
  */
 declare function readPtgExpBase(rgce: Uint8Array<ArrayBuffer>): FormulaOrigin | undefined;
 //#endregion
-export { SheetRange as a, ParseFormulaOptions as i, FormulaOrigin as n, parseFormulaText as o, FormulaSheetContext as r, readPtgExpBase as s, ExternalSheetLabel as t };
+export { SheetRange as a, readPtgExpBase as c, ParseFormulaOptions as i, FormulaOrigin as n, extractFirstStringLiteral as o, FormulaSheetContext as r, parseFormulaText as s, ExternalSheetLabel as t };

package/dist/{ptg-CCBbJLZJ.d.ts → ptg-75v7MhaA.d.ts}

@@ -37,8 +37,14 @@ interface ParseFormulaOptions {
   readonly relativeTo?: FormulaOrigin;
   /** The RgbExtra trailer following `rgce` in the same CellParsedFormula/ArrayParsedFormula ([MS-XLS] 7dd67f0a/242bcf20) -- consulted only when `rgce` contains a PtgArray, one PtgExtraArray pulled off the front for each in the order both arrays share ([MS-XLS] 70f743b2: "The order of the structures MUST be the same as the order of the Ptgs"). Absent (or exhausted before a PtgArray needs it) aborts the parse rather than guessing at the array's values. */
   readonly rgcb?: Uint8Array<ArrayBuffer>;
+  /** Invoked with the raw, unquoted text of every PtgStr operand this formula contains, in encounter order -- a side channel for a caller that needs a literal string operand out of a formula whose overall shape it isn't otherwise trying to interpret (conditional-format-12.ts's own readCfTextFilterRule, extracting the search text CFExTextTemplateParams itself has no field for). Does not affect the returned formula text, which still renders the same operand quoted via quoteStringLiteral as it always has. */
+  readonly onStringLiteral?: (value: string) => void;
 }
 declare function parseFormulaText(rgce: Uint8Array<ArrayBuffer>, context: FormulaSheetContext, options?: ParseFormulaOptions): string | undefined;
+/**
+ * Returns the raw text of the first PtgStr operand `rgce` contains, or undefined if it contains none -- a narrower question than parseFormulaText's own "render the whole formula", answerable even when the formula wraps that operand in functions this reader has no other reason to understand. Exists for conditional-format-12.ts's own readCfTextFilterRule: a CF12/CFExNonCF12 containsText-family rule states which of the four text-comparison sub-types it is via CFExTextTemplateParams.ctp, but carries the literal search text nowhere else but as this operand in its own formula (Excel's real generated shape being e.g. NOT(ISERROR(SEARCH("text",A1))) for containsText -- see conditional-format-ex.ts's own top comment for the full citation). Walks the whole token stream via parseFormulaText's own onStringLiteral hook rather than scanning for the PtgStr opcode directly, since a raw byte scan cannot tell an opcode byte from a length or count belonging to some other token's own payload.
+ */
+declare function extractFirstStringLiteral(rgce: Uint8Array<ArrayBuffer>, context: FormulaSheetContext): string | undefined;
 /**
  * If `rgce` is EXACTLY one PtgExp token -- which is the only shape a Formula record belonging to a shared or array formula group ever has, including the group's own base cell, which points at itself -- returns the (row, column) of the Formula record that carries the real expression (a ShrFmla or Array record immediately follows it). Returns undefined for every other rgce, so a caller can try this first and fall back to parseFormulaText for a formula that merely happens to open with byte 0x01 for some other reason (it cannot: no other single-byte-opcode Ptg in this reader's vocabulary is 0x01, but a malformed or foreign rgce is not assumed well-formed here either) or is simply longer than five bytes.
  *
@@ -46,4 +52,4 @@ declare function parseFormulaText(rgce: Uint8Array<ArrayBuffer>, context: Formul
  */
 declare function readPtgExpBase(rgce: Uint8Array<ArrayBuffer>): FormulaOrigin | undefined;
 //#endregion
-export { SheetRange as a, ParseFormulaOptions as i, FormulaOrigin as n, parseFormulaText as o, FormulaSheetContext as r, readPtgExpBase as s, ExternalSheetLabel as t };
+export { SheetRange as a, readPtgExpBase as c, ParseFormulaOptions as i, FormulaOrigin as n, extractFirstStringLiteral as o, FormulaSheetContext as r, parseFormulaText as s, ExternalSheetLabel as t };

package/dist/{substreams-Dp5cZoUo.d.ts → substreams-CgTHx5kX.d.ts}

@@ -17,7 +17,7 @@ interface Substream {
 }
 /** Joins each record to the Continue records following it, keeping the blocks separate. */
 declare function groupRecords(records: readonly BiffRecord[]): readonly RecordGroup[];
-/** Splits a grouped record sequence into its substreams, verifying each BOF declares BIFF8. */
+/** Splits a grouped record sequence into its substreams, verifying each BOF declares BIFF8. A BOF met while a substream is already open pushes that substream onto a stack and starts a nested one; the nested substream is closed and reported (via its own EOF) before its parent resumes collecting records -- see this module's own top comment for why a stack, not a flat "BOF ends the previous substream", is what a chart embedded in a worksheet needs. */
 declare function splitSubstreams(groups: readonly RecordGroup[]): readonly Substream[];
 //#endregion
 export { splitSubstreams as a, recordByteLength as i, Substream as n, groupRecords as r, RecordGroup as t };

package/dist/{substreams-CHv3oWmn.d.cts → substreams-XDNgDvRJ.d.cts}

@@ -17,7 +17,7 @@ interface Substream {
 }
 /** Joins each record to the Continue records following it, keeping the blocks separate. */
 declare function groupRecords(records: readonly BiffRecord[]): readonly RecordGroup[];
-/** Splits a grouped record sequence into its substreams, verifying each BOF declares BIFF8. */
+/** Splits a grouped record sequence into its substreams, verifying each BOF declares BIFF8. A BOF met while a substream is already open pushes that substream onto a stack and starts a nested one; the nested substream is closed and reported (via its own EOF) before its parent resumes collecting records -- see this module's own top comment for why a stack, not a flat "BOF ends the previous substream", is what a chart embedded in a worksheet needs. */
 declare function splitSubstreams(groups: readonly RecordGroup[]): readonly Substream[];
 //#endregion
 export { splitSubstreams as a, recordByteLength as i, Substream as n, groupRecords as r, RecordGroup as t };

package/dist/units.cjs

@@ -13,6 +13,11 @@ const MILLIMETRES_PER_INCH = 25.4;
 * 7 is the Calibri-11-at-96dpi value every mainstream spreadsheet tool assumes by default, and the same constant ooxml.js's xlsx reader uses -- so a column of a given width reads back the same number of points whether it arrived as .xls or .xlsx. This package has no font-metrics engine and so cannot compute a workbook's actual digit width from whatever font its Normal style really uses: a workbook using a materially narrower or wider font reads column widths that are honestly approximate rather than exact.
 */
 const MAX_DIGIT_WIDTH_PX = 7;
+/**
+* Excel's own "Normal" style column width (8.43 characters) and default row height (15pt), for a worksheet grid cell a drawing shape's own anchor names but that carries no explicit ColInfo/Row record of its own to size it -- the identical fallback constants ooxml.js's own xlsx drawing reader uses for the same reason (no font-metrics engine to derive a workbook's real default from), so a shape anchored to an undeclared cell places identically whether it arrived as .xls or .xlsx.
+*/
+const DEFAULT_COLUMN_WIDTH_CHARS = 8.43;
+const DEFAULT_ROW_HEIGHT_PT = 15;
 /** A Row record's height, in twips, as points. */
 function twipsToPoints(twips) {
 	return twips / TWIPS_PER_POINT;
@@ -58,6 +63,8 @@ function pointsToColumnWidth(points) {
 	return Math.max(coldx, 0);
 }
 //#endregion
+exports.DEFAULT_COLUMN_WIDTH_CHARS = DEFAULT_COLUMN_WIDTH_CHARS;
+exports.DEFAULT_ROW_HEIGHT_PT = DEFAULT_ROW_HEIGHT_PT;
 exports.columnWidthToPoints = columnWidthToPoints;
 exports.inchesToPoints = inchesToPoints;
 exports.millimetresToPoints = millimetresToPoints;

package/dist/units.d.cts

@@ -1,4 +1,9 @@
 //#region src/units.d.ts
+/**
+ * Excel's own "Normal" style column width (8.43 characters) and default row height (15pt), for a worksheet grid cell a drawing shape's own anchor names but that carries no explicit ColInfo/Row record of its own to size it -- the identical fallback constants ooxml.js's own xlsx drawing reader uses for the same reason (no font-metrics engine to derive a workbook's real default from), so a shape anchored to an undeclared cell places identically whether it arrived as .xls or .xlsx.
+ */
+declare const DEFAULT_COLUMN_WIDTH_CHARS = 8.43;
+declare const DEFAULT_ROW_HEIGHT_PT = 15;
 /** A Row record's height, in twips, as points. */
 declare function twipsToPoints(twips: number): number;
 /** A margin record's own Xnum ([MS-XLS] 2.4.151 and its three siblings), in inches, as points. */
@@ -22,4 +27,4 @@ declare function pointsToTwips(points: number): number;
  */
 declare function pointsToColumnWidth(points: number): number;
 //#endregion
-export { columnWidthToPoints, inchesToPoints, millimetresToPoints, pointsToColumnWidth, pointsToInches, pointsToTwips, twipsToPoints };
+export { DEFAULT_COLUMN_WIDTH_CHARS, DEFAULT_ROW_HEIGHT_PT, columnWidthToPoints, inchesToPoints, millimetresToPoints, pointsToColumnWidth, pointsToInches, pointsToTwips, twipsToPoints };

package/dist/units.d.ts

@@ -1,4 +1,9 @@
 //#region src/units.d.ts
+/**
+ * Excel's own "Normal" style column width (8.43 characters) and default row height (15pt), for a worksheet grid cell a drawing shape's own anchor names but that carries no explicit ColInfo/Row record of its own to size it -- the identical fallback constants ooxml.js's own xlsx drawing reader uses for the same reason (no font-metrics engine to derive a workbook's real default from), so a shape anchored to an undeclared cell places identically whether it arrived as .xls or .xlsx.
+ */
+declare const DEFAULT_COLUMN_WIDTH_CHARS = 8.43;
+declare const DEFAULT_ROW_HEIGHT_PT = 15;
 /** A Row record's height, in twips, as points. */
 declare function twipsToPoints(twips: number): number;
 /** A margin record's own Xnum ([MS-XLS] 2.4.151 and its three siblings), in inches, as points. */
@@ -22,4 +27,4 @@ declare function pointsToTwips(points: number): number;
  */
 declare function pointsToColumnWidth(points: number): number;
 //#endregion
-export { columnWidthToPoints, inchesToPoints, millimetresToPoints, pointsToColumnWidth, pointsToInches, pointsToTwips, twipsToPoints };
+export { DEFAULT_COLUMN_WIDTH_CHARS, DEFAULT_ROW_HEIGHT_PT, columnWidthToPoints, inchesToPoints, millimetresToPoints, pointsToColumnWidth, pointsToInches, pointsToTwips, twipsToPoints };

package/dist/units.js

@@ -12,6 +12,11 @@ const MILLIMETRES_PER_INCH = 25.4;
 * 7 is the Calibri-11-at-96dpi value every mainstream spreadsheet tool assumes by default, and the same constant ooxml.js's xlsx reader uses -- so a column of a given width reads back the same number of points whether it arrived as .xls or .xlsx. This package has no font-metrics engine and so cannot compute a workbook's actual digit width from whatever font its Normal style really uses: a workbook using a materially narrower or wider font reads column widths that are honestly approximate rather than exact.
 */
 const MAX_DIGIT_WIDTH_PX = 7;
+/**
+* Excel's own "Normal" style column width (8.43 characters) and default row height (15pt), for a worksheet grid cell a drawing shape's own anchor names but that carries no explicit ColInfo/Row record of its own to size it -- the identical fallback constants ooxml.js's own xlsx drawing reader uses for the same reason (no font-metrics engine to derive a workbook's real default from), so a shape anchored to an undeclared cell places identically whether it arrived as .xls or .xlsx.
+*/
+const DEFAULT_COLUMN_WIDTH_CHARS = 8.43;
+const DEFAULT_ROW_HEIGHT_PT = 15;
 /** A Row record's height, in twips, as points. */
 function twipsToPoints(twips) {
 	return twips / TWIPS_PER_POINT;
@@ -57,4 +62,4 @@ function pointsToColumnWidth(points) {
 	return Math.max(coldx, 0);
 }
 //#endregion
-export { columnWidthToPoints, inchesToPoints, millimetresToPoints, pointsToColumnWidth, pointsToInches, pointsToTwips, twipsToPoints };
+export { DEFAULT_COLUMN_WIDTH_CHARS, DEFAULT_ROW_HEIGHT_PT, columnWidthToPoints, inchesToPoints, millimetresToPoints, pointsToColumnWidth, pointsToInches, pointsToTwips, twipsToPoints };