@rowsncolumns/charts 27.0.34 → 28.1.0

package/dist/cjs/utils/chart-styles.js

@@ -0,0 +1,283 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.applyChartQuickLayout = exports.CHART_QUICK_LAYOUTS = exports.applyChartStyle = exports.CHART_STYLES = exports.getChartPalette = exports.resetChartToMatchStyle = exports.applyChartColorPalette = exports.CHART_COLOR_PALETTES = void 0;
+var tslib_1 = require("tslib");
+/**
+ * Office's Change Colors gallery. Colorful 1 is the theme itself (no
+ * `colors` — the renderer keeps its accent fallback); the rest are the
+ * default Office theme's derived palettes.
+ */
+exports.CHART_COLOR_PALETTES = [
+    { id: "colorful1", label: "Colorful Palette 1", kind: "colorful" },
+    {
+        id: "colorful2",
+        label: "Colorful Palette 2",
+        kind: "colorful",
+        colors: ["#4472C4", "#A5A5A5", "#5B9BD5", "#264478", "#636363", "#255E91"],
+    },
+    {
+        id: "colorful3",
+        label: "Colorful Palette 3",
+        kind: "colorful",
+        colors: ["#ED7D31", "#FFC000", "#70AD47", "#9E480E", "#997300", "#43682B"],
+    },
+    {
+        id: "colorful4",
+        label: "Colorful Palette 4",
+        kind: "colorful",
+        colors: ["#70AD47", "#4472C4", "#FFC000", "#43682B", "#264478", "#997300"],
+    },
+    {
+        id: "mono1",
+        label: "Monochromatic Palette 1",
+        kind: "monochromatic",
+        colors: ["#1F3864", "#2F5597", "#4472C4", "#8FAADC", "#B4C7E7", "#DAE3F3"],
+    },
+    {
+        id: "mono2",
+        label: "Monochromatic Palette 2",
+        kind: "monochromatic",
+        colors: ["#833C0B", "#C55A11", "#ED7D31", "#F4B183", "#F8CBAD", "#FBE5D6"],
+    },
+    {
+        id: "mono3",
+        label: "Monochromatic Palette 3",
+        kind: "monochromatic",
+        colors: ["#525252", "#7B7B7B", "#A5A5A5", "#C9C9C9", "#DBDBDB", "#EDEDED"],
+    },
+    {
+        id: "mono4",
+        label: "Monochromatic Palette 4",
+        kind: "monochromatic",
+        colors: ["#375623", "#548235", "#70AD47", "#A9D18E", "#C5E0B4", "#E2F0D9"],
+    },
+];
+var stripSeriesColor = function (entry) {
+    var _color = entry.color, _gradient = entry.gradient, _dataPointColors = entry.dataPointColors, _negativeColor = entry.negativeColor, rest = tslib_1.__rest(entry, ["color", "gradient", "dataPointColors", "negativeColor"]);
+    return rest;
+};
+/**
+ * Strip the per-series colour overrides so the chart-level palette shows
+ * through. Hierarchy specs (treemap / sunburst) carry no series.
+ */
+var withoutSeriesColors = function (spec) {
+    return "series" in spec && Array.isArray(spec.series)
+        ? tslib_1.__assign(tslib_1.__assign({}, spec), { series: spec.series.map(stripSeriesColor) })
+        : spec;
+};
+/**
+ * Change Colors: set the palette and clear every series' own colour so the
+ * palette applies (a series colour always wins over the palette).
+ */
+var applyChartColorPalette = function (spec, palette) { return (tslib_1.__assign(tslib_1.__assign({}, withoutSeriesColors(spec)), { palette: palette.colors ? tslib_1.__spreadArray([], tslib_1.__read(palette.colors), false) : undefined })); };
+exports.applyChartColorPalette = applyChartColorPalette;
+/**
+ * Reset to Match Style: drop the per-series formatting overrides so the
+ * series follow the chart style's palette again. Chart-level fields are
+ * untouched — they *are* the style.
+ */
+var resetChartToMatchStyle = function (spec) {
+    return withoutSeriesColors(spec);
+};
+exports.resetChartToMatchStyle = resetChartToMatchStyle;
+/**
+ * The series colour cycle a renderer should use: the spec's palette when
+ * one is set, else the caller's theme accents.
+ */
+var getChartPalette = function (spec, fallback) {
+    return (spec === null || spec === void 0 ? void 0 : spec.palette) && spec.palette.length > 0
+        ? tslib_1.__spreadArray([], tslib_1.__read(spec.palette), false) : tslib_1.__spreadArray([], tslib_1.__read(fallback), false);
+};
+exports.getChartPalette = getChartPalette;
+var GRAYSCALE_PALETTE = [
+    "#404040",
+    "#7F7F7F",
+    "#A5A5A5",
+    "#BFBFBF",
+    "#D9D9D9",
+    "#595959",
+];
+var MONOCHROME_PALETTE = exports.CHART_COLOR_PALETTES.find(function (palette) { return palette.id === "mono1"; }).colors;
+var COLORFUL_PREVIEW = ["#4472C4", "#ED7D31", "#A5A5A5", "#FFC000"];
+var setTitleFormat = function (spec, format) {
+    var _a;
+    return (tslib_1.__assign(tslib_1.__assign({}, ((_a = spec.titleTextFormat) !== null && _a !== void 0 ? _a : {})), format));
+};
+var setAxisGridlines = function (spec, show) {
+    var _a;
+    return ({
+        valueAxisOptions: tslib_1.__assign(tslib_1.__assign({}, ((_a = spec.valueAxisOptions) !== null && _a !== void 0 ? _a : {})), { showMajorGridlines: show }),
+    });
+};
+/** Text colour for every chart text element (dark-frame styles). */
+var setTextColor = function (spec, color) {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m;
+    return ({
+        titleTextFormat: setTitleFormat(spec, { color: color }),
+        legend: tslib_1.__assign(tslib_1.__assign({}, ((_a = spec.legend) !== null && _a !== void 0 ? _a : {})), { textFormat: tslib_1.__assign(tslib_1.__assign({}, ((_c = (_b = spec.legend) === null || _b === void 0 ? void 0 : _b.textFormat) !== null && _c !== void 0 ? _c : {})), { color: color }) }),
+        valueAxisOptions: tslib_1.__assign(tslib_1.__assign({}, ((_d = spec.valueAxisOptions) !== null && _d !== void 0 ? _d : {})), { textFormat: tslib_1.__assign(tslib_1.__assign({}, ((_f = (_e = spec.valueAxisOptions) === null || _e === void 0 ? void 0 : _e.textFormat) !== null && _f !== void 0 ? _f : {})), { color: color }) }),
+        categoryAxisOptions: tslib_1.__assign(tslib_1.__assign({}, ((_g = spec.categoryAxisOptions) !== null && _g !== void 0 ? _g : {})), { textFormat: tslib_1.__assign(tslib_1.__assign({}, ((_j = (_h = spec.categoryAxisOptions) === null || _h === void 0 ? void 0 : _h.textFormat) !== null && _j !== void 0 ? _j : {})), { color: color }) }),
+        dataLabels: tslib_1.__assign(tslib_1.__assign({}, ((_k = spec.dataLabels) !== null && _k !== void 0 ? _k : {})), { textFormat: tslib_1.__assign(tslib_1.__assign({}, ((_m = (_l = spec.dataLabels) === null || _l === void 0 ? void 0 : _l.textFormat) !== null && _m !== void 0 ? _m : {})), { color: color }) }),
+    });
+};
+/**
+ * The Chart Styles gallery. Each entry pins the look Excel's style of that
+ * id implies onto the spec fields both renderers read: chart-area fill,
+ * gridlines, data labels, legend placement, title font and — for the
+ * grayscale / monochromatic rows — the palette. Per-series colours are
+ * left alone (Reset to Match Style clears them).
+ */
+exports.CHART_STYLES = [
+    {
+        id: 2,
+        label: "Style 1",
+        preview: { background: "#FFFFFF", bars: COLORFUL_PREVIEW },
+        apply: function (spec) {
+            var _a;
+            return (tslib_1.__assign(tslib_1.__assign(tslib_1.__assign(tslib_1.__assign({}, spec), { chartStyle: 2, backgroundColor: undefined }), setAxisGridlines(spec, true)), { dataLabels: tslib_1.__assign(tslib_1.__assign({}, ((_a = spec.dataLabels) !== null && _a !== void 0 ? _a : {})), { show: false }), titleTextFormat: setTitleFormat(spec, {
+                    fontSize: 14,
+                    bold: false,
+                    color: undefined,
+                }) }));
+        },
+    },
+    {
+        id: 10,
+        label: "Style 2",
+        preview: { background: "#FFFFFF", bars: COLORFUL_PREVIEW },
+        apply: function (spec) {
+            var _a, _b;
+            return (tslib_1.__assign(tslib_1.__assign(tslib_1.__assign(tslib_1.__assign({}, spec), { chartStyle: 10, backgroundColor: undefined }), setAxisGridlines(spec, true)), { dataLabels: tslib_1.__assign(tslib_1.__assign({}, ((_a = spec.dataLabels) !== null && _a !== void 0 ? _a : {})), { show: true, position: "outsideEnd" }), legend: tslib_1.__assign(tslib_1.__assign({}, ((_b = spec.legend) !== null && _b !== void 0 ? _b : {})), { position: "top" }), titleTextFormat: setTitleFormat(spec, { fontSize: 16, bold: true }) }));
+        },
+    },
+    {
+        id: 18,
+        label: "Style 3",
+        preview: { background: "#FFFFFF", bars: COLORFUL_PREVIEW },
+        apply: function (spec) {
+            var _a, _b;
+            return (tslib_1.__assign(tslib_1.__assign(tslib_1.__assign(tslib_1.__assign({}, spec), { chartStyle: 18, backgroundColor: undefined }), setAxisGridlines(spec, false)), { dataLabels: tslib_1.__assign(tslib_1.__assign({}, ((_a = spec.dataLabels) !== null && _a !== void 0 ? _a : {})), { show: true, position: "insideEnd" }), legend: tslib_1.__assign(tslib_1.__assign({}, ((_b = spec.legend) !== null && _b !== void 0 ? _b : {})), { position: "bottom" }), titleTextFormat: setTitleFormat(spec, { fontSize: 14, bold: true }) }));
+        },
+    },
+    {
+        id: 26,
+        label: "Style 4",
+        preview: { background: "#F2F2F2", bars: COLORFUL_PREVIEW },
+        apply: function (spec) {
+            var _a, _b;
+            return (tslib_1.__assign(tslib_1.__assign(tslib_1.__assign(tslib_1.__assign({}, spec), { chartStyle: 26, backgroundColor: "#F2F2F2" }), setAxisGridlines(spec, true)), { dataLabels: tslib_1.__assign(tslib_1.__assign({}, ((_a = spec.dataLabels) !== null && _a !== void 0 ? _a : {})), { show: false }), legend: tslib_1.__assign(tslib_1.__assign({}, ((_b = spec.legend) !== null && _b !== void 0 ? _b : {})), { position: "bottom" }), titleTextFormat: setTitleFormat(spec, { fontSize: 18, bold: true }) }));
+        },
+    },
+    {
+        id: 1,
+        label: "Style 5",
+        preview: { background: "#FFFFFF", bars: GRAYSCALE_PALETTE.slice(0, 4) },
+        apply: function (spec) { return (tslib_1.__assign(tslib_1.__assign(tslib_1.__assign(tslib_1.__assign({}, spec), { chartStyle: 1, backgroundColor: undefined, palette: tslib_1.__spreadArray([], tslib_1.__read(GRAYSCALE_PALETTE), false) }), setAxisGridlines(spec, true)), { titleTextFormat: setTitleFormat(spec, { fontSize: 14, bold: false }) })); },
+    },
+    {
+        id: 3,
+        label: "Style 6",
+        preview: { background: "#FFFFFF", bars: MONOCHROME_PALETTE.slice(0, 4) },
+        apply: function (spec) { return (tslib_1.__assign(tslib_1.__assign(tslib_1.__assign(tslib_1.__assign({}, spec), { chartStyle: 3, backgroundColor: undefined, palette: tslib_1.__spreadArray([], tslib_1.__read(MONOCHROME_PALETTE), false) }), setAxisGridlines(spec, true)), { titleTextFormat: setTitleFormat(spec, { fontSize: 14, bold: false }) })); },
+    },
+    {
+        id: 34,
+        label: "Style 7",
+        preview: { background: "#404040", bars: COLORFUL_PREVIEW },
+        apply: function (spec) {
+            var _a, _b, _c;
+            return (tslib_1.__assign(tslib_1.__assign(tslib_1.__assign(tslib_1.__assign({}, spec), { chartStyle: 34, backgroundColor: "#404040" }), setTextColor(spec, "#F2F2F2")), { valueAxisOptions: tslib_1.__assign(tslib_1.__assign({}, ((_a = spec.valueAxisOptions) !== null && _a !== void 0 ? _a : {})), { textFormat: tslib_1.__assign(tslib_1.__assign({}, ((_c = (_b = spec.valueAxisOptions) === null || _b === void 0 ? void 0 : _b.textFormat) !== null && _c !== void 0 ? _c : {})), { color: "#F2F2F2" }), showMajorGridlines: true }), titleTextFormat: setTitleFormat(spec, {
+                    fontSize: 16,
+                    bold: true,
+                    color: "#FFFFFF",
+                }) }));
+        },
+    },
+    {
+        id: 42,
+        label: "Style 8",
+        preview: { background: "#000000", bars: COLORFUL_PREVIEW },
+        apply: function (spec) {
+            var _a, _b, _c;
+            return (tslib_1.__assign(tslib_1.__assign(tslib_1.__assign(tslib_1.__assign({}, spec), { chartStyle: 42, backgroundColor: "#000000" }), setTextColor(spec, "#FFFFFF")), { valueAxisOptions: tslib_1.__assign(tslib_1.__assign({}, ((_a = spec.valueAxisOptions) !== null && _a !== void 0 ? _a : {})), { textFormat: tslib_1.__assign(tslib_1.__assign({}, ((_c = (_b = spec.valueAxisOptions) === null || _b === void 0 ? void 0 : _b.textFormat) !== null && _c !== void 0 ? _c : {})), { color: "#FFFFFF" }), showMajorGridlines: false }), titleTextFormat: setTitleFormat(spec, {
+                    fontSize: 16,
+                    bold: true,
+                    color: "#FFFFFF",
+                }) }));
+        },
+    },
+];
+var applyChartStyle = function (spec, style) { return style.apply(spec); };
+exports.applyChartStyle = applyChartStyle;
+/** Excel inserts placeholder axis titles when a layout shows axis titles the chart lacks. */
+var AXIS_TITLE_PLACEHOLDER = "Axis Title";
+var withAxisTitles = function (spec, show) {
+    return show
+        ? {
+            verticalAxisTitle: spec.verticalAxisTitle || AXIS_TITLE_PLACEHOLDER,
+            horizontalAxisTitle: spec.horizontalAxisTitle || AXIS_TITLE_PLACEHOLDER,
+        }
+        : { verticalAxisTitle: undefined, horizontalAxisTitle: undefined };
+};
+var withDataLabels = function (spec, show, position) {
+    var _a;
+    return ({
+        dataLabels: tslib_1.__assign(tslib_1.__assign(tslib_1.__assign({}, ((_a = spec.dataLabels) !== null && _a !== void 0 ? _a : {})), { show: show }), (show && position ? { position: position } : {})),
+    });
+};
+/**
+ * Excel's Quick Layout gallery (the first six of the column-chart set).
+ * Layouts arrange the existing elements; they never touch colours.
+ */
+exports.CHART_QUICK_LAYOUTS = [
+    {
+        id: 1,
+        label: "Layout 1",
+        apply: function (spec) {
+            var _a;
+            return (tslib_1.__assign(tslib_1.__assign(tslib_1.__assign(tslib_1.__assign({}, spec), { legend: tslib_1.__assign(tslib_1.__assign({}, ((_a = spec.legend) !== null && _a !== void 0 ? _a : {})), { position: "right" }) }), withDataLabels(spec, false)), withAxisTitles(spec, false)));
+        },
+    },
+    {
+        id: 2,
+        label: "Layout 2",
+        apply: function (spec) {
+            var _a, _b;
+            return (tslib_1.__assign(tslib_1.__assign(tslib_1.__assign(tslib_1.__assign(tslib_1.__assign({}, spec), { legend: tslib_1.__assign(tslib_1.__assign({}, ((_a = spec.legend) !== null && _a !== void 0 ? _a : {})), { position: "top" }) }), withDataLabels(spec, true, "outsideEnd")), withAxisTitles(spec, false)), { valueAxisOptions: tslib_1.__assign(tslib_1.__assign({}, ((_b = spec.valueAxisOptions) !== null && _b !== void 0 ? _b : {})), { showMajorGridlines: false }) }));
+        },
+    },
+    {
+        id: 3,
+        label: "Layout 3",
+        apply: function (spec) {
+            var _a;
+            return (tslib_1.__assign(tslib_1.__assign(tslib_1.__assign(tslib_1.__assign({}, spec), { legend: tslib_1.__assign(tslib_1.__assign({}, ((_a = spec.legend) !== null && _a !== void 0 ? _a : {})), { position: "bottom" }) }), withDataLabels(spec, false)), withAxisTitles(spec, false)));
+        },
+    },
+    {
+        id: 4,
+        label: "Layout 4",
+        apply: function (spec) {
+            var _a, _b;
+            return (tslib_1.__assign(tslib_1.__assign(tslib_1.__assign(tslib_1.__assign(tslib_1.__assign({}, spec), { legend: tslib_1.__assign(tslib_1.__assign({}, ((_a = spec.legend) !== null && _a !== void 0 ? _a : {})), { position: "none" }) }), withDataLabels(spec, true, "insideEnd")), withAxisTitles(spec, false)), { valueAxisOptions: tslib_1.__assign(tslib_1.__assign({}, ((_b = spec.valueAxisOptions) !== null && _b !== void 0 ? _b : {})), { showMajorGridlines: false }) }));
+        },
+    },
+    {
+        id: 5,
+        label: "Layout 5",
+        apply: function (spec) {
+            var _a;
+            return (tslib_1.__assign(tslib_1.__assign(tslib_1.__assign(tslib_1.__assign({}, spec), { legend: tslib_1.__assign(tslib_1.__assign({}, ((_a = spec.legend) !== null && _a !== void 0 ? _a : {})), { position: "none" }) }), withDataLabels(spec, false)), withAxisTitles(spec, true)));
+        },
+    },
+    {
+        id: 6,
+        label: "Layout 6",
+        apply: function (spec) {
+            var _a;
+            return (tslib_1.__assign(tslib_1.__assign(tslib_1.__assign(tslib_1.__assign({}, spec), { legend: tslib_1.__assign(tslib_1.__assign({}, ((_a = spec.legend) !== null && _a !== void 0 ? _a : {})), { position: "right" }) }), withDataLabels(spec, false)), withAxisTitles(spec, true)));
+        },
+    },
+];
+var applyChartQuickLayout = function (spec, layout) { return layout.apply(spec); };
+exports.applyChartQuickLayout = applyChartQuickLayout;

package/dist/cjs/utils/empty-cells.d.ts

@@ -0,0 +1,30 @@
+import type { EmbeddedChart } from "@rowsncolumns/spreadsheet";
+type ChartSpec = EmbeddedChart["spec"];
+export type EmptyCellsPolicy = NonNullable<ChartSpec["emptyCells"]>;
+type EmptyCellsSpec = Pick<ChartSpec, "emptyCells" | "showNaAsEmpty">;
+export declare const isChartErrorValue: (value: unknown) => boolean;
+/** Excel's default is a gap. */
+export declare const getEmptyCellsPolicy: (spec: EmptyCellsSpec) => EmptyCellsPolicy;
+/** Only a line-like series has a line to carry across the hole. */
+export declare const isLineLikeChartType: (chartType: ChartSpec["chartType"] | null | undefined) => boolean;
+/**
+ * "Connect data points with line" — the renderer bridges the gap
+ * (echarts `connectNulls`, plotly `connectgaps`).
+ */
+export declare const connectsAcrossEmptyCells: (spec: EmptyCellsSpec, lineLike: boolean) => boolean;
+/**
+ * Plot-ready values for one series under the chart's "Hidden and Empty
+ * Cells" settings. `values` are the sanitized numbers (blanks and errors
+ * already `undefined`), `rawValues` the cells as read, index-aligned, so
+ * a blank can be told from an error:
+ *
+ * - a blank follows `emptyCells`: `"zero"` plots 0, `"gaps"` and
+ *   `"connect"` leave `null` (the renderer's connect flag bridges it);
+ * - an error is a blank while `showNaAsEmpty` is on (Excel's default);
+ *   with it off a line-like series is drawn straight through the point
+ *   (linear interpolation between its numeric neighbours — Excel's
+ *   pre-2016 #N/A behaviour), and any other series leaves a gap.
+ */
+export declare const applyEmptyCellsPolicy: (values: readonly (number | null | undefined)[], rawValues: readonly unknown[], spec: EmptyCellsSpec, lineLike: boolean) => (number | null)[];
+export {};
+//# sourceMappingURL=empty-cells.d.ts.map

package/dist/cjs/utils/empty-cells.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"empty-cells.d.ts","sourceRoot":"","sources":["../../../utils/empty-cells.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE/D,KAAK,SAAS,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;AAEvC,MAAM,MAAM,gBAAgB,GAAG,WAAW,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC,CAAC;AAEpE,KAAK,cAAc,GAAG,IAAI,CAAC,SAAS,EAAE,YAAY,GAAG,eAAe,CAAC,CAAC;AAetE,eAAO,MAAM,iBAAiB,GAAI,OAAO,OAAO,KAAG,OACuB,CAAC;AAE3E,gCAAgC;AAChC,eAAO,MAAM,mBAAmB,GAAI,MAAM,cAAc,KAAG,gBAChC,CAAC;AAE5B,mEAAmE;AACnE,eAAO,MAAM,mBAAmB,GAC9B,WAAW,SAAS,CAAC,WAAW,CAAC,GAAG,IAAI,GAAG,SAAS,KACnD,OAAuD,CAAC;AAE3D;;;GAGG;AACH,eAAO,MAAM,wBAAwB,GACnC,MAAM,cAAc,EACpB,UAAU,OAAO,KAChB,OAA8D,CAAC;AAElE;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,qBAAqB,GAChC,QAAQ,SAAS,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,EAC9C,WAAW,SAAS,OAAO,EAAE,EAC7B,MAAM,cAAc,EACpB,UAAU,OAAO,KAChB,CAAC,MAAM,GAAG,IAAI,CAAC,EA4BjB,CAAC"}

package/dist/cjs/utils/empty-cells.js

@@ -0,0 +1,91 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.applyEmptyCellsPolicy = exports.connectsAcrossEmptyCells = exports.isLineLikeChartType = exports.getEmptyCellsPolicy = exports.isChartErrorValue = void 0;
+var tslib_1 = require("tslib");
+var CHART_ERROR_VALUES = new Set([
+    "#N/A",
+    "#VALUE!",
+    "#REF!",
+    "#DIV/0!",
+    "#NUM!",
+    "#NAME?",
+    "#NULL!",
+    "#SPILL!",
+    "#CALC!",
+    "#GETTING_DATA",
+]);
+var isChartErrorValue = function (value) {
+    return typeof value === "string" && CHART_ERROR_VALUES.has(value.toUpperCase());
+};
+exports.isChartErrorValue = isChartErrorValue;
+/** Excel's default is a gap. */
+var getEmptyCellsPolicy = function (spec) { var _a; return (_a = spec.emptyCells) !== null && _a !== void 0 ? _a : "gaps"; };
+exports.getEmptyCellsPolicy = getEmptyCellsPolicy;
+/** Only a line-like series has a line to carry across the hole. */
+var isLineLikeChartType = function (chartType) { return chartType === "line" || chartType === "area"; };
+exports.isLineLikeChartType = isLineLikeChartType;
+/**
+ * "Connect data points with line" — the renderer bridges the gap
+ * (echarts `connectNulls`, plotly `connectgaps`).
+ */
+var connectsAcrossEmptyCells = function (spec, lineLike) { return lineLike && (0, exports.getEmptyCellsPolicy)(spec) === "connect"; };
+exports.connectsAcrossEmptyCells = connectsAcrossEmptyCells;
+/**
+ * Plot-ready values for one series under the chart's "Hidden and Empty
+ * Cells" settings. `values` are the sanitized numbers (blanks and errors
+ * already `undefined`), `rawValues` the cells as read, index-aligned, so
+ * a blank can be told from an error:
+ *
+ * - a blank follows `emptyCells`: `"zero"` plots 0, `"gaps"` and
+ *   `"connect"` leave `null` (the renderer's connect flag bridges it);
+ * - an error is a blank while `showNaAsEmpty` is on (Excel's default);
+ *   with it off a line-like series is drawn straight through the point
+ *   (linear interpolation between its numeric neighbours — Excel's
+ *   pre-2016 #N/A behaviour), and any other series leaves a gap.
+ */
+var applyEmptyCellsPolicy = function (values, rawValues, spec, lineLike) {
+    var e_1, _a;
+    var policy = (0, exports.getEmptyCellsPolicy)(spec);
+    var naAsEmpty = spec.showNaAsEmpty !== false;
+    var plotted = values.map(function (value) {
+        return typeof value === "number" && Number.isFinite(value) ? value : null;
+    });
+    var legacyErrors = [];
+    for (var i = 0; i < plotted.length; i++) {
+        if (plotted[i] !== null)
+            continue;
+        if (!naAsEmpty && (0, exports.isChartErrorValue)(rawValues[i])) {
+            legacyErrors.push(i);
+            continue;
+        }
+        if (policy === "zero")
+            plotted[i] = 0;
+    }
+    if (lineLike) {
+        try {
+            for (var legacyErrors_1 = tslib_1.__values(legacyErrors), legacyErrors_1_1 = legacyErrors_1.next(); !legacyErrors_1_1.done; legacyErrors_1_1 = legacyErrors_1.next()) {
+                var i = legacyErrors_1_1.value;
+                var prev = i - 1;
+                while (prev >= 0 && plotted[prev] === null)
+                    prev--;
+                var next = i + 1;
+                while (next < plotted.length && plotted[next] === null)
+                    next++;
+                if (prev < 0 || next >= plotted.length)
+                    continue;
+                var a = plotted[prev];
+                var b = plotted[next];
+                plotted[i] = a + ((b - a) * (i - prev)) / (next - prev);
+            }
+        }
+        catch (e_1_1) { e_1 = { error: e_1_1 }; }
+        finally {
+            try {
+                if (legacyErrors_1_1 && !legacyErrors_1_1.done && (_a = legacyErrors_1.return)) _a.call(legacyErrors_1);
+            }
+            finally { if (e_1) throw e_1.error; }
+        }
+    }
+    return plotted;
+};
+exports.applyEmptyCellsPolicy = applyEmptyCellsPolicy;

package/dist/cjs/utils/overrides.d.ts

@@ -2,7 +2,12 @@ import type { LegendComponentOption } from "echarts";
 /** Build an echarts `textStyle` from a parsed `ChartTextFormat`. */
 export declare const textFormatToEchartsTextStyle: (fmt: any) => Record<string, any> | undefined;
 export declare const applyLegendOverrides: (legend: LegendComponentOption, opts: any) => LegendComponentOption;
-export declare const applyAxisOverrides: (axis: any, opts: any) => any;
+/**
+ * `numberFormatPattern` is the axis' RESOLVED format (explicit pattern or
+ * the linked source-cell format — see `resolveValueAxisNumberFormat`); it
+ * becomes the tick-label formatter.
+ */
+export declare const applyAxisOverrides: (axis: any, opts: any, numberFormatPattern?: string) => any;
 export declare const dataLabelFormatter: (opts: any) => (params: any) => string;
 export declare const buildSeriesLabelOption: (opts: any) => {
     readonly show: true;

package/dist/cjs/utils/overrides.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"overrides.d.ts","sourceRoot":"","sources":["../../../utils/overrides.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AASrD,oEAAoE;AACpE,eAAO,MAAM,4BAA4B,GAAI,KAAK,GAAG,oCASpD,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAC/B,QAAQ,qBAAqB,EAC7B,MAAM,GAAG,KACR,qBA6CF,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAAI,MAAM,GAAG,EAAE,MAAM,GAAG,QAsBtD,CAAC;AAqBF,eAAO,MAAM,kBAAkB,GAAI,MAAM,GAAG,MAAM,QAAQ,GAAG,WA4B5D,CAAC;AAWF,eAAO,MAAM,sBAAsB,GAAI,MAAM,GAAG;;;iCAvCU,GAAG;aA+C5D,CAAC"}
+{"version":3,"file":"overrides.d.ts","sourceRoot":"","sources":["../../../utils/overrides.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAWrD,oEAAoE;AACpE,eAAO,MAAM,4BAA4B,GAAI,KAAK,GAAG,oCASpD,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAC/B,QAAQ,qBAAqB,EAC7B,MAAM,GAAG,KACR,qBA6CF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,GAC7B,MAAM,GAAG,EACT,MAAM,GAAG,EACT,sBAAsB,MAAM,QA4B7B,CAAC;AAqBF,eAAO,MAAM,kBAAkB,GAAI,MAAM,GAAG,MAAM,QAAQ,GAAG,WA4B5D,CAAC;AAWF,eAAO,MAAM,sBAAsB,GAAI,MAAM,GAAG;;;iCAvCU,GAAG;aA+C5D,CAAC"}

package/dist/cjs/utils/overrides.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.buildSeriesLabelOption = exports.dataLabelFormatter = exports.applyAxisOverrides = exports.applyLegendOverrides = exports.textFormatToEchartsTextStyle = void 0;
 var tslib_1 = require("tslib");
 var utils_1 = require("@rowsncolumns/utils");
+var axis_number_format_1 = require("./axis-number-format");
 // Map ChartSpec.legend / dataLabels / axisOptions to ECharts option
 // fragments. Each helper is a no-op when the spec field is missing, so
 // callers can spread the result without checks. Shared by the main
@@ -76,11 +77,22 @@ var applyLegendOverrides = function (legend, opts) {
     return next;
 };
 exports.applyLegendOverrides = applyLegendOverrides;
-var applyAxisOverrides = function (axis, opts) {
-    var _a, _b, _c, _d;
-    if (!opts)
+/**
+ * `numberFormatPattern` is the axis' RESOLVED format (explicit pattern or
+ * the linked source-cell format — see `resolveValueAxisNumberFormat`); it
+ * becomes the tick-label formatter.
+ */
+var applyAxisOverrides = function (axis, opts, numberFormatPattern) {
+    var _a, _b, _c, _d, _e;
+    var formatter = (0, axis_number_format_1.valueAxisLabelFormatter)(numberFormatPattern);
+    if (!opts && !formatter)
         return axis;
     var next = tslib_1.__assign({}, axis);
+    if (formatter) {
+        next.axisLabel = tslib_1.__assign(tslib_1.__assign({}, ((_a = next.axisLabel) !== null && _a !== void 0 ? _a : {})), { formatter: formatter });
+    }
+    if (!opts)
+        return next;
     if (opts.logarithmic)
         next.type = "log";
     if (opts.reverse)
@@ -92,17 +104,17 @@ var applyAxisOverrides = function (axis, opts) {
     if (opts.visible === false)
         next.show = false;
     if (opts.showMajorGridlines === false) {
-        next.splitLine = tslib_1.__assign(tslib_1.__assign({}, ((_a = next.splitLine) !== null && _a !== void 0 ? _a : {})), { show: false });
+        next.splitLine = tslib_1.__assign(tslib_1.__assign({}, ((_b = next.splitLine) !== null && _b !== void 0 ? _b : {})), { show: false });
     }
     if (opts.showMajorGridlines === true) {
-        next.splitLine = tslib_1.__assign(tslib_1.__assign({}, ((_b = next.splitLine) !== null && _b !== void 0 ? _b : {})), { show: true });
+        next.splitLine = tslib_1.__assign(tslib_1.__assign({}, ((_c = next.splitLine) !== null && _c !== void 0 ? _c : {})), { show: true });
     }
     // Axis label text style (tick labels) + axis title font come from
     // <c:txPr>. Without this echarts uses its default (~black on light).
     var axisTextStyle = (0, exports.textFormatToEchartsTextStyle)(opts.textFormat);
     if (axisTextStyle) {
-        next.axisLabel = tslib_1.__assign(tslib_1.__assign({}, ((_c = next.axisLabel) !== null && _c !== void 0 ? _c : {})), axisTextStyle);
-        next.nameTextStyle = tslib_1.__assign(tslib_1.__assign({}, ((_d = next.nameTextStyle) !== null && _d !== void 0 ? _d : {})), axisTextStyle);
+        next.axisLabel = tslib_1.__assign(tslib_1.__assign({}, ((_d = next.axisLabel) !== null && _d !== void 0 ? _d : {})), axisTextStyle);
+        next.nameTextStyle = tslib_1.__assign(tslib_1.__assign({}, ((_e = next.nameTextStyle) !== null && _e !== void 0 ? _e : {})), axisTextStyle);
     }
     return next;
 };

package/dist/cjs/utils/pie-explosion.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Exploded pie / doughnut (rowsncolumns/spreadsheet#668 C-32). Excel stores
+ * the explosion as a percentage of the pie radius (`<c:explosion val="25"/>`,
+ * 25 being the gallery default); each slice moves outward along its own
+ * bisector by that much. Both renderers resolve the spec value here.
+ */
+/** Excel's gallery "Exploded Pie" / "Exploded Doughnut" explosion. */
+export declare const DEFAULT_PIE_EXPLOSION = 25;
+/**
+ * The explosion percentage a spec asks for, `0` when the slices touch
+ * (absent, non-numeric, negative or `0`).
+ */
+export declare const resolveExplosion: (spec: {
+    explosion?: number | null;
+} | null | undefined) => number;
+/**
+ * The outer radius of a pie in pixels for the container it renders in:
+ * echarts' `radius` is a percentage of half the shorter side (default
+ * `"75%"`) or an absolute pixel count.
+ */
+export declare const pieRadiusPx: (radius: (string | number)[] | null | undefined, width: number, height: number) => number;
+/**
+ * echarts has no slice offset of its own; the exploded look is its
+ * `select` state (`selectedOffset`, in pixels) with every slice selected.
+ * The percentage is of the pie radius, so the offset scales with it.
+ */
+export declare const explosionOffsetPx: (explosion: number, radiusPx: number) => number;
+/** plotly pie `pull` — a fraction of the radius. */
+export declare const explosionToPlotlyPull: (explosion: number) => number | undefined;
+//# sourceMappingURL=pie-explosion.d.ts.map

package/dist/cjs/utils/pie-explosion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pie-explosion.d.ts","sourceRoot":"","sources":["../../../utils/pie-explosion.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,sEAAsE;AACtE,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAKxC;;;GAGG;AACH,eAAO,MAAM,gBAAgB,GAC3B,MAAM;IAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAAG,IAAI,GAAG,SAAS,KACrD,MAIF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,WAAW,GACtB,QAAQ,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GAAG,IAAI,GAAG,SAAS,EAC9C,OAAO,MAAM,EACb,QAAQ,MAAM,KACb,MAOF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,GAAI,WAAW,MAAM,EAAE,UAAU,MAAM,WAC3B,CAAC;AAE3C,oDAAoD;AACpD,eAAO,MAAM,qBAAqB,GAAI,WAAW,MAAM,uBACG,CAAC"}

package/dist/cjs/utils/pie-explosion.js

@@ -0,0 +1,55 @@
+"use strict";
+/**
+ * Exploded pie / doughnut (rowsncolumns/spreadsheet#668 C-32). Excel stores
+ * the explosion as a percentage of the pie radius (`<c:explosion val="25"/>`,
+ * 25 being the gallery default); each slice moves outward along its own
+ * bisector by that much. Both renderers resolve the spec value here.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.explosionToPlotlyPull = exports.explosionOffsetPx = exports.pieRadiusPx = exports.resolveExplosion = exports.DEFAULT_PIE_EXPLOSION = void 0;
+/** Excel's gallery "Exploded Pie" / "Exploded Doughnut" explosion. */
+exports.DEFAULT_PIE_EXPLOSION = 25;
+/** OOXML `CT_UnsignedInt` explosion — Excel's dialog caps it at 400%. */
+var MAX_PIE_EXPLOSION = 400;
+/**
+ * The explosion percentage a spec asks for, `0` when the slices touch
+ * (absent, non-numeric, negative or `0`).
+ */
+var resolveExplosion = function (spec) {
+    var explosion = spec === null || spec === void 0 ? void 0 : spec.explosion;
+    if (typeof explosion !== "number" || !Number.isFinite(explosion))
+        return 0;
+    return Math.min(MAX_PIE_EXPLOSION, Math.max(0, explosion));
+};
+exports.resolveExplosion = resolveExplosion;
+/**
+ * The outer radius of a pie in pixels for the container it renders in:
+ * echarts' `radius` is a percentage of half the shorter side (default
+ * `"75%"`) or an absolute pixel count.
+ */
+var pieRadiusPx = function (radius, width, height) {
+    var _a;
+    var half = Math.max(0, Math.min(width, height)) / 2;
+    var outer = (_a = radius === null || radius === void 0 ? void 0 : radius[radius.length - 1]) !== null && _a !== void 0 ? _a : "75%";
+    if (typeof outer === "number")
+        return Math.max(0, outer);
+    var parsed = Number.parseFloat(outer);
+    if (!Number.isFinite(parsed))
+        return half * 0.75;
+    return outer.trim().endsWith("%") ? (half * parsed) / 100 : parsed;
+};
+exports.pieRadiusPx = pieRadiusPx;
+/**
+ * echarts has no slice offset of its own; the exploded look is its
+ * `select` state (`selectedOffset`, in pixels) with every slice selected.
+ * The percentage is of the pie radius, so the offset scales with it.
+ */
+var explosionOffsetPx = function (explosion, radiusPx) {
+    return Math.round((radiusPx * explosion) / 100);
+};
+exports.explosionOffsetPx = explosionOffsetPx;
+/** plotly pie `pull` — a fraction of the radius. */
+var explosionToPlotlyPull = function (explosion) {
+    return explosion > 0 ? Math.min(1, explosion / 100) : undefined;
+};
+exports.explosionToPlotlyPull = explosionToPlotlyPull;

package/dist/cjs/utils/plotly-click.d.ts

@@ -0,0 +1,34 @@
+/**
+ * plotly click → chart selection (rowsncolumns/spreadsheet#668 C-37 / C-38).
+ *
+ * The plotly renderer is interactive with `layout.dragmode: false`: plotly
+ * reports `plotly_click` but never starts a drag, so a body drag reaches
+ * the embed's move handler instead. plotly does not track that drag either
+ * and treats the mouseup as a click, so the caller compares the click's
+ * pointer position with where the pointer went down.
+ */
+/** Pointer travel (px) beyond which a mouseup is a drag, not a click. */
+export declare const CLICK_DRAG_TOLERANCE_PX = 3;
+export declare const wasDragged: (pointerDown: {
+    x: number;
+    y: number;
+} | undefined, clickEvent: {
+    clientX?: number;
+    clientY?: number;
+} | undefined) => boolean;
+export type PlotlyClickPoint = {
+    curveNumber: number;
+    /** Index of the clicked point within its trace (a category index). */
+    pointNumber?: number;
+    data?: unknown;
+};
+/**
+ * The `spec.series` entry (and data point) a plotly click lands on. Traces
+ * tagged with `meta.rncSeriesIndex` resolve through the tag; untagged ones
+ * map by curve position while it fits; anything else is not a series.
+ */
+export declare const resolvePlotlyClickSelection: (points: ReadonlyArray<PlotlyClickPoint> | undefined, seriesCount: number) => {
+    seriesIndex: number;
+    dataIndex?: number;
+} | undefined;
+//# sourceMappingURL=plotly-click.d.ts.map

package/dist/cjs/utils/plotly-click.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plotly-click.d.ts","sourceRoot":"","sources":["../../../utils/plotly-click.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,yEAAyE;AACzE,eAAO,MAAM,uBAAuB,IAAI,CAAC;AAEzC,eAAO,MAAM,UAAU,GACrB,aAAa;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,EACjD,YAAY;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,KAC7D,OAQF,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,sEAAsE;IACtE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,GACtC,QAAQ,aAAa,CAAC,gBAAgB,CAAC,GAAG,SAAS,EACnD,aAAa,MAAM,KAClB;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAkBhD,CAAC"}