@rowsncolumns/utils 9.5.3 → 9.5.5

package/dist/cjs/color.d.ts

@@ -16,5 +16,45 @@ export declare const hexToRgb: (hex: string) => {
     b: number;
 };
 export declare const rgbToHex: (r: number, g: number, b: number) => string;
+/**
+ * Excel's colour variations for a chart palette that runs out of entries —
+ * the default chart colour style ("Colorful Palette 1", `colors1.xml`,
+ * `meth="cycle"`): the palette's entries are used as-is on the first pass,
+ * and every further pass reuses them with a luminance modification
+ * (`lumMod` scales each channel, `lumOff` adds toward white; 1 = 100%):
+ * darker, lighter, slightly darker, lighter still, … Nine passes, then the
+ * sequence repeats — 54 distinguishable shades over the six theme accents
+ * before any exact repeat. A pie with seven slices therefore gets accent 1
+ * darkened for slice 7, not accent 1 again.
+ */
+export declare const CHART_PALETTE_VARIATIONS: ReadonlyArray<{
+    lumMod: number;
+    lumOff: number;
+}>;
+/**
+ * Apply DrawingML `lumMod` / `lumOff` (as fractions, 1 = 100%) to a colour:
+ * each channel becomes `c * lumMod + 255 * lumOff`, clamped — the arithmetic
+ * the xlsx importer uses for `<a:schemeClr>` modifiers, so a derived palette
+ * colour renders exactly as the same modifier read back from a file. A colour
+ * the normalizer cannot parse is returned unchanged; the result is `#RRGGBB`
+ * upper-case (the exporter's and importer's hex convention).
+ */
+export declare const applyLumModOff: (color: string, lumMod: number, lumOff: number) => string;
+/**
+ * The colour for point / series `index` of a chart palette: the palette
+ * cycles, and each pass past its length applies the next
+ * {@link CHART_PALETTE_VARIATIONS} entry to the base colour (Excel's
+ * `varyColors` behaviour). Indexing an empty palette behaves like
+ * `palette[i]` (undefined at runtime); callers pass a non-empty palette.
+ */
+export declare const chartPaletteColorAt: (palette: readonly string[], index: number) => string;
+/**
+ * The palette unrolled through every variation pass — what to hand a
+ * renderer that cycles a colour list itself (echarts' option-level `color`,
+ * plotly's `marker.colors`): the first `palette.length` entries are the
+ * palette, the rest its variations, so the renderer's own wrap-around only
+ * starts where Excel's does.
+ */
+export declare const expandChartPalette: (palette: readonly string[]) => string[];
 export declare const getContrastColor: (backgroundColor: string, lightColor: string, darkColor: string) => string | undefined;
 //# sourceMappingURL=color.d.ts.map

package/dist/cjs/color.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"color.d.ts","sourceRoot":"","sources":["../../color.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,wBAAwB,GAAI,KAAK,MAAM,WAoCnD,CAAC;AAEF,MAAM,MAAM,IAAI,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAYnE,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAkBzD;AAED,eAAO,MAAM,aAAa,GAAI,gBAAoB,IAAI,WAUrD,CAAC;AAEF,eAAO,MAAM,WAAW,GACtB,QAAQ,MAAM,GAAG,SAAS,EAC1B,QAAQ,MAAM,GAAG,SAAS,wBAiB3B,CAAC;AAQF,eAAO,MAAM,gBAAgB,GAAI,OAAO,MAAM,GAAG,SAAS,uBAczD,CAAC;AAGF,eAAO,MAAM,YAAY,GAAI,wBAAU,EAAE,OAAO,MAAM,uBAGrD,CAAC;AAEF,eAAO,MAAM,QAAQ,GAAI,KAAK,MAAM;;;;CAOnC,CAAC;AAEF,eAAO,MAAM,QAAQ,GAAI,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE,GAAG,MAAM,WAGvD,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAC3B,iBAAiB,MAAM,EACvB,YAAY,MAAM,EAClB,WAAW,MAAM,uBAUlB,CAAC"}
+{"version":3,"file":"color.d.ts","sourceRoot":"","sources":["../../color.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,wBAAwB,GAAI,KAAK,MAAM,WAoCnD,CAAC;AAEF,MAAM,MAAM,IAAI,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAYnE,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAkBzD;AAED,eAAO,MAAM,aAAa,GAAI,gBAAoB,IAAI,WAUrD,CAAC;AAEF,eAAO,MAAM,WAAW,GACtB,QAAQ,MAAM,GAAG,SAAS,EAC1B,QAAQ,MAAM,GAAG,SAAS,wBAiB3B,CAAC;AAQF,eAAO,MAAM,gBAAgB,GAAI,OAAO,MAAM,GAAG,SAAS,uBAczD,CAAC;AAGF,eAAO,MAAM,YAAY,GAAI,wBAAU,EAAE,OAAO,MAAM,uBAGrD,CAAC;AAEF,eAAO,MAAM,QAAQ,GAAI,KAAK,MAAM;;;;CAOnC,CAAC;AAEF,eAAO,MAAM,QAAQ,GAAI,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE,GAAG,MAAM,WAGvD,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,wBAAwB,EAAE,aAAa,CAAC;IACnD,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB,CAUA,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,GACzB,OAAO,MAAM,EACb,QAAQ,MAAM,EACd,QAAQ,MAAM,KACb,MAUF,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,GAC9B,SAAS,SAAS,MAAM,EAAE,EAC1B,OAAO,MAAM,KACZ,MAMF,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,GAAI,SAAS,SAAS,MAAM,EAAE,KAAG,MAAM,EAInE,CAAC;AAEJ,eAAO,MAAM,gBAAgB,GAC3B,iBAAiB,MAAM,EACvB,YAAY,MAAM,EAClB,WAAW,MAAM,uBAUlB,CAAC"}

package/dist/cjs/color.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getContrastColor = exports.rgbToHex = exports.hexToRgb = exports.lightenColor = exports.colorStringToHex = exports.isSameColor = exports.rgbaToArgbHex = exports.getSelectionColorAtIndex = void 0;
+exports.getContrastColor = exports.expandChartPalette = exports.chartPaletteColorAt = exports.applyLumModOff = exports.CHART_PALETTE_VARIATIONS = exports.rgbToHex = exports.hexToRgb = exports.lightenColor = exports.colorStringToHex = exports.isSameColor = exports.rgbaToArgbHex = exports.getSelectionColorAtIndex = void 0;
 exports.normalizeColor = normalizeColor;
 var tslib_1 = require("tslib");
 var typeguards_1 = require("./typeguards");
@@ -139,6 +139,78 @@ var rgbToHex = function (r, g, b) {
     return "#" + ("000000" + hex).slice(-6);
 };
 exports.rgbToHex = rgbToHex;
+/**
+ * Excel's colour variations for a chart palette that runs out of entries —
+ * the default chart colour style ("Colorful Palette 1", `colors1.xml`,
+ * `meth="cycle"`): the palette's entries are used as-is on the first pass,
+ * and every further pass reuses them with a luminance modification
+ * (`lumMod` scales each channel, `lumOff` adds toward white; 1 = 100%):
+ * darker, lighter, slightly darker, lighter still, … Nine passes, then the
+ * sequence repeats — 54 distinguishable shades over the six theme accents
+ * before any exact repeat. A pie with seven slices therefore gets accent 1
+ * darkened for slice 7, not accent 1 again.
+ */
+exports.CHART_PALETTE_VARIATIONS = [
+    { lumMod: 1, lumOff: 0 },
+    { lumMod: 0.6, lumOff: 0 },
+    { lumMod: 0.8, lumOff: 0.2 },
+    { lumMod: 0.8, lumOff: 0 },
+    { lumMod: 0.6, lumOff: 0.4 },
+    { lumMod: 0.5, lumOff: 0 },
+    { lumMod: 0.7, lumOff: 0.3 },
+    { lumMod: 0.7, lumOff: 0 },
+    { lumMod: 0.5, lumOff: 0.5 },
+];
+/**
+ * Apply DrawingML `lumMod` / `lumOff` (as fractions, 1 = 100%) to a colour:
+ * each channel becomes `c * lumMod + 255 * lumOff`, clamped — the arithmetic
+ * the xlsx importer uses for `<a:schemeClr>` modifiers, so a derived palette
+ * colour renders exactly as the same modifier read back from a file. A colour
+ * the normalizer cannot parse is returned unchanged; the result is `#RRGGBB`
+ * upper-case (the exporter's and importer's hex convention).
+ */
+var applyLumModOff = function (color, lumMod, lumOff) {
+    if (lumMod === 1 && lumOff === 0)
+        return color;
+    var rgba = normalizeColor(color.trim());
+    if (!rgba || !Number.isFinite(rgba.r + rgba.g + rgba.b))
+        return color;
+    var channel = function (c) {
+        return Math.max(0, Math.min(255, Math.round(c * lumMod + 255 * lumOff)))
+            .toString(16)
+            .padStart(2, "0")
+            .toUpperCase();
+    };
+    return "#".concat(channel(rgba.r)).concat(channel(rgba.g)).concat(channel(rgba.b));
+};
+exports.applyLumModOff = applyLumModOff;
+/**
+ * The colour for point / series `index` of a chart palette: the palette
+ * cycles, and each pass past its length applies the next
+ * {@link CHART_PALETTE_VARIATIONS} entry to the base colour (Excel's
+ * `varyColors` behaviour). Indexing an empty palette behaves like
+ * `palette[i]` (undefined at runtime); callers pass a non-empty palette.
+ */
+var chartPaletteColorAt = function (palette, index) {
+    var base = palette[index % palette.length];
+    if (typeof base !== "string")
+        return base;
+    var pass = Math.floor(index / palette.length) % exports.CHART_PALETTE_VARIATIONS.length;
+    var _a = exports.CHART_PALETTE_VARIATIONS[pass], lumMod = _a.lumMod, lumOff = _a.lumOff;
+    return (0, exports.applyLumModOff)(base, lumMod, lumOff);
+};
+exports.chartPaletteColorAt = chartPaletteColorAt;
+/**
+ * The palette unrolled through every variation pass — what to hand a
+ * renderer that cycles a colour list itself (echarts' option-level `color`,
+ * plotly's `marker.colors`): the first `palette.length` entries are the
+ * palette, the rest its variations, so the renderer's own wrap-around only
+ * starts where Excel's does.
+ */
+var expandChartPalette = function (palette) {
+    return Array.from({ length: palette.length * exports.CHART_PALETTE_VARIATIONS.length }, function (_, index) { return (0, exports.chartPaletteColorAt)(palette, index); });
+};
+exports.expandChartPalette = expandChartPalette;
 var getContrastColor = function (backgroundColor, lightColor, darkColor) {
     var rgbColor = normalizeColor(backgroundColor);
     if (rgbColor) {

package/dist/cjs/date.d.ts

@@ -1,3 +1,11 @@
+/**
+ * Excel's 1900 date system counts a day that never happened: serial 60 is
+ * 1900-02-29 (Lotus 1-2-3 compatibility). 1900-01-01 is 1, 1900-02-28 is 59,
+ * 1900-03-01 is 61. Google Sheets keeps the same numbering.
+ */
+export declare const EXCEL_LEAP_BUG_SERIAL = 60;
+/** The calendar day Excel's serial 60 stands for, which no `Date` can hold. */
+export declare const isExcelLeapDay: (year: number, month: number, day: number) => boolean;
 export type DateSerialMode = "local" | "excel-utc";
 /**
  * Convert date to serial with explicit time zone behavior.
@@ -6,6 +14,14 @@ export type DateSerialMode = "local" | "excel-utc";
  */
 export declare const toSerialWithMode: (date: Date, use1904?: boolean, mode?: DateSerialMode) => number;
 export declare const toSerial: (date: Date, use1904?: boolean) => number;
+/**
+ * Serial for calendar parts the way a user typed them. Unlike
+ * `toSerial(new Date(y, m, d))`, this never goes through a `Date`, so the
+ * phantom 1900-02-29 stays serial 60 instead of rolling over to March 1
+ * (rowsncolumns/spreadsheet#1026). Every other date takes the same path as
+ * `toSerial` in "local" mode. `month` is 0-based like `Date`.
+ */
+export declare const toSerialFromParts: (year: number, month: number, day: number, hour?: number, minute?: number, second?: number, use1904?: boolean) => number;
 /**
  * Convert serial to date
  * @param serial

package/dist/cjs/date.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"date.d.ts","sourceRoot":"","sources":["../../date.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,WAAW,CAAC;AAEnD;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAC3B,MAAM,IAAI,EACV,iBAAe,EACf,OAAM,cAAwB,WAwB/B,CAAC;AAEF,eAAO,MAAM,QAAQ,GAAI,MAAM,IAAI,EAAE,iBAAe,WAEnD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,MAAM,GAAI,QAAQ,MAAM,EAAE,iBAAe,SA+BrD,CAAC"}
+{"version":3,"file":"date.d.ts","sourceRoot":"","sources":["../../date.ts"],"names":[],"mappings":"AACA;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAExC,+EAA+E;AAC/E,eAAO,MAAM,cAAc,GAAI,MAAM,MAAM,EAAE,OAAO,MAAM,EAAE,KAAK,MAAM,YAC3B,CAAC;AAE7C,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,WAAW,CAAC;AAEnD;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAC3B,MAAM,IAAI,EACV,iBAAe,EACf,OAAM,cAAwB,WAwB/B,CAAC;AAEF,eAAO,MAAM,QAAQ,GAAI,MAAM,IAAI,EAAE,iBAAe,WAEnD,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,GAC5B,MAAM,MAAM,EACZ,OAAO,MAAM,EACb,KAAK,MAAM,EACX,aAAQ,EACR,eAAU,EACV,eAAU,EACV,iBAAe,WAWhB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,MAAM,GAAI,QAAQ,MAAM,EAAE,iBAAe,SA+BrD,CAAC"}

package/dist/cjs/date.js

@@ -1,8 +1,18 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.toDate = exports.toSerial = exports.toSerialWithMode = void 0;
+exports.toDate = exports.toSerialFromParts = exports.toSerial = exports.toSerialWithMode = exports.isExcelLeapDay = exports.EXCEL_LEAP_BUG_SERIAL = void 0;
 var DAY_TO_MS = 24 * 60 * 60 * 1000;
-var EXCEL_LEAP_BUG_SERIAL = 60;
+/**
+ * Excel's 1900 date system counts a day that never happened: serial 60 is
+ * 1900-02-29 (Lotus 1-2-3 compatibility). 1900-01-01 is 1, 1900-02-28 is 59,
+ * 1900-03-01 is 61. Google Sheets keeps the same numbering.
+ */
+exports.EXCEL_LEAP_BUG_SERIAL = 60;
+/** The calendar day Excel's serial 60 stands for, which no `Date` can hold. */
+var isExcelLeapDay = function (year, month, day) {
+    return year === 1900 && month === 1 && day === 29;
+};
+exports.isExcelLeapDay = isExcelLeapDay;
 /**
  * Convert date to serial with explicit time zone behavior.
  * - local: interpret date components in local time (UI entry behavior).
@@ -31,6 +41,25 @@ var toSerial = function (date, use1904) {
     return (0, exports.toSerialWithMode)(date, use1904, "local");
 };
 exports.toSerial = toSerial;
+/**
+ * Serial for calendar parts the way a user typed them. Unlike
+ * `toSerial(new Date(y, m, d))`, this never goes through a `Date`, so the
+ * phantom 1900-02-29 stays serial 60 instead of rolling over to March 1
+ * (rowsncolumns/spreadsheet#1026). Every other date takes the same path as
+ * `toSerial` in "local" mode. `month` is 0-based like `Date`.
+ */
+var toSerialFromParts = function (year, month, day, hour, minute, second, use1904) {
+    if (hour === void 0) { hour = 0; }
+    if (minute === void 0) { minute = 0; }
+    if (second === void 0) { second = 0; }
+    if (use1904 === void 0) { use1904 = false; }
+    var timeFraction = (hour * 3600 + minute * 60 + second) / (24 * 60 * 60);
+    if (!use1904 && (0, exports.isExcelLeapDay)(year, month, day)) {
+        return exports.EXCEL_LEAP_BUG_SERIAL + timeFraction;
+    }
+    return (0, exports.toSerialWithMode)(new Date(year, month, day, hour, minute, second, 0), use1904, "local");
+};
+exports.toSerialFromParts = toSerialFromParts;
 /**
  * Convert serial to date
  * @param serial
@@ -44,11 +73,11 @@ var toDate = function (serial, use1904) {
         var utcDate_1 = new Date(utcMillis_1);
         return new Date(utcDate_1.getUTCFullYear(), utcDate_1.getUTCMonth(), utcDate_1.getUTCDate(), utcDate_1.getUTCHours(), utcDate_1.getUTCMinutes(), utcDate_1.getUTCSeconds(), utcDate_1.getUTCMilliseconds());
     }
-    if (serial === EXCEL_LEAP_BUG_SERIAL) {
+    if (serial === exports.EXCEL_LEAP_BUG_SERIAL) {
         return new Date(1900, 1, 28);
     }
     var baseUtc = Date.UTC(1899, 11, 31);
-    var dayCount = serial < EXCEL_LEAP_BUG_SERIAL ? serial : serial - 1;
+    var dayCount = serial < exports.EXCEL_LEAP_BUG_SERIAL ? serial : serial - 1;
     var utcMillis = baseUtc + dayCount * DAY_TO_MS;
     var utcDate = new Date(utcMillis);
     return new Date(utcDate.getUTCFullYear(), utcDate.getUTCMonth(), utcDate.getUTCDate(), utcDate.getUTCHours(), utcDate.getUTCMinutes(), utcDate.getUTCSeconds(), utcDate.getUTCMilliseconds());

package/dist/esm/color.d.ts

@@ -16,5 +16,45 @@ export declare const hexToRgb: (hex: string) => {
     b: number;
 };
 export declare const rgbToHex: (r: number, g: number, b: number) => string;
+/**
+ * Excel's colour variations for a chart palette that runs out of entries —
+ * the default chart colour style ("Colorful Palette 1", `colors1.xml`,
+ * `meth="cycle"`): the palette's entries are used as-is on the first pass,
+ * and every further pass reuses them with a luminance modification
+ * (`lumMod` scales each channel, `lumOff` adds toward white; 1 = 100%):
+ * darker, lighter, slightly darker, lighter still, … Nine passes, then the
+ * sequence repeats — 54 distinguishable shades over the six theme accents
+ * before any exact repeat. A pie with seven slices therefore gets accent 1
+ * darkened for slice 7, not accent 1 again.
+ */
+export declare const CHART_PALETTE_VARIATIONS: ReadonlyArray<{
+    lumMod: number;
+    lumOff: number;
+}>;
+/**
+ * Apply DrawingML `lumMod` / `lumOff` (as fractions, 1 = 100%) to a colour:
+ * each channel becomes `c * lumMod + 255 * lumOff`, clamped — the arithmetic
+ * the xlsx importer uses for `<a:schemeClr>` modifiers, so a derived palette
+ * colour renders exactly as the same modifier read back from a file. A colour
+ * the normalizer cannot parse is returned unchanged; the result is `#RRGGBB`
+ * upper-case (the exporter's and importer's hex convention).
+ */
+export declare const applyLumModOff: (color: string, lumMod: number, lumOff: number) => string;
+/**
+ * The colour for point / series `index` of a chart palette: the palette
+ * cycles, and each pass past its length applies the next
+ * {@link CHART_PALETTE_VARIATIONS} entry to the base colour (Excel's
+ * `varyColors` behaviour). Indexing an empty palette behaves like
+ * `palette[i]` (undefined at runtime); callers pass a non-empty palette.
+ */
+export declare const chartPaletteColorAt: (palette: readonly string[], index: number) => string;
+/**
+ * The palette unrolled through every variation pass — what to hand a
+ * renderer that cycles a colour list itself (echarts' option-level `color`,
+ * plotly's `marker.colors`): the first `palette.length` entries are the
+ * palette, the rest its variations, so the renderer's own wrap-around only
+ * starts where Excel's does.
+ */
+export declare const expandChartPalette: (palette: readonly string[]) => string[];
 export declare const getContrastColor: (backgroundColor: string, lightColor: string, darkColor: string) => string | undefined;
 //# sourceMappingURL=color.d.ts.map

package/dist/esm/color.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"color.d.ts","sourceRoot":"","sources":["../../color.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,wBAAwB,GAAI,KAAK,MAAM,WAoCnD,CAAC;AAEF,MAAM,MAAM,IAAI,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAYnE,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAkBzD;AAED,eAAO,MAAM,aAAa,GAAI,gBAAoB,IAAI,WAUrD,CAAC;AAEF,eAAO,MAAM,WAAW,GACtB,QAAQ,MAAM,GAAG,SAAS,EAC1B,QAAQ,MAAM,GAAG,SAAS,wBAiB3B,CAAC;AAQF,eAAO,MAAM,gBAAgB,GAAI,OAAO,MAAM,GAAG,SAAS,uBAczD,CAAC;AAGF,eAAO,MAAM,YAAY,GAAI,wBAAU,EAAE,OAAO,MAAM,uBAGrD,CAAC;AAEF,eAAO,MAAM,QAAQ,GAAI,KAAK,MAAM;;;;CAOnC,CAAC;AAEF,eAAO,MAAM,QAAQ,GAAI,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE,GAAG,MAAM,WAGvD,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAC3B,iBAAiB,MAAM,EACvB,YAAY,MAAM,EAClB,WAAW,MAAM,uBAUlB,CAAC"}
+{"version":3,"file":"color.d.ts","sourceRoot":"","sources":["../../color.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,wBAAwB,GAAI,KAAK,MAAM,WAoCnD,CAAC;AAEF,MAAM,MAAM,IAAI,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAYnE,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAkBzD;AAED,eAAO,MAAM,aAAa,GAAI,gBAAoB,IAAI,WAUrD,CAAC;AAEF,eAAO,MAAM,WAAW,GACtB,QAAQ,MAAM,GAAG,SAAS,EAC1B,QAAQ,MAAM,GAAG,SAAS,wBAiB3B,CAAC;AAQF,eAAO,MAAM,gBAAgB,GAAI,OAAO,MAAM,GAAG,SAAS,uBAczD,CAAC;AAGF,eAAO,MAAM,YAAY,GAAI,wBAAU,EAAE,OAAO,MAAM,uBAGrD,CAAC;AAEF,eAAO,MAAM,QAAQ,GAAI,KAAK,MAAM;;;;CAOnC,CAAC;AAEF,eAAO,MAAM,QAAQ,GAAI,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE,GAAG,MAAM,WAGvD,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,wBAAwB,EAAE,aAAa,CAAC;IACnD,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB,CAUA,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,GACzB,OAAO,MAAM,EACb,QAAQ,MAAM,EACd,QAAQ,MAAM,KACb,MAUF,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,GAC9B,SAAS,SAAS,MAAM,EAAE,EAC1B,OAAO,MAAM,KACZ,MAMF,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,GAAI,SAAS,SAAS,MAAM,EAAE,KAAG,MAAM,EAInE,CAAC;AAEJ,eAAO,MAAM,gBAAgB,GAC3B,iBAAiB,MAAM,EACvB,YAAY,MAAM,EAClB,WAAW,MAAM,uBAUlB,CAAC"}

package/dist/esm/color.js

@@ -125,6 +125,71 @@ export const rgbToHex = (r, g, b) => {
     const hex = ((r << 16) | (g << 8) | b).toString(16);
     return "#" + ("000000" + hex).slice(-6);
 };
+/**
+ * Excel's colour variations for a chart palette that runs out of entries —
+ * the default chart colour style ("Colorful Palette 1", `colors1.xml`,
+ * `meth="cycle"`): the palette's entries are used as-is on the first pass,
+ * and every further pass reuses them with a luminance modification
+ * (`lumMod` scales each channel, `lumOff` adds toward white; 1 = 100%):
+ * darker, lighter, slightly darker, lighter still, … Nine passes, then the
+ * sequence repeats — 54 distinguishable shades over the six theme accents
+ * before any exact repeat. A pie with seven slices therefore gets accent 1
+ * darkened for slice 7, not accent 1 again.
+ */
+export const CHART_PALETTE_VARIATIONS = [
+    { lumMod: 1, lumOff: 0 },
+    { lumMod: 0.6, lumOff: 0 },
+    { lumMod: 0.8, lumOff: 0.2 },
+    { lumMod: 0.8, lumOff: 0 },
+    { lumMod: 0.6, lumOff: 0.4 },
+    { lumMod: 0.5, lumOff: 0 },
+    { lumMod: 0.7, lumOff: 0.3 },
+    { lumMod: 0.7, lumOff: 0 },
+    { lumMod: 0.5, lumOff: 0.5 },
+];
+/**
+ * Apply DrawingML `lumMod` / `lumOff` (as fractions, 1 = 100%) to a colour:
+ * each channel becomes `c * lumMod + 255 * lumOff`, clamped — the arithmetic
+ * the xlsx importer uses for `<a:schemeClr>` modifiers, so a derived palette
+ * colour renders exactly as the same modifier read back from a file. A colour
+ * the normalizer cannot parse is returned unchanged; the result is `#RRGGBB`
+ * upper-case (the exporter's and importer's hex convention).
+ */
+export const applyLumModOff = (color, lumMod, lumOff) => {
+    if (lumMod === 1 && lumOff === 0)
+        return color;
+    const rgba = normalizeColor(color.trim());
+    if (!rgba || !Number.isFinite(rgba.r + rgba.g + rgba.b))
+        return color;
+    const channel = (c) => Math.max(0, Math.min(255, Math.round(c * lumMod + 255 * lumOff)))
+        .toString(16)
+        .padStart(2, "0")
+        .toUpperCase();
+    return `#${channel(rgba.r)}${channel(rgba.g)}${channel(rgba.b)}`;
+};
+/**
+ * The colour for point / series `index` of a chart palette: the palette
+ * cycles, and each pass past its length applies the next
+ * {@link CHART_PALETTE_VARIATIONS} entry to the base colour (Excel's
+ * `varyColors` behaviour). Indexing an empty palette behaves like
+ * `palette[i]` (undefined at runtime); callers pass a non-empty palette.
+ */
+export const chartPaletteColorAt = (palette, index) => {
+    const base = palette[index % palette.length];
+    if (typeof base !== "string")
+        return base;
+    const pass = Math.floor(index / palette.length) % CHART_PALETTE_VARIATIONS.length;
+    const { lumMod, lumOff } = CHART_PALETTE_VARIATIONS[pass];
+    return applyLumModOff(base, lumMod, lumOff);
+};
+/**
+ * The palette unrolled through every variation pass — what to hand a
+ * renderer that cycles a colour list itself (echarts' option-level `color`,
+ * plotly's `marker.colors`): the first `palette.length` entries are the
+ * palette, the rest its variations, so the renderer's own wrap-around only
+ * starts where Excel's does.
+ */
+export const expandChartPalette = (palette) => Array.from({ length: palette.length * CHART_PALETTE_VARIATIONS.length }, (_, index) => chartPaletteColorAt(palette, index));
 export const getContrastColor = (backgroundColor, lightColor, darkColor) => {
     const rgbColor = normalizeColor(backgroundColor);
     if (rgbColor) {

package/dist/esm/date.d.ts

@@ -1,3 +1,11 @@
+/**
+ * Excel's 1900 date system counts a day that never happened: serial 60 is
+ * 1900-02-29 (Lotus 1-2-3 compatibility). 1900-01-01 is 1, 1900-02-28 is 59,
+ * 1900-03-01 is 61. Google Sheets keeps the same numbering.
+ */
+export declare const EXCEL_LEAP_BUG_SERIAL = 60;
+/** The calendar day Excel's serial 60 stands for, which no `Date` can hold. */
+export declare const isExcelLeapDay: (year: number, month: number, day: number) => boolean;
 export type DateSerialMode = "local" | "excel-utc";
 /**
  * Convert date to serial with explicit time zone behavior.
@@ -6,6 +14,14 @@ export type DateSerialMode = "local" | "excel-utc";
  */
 export declare const toSerialWithMode: (date: Date, use1904?: boolean, mode?: DateSerialMode) => number;
 export declare const toSerial: (date: Date, use1904?: boolean) => number;
+/**
+ * Serial for calendar parts the way a user typed them. Unlike
+ * `toSerial(new Date(y, m, d))`, this never goes through a `Date`, so the
+ * phantom 1900-02-29 stays serial 60 instead of rolling over to March 1
+ * (rowsncolumns/spreadsheet#1026). Every other date takes the same path as
+ * `toSerial` in "local" mode. `month` is 0-based like `Date`.
+ */
+export declare const toSerialFromParts: (year: number, month: number, day: number, hour?: number, minute?: number, second?: number, use1904?: boolean) => number;
 /**
  * Convert serial to date
  * @param serial

package/dist/esm/date.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"date.d.ts","sourceRoot":"","sources":["../../date.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,WAAW,CAAC;AAEnD;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAC3B,MAAM,IAAI,EACV,iBAAe,EACf,OAAM,cAAwB,WAwB/B,CAAC;AAEF,eAAO,MAAM,QAAQ,GAAI,MAAM,IAAI,EAAE,iBAAe,WAEnD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,MAAM,GAAI,QAAQ,MAAM,EAAE,iBAAe,SA+BrD,CAAC"}
+{"version":3,"file":"date.d.ts","sourceRoot":"","sources":["../../date.ts"],"names":[],"mappings":"AACA;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAExC,+EAA+E;AAC/E,eAAO,MAAM,cAAc,GAAI,MAAM,MAAM,EAAE,OAAO,MAAM,EAAE,KAAK,MAAM,YAC3B,CAAC;AAE7C,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,WAAW,CAAC;AAEnD;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAC3B,MAAM,IAAI,EACV,iBAAe,EACf,OAAM,cAAwB,WAwB/B,CAAC;AAEF,eAAO,MAAM,QAAQ,GAAI,MAAM,IAAI,EAAE,iBAAe,WAEnD,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,GAC5B,MAAM,MAAM,EACZ,OAAO,MAAM,EACb,KAAK,MAAM,EACX,aAAQ,EACR,eAAU,EACV,eAAU,EACV,iBAAe,WAWhB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,MAAM,GAAI,QAAQ,MAAM,EAAE,iBAAe,SA+BrD,CAAC"}

package/dist/esm/date.js

@@ -1,5 +1,12 @@
 const DAY_TO_MS = 24 * 60 * 60 * 1000;
-const EXCEL_LEAP_BUG_SERIAL = 60;
+/**
+ * Excel's 1900 date system counts a day that never happened: serial 60 is
+ * 1900-02-29 (Lotus 1-2-3 compatibility). 1900-01-01 is 1, 1900-02-28 is 59,
+ * 1900-03-01 is 61. Google Sheets keeps the same numbering.
+ */
+export const EXCEL_LEAP_BUG_SERIAL = 60;
+/** The calendar day Excel's serial 60 stands for, which no `Date` can hold. */
+export const isExcelLeapDay = (year, month, day) => year === 1900 && month === 1 && day === 29;
 /**
  * Convert date to serial with explicit time zone behavior.
  * - local: interpret date components in local time (UI entry behavior).
@@ -23,6 +30,20 @@ export const toSerialWithMode = (date, use1904 = false, mode = "local") => {
 export const toSerial = (date, use1904 = false) => {
     return toSerialWithMode(date, use1904, "local");
 };
+/**
+ * Serial for calendar parts the way a user typed them. Unlike
+ * `toSerial(new Date(y, m, d))`, this never goes through a `Date`, so the
+ * phantom 1900-02-29 stays serial 60 instead of rolling over to March 1
+ * (rowsncolumns/spreadsheet#1026). Every other date takes the same path as
+ * `toSerial` in "local" mode. `month` is 0-based like `Date`.
+ */
+export const toSerialFromParts = (year, month, day, hour = 0, minute = 0, second = 0, use1904 = false) => {
+    const timeFraction = (hour * 3600 + minute * 60 + second) / (24 * 60 * 60);
+    if (!use1904 && isExcelLeapDay(year, month, day)) {
+        return EXCEL_LEAP_BUG_SERIAL + timeFraction;
+    }
+    return toSerialWithMode(new Date(year, month, day, hour, minute, second, 0), use1904, "local");
+};
 /**
  * Convert serial to date
  * @param serial

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rowsncolumns/utils",
-  "version": "9.5.3",
+  "version": "9.5.5",
   "author": "Vinay M",
   "license": "SEE LICENSE IN LICENSE.md",
   "main": "./dist/cjs/index.js",