xls-codec 4.5.0 → 4.6.0

package/README.md

@@ -55,8 +55,9 @@ 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.
+- **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.
 
 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/{conditional-format-12-DdEL5DL0.d.cts → conditional-format-12-DPNiYLVp.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 { i as RawConditionalFormatStyle } from "./conditional-format-S9NaPjhr.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-12-Dw82ECRh.d.ts → conditional-format-12-DyqonR1G.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 { i as RawConditionalFormatStyle } from "./conditional-format-CWlz0Ty6.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-BV2313jL.d.ts → conditional-format-CWlz0Ty6.d.ts}

@@ -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-DUQuOrNW.d.cts → conditional-format-S9NaPjhr.d.cts}

@@ -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

@@ -186,12 +186,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.js

@@ -185,12 +185,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/workbook/conditional-format-12.cjs

@@ -3,6 +3,7 @@ require("../biff/record-types.cjs");
 const require_biff_records = require("../biff/records.cjs");
 const require_biff_cursor = require("../biff/cursor.cjs");
 const require_biff_ptg = require("../biff/ptg.cjs");
+const require_workbook_conditional_format = require("./conditional-format.cjs");
 //#region src/workbook/conditional-format-12.ts
 const CFVO_TYPE_TO_VALUE_TYPE = /* @__PURE__ */ new Map([
 	[1, "num"],
@@ -149,6 +150,69 @@ function readCfMultistate(cursor, formulaSheets) {
 		showValue
 	};
 }
+const ICF_TEMPLATE_TOP10 = 5;
+const ICF_TEMPLATE_UNIQUE_VALUES = 7;
+const ICF_TEMPLATE_CONTAINS_BLANKS = 9;
+const ICF_TEMPLATE_CONTAINS_NO_BLANKS = 10;
+const ICF_TEMPLATE_CONTAINS_ERRORS = 11;
+const ICF_TEMPLATE_CONTAINS_NO_ERRORS = 12;
+const ICF_TEMPLATE_ABOVE_AVERAGE = 25;
+const ICF_TEMPLATE_BELOW_AVERAGE = 26;
+const ICF_TEMPLATE_DUPLICATE_VALUES = 27;
+const ICF_TEMPLATE_ABOVE_OR_EQUAL_AVERAGE = 29;
+const ICF_TEMPLATE_BELOW_OR_EQUAL_AVERAGE = 30;
+const ICF_TEMPLATE_TO_TIME_PERIOD = /* @__PURE__ */ new Map([
+	[15, "today"],
+	[16, "tomorrow"],
+	[17, "yesterday"],
+	[18, "last7Days"],
+	[19, "lastMonth"],
+	[20, "nextMonth"],
+	[21, "thisWeek"],
+	[22, "nextWeek"],
+	[23, "lastWeek"],
+	[24, "thisMonth"]
+]);
+const SIMPLE_ICF_TEMPLATE_KIND = /* @__PURE__ */ new Map([
+	[ICF_TEMPLATE_UNIQUE_VALUES, "uniqueValues"],
+	[ICF_TEMPLATE_CONTAINS_BLANKS, "containsBlanks"],
+	[ICF_TEMPLATE_CONTAINS_NO_BLANKS, "notContainsBlanks"],
+	[ICF_TEMPLATE_CONTAINS_ERRORS, "containsErrors"],
+	[ICF_TEMPLATE_CONTAINS_NO_ERRORS, "notContainsErrors"],
+	[ICF_TEMPLATE_DUPLICATE_VALUES, "duplicateValues"]
+]);
+function readCfFilterRule(icfTemplate, templateParams) {
+	if (icfTemplate === ICF_TEMPLATE_TOP10) {
+		const cursor = new require_biff_cursor.BlockCursor([templateParams]);
+		const flags = cursor.u8();
+		const top = (flags & 1) !== 0;
+		const percent = (flags >>> 1 & 1) !== 0;
+		const rank = cursor.u16();
+		if (rank <= 0) return;
+		return {
+			kind: "top10",
+			rank,
+			percent,
+			bottom: !top
+		};
+	}
+	if (icfTemplate === ICF_TEMPLATE_ABOVE_AVERAGE || icfTemplate === ICF_TEMPLATE_BELOW_AVERAGE || icfTemplate === ICF_TEMPLATE_ABOVE_OR_EQUAL_AVERAGE || icfTemplate === ICF_TEMPLATE_BELOW_OR_EQUAL_AVERAGE) {
+		const iParam = new require_biff_cursor.BlockCursor([templateParams]).u16();
+		return {
+			kind: "aboveAverage",
+			aboveAverage: icfTemplate === ICF_TEMPLATE_ABOVE_AVERAGE || icfTemplate === ICF_TEMPLATE_ABOVE_OR_EQUAL_AVERAGE,
+			equalAverage: icfTemplate === ICF_TEMPLATE_ABOVE_OR_EQUAL_AVERAGE || icfTemplate === ICF_TEMPLATE_BELOW_OR_EQUAL_AVERAGE,
+			stdDev: iParam > 0 ? iParam : void 0
+		};
+	}
+	const timePeriod = ICF_TEMPLATE_TO_TIME_PERIOD.get(icfTemplate);
+	if (timePeriod !== void 0) return {
+		kind: "timePeriod",
+		timePeriod
+	};
+	const simpleKind = SIMPLE_ICF_TEMPLATE_KIND.get(icfTemplate);
+	if (simpleKind !== void 0) return { kind: simpleKind };
+}
 function readCf12(record, ranges, formulaSheets) {
 	try {
 		const cursor = new require_biff_cursor.BlockCursor(record.blocks);
@@ -158,16 +222,16 @@ function readCf12(record, ranges, formulaSheets) {
 		const cce1 = cursor.u16();
 		const cce2 = cursor.u16();
 		const cbDxf = cursor.u32();
-		cursor.skip(cbDxf);
+		const dxfBytes = cursor.take(cbDxf);
 		cursor.skip(cce1);
 		cursor.skip(cce2);
 		const cceActive = cursor.u16();
 		cursor.skip(cceActive);
 		const stopIfTrue = (cursor.u8() & 2) !== 0;
 		const priority = cursor.u16();
-		cursor.skip(2);
+		const icfTemplate = cursor.u16();
 		cursor.skip(1);
-		cursor.skip(16);
+		const templateParams = cursor.take(16);
 		const common = {
 			priority,
 			stopIfTrue,
@@ -197,6 +261,18 @@ function readCf12(record, ranges, formulaSheets) {
 				...common
 			};
 		}
+		if (ct === 5) {
+			const rule = readCfFilterRule(icfTemplate, templateParams);
+			const cbFilter = cursor.u16();
+			cursor.skip(cbFilter);
+			if (rule === void 0) return;
+			const style = require_workbook_conditional_format.parseDxfStyle(dxfBytes);
+			return {
+				...rule,
+				...common,
+				style
+			};
+		}
 		return;
 	} catch (err) {
 		if (!(err instanceof require_biff_records.BiffFormatError)) throw err;

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

@@ -1,2 +1,2 @@
-import { a as RawDataBarFormat, i as RawConditionalFormat12, n as RawCfColor, o as RawIconSetFormat, r as RawColorScaleFormat, s as readCondFmt12Group, t as CondFmt12GroupResult } from "../conditional-format-12-DdEL5DL0.cjs";
-export { CondFmt12GroupResult, RawCfColor, RawColorScaleFormat, RawConditionalFormat12, RawDataBarFormat, RawIconSetFormat, readCondFmt12Group };
+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";
+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 RawDataBarFormat, i as RawConditionalFormat12, n as RawCfColor, o as RawIconSetFormat, r as RawColorScaleFormat, s as readCondFmt12Group, t as CondFmt12GroupResult } from "../conditional-format-12-Dw82ECRh.js";
-export { CondFmt12GroupResult, RawCfColor, RawColorScaleFormat, RawConditionalFormat12, RawDataBarFormat, RawIconSetFormat, readCondFmt12Group };
+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";
+export { CondFmt12GroupResult, RawAboveAverageFormat, RawCfColor, RawColorScaleFormat, RawConditionalFormat12, RawDataBarFormat, RawIconSetFormat, RawSimpleFilterFormat, RawTimePeriod, RawTimePeriodFormat, RawTop10Format, readCondFmt12Group };

package/dist/workbook/conditional-format-12.js

@@ -2,6 +2,7 @@ import "../biff/record-types.js";
 import { BiffFormatError } from "../biff/records.js";
 import { BlockCursor } from "../biff/cursor.js";
 import { parseFormulaText } from "../biff/ptg.js";
+import { parseDxfStyle } from "./conditional-format.js";
 //#region src/workbook/conditional-format-12.ts
 const CFVO_TYPE_TO_VALUE_TYPE = /* @__PURE__ */ new Map([
 	[1, "num"],
@@ -148,6 +149,69 @@ function readCfMultistate(cursor, formulaSheets) {
 		showValue
 	};
 }
+const ICF_TEMPLATE_TOP10 = 5;
+const ICF_TEMPLATE_UNIQUE_VALUES = 7;
+const ICF_TEMPLATE_CONTAINS_BLANKS = 9;
+const ICF_TEMPLATE_CONTAINS_NO_BLANKS = 10;
+const ICF_TEMPLATE_CONTAINS_ERRORS = 11;
+const ICF_TEMPLATE_CONTAINS_NO_ERRORS = 12;
+const ICF_TEMPLATE_ABOVE_AVERAGE = 25;
+const ICF_TEMPLATE_BELOW_AVERAGE = 26;
+const ICF_TEMPLATE_DUPLICATE_VALUES = 27;
+const ICF_TEMPLATE_ABOVE_OR_EQUAL_AVERAGE = 29;
+const ICF_TEMPLATE_BELOW_OR_EQUAL_AVERAGE = 30;
+const ICF_TEMPLATE_TO_TIME_PERIOD = /* @__PURE__ */ new Map([
+	[15, "today"],
+	[16, "tomorrow"],
+	[17, "yesterday"],
+	[18, "last7Days"],
+	[19, "lastMonth"],
+	[20, "nextMonth"],
+	[21, "thisWeek"],
+	[22, "nextWeek"],
+	[23, "lastWeek"],
+	[24, "thisMonth"]
+]);
+const SIMPLE_ICF_TEMPLATE_KIND = /* @__PURE__ */ new Map([
+	[ICF_TEMPLATE_UNIQUE_VALUES, "uniqueValues"],
+	[ICF_TEMPLATE_CONTAINS_BLANKS, "containsBlanks"],
+	[ICF_TEMPLATE_CONTAINS_NO_BLANKS, "notContainsBlanks"],
+	[ICF_TEMPLATE_CONTAINS_ERRORS, "containsErrors"],
+	[ICF_TEMPLATE_CONTAINS_NO_ERRORS, "notContainsErrors"],
+	[ICF_TEMPLATE_DUPLICATE_VALUES, "duplicateValues"]
+]);
+function readCfFilterRule(icfTemplate, templateParams) {
+	if (icfTemplate === ICF_TEMPLATE_TOP10) {
+		const cursor = new BlockCursor([templateParams]);
+		const flags = cursor.u8();
+		const top = (flags & 1) !== 0;
+		const percent = (flags >>> 1 & 1) !== 0;
+		const rank = cursor.u16();
+		if (rank <= 0) return;
+		return {
+			kind: "top10",
+			rank,
+			percent,
+			bottom: !top
+		};
+	}
+	if (icfTemplate === ICF_TEMPLATE_ABOVE_AVERAGE || icfTemplate === ICF_TEMPLATE_BELOW_AVERAGE || icfTemplate === ICF_TEMPLATE_ABOVE_OR_EQUAL_AVERAGE || icfTemplate === ICF_TEMPLATE_BELOW_OR_EQUAL_AVERAGE) {
+		const iParam = new BlockCursor([templateParams]).u16();
+		return {
+			kind: "aboveAverage",
+			aboveAverage: icfTemplate === ICF_TEMPLATE_ABOVE_AVERAGE || icfTemplate === ICF_TEMPLATE_ABOVE_OR_EQUAL_AVERAGE,
+			equalAverage: icfTemplate === ICF_TEMPLATE_ABOVE_OR_EQUAL_AVERAGE || icfTemplate === ICF_TEMPLATE_BELOW_OR_EQUAL_AVERAGE,
+			stdDev: iParam > 0 ? iParam : void 0
+		};
+	}
+	const timePeriod = ICF_TEMPLATE_TO_TIME_PERIOD.get(icfTemplate);
+	if (timePeriod !== void 0) return {
+		kind: "timePeriod",
+		timePeriod
+	};
+	const simpleKind = SIMPLE_ICF_TEMPLATE_KIND.get(icfTemplate);
+	if (simpleKind !== void 0) return { kind: simpleKind };
+}
 function readCf12(record, ranges, formulaSheets) {
 	try {
 		const cursor = new BlockCursor(record.blocks);
@@ -157,16 +221,16 @@ function readCf12(record, ranges, formulaSheets) {
 		const cce1 = cursor.u16();
 		const cce2 = cursor.u16();
 		const cbDxf = cursor.u32();
-		cursor.skip(cbDxf);
+		const dxfBytes = cursor.take(cbDxf);
 		cursor.skip(cce1);
 		cursor.skip(cce2);
 		const cceActive = cursor.u16();
 		cursor.skip(cceActive);
 		const stopIfTrue = (cursor.u8() & 2) !== 0;
 		const priority = cursor.u16();
-		cursor.skip(2);
+		const icfTemplate = cursor.u16();
 		cursor.skip(1);
-		cursor.skip(16);
+		const templateParams = cursor.take(16);
 		const common = {
 			priority,
 			stopIfTrue,
@@ -196,6 +260,18 @@ function readCf12(record, ranges, formulaSheets) {
 				...common
 			};
 		}
+		if (ct === 5) {
+			const rule = readCfFilterRule(icfTemplate, templateParams);
+			const cbFilter = cursor.u16();
+			cursor.skip(cbFilter);
+			if (rule === void 0) return;
+			const style = parseDxfStyle(dxfBytes);
+			return {
+				...rule,
+				...common,
+				style
+			};
+		}
 		return;
 	} catch (err) {
 		if (!(err instanceof BiffFormatError)) throw err;

package/dist/workbook/conditional-format.cjs

@@ -138,4 +138,5 @@ function readCondFmtGroup(records, startIndex, formulaSheets) {
 	}
 }
 //#endregion
+exports.parseDxfStyle = parseDxfStyle;
 exports.readCondFmtGroup = readCondFmtGroup;

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

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

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

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

package/dist/workbook/conditional-format.js

@@ -137,4 +137,4 @@ function readCondFmtGroup(records, startIndex, formulaSheets) {
 	}
 }
 //#endregion
-export { readCondFmtGroup };
+export { parseDxfStyle, readCondFmtGroup };

package/dist/workbook/sheet.d.cts

@@ -1,8 +1,8 @@
 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-DUQuOrNW.cjs";
-import { i as RawConditionalFormat12 } from "../conditional-format-12-DdEL5DL0.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";
 //#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. */

package/dist/workbook/sheet.d.ts

@@ -1,8 +1,8 @@
 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-BV2313jL.js";
-import { i as RawConditionalFormat12 } from "../conditional-format-12-Dw82ECRh.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";
 //#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. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xls-codec",
-  "version": "4.5.0",
+  "version": "4.6.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": {