xls-codec 4.4.0 → 4.5.0

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

@@ -0,0 +1,254 @@
+import "../biff/record-types.js";
+import { BiffFormatError } from "../biff/records.js";
+import { BlockCursor } from "../biff/cursor.js";
+import { parseFormulaText } from "../biff/ptg.js";
+//#region src/workbook/conditional-format-12.ts
+const CFVO_TYPE_TO_VALUE_TYPE = /* @__PURE__ */ new Map([
+	[1, "num"],
+	[2, "min"],
+	[3, "max"],
+	[4, "percent"],
+	[5, "percentile"],
+	[7, "formula"]
+]);
+function readCfvo(cursor, formulaSheets) {
+	const cfvoType = cursor.u8();
+	const type = CFVO_TYPE_TO_VALUE_TYPE.get(cfvoType);
+	const cce = cursor.u16();
+	const rgce = cursor.take(cce);
+	const hasFormula = cce > 0;
+	const numValue = !hasFormula && type !== "min" && type !== "max" ? cursor.f64() : void 0;
+	if (type === void 0) return;
+	if (type === "min" || type === "max") return { type };
+	const value = hasFormula ? parseFormulaText(rgce, formulaSheets) : numValue?.toString() ?? void 0;
+	if (value === void 0) return;
+	return {
+		type,
+		value
+	};
+}
+const XCLR_INDEXED = 1;
+const XCLR_RGB = 2;
+function readCfColor(cursor) {
+	const xclrType = cursor.u32();
+	if (xclrType === XCLR_INDEXED) return {
+		kind: "icv",
+		icv: cursor.u32(),
+		tint: cursor.f64()
+	};
+	if (xclrType === XCLR_RGB) {
+		const red = cursor.u8();
+		const green = cursor.u8();
+		const blue = cursor.u8();
+		cursor.skip(1);
+		const tint = cursor.f64();
+		return {
+			kind: "rgb",
+			color: {
+				r: red / 255,
+				g: green / 255,
+				b: blue / 255
+			},
+			tint
+		};
+	}
+	cursor.skip(12);
+}
+function readCfGradient(cursor, formulaSheets) {
+	cursor.skip(2);
+	cursor.skip(1);
+	const cInterpCurve = cursor.u8();
+	const cGradientCurve = cursor.u8();
+	cursor.skip(1);
+	if (cInterpCurve !== cGradientCurve || cInterpCurve < 2 || cInterpCurve > 3) return;
+	const values = [];
+	for (let index = 0; index < cInterpCurve; index += 1) {
+		const value = readCfvo(cursor, formulaSheets);
+		cursor.f64();
+		if (value === void 0) return;
+		values.push(value);
+	}
+	const colors = [];
+	for (let index = 0; index < cGradientCurve; index += 1) {
+		cursor.f64();
+		const color = readCfColor(cursor);
+		if (color === void 0) return;
+		colors.push(color);
+	}
+	const stops = [];
+	for (let index = 0; index < values.length; index += 1) {
+		const value = values[index];
+		const color = colors[index];
+		if (value === void 0 || color === void 0) return;
+		stops.push({
+			value,
+			color
+		});
+	}
+	return stops;
+}
+function readCfDatabar(cursor, formulaSheets) {
+	cursor.skip(2);
+	cursor.skip(1);
+	const showValue = (cursor.u8() >>> 1 & 1) !== 0;
+	cursor.skip(1);
+	cursor.skip(1);
+	const color = readCfColor(cursor);
+	const min = readCfvo(cursor, formulaSheets);
+	const max = readCfvo(cursor, formulaSheets);
+	if (color === void 0 || min === void 0 || max === void 0) return;
+	return {
+		min,
+		max,
+		color,
+		showValue
+	};
+}
+const ICON_SET_TYPE_NAMES = [
+	"3Arrows",
+	"3ArrowsGray",
+	"3Flags",
+	"3TrafficLights1",
+	"3TrafficLights2",
+	"3Signs",
+	"3Symbols",
+	"3Symbols2",
+	"4Arrows",
+	"4ArrowsGray",
+	"4RedToBlack",
+	"4Rating",
+	"4TrafficLights",
+	"5Arrows",
+	"5ArrowsGray",
+	"5Rating",
+	"5Quarters"
+];
+function readCfMultistate(cursor, formulaSheets) {
+	cursor.skip(2);
+	cursor.skip(1);
+	const cStates = cursor.u8();
+	const iIconSet = cursor.u8();
+	const flags = cursor.u8();
+	const showValue = (flags & 1) === 0;
+	const reverse = (flags >>> 2 & 1) !== 0;
+	const iconSetType = ICON_SET_TYPE_NAMES[iIconSet];
+	if (iconSetType === void 0) return;
+	const thresholds = [];
+	for (let index = 0; index < cStates; index += 1) {
+		const value = readCfvo(cursor, formulaSheets);
+		cursor.skip(1);
+		cursor.skip(4);
+		if (value === void 0) return;
+		thresholds.push(value);
+	}
+	return {
+		iconSetType,
+		thresholds,
+		reverse,
+		showValue
+	};
+}
+function readCf12(record, ranges, formulaSheets) {
+	try {
+		const cursor = new BlockCursor(record.blocks);
+		cursor.skip(12);
+		const ct = cursor.u8();
+		cursor.skip(1);
+		const cce1 = cursor.u16();
+		const cce2 = cursor.u16();
+		const cbDxf = cursor.u32();
+		cursor.skip(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);
+		cursor.skip(1);
+		cursor.skip(16);
+		const common = {
+			priority,
+			stopIfTrue,
+			ranges
+		};
+		if (ct === 3) {
+			const stops = readCfGradient(cursor, formulaSheets);
+			return stops === void 0 ? void 0 : {
+				kind: "colorScale",
+				stops,
+				...common
+			};
+		}
+		if (ct === 4) {
+			const databar = readCfDatabar(cursor, formulaSheets);
+			return databar === void 0 ? void 0 : {
+				kind: "dataBar",
+				...databar,
+				...common
+			};
+		}
+		if (ct === 6) {
+			const iconSet = readCfMultistate(cursor, formulaSheets);
+			return iconSet === void 0 ? void 0 : {
+				kind: "iconSet",
+				...iconSet,
+				...common
+			};
+		}
+		return;
+	} catch (err) {
+		if (!(err instanceof BiffFormatError)) throw err;
+		return;
+	}
+}
+function readCondFmt12Group(records, startIndex, formulaSheets) {
+	const condFmt12 = records[startIndex];
+	if (condFmt12 === void 0) return {
+		formats: [],
+		recordsConsumed: 1
+	};
+	try {
+		const cursor = new BlockCursor(condFmt12.blocks);
+		cursor.skip(12);
+		const ccf = cursor.u16();
+		cursor.skip(2);
+		cursor.skip(8);
+		const crefCount = cursor.u16();
+		const ranges = [];
+		for (let index = 0; index < crefCount; index += 1) {
+			const startRow = cursor.u16();
+			const endRow = cursor.u16();
+			const startColumn = cursor.u16();
+			const endColumn = cursor.u16();
+			ranges.push({
+				startRow,
+				startColumn,
+				endRow,
+				endColumn
+			});
+		}
+		const formats = [];
+		for (let offset = 1; offset <= ccf; offset += 1) {
+			const cf12Record = records[startIndex + offset];
+			if (cf12Record?.type !== 2170) return {
+				formats: [],
+				recordsConsumed: 1
+			};
+			const format = readCf12(cf12Record, ranges, formulaSheets);
+			if (format !== void 0) formats.push(format);
+		}
+		return {
+			formats,
+			recordsConsumed: 1 + ccf
+		};
+	} catch (err) {
+		if (!(err instanceof BiffFormatError)) throw err;
+		return {
+			formats: [],
+			recordsConsumed: 1
+		};
+	}
+}
+//#endregion
+export { readCondFmt12Group };

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

@@ -1,4 +1,4 @@
-import { E as XfDecorationFields } from "../xf-colors-BB5MKq6R.cjs";
+import { E as XfDecorationFields } from "../xf-colors-mqerVt2O.cjs";
 import { t as PrintNamePlanEntry } from "../print-names-DyYloloV.cjs";
 import { Alignment, Color } from "document-schema.js";
 //#region src/workbook/globals-writer.d.ts

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

@@ -1,4 +1,4 @@
-import { E as XfDecorationFields } from "../xf-colors--5oxSeI1.js";
+import { E as XfDecorationFields } from "../xf-colors-d3OvRw76.js";
 import { t as PrintNamePlanEntry } from "../print-names-C-PQ2vAy.js";
 import { Alignment, Color } from "document-schema.js";
 //#region src/workbook/globals-writer.d.ts

package/dist/workbook/globals.d.cts

@@ -1,6 +1,6 @@
 import { a as SheetRange, t as ExternalSheetLabel } from "../ptg-CCBbJLZJ.cjs";
 import { t as RecordGroup } from "../substreams-Cpy5Fi3d.cjs";
-import { E as XfDecorationFields, w as XfAlignmentFields } from "../xf-colors-BB5MKq6R.cjs";
+import { E as XfDecorationFields, w as XfAlignmentFields } from "../xf-colors-mqerVt2O.cjs";
 import { n as SheetPrintNames } from "../print-names-DyYloloV.cjs";
 import { Color } from "document-schema.js";
 //#region src/workbook/globals.d.ts

package/dist/workbook/globals.d.ts

@@ -1,6 +1,6 @@
 import { a as SheetRange, t as ExternalSheetLabel } from "../ptg-CCBbJLZJ.js";
 import { t as RecordGroup } from "../substreams-CmyZMtuM.js";
-import { E as XfDecorationFields, w as XfAlignmentFields } from "../xf-colors--5oxSeI1.js";
+import { E as XfDecorationFields, w as XfAlignmentFields } from "../xf-colors-d3OvRw76.js";
 import { n as SheetPrintNames } from "../print-names-C-PQ2vAy.js";
 import { Color } from "document-schema.js";
 //#region src/workbook/globals.d.ts

package/dist/workbook/sheet.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-require("../biff/record-types.cjs");
+const require_biff_record_types = require("../biff/record-types.cjs");
 const require_biff_records = require("../biff/records.cjs");
 const require_units = require("../units.cjs");
 const require_biff_print_setup = require("../biff/print-setup.cjs");
@@ -10,6 +10,7 @@ const require_biff_errors = require("../biff/errors.cjs");
 const require_biff_ptg = require("../biff/ptg.cjs");
 const require_biff_rk = require("../biff/rk.cjs");
 const require_workbook_conditional_format = require("./conditional-format.cjs");
+const require_workbook_conditional_format_12 = require("./conditional-format-12.cjs");
 const require_workbook_data_validation = require("./data-validation.cjs");
 //#region src/workbook/sheet.ts
 /** Row record flag bits, in the 32-bit field following unused1 ([MS-XLS] 2.4.221). */
@@ -114,6 +115,7 @@ function readSheetRecords(records, sharedStrings, formulaSheets = EMPTY_FORMULA_
 	const merges = [];
 	const dataValidations = [];
 	const conditionalFormats = [];
+	const conditionalFormats12 = [];
 	let usedRange;
 	const marginsPt = {};
 	const rowBreaks = [];
@@ -149,6 +151,12 @@ function readSheetRecords(records, sharedStrings, formulaSheets = EMPTY_FORMULA_
 				index += group.recordsConsumed - 1;
 				break;
 			}
+			case require_biff_record_types.RECORD_CONDFMT12: {
+				const group = require_workbook_conditional_format_12.readCondFmt12Group(records, index, formulaSheets);
+				conditionalFormats12.push(...group.formats);
+				index += group.recordsConsumed - 1;
+				break;
+			}
 			case 513:
 				cells.push(readBlank(record));
 				break;
@@ -224,6 +232,7 @@ function readSheetRecords(records, sharedStrings, formulaSheets = EMPTY_FORMULA_
 		merges,
 		dataValidations,
 		conditionalFormats,
+		conditionalFormats12,
 		print
 	} : {
 		cells,
@@ -232,6 +241,7 @@ function readSheetRecords(records, sharedStrings, formulaSheets = EMPTY_FORMULA_
 		merges,
 		dataValidations,
 		conditionalFormats,
+		conditionalFormats12,
 		usedRange,
 		print
 	};

package/dist/workbook/sheet.d.cts

@@ -2,6 +2,7 @@ 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 { 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. */
@@ -85,6 +86,7 @@ interface RawSheet {
   readonly merges: readonly RawRange[];
   readonly dataValidations: readonly RawDataValidation[];
   readonly conditionalFormats: readonly RawConditionalFormat[];
+  readonly conditionalFormats12: readonly RawConditionalFormat12[];
   /** The used range from the Dimensions record ([MS-XLS] 2.4.90), when the sheet declared one. */
   readonly usedRange?: RawRange;
   /** The sheet's own page setup, as far as its records state it. */

package/dist/workbook/sheet.d.ts

@@ -2,6 +2,7 @@ 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 { 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. */
@@ -85,6 +86,7 @@ interface RawSheet {
   readonly merges: readonly RawRange[];
   readonly dataValidations: readonly RawDataValidation[];
   readonly conditionalFormats: readonly RawConditionalFormat[];
+  readonly conditionalFormats12: readonly RawConditionalFormat12[];
   /** The used range from the Dimensions record ([MS-XLS] 2.4.90), when the sheet declared one. */
   readonly usedRange?: RawRange;
   /** The sheet's own page setup, as far as its records state it. */

package/dist/workbook/sheet.js

@@ -1,4 +1,4 @@
-import "../biff/record-types.js";
+import { RECORD_CONDFMT12 } from "../biff/record-types.js";
 import { BiffFormatError } from "../biff/records.js";
 import { columnWidthToPoints, inchesToPoints, twipsToPoints } from "../units.js";
 import { unpackSetupFlags } from "../biff/print-setup.js";
@@ -9,6 +9,7 @@ import { errorTextOf } from "../biff/errors.js";
 import { parseFormulaText, readPtgExpBase } from "../biff/ptg.js";
 import { decodeRkNumber } from "../biff/rk.js";
 import { readCondFmtGroup } from "./conditional-format.js";
+import { readCondFmt12Group } from "./conditional-format-12.js";
 import { readDv } from "./data-validation.js";
 //#region src/workbook/sheet.ts
 /** Row record flag bits, in the 32-bit field following unused1 ([MS-XLS] 2.4.221). */
@@ -113,6 +114,7 @@ function readSheetRecords(records, sharedStrings, formulaSheets = EMPTY_FORMULA_
 	const merges = [];
 	const dataValidations = [];
 	const conditionalFormats = [];
+	const conditionalFormats12 = [];
 	let usedRange;
 	const marginsPt = {};
 	const rowBreaks = [];
@@ -148,6 +150,12 @@ function readSheetRecords(records, sharedStrings, formulaSheets = EMPTY_FORMULA_
 				index += group.recordsConsumed - 1;
 				break;
 			}
+			case RECORD_CONDFMT12: {
+				const group = readCondFmt12Group(records, index, formulaSheets);
+				conditionalFormats12.push(...group.formats);
+				index += group.recordsConsumed - 1;
+				break;
+			}
 			case 513:
 				cells.push(readBlank(record));
 				break;
@@ -223,6 +231,7 @@ function readSheetRecords(records, sharedStrings, formulaSheets = EMPTY_FORMULA_
 		merges,
 		dataValidations,
 		conditionalFormats,
+		conditionalFormats12,
 		print
 	} : {
 		cells,
@@ -231,6 +240,7 @@ function readSheetRecords(records, sharedStrings, formulaSheets = EMPTY_FORMULA_
 		merges,
 		dataValidations,
 		conditionalFormats,
+		conditionalFormats12,
 		usedRange,
 		print
 	};

package/dist/{xf-colors--5oxSeI1.d.ts → xf-colors-d3OvRw76.d.ts}

@@ -49,6 +49,12 @@ declare const DEFAULT_PALETTE_HEX_TO_ICV: ReadonlyMap<string, number>;
  * `palette`, when given, is the workbook's own Palette record contents (56 entries, icv 8 first); when undefined, icv 8-63 resolve through the fixed default table instead -- [MS-XLS] "Icv"'s own documented fallback for a file carrying no Palette record.
  */
 declare function resolveIcvColor(icv: number, palette: readonly Color[] | undefined): Color | undefined;
+/**
+ * Applies Excel's own "TintAndShade" colour model to an already-resolved colour: a single -1.0..1.0 value shading a colour toward black (negative) or tinting it toward white (positive), the model CFColor's own numTint field ([MS-XLS] 2.4, https://learn.microsoft.com/en-us/openspecs/office_file_formats/ms-xls/fd8e679d-069f-486b-ab48-2382cc167305) carries -- distinct from DrawingML's own separate shade/tint elements (ooxml.js's typed/shared/color.ts), which apply in linear light rather than adjusting HSL lightness directly.
+ *
+ * The formula itself -- Lum' = Lum*(1+tint) for a negative tint, Lum' = Lum*(1-tint) + tint for a positive one -- is Microsoft's own documented Color.TintAndShade algorithm, cross-checked against Apache POI's XSSFColor#getTint/#setTint javadoc (a completely independent implementation carrying the identical formula) rather than trusted from memory alone.
+ */
+declare function applyTint(color: Color, tint: number): Color;
 /** One border edge's own raw fields, as the CellXF/StyleXF trailing payload packs them: a BorderStyle line-style token and a 7-bit icv colour index. */
 interface XfBorderEdge {
   readonly style: number;
@@ -95,4 +101,4 @@ declare function readLongRgbColor(cursor: BlockCursor): Color;
 /** The inverse of readLongRgbColor: a colour's own red/green/blue/reserved bytes, rounded to the nearest byte (the same rounding colorToRgbHex applies) -- exact for any colour this package itself constructed via rgbHexToColor, which is what write.ts's own palette-colour interning does. */
 declare function longRgbBytesOf(color: Color): readonly [number, number, number, number];
 //#endregion
-export { packXfDecorationWords as A, UNDECORATED_XF_FIELDS as C, borderStyleTokenFor as D, XfDecorationFields as E, resolveIcvColor as F, resolveVerticalAlignment as I, unpackXfAlignment as L, resolveBorderEdge as M, resolveFillBackground as N, horizAlignTokenFor as O, resolveHorizontalAlignment as P, unpackXfDecoration as R, PATTERN_TYPE_TO_FILL_PATTERN as S, XfBorderEdge as T, FILL_PATTERN_SOLID as _, BORDER_STYLE_DOUBLE as a, PALETTE_BASE_ICV as b, BORDER_STYLE_MEDIUM_DASHDOT as c, BORDER_STYLE_NONE as d, BORDER_STYLE_SLANT_DASHDOT as f, FILL_PATTERN_NONE as g, DEFAULT_PALETTE_HEX_TO_ICV as h, BORDER_STYLE_DOTTED as i, readLongRgbColor as j, longRgbBytesOf as k, BORDER_STYLE_MEDIUM_DASHDOTDOT as l, BORDER_STYLE_THIN as m, BORDER_STYLE_DASHDOTDOT as n, BORDER_STYLE_HAIR as o, BORDER_STYLE_THICK as p, BORDER_STYLE_DASHED as r, BORDER_STYLE_MEDIUM as s, BORDER_STYLE_DASHDOT as t, BORDER_STYLE_MEDIUM_DASHED as u, ICV_AUTOMATIC_BACKGROUND as v, XfAlignmentFields as w, PALETTE_ENTRY_COUNT as x, ICV_AUTOMATIC_FOREGROUND as y, vertAlignTokenFor as z };
+export { longRgbBytesOf as A, vertAlignTokenFor as B, UNDECORATED_XF_FIELDS as C, applyTint as D, XfDecorationFields as E, resolveHorizontalAlignment as F, resolveIcvColor as I, resolveVerticalAlignment as L, readLongRgbColor as M, resolveBorderEdge as N, borderStyleTokenFor as O, resolveFillBackground as P, unpackXfAlignment as R, PATTERN_TYPE_TO_FILL_PATTERN as S, XfBorderEdge as T, FILL_PATTERN_SOLID as _, BORDER_STYLE_DOUBLE as a, PALETTE_BASE_ICV as b, BORDER_STYLE_MEDIUM_DASHDOT as c, BORDER_STYLE_NONE as d, BORDER_STYLE_SLANT_DASHDOT as f, FILL_PATTERN_NONE as g, DEFAULT_PALETTE_HEX_TO_ICV as h, BORDER_STYLE_DOTTED as i, packXfDecorationWords as j, horizAlignTokenFor as k, BORDER_STYLE_MEDIUM_DASHDOTDOT as l, BORDER_STYLE_THIN as m, BORDER_STYLE_DASHDOTDOT as n, BORDER_STYLE_HAIR as o, BORDER_STYLE_THICK as p, BORDER_STYLE_DASHED as r, BORDER_STYLE_MEDIUM as s, BORDER_STYLE_DASHDOT as t, BORDER_STYLE_MEDIUM_DASHED as u, ICV_AUTOMATIC_BACKGROUND as v, XfAlignmentFields as w, PALETTE_ENTRY_COUNT as x, ICV_AUTOMATIC_FOREGROUND as y, unpackXfDecoration as z };

package/dist/{xf-colors-BB5MKq6R.d.cts → xf-colors-mqerVt2O.d.cts}

@@ -49,6 +49,12 @@ declare const DEFAULT_PALETTE_HEX_TO_ICV: ReadonlyMap<string, number>;
  * `palette`, when given, is the workbook's own Palette record contents (56 entries, icv 8 first); when undefined, icv 8-63 resolve through the fixed default table instead -- [MS-XLS] "Icv"'s own documented fallback for a file carrying no Palette record.
  */
 declare function resolveIcvColor(icv: number, palette: readonly Color[] | undefined): Color | undefined;
+/**
+ * Applies Excel's own "TintAndShade" colour model to an already-resolved colour: a single -1.0..1.0 value shading a colour toward black (negative) or tinting it toward white (positive), the model CFColor's own numTint field ([MS-XLS] 2.4, https://learn.microsoft.com/en-us/openspecs/office_file_formats/ms-xls/fd8e679d-069f-486b-ab48-2382cc167305) carries -- distinct from DrawingML's own separate shade/tint elements (ooxml.js's typed/shared/color.ts), which apply in linear light rather than adjusting HSL lightness directly.
+ *
+ * The formula itself -- Lum' = Lum*(1+tint) for a negative tint, Lum' = Lum*(1-tint) + tint for a positive one -- is Microsoft's own documented Color.TintAndShade algorithm, cross-checked against Apache POI's XSSFColor#getTint/#setTint javadoc (a completely independent implementation carrying the identical formula) rather than trusted from memory alone.
+ */
+declare function applyTint(color: Color, tint: number): Color;
 /** One border edge's own raw fields, as the CellXF/StyleXF trailing payload packs them: a BorderStyle line-style token and a 7-bit icv colour index. */
 interface XfBorderEdge {
   readonly style: number;
@@ -95,4 +101,4 @@ declare function readLongRgbColor(cursor: BlockCursor): Color;
 /** The inverse of readLongRgbColor: a colour's own red/green/blue/reserved bytes, rounded to the nearest byte (the same rounding colorToRgbHex applies) -- exact for any colour this package itself constructed via rgbHexToColor, which is what write.ts's own palette-colour interning does. */
 declare function longRgbBytesOf(color: Color): readonly [number, number, number, number];
 //#endregion
-export { packXfDecorationWords as A, UNDECORATED_XF_FIELDS as C, borderStyleTokenFor as D, XfDecorationFields as E, resolveIcvColor as F, resolveVerticalAlignment as I, unpackXfAlignment as L, resolveBorderEdge as M, resolveFillBackground as N, horizAlignTokenFor as O, resolveHorizontalAlignment as P, unpackXfDecoration as R, PATTERN_TYPE_TO_FILL_PATTERN as S, XfBorderEdge as T, FILL_PATTERN_SOLID as _, BORDER_STYLE_DOUBLE as a, PALETTE_BASE_ICV as b, BORDER_STYLE_MEDIUM_DASHDOT as c, BORDER_STYLE_NONE as d, BORDER_STYLE_SLANT_DASHDOT as f, FILL_PATTERN_NONE as g, DEFAULT_PALETTE_HEX_TO_ICV as h, BORDER_STYLE_DOTTED as i, readLongRgbColor as j, longRgbBytesOf as k, BORDER_STYLE_MEDIUM_DASHDOTDOT as l, BORDER_STYLE_THIN as m, BORDER_STYLE_DASHDOTDOT as n, BORDER_STYLE_HAIR as o, BORDER_STYLE_THICK as p, BORDER_STYLE_DASHED as r, BORDER_STYLE_MEDIUM as s, BORDER_STYLE_DASHDOT as t, BORDER_STYLE_MEDIUM_DASHED as u, ICV_AUTOMATIC_BACKGROUND as v, XfAlignmentFields as w, PALETTE_ENTRY_COUNT as x, ICV_AUTOMATIC_FOREGROUND as y, vertAlignTokenFor as z };
+export { longRgbBytesOf as A, vertAlignTokenFor as B, UNDECORATED_XF_FIELDS as C, applyTint as D, XfDecorationFields as E, resolveHorizontalAlignment as F, resolveIcvColor as I, resolveVerticalAlignment as L, readLongRgbColor as M, resolveBorderEdge as N, borderStyleTokenFor as O, resolveFillBackground as P, unpackXfAlignment as R, PATTERN_TYPE_TO_FILL_PATTERN as S, XfBorderEdge as T, FILL_PATTERN_SOLID as _, BORDER_STYLE_DOUBLE as a, PALETTE_BASE_ICV as b, BORDER_STYLE_MEDIUM_DASHDOT as c, BORDER_STYLE_NONE as d, BORDER_STYLE_SLANT_DASHDOT as f, FILL_PATTERN_NONE as g, DEFAULT_PALETTE_HEX_TO_ICV as h, BORDER_STYLE_DOTTED as i, packXfDecorationWords as j, horizAlignTokenFor as k, BORDER_STYLE_MEDIUM_DASHDOTDOT as l, BORDER_STYLE_THIN as m, BORDER_STYLE_DASHDOTDOT as n, BORDER_STYLE_HAIR as o, BORDER_STYLE_THICK as p, BORDER_STYLE_DASHED as r, BORDER_STYLE_MEDIUM as s, BORDER_STYLE_DASHDOT as t, BORDER_STYLE_MEDIUM_DASHED as u, ICV_AUTOMATIC_BACKGROUND as v, XfAlignmentFields as w, PALETTE_ENTRY_COUNT as x, ICV_AUTOMATIC_FOREGROUND as y, unpackXfDecoration as z };

package/package.json

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