xls-codec 4.7.6 → 4.9.0

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

@@ -1,7 +1,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 { extractFirstStringLiteral, 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([
@@ -149,6 +149,25 @@ function readCfMultistate(cursor, formulaSheets) {
 		showValue
 	};
 }
+const ICF_TEMPLATE_CONTAINS_TEXT = 8;
+const CTP_TO_TEXT_KIND = /* @__PURE__ */ new Map([
+	[0, "containsText"],
+	[1, "notContainsText"],
+	[2, "beginsWith"],
+	[3, "endsWith"]
+]);
+function readCfTextFilterRule(icfTemplate, templateParams, rgce1, formulaSheets) {
+	if (icfTemplate !== ICF_TEMPLATE_CONTAINS_TEXT) return;
+	const ctp = new BlockCursor([templateParams]).u16();
+	const kind = CTP_TO_TEXT_KIND.get(ctp);
+	if (kind === void 0) return;
+	const text = extractFirstStringLiteral(rgce1, formulaSheets);
+	if (text === void 0) return;
+	return {
+		kind,
+		text
+	};
+}
 const ICF_TEMPLATE_TOP10 = 5;
 const ICF_TEMPLATE_UNIQUE_VALUES = 7;
 const ICF_TEMPLATE_CONTAINS_BLANKS = 9;
@@ -222,7 +241,7 @@ function readCf12(record, ranges, formulaSheets) {
 		const cce2 = cursor.u16();
 		const cbDxf = cursor.u32();
 		const dxfBytes = cursor.take(cbDxf);
-		cursor.skip(cce1);
+		const rgce1 = cursor.take(cce1);
 		cursor.skip(cce2);
 		const cceActive = cursor.u16();
 		cursor.skip(cceActive);
@@ -272,6 +291,17 @@ function readCf12(record, ranges, formulaSheets) {
 				style
 			};
 		}
+		if (ct === 2) {
+			const textRule = readCfTextFilterRule(icfTemplate, templateParams, rgce1, formulaSheets);
+			if (textRule !== void 0) {
+				const style = parseDxfStyle(dxfBytes);
+				return {
+					...textRule,
+					...common,
+					style
+				};
+			}
+		}
 		return;
 	} catch (err) {
 		if (!(err instanceof BiffFormatError)) throw err;
@@ -327,4 +357,4 @@ function readCondFmt12Group(records, startIndex, formulaSheets) {
 	}
 }
 //#endregion
-export { readCondFmt12Group };
+export { readCfTextFilterRule, readCondFmt12Group };

package/dist/workbook/conditional-format-ex.cjs

@@ -0,0 +1,53 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_biff_records = require("../biff/records.cjs");
+const require_biff_cursor = require("../biff/cursor.cjs");
+const require_workbook_conditional_format = require("./conditional-format.cjs");
+const require_workbook_conditional_format_12 = require("./conditional-format-12.cjs");
+//#region src/workbook/conditional-format-ex.ts
+function readCfEx(record, targetsByNID, formulaSheets) {
+	try {
+		const cursor = new require_biff_cursor.BlockCursor(record.blocks);
+		cursor.skip(12);
+		const fIsCF12 = cursor.u32();
+		const nID = cursor.u16();
+		if (fIsCF12 !== 0) return;
+		const target = targetsByNID.get(nID);
+		if (target === void 0) return;
+		const icf = cursor.u16();
+		cursor.skip(1);
+		const icfTemplate = cursor.u8();
+		const priority = cursor.u16();
+		const flags = cursor.u8();
+		const active = (flags & 1) !== 0;
+		const stopIfTrue = (flags >>> 1 & 1) !== 0;
+		const fHasDxf = cursor.u8();
+		let dxfBytes = /* @__PURE__ */ new Uint8Array(0);
+		if (fHasDxf !== 0) {
+			const cbDxf = cursor.u32();
+			dxfBytes = cursor.take(cbDxf);
+		}
+		cursor.skip(1);
+		const templateParams = cursor.take(16);
+		if (!active) return;
+		const cf = target.cfs[icf];
+		if (cf === void 0) return;
+		const textRule = require_workbook_conditional_format_12.readCfTextFilterRule(icfTemplate, templateParams, cf.rgce1, formulaSheets);
+		if (textRule === void 0) return;
+		const common = {
+			priority,
+			stopIfTrue,
+			ranges: target.ranges
+		};
+		const style = require_workbook_conditional_format.parseDxfStyle(dxfBytes);
+		return {
+			...textRule,
+			...common,
+			style
+		};
+	} catch (err) {
+		if (!(err instanceof require_biff_records.BiffFormatError)) throw err;
+		return;
+	}
+}
+//#endregion
+exports.readCfEx = readCfEx;

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

@@ -0,0 +1,13 @@
+import { r as FormulaSheetContext } from "../ptg-75v7MhaA.cjs";
+import { t as RecordGroup } from "../substreams-XDNgDvRJ.cjs";
+import { n as RawCfOperand } from "../conditional-format-Cth_afMy.cjs";
+import { a as RawConditionalFormat12 } from "../conditional-format-12-D65-ruTq.cjs";
+import { ContentSheetRange } from "document-schema.js";
+//#region src/workbook/conditional-format-ex.d.ts
+interface CfExTarget {
+  readonly ranges: ContentSheetRange[];
+  readonly cfs: readonly (RawCfOperand | undefined)[];
+}
+declare function readCfEx(record: RecordGroup, targetsByNID: ReadonlyMap<number, CfExTarget>, formulaSheets: FormulaSheetContext): RawConditionalFormat12 | undefined;
+//#endregion
+export { CfExTarget, readCfEx };

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

@@ -0,0 +1,13 @@
+import { r as FormulaSheetContext } from "../ptg-75v7MhaA.js";
+import { t as RecordGroup } from "../substreams-CgTHx5kX.js";
+import { n as RawCfOperand } from "../conditional-format-BRMUTRP1.js";
+import { a as RawConditionalFormat12 } from "../conditional-format-12-C3nwy1f8.js";
+import { ContentSheetRange } from "document-schema.js";
+//#region src/workbook/conditional-format-ex.d.ts
+interface CfExTarget {
+  readonly ranges: ContentSheetRange[];
+  readonly cfs: readonly (RawCfOperand | undefined)[];
+}
+declare function readCfEx(record: RecordGroup, targetsByNID: ReadonlyMap<number, CfExTarget>, formulaSheets: FormulaSheetContext): RawConditionalFormat12 | undefined;
+//#endregion
+export { CfExTarget, readCfEx };

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

@@ -0,0 +1,52 @@
+import { BiffFormatError } from "../biff/records.js";
+import { BlockCursor } from "../biff/cursor.js";
+import { parseDxfStyle } from "./conditional-format.js";
+import { readCfTextFilterRule } from "./conditional-format-12.js";
+//#region src/workbook/conditional-format-ex.ts
+function readCfEx(record, targetsByNID, formulaSheets) {
+	try {
+		const cursor = new BlockCursor(record.blocks);
+		cursor.skip(12);
+		const fIsCF12 = cursor.u32();
+		const nID = cursor.u16();
+		if (fIsCF12 !== 0) return;
+		const target = targetsByNID.get(nID);
+		if (target === void 0) return;
+		const icf = cursor.u16();
+		cursor.skip(1);
+		const icfTemplate = cursor.u8();
+		const priority = cursor.u16();
+		const flags = cursor.u8();
+		const active = (flags & 1) !== 0;
+		const stopIfTrue = (flags >>> 1 & 1) !== 0;
+		const fHasDxf = cursor.u8();
+		let dxfBytes = /* @__PURE__ */ new Uint8Array(0);
+		if (fHasDxf !== 0) {
+			const cbDxf = cursor.u32();
+			dxfBytes = cursor.take(cbDxf);
+		}
+		cursor.skip(1);
+		const templateParams = cursor.take(16);
+		if (!active) return;
+		const cf = target.cfs[icf];
+		if (cf === void 0) return;
+		const textRule = readCfTextFilterRule(icfTemplate, templateParams, cf.rgce1, formulaSheets);
+		if (textRule === void 0) return;
+		const common = {
+			priority,
+			stopIfTrue,
+			ranges: target.ranges
+		};
+		const style = parseDxfStyle(dxfBytes);
+		return {
+			...textRule,
+			...common,
+			style
+		};
+	} catch (err) {
+		if (!(err instanceof BiffFormatError)) throw err;
+		return;
+	}
+}
+//#endregion
+export { readCfEx };

package/dist/workbook/conditional-format.cjs

@@ -61,27 +61,42 @@ function parseDxfStyle(dxfBytes) {
 		return;
 	}
 }
-function readCf(record, ranges, formulaSheets) {
+/** The shared byte-layout parse both readCf and conditional-format.ts's own readCondFmtGroup need: ct/cp/cce1/cce2, the dxf trailer's own bytes (its length inferred from the record's total size the same way this file always has, since [MS-XLS] never states it directly), and the two formula operands. Returns undefined for a truncated/malformed record rather than throwing, so a caller can fold this into its own try/catch or call it standalone. */
+function parseCfBytes(record) {
 	try {
 		const cursor = new require_biff_cursor.BlockCursor(record.blocks);
 		const ct = cursor.u8();
 		const cp = cursor.u8();
 		const cce1 = cursor.u16();
 		const cce2 = cursor.u16();
-		if (ct === 2) return;
-		const operator = CP_TO_OPERATOR.get(cp);
-		if (operator === void 0) return;
 		const dxfLength = require_biff_substreams.recordByteLength(record) - 6 - cce1 - cce2;
-		const dxfBytes = cursor.take(dxfLength);
-		const rgce1 = cursor.take(cce1);
-		const rgce2 = cursor.take(cce2);
-		if (cce1 === 0) return;
+		return {
+			ct,
+			cp,
+			dxfBytes: cursor.take(dxfLength),
+			rgce1: cursor.take(cce1),
+			rgce2: cursor.take(cce2)
+		};
+	} catch (err) {
+		if (!(err instanceof require_biff_records.BiffFormatError)) throw err;
+		return;
+	}
+}
+function readCf(record, ranges, formulaSheets) {
+	const parsed = parseCfBytes(record);
+	if (parsed === void 0) return;
+	const { ct, cp, dxfBytes, rgce1, rgce2 } = parsed;
+	if (ct === 2) return;
+	const operator = CP_TO_OPERATOR.get(cp);
+	if (operator === void 0) return;
+	if (rgce1.length === 0) return;
+	try {
 		const formula1 = require_biff_ptg.parseFormulaText(rgce1, formulaSheets);
 		if (formula1 === void 0) return;
 		return {
 			operator,
 			formula1,
-			formula2: cce2 > 0 ? require_biff_ptg.parseFormulaText(rgce2, formulaSheets) : void 0,
+			formula2: rgce2.length > 0 ? require_biff_ptg.parseFormulaText(rgce2, formulaSheets) : void 0,
 			style: parseDxfStyle(dxfBytes),
 			ranges
 		};
@@ -90,16 +105,20 @@ function readCf(record, ranges, formulaSheets) {
 		return;
 	}
 }
+const DEGRADED_CONDFMT_GROUP = {
+	formats: [],
+	recordsConsumed: 1,
+	nID: 0,
+	ranges: [],
+	rawCfs: []
+};
 function readCondFmtGroup(records, startIndex, formulaSheets) {
 	const condFmt = records[startIndex];
-	if (condFmt === void 0) return {
-		formats: [],
-		recordsConsumed: 1
-	};
+	if (condFmt === void 0) return DEGRADED_CONDFMT_GROUP;
 	try {
 		const cursor = new require_biff_cursor.BlockCursor(condFmt.blocks);
 		const ccf = cursor.u16();
-		cursor.skip(2);
+		const nID = cursor.u16() >>> 1 & 32767;
 		cursor.skip(8);
 		const crefCount = cursor.u16();
 		const ranges = [];
@@ -116,25 +135,29 @@ function readCondFmtGroup(records, startIndex, formulaSheets) {
 			});
 		}
 		const formats = [];
+		const rawCfs = [];
 		for (let offset = 1; offset <= ccf; offset += 1) {
 			const cfRecord = records[startIndex + offset];
-			if (cfRecord?.type !== 433) return {
-				formats: [],
-				recordsConsumed: 1
-			};
+			if (cfRecord?.type !== 433) return DEGRADED_CONDFMT_GROUP;
 			const format = readCf(cfRecord, ranges, formulaSheets);
 			if (format !== void 0) formats.push(format);
+			const parsed = parseCfBytes(cfRecord);
+			rawCfs.push(parsed === void 0 ? void 0 : {
+				ct: parsed.ct,
+				cp: parsed.cp,
+				rgce1: parsed.rgce1
+			});
 		}
 		return {
 			formats,
-			recordsConsumed: 1 + ccf
+			recordsConsumed: 1 + ccf,
+			nID,
+			ranges,
+			rawCfs
 		};
 	} catch (err) {
 		if (!(err instanceof require_biff_records.BiffFormatError)) throw err;
-		return {
-			formats: [],
-			recordsConsumed: 1
-		};
+		return DEGRADED_CONDFMT_GROUP;
 	}
 }
 //#endregion

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-Czh2oTzQ.cjs";
-export { CondFmtGroupResult, RawConditionalFormat, RawConditionalFormatFill, RawConditionalFormatStyle, parseDxfStyle, readCondFmtGroup };
+import { a as RawConditionalFormatStyle, i as RawConditionalFormatFill, n as RawCfOperand, o as parseDxfStyle, r as RawConditionalFormat, s as readCondFmtGroup, t as CondFmtGroupResult } from "../conditional-format-Cth_afMy.cjs";
+export { CondFmtGroupResult, RawCfOperand, 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-DOdazxWe.js";
-export { CondFmtGroupResult, RawConditionalFormat, RawConditionalFormatFill, RawConditionalFormatStyle, parseDxfStyle, readCondFmtGroup };
+import { a as RawConditionalFormatStyle, i as RawConditionalFormatFill, n as RawCfOperand, o as parseDxfStyle, r as RawConditionalFormat, s as readCondFmtGroup, t as CondFmtGroupResult } from "../conditional-format-BRMUTRP1.js";
+export { CondFmtGroupResult, RawCfOperand, RawConditionalFormat, RawConditionalFormatFill, RawConditionalFormatStyle, parseDxfStyle, readCondFmtGroup };

package/dist/workbook/conditional-format.js

@@ -60,27 +60,42 @@ function parseDxfStyle(dxfBytes) {
 		return;
 	}
 }
-function readCf(record, ranges, formulaSheets) {
+/** The shared byte-layout parse both readCf and conditional-format.ts's own readCondFmtGroup need: ct/cp/cce1/cce2, the dxf trailer's own bytes (its length inferred from the record's total size the same way this file always has, since [MS-XLS] never states it directly), and the two formula operands. Returns undefined for a truncated/malformed record rather than throwing, so a caller can fold this into its own try/catch or call it standalone. */
+function parseCfBytes(record) {
 	try {
 		const cursor = new BlockCursor(record.blocks);
 		const ct = cursor.u8();
 		const cp = cursor.u8();
 		const cce1 = cursor.u16();
 		const cce2 = cursor.u16();
-		if (ct === 2) return;
-		const operator = CP_TO_OPERATOR.get(cp);
-		if (operator === void 0) return;
 		const dxfLength = recordByteLength(record) - 6 - cce1 - cce2;
-		const dxfBytes = cursor.take(dxfLength);
-		const rgce1 = cursor.take(cce1);
-		const rgce2 = cursor.take(cce2);
-		if (cce1 === 0) return;
+		return {
+			ct,
+			cp,
+			dxfBytes: cursor.take(dxfLength),
+			rgce1: cursor.take(cce1),
+			rgce2: cursor.take(cce2)
+		};
+	} catch (err) {
+		if (!(err instanceof BiffFormatError)) throw err;
+		return;
+	}
+}
+function readCf(record, ranges, formulaSheets) {
+	const parsed = parseCfBytes(record);
+	if (parsed === void 0) return;
+	const { ct, cp, dxfBytes, rgce1, rgce2 } = parsed;
+	if (ct === 2) return;
+	const operator = CP_TO_OPERATOR.get(cp);
+	if (operator === void 0) return;
+	if (rgce1.length === 0) return;
+	try {
 		const formula1 = parseFormulaText(rgce1, formulaSheets);
 		if (formula1 === void 0) return;
 		return {
 			operator,
 			formula1,
-			formula2: cce2 > 0 ? parseFormulaText(rgce2, formulaSheets) : void 0,
+			formula2: rgce2.length > 0 ? parseFormulaText(rgce2, formulaSheets) : void 0,
 			style: parseDxfStyle(dxfBytes),
 			ranges
 		};
@@ -89,16 +104,20 @@ function readCf(record, ranges, formulaSheets) {
 		return;
 	}
 }
+const DEGRADED_CONDFMT_GROUP = {
+	formats: [],
+	recordsConsumed: 1,
+	nID: 0,
+	ranges: [],
+	rawCfs: []
+};
 function readCondFmtGroup(records, startIndex, formulaSheets) {
 	const condFmt = records[startIndex];
-	if (condFmt === void 0) return {
-		formats: [],
-		recordsConsumed: 1
-	};
+	if (condFmt === void 0) return DEGRADED_CONDFMT_GROUP;
 	try {
 		const cursor = new BlockCursor(condFmt.blocks);
 		const ccf = cursor.u16();
-		cursor.skip(2);
+		const nID = cursor.u16() >>> 1 & 32767;
 		cursor.skip(8);
 		const crefCount = cursor.u16();
 		const ranges = [];
@@ -115,25 +134,29 @@ function readCondFmtGroup(records, startIndex, formulaSheets) {
 			});
 		}
 		const formats = [];
+		const rawCfs = [];
 		for (let offset = 1; offset <= ccf; offset += 1) {
 			const cfRecord = records[startIndex + offset];
-			if (cfRecord?.type !== 433) return {
-				formats: [],
-				recordsConsumed: 1
-			};
+			if (cfRecord?.type !== 433) return DEGRADED_CONDFMT_GROUP;
 			const format = readCf(cfRecord, ranges, formulaSheets);
 			if (format !== void 0) formats.push(format);
+			const parsed = parseCfBytes(cfRecord);
+			rawCfs.push(parsed === void 0 ? void 0 : {
+				ct: parsed.ct,
+				cp: parsed.cp,
+				rgce1: parsed.rgce1
+			});
 		}
 		return {
 			formats,
-			recordsConsumed: 1 + ccf
+			recordsConsumed: 1 + ccf,
+			nID,
+			ranges,
+			rawCfs
 		};
 	} catch (err) {
 		if (!(err instanceof BiffFormatError)) throw err;
-		return {
-			formats: [],
-			recordsConsumed: 1
-		};
+		return DEGRADED_CONDFMT_GROUP;
 	}
 }
 //#endregion

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

@@ -1,2 +1,2 @@
-import { n as readDv, t as RawDataValidation } from "../data-validation-DfpjUN-N.cjs";
+import { n as readDv, t as RawDataValidation } from "../data-validation-BgUt8CbE.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-BXvIVU0e.js";
+import { n as readDv, t as RawDataValidation } from "../data-validation-Cq6iD8lB.js";
 export { RawDataValidation, readDv };