xls-codec 3.0.0 → 4.0.0

package/dist/biff/substreams.js

@@ -1,6 +1,10 @@
 import "./record-types.js";
 import { BiffFormatError } from "./records.js";
 //#region src/biff/substreams.ts
+/** The total byte length of a record's data across every block (the base record's and any Continues that followed it) -- what a reader needs whenever a trailing field's own length is implied by "whatever is left" rather than stated by a preceding count (a Mul record's entry count, an SST's own bounds check, a formula's RgbExtra trailer). */
+function recordByteLength(record) {
+	return record.blocks.reduce((sum, block) => sum + block.length, 0);
+}
 /** Joins each record to the Continue records following it, keeping the blocks separate. */
 function groupRecords(records) {
 	const groups = [];
@@ -66,4 +70,4 @@ function readBofDocumentType(group) {
 	return view.getUint16(2, true);
 }
 //#endregion
-export { groupRecords, splitSubstreams };
+export { groupRecords, recordByteLength, splitSubstreams };

package/dist/index.cjs

@@ -109,8 +109,10 @@ exports.readShortXLUnicodeString = require_biff_strings.readShortXLUnicodeString
 exports.readWorkbookGlobals = require_workbook_globals.readWorkbookGlobals;
 exports.readWorkbookStreams = require_container.readWorkbookStreams;
 exports.readXLUnicodeString = require_biff_strings.readXLUnicodeString;
+exports.readXLUnicodeStringNoCch = require_biff_strings.readXLUnicodeStringNoCch;
 exports.readXls = require_content.readXls;
 exports.readXlsContent = require_content.readXlsContent;
+exports.recordByteLength = require_biff_substreams.recordByteLength;
 exports.serialToIsoDate = require_serial.serialToIsoDate;
 exports.serialToIsoDateTime = require_serial.serialToIsoDateTime;
 exports.serialToIsoTime = require_serial.serialToIsoTime;

package/dist/index.d.cts

@@ -7,8 +7,8 @@ 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 { i as splitSubstreams, n as Substream, r as groupRecords, t as RecordGroup } from "./substreams-Ddtvn_Vr.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-Cpy5Fi3d.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";
@@ -22,4 +22,4 @@ import { RawCell, RawCellValue, RawColumn, RawPrintSettings, RawRange, RawRow, R
 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 };
+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, 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

@@ -7,8 +7,8 @@ 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 { i as splitSubstreams, n as Substream, r as groupRecords, t as RecordGroup } from "./substreams-D7dQiJbp.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-CmyZMtuM.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";
@@ -22,4 +22,4 @@ import { RawCell, RawCellValue, RawColumn, RawPrintSettings, RawRange, RawRow, R
 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 };
+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, 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

@@ -2,11 +2,11 @@ import { BIFF8_VERSION, BOF_TYPE_CHART, BOF_TYPE_MACRO, BOF_TYPE_WORKBOOK, BOF_T
 import { BiffFormatError, 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 { groupRecords, splitSubstreams } from "./biff/substreams.js";
+import { groupRecords, recordByteLength, splitSubstreams } from "./biff/substreams.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 { readRichExtendedString, readShortXLUnicodeString, readXLUnicodeString, readXLUnicodeStringNoCch } 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";
@@ -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, 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 };
+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, 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-DUlpVE00.d.ts → print-names-C-PQ2vAy.d.ts}

@@ -1,4 +1,4 @@
-import { t as RecordGroup } from "./substreams-D7dQiJbp.js";
+import { t as RecordGroup } from "./substreams-CmyZMtuM.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/{print-names-D-njuzVw.d.cts → print-names-DyYloloV.d.cts}

@@ -1,4 +1,4 @@
-import { t as RecordGroup } from "./substreams-Ddtvn_Vr.cjs";
+import { t as RecordGroup } from "./substreams-Cpy5Fi3d.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/ptg-CCBbJLZJ.d.cts

@@ -0,0 +1,49 @@
+//#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;
+}
+/**
+ * A 3D reference's sheet-prefix label, already fully formatted by workbook/globals.ts, for an ixti this reader cannot resolve into a plain SheetRange -- a genuinely external workbook (label carries `[workbook]sheet` or `[workbook]first:last`) or a supporting link of a kind this reader never resolves a sheet name from at all (add-in, DDE/OLE, same-sheet, unused, an unresolved sheet index, or a workbook name this reader's own deliberately partial VirtualPath decoding could not isolate -- label then carries a bracketed `#REF!(reason)` diagnostic, or a `[EXTERNAL]` placeholder workbook name, in place of real recovered data). Kept as a single pre-formatted string rather than a further structured shape, since resolveSheetLabel below only ever needs the finished label text and every other consumer of a 3D reference's sheet name is upstream of this module (see WorkbookGlobals.sheetRanges, which this type's own sheetRanges field matches field-for-field).
+ *
+ * `diagnostic` says which of those two this is: false only when both the external workbook's own file name and its sheet name(s) were genuinely recovered from the file's own virtPath and rgst, in which case `label` is real data worth writing back out as a formula's sheet-scope text; true whenever `label` instead carries this reader's OWN placeholder text standing in for something it could not resolve. resolveSheetLabel treats a diagnostic label the same as any other construct this reader cannot resolve -- the containing formula is left absent rather than having synthetic, non-formula text spliced into what a spreadsheet application would otherwise treat as real, writable formula content (see documents.js's own write paths, which take ContentSheetCell.formula as literal, verbatim formula text with no further validation).
+ *
+ * No `kind` tag beyond this: SheetRange's two fields are both required and this type's own `label`/`diagnostic` fields are required too, so the two shapes are already mutually exclusive by construction and a plain `"label" in candidate` check discriminates them.
+ */
+interface ExternalSheetLabel {
+  readonly label: string;
+  readonly diagnostic: boolean;
+}
+/** 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 scope (undefined where this reader has nothing at all to say about 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 | ExternalSheetLabel | undefined)[];
+}
+/** A cell position a relative Ptg token's offset is resolved against -- the referencing cell currently being expanded, never the shared formula's own base cell. Exported only because it appears in ParseFormulaOptions.relativeTo and readPtgExpBase's own return type, both public. */
+interface FormulaOrigin {
+  readonly row: number;
+  readonly column: number;
+}
+/**
+ * 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 defined name, a natural-language reference, or a data table (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/SharedParsedFormula.cce/ArrayParsedFormula.cce) by the caller -- this function reads exactly that many bytes and nothing past them.
+ */
+interface ParseFormulaOptions {
+  /** The cell this formula is being evaluated for -- present only when `rgce` is a ShrFmla's own SharedParsedFormula being expanded for one specific referencing cell (see workbook/sheet.ts's collectFormulaGroups), which is the only place PtgRefN/PtgAreaN are legal. Absent for every other caller, in which case meeting one of those tokens aborts the parse exactly as it always has. */
+  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>;
+}
+declare function parseFormulaText(rgce: Uint8Array<ArrayBuffer>, context: FormulaSheetContext, options?: ParseFormulaOptions): 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.
+ *
+ * Exported for workbook/sheet.ts's collectFormulaGroups, which joins the returned cell against whichever ShrFmla/Array record follows the Formula record found there.
+ */
+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 };

package/dist/ptg-CCBbJLZJ.d.ts

@@ -0,0 +1,49 @@
+//#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;
+}
+/**
+ * A 3D reference's sheet-prefix label, already fully formatted by workbook/globals.ts, for an ixti this reader cannot resolve into a plain SheetRange -- a genuinely external workbook (label carries `[workbook]sheet` or `[workbook]first:last`) or a supporting link of a kind this reader never resolves a sheet name from at all (add-in, DDE/OLE, same-sheet, unused, an unresolved sheet index, or a workbook name this reader's own deliberately partial VirtualPath decoding could not isolate -- label then carries a bracketed `#REF!(reason)` diagnostic, or a `[EXTERNAL]` placeholder workbook name, in place of real recovered data). Kept as a single pre-formatted string rather than a further structured shape, since resolveSheetLabel below only ever needs the finished label text and every other consumer of a 3D reference's sheet name is upstream of this module (see WorkbookGlobals.sheetRanges, which this type's own sheetRanges field matches field-for-field).
+ *
+ * `diagnostic` says which of those two this is: false only when both the external workbook's own file name and its sheet name(s) were genuinely recovered from the file's own virtPath and rgst, in which case `label` is real data worth writing back out as a formula's sheet-scope text; true whenever `label` instead carries this reader's OWN placeholder text standing in for something it could not resolve. resolveSheetLabel treats a diagnostic label the same as any other construct this reader cannot resolve -- the containing formula is left absent rather than having synthetic, non-formula text spliced into what a spreadsheet application would otherwise treat as real, writable formula content (see documents.js's own write paths, which take ContentSheetCell.formula as literal, verbatim formula text with no further validation).
+ *
+ * No `kind` tag beyond this: SheetRange's two fields are both required and this type's own `label`/`diagnostic` fields are required too, so the two shapes are already mutually exclusive by construction and a plain `"label" in candidate` check discriminates them.
+ */
+interface ExternalSheetLabel {
+  readonly label: string;
+  readonly diagnostic: boolean;
+}
+/** 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 scope (undefined where this reader has nothing at all to say about 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 | ExternalSheetLabel | undefined)[];
+}
+/** A cell position a relative Ptg token's offset is resolved against -- the referencing cell currently being expanded, never the shared formula's own base cell. Exported only because it appears in ParseFormulaOptions.relativeTo and readPtgExpBase's own return type, both public. */
+interface FormulaOrigin {
+  readonly row: number;
+  readonly column: number;
+}
+/**
+ * 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 defined name, a natural-language reference, or a data table (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/SharedParsedFormula.cce/ArrayParsedFormula.cce) by the caller -- this function reads exactly that many bytes and nothing past them.
+ */
+interface ParseFormulaOptions {
+  /** The cell this formula is being evaluated for -- present only when `rgce` is a ShrFmla's own SharedParsedFormula being expanded for one specific referencing cell (see workbook/sheet.ts's collectFormulaGroups), which is the only place PtgRefN/PtgAreaN are legal. Absent for every other caller, in which case meeting one of those tokens aborts the parse exactly as it always has. */
+  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>;
+}
+declare function parseFormulaText(rgce: Uint8Array<ArrayBuffer>, context: FormulaSheetContext, options?: ParseFormulaOptions): 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.
+ *
+ * Exported for workbook/sheet.ts's collectFormulaGroups, which joins the returned cell against whichever ShrFmla/Array record follows the Formula record found there.
+ */
+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 };

package/dist/{substreams-D7dQiJbp.d.ts → substreams-CmyZMtuM.d.ts}

@@ -6,6 +6,8 @@ interface RecordGroup {
   readonly blocks: readonly Uint8Array<ArrayBuffer>[];
   readonly offset: number;
 }
+/** The total byte length of a record's data across every block (the base record's and any Continues that followed it) -- what a reader needs whenever a trailing field's own length is implied by "whatever is left" rather than stated by a preceding count (a Mul record's entry count, an SST's own bounds check, a formula's RgbExtra trailer). */
+declare function recordByteLength(record: RecordGroup): number;
 /** One substream: the document type its BOF declared, the records between that BOF and its EOF, its ordinal position among the stream's substreams, and the stream offset of its own BOF -- which is what a BoundSheet8's lbPlyPos names. */
 interface Substream {
   readonly documentType: number;
@@ -18,4 +20,4 @@ declare function groupRecords(records: readonly BiffRecord[]): readonly RecordGr
 /** Splits a grouped record sequence into its substreams, verifying each BOF declares BIFF8. */
 declare function splitSubstreams(groups: readonly RecordGroup[]): readonly Substream[];
 //#endregion
-export { splitSubstreams as i, Substream as n, groupRecords as r, RecordGroup as t };
+export { splitSubstreams as a, recordByteLength as i, Substream as n, groupRecords as r, RecordGroup as t };

package/dist/{substreams-Ddtvn_Vr.d.cts → substreams-Cpy5Fi3d.d.cts}

@@ -6,6 +6,8 @@ interface RecordGroup {
   readonly blocks: readonly Uint8Array<ArrayBuffer>[];
   readonly offset: number;
 }
+/** The total byte length of a record's data across every block (the base record's and any Continues that followed it) -- what a reader needs whenever a trailing field's own length is implied by "whatever is left" rather than stated by a preceding count (a Mul record's entry count, an SST's own bounds check, a formula's RgbExtra trailer). */
+declare function recordByteLength(record: RecordGroup): number;
 /** One substream: the document type its BOF declared, the records between that BOF and its EOF, its ordinal position among the stream's substreams, and the stream offset of its own BOF -- which is what a BoundSheet8's lbPlyPos names. */
 interface Substream {
   readonly documentType: number;
@@ -18,4 +20,4 @@ declare function groupRecords(records: readonly BiffRecord[]): readonly RecordGr
 /** Splits a grouped record sequence into its substreams, verifying each BOF declares BIFF8. */
 declare function splitSubstreams(groups: readonly RecordGroup[]): readonly Substream[];
 //#endregion
-export { splitSubstreams as i, Substream as n, groupRecords as r, RecordGroup as t };
+export { splitSubstreams as a, recordByteLength as i, Substream as n, groupRecords as r, RecordGroup as t };

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

@@ -1,5 +1,5 @@
 import { E as XfDecorationFields } from "../xf-colors-BB5MKq6R.cjs";
-import { t as PrintNamePlanEntry } from "../print-names-D-njuzVw.cjs";
+import { t as PrintNamePlanEntry } from "../print-names-DyYloloV.cjs";
 import { Alignment, Color } from "document-schema.js";
 //#region src/workbook/globals-writer.d.ts
 /** [MS-XLS] 2.1.7.20.3's own XFS production requires at least sixteen XF records before any cell can reference one: BUILTIN_STYLES.length built-in cell styles, then at least one cell XF -- the "General, no declared format" one every workbook needs unconditionally, written immediately after them. Derived from BUILTIN_STYLES's own length rather than restated as a literal, so the two can never drift apart. */

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

@@ -1,5 +1,5 @@
 import { E as XfDecorationFields } from "../xf-colors--5oxSeI1.js";
-import { t as PrintNamePlanEntry } from "../print-names-DUlpVE00.js";
+import { t as PrintNamePlanEntry } from "../print-names-C-PQ2vAy.js";
 import { Alignment, Color } from "document-schema.js";
 //#region src/workbook/globals-writer.d.ts
 /** [MS-XLS] 2.1.7.20.3's own XFS production requires at least sixteen XF records before any cell can reference one: BUILTIN_STYLES.length built-in cell styles, then at least one cell XF -- the "General, no declared format" one every workbook needs unconditionally, written immediately after them. Derived from BUILTIN_STYLES's own length rather than restated as a literal, so the two can never drift apart. */

package/dist/workbook/globals.cjs

@@ -1,6 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_biff_record_types = require("../biff/record-types.cjs");
 const require_biff_records = require("../biff/records.cjs");
+const require_biff_substreams = require("../biff/substreams.cjs");
 const require_biff_xf_colors = require("../biff/xf-colors.cjs");
 const require_biff_cursor = require("../biff/cursor.cjs");
 const require_biff_strings = require("../biff/strings.cjs");
@@ -19,7 +20,7 @@ function readWorkbookGlobals(records) {
 	const sheets = [];
 	const cellFormats = [];
 	const customFormats = /* @__PURE__ */ new Map();
-	const supBookSelfReferencing = [];
+	const supBooks = [];
 	let sharedStrings = [];
 	let date1904 = false;
 	let externSheet;
@@ -43,7 +44,7 @@ function readWorkbookGlobals(records) {
 			date1904 = readDate1904(record);
 			break;
 		case 430:
-			supBookSelfReferencing.push(isSelfReferencingSupBook(record));
+			supBooks.push(readSupBookSafely(record));
 			break;
 		case 23:
 			externSheet = record;
@@ -52,7 +53,7 @@ function readWorkbookGlobals(records) {
 	}
 	const numberFormats = new Map(excel_number_format.BUILTIN_NUMBER_FORMATS);
 	for (const [id, code] of customFormats) numberFormats.set(id, code);
-	const sheetRanges = externSheet === void 0 ? [] : readSheetRanges(externSheet, supBookSelfReferencing);
+	const sheetRanges = externSheet === void 0 ? [] : readSheetRanges(externSheet, supBooks);
 	return {
 		sheets,
 		sharedStrings,
@@ -64,16 +65,141 @@ function readWorkbookGlobals(records) {
 		printNames: require_workbook_print_names.readPrintNames(records)
 	};
 }
-/** [MS-XLS] 2.4.271's own cch table: a SupBook whose cch is exactly this value is a self-referencing supporting link -- this workbook itself -- rather than another workbook, a DDE/OLE data source, or an add-in. This is the only kind of supporting link a 3D reference resolves through here; every other kind genuinely needs bytes from outside this file. */
+/** [MS-XLS] 2.4.271's own cch table: a SupBook whose cch is exactly this value is a self-referencing supporting link -- this workbook itself -- rather than another workbook, a DDE/OLE data source, or an add-in. */
 const SUPBOOK_SELF_REFERENCING_CCH = 1025;
-/** SupBook ([MS-XLS] 2.4.271): a two-byte ctab then a two-byte cch. Only cch is read here -- ctab is undefined for a self-referencing SupBook and unused for every other kind this reader does not resolve, and the virtPath/rgst payload that would follow for a non-self-referencing link is never reached. */
-function isSelfReferencingSupBook(record) {
+/** The cch table's other named sentinel: an add-in-referencing supporting link, whose ExternName records name add-in functions this reader has no workbook or sheet to resolve a name from. */
+const SUPBOOK_ADDIN_CCH = 14849;
+/** The inclusive cch range meaning "virtPath is present, and its own grammar (rather than a further sentinel) says what kind of supporting link this is" ([MS-XLS] 2.4.271's own cch table). */
+const SUPBOOK_VIRTPATH_MAX_CCH = 255;
+/** virtPath's own single-character sentinels ([MS-XLS] 31ed3738's own virtPath value table): a lone NUL marks a same-sheet reference, a lone SPACE an unused supporting link. */
+const SUPBOOK_SAME_SHEET_CHAR = "\0";
+const SUPBOOK_UNUSED_CHAR = " ";
+/**
+* SupBook ([MS-XLS] 2.4.271): a two-byte ctab, a two-byte cch, then -- for every kind but self-referencing and add-in-referencing -- a virtPath (an XLUnicodeStringNoCch, cch characters long) and, for an external-workbook or unused link specifically, ctab sheet names (XLUnicodeString) in rgst.
+*/
+function readSupBook(record) {
 	const cursor = new require_biff_cursor.BlockCursor(record.blocks);
-	cursor.skip(2);
-	return cursor.u16() === SUPBOOK_SELF_REFERENCING_CCH;
+	const ctab = cursor.u16();
+	const cch = cursor.u16();
+	if (cch === SUPBOOK_SELF_REFERENCING_CCH) return { kind: "self" };
+	if (cch === SUPBOOK_ADDIN_CCH) return {
+		kind: "unresolvable",
+		diagnostic: "add-in function reference"
+	};
+	if (cch < 1 || cch > SUPBOOK_VIRTPATH_MAX_CCH) return {
+		kind: "unresolvable",
+		diagnostic: `supporting link of unrecognised type (cch=0x${cch.toString(16).padStart(4, "0")})`
+	};
+	const virtPath = require_biff_strings.readXLUnicodeStringNoCch(cursor, cch);
+	if (virtPath === SUPBOOK_SAME_SHEET_CHAR) return {
+		kind: "unresolvable",
+		diagnostic: "same-sheet reference"
+	};
+	if (virtPath === SUPBOOK_UNUSED_CHAR) return {
+		kind: "unresolvable",
+		diagnostic: "unused supporting link"
+	};
+	if (ctab === 0) return {
+		kind: "unresolvable",
+		diagnostic: "DDE or OLE data source reference"
+	};
+	const fileName = fileNameFromVirtPath(virtPath);
+	const sheetNames = [];
+	for (let index = 0; index < ctab; index += 1) sheetNames.push(require_biff_strings.readXLUnicodeString(cursor));
+	return {
+		kind: "external-workbook",
+		fileName,
+		sheetNames
+	};
+}
+/**
+* readSupBook, degrading a malformed record (an rgst shorter than its own declared ctab, most concretely) to an unresolvable diagnostic rather than letting a BiffFormatError propagate out of this one SupBook and abort the whole globals read -- and with it, the whole workbook. This is entirely new territory added alongside external-3D-reference resolution: before it, this reader never walked a SupBook's own virtPath/rgst at all, so a malformed one had nothing here to trip over. The per-record boundary keeps the damage to the XTI entries that resolve through this one SupBook, which already carry their own `unresolvable` label path for every other kind this reader cannot fully resolve.
+*/
+function readSupBookSafely(record) {
+	try {
+		return readSupBook(record);
+	} catch (error) {
+		if (!(error instanceof require_biff_records.BiffFormatError)) throw error;
+		return {
+			kind: "unresolvable",
+			diagnostic: "malformed supporting link"
+		};
+	}
+}
+/** [MS-XLS] 480c3d2a's own VirtualPath grammar directory separator (U+0003) -- never a printable character a real file or sheet name may contain, so splitting on it to find the trailing segment is unambiguous. */
+const VIRTPATH_DIRECTORY_SEPARATOR = "";
+/** [MS-XLS] 480c3d2a's own two-character virt-path markers this reader still resolves a trailing file name through: rel-volume, startup, alt-startup, and library -- each %x0001 followed by one of these bytes, then file-path itself. Distinct from simple-file-path, whose own leading %x0001 (when present at all) stands ALONE, with no second marker byte, directly followed by file-path -- so any OTHER second character belongs to that file-path, not to a marker this function should also consume. */
+const VIRTPATH_REL_VOLUME_MARKER = 2;
+const VIRTPATH_STARTUP_MARKER = 6;
+const VIRTPATH_ALT_STARTUP_MARKER = 7;
+const VIRTPATH_LIBRARY_MARKER = 8;
+/**
+* Isolates a plain trailing file name from a SupBook's own virtPath, when it uses one of the VirtualPath grammar's simpler forms: simple-file-path (no marker at all, or its own optional lone %x0001 with no second marker byte), or a genuine two-character marker saying the path is relative to the referencing workbook's own drive, the startup directory, the alternate startup directory, or the library directory (rel-volume/startup/alt-startup/library -- [MS-XLS] 480c3d2a's own virt-path alternatives). An absolute drive volume, a UNC share, or a transfer-protocol URL needs more of the grammar than a trailing path segment to reproduce faithfully, so those return undefined rather than a guess -- readSupBook's own caller then shows the sheet name(s) (still fully resolvable from rgst) against a placeholder workbook label instead of discarding them. file-path's own bracketed form (`"[" relative-path "]" sheet-name`, naming a sheet directly in the path rather than through SupBook's separate rgst array) is outside what this reader reconstructs too, and is declined the same way rather than folded into the file name and doubled up with the caller's own `[bookLabel]` bracketing.
+*/
+function fileNameFromVirtPath(virtPath) {
+	let path = virtPath;
+	if (path.startsWith("
")) switch (path.codePointAt(1)) {
+		case 1:
+		case 5: return;
+		case VIRTPATH_REL_VOLUME_MARKER:
+		case VIRTPATH_STARTUP_MARKER:
+		case VIRTPATH_ALT_STARTUP_MARKER:
+		case VIRTPATH_LIBRARY_MARKER:
+			path = path.slice(2);
+			break;
+		default: path = path.slice(1);
+	}
+	if (path.length === 0) return;
+	const last = path.split(VIRTPATH_DIRECTORY_SEPARATOR).at(-1);
+	if (last === void 0 || last.length === 0) return;
+	return last.includes("[") || last.includes("]") ? void 0 : last;
+}
+/** A bracketed diagnostic placeholder for a sheet label this reader could not fully resolve -- deliberately distinct from Excel's own bare `#REF!` error literal (which is valid, retypeable formula syntax on its own): this always carries a parenthesised reason, and resolveSheetLabel's own quoting (biff/ptg.ts) wraps the whole thing in single quotes regardless, since neither the reason text nor the surrounding punctuation matches a bare sheet-name pattern. */
+function diagnosticLabel(reason) {
+	return `#REF!(${reason})`;
+}
+/**
+* One XTI's own scope resolved against its SupBook -- a plain SheetRange when the SupBook is this same, self-referencing workbook and both sheet indices are real ([MS-XLS] 2.5.344's own `-1` "could not be found" and `-2` "workbook-level" sentinels aside), otherwise an ExternalSheetLabel carrying whatever this reader could recover (an external workbook's own file name and sheet name(s), when the SupBook resolves that far) or a diagnostic placeholder, for a supporting-link kind or a sheet index this reader does not resolve a name from at all.
+*
+* The SupBook's own kind is checked before the `-2` sentinel, not after: [MS-XLS] 2.5.344's itabFirst/itabLast table produces `-2` for a same-sheet, add-in, DDE, and OLE supporting link alike (none of them names a sheet at all), so treating every `-2` as a generic "workbook-level reference" before asking what kind of SupBook it belongs to would overwrite each of those already-specific `unresolvable` diagnostics with a less useful, wrong one. `-2` only means "workbook-level" for the two kinds that otherwise resolve a real sheet scope -- self and external-workbook -- so the sentinel is scoped to those.
+*/
+function resolveXti(supBook, itabFirst, itabLast) {
+	if (supBook === void 0) return {
+		label: diagnosticLabel("supporting link index out of range"),
+		diagnostic: true
+	};
+	if (supBook.kind === "unresolvable") return {
+		label: diagnosticLabel(supBook.diagnostic),
+		diagnostic: true
+	};
+	if (itabFirst === -2 || itabLast === -2) return {
+		label: diagnosticLabel("workbook-level reference"),
+		diagnostic: true
+	};
+	if (supBook.kind === "self") return itabFirst >= 0 && itabLast >= 0 ? {
+		firstSheetIndex: itabFirst,
+		lastSheetIndex: itabLast
+	} : {
+		label: diagnosticLabel("sheet not found"),
+		diagnostic: true
+	};
+	const first = itabFirst >= 0 ? supBook.sheetNames[itabFirst] : void 0;
+	const last = itabLast >= 0 ? supBook.sheetNames[itabLast] : void 0;
+	if (first === void 0 || last === void 0) return {
+		label: `[${supBook.fileName ?? "EXTERNAL"}]${diagnosticLabel("sheet not found")}`,
+		diagnostic: true
+	};
+	if (supBook.fileName === void 0) return {
+		label: `[EXTERNAL]${first === last ? first : `${first}:${last}`}`,
+		diagnostic: true
+	};
+	return {
+		label: `[${supBook.fileName}]${first === last ? first : `${first}:${last}`}`,
+		diagnostic: false
+	};
 }
 /** ExternSheet ([MS-XLS] 2.4.106): a two-byte cXTI then that many XTI structures ([MS-XLS] 2.5.344) -- a two-byte iSupBook and two signed 16-bit sheet-scope bounds each. iSupBook indexes the SupBook collection positionally, in the order those records appeared. */
-function readSheetRanges(record, supBookSelfReferencing) {
+function readSheetRanges(record, supBooks) {
 	const cursor = new require_biff_cursor.BlockCursor(record.blocks);
 	const count = cursor.u16();
 	const ranges = [];
@@ -81,10 +207,7 @@ function readSheetRanges(record, supBookSelfReferencing) {
 		const iSupBook = cursor.u16();
 		const itabFirst = cursor.i16();
 		const itabLast = cursor.i16();
-		ranges.push((supBookSelfReferencing[iSupBook] ?? false) && itabFirst >= 0 && itabLast >= 0 ? {
-			firstSheetIndex: itabFirst,
-			lastSheetIndex: itabLast
-		} : void 0);
+		ranges.push(resolveXti(supBooks[iSupBook], itabFirst, itabLast));
 	}
 	return ranges;
 }
@@ -107,7 +230,7 @@ function readSharedStrings(record) {
 	cursor.i32();
 	const uniqueCount = cursor.i32();
 	if (uniqueCount < 0) throw new require_biff_records.BiffFormatError(`SST declares a negative unique-string count (${uniqueCount})`);
-	const totalBytes = record.blocks.reduce((sum, block) => sum + block.length, 0);
+	const totalBytes = require_biff_substreams.recordByteLength(record);
 	if (uniqueCount * MIN_SST_ENTRY_BYTES > totalBytes) throw new require_biff_records.BiffFormatError(`SST declares ${uniqueCount} unique strings, more than its ${totalBytes} bytes could carry`);
 	const strings = [];
 	for (let index = 0; index < uniqueCount; index += 1) strings.push(require_biff_strings.readRichExtendedString(cursor));

package/dist/workbook/globals.d.cts

@@ -1,7 +1,7 @@
-import { n as SheetRange } from "../ptg-B2K8t3js.cjs";
-import { t as RecordGroup } from "../substreams-Ddtvn_Vr.cjs";
+import { a as SheetRange, t as ExternalSheetLabel } from "../ptg-CCBbJLZJ.cjs";
+import { t as RecordGroup } from "../substreams-Cpy5Fi3d.cjs";
 import { E as XfDecorationFields, w as XfAlignmentFields } from "../xf-colors-BB5MKq6R.cjs";
-import { n as SheetPrintNames } from "../print-names-D-njuzVw.cjs";
+import { n as SheetPrintNames } from "../print-names-DyYloloV.cjs";
 import { Color } from "document-schema.js";
 //#region src/workbook/globals.d.ts
 /** One sheet, as its BoundSheet8 record describes it ([MS-XLS] 2.4.28). */
@@ -41,11 +41,11 @@ interface WorkbookGlobals {
   /** Whether serials count from the 1904 epoch rather than the 1900 one ([MS-XLS] 2.4.77). */
   readonly date1904: boolean;
   /**
-   * A PtgRef3d/PtgArea3d's own ixti, resolved to the sheet range it names -- one entry per XTI in the EXTERNSHEET record's rgXTI array, in that array's own order (an ixti is an index into it).
+   * A PtgRef3d/PtgArea3d's own ixti, resolved to the sheet scope it names -- one entry per XTI in the EXTERNSHEET record's rgXTI array, in that array's own order (an ixti is an index into it).
    *
-   * An entry is undefined when this reader does not resolve it: the XTI's own SupBook is not this same, self-referencing workbook (a genuine external-workbook, DDE, OLE, or add-in reference -- [MS-XLS] 2.4.271's own cch table, `0x0401` being the one this reader treats as resolvable), or its itabFirst/itabLast do not name a real sheet (`-1`, "sheet could not be found"). A formula whose 3D reference lands on an undefined entry is left with `formula` absent for that cell, exactly like the other unsupported-token cases -- this reader never resolves a genuinely external workbook's own sheet names, since that needs the external workbook's own bytes, not this one's.
+   * A plain SheetRange when the XTI's own SupBook is this same, self-referencing workbook and both itabFirst/itabLast name a real sheet. An ExternalSheetLabel -- a fully-formatted label text, diagnostic placeholder included -- for everything else this reader cannot turn into direct BoundSheet8 indices: a genuinely external workbook (resolved as far as its own virtPath and rgst allow, see readSupBook/fileNameFromVirtPath), a DDE/OLE/add-in/same-sheet/unused supporting link (no sheet name to resolve at all), or a sheet index [MS-XLS] 2.5.344 itself marks unresolvable (`-1`, "sheet could not be found") or workbook-level (`-2`). Only an ixti past the end of EXTERNSHEET's own array is genuinely undefined -- every other case now carries SOME label text, so a 3D reference into it no longer drops the whole formula the way an unresolvable one used to.
    */
-  readonly sheetRanges: readonly (SheetRange | undefined)[];
+  readonly sheetRanges: readonly (SheetRange | ExternalSheetLabel | undefined)[];
   /**
    * The workbook's own custom colour table, from a Palette record ([MS-XLS] 2.4.188) -- 56 entries, index 0 being icv 8. Undefined when the file carries no Palette record at all, which is common: a real file relying purely on the fixed default 8-colour-plus-56-entry table (this package's own `resolveIcvColor` falls back to that same default table, matching [MS-XLS] "Icv"'s own documented fallback) never needs one.
    */

package/dist/workbook/globals.d.ts

@@ -1,7 +1,7 @@
-import { n as SheetRange } from "../ptg-B2K8t3js.js";
-import { t as RecordGroup } from "../substreams-D7dQiJbp.js";
+import { a as SheetRange, t as ExternalSheetLabel } from "../ptg-CCBbJLZJ.js";
+import { t as RecordGroup } from "../substreams-CmyZMtuM.js";
 import { E as XfDecorationFields, w as XfAlignmentFields } from "../xf-colors--5oxSeI1.js";
-import { n as SheetPrintNames } from "../print-names-DUlpVE00.js";
+import { n as SheetPrintNames } from "../print-names-C-PQ2vAy.js";
 import { Color } from "document-schema.js";
 //#region src/workbook/globals.d.ts
 /** One sheet, as its BoundSheet8 record describes it ([MS-XLS] 2.4.28). */
@@ -41,11 +41,11 @@ interface WorkbookGlobals {
   /** Whether serials count from the 1904 epoch rather than the 1900 one ([MS-XLS] 2.4.77). */
   readonly date1904: boolean;
   /**
-   * A PtgRef3d/PtgArea3d's own ixti, resolved to the sheet range it names -- one entry per XTI in the EXTERNSHEET record's rgXTI array, in that array's own order (an ixti is an index into it).
+   * A PtgRef3d/PtgArea3d's own ixti, resolved to the sheet scope it names -- one entry per XTI in the EXTERNSHEET record's rgXTI array, in that array's own order (an ixti is an index into it).
    *
-   * An entry is undefined when this reader does not resolve it: the XTI's own SupBook is not this same, self-referencing workbook (a genuine external-workbook, DDE, OLE, or add-in reference -- [MS-XLS] 2.4.271's own cch table, `0x0401` being the one this reader treats as resolvable), or its itabFirst/itabLast do not name a real sheet (`-1`, "sheet could not be found"). A formula whose 3D reference lands on an undefined entry is left with `formula` absent for that cell, exactly like the other unsupported-token cases -- this reader never resolves a genuinely external workbook's own sheet names, since that needs the external workbook's own bytes, not this one's.
+   * A plain SheetRange when the XTI's own SupBook is this same, self-referencing workbook and both itabFirst/itabLast name a real sheet. An ExternalSheetLabel -- a fully-formatted label text, diagnostic placeholder included -- for everything else this reader cannot turn into direct BoundSheet8 indices: a genuinely external workbook (resolved as far as its own virtPath and rgst allow, see readSupBook/fileNameFromVirtPath), a DDE/OLE/add-in/same-sheet/unused supporting link (no sheet name to resolve at all), or a sheet index [MS-XLS] 2.5.344 itself marks unresolvable (`-1`, "sheet could not be found") or workbook-level (`-2`). Only an ixti past the end of EXTERNSHEET's own array is genuinely undefined -- every other case now carries SOME label text, so a 3D reference into it no longer drops the whole formula the way an unresolvable one used to.
    */
-  readonly sheetRanges: readonly (SheetRange | undefined)[];
+  readonly sheetRanges: readonly (SheetRange | ExternalSheetLabel | undefined)[];
   /**
    * The workbook's own custom colour table, from a Palette record ([MS-XLS] 2.4.188) -- 56 entries, index 0 being icv 8. Undefined when the file carries no Palette record at all, which is common: a real file relying purely on the fixed default 8-colour-plus-56-entry table (this package's own `resolveIcvColor` falls back to that same default table, matching [MS-XLS] "Icv"'s own documented fallback) never needs one.
    */