xls-codec 4.5.0 → 4.7.0

package/README.md

@@ -55,9 +55,10 @@ Each deliberate rather than overlooked:
 - **Cell comments, resolved for real (ExaDev/documents.js#949).** A legacy BIFF8 comment is split across three record kinds a single self-contained xlsx `<comment>` element never needs: a `Note` record ([MS-XLS] 2.4.179, wrapping a `NoteSh` structure) anchors the comment to a cell and names its author, but carries no text of its own; the text lives in a `Txo` record ([MS-XLS] 2.4.329), its characters carried across trailing `Continue` records; the two are joined through an `Obj` record ([MS-XLS] 2.4.181) whose `FtCmo` names an object id and type, the `Note`'s own `idObj` field naming that same id, and a `Txo` always immediately following the `Obj` record whose shape it belongs to (`src/workbook/comments.ts`). Read in one independent pass over the whole worksheet substream rather than assuming stream order between a `Note` and the `Obj`+`Txo` pair it names -- both are resolved regardless of which comes first. Legacy BIFF8 has no threading and no per-comment timestamp at all (unlike xlsx's own `[MS-XLSX]` threaded-comments extension), so `ContentSheetCellComment.replies` and `.createdAt` are never populated from an `.xls` source; rich per-character formatting within a comment (`TxORuns`) is skipped rather than modelled, the same scope limit this reader already applies to the shared string table's own rich runs, since `ContentSheetCellComment.text` is a plain string with nowhere to carry them.
 - **Data validation, resolved for real (ExaDev/documents.js#1098).** `Dv` ([MS-XLS] 2.4.95) is a fixed, published binary structure -- a bit-packed flags `DWORD` (`valType`/`errStyle`/`fAllowBlank`/`fShowInputMsg`/`fShowErrorMsg`/`typOperator`), four `XLUnicodeString`s (prompt/error titles and messages), one or two `DVParsedFormula` structures, and a trailing `SqRefU` range list -- read directly against that spec (`src/workbook/data-validation.ts`), unlike `calcext:condition`'s own LibreOffice-source-transcribed mini-language odf.js's equivalent reader needed. A `DVParsedFormula`'s own `rgce` is the identical `Ptg` token grammar a cell's `Formula` record carries, so its formula text is recovered with the same `parseFormulaText` this reader already uses for ordinary cell formulas. `DVal` ([MS-XLS] 2.4.96), the record that precedes a sheet's own `Dv` collection, carries only input-window UI state (position, drop-down `Obj` reference) with no counterpart in `ContentSheetDataValidationSchema` and is not read for its own fields.
 - **Conditional formatting, base rules resolved for real (ExaDev/documents.js#1102).** A `CondFmt` record ([MS-XLS] 2.4.56) marks the start of one to three `CF` records ([MS-XLS] 2.4.42) sharing one cell-range list, read together as a group (`src/workbook/conditional-format.ts`) since a `CF`'s own ranges live on its parent `CondFmt`, not on itself. Base BIFF8 (Excel 97) conditional formatting has exactly two rule shapes: a comparison ("Cell Value Is") condition, promoted to `ContentSheetConditionalFormat`'s `cellIs` variant with its formula(s) recovered through the same `parseFormulaText` this reader already uses for cell formulas and `Dv`; and a formula condition, left unpromoted for the same "no closed-form structure without a general formula engine" reason `data-validation.ts` and `ooxml.js`'s own xlsx `cfRule` reading already draw. A rule's resulting style -- font colour and fill background -- comes from its `CF`'s own `DXFN` structure, resolved through the identical `icv`/`Palette` colour machinery a regular cell's fill and border already use ([Cell decoration](#cell-decoration)); a `DXFN` naming a user-defined number format (`DXFNumUsr`) degrades that one rule's style to absent rather than risk misreading the font/fill fields that follow it, since [MS-XLS]'s own prose for `DXFNumUsr`'s length field does not settle whether it counts itself. Every richer rule type Excel 2007+ added has no representation in the base `CF` record at all; it rides a `CF12` record instead, linked to its own `CondFmt` through a `CFEx` extension record.
-- **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`; one naming a plain RGB triple resolves directly; 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. `CF12`'s remaining rule shapes -- comparison/formula rules re-expressed in this newer record shape, and the filter-dispatched template family (top10, aboveAverage, duplicate/unique values, text/date conditions, dispatched through `icfTemplate` + a fixed `CFExTemplateParams` block) -- remain unread (ExaDev/documents.js#1100), along with `CFEx`'s own extension of a legacy `CF` record.
-- **Not read at all:** charts, drawings and images, and `CF12`'s filter-dispatched template rules plus `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.
+- **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.
+- **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-Dw82ECRh.d.ts → conditional-format-12-D-X5g_O3.d.ts}

@@ -1,6 +1,7 @@
 import { r as FormulaSheetContext } from "./ptg-CCBbJLZJ.js";
-import { t as RecordGroup } from "./substreams-CmyZMtuM.js";
-import { Color, ContentSheetConditionalFormatValue, ContentSheetRange } from "document-schema.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 = {
   readonly kind: "icv";
@@ -38,7 +39,33 @@ interface RawIconSetFormat extends RawConditionalFormat12Common {
   readonly reverse: boolean;
   readonly showValue: boolean;
 }
-type RawConditionalFormat12 = RawColorScaleFormat | RawDataBarFormat | RawIconSetFormat;
+type RawTimePeriod = Extract<ContentSheetConditionalFormat, {
+  readonly type: "timePeriod";
+}>["timePeriod"];
+interface RawFilterFormatCommon extends RawConditionalFormat12Common {
+  readonly style: RawConditionalFormatStyle | undefined;
+}
+interface RawTop10Format extends RawFilterFormatCommon {
+  readonly kind: "top10";
+  readonly rank: number;
+  readonly percent: boolean;
+  readonly bottom: boolean;
+}
+interface RawAboveAverageFormat extends RawFilterFormatCommon {
+  readonly kind: "aboveAverage";
+  readonly aboveAverage: boolean;
+  readonly equalAverage: boolean;
+  readonly stdDev: number | undefined;
+}
+interface RawTimePeriodFormat extends RawFilterFormatCommon {
+  readonly kind: "timePeriod";
+  readonly timePeriod: RawTimePeriod;
+}
+/** duplicateValues/uniqueValues and the four blank/error conditions carry no data beyond which one a rule is -- CFExDefaultTemplateParams is 16 reserved bytes ([MS-XLS] 2.4, https://learn.microsoft.com/en-us/openspecs/office_file_formats/ms-xls/c8f156b6-10ec-4594-adb1-c734fbb1fc11). */
+interface RawSimpleFilterFormat extends RawFilterFormatCommon {
+  readonly kind: "containsBlanks" | "notContainsBlanks" | "containsErrors" | "notContainsErrors" | "uniqueValues" | "duplicateValues";
+}
+type RawConditionalFormat12 = RawColorScaleFormat | RawDataBarFormat | RawIconSetFormat | RawTop10Format | RawAboveAverageFormat | RawTimePeriodFormat | RawSimpleFilterFormat;
 interface CondFmt12GroupResult {
   readonly formats: RawConditionalFormat12[];
   /** How many records (the CondFmt12 itself plus every CF12 it claimed) the caller should advance past, regardless of how many rules actually promoted. */
@@ -46,4 +73,4 @@ interface CondFmt12GroupResult {
 }
 declare function readCondFmt12Group(records: readonly RecordGroup[], startIndex: number, formulaSheets: FormulaSheetContext): CondFmt12GroupResult;
 //#endregion
-export { RawDataBarFormat as a, RawConditionalFormat12 as i, RawCfColor as n, RawIconSetFormat as o, RawColorScaleFormat as r, readCondFmt12Group as s, CondFmt12GroupResult as t };
+export { RawConditionalFormat12 as a, RawSimpleFilterFormat as c, RawTop10Format as d, readCondFmt12Group as f, RawColorScaleFormat as i, RawTimePeriod as l, RawAboveAverageFormat as n, RawDataBarFormat as o, RawCfColor as r, RawIconSetFormat as s, CondFmt12GroupResult as t, RawTimePeriodFormat as u };

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

@@ -1,6 +1,7 @@
 import { r as FormulaSheetContext } from "./ptg-CCBbJLZJ.cjs";
-import { t as RecordGroup } from "./substreams-Cpy5Fi3d.cjs";
-import { Color, ContentSheetConditionalFormatValue, ContentSheetRange } from "document-schema.js";
+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 = {
   readonly kind: "icv";
@@ -38,7 +39,33 @@ interface RawIconSetFormat extends RawConditionalFormat12Common {
   readonly reverse: boolean;
   readonly showValue: boolean;
 }
-type RawConditionalFormat12 = RawColorScaleFormat | RawDataBarFormat | RawIconSetFormat;
+type RawTimePeriod = Extract<ContentSheetConditionalFormat, {
+  readonly type: "timePeriod";
+}>["timePeriod"];
+interface RawFilterFormatCommon extends RawConditionalFormat12Common {
+  readonly style: RawConditionalFormatStyle | undefined;
+}
+interface RawTop10Format extends RawFilterFormatCommon {
+  readonly kind: "top10";
+  readonly rank: number;
+  readonly percent: boolean;
+  readonly bottom: boolean;
+}
+interface RawAboveAverageFormat extends RawFilterFormatCommon {
+  readonly kind: "aboveAverage";
+  readonly aboveAverage: boolean;
+  readonly equalAverage: boolean;
+  readonly stdDev: number | undefined;
+}
+interface RawTimePeriodFormat extends RawFilterFormatCommon {
+  readonly kind: "timePeriod";
+  readonly timePeriod: RawTimePeriod;
+}
+/** duplicateValues/uniqueValues and the four blank/error conditions carry no data beyond which one a rule is -- CFExDefaultTemplateParams is 16 reserved bytes ([MS-XLS] 2.4, https://learn.microsoft.com/en-us/openspecs/office_file_formats/ms-xls/c8f156b6-10ec-4594-adb1-c734fbb1fc11). */
+interface RawSimpleFilterFormat extends RawFilterFormatCommon {
+  readonly kind: "containsBlanks" | "notContainsBlanks" | "containsErrors" | "notContainsErrors" | "uniqueValues" | "duplicateValues";
+}
+type RawConditionalFormat12 = RawColorScaleFormat | RawDataBarFormat | RawIconSetFormat | RawTop10Format | RawAboveAverageFormat | RawTimePeriodFormat | RawSimpleFilterFormat;
 interface CondFmt12GroupResult {
   readonly formats: RawConditionalFormat12[];
   /** How many records (the CondFmt12 itself plus every CF12 it claimed) the caller should advance past, regardless of how many rules actually promoted. */
@@ -46,4 +73,4 @@ interface CondFmt12GroupResult {
 }
 declare function readCondFmt12Group(records: readonly RecordGroup[], startIndex: number, formulaSheets: FormulaSheetContext): CondFmt12GroupResult;
 //#endregion
-export { RawDataBarFormat as a, RawConditionalFormat12 as i, RawCfColor as n, RawIconSetFormat as o, RawColorScaleFormat as r, readCondFmt12Group as s, CondFmt12GroupResult as t };
+export { RawConditionalFormat12 as a, RawSimpleFilterFormat as c, RawTop10Format as d, readCondFmt12Group as f, RawColorScaleFormat as i, RawTimePeriod as l, RawAboveAverageFormat as n, RawDataBarFormat as o, RawCfColor as r, RawIconSetFormat as s, CondFmt12GroupResult as t, RawTimePeriodFormat as u };

package/dist/{conditional-format-DUQuOrNW.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 {
@@ -18,6 +18,7 @@ interface RawConditionalFormat {
   readonly style: RawConditionalFormatStyle | undefined;
   readonly ranges: ContentSheetRange[];
 }
+declare function parseDxfStyle(dxfBytes: Uint8Array<ArrayBuffer>): RawConditionalFormatStyle | undefined;
 interface CondFmtGroupResult {
   readonly formats: RawConditionalFormat[];
   /** How many records (the CondFmt itself plus every CF it claimed) the caller should advance past, regardless of how many rules actually promoted. */
@@ -25,4 +26,4 @@ interface CondFmtGroupResult {
 }
 declare function readCondFmtGroup(records: readonly RecordGroup[], startIndex: number, formulaSheets: FormulaSheetContext): CondFmtGroupResult;
 //#endregion
-export { readCondFmtGroup as a, RawConditionalFormatStyle as i, RawConditionalFormat as n, RawConditionalFormatFill as r, CondFmtGroupResult as t };
+export { parseDxfStyle as a, RawConditionalFormatStyle as i, RawConditionalFormat as n, readCondFmtGroup as o, RawConditionalFormatFill as r, CondFmtGroupResult as t };

package/dist/{conditional-format-BV2313jL.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 {
@@ -18,6 +18,7 @@ interface RawConditionalFormat {
   readonly style: RawConditionalFormatStyle | undefined;
   readonly ranges: ContentSheetRange[];
 }
+declare function parseDxfStyle(dxfBytes: Uint8Array<ArrayBuffer>): RawConditionalFormatStyle | undefined;
 interface CondFmtGroupResult {
   readonly formats: RawConditionalFormat[];
   /** How many records (the CondFmt itself plus every CF it claimed) the caller should advance past, regardless of how many rules actually promoted. */
@@ -25,4 +26,4 @@ interface CondFmtGroupResult {
 }
 declare function readCondFmtGroup(records: readonly RecordGroup[], startIndex: number, formulaSheets: FormulaSheetContext): CondFmtGroupResult;
 //#endregion
-export { readCondFmtGroup as a, RawConditionalFormatStyle as i, RawConditionalFormat as n, RawConditionalFormatFill as r, CondFmtGroupResult as t };
+export { parseDxfStyle as a, RawConditionalFormatStyle as i, RawConditionalFormat as n, readCondFmtGroup as o, RawConditionalFormatFill as r, CondFmtGroupResult as t };

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.
@@ -186,12 +189,55 @@ function mapConditionalFormats12(raw, palette) {
 			});
 			continue;
 		}
+		if (format.kind === "iconSet") {
+			results.push({
+				type: "iconSet",
+				iconSetType: format.iconSetType,
+				thresholds: [...format.thresholds],
+				...format.reverse ? { reverse: true } : {},
+				...format.showValue ? {} : { showValue: false },
+				...common
+			});
+			continue;
+		}
+		if (format.kind === "top10") {
+			const style = mapConditionalFormatStyle(format.style, palette);
+			results.push({
+				type: "top10",
+				rank: format.rank,
+				...format.percent ? { percent: true } : {},
+				...format.bottom ? { bottom: true } : {},
+				...style !== void 0 ? { style } : {},
+				...common
+			});
+			continue;
+		}
+		if (format.kind === "aboveAverage") {
+			const style = mapConditionalFormatStyle(format.style, palette);
+			results.push({
+				type: "aboveAverage",
+				...format.aboveAverage ? {} : { aboveAverage: false },
+				...format.equalAverage ? { equalAverage: true } : {},
+				...format.stdDev !== void 0 ? { stdDev: format.stdDev } : {},
+				...style !== void 0 ? { style } : {},
+				...common
+			});
+			continue;
+		}
+		if (format.kind === "timePeriod") {
+			const style = mapConditionalFormatStyle(format.style, palette);
+			results.push({
+				type: "timePeriod",
+				timePeriod: format.timePeriod,
+				...style !== void 0 ? { style } : {},
+				...common
+			});
+			continue;
+		}
+		const style = mapConditionalFormatStyle(format.style, palette);
 		results.push({
-			type: "iconSet",
-			iconSetType: format.iconSetType,
-			thresholds: [...format.thresholds],
-			...format.reverse ? { reverse: true } : {},
-			...format.showValue ? {} : { showValue: false },
+			type: format.kind,
+			...style !== void 0 ? { style } : {},
 			...common
 		});
 	}

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 };