xls-codec 4.6.0 → 4.7.0

package/README.md

@@ -58,7 +58,7 @@ Each deliberate rather than overlooked:
 - **Conditional formatting, CF12's colour scale/data bar/icon set rules resolved for real (ExaDev/documents.js#1104).** `CF12`'s own `ct` field picks one of six rule shapes ([MS-XLS] 2.4.43); this reader promotes the three that share a genuine array-of-thresholds building block already modelled in `document-schema.js` -- colour scale, data bar, and icon set (`src/workbook/conditional-format-12.ts`) -- each reading an array of `CFVO` threshold objects (the identical `num`/`percent`/`max`/`min`/`formula`/`percentile` vocabulary `ContentSheetConditionalFormatValueSchema` already carries for `ooxml.js`'s xlsx reader and `odf.js`'s ods reader) paired with `CFColor` values. A `CFColor` naming an indexed colour resolves through the same `icv`/`Palette` machinery as base `CF`'s own `DXFN`, then Excel's own TintAndShade model applies the colour's own tint/shade Xnum (`xf-colors.ts`'s `applyTint`); one naming a plain RGB triple resolves directly, tint included; one naming an automatic or theme colour degrades the whole rule to absent, since this package has no BIFF8 `Theme` reader to resolve a theme reference against. Icon set's own `iIconSet` byte maps to the identical ECMA-376 `ST_IconSetType` vocabulary (`3Arrows`, `3TrafficLights1`, `5Quarters`, and the rest of the seventeen built-in sets) `ooxml.js`'s xlsx `cfRule` reading already carries as a plain string. A record longer than the 8224-byte single-record ceiling continues onto `ContinueFrt12` rather than the plain `Continue` every other record in this package joins against; `groupRecords` (`src/biff/substreams.ts`) strips its own restated `FrtRefHeader` before joining it.
 - **Conditional formatting, CF12's filter-dispatched template rules resolved for real (ExaDev/documents.js#1106).** `ct` 0x05 ("filter") dispatches further through `icfTemplate`, alongside a 16-byte `CFExTemplateParams` block always present regardless of `ct`. Of that block's five variants, only two need real parsing -- `CFExFilterParams` (top10's own `fTop`/`fPercent`/`iParam`) and `CFExAveragesTemplateParams` (the aboveAverage family's own standard-deviation count) -- since `CFExDefaultTemplateParams` (duplicateValues/uniqueValues/the four blank/error conditions) is 16 reserved bytes and `CFExDateTemplateParams`'s own `dateOp` field is a fixed restatement of `icfTemplate` for all ten date/time periods, so both dispatch directly off `icfTemplate` with no further byte reading. Unlike colour scale/data bar/icon set, [MS-XLS] does not force a `ct` 0x05 rule's own `cbDxf` to zero, so its `DXFN12` can carry a genuine font/fill override; that structure resolves through the identical `parseDxfStyle` base `CF`'s own `DXFN` already uses. A malformed `iParam` of zero degrades a top10 rule to absent rather than promoting a `rank` `ContentSheetConditionalFormatSchema` itself requires to be positive. Comparison/formula rules re-expressed in this newer record shape, `containsText`'s own four sub-types (`CFExTextTemplateParams` names which one a rule is but not its actual search string, and CF12's own formula fields are spec'd to be zero for every `ct` 0x05 rule -- where the literal text operand lives is a genuine open question), and `CFEx`'s own extension of a legacy `CF` record all remain unread (ExaDev/documents.js#1100).
 - **Not read at all:** charts, drawings and images, `CF12`'s `containsText` filter rules, and `CFEx`'s own `CF`-record extension (ExaDev/documents.js#1100). Defined names (`Lbl`) are read only for the two built-in ones a sheet's print range and repeated header bands live in ([Print settings](#print-settings)); a user-defined name has nowhere to land in `document-schema.js`'s spreadsheet model, so it is skipped.
-- **Encrypted workbooks** are refused rather than mis-read: a `FilePass` record means every record after it is ciphertext.
+- **RC4-encrypted workbooks, decrypted for real (ExaDev/documents.js#1108).** A `FilePass` record ([MS-XLS] 2.4.117) means every record after it is ciphertext under one of three schemes; this reader implements exactly one, the [MS-OFFCRYPTO] 2.3.6.1 "RC4 encryption header" -- `readXlsContent`/`readXls` take an optional `password`, verify it against the header's own `EncryptedVerifier`/`EncryptedVerifierHash` pair, then decrypt every subsequent record's data (`src/workbook/encryption.ts`) using the RC4/MD5 primitives [`archive-codec`](../archive-codec/README.md#legacy-office-encryption) shares with `doc-codec`/`ppt-codec`'s own eventual integration. [MS-XLS] 2.2.10's own exclusion list -- `BOF`, `FilePass`, and four shared-workbook revision-tracking records this package otherwise never reads, plus `BoundSheet8`'s own `lbPlyPos` field specifically -- is honoured exactly, re-derived independently in this package's own tests rather than trusted by construction. A missing or incorrect password throws rather than returning a garbled document; the newer "RC4 CryptoAPI encryption header" scheme and XOR obfuscation are explicitly out of scope, tracked separately on [#922](https://github.com/ExaDev/documents.js/issues/922).
 
 This package is wired into `documents.js`'s conversion registry (`xlsToPdf`/`pdfToXls`, `convertDocument("xls", ...)`, and every same-variant spreadsheet bridge) — see that package's own README Fidelity table for exactly which pairs route and which don't. Remaining read+write scope gaps (formula writing and per-cell font) are tracked on [#815](https://github.com/ExaDev/documents.js/issues/815).
 

package/dist/biff/record-types.cjs

@@ -24,6 +24,16 @@ const RECORD_DATE1904 = 34;
 const RECORD_STYLE = 659;
 /** Present only in an encrypted workbook, where every record after it is ciphertext ([MS-XLS] 2.4.117). */
 const RECORD_FILEPASS = 47;
+/** Specifies whether a user holds an exclusive lock on a shared workbook ([MS-XLS] 2.4.339). */
+const RECORD_USREXCL = 404;
+/** Specifies that a shared workbook was locked by a particular user ([MS-XLS] 2.4.116). */
+const RECORD_FILELOCK = 405;
+/** Specifies the user-interface code page and opens the globals substream's own record collection ([MS-XLS] 2.4.146). */
+const RECORD_INTERFACEHDR = 225;
+/** Information about a shared workbook's revision tracking ([MS-XLS] 2.4.227). */
+const RECORD_RRDINFO = 406;
+/** Metadata about one user's set of revisions in a shared workbook ([MS-XLS] 2.4.226). */
+const RECORD_RRDHEAD = 312;
 /** A collection of XTI structures resolving a formula's ixti to a sheet range, for a 3D reference ([MS-XLS] 2.4.106). */
 const RECORD_EXTERNSHEET = 23;
 /** The beginning of a supporting-link's own record collection: another workbook, a DDE/OLE data source, an add-in, or -- the one case this reader resolves -- this same workbook, self-referencing ([MS-XLS] 2.4.271). */
@@ -163,11 +173,13 @@ exports.RECORD_DV = RECORD_DV;
 exports.RECORD_DVAL = RECORD_DVAL;
 exports.RECORD_EOF = RECORD_EOF;
 exports.RECORD_EXTERNSHEET = RECORD_EXTERNSHEET;
+exports.RECORD_FILELOCK = RECORD_FILELOCK;
 exports.RECORD_FILEPASS = RECORD_FILEPASS;
 exports.RECORD_FONT = RECORD_FONT;
 exports.RECORD_FORMAT = RECORD_FORMAT;
 exports.RECORD_FORMULA = RECORD_FORMULA;
 exports.RECORD_HORIZONTALPAGEBREAKS = RECORD_HORIZONTALPAGEBREAKS;
+exports.RECORD_INTERFACEHDR = RECORD_INTERFACEHDR;
 exports.RECORD_LABEL = RECORD_LABEL;
 exports.RECORD_LABELSST = RECORD_LABELSST;
 exports.RECORD_LBL = RECORD_LBL;
@@ -184,6 +196,8 @@ exports.RECORD_PRINTROWCOL = RECORD_PRINTROWCOL;
 exports.RECORD_RIGHTMARGIN = RECORD_RIGHTMARGIN;
 exports.RECORD_RK = RECORD_RK;
 exports.RECORD_ROW = RECORD_ROW;
+exports.RECORD_RRDHEAD = RECORD_RRDHEAD;
+exports.RECORD_RRDINFO = RECORD_RRDINFO;
 exports.RECORD_SETUP = RECORD_SETUP;
 exports.RECORD_SHRFMLA = RECORD_SHRFMLA;
 exports.RECORD_SST = RECORD_SST;
@@ -193,6 +207,7 @@ exports.RECORD_SUPBOOK = RECORD_SUPBOOK;
 exports.RECORD_TABLE = RECORD_TABLE;
 exports.RECORD_TOPMARGIN = RECORD_TOPMARGIN;
 exports.RECORD_TXO = RECORD_TXO;
+exports.RECORD_USREXCL = RECORD_USREXCL;
 exports.RECORD_VERTICALPAGEBREAKS = RECORD_VERTICALPAGEBREAKS;
 exports.RECORD_WSBOOL = RECORD_WSBOOL;
 exports.RECORD_XF = RECORD_XF;

package/dist/biff/record-types.d.cts

@@ -23,6 +23,16 @@ declare const RECORD_DATE1904 = 34;
 declare const RECORD_STYLE = 659;
 /** Present only in an encrypted workbook, where every record after it is ciphertext ([MS-XLS] 2.4.117). */
 declare const RECORD_FILEPASS = 47;
+/** Specifies whether a user holds an exclusive lock on a shared workbook ([MS-XLS] 2.4.339). */
+declare const RECORD_USREXCL = 404;
+/** Specifies that a shared workbook was locked by a particular user ([MS-XLS] 2.4.116). */
+declare const RECORD_FILELOCK = 405;
+/** Specifies the user-interface code page and opens the globals substream's own record collection ([MS-XLS] 2.4.146). */
+declare const RECORD_INTERFACEHDR = 225;
+/** Information about a shared workbook's revision tracking ([MS-XLS] 2.4.227). */
+declare const RECORD_RRDINFO = 406;
+/** Metadata about one user's set of revisions in a shared workbook ([MS-XLS] 2.4.226). */
+declare const RECORD_RRDHEAD = 312;
 /** A collection of XTI structures resolving a formula's ixti to a sheet range, for a 3D reference ([MS-XLS] 2.4.106). */
 declare const RECORD_EXTERNSHEET = 23;
 /** The beginning of a supporting-link's own record collection: another workbook, a DDE/OLE data source, an add-in, or -- the one case this reader resolves -- this same workbook, self-referencing ([MS-XLS] 2.4.271). */
@@ -130,4 +140,4 @@ declare const BIFF8_VERSION = 1536;
 /** [MS-XLS] 2.1.4: "The record size ... MUST be less than or equal to 8224." The ceiling a writer splits a record at, and the bound a reader can sanity-check a declared size against. */
 declare const MAX_RECORD_DATA_SIZE = 8224;
 //#endregion
-export { 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_FILEPASS, RECORD_FONT, RECORD_FORMAT, RECORD_FORMULA, RECORD_HORIZONTALPAGEBREAKS, 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_SETUP, RECORD_SHRFMLA, RECORD_SST, RECORD_STRING, RECORD_STYLE, RECORD_SUPBOOK, RECORD_TABLE, RECORD_TOPMARGIN, RECORD_TXO, RECORD_VERTICALPAGEBREAKS, RECORD_WSBOOL, RECORD_XF };
+export { 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 };

package/dist/biff/record-types.d.ts

@@ -23,6 +23,16 @@ declare const RECORD_DATE1904 = 34;
 declare const RECORD_STYLE = 659;
 /** Present only in an encrypted workbook, where every record after it is ciphertext ([MS-XLS] 2.4.117). */
 declare const RECORD_FILEPASS = 47;
+/** Specifies whether a user holds an exclusive lock on a shared workbook ([MS-XLS] 2.4.339). */
+declare const RECORD_USREXCL = 404;
+/** Specifies that a shared workbook was locked by a particular user ([MS-XLS] 2.4.116). */
+declare const RECORD_FILELOCK = 405;
+/** Specifies the user-interface code page and opens the globals substream's own record collection ([MS-XLS] 2.4.146). */
+declare const RECORD_INTERFACEHDR = 225;
+/** Information about a shared workbook's revision tracking ([MS-XLS] 2.4.227). */
+declare const RECORD_RRDINFO = 406;
+/** Metadata about one user's set of revisions in a shared workbook ([MS-XLS] 2.4.226). */
+declare const RECORD_RRDHEAD = 312;
 /** A collection of XTI structures resolving a formula's ixti to a sheet range, for a 3D reference ([MS-XLS] 2.4.106). */
 declare const RECORD_EXTERNSHEET = 23;
 /** The beginning of a supporting-link's own record collection: another workbook, a DDE/OLE data source, an add-in, or -- the one case this reader resolves -- this same workbook, self-referencing ([MS-XLS] 2.4.271). */
@@ -130,4 +140,4 @@ declare const BIFF8_VERSION = 1536;
 /** [MS-XLS] 2.1.4: "The record size ... MUST be less than or equal to 8224." The ceiling a writer splits a record at, and the bound a reader can sanity-check a declared size against. */
 declare const MAX_RECORD_DATA_SIZE = 8224;
 //#endregion
-export { 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_FILEPASS, RECORD_FONT, RECORD_FORMAT, RECORD_FORMULA, RECORD_HORIZONTALPAGEBREAKS, 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_SETUP, RECORD_SHRFMLA, RECORD_SST, RECORD_STRING, RECORD_STYLE, RECORD_SUPBOOK, RECORD_TABLE, RECORD_TOPMARGIN, RECORD_TXO, RECORD_VERTICALPAGEBREAKS, RECORD_WSBOOL, RECORD_XF };
+export { 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 };

package/dist/biff/record-types.js

@@ -23,6 +23,16 @@ const RECORD_DATE1904 = 34;
 const RECORD_STYLE = 659;
 /** Present only in an encrypted workbook, where every record after it is ciphertext ([MS-XLS] 2.4.117). */
 const RECORD_FILEPASS = 47;
+/** Specifies whether a user holds an exclusive lock on a shared workbook ([MS-XLS] 2.4.339). */
+const RECORD_USREXCL = 404;
+/** Specifies that a shared workbook was locked by a particular user ([MS-XLS] 2.4.116). */
+const RECORD_FILELOCK = 405;
+/** Specifies the user-interface code page and opens the globals substream's own record collection ([MS-XLS] 2.4.146). */
+const RECORD_INTERFACEHDR = 225;
+/** Information about a shared workbook's revision tracking ([MS-XLS] 2.4.227). */
+const RECORD_RRDINFO = 406;
+/** Metadata about one user's set of revisions in a shared workbook ([MS-XLS] 2.4.226). */
+const RECORD_RRDHEAD = 312;
 /** A collection of XTI structures resolving a formula's ixti to a sheet range, for a 3D reference ([MS-XLS] 2.4.106). */
 const RECORD_EXTERNSHEET = 23;
 /** The beginning of a supporting-link's own record collection: another workbook, a DDE/OLE data source, an add-in, or -- the one case this reader resolves -- this same workbook, self-referencing ([MS-XLS] 2.4.271). */
@@ -130,4 +140,4 @@ const BIFF8_VERSION = 1536;
 /** [MS-XLS] 2.1.4: "The record size ... MUST be less than or equal to 8224." The ceiling a writer splits a record at, and the bound a reader can sanity-check a declared size against. */
 const MAX_RECORD_DATA_SIZE = 8224;
 //#endregion
-export { 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_FILEPASS, RECORD_FONT, RECORD_FORMAT, RECORD_FORMULA, RECORD_HORIZONTALPAGEBREAKS, 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_SETUP, RECORD_SHRFMLA, RECORD_SST, RECORD_STRING, RECORD_STYLE, RECORD_SUPBOOK, RECORD_TABLE, RECORD_TOPMARGIN, RECORD_TXO, RECORD_VERTICALPAGEBREAKS, RECORD_WSBOOL, RECORD_XF };
+export { 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 };

package/dist/biff/records.cjs

@@ -8,7 +8,7 @@ var BiffFormatError = class extends Error {
 		this.name = "BiffFormatError";
 	}
 };
-/** The four-byte record header: a two-byte type followed by a two-byte size. */
+/** The four-byte record header: a two-byte type followed by a two-byte size. Exported for workbook/encryption.ts, which needs a record's own data start offset (the byte position right after this header) to derive the correct RC4 keystream position -- [MS-XLS] 2.2.10 counts a record's own header bytes toward the encryption stream's position even though the header itself is never encrypted. */
 const HEADER_SIZE = 4;
 /**
 * Splits a BIFF record stream into its records, in stream order.
@@ -20,11 +20,11 @@ function readRecords(stream) {
 	const records = [];
 	let offset = 0;
 	while (offset < stream.length) {
-		if (offset + HEADER_SIZE > stream.length) throw new BiffFormatError(`record header at offset ${offset} runs past the end of the ${stream.length}-byte stream`);
+		if (offset + 4 > stream.length) throw new BiffFormatError(`record header at offset ${offset} runs past the end of the ${stream.length}-byte stream`);
 		const type = view.getUint16(offset, true);
 		const size = view.getUint16(offset + 2, true);
 		if (size > 8224) throw new BiffFormatError(`record 0x${type.toString(16)} at offset ${offset} declares ${size} bytes of data, above the ${require_biff_record_types.MAX_RECORD_DATA_SIZE}-byte maximum`);
-		const dataStart = offset + HEADER_SIZE;
+		const dataStart = offset + 4;
 		if (dataStart + size > stream.length) throw new BiffFormatError(`record 0x${type.toString(16)} at offset ${offset} declares ${size} bytes of data, running past the end of the ${stream.length}-byte stream`);
 		records.push({
 			type,
@@ -37,4 +37,5 @@ function readRecords(stream) {
 }
 //#endregion
 exports.BiffFormatError = BiffFormatError;
+exports.HEADER_SIZE = HEADER_SIZE;
 exports.readRecords = readRecords;

package/dist/biff/records.d.cts

@@ -1,2 +1,2 @@
-import { n as BiffRecord, r as readRecords, t as BiffFormatError } from "../records-DVIqXFKk.cjs";
-export { BiffFormatError, BiffRecord, readRecords };
+import { i as readRecords, n as BiffRecord, r as HEADER_SIZE, t as BiffFormatError } from "../records-G82UEVq8.cjs";
+export { BiffFormatError, BiffRecord, HEADER_SIZE, readRecords };

package/dist/biff/records.d.ts

@@ -1,2 +1,2 @@
-import { n as BiffRecord, r as readRecords, t as BiffFormatError } from "../records-DVIqXFKk.js";
-export { BiffFormatError, BiffRecord, readRecords };
+import { i as readRecords, n as BiffRecord, r as HEADER_SIZE, t as BiffFormatError } from "../records-G82UEVq8.js";
+export { BiffFormatError, BiffRecord, HEADER_SIZE, readRecords };

package/dist/biff/records.js

@@ -7,7 +7,7 @@ var BiffFormatError = class extends Error {
 		this.name = "BiffFormatError";
 	}
 };
-/** The four-byte record header: a two-byte type followed by a two-byte size. */
+/** The four-byte record header: a two-byte type followed by a two-byte size. Exported for workbook/encryption.ts, which needs a record's own data start offset (the byte position right after this header) to derive the correct RC4 keystream position -- [MS-XLS] 2.2.10 counts a record's own header bytes toward the encryption stream's position even though the header itself is never encrypted. */
 const HEADER_SIZE = 4;
 /**
 * Splits a BIFF record stream into its records, in stream order.
@@ -19,11 +19,11 @@ function readRecords(stream) {
 	const records = [];
 	let offset = 0;
 	while (offset < stream.length) {
-		if (offset + HEADER_SIZE > stream.length) throw new BiffFormatError(`record header at offset ${offset} runs past the end of the ${stream.length}-byte stream`);
+		if (offset + 4 > stream.length) throw new BiffFormatError(`record header at offset ${offset} runs past the end of the ${stream.length}-byte stream`);
 		const type = view.getUint16(offset, true);
 		const size = view.getUint16(offset + 2, true);
 		if (size > 8224) throw new BiffFormatError(`record 0x${type.toString(16)} at offset ${offset} declares ${size} bytes of data, above the ${MAX_RECORD_DATA_SIZE}-byte maximum`);
-		const dataStart = offset + HEADER_SIZE;
+		const dataStart = offset + 4;
 		if (dataStart + size > stream.length) throw new BiffFormatError(`record 0x${type.toString(16)} at offset ${offset} declares ${size} bytes of data, running past the end of the ${stream.length}-byte stream`);
 		records.push({
 			type,
@@ -35,4 +35,4 @@ function readRecords(stream) {
 	return records;
 }
 //#endregion
-export { BiffFormatError, readRecords };
+export { BiffFormatError, HEADER_SIZE, readRecords };

package/dist/biff/substreams.d.cts

@@ -1,2 +1,2 @@
-import { a as splitSubstreams, i as recordByteLength, n as Substream, r as groupRecords, t as RecordGroup } from "../substreams-Cpy5Fi3d.cjs";
+import { a as splitSubstreams, i as recordByteLength, n as Substream, r as groupRecords, t as RecordGroup } from "../substreams-CHv3oWmn.cjs";
 export { RecordGroup, Substream, groupRecords, recordByteLength, splitSubstreams };

package/dist/biff/substreams.d.ts

@@ -1,2 +1,2 @@
-import { a as splitSubstreams, i as recordByteLength, n as Substream, r as groupRecords, t as RecordGroup } from "../substreams-CmyZMtuM.js";
+import { a as splitSubstreams, i as recordByteLength, n as Substream, r as groupRecords, t as RecordGroup } from "../substreams-Dp5cZoUo.js";
 export { RecordGroup, Substream, groupRecords, recordByteLength, splitSubstreams };

package/dist/{conditional-format-12-DyqonR1G.d.ts → conditional-format-12-D-X5g_O3.d.ts}

@@ -1,6 +1,6 @@
 import { r as FormulaSheetContext } from "./ptg-CCBbJLZJ.js";
-import { t as RecordGroup } from "./substreams-CmyZMtuM.js";
-import { i as RawConditionalFormatStyle } from "./conditional-format-CWlz0Ty6.js";
+import { t as RecordGroup } from "./substreams-Dp5cZoUo.js";
+import { i as RawConditionalFormatStyle } from "./conditional-format-DOdazxWe.js";
 import { Color, ContentSheetConditionalFormat, ContentSheetConditionalFormatValue, ContentSheetRange } from "document-schema.js";
 //#region src/workbook/conditional-format-12.d.ts
 type RawCfColor = {

package/dist/{conditional-format-12-DPNiYLVp.d.cts → conditional-format-12-DBhe7Zo6.d.cts}

@@ -1,6 +1,6 @@
 import { r as FormulaSheetContext } from "./ptg-CCBbJLZJ.cjs";
-import { t as RecordGroup } from "./substreams-Cpy5Fi3d.cjs";
-import { i as RawConditionalFormatStyle } from "./conditional-format-S9NaPjhr.cjs";
+import { t as RecordGroup } from "./substreams-CHv3oWmn.cjs";
+import { i as RawConditionalFormatStyle } from "./conditional-format-Czh2oTzQ.cjs";
 import { Color, ContentSheetConditionalFormat, ContentSheetConditionalFormatValue, ContentSheetRange } from "document-schema.js";
 //#region src/workbook/conditional-format-12.d.ts
 type RawCfColor = {

package/dist/{conditional-format-S9NaPjhr.d.cts → conditional-format-Czh2oTzQ.d.cts}

@@ -1,5 +1,5 @@
 import { r as FormulaSheetContext } from "./ptg-CCBbJLZJ.cjs";
-import { t as RecordGroup } from "./substreams-Cpy5Fi3d.cjs";
+import { t as RecordGroup } from "./substreams-CHv3oWmn.cjs";
 import { ContentSheetRange, SheetRuleOperator } from "document-schema.js";
 //#region src/workbook/conditional-format.d.ts
 interface RawConditionalFormatFill {

package/dist/{conditional-format-CWlz0Ty6.d.ts → conditional-format-DOdazxWe.d.ts}

@@ -1,5 +1,5 @@
 import { r as FormulaSheetContext } from "./ptg-CCBbJLZJ.js";
-import { t as RecordGroup } from "./substreams-CmyZMtuM.js";
+import { t as RecordGroup } from "./substreams-Dp5cZoUo.js";
 import { ContentSheetRange, SheetRuleOperator } from "document-schema.js";
 //#region src/workbook/conditional-format.d.ts
 interface RawConditionalFormatFill {

package/dist/content.cjs

@@ -10,6 +10,7 @@ const require_workbook_comments = require("./workbook/comments.cjs");
 const require_serial = require("./serial.cjs");
 const require_workbook_globals = require("./workbook/globals.cjs");
 const require_workbook_sheet = require("./workbook/sheet.cjs");
+const require_workbook_encryption = require("./workbook/encryption.cjs");
 let archive_codec = require("archive-codec");
 let document_schema_js = require("document-schema.js");
 let excel_number_format = require("excel-number-format");
@@ -79,14 +80,16 @@ function mapPrintSettings(raw, names) {
 /**
 * Reads a .xls file's bytes into a ContentDocument.
 *
-* The counterpart of ooxml.js's readXlsxContent, producing the same shape from the older format.
+* The counterpart of ooxml.js's readXlsxContent, producing the same shape from the older format. `password` decrypts a workbook protected by [MS-XLS] 2.4.117's FilePass record under the [MS-OFFCRYPTO] 2.3.6.1 RC4 encryption header scheme -- see workbook/encryption.ts. It is ignored for an unencrypted workbook, and a missing or incorrect password against an encrypted one throws rather than returning a partial or garbled document.
 */
-function readXlsContent(bytes) {
+function readXlsContent(bytes, password) {
 	const { workbook, metadata } = require_container.readWorkbookStreams(bytes);
-	const substreams = require_biff_substreams.splitSubstreams(require_biff_substreams.groupRecords(require_biff_records.readRecords(workbook)));
+	const rawRecords = require_biff_records.readRecords(workbook);
+	const filePassRecord = rawRecords.find((record) => record.type === 47);
+	const records = filePassRecord === void 0 ? rawRecords : require_workbook_encryption.decryptWorkbookRecords(rawRecords, filePassRecord, password);
+	const substreams = require_biff_substreams.splitSubstreams(require_biff_substreams.groupRecords(records));
 	const globalsSubstream = substreams[0];
 	if (globalsSubstream === void 0) throw new require_biff_records.BiffFormatError("workbook stream holds no substreams, so it carries no globals substream");
-	if (globalsSubstream.records.some((rec) => rec.type === 47)) throw new require_biff_records.BiffFormatError("workbook is encrypted (its globals substream carries a FilePass record); this reader does not decrypt");
 	const globals = require_workbook_globals.readWorkbookGlobals(globalsSubstream.records);
 	const sheets = globals.sheets.map((entry, sheetIndex) => ({
 		entry,
@@ -99,8 +102,8 @@ function readXlsContent(bytes) {
 	};
 }
 /** The tree-form read: readXlsContent composed with the schema's own structural transform, exactly as ooxml.js's readXlsx wraps readXlsxContent. */
-function readXls(bytes) {
-	return (0, document_schema_js.assembleTree)(readXlsContent(bytes));
+function readXls(bytes, password) {
+	return (0, document_schema_js.assembleTree)(readXlsContent(bytes, password));
 }
 /**
 * Locates a sheet's own substream and maps it.

package/dist/content.d.cts

@@ -11,10 +11,10 @@ type XlsContentDocument = Extract<ContentDocument, {
 /**
  * Reads a .xls file's bytes into a ContentDocument.
  *
- * The counterpart of ooxml.js's readXlsxContent, producing the same shape from the older format.
+ * The counterpart of ooxml.js's readXlsxContent, producing the same shape from the older format. `password` decrypts a workbook protected by [MS-XLS] 2.4.117's FilePass record under the [MS-OFFCRYPTO] 2.3.6.1 RC4 encryption header scheme -- see workbook/encryption.ts. It is ignored for an unencrypted workbook, and a missing or incorrect password against an encrypted one throws rather than returning a partial or garbled document.
  */
-declare function readXlsContent(bytes: Uint8Array<ArrayBuffer>): XlsContentDocument;
+declare function readXlsContent(bytes: Uint8Array<ArrayBuffer>, password?: string): XlsContentDocument;
 /** The tree-form read: readXlsContent composed with the schema's own structural transform, exactly as ooxml.js's readXlsx wraps readXlsxContent. */
-declare function readXls(bytes: Uint8Array<ArrayBuffer>): DocumentTree;
+declare function readXls(bytes: Uint8Array<ArrayBuffer>, password?: string): DocumentTree;
 //#endregion
 export { XlsContentDocument, readXls, readXlsContent };

package/dist/content.d.ts

@@ -11,10 +11,10 @@ type XlsContentDocument = Extract<ContentDocument, {
 /**
  * Reads a .xls file's bytes into a ContentDocument.
  *
- * The counterpart of ooxml.js's readXlsxContent, producing the same shape from the older format.
+ * The counterpart of ooxml.js's readXlsxContent, producing the same shape from the older format. `password` decrypts a workbook protected by [MS-XLS] 2.4.117's FilePass record under the [MS-OFFCRYPTO] 2.3.6.1 RC4 encryption header scheme -- see workbook/encryption.ts. It is ignored for an unencrypted workbook, and a missing or incorrect password against an encrypted one throws rather than returning a partial or garbled document.
  */
-declare function readXlsContent(bytes: Uint8Array<ArrayBuffer>): XlsContentDocument;
+declare function readXlsContent(bytes: Uint8Array<ArrayBuffer>, password?: string): XlsContentDocument;
 /** The tree-form read: readXlsContent composed with the schema's own structural transform, exactly as ooxml.js's readXlsx wraps readXlsxContent. */
-declare function readXls(bytes: Uint8Array<ArrayBuffer>): DocumentTree;
+declare function readXls(bytes: Uint8Array<ArrayBuffer>, password?: string): DocumentTree;
 //#endregion
 export { XlsContentDocument, readXls, readXlsContent };

package/dist/content.js

@@ -9,6 +9,7 @@ import { readSheetComments } from "./workbook/comments.js";
 import { serialToIsoDate, serialToIsoDateTime, serialToIsoTime } from "./serial.js";
 import { formatCodeOf, readWorkbookGlobals } from "./workbook/globals.js";
 import { readSheetRecords } from "./workbook/sheet.js";
+import { decryptWorkbookRecords } from "./workbook/encryption.js";
 import { readSummaryInformation, summaryInformationToLayoutMetadata } from "archive-codec";
 import { PAGE_SIZE_LETTER, assembleTree } from "document-schema.js";
 import { classifyNumberFormat } from "excel-number-format";
@@ -78,14 +79,16 @@ function mapPrintSettings(raw, names) {
 /**
 * Reads a .xls file's bytes into a ContentDocument.
 *
-* The counterpart of ooxml.js's readXlsxContent, producing the same shape from the older format.
+* The counterpart of ooxml.js's readXlsxContent, producing the same shape from the older format. `password` decrypts a workbook protected by [MS-XLS] 2.4.117's FilePass record under the [MS-OFFCRYPTO] 2.3.6.1 RC4 encryption header scheme -- see workbook/encryption.ts. It is ignored for an unencrypted workbook, and a missing or incorrect password against an encrypted one throws rather than returning a partial or garbled document.
 */
-function readXlsContent(bytes) {
+function readXlsContent(bytes, password) {
 	const { workbook, metadata } = readWorkbookStreams(bytes);
-	const substreams = splitSubstreams(groupRecords(readRecords(workbook)));
+	const rawRecords = readRecords(workbook);
+	const filePassRecord = rawRecords.find((record) => record.type === 47);
+	const records = filePassRecord === void 0 ? rawRecords : decryptWorkbookRecords(rawRecords, filePassRecord, password);
+	const substreams = splitSubstreams(groupRecords(records));
 	const globalsSubstream = substreams[0];
 	if (globalsSubstream === void 0) throw new BiffFormatError("workbook stream holds no substreams, so it carries no globals substream");
-	if (globalsSubstream.records.some((rec) => rec.type === 47)) throw new BiffFormatError("workbook is encrypted (its globals substream carries a FilePass record); this reader does not decrypt");
 	const globals = readWorkbookGlobals(globalsSubstream.records);
 	const sheets = globals.sheets.map((entry, sheetIndex) => ({
 		entry,
@@ -98,8 +101,8 @@ function readXlsContent(bytes) {
 	};
 }
 /** The tree-form read: readXlsContent composed with the schema's own structural transform, exactly as ooxml.js's readXlsx wraps readXlsxContent. */
-function readXls(bytes) {
-	return assembleTree(readXlsContent(bytes));
+function readXls(bytes, password) {
+	return assembleTree(readXlsContent(bytes, password));
 }
 /**
 * Locates a sheet's own substream and maps it.

package/dist/{data-validation-DsVG0Mms.d.ts → data-validation-BXvIVU0e.d.ts}

@@ -1,5 +1,5 @@
 import { r as FormulaSheetContext } from "./ptg-CCBbJLZJ.js";
-import { t as RecordGroup } from "./substreams-CmyZMtuM.js";
+import { t as RecordGroup } from "./substreams-Dp5cZoUo.js";
 import { ContentSheetRange, SheetRuleOperator } from "document-schema.js";
 //#region src/workbook/data-validation.d.ts
 interface RawDataValidation {

package/dist/{data-validation-DZPzAW-8.d.cts → data-validation-DfpjUN-N.d.cts}

@@ -1,5 +1,5 @@
 import { r as FormulaSheetContext } from "./ptg-CCBbJLZJ.cjs";
-import { t as RecordGroup } from "./substreams-Cpy5Fi3d.cjs";
+import { t as RecordGroup } from "./substreams-CHv3oWmn.cjs";
 import { ContentSheetRange, SheetRuleOperator } from "document-schema.js";
 //#region src/workbook/data-validation.d.ts
 interface RawDataValidation {

package/dist/index.cjs

@@ -31,6 +31,7 @@ exports.BiffFormatError = require_biff_records.BiffFormatError;
 exports.BiffWriteError = require_biff_write_errors.BiffWriteError;
 exports.BlockCursor = require_biff_cursor.BlockCursor;
 exports.GENERAL_CELL_XF_INDEX = require_workbook_globals_writer.GENERAL_CELL_XF_INDEX;
+exports.HEADER_SIZE = require_biff_records.HEADER_SIZE;
 exports.MAX_RECORD_DATA_SIZE = require_biff_record_types.MAX_RECORD_DATA_SIZE;
 exports.RECORD_ARRAY = require_biff_record_types.RECORD_ARRAY;
 exports.RECORD_BLANK = require_biff_record_types.RECORD_BLANK;
@@ -58,11 +59,13 @@ exports.RECORD_DV = require_biff_record_types.RECORD_DV;
 exports.RECORD_DVAL = require_biff_record_types.RECORD_DVAL;
 exports.RECORD_EOF = require_biff_record_types.RECORD_EOF;
 exports.RECORD_EXTERNSHEET = require_biff_record_types.RECORD_EXTERNSHEET;
+exports.RECORD_FILELOCK = require_biff_record_types.RECORD_FILELOCK;
 exports.RECORD_FILEPASS = require_biff_record_types.RECORD_FILEPASS;
 exports.RECORD_FONT = require_biff_record_types.RECORD_FONT;
 exports.RECORD_FORMAT = require_biff_record_types.RECORD_FORMAT;
 exports.RECORD_FORMULA = require_biff_record_types.RECORD_FORMULA;
 exports.RECORD_HORIZONTALPAGEBREAKS = require_biff_record_types.RECORD_HORIZONTALPAGEBREAKS;
+exports.RECORD_INTERFACEHDR = require_biff_record_types.RECORD_INTERFACEHDR;
 exports.RECORD_LABEL = require_biff_record_types.RECORD_LABEL;
 exports.RECORD_LABELSST = require_biff_record_types.RECORD_LABELSST;
 exports.RECORD_LBL = require_biff_record_types.RECORD_LBL;
@@ -79,6 +82,8 @@ exports.RECORD_PRINTROWCOL = require_biff_record_types.RECORD_PRINTROWCOL;
 exports.RECORD_RIGHTMARGIN = require_biff_record_types.RECORD_RIGHTMARGIN;
 exports.RECORD_RK = require_biff_record_types.RECORD_RK;
 exports.RECORD_ROW = require_biff_record_types.RECORD_ROW;
+exports.RECORD_RRDHEAD = require_biff_record_types.RECORD_RRDHEAD;
+exports.RECORD_RRDINFO = require_biff_record_types.RECORD_RRDINFO;
 exports.RECORD_SETUP = require_biff_record_types.RECORD_SETUP;
 exports.RECORD_SHRFMLA = require_biff_record_types.RECORD_SHRFMLA;
 exports.RECORD_SST = require_biff_record_types.RECORD_SST;
@@ -88,6 +93,7 @@ exports.RECORD_SUPBOOK = require_biff_record_types.RECORD_SUPBOOK;
 exports.RECORD_TABLE = require_biff_record_types.RECORD_TABLE;
 exports.RECORD_TOPMARGIN = require_biff_record_types.RECORD_TOPMARGIN;
 exports.RECORD_TXO = require_biff_record_types.RECORD_TXO;
+exports.RECORD_USREXCL = require_biff_record_types.RECORD_USREXCL;
 exports.RECORD_VERTICALPAGEBREAKS = require_biff_record_types.RECORD_VERTICALPAGEBREAKS;
 exports.RECORD_WSBOOL = require_biff_record_types.RECORD_WSBOOL;
 exports.RECORD_XF = require_biff_record_types.RECORD_XF;

package/dist/index.d.cts

@@ -2,13 +2,13 @@ import { writeBofData } from "./biff/bof-writer.cjs";
 import { RecordBuilder } from "./biff/builder.cjs";
 import { t as BlockCursor } from "./cursor-VMtw9uVP.cjs";
 import { errorCodeOf, errorTextOf } from "./biff/errors.cjs";
-import { BIFF8_VERSION, BOF_TYPE_CHART, BOF_TYPE_MACRO, BOF_TYPE_WORKBOOK, BOF_TYPE_WORKSHEET, MAX_RECORD_DATA_SIZE, RECORD_ARRAY, RECORD_BLANK, RECORD_BOF, RECORD_BOOLERR, RECORD_BOTTOMMARGIN, RECORD_BOUNDSHEET8, RECORD_CALCCOUNT, RECORD_CALCDELTA, RECORD_CALCITER, RECORD_CALCREFMODE, RECORD_CALCSAVERECALC, RECORD_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_FILEPASS, RECORD_FONT, RECORD_FORMAT, RECORD_FORMULA, RECORD_HORIZONTALPAGEBREAKS, 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_SETUP, RECORD_SHRFMLA, RECORD_SST, RECORD_STRING, RECORD_STYLE, RECORD_SUPBOOK, RECORD_TABLE, RECORD_TOPMARGIN, RECORD_TXO, 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_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 { concatRecords, writeRecord } from "./biff/record-writer.cjs";
-import { n as BiffRecord, r as readRecords, t as BiffFormatError } from "./records-DVIqXFKk.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-Cpy5Fi3d.cjs";
+import { a as splitSubstreams, i as recordByteLength, n as Substream, r as groupRecords, t as RecordGroup } from "./substreams-CHv3oWmn.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_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_FILEPASS, RECORD_FONT, RECORD_FORMAT, RECORD_FORMULA, RECORD_HORIZONTALPAGEBREAKS, 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_SETUP, RECORD_SHRFMLA, RECORD_SST, RECORD_STRING, RECORD_STYLE, RECORD_SUPBOOK, RECORD_TABLE, RECORD_TOPMARGIN, RECORD_TXO, 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, 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 };

package/dist/index.d.ts

@@ -2,13 +2,13 @@ import { writeBofData } from "./biff/bof-writer.js";
 import { RecordBuilder } from "./biff/builder.js";
 import { t as BlockCursor } from "./cursor-VMtw9uVP.js";
 import { errorCodeOf, errorTextOf } from "./biff/errors.js";
-import { BIFF8_VERSION, BOF_TYPE_CHART, BOF_TYPE_MACRO, BOF_TYPE_WORKBOOK, BOF_TYPE_WORKSHEET, MAX_RECORD_DATA_SIZE, RECORD_ARRAY, RECORD_BLANK, RECORD_BOF, RECORD_BOOLERR, RECORD_BOTTOMMARGIN, RECORD_BOUNDSHEET8, RECORD_CALCCOUNT, RECORD_CALCDELTA, RECORD_CALCITER, RECORD_CALCREFMODE, RECORD_CALCSAVERECALC, RECORD_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_FILEPASS, RECORD_FONT, RECORD_FORMAT, RECORD_FORMULA, RECORD_HORIZONTALPAGEBREAKS, 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_SETUP, RECORD_SHRFMLA, RECORD_SST, RECORD_STRING, RECORD_STYLE, RECORD_SUPBOOK, RECORD_TABLE, RECORD_TOPMARGIN, RECORD_TXO, 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_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 { concatRecords, writeRecord } from "./biff/record-writer.js";
-import { n as BiffRecord, r as readRecords, t as BiffFormatError } from "./records-DVIqXFKk.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-CmyZMtuM.js";
+import { a as splitSubstreams, i as recordByteLength, n as Substream, r as groupRecords, t as RecordGroup } from "./substreams-Dp5cZoUo.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_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_FILEPASS, RECORD_FONT, RECORD_FORMAT, RECORD_FORMULA, RECORD_HORIZONTALPAGEBREAKS, 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_SETUP, RECORD_SHRFMLA, RECORD_SST, RECORD_STRING, RECORD_STYLE, RECORD_SUPBOOK, RECORD_TABLE, RECORD_TOPMARGIN, RECORD_TXO, 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, 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 };

package/dist/index.js

@@ -1,5 +1,5 @@
-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_FILEPASS, RECORD_FONT, RECORD_FORMAT, RECORD_FORMULA, RECORD_HORIZONTALPAGEBREAKS, 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_SETUP, RECORD_SHRFMLA, RECORD_SST, RECORD_STRING, RECORD_STYLE, RECORD_SUPBOOK, RECORD_TABLE, RECORD_TOPMARGIN, RECORD_TXO, RECORD_VERTICALPAGEBREAKS, RECORD_WSBOOL, RECORD_XF } from "./biff/record-types.js";
-import { BiffFormatError, readRecords } from "./biff/records.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 { 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 { groupRecords, recordByteLength, splitSubstreams } from "./biff/substreams.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_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_FILEPASS, RECORD_FONT, RECORD_FORMAT, RECORD_FORMULA, RECORD_HORIZONTALPAGEBREAKS, 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_SETUP, RECORD_SHRFMLA, RECORD_SST, RECORD_STRING, RECORD_STYLE, RECORD_SUPBOOK, RECORD_TABLE, RECORD_TOPMARGIN, RECORD_TXO, 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, 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 };

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

@@ -1,4 +1,4 @@
-import { t as RecordGroup } from "./substreams-Cpy5Fi3d.cjs";
+import { t as RecordGroup } from "./substreams-CHv3oWmn.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-C-PQ2vAy.d.ts → print-names-CxAbgcjB.d.ts}

@@ -1,4 +1,4 @@
-import { t as RecordGroup } from "./substreams-CmyZMtuM.js";
+import { t as RecordGroup } from "./substreams-Dp5cZoUo.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/{records-DVIqXFKk.d.cts → records-G82UEVq8.d.cts}

@@ -10,6 +10,8 @@ interface BiffRecord {
 declare class BiffFormatError extends Error {
   constructor(message: string);
 }
+/** The four-byte record header: a two-byte type followed by a two-byte size. Exported for workbook/encryption.ts, which needs a record's own data start offset (the byte position right after this header) to derive the correct RC4 keystream position -- [MS-XLS] 2.2.10 counts a record's own header bytes toward the encryption stream's position even though the header itself is never encrypted. */
+declare const HEADER_SIZE = 4;
 /**
  * Splits a BIFF record stream into its records, in stream order.
  *
@@ -17,4 +19,4 @@ declare class BiffFormatError extends Error {
  */
 declare function readRecords(stream: Uint8Array<ArrayBuffer>): readonly BiffRecord[];
 //#endregion
-export { BiffRecord as n, readRecords as r, BiffFormatError as t };
+export { readRecords as i, BiffRecord as n, HEADER_SIZE as r, BiffFormatError as t };

package/dist/{records-DVIqXFKk.d.ts → records-G82UEVq8.d.ts}

@@ -10,6 +10,8 @@ interface BiffRecord {
 declare class BiffFormatError extends Error {
   constructor(message: string);
 }
+/** The four-byte record header: a two-byte type followed by a two-byte size. Exported for workbook/encryption.ts, which needs a record's own data start offset (the byte position right after this header) to derive the correct RC4 keystream position -- [MS-XLS] 2.2.10 counts a record's own header bytes toward the encryption stream's position even though the header itself is never encrypted. */
+declare const HEADER_SIZE = 4;
 /**
  * Splits a BIFF record stream into its records, in stream order.
  *
@@ -17,4 +19,4 @@ declare class BiffFormatError extends Error {
  */
 declare function readRecords(stream: Uint8Array<ArrayBuffer>): readonly BiffRecord[];
 //#endregion
-export { BiffRecord as n, readRecords as r, BiffFormatError as t };
+export { readRecords as i, BiffRecord as n, HEADER_SIZE as r, BiffFormatError as t };

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

@@ -1,4 +1,4 @@
-import { n as BiffRecord } from "./records-DVIqXFKk.cjs";
+import { n as BiffRecord } from "./records-G82UEVq8.cjs";
 //#region src/biff/substreams.d.ts
 /** One logical record: its type, its data blocks -- the base record's, then one per Continue that followed it -- and the base record's own offset in the stream. */
 interface RecordGroup {

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

@@ -1,4 +1,4 @@
-import { n as BiffRecord } from "./records-DVIqXFKk.js";
+import { n as BiffRecord } from "./records-G82UEVq8.js";
 //#region src/biff/substreams.d.ts
 /** One logical record: its type, its data blocks -- the base record's, then one per Continue that followed it -- and the base record's own offset in the stream. */
 interface RecordGroup {

package/dist/workbook/comments.d.cts

@@ -1,4 +1,4 @@
-import { t as RecordGroup } from "../substreams-Cpy5Fi3d.cjs";
+import { t as RecordGroup } from "../substreams-CHv3oWmn.cjs";
 import { ContentSheetCellComment } from "document-schema.js";
 //#region src/workbook/comments.d.ts
 /** One comment, resolved to the cell position it is anchored to. */

package/dist/workbook/comments.d.ts

@@ -1,4 +1,4 @@
-import { t as RecordGroup } from "../substreams-CmyZMtuM.js";
+import { t as RecordGroup } from "../substreams-Dp5cZoUo.js";
 import { ContentSheetCellComment } from "document-schema.js";
 //#region src/workbook/comments.d.ts
 /** One comment, resolved to the cell position it is anchored to. */

package/dist/workbook/conditional-format-12.d.cts

@@ -1,2 +1,2 @@
-import { a as RawConditionalFormat12, c as RawSimpleFilterFormat, d as RawTop10Format, f as readCondFmt12Group, i as RawColorScaleFormat, l as RawTimePeriod, n as RawAboveAverageFormat, o as RawDataBarFormat, r as RawCfColor, s as RawIconSetFormat, t as CondFmt12GroupResult, u as RawTimePeriodFormat } from "../conditional-format-12-DPNiYLVp.cjs";
+import { a as RawConditionalFormat12, c as RawSimpleFilterFormat, d as RawTop10Format, f as readCondFmt12Group, i as RawColorScaleFormat, l as RawTimePeriod, n as RawAboveAverageFormat, o as RawDataBarFormat, r as RawCfColor, s as RawIconSetFormat, t as CondFmt12GroupResult, u as RawTimePeriodFormat } from "../conditional-format-12-DBhe7Zo6.cjs";
 export { CondFmt12GroupResult, RawAboveAverageFormat, RawCfColor, RawColorScaleFormat, RawConditionalFormat12, RawDataBarFormat, RawIconSetFormat, RawSimpleFilterFormat, RawTimePeriod, RawTimePeriodFormat, RawTop10Format, readCondFmt12Group };

package/dist/workbook/conditional-format-12.d.ts

@@ -1,2 +1,2 @@
-import { a as RawConditionalFormat12, c as RawSimpleFilterFormat, d as RawTop10Format, f as readCondFmt12Group, i as RawColorScaleFormat, l as RawTimePeriod, n as RawAboveAverageFormat, o as RawDataBarFormat, r as RawCfColor, s as RawIconSetFormat, t as CondFmt12GroupResult, u as RawTimePeriodFormat } from "../conditional-format-12-DyqonR1G.js";
+import { a as RawConditionalFormat12, c as RawSimpleFilterFormat, d as RawTop10Format, f as readCondFmt12Group, i as RawColorScaleFormat, l as RawTimePeriod, n as RawAboveAverageFormat, o as RawDataBarFormat, r as RawCfColor, s as RawIconSetFormat, t as CondFmt12GroupResult, u as RawTimePeriodFormat } from "../conditional-format-12-D-X5g_O3.js";
 export { CondFmt12GroupResult, RawAboveAverageFormat, RawCfColor, RawColorScaleFormat, RawConditionalFormat12, RawDataBarFormat, RawIconSetFormat, RawSimpleFilterFormat, RawTimePeriod, RawTimePeriodFormat, RawTop10Format, readCondFmt12Group };

package/dist/workbook/conditional-format.d.cts

@@ -1,2 +1,2 @@
-import { a as parseDxfStyle, i as RawConditionalFormatStyle, n as RawConditionalFormat, o as readCondFmtGroup, r as RawConditionalFormatFill, t as CondFmtGroupResult } from "../conditional-format-S9NaPjhr.cjs";
+import { a as parseDxfStyle, i as RawConditionalFormatStyle, n as RawConditionalFormat, o as readCondFmtGroup, r as RawConditionalFormatFill, t as CondFmtGroupResult } from "../conditional-format-Czh2oTzQ.cjs";
 export { CondFmtGroupResult, RawConditionalFormat, RawConditionalFormatFill, RawConditionalFormatStyle, parseDxfStyle, readCondFmtGroup };

package/dist/workbook/conditional-format.d.ts

@@ -1,2 +1,2 @@
-import { a as parseDxfStyle, i as RawConditionalFormatStyle, n as RawConditionalFormat, o as readCondFmtGroup, r as RawConditionalFormatFill, t as CondFmtGroupResult } from "../conditional-format-CWlz0Ty6.js";
+import { a as parseDxfStyle, i as RawConditionalFormatStyle, n as RawConditionalFormat, o as readCondFmtGroup, r as RawConditionalFormatFill, t as CondFmtGroupResult } from "../conditional-format-DOdazxWe.js";
 export { CondFmtGroupResult, RawConditionalFormat, RawConditionalFormatFill, RawConditionalFormatStyle, parseDxfStyle, readCondFmtGroup };

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

@@ -1,2 +1,2 @@
-import { n as readDv, t as RawDataValidation } from "../data-validation-DZPzAW-8.cjs";
+import { n as readDv, t as RawDataValidation } from "../data-validation-DfpjUN-N.cjs";
 export { RawDataValidation, readDv };

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

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

package/dist/workbook/encryption.cjs

@@ -0,0 +1,78 @@
+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_cursor = require("../biff/cursor.cjs");
+let archive_codec = require("archive-codec");
+//#region src/workbook/encryption.ts
+/** [MS-XLS] 2.4.117's own wEncryptionType: RC4 encryption, as opposed to 0x0000 (XOR obfuscation, out of scope). */
+const ENCRYPTION_TYPE_RC4 = 1;
+/** [MS-OFFCRYPTO] 2.3.6.1's own EncryptionVersionInfo: vMajor/vMinor MUST both be 1 for the "RC4 encryption header" this module reads. vMajor 2/3/4 with vMinor 2 names the RC4 CryptoAPI encryption header instead (2.3.5.1), a different, unimplemented header shape. */
+const RC4_HEADER_VERSION_MAJOR = 1;
+const RC4_HEADER_VERSION_MINOR = 1;
+/** The first four bytes of a BoundSheet8 record's own data ([MS-XLS] 2.4.28): lbPlyPos, the one field [MS-XLS] 2.2.10 names as never encrypted even though the rest of the record is. */
+const BOUNDSHEET8_LBPLYPOS_SIZE = 4;
+/** [MS-XLS] 2.2.10's own list of records that "MUST NOT be obfuscated or encrypted" wherever they occur in the workbook stream -- BOF and FilePass are checked ahead of this set by their callers, since both matter beyond encryption too. */
+const NEVER_ENCRYPTED_RECORD_TYPES = /* @__PURE__ */ new Set([
+	require_biff_record_types.RECORD_BOF,
+	47,
+	404,
+	405,
+	225,
+	406,
+	312
+]);
+/** Reads FilePass's own fields, rejecting the two encryption schemes this module does not implement with a specific message rather than a generic parse failure. */
+function readFilePassRc4Header(filePassRecord) {
+	const cursor = new require_biff_cursor.BlockCursor([filePassRecord.data]);
+	const encryptionType = cursor.u16();
+	if (encryptionType !== ENCRYPTION_TYPE_RC4) throw new require_biff_records.BiffFormatError(`workbook uses FilePass wEncryptionType 0x${encryptionType.toString(16).padStart(4, "0")} (XOR obfuscation), which this reader does not decrypt`);
+	const versionMajor = cursor.u16();
+	const versionMinor = cursor.u16();
+	if (versionMajor !== RC4_HEADER_VERSION_MAJOR || versionMinor !== RC4_HEADER_VERSION_MINOR) throw new require_biff_records.BiffFormatError(`workbook uses RC4 CryptoAPI encryption (EncryptionVersionInfo ${versionMajor}.${versionMinor}), which this reader does not decrypt`);
+	return {
+		salt: cursor.take(archive_codec.OFFICE_RC4_VERIFIER_LENGTH),
+		encryptedVerifier: cursor.take(archive_codec.OFFICE_RC4_VERIFIER_LENGTH),
+		encryptedVerifierHash: cursor.take(archive_codec.OFFICE_RC4_VERIFIER_LENGTH)
+	};
+}
+/** [MS-OFFCRYPTO] 2.3.6.4's own password verification: block 0's key decrypts EncryptedVerifier, and MD5 of the result must equal the same block's decryption of EncryptedVerifierHash. Both verifier fields sit in one continuous keystream starting at position 0, not two independently-reset ones -- though decryptOfficeRc4 regenerates its keystream fresh from block start on every call regardless, so decrypting them as two separate 16-byte calls at offsets 0 and 16 is equivalent to one 32-byte call, not merely close to it. */
+function verifyOfficeRc4Password(baseHash, header) {
+	const decryptedVerifier = (0, archive_codec.decryptOfficeRc4)(baseHash, 0, header.encryptedVerifier);
+	const decryptedVerifierHash = (0, archive_codec.decryptOfficeRc4)(baseHash, archive_codec.OFFICE_RC4_VERIFIER_LENGTH, header.encryptedVerifierHash);
+	const computedHash = (0, archive_codec.md5)(decryptedVerifier);
+	if (!(computedHash.length === decryptedVerifierHash.length && computedHash.every((byte, index) => byte === decryptedVerifierHash[index]))) throw new require_biff_records.BiffFormatError("incorrect password for RC4-encrypted workbook");
+}
+/** Decrypts one record's own data in place against the derived base hash, honouring every [MS-XLS] 2.2.10 exclusion: a never-encrypted record's data is returned unchanged, BoundSheet8's own lbPlyPos prefix is preserved while the rest of its data is decrypted, and everything else is decrypted whole. `record.offset` is the record's own header start, so its data begins `HEADER_SIZE` bytes further into the stream -- the position [MS-OFFCRYPTO]'s block-keyed keystream is defined against. */
+function decryptRecord(record, baseHash) {
+	if (NEVER_ENCRYPTED_RECORD_TYPES.has(record.type)) return record;
+	const dataOffset = record.offset + 4;
+	if (record.type === 133) {
+		const lbPlyPos = record.data.subarray(0, BOUNDSHEET8_LBPLYPOS_SIZE);
+		const decryptedRest = (0, archive_codec.decryptOfficeRc4)(baseHash, dataOffset + BOUNDSHEET8_LBPLYPOS_SIZE, record.data.subarray(BOUNDSHEET8_LBPLYPOS_SIZE));
+		const data = new Uint8Array(record.data.length);
+		data.set(lbPlyPos, 0);
+		data.set(decryptedRest, BOUNDSHEET8_LBPLYPOS_SIZE);
+		return {
+			...record,
+			data
+		};
+	}
+	return {
+		...record,
+		data: (0, archive_codec.decryptOfficeRc4)(baseHash, dataOffset, record.data)
+	};
+}
+/**
+* Decrypts every record of a workbook stream protected by [MS-OFFCRYPTO] 2.3.6.1's RC4 encryption header, given the `FilePass` record already located within `records` and the password to decrypt it with.
+*
+* Throws `BiffFormatError` for a missing password, an incorrect one, or an encryption scheme this module does not implement (RC4 CryptoAPI, XOR obfuscation) -- there is no partial or best-effort result to return in any of those cases.
+*/
+function decryptWorkbookRecords(records, filePassRecord, password) {
+	const header = readFilePassRc4Header(filePassRecord);
+	if (password === void 0) throw new require_biff_records.BiffFormatError("workbook is RC4-encrypted (FilePass record); call readXlsContent with a password to decrypt it");
+	const baseHash = (0, archive_codec.deriveOfficeRc4BaseHash)(password, header.salt);
+	verifyOfficeRc4Password(baseHash, header);
+	return records.map((record) => decryptRecord(record, baseHash));
+}
+//#endregion
+exports.decryptWorkbookRecords = decryptWorkbookRecords;

package/dist/workbook/encryption.d.cts

@@ -0,0 +1,10 @@
+import { n as BiffRecord } from "../records-G82UEVq8.cjs";
+//#region src/workbook/encryption.d.ts
+/**
+ * Decrypts every record of a workbook stream protected by [MS-OFFCRYPTO] 2.3.6.1's RC4 encryption header, given the `FilePass` record already located within `records` and the password to decrypt it with.
+ *
+ * Throws `BiffFormatError` for a missing password, an incorrect one, or an encryption scheme this module does not implement (RC4 CryptoAPI, XOR obfuscation) -- there is no partial or best-effort result to return in any of those cases.
+ */
+declare function decryptWorkbookRecords(records: readonly BiffRecord[], filePassRecord: BiffRecord, password: string | undefined): readonly BiffRecord[];
+//#endregion
+export { decryptWorkbookRecords };

package/dist/workbook/encryption.d.ts

@@ -0,0 +1,10 @@
+import { n as BiffRecord } from "../records-G82UEVq8.js";
+//#region src/workbook/encryption.d.ts
+/**
+ * Decrypts every record of a workbook stream protected by [MS-OFFCRYPTO] 2.3.6.1's RC4 encryption header, given the `FilePass` record already located within `records` and the password to decrypt it with.
+ *
+ * Throws `BiffFormatError` for a missing password, an incorrect one, or an encryption scheme this module does not implement (RC4 CryptoAPI, XOR obfuscation) -- there is no partial or best-effort result to return in any of those cases.
+ */
+declare function decryptWorkbookRecords(records: readonly BiffRecord[], filePassRecord: BiffRecord, password: string | undefined): readonly BiffRecord[];
+//#endregion
+export { decryptWorkbookRecords };

package/dist/workbook/encryption.js

@@ -0,0 +1,77 @@
+import { RECORD_BOF } from "../biff/record-types.js";
+import { BiffFormatError } from "../biff/records.js";
+import { BlockCursor } from "../biff/cursor.js";
+import { OFFICE_RC4_VERIFIER_LENGTH, decryptOfficeRc4, deriveOfficeRc4BaseHash, md5 } from "archive-codec";
+//#region src/workbook/encryption.ts
+/** [MS-XLS] 2.4.117's own wEncryptionType: RC4 encryption, as opposed to 0x0000 (XOR obfuscation, out of scope). */
+const ENCRYPTION_TYPE_RC4 = 1;
+/** [MS-OFFCRYPTO] 2.3.6.1's own EncryptionVersionInfo: vMajor/vMinor MUST both be 1 for the "RC4 encryption header" this module reads. vMajor 2/3/4 with vMinor 2 names the RC4 CryptoAPI encryption header instead (2.3.5.1), a different, unimplemented header shape. */
+const RC4_HEADER_VERSION_MAJOR = 1;
+const RC4_HEADER_VERSION_MINOR = 1;
+/** The first four bytes of a BoundSheet8 record's own data ([MS-XLS] 2.4.28): lbPlyPos, the one field [MS-XLS] 2.2.10 names as never encrypted even though the rest of the record is. */
+const BOUNDSHEET8_LBPLYPOS_SIZE = 4;
+/** [MS-XLS] 2.2.10's own list of records that "MUST NOT be obfuscated or encrypted" wherever they occur in the workbook stream -- BOF and FilePass are checked ahead of this set by their callers, since both matter beyond encryption too. */
+const NEVER_ENCRYPTED_RECORD_TYPES = /* @__PURE__ */ new Set([
+	RECORD_BOF,
+	47,
+	404,
+	405,
+	225,
+	406,
+	312
+]);
+/** Reads FilePass's own fields, rejecting the two encryption schemes this module does not implement with a specific message rather than a generic parse failure. */
+function readFilePassRc4Header(filePassRecord) {
+	const cursor = new BlockCursor([filePassRecord.data]);
+	const encryptionType = cursor.u16();
+	if (encryptionType !== ENCRYPTION_TYPE_RC4) throw new BiffFormatError(`workbook uses FilePass wEncryptionType 0x${encryptionType.toString(16).padStart(4, "0")} (XOR obfuscation), which this reader does not decrypt`);
+	const versionMajor = cursor.u16();
+	const versionMinor = cursor.u16();
+	if (versionMajor !== RC4_HEADER_VERSION_MAJOR || versionMinor !== RC4_HEADER_VERSION_MINOR) throw new BiffFormatError(`workbook uses RC4 CryptoAPI encryption (EncryptionVersionInfo ${versionMajor}.${versionMinor}), which this reader does not decrypt`);
+	return {
+		salt: cursor.take(OFFICE_RC4_VERIFIER_LENGTH),
+		encryptedVerifier: cursor.take(OFFICE_RC4_VERIFIER_LENGTH),
+		encryptedVerifierHash: cursor.take(OFFICE_RC4_VERIFIER_LENGTH)
+	};
+}
+/** [MS-OFFCRYPTO] 2.3.6.4's own password verification: block 0's key decrypts EncryptedVerifier, and MD5 of the result must equal the same block's decryption of EncryptedVerifierHash. Both verifier fields sit in one continuous keystream starting at position 0, not two independently-reset ones -- though decryptOfficeRc4 regenerates its keystream fresh from block start on every call regardless, so decrypting them as two separate 16-byte calls at offsets 0 and 16 is equivalent to one 32-byte call, not merely close to it. */
+function verifyOfficeRc4Password(baseHash, header) {
+	const decryptedVerifier = decryptOfficeRc4(baseHash, 0, header.encryptedVerifier);
+	const decryptedVerifierHash = decryptOfficeRc4(baseHash, OFFICE_RC4_VERIFIER_LENGTH, header.encryptedVerifierHash);
+	const computedHash = md5(decryptedVerifier);
+	if (!(computedHash.length === decryptedVerifierHash.length && computedHash.every((byte, index) => byte === decryptedVerifierHash[index]))) throw new BiffFormatError("incorrect password for RC4-encrypted workbook");
+}
+/** Decrypts one record's own data in place against the derived base hash, honouring every [MS-XLS] 2.2.10 exclusion: a never-encrypted record's data is returned unchanged, BoundSheet8's own lbPlyPos prefix is preserved while the rest of its data is decrypted, and everything else is decrypted whole. `record.offset` is the record's own header start, so its data begins `HEADER_SIZE` bytes further into the stream -- the position [MS-OFFCRYPTO]'s block-keyed keystream is defined against. */
+function decryptRecord(record, baseHash) {
+	if (NEVER_ENCRYPTED_RECORD_TYPES.has(record.type)) return record;
+	const dataOffset = record.offset + 4;
+	if (record.type === 133) {
+		const lbPlyPos = record.data.subarray(0, BOUNDSHEET8_LBPLYPOS_SIZE);
+		const decryptedRest = decryptOfficeRc4(baseHash, dataOffset + BOUNDSHEET8_LBPLYPOS_SIZE, record.data.subarray(BOUNDSHEET8_LBPLYPOS_SIZE));
+		const data = new Uint8Array(record.data.length);
+		data.set(lbPlyPos, 0);
+		data.set(decryptedRest, BOUNDSHEET8_LBPLYPOS_SIZE);
+		return {
+			...record,
+			data
+		};
+	}
+	return {
+		...record,
+		data: decryptOfficeRc4(baseHash, dataOffset, record.data)
+	};
+}
+/**
+* Decrypts every record of a workbook stream protected by [MS-OFFCRYPTO] 2.3.6.1's RC4 encryption header, given the `FilePass` record already located within `records` and the password to decrypt it with.
+*
+* Throws `BiffFormatError` for a missing password, an incorrect one, or an encryption scheme this module does not implement (RC4 CryptoAPI, XOR obfuscation) -- there is no partial or best-effort result to return in any of those cases.
+*/
+function decryptWorkbookRecords(records, filePassRecord, password) {
+	const header = readFilePassRc4Header(filePassRecord);
+	if (password === void 0) throw new BiffFormatError("workbook is RC4-encrypted (FilePass record); call readXlsContent with a password to decrypt it");
+	const baseHash = deriveOfficeRc4BaseHash(password, header.salt);
+	verifyOfficeRc4Password(baseHash, header);
+	return records.map((record) => decryptRecord(record, baseHash));
+}
+//#endregion
+export { decryptWorkbookRecords };

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

@@ -1,5 +1,5 @@
 import { E as XfDecorationFields } from "../xf-colors-mqerVt2O.cjs";
-import { t as PrintNamePlanEntry } from "../print-names-DyYloloV.cjs";
+import { t as PrintNamePlanEntry } from "../print-names-CCwUHAoL.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-d3OvRw76.js";
-import { t as PrintNamePlanEntry } from "../print-names-C-PQ2vAy.js";
+import { t as PrintNamePlanEntry } from "../print-names-CxAbgcjB.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.d.cts

@@ -1,7 +1,7 @@
 import { a as SheetRange, t as ExternalSheetLabel } from "../ptg-CCBbJLZJ.cjs";
-import { t as RecordGroup } from "../substreams-Cpy5Fi3d.cjs";
+import { t as RecordGroup } from "../substreams-CHv3oWmn.cjs";
 import { E as XfDecorationFields, w as XfAlignmentFields } from "../xf-colors-mqerVt2O.cjs";
-import { n as SheetPrintNames } from "../print-names-DyYloloV.cjs";
+import { n as SheetPrintNames } from "../print-names-CCwUHAoL.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). */

package/dist/workbook/globals.d.ts

@@ -1,7 +1,7 @@
 import { a as SheetRange, t as ExternalSheetLabel } from "../ptg-CCBbJLZJ.js";
-import { t as RecordGroup } from "../substreams-CmyZMtuM.js";
+import { t as RecordGroup } from "../substreams-Dp5cZoUo.js";
 import { E as XfDecorationFields, w as XfAlignmentFields } from "../xf-colors-d3OvRw76.js";
-import { n as SheetPrintNames } from "../print-names-C-PQ2vAy.js";
+import { n as SheetPrintNames } from "../print-names-CxAbgcjB.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). */

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

@@ -1,2 +1,2 @@
-import { a as writePrintNameRecords, i as readPrintNames, n as SheetPrintNames, r as printNameEntriesFor, t as PrintNamePlanEntry } from "../print-names-DyYloloV.cjs";
+import { a as writePrintNameRecords, i as readPrintNames, n as SheetPrintNames, r as printNameEntriesFor, t as PrintNamePlanEntry } from "../print-names-CCwUHAoL.cjs";
 export { PrintNamePlanEntry, SheetPrintNames, printNameEntriesFor, readPrintNames, writePrintNameRecords };

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

@@ -1,2 +1,2 @@
-import { a as writePrintNameRecords, i as readPrintNames, n as SheetPrintNames, r as printNameEntriesFor, t as PrintNamePlanEntry } from "../print-names-C-PQ2vAy.js";
+import { a as writePrintNameRecords, i as readPrintNames, n as SheetPrintNames, r as printNameEntriesFor, t as PrintNamePlanEntry } from "../print-names-CxAbgcjB.js";
 export { PrintNamePlanEntry, SheetPrintNames, printNameEntriesFor, readPrintNames, writePrintNameRecords };

package/dist/workbook/sheet.d.cts

@@ -1,9 +1,9 @@
 import { n as SetupFields } from "../print-setup-B_ihDvm5.cjs";
 import { r as FormulaSheetContext } from "../ptg-CCBbJLZJ.cjs";
-import { t as RecordGroup } from "../substreams-Cpy5Fi3d.cjs";
-import { n as RawConditionalFormat } from "../conditional-format-S9NaPjhr.cjs";
-import { a as RawConditionalFormat12 } from "../conditional-format-12-DPNiYLVp.cjs";
-import { t as RawDataValidation } from "../data-validation-DZPzAW-8.cjs";
+import { t as RecordGroup } from "../substreams-CHv3oWmn.cjs";
+import { n as RawConditionalFormat } from "../conditional-format-Czh2oTzQ.cjs";
+import { a as RawConditionalFormat12 } from "../conditional-format-12-DBhe7Zo6.cjs";
+import { t as RawDataValidation } from "../data-validation-DfpjUN-N.cjs";
 //#region src/workbook/sheet.d.ts
 /** A cell's value as its own record carries it, before number-format classification decides whether a number is really a date, a percentage, or an amount of money. */
 type RawCellValue = {

package/dist/workbook/sheet.d.ts

@@ -1,9 +1,9 @@
 import { n as SetupFields } from "../print-setup-B_ihDvm5.js";
 import { r as FormulaSheetContext } from "../ptg-CCBbJLZJ.js";
-import { t as RecordGroup } from "../substreams-CmyZMtuM.js";
-import { n as RawConditionalFormat } from "../conditional-format-CWlz0Ty6.js";
-import { a as RawConditionalFormat12 } from "../conditional-format-12-DyqonR1G.js";
-import { t as RawDataValidation } from "../data-validation-DsVG0Mms.js";
+import { t as RecordGroup } from "../substreams-Dp5cZoUo.js";
+import { n as RawConditionalFormat } from "../conditional-format-DOdazxWe.js";
+import { a as RawConditionalFormat12 } from "../conditional-format-12-D-X5g_O3.js";
+import { t as RawDataValidation } from "../data-validation-BXvIVU0e.js";
 //#region src/workbook/sheet.d.ts
 /** A cell's value as its own record carries it, before number-format classification decides whether a number is really a date, a percentage, or an amount of money. */
 type RawCellValue = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xls-codec",
-  "version": "4.6.0",
+  "version": "4.7.0",
   "description": "Hand-written reader for the legacy Excel Binary File Format (.xls, BIFF8) as specified by [MS-XLS], mapping a workbook's record stream onto the shared document-schema.js spreadsheet model - the .xls codec for the documents.js family.",
   "type": "module",
   "repository": {
@@ -70,7 +70,7 @@
   },
   "packageManager": "pnpm@11.6.0",
   "dependencies": {
-    "archive-codec": "^1.6.8",
+    "archive-codec": "^1.7.0",
     "document-schema.js": "^7.3.0",
     "excel-number-format": "^1.1.0"
   },