xls-codec 4.7.6 → 4.9.0

package/dist/biff/xf-colors.d.cts

@@ -1,2 +1,2 @@
-import { A as longRgbBytesOf, B as vertAlignTokenFor, C as UNDECORATED_XF_FIELDS, D as applyTint, E as XfDecorationFields, F as resolveHorizontalAlignment, I as resolveIcvColor, L as resolveVerticalAlignment, M as readLongRgbColor, N as resolveBorderEdge, O as borderStyleTokenFor, P as resolveFillBackground, R as unpackXfAlignment, S as PATTERN_TYPE_TO_FILL_PATTERN, T as XfBorderEdge, _ as FILL_PATTERN_SOLID, a as BORDER_STYLE_DOUBLE, b as PALETTE_BASE_ICV, c as BORDER_STYLE_MEDIUM_DASHDOT, d as BORDER_STYLE_NONE, f as BORDER_STYLE_SLANT_DASHDOT, g as FILL_PATTERN_NONE, h as DEFAULT_PALETTE_HEX_TO_ICV, i as BORDER_STYLE_DOTTED, j as packXfDecorationWords, k as horizAlignTokenFor, l as BORDER_STYLE_MEDIUM_DASHDOTDOT, m as BORDER_STYLE_THIN, n as BORDER_STYLE_DASHDOTDOT, o as BORDER_STYLE_HAIR, p as BORDER_STYLE_THICK, r as BORDER_STYLE_DASHED, s as BORDER_STYLE_MEDIUM, t as BORDER_STYLE_DASHDOT, u as BORDER_STYLE_MEDIUM_DASHED, v as ICV_AUTOMATIC_BACKGROUND, w as XfAlignmentFields, x as PALETTE_ENTRY_COUNT, y as ICV_AUTOMATIC_FOREGROUND, z as unpackXfDecoration } from "../xf-colors-mqerVt2O.cjs";
+import { A as longRgbBytesOf, B as vertAlignTokenFor, C as UNDECORATED_XF_FIELDS, D as applyTint, E as XfDecorationFields, F as resolveHorizontalAlignment, I as resolveIcvColor, L as resolveVerticalAlignment, M as readLongRgbColor, N as resolveBorderEdge, O as borderStyleTokenFor, P as resolveFillBackground, R as unpackXfAlignment, S as PATTERN_TYPE_TO_FILL_PATTERN, T as XfBorderEdge, _ as FILL_PATTERN_SOLID, a as BORDER_STYLE_DOUBLE, b as PALETTE_BASE_ICV, c as BORDER_STYLE_MEDIUM_DASHDOT, d as BORDER_STYLE_NONE, f as BORDER_STYLE_SLANT_DASHDOT, g as FILL_PATTERN_NONE, h as DEFAULT_PALETTE_HEX_TO_ICV, i as BORDER_STYLE_DOTTED, j as packXfDecorationWords, k as horizAlignTokenFor, l as BORDER_STYLE_MEDIUM_DASHDOTDOT, m as BORDER_STYLE_THIN, n as BORDER_STYLE_DASHDOTDOT, o as BORDER_STYLE_HAIR, p as BORDER_STYLE_THICK, r as BORDER_STYLE_DASHED, s as BORDER_STYLE_MEDIUM, t as BORDER_STYLE_DASHDOT, u as BORDER_STYLE_MEDIUM_DASHED, v as ICV_AUTOMATIC_BACKGROUND, w as XfAlignmentFields, x as PALETTE_ENTRY_COUNT, y as ICV_AUTOMATIC_FOREGROUND, z as unpackXfDecoration } from "../xf-colors-aeH9Ax3Q.cjs";
 export { BORDER_STYLE_DASHDOT, BORDER_STYLE_DASHDOTDOT, BORDER_STYLE_DASHED, BORDER_STYLE_DOTTED, BORDER_STYLE_DOUBLE, BORDER_STYLE_HAIR, BORDER_STYLE_MEDIUM, BORDER_STYLE_MEDIUM_DASHDOT, BORDER_STYLE_MEDIUM_DASHDOTDOT, BORDER_STYLE_MEDIUM_DASHED, BORDER_STYLE_NONE, BORDER_STYLE_SLANT_DASHDOT, BORDER_STYLE_THICK, BORDER_STYLE_THIN, DEFAULT_PALETTE_HEX_TO_ICV, FILL_PATTERN_NONE, FILL_PATTERN_SOLID, ICV_AUTOMATIC_BACKGROUND, ICV_AUTOMATIC_FOREGROUND, PALETTE_BASE_ICV, PALETTE_ENTRY_COUNT, PATTERN_TYPE_TO_FILL_PATTERN, UNDECORATED_XF_FIELDS, XfAlignmentFields, XfBorderEdge, XfDecorationFields, applyTint, borderStyleTokenFor, horizAlignTokenFor, longRgbBytesOf, packXfDecorationWords, readLongRgbColor, resolveBorderEdge, resolveFillBackground, resolveHorizontalAlignment, resolveIcvColor, resolveVerticalAlignment, unpackXfAlignment, unpackXfDecoration, vertAlignTokenFor };

package/dist/biff/xf-colors.d.ts

@@ -1,2 +1,2 @@
-import { A as longRgbBytesOf, B as vertAlignTokenFor, C as UNDECORATED_XF_FIELDS, D as applyTint, E as XfDecorationFields, F as resolveHorizontalAlignment, I as resolveIcvColor, L as resolveVerticalAlignment, M as readLongRgbColor, N as resolveBorderEdge, O as borderStyleTokenFor, P as resolveFillBackground, R as unpackXfAlignment, S as PATTERN_TYPE_TO_FILL_PATTERN, T as XfBorderEdge, _ as FILL_PATTERN_SOLID, a as BORDER_STYLE_DOUBLE, b as PALETTE_BASE_ICV, c as BORDER_STYLE_MEDIUM_DASHDOT, d as BORDER_STYLE_NONE, f as BORDER_STYLE_SLANT_DASHDOT, g as FILL_PATTERN_NONE, h as DEFAULT_PALETTE_HEX_TO_ICV, i as BORDER_STYLE_DOTTED, j as packXfDecorationWords, k as horizAlignTokenFor, l as BORDER_STYLE_MEDIUM_DASHDOTDOT, m as BORDER_STYLE_THIN, n as BORDER_STYLE_DASHDOTDOT, o as BORDER_STYLE_HAIR, p as BORDER_STYLE_THICK, r as BORDER_STYLE_DASHED, s as BORDER_STYLE_MEDIUM, t as BORDER_STYLE_DASHDOT, u as BORDER_STYLE_MEDIUM_DASHED, v as ICV_AUTOMATIC_BACKGROUND, w as XfAlignmentFields, x as PALETTE_ENTRY_COUNT, y as ICV_AUTOMATIC_FOREGROUND, z as unpackXfDecoration } from "../xf-colors-d3OvRw76.js";
+import { A as longRgbBytesOf, B as vertAlignTokenFor, C as UNDECORATED_XF_FIELDS, D as applyTint, E as XfDecorationFields, F as resolveHorizontalAlignment, I as resolveIcvColor, L as resolveVerticalAlignment, M as readLongRgbColor, N as resolveBorderEdge, O as borderStyleTokenFor, P as resolveFillBackground, R as unpackXfAlignment, S as PATTERN_TYPE_TO_FILL_PATTERN, T as XfBorderEdge, _ as FILL_PATTERN_SOLID, a as BORDER_STYLE_DOUBLE, b as PALETTE_BASE_ICV, c as BORDER_STYLE_MEDIUM_DASHDOT, d as BORDER_STYLE_NONE, f as BORDER_STYLE_SLANT_DASHDOT, g as FILL_PATTERN_NONE, h as DEFAULT_PALETTE_HEX_TO_ICV, i as BORDER_STYLE_DOTTED, j as packXfDecorationWords, k as horizAlignTokenFor, l as BORDER_STYLE_MEDIUM_DASHDOTDOT, m as BORDER_STYLE_THIN, n as BORDER_STYLE_DASHDOTDOT, o as BORDER_STYLE_HAIR, p as BORDER_STYLE_THICK, r as BORDER_STYLE_DASHED, s as BORDER_STYLE_MEDIUM, t as BORDER_STYLE_DASHDOT, u as BORDER_STYLE_MEDIUM_DASHED, v as ICV_AUTOMATIC_BACKGROUND, w as XfAlignmentFields, x as PALETTE_ENTRY_COUNT, y as ICV_AUTOMATIC_FOREGROUND, z as unpackXfDecoration } from "../xf-colors-kdNsiNYt.js";
 export { BORDER_STYLE_DASHDOT, BORDER_STYLE_DASHDOTDOT, BORDER_STYLE_DASHED, BORDER_STYLE_DOTTED, BORDER_STYLE_DOUBLE, BORDER_STYLE_HAIR, BORDER_STYLE_MEDIUM, BORDER_STYLE_MEDIUM_DASHDOT, BORDER_STYLE_MEDIUM_DASHDOTDOT, BORDER_STYLE_MEDIUM_DASHED, BORDER_STYLE_NONE, BORDER_STYLE_SLANT_DASHDOT, BORDER_STYLE_THICK, BORDER_STYLE_THIN, DEFAULT_PALETTE_HEX_TO_ICV, FILL_PATTERN_NONE, FILL_PATTERN_SOLID, ICV_AUTOMATIC_BACKGROUND, ICV_AUTOMATIC_FOREGROUND, PALETTE_BASE_ICV, PALETTE_ENTRY_COUNT, PATTERN_TYPE_TO_FILL_PATTERN, UNDECORATED_XF_FIELDS, XfAlignmentFields, XfBorderEdge, XfDecorationFields, applyTint, borderStyleTokenFor, horizAlignTokenFor, longRgbBytesOf, packXfDecorationWords, readLongRgbColor, resolveBorderEdge, resolveFillBackground, resolveHorizontalAlignment, resolveIcvColor, resolveVerticalAlignment, unpackXfAlignment, unpackXfDecoration, vertAlignTokenFor };

package/dist/biff/xf-writer.d.cts

@@ -1,4 +1,4 @@
-import { E as XfDecorationFields } from "../xf-colors-mqerVt2O.cjs";
+import { E as XfDecorationFields } from "../xf-colors-aeH9Ax3Q.cjs";
 import { Alignment, Color } from "document-schema.js";
 //#region src/biff/xf-writer.d.ts
 /** Writes one cell-format XF record (fStyle=0): ifnt/ifmt as given, ixfParent pointing at the Normal cell-style XF (index 0), a CellXF payload carrying `alignment`/`verticalAlignment`/`decoration`'s own fields -- general alignment, bottom vertical alignment, and no fill/border (the same bytes this always wrote before either existed) for whatever is omitted. Twenty bytes total ([MS-XLS] 2.4.353). */

package/dist/biff/xf-writer.d.ts

@@ -1,4 +1,4 @@
-import { E as XfDecorationFields } from "../xf-colors-d3OvRw76.js";
+import { E as XfDecorationFields } from "../xf-colors-kdNsiNYt.js";
 import { Alignment, Color } from "document-schema.js";
 //#region src/biff/xf-writer.d.ts
 /** Writes one cell-format XF record (fStyle=0): ifnt/ifmt as given, ixfParent pointing at the Normal cell-style XF (index 0), a CellXF payload carrying `alignment`/`verticalAlignment`/`decoration`'s own fields -- general alignment, bottom vertical alignment, and no fill/border (the same bytes this always wrote before either existed) for whatever is omitted. Twenty bytes total ([MS-XLS] 2.4.353). */

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

@@ -1,6 +1,6 @@
-import { r as FormulaSheetContext } from "./ptg-CCBbJLZJ.js";
-import { t as RecordGroup } from "./substreams-Dp5cZoUo.js";
-import { i as RawConditionalFormatStyle } from "./conditional-format-DOdazxWe.js";
+import { r as FormulaSheetContext } from "./ptg-75v7MhaA.js";
+import { t as RecordGroup } from "./substreams-CgTHx5kX.js";
+import { a as RawConditionalFormatStyle } from "./conditional-format-BRMUTRP1.js";
 import { Color, ContentSheetConditionalFormat, ContentSheetConditionalFormatValue, ContentSheetRange } from "document-schema.js";
 //#region src/workbook/conditional-format-12.d.ts
 type RawCfColor = {
@@ -65,7 +65,12 @@ interface RawTimePeriodFormat extends RawFilterFormatCommon {
 interface RawSimpleFilterFormat extends RawFilterFormatCommon {
   readonly kind: "containsBlanks" | "notContainsBlanks" | "containsErrors" | "notContainsErrors" | "uniqueValues" | "duplicateValues";
 }
-type RawConditionalFormat12 = RawColorScaleFormat | RawDataBarFormat | RawIconSetFormat | RawTop10Format | RawAboveAverageFormat | RawTimePeriodFormat | RawSimpleFilterFormat;
+interface RawTextFilterFormat extends RawFilterFormatCommon {
+  readonly kind: "containsText" | "notContainsText" | "beginsWith" | "endsWith";
+  readonly text: string;
+}
+type RawConditionalFormat12 = RawColorScaleFormat | RawDataBarFormat | RawIconSetFormat | RawTop10Format | RawAboveAverageFormat | RawTimePeriodFormat | RawSimpleFilterFormat | RawTextFilterFormat;
+declare function readCfTextFilterRule(icfTemplate: number, templateParams: Uint8Array<ArrayBuffer>, rgce1: Uint8Array<ArrayBuffer>, formulaSheets: FormulaSheetContext): Omit<RawTextFilterFormat, keyof RawFilterFormatCommon> | undefined;
 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. */
@@ -73,4 +78,4 @@ interface CondFmt12GroupResult {
 }
 declare function readCondFmt12Group(records: readonly RecordGroup[], startIndex: number, formulaSheets: FormulaSheetContext): CondFmt12GroupResult;
 //#endregion
-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 };
+export { RawConditionalFormat12 as a, RawIconSetFormat as c, RawTimePeriod as d, RawTimePeriodFormat as f, readCondFmt12Group as h, RawColorScaleFormat as i, RawSimpleFilterFormat as l, readCfTextFilterRule as m, RawAboveAverageFormat as n, RawConditionalFormat12Common as o, RawTop10Format as p, RawCfColor as r, RawDataBarFormat as s, CondFmt12GroupResult as t, RawTextFilterFormat as u };

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

@@ -1,6 +1,6 @@
-import { r as FormulaSheetContext } from "./ptg-CCBbJLZJ.cjs";
-import { t as RecordGroup } from "./substreams-CHv3oWmn.cjs";
-import { i as RawConditionalFormatStyle } from "./conditional-format-Czh2oTzQ.cjs";
+import { r as FormulaSheetContext } from "./ptg-75v7MhaA.cjs";
+import { t as RecordGroup } from "./substreams-XDNgDvRJ.cjs";
+import { a as RawConditionalFormatStyle } from "./conditional-format-Cth_afMy.cjs";
 import { Color, ContentSheetConditionalFormat, ContentSheetConditionalFormatValue, ContentSheetRange } from "document-schema.js";
 //#region src/workbook/conditional-format-12.d.ts
 type RawCfColor = {
@@ -65,7 +65,12 @@ interface RawTimePeriodFormat extends RawFilterFormatCommon {
 interface RawSimpleFilterFormat extends RawFilterFormatCommon {
   readonly kind: "containsBlanks" | "notContainsBlanks" | "containsErrors" | "notContainsErrors" | "uniqueValues" | "duplicateValues";
 }
-type RawConditionalFormat12 = RawColorScaleFormat | RawDataBarFormat | RawIconSetFormat | RawTop10Format | RawAboveAverageFormat | RawTimePeriodFormat | RawSimpleFilterFormat;
+interface RawTextFilterFormat extends RawFilterFormatCommon {
+  readonly kind: "containsText" | "notContainsText" | "beginsWith" | "endsWith";
+  readonly text: string;
+}
+type RawConditionalFormat12 = RawColorScaleFormat | RawDataBarFormat | RawIconSetFormat | RawTop10Format | RawAboveAverageFormat | RawTimePeriodFormat | RawSimpleFilterFormat | RawTextFilterFormat;
+declare function readCfTextFilterRule(icfTemplate: number, templateParams: Uint8Array<ArrayBuffer>, rgce1: Uint8Array<ArrayBuffer>, formulaSheets: FormulaSheetContext): Omit<RawTextFilterFormat, keyof RawFilterFormatCommon> | undefined;
 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. */
@@ -73,4 +78,4 @@ interface CondFmt12GroupResult {
 }
 declare function readCondFmt12Group(records: readonly RecordGroup[], startIndex: number, formulaSheets: FormulaSheetContext): CondFmt12GroupResult;
 //#endregion
-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 };
+export { RawConditionalFormat12 as a, RawIconSetFormat as c, RawTimePeriod as d, RawTimePeriodFormat as f, readCondFmt12Group as h, RawColorScaleFormat as i, RawSimpleFilterFormat as l, readCfTextFilterRule as m, RawAboveAverageFormat as n, RawConditionalFormat12Common as o, RawTop10Format as p, RawCfColor as r, RawDataBarFormat as s, CondFmt12GroupResult as t, RawTextFilterFormat as u };

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

@@ -0,0 +1,41 @@
+import { r as FormulaSheetContext } from "./ptg-75v7MhaA.js";
+import { t as RecordGroup } from "./substreams-CgTHx5kX.js";
+import { ContentSheetRange, SheetRuleOperator } from "document-schema.js";
+//#region src/workbook/conditional-format.d.ts
+interface RawConditionalFormatFill {
+  readonly fillPattern: number;
+  readonly fillForegroundIcv: number;
+  readonly fillBackgroundIcv: number;
+}
+interface RawConditionalFormatStyle {
+  readonly fontColorIcv: number | undefined;
+  readonly fill: RawConditionalFormatFill | undefined;
+}
+interface RawConditionalFormat {
+  readonly operator: SheetRuleOperator;
+  readonly formula1: string;
+  readonly formula2: string | undefined;
+  readonly style: RawConditionalFormatStyle | undefined;
+  readonly ranges: ContentSheetRange[];
+}
+declare function parseDxfStyle(dxfBytes: Uint8Array<ArrayBuffer>): RawConditionalFormatStyle | undefined;
+/** A CF record's own operand, in its rawest usable form -- the pieces conditional-format-ex.ts needs to resolve a CFEx that extends this specific CF (by icf, a positional index into a CondFmt's own CF children), independent of whether readCf below can promote this CF into a 'cellIs' rule at all. A ct 0x02 formula condition, exactly the kind readCf itself never promotes, is the one CFEx actually cares about (see conditional-format-ex.ts's own top comment for why). */
+interface RawCfOperand {
+  readonly ct: number;
+  readonly cp: number;
+  readonly rgce1: Uint8Array<ArrayBuffer>;
+}
+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. */
+  readonly recordsConsumed: number;
+  /** CondFmt's own nID ([MS-XLS] 2.5.56's own CondFmtStructure) -- the identifier a later CFEx record's own nID field cross-references to extend one specific CF child of this group (conditional-format-ex.ts). 0 on a malformed group, alongside an empty rawCfs -- a real CFEx can legitimately name nID 0, but never resolves anything through an empty rawCfs, so the two degraded groups can never be confused for one another by a lookup. */
+  readonly nID: number;
+  /** This group's own shared ranges, exposed independently of `formats` since a CFEx-promoted rule needs them too and a CF this reader could not promote into `formats` still shares them. */
+  readonly ranges: ContentSheetRange[];
+  /** Every one of this group's CF children, in declared (icf) order, each parsed to its raw operand or undefined for one this reader could not even parse -- CFExNonCF12's own icf field indexes into exactly this collection, regardless of which entries readCf itself went on to promote into `formats`. */
+  readonly rawCfs: readonly (RawCfOperand | undefined)[];
+}
+declare function readCondFmtGroup(records: readonly RecordGroup[], startIndex: number, formulaSheets: FormulaSheetContext): CondFmtGroupResult;
+//#endregion
+export { RawConditionalFormatStyle as a, RawConditionalFormatFill as i, RawCfOperand as n, parseDxfStyle as o, RawConditionalFormat as r, readCondFmtGroup as s, CondFmtGroupResult as t };

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

@@ -0,0 +1,41 @@
+import { r as FormulaSheetContext } from "./ptg-75v7MhaA.cjs";
+import { t as RecordGroup } from "./substreams-XDNgDvRJ.cjs";
+import { ContentSheetRange, SheetRuleOperator } from "document-schema.js";
+//#region src/workbook/conditional-format.d.ts
+interface RawConditionalFormatFill {
+  readonly fillPattern: number;
+  readonly fillForegroundIcv: number;
+  readonly fillBackgroundIcv: number;
+}
+interface RawConditionalFormatStyle {
+  readonly fontColorIcv: number | undefined;
+  readonly fill: RawConditionalFormatFill | undefined;
+}
+interface RawConditionalFormat {
+  readonly operator: SheetRuleOperator;
+  readonly formula1: string;
+  readonly formula2: string | undefined;
+  readonly style: RawConditionalFormatStyle | undefined;
+  readonly ranges: ContentSheetRange[];
+}
+declare function parseDxfStyle(dxfBytes: Uint8Array<ArrayBuffer>): RawConditionalFormatStyle | undefined;
+/** A CF record's own operand, in its rawest usable form -- the pieces conditional-format-ex.ts needs to resolve a CFEx that extends this specific CF (by icf, a positional index into a CondFmt's own CF children), independent of whether readCf below can promote this CF into a 'cellIs' rule at all. A ct 0x02 formula condition, exactly the kind readCf itself never promotes, is the one CFEx actually cares about (see conditional-format-ex.ts's own top comment for why). */
+interface RawCfOperand {
+  readonly ct: number;
+  readonly cp: number;
+  readonly rgce1: Uint8Array<ArrayBuffer>;
+}
+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. */
+  readonly recordsConsumed: number;
+  /** CondFmt's own nID ([MS-XLS] 2.5.56's own CondFmtStructure) -- the identifier a later CFEx record's own nID field cross-references to extend one specific CF child of this group (conditional-format-ex.ts). 0 on a malformed group, alongside an empty rawCfs -- a real CFEx can legitimately name nID 0, but never resolves anything through an empty rawCfs, so the two degraded groups can never be confused for one another by a lookup. */
+  readonly nID: number;
+  /** This group's own shared ranges, exposed independently of `formats` since a CFEx-promoted rule needs them too and a CF this reader could not promote into `formats` still shares them. */
+  readonly ranges: ContentSheetRange[];
+  /** Every one of this group's CF children, in declared (icf) order, each parsed to its raw operand or undefined for one this reader could not even parse -- CFExNonCF12's own icf field indexes into exactly this collection, regardless of which entries readCf itself went on to promote into `formats`. */
+  readonly rawCfs: readonly (RawCfOperand | undefined)[];
+}
+declare function readCondFmtGroup(records: readonly RecordGroup[], startIndex: number, formulaSheets: FormulaSheetContext): CondFmtGroupResult;
+//#endregion
+export { RawConditionalFormatStyle as a, RawConditionalFormatFill as i, RawCfOperand as n, parseDxfStyle as o, RawConditionalFormat as r, readCondFmtGroup as s, CondFmtGroupResult as t };

package/dist/content.cjs

@@ -6,7 +6,10 @@ const require_units = require("./units.cjs");
 const require_biff_print_setup = require("./biff/print-setup.cjs");
 const require_biff_substreams = require("./biff/substreams.cjs");
 const require_biff_xf_colors = require("./biff/xf-colors.cjs");
+const require_drawing_blips = require("./drawing/blips.cjs");
+const require_drawing_bytes = require("./drawing/bytes.cjs");
 const require_workbook_comments = require("./workbook/comments.cjs");
+const require_workbook_drawing = require("./workbook/drawing.cjs");
 const require_serial = require("./serial.cjs");
 const require_workbook_globals = require("./workbook/globals.cjs");
 const require_workbook_sheet = require("./workbook/sheet.cjs");
@@ -91,16 +94,22 @@ function readXlsContent(bytes, password) {
 	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");
 	const globals = require_workbook_globals.readWorkbookGlobals(globalsSubstream.records);
-	const sheets = globals.sheets.map((entry, sheetIndex) => ({
-		entry,
-		sheetIndex
-	})).filter(({ entry }) => entry.sheetType === SHEET_TYPE_WORKSHEET).map(({ entry, sheetIndex }) => readSheet(entry, sheetIndex, substreams, globals));
+	const blipStore = require_drawing_blips.readBlipStore(concatDrawingGroupBytes(globalsSubstream.records));
+	const documentMetadata = metadata === void 0 ? {} : (0, archive_codec.summaryInformationToLayoutMetadata)((0, archive_codec.readSummaryInformation)(metadata));
 	return {
 		kind: "spreadsheet",
-		metadata: metadata === void 0 ? {} : (0, archive_codec.summaryInformationToLayoutMetadata)((0, archive_codec.readSummaryInformation)(metadata)),
-		sheets
+		metadata: documentMetadata,
+		sheets: globals.sheets.map((entry, sheetIndex) => ({
+			entry,
+			sheetIndex
+		})).filter(({ entry }) => entry.sheetType === SHEET_TYPE_WORKSHEET).map(({ entry, sheetIndex }) => readSheet(entry, sheetIndex, substreams, globals, blipStore, documentMetadata))
 	};
 }
+/** Every MsoDrawingGroup record's own data, in stream order, concatenated into one Escher byte stream -- the workbook-wide counterpart of a worksheet's own MsoDrawing concatenation (drawing/shapes.ts's own readSheetShapes), carrying the Blip Store rather than any one sheet's shape tree. */
+function concatDrawingGroupBytes(records) {
+	const chunks = records.filter((record) => record.type === 235).map((record) => record.blocks[0]).filter((block) => block !== void 0);
+	return require_drawing_bytes.concatBytes(chunks);
+}
 /** The tree-form read: readXlsContent composed with the schema's own structural transform, exactly as ooxml.js's readXlsx wraps readXlsxContent. */
 function readXls(bytes, password) {
 	return (0, document_schema_js.assembleTree)(readXlsContent(bytes, password));
@@ -110,8 +119,17 @@ function readXls(bytes, password) {
 *
 * The substream is found by the byte offset BoundSheet8's lbPlyPos names, not by position: the order sheets appear in the workbook (which is BoundSheet8 order, and therefore the order of `globals.sheets`) is not required to match the order their substreams were written in. A sheet whose substream cannot be found still produces a ContentSheet, empty -- losing the sheet entirely would be a worse answer than losing its cells, since its name and position are real information the workbook did state.
 */
-function readSheet(entry, sheetIndex, substreams, globals) {
+function readSheet(entry, sheetIndex, substreams, globals, blipStore, documentMetadata) {
 	const substream = substreams.find((candidate) => candidate.offset === entry.bofPosition && candidate.documentType === 16);
+	const emptyPrint = {
+		marginsPt: {},
+		rowBreaks: [],
+		columnBreaks: []
+	};
+	const formulaSheets = {
+		sheets: globals.sheets,
+		sheetRanges: globals.sheetRanges
+	};
 	const raw = substream === void 0 ? {
 		cells: [],
 		rows: [],
@@ -120,29 +138,33 @@ function readSheet(entry, sheetIndex, substreams, globals) {
 		dataValidations: [],
 		conditionalFormats: [],
 		conditionalFormats12: [],
-		print: {
-			marginsPt: {},
-			rowBreaks: [],
-			columnBreaks: []
-		}
-	} : require_workbook_sheet.readSheetRecords(substream.records, globals.sharedStrings, {
-		sheets: globals.sheets,
-		sheetRanges: globals.sheetRanges
-	});
+		print: emptyPrint
+	} : require_workbook_sheet.readSheetRecords(substream.records, globals.sharedStrings, formulaSheets);
 	const comments = substream === void 0 ? /* @__PURE__ */ new Map() : require_workbook_comments.readSheetComments(substream.records);
 	const cells = mapCells(raw, globals);
 	applyCellComments(comments, cells);
 	const dataValidations = mapDataValidations(raw.dataValidations);
 	const conditionalFormats = [...mapConditionalFormats(raw.conditionalFormats, globals.palette), ...mapConditionalFormats12(raw.conditionalFormats12, globals.palette)];
+	const drawing = require_workbook_drawing.readSheetDrawing(substream?.records ?? [], {
+		blipStore,
+		columns: raw.columns,
+		rows: raw.rows,
+		ownSheetIndex: sheetIndex,
+		formulaSheets,
+		ownSheetCells: cells,
+		metadata: documentMetadata,
+		allSubstreams: substreams
+	});
 	return {
 		name: entry.name,
 		cells,
 		columns: mapColumns(raw),
 		rows: mapRows(raw),
-		images: [],
+		images: [...drawing.images],
 		printSettings: mapPrintSettings(raw.print, globals.printNames.get(sheetIndex)),
 		...dataValidations.length > 0 ? { dataValidations } : {},
-		...conditionalFormats.length > 0 ? { conditionalFormats } : {}
+		...conditionalFormats.length > 0 ? { conditionalFormats } : {},
+		...drawing.embeddedObjects.length > 0 ? { embeddedObjects: [...drawing.embeddedObjects] } : {}
 	};
 }
 function mapConditionalFormats(raw, palette) {
@@ -234,6 +256,16 @@ function mapConditionalFormats12(raw, palette) {
 			});
 			continue;
 		}
+		if (format.kind === "containsText" || format.kind === "notContainsText" || format.kind === "beginsWith" || format.kind === "endsWith") {
+			const style = mapConditionalFormatStyle(format.style, palette);
+			results.push({
+				type: format.kind,
+				text: format.text,
+				...style !== void 0 ? { style } : {},
+				...common
+			});
+			continue;
+		}
 		const style = mapConditionalFormatStyle(format.style, palette);
 		results.push({
 			type: format.kind,

package/dist/content.js

@@ -5,7 +5,10 @@ import { inchesToPoints } from "./units.js";
 import { pageSizeFromSetup } from "./biff/print-setup.js";
 import { groupRecords, splitSubstreams } from "./biff/substreams.js";
 import { applyTint, resolveBorderEdge, resolveFillBackground, resolveIcvColor } from "./biff/xf-colors.js";
+import { readBlipStore } from "./drawing/blips.js";
+import { concatBytes } from "./drawing/bytes.js";
 import { readSheetComments } from "./workbook/comments.js";
+import { readSheetDrawing } from "./workbook/drawing.js";
 import { serialToIsoDate, serialToIsoDateTime, serialToIsoTime } from "./serial.js";
 import { formatCodeOf, readWorkbookGlobals } from "./workbook/globals.js";
 import { readSheetRecords } from "./workbook/sheet.js";
@@ -90,16 +93,22 @@ function readXlsContent(bytes, password) {
 	const globalsSubstream = substreams[0];
 	if (globalsSubstream === void 0) throw new BiffFormatError("workbook stream holds no substreams, so it carries no globals substream");
 	const globals = readWorkbookGlobals(globalsSubstream.records);
-	const sheets = globals.sheets.map((entry, sheetIndex) => ({
-		entry,
-		sheetIndex
-	})).filter(({ entry }) => entry.sheetType === SHEET_TYPE_WORKSHEET).map(({ entry, sheetIndex }) => readSheet(entry, sheetIndex, substreams, globals));
+	const blipStore = readBlipStore(concatDrawingGroupBytes(globalsSubstream.records));
+	const documentMetadata = metadata === void 0 ? {} : summaryInformationToLayoutMetadata(readSummaryInformation(metadata));
 	return {
 		kind: "spreadsheet",
-		metadata: metadata === void 0 ? {} : summaryInformationToLayoutMetadata(readSummaryInformation(metadata)),
-		sheets
+		metadata: documentMetadata,
+		sheets: globals.sheets.map((entry, sheetIndex) => ({
+			entry,
+			sheetIndex
+		})).filter(({ entry }) => entry.sheetType === SHEET_TYPE_WORKSHEET).map(({ entry, sheetIndex }) => readSheet(entry, sheetIndex, substreams, globals, blipStore, documentMetadata))
 	};
 }
+/** Every MsoDrawingGroup record's own data, in stream order, concatenated into one Escher byte stream -- the workbook-wide counterpart of a worksheet's own MsoDrawing concatenation (drawing/shapes.ts's own readSheetShapes), carrying the Blip Store rather than any one sheet's shape tree. */
+function concatDrawingGroupBytes(records) {
+	const chunks = records.filter((record) => record.type === 235).map((record) => record.blocks[0]).filter((block) => block !== void 0);
+	return concatBytes(chunks);
+}
 /** The tree-form read: readXlsContent composed with the schema's own structural transform, exactly as ooxml.js's readXlsx wraps readXlsxContent. */
 function readXls(bytes, password) {
 	return assembleTree(readXlsContent(bytes, password));
@@ -109,8 +118,17 @@ function readXls(bytes, password) {
 *
 * The substream is found by the byte offset BoundSheet8's lbPlyPos names, not by position: the order sheets appear in the workbook (which is BoundSheet8 order, and therefore the order of `globals.sheets`) is not required to match the order their substreams were written in. A sheet whose substream cannot be found still produces a ContentSheet, empty -- losing the sheet entirely would be a worse answer than losing its cells, since its name and position are real information the workbook did state.
 */
-function readSheet(entry, sheetIndex, substreams, globals) {
+function readSheet(entry, sheetIndex, substreams, globals, blipStore, documentMetadata) {
 	const substream = substreams.find((candidate) => candidate.offset === entry.bofPosition && candidate.documentType === 16);
+	const emptyPrint = {
+		marginsPt: {},
+		rowBreaks: [],
+		columnBreaks: []
+	};
+	const formulaSheets = {
+		sheets: globals.sheets,
+		sheetRanges: globals.sheetRanges
+	};
 	const raw = substream === void 0 ? {
 		cells: [],
 		rows: [],
@@ -119,29 +137,33 @@ function readSheet(entry, sheetIndex, substreams, globals) {
 		dataValidations: [],
 		conditionalFormats: [],
 		conditionalFormats12: [],
-		print: {
-			marginsPt: {},
-			rowBreaks: [],
-			columnBreaks: []
-		}
-	} : readSheetRecords(substream.records, globals.sharedStrings, {
-		sheets: globals.sheets,
-		sheetRanges: globals.sheetRanges
-	});
+		print: emptyPrint
+	} : readSheetRecords(substream.records, globals.sharedStrings, formulaSheets);
 	const comments = substream === void 0 ? /* @__PURE__ */ new Map() : readSheetComments(substream.records);
 	const cells = mapCells(raw, globals);
 	applyCellComments(comments, cells);
 	const dataValidations = mapDataValidations(raw.dataValidations);
 	const conditionalFormats = [...mapConditionalFormats(raw.conditionalFormats, globals.palette), ...mapConditionalFormats12(raw.conditionalFormats12, globals.palette)];
+	const drawing = readSheetDrawing(substream?.records ?? [], {
+		blipStore,
+		columns: raw.columns,
+		rows: raw.rows,
+		ownSheetIndex: sheetIndex,
+		formulaSheets,
+		ownSheetCells: cells,
+		metadata: documentMetadata,
+		allSubstreams: substreams
+	});
 	return {
 		name: entry.name,
 		cells,
 		columns: mapColumns(raw),
 		rows: mapRows(raw),
-		images: [],
+		images: [...drawing.images],
 		printSettings: mapPrintSettings(raw.print, globals.printNames.get(sheetIndex)),
 		...dataValidations.length > 0 ? { dataValidations } : {},
-		...conditionalFormats.length > 0 ? { conditionalFormats } : {}
+		...conditionalFormats.length > 0 ? { conditionalFormats } : {},
+		...drawing.embeddedObjects.length > 0 ? { embeddedObjects: [...drawing.embeddedObjects] } : {}
 	};
 }
 function mapConditionalFormats(raw, palette) {
@@ -233,6 +255,16 @@ function mapConditionalFormats12(raw, palette) {
 			});
 			continue;
 		}
+		if (format.kind === "containsText" || format.kind === "notContainsText" || format.kind === "beginsWith" || format.kind === "endsWith") {
+			const style = mapConditionalFormatStyle(format.style, palette);
+			results.push({
+				type: format.kind,
+				text: format.text,
+				...style !== void 0 ? { style } : {},
+				...common
+			});
+			continue;
+		}
 		const style = mapConditionalFormatStyle(format.style, palette);
 		results.push({
 			type: format.kind,

package/dist/{cursor-VMtw9uVP.d.cts → cursor-CnEuX5qE.d.cts}

@@ -21,7 +21,9 @@ declare class BlockCursor {
   i16(): number;
   /** An Xnum ([MS-XLS] 2.5.342): a little-endian IEEE 754 double. */
   f64(): number;
-  /** The next `count` bytes, copied out. Spans block boundaries. */
+  /** Total unread bytes across the current block and every block after it -- what a length-prefixed field's own prefix must be checked against before that many bytes are allocated, so a record cannot claim a length far larger than the data actually behind it. */
+  private remainingTotal;
+  /** The next `count` bytes, copied out. Spans block boundaries. Rejects a `count` larger than the data actually remaining before allocating, so a length-prefixed field taken from untrusted input (e.g. CFEx's own `cbDxf`) cannot force a multi-gigabyte allocation from a tiny record. */
   take(count: number): Uint8Array<ArrayBuffer>;
   /** Advances `count` bytes without materialising them -- for a field this package reads past rather than reads. */
   skip(count: number): void;

package/dist/{cursor-VMtw9uVP.d.ts → cursor-CnEuX5qE.d.ts}

@@ -21,7 +21,9 @@ declare class BlockCursor {
   i16(): number;
   /** An Xnum ([MS-XLS] 2.5.342): a little-endian IEEE 754 double. */
   f64(): number;
-  /** The next `count` bytes, copied out. Spans block boundaries. */
+  /** Total unread bytes across the current block and every block after it -- what a length-prefixed field's own prefix must be checked against before that many bytes are allocated, so a record cannot claim a length far larger than the data actually behind it. */
+  private remainingTotal;
+  /** The next `count` bytes, copied out. Spans block boundaries. Rejects a `count` larger than the data actually remaining before allocating, so a length-prefixed field taken from untrusted input (e.g. CFEx's own `cbDxf`) cannot force a multi-gigabyte allocation from a tiny record. */
   take(count: number): Uint8Array<ArrayBuffer>;
   /** Advances `count` bytes without materialising them -- for a field this package reads past rather than reads. */
   skip(count: number): void;

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

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

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

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

package/dist/drawing/blips.cjs

@@ -0,0 +1,83 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_biff_cursor = require("../biff/cursor.cjs");
+const require_drawing_escher_constants = require("./escher-constants.cjs");
+const require_drawing_escher = require("./escher.cjs");
+//#region src/drawing/blips.ts
+const RGB_UID_SIZE = 16;
+const BLIP_TAG_SIZE = 1;
+/** [MS-ODRAW] OfficeArtFBSE's own fixed fields up to and including unused3, before the optional nameData and the nested embedded blip -- btWin32(1) + btMacOS(1) + rgbUid(16) + tag(2) + size(4) + cRef(4) + foDelay(4) + unused1(1) + cbName(1) + unused2(1) + unused3(1). */
+const BSE_FIXED_SIZE = 36;
+/** A Blip record's own recInstance, mapped to how many 16-byte rgbUid fields precede its `tag` byte and the raw file bytes -- one UID for a blip embedded once, two when [MS-ODRAW] also records a second, "printer" representation's own hash. Only PNG/JPEG instances are named: every other blip type resolves to no image at all (see readBlipImage), so its own UID count is never needed. */
+const BLIP_UID_COUNTS = /* @__PURE__ */ new Map([
+	[1760, 1],
+	[1761, 2],
+	[1130, 1],
+	[1131, 2],
+	[1762, 1],
+	[1763, 2]
+]);
+/** Reads every BSE entry the workbook's own drawing-group Escher stream declares, keyed by its 1-based position in the Blip Store array -- the same index a picture shape's `pib` property names. A BSE this reader cannot turn into a real image (no embedded blip, or a blip type document-schema.js's ContentImageBlockSchema has no lossless slot for -- DIB, EMF, WMF, PICT, TIFF) is simply absent from the map, exactly like any other unsupported construct elsewhere in this package: a picture shape whose `pib` resolves to one of these is recognised as a picture but produces no ContentSheetImage, rather than a fabricated or mistranscoded one. */
+function readBlipStore(drawingGroupBytes) {
+	const store = /* @__PURE__ */ new Map();
+	if (drawingGroupBytes.length === 0) return store;
+	const dgg = require_drawing_escher.readEscherRecords(drawingGroupBytes).find((record) => record.kind === "container" && record.recType === 61440);
+	if (dgg === void 0) return store;
+	const bstore = require_drawing_escher.childrenOfType(dgg, require_drawing_escher_constants.ESCHER_BSTORE_CONTAINER)[0];
+	if (bstore?.kind !== "container") return store;
+	require_drawing_escher.childrenOfType(bstore, require_drawing_escher_constants.ESCHER_BSE).forEach((bse, index) => {
+		if (bse.kind !== "atom") return;
+		const image = readBseImage(bse.data);
+		if (image !== void 0) store.set(index + 1, image);
+	});
+	return store;
+}
+/** One BSE atom's own body ([MS-ODRAW] OfficeArtFBSE): the fixed fields, an optional nameData string, then the nested embedded blip record -- present whenever the image is stored inline rather than only linked externally (foDelay !== 0xFFFFFFFF), which is the only case this reader can recover bytes for at all. */
+function readBseImage(data) {
+	if (data.length < BSE_FIXED_SIZE) return;
+	const cursor = new require_biff_cursor.BlockCursor([data]);
+	cursor.skip(1);
+	cursor.skip(1);
+	cursor.skip(RGB_UID_SIZE);
+	cursor.skip(2);
+	cursor.skip(4);
+	cursor.skip(4);
+	cursor.skip(4);
+	cursor.skip(1);
+	const cbName = cursor.u8();
+	cursor.skip(1);
+	cursor.skip(1);
+	const embeddedStart = BSE_FIXED_SIZE + (cbName > 0 ? cbName : 0);
+	if (embeddedStart >= data.length) return;
+	const embeddedBytes = data.subarray(embeddedStart);
+	const blip = require_drawing_escher.readEscherRecords(embeddedBytes)[0];
+	if (blip?.kind !== "atom") return;
+	return readBlipImage(blip.recType, blip.recInstance, blip.data);
+}
+/** One embedded OfficeArtBlip record's own body -- one or two 16-byte rgbUid fields, a one-byte tag, then the literal image file bytes to the end of the record. PNG and JPEG blips carry their literal file bytes verbatim ([MS-ODRAW] OfficeArtBlipPNG/OfficeArtBlipJPEG); every other recognised blip type (DIB -- an in-memory Windows DIB, not a standalone .bmp file, and carrying no BITMAPFILEHEADER of its own to become one) has no lossless target in document-schema.js's ContentImageBlockSchema (png/jpeg/svg/gif only) and resolves to undefined rather than a mistranscoded image. */
+function readBlipImage(recType, recInstance, data) {
+	const format = blipFormatOf(recType);
+	if (format === void 0) return;
+	const uidCount = BLIP_UID_COUNTS.get(recInstance);
+	if (uidCount === void 0) return;
+	const headerSize = uidCount * RGB_UID_SIZE + BLIP_TAG_SIZE;
+	if (data.length < headerSize) return;
+	return {
+		format,
+		base64: bytesToBase64(data.subarray(headerSize))
+	};
+}
+function blipFormatOf(recType) {
+	if (recType === 61470) return "png";
+	if (recType === 61469 || recType === 61482) return "jpeg";
+}
+function bytesToBase64(bytes) {
+	let binary = "";
+	const chunkSize = 32768;
+	for (let offset = 0; offset < bytes.length; offset += chunkSize) {
+		const chunk = bytes.subarray(offset, offset + chunkSize);
+		binary += String.fromCharCode(...chunk);
+	}
+	return btoa(binary);
+}
+//#endregion
+exports.readBlipStore = readBlipStore;

package/dist/drawing/blips.d.cts

@@ -0,0 +1,10 @@
+//#region src/drawing/blips.d.ts
+/** One resolved image: the bytes document-schema.js's ContentImageBlockSchema can actually carry (png/jpeg only -- see readBlipImage below), base64-encoded. */
+interface BlipImage {
+  readonly format: "png" | "jpeg";
+  readonly base64: string;
+}
+/** Reads every BSE entry the workbook's own drawing-group Escher stream declares, keyed by its 1-based position in the Blip Store array -- the same index a picture shape's `pib` property names. A BSE this reader cannot turn into a real image (no embedded blip, or a blip type document-schema.js's ContentImageBlockSchema has no lossless slot for -- DIB, EMF, WMF, PICT, TIFF) is simply absent from the map, exactly like any other unsupported construct elsewhere in this package: a picture shape whose `pib` resolves to one of these is recognised as a picture but produces no ContentSheetImage, rather than a fabricated or mistranscoded one. */
+declare function readBlipStore(drawingGroupBytes: Uint8Array<ArrayBuffer>): ReadonlyMap<number, BlipImage>;
+//#endregion
+export { BlipImage, readBlipStore };

package/dist/drawing/blips.d.ts

@@ -0,0 +1,10 @@
+//#region src/drawing/blips.d.ts
+/** One resolved image: the bytes document-schema.js's ContentImageBlockSchema can actually carry (png/jpeg only -- see readBlipImage below), base64-encoded. */
+interface BlipImage {
+  readonly format: "png" | "jpeg";
+  readonly base64: string;
+}
+/** Reads every BSE entry the workbook's own drawing-group Escher stream declares, keyed by its 1-based position in the Blip Store array -- the same index a picture shape's `pib` property names. A BSE this reader cannot turn into a real image (no embedded blip, or a blip type document-schema.js's ContentImageBlockSchema has no lossless slot for -- DIB, EMF, WMF, PICT, TIFF) is simply absent from the map, exactly like any other unsupported construct elsewhere in this package: a picture shape whose `pib` resolves to one of these is recognised as a picture but produces no ContentSheetImage, rather than a fabricated or mistranscoded one. */
+declare function readBlipStore(drawingGroupBytes: Uint8Array<ArrayBuffer>): ReadonlyMap<number, BlipImage>;
+//#endregion
+export { BlipImage, readBlipStore };