@rowsncolumns/charts 27.0.34 → 28.1.0

package/dist/cjs/plotly/basic-chart/helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../../plotly/basic-chart/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE/D,eAAO,MAAM,qBAAqB,GAChC,MAAM,aAAa,CAAC,MAAM,CAAC,CAAC,WAAW,CAAC,KACvC,MA+DF,CAAC;AAEF,eAAO,MAAM,mBAAmB,GAC9B,MAAM,aAAa,CAAC,MAAM,CAAC,CAAC,WAAW,CAAC;;;;;;;;;CAgBzC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,GAClC,QAAQ,MAAM,GAAG,SAAS,GAAG,IAAI,KAChC,MAAM,GAAG,SA0BX,CAAC;AAEF,eAAO,MAAM,SAAS,GAAI,MAAM,aAAa,CAAC,MAAM,CAAC,CAAC,WAAW,CAAC,YAejE,CAAC"}
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../../plotly/basic-chart/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE/D,eAAO,MAAM,qBAAqB,GAChC,MAAM,aAAa,CAAC,MAAM,CAAC,CAAC,WAAW,CAAC,KACvC,MAmEF,CAAC;AAEF,eAAO,MAAM,mBAAmB,GAC9B,MAAM,aAAa,CAAC,MAAM,CAAC,CAAC,WAAW,CAAC;;;;;;;;;CAgBzC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,GAClC,QAAQ,MAAM,GAAG,SAAS,GAAG,IAAI,KAChC,MAAM,GAAG,SA0BX,CAAC;AAEF,eAAO,MAAM,SAAS,GAAI,MAAM,aAAa,CAAC,MAAM,CAAC,CAAC,WAAW,CAAC,YAejE,CAAC"}

package/dist/cjs/plotly/basic-chart/helpers.js

@@ -13,6 +13,9 @@ var chartTypeToPlotlyType = function (type) {
             return "bar";
         case "pie":
             return "pie";
+        // Doughnut is a pie trace with `hole` set (see basic-chart.tsx).
+        case "doughnut":
+            return "pie";
         case "treemap":
             return "treemap";
         case "sunburst":

package/dist/cjs/tsconfig.cjs.tsbuildinfo

@@ -1 +1 @@
-{"root":["../../config.ts","../../echarts-gl.d.ts","../../geo-modules.d.ts","../../index.ts","../../types.ts","../../vitest.config.ts","../../atoms/editing-chart.atom.ts","../../basic-chart/basic-chart.tsx","../../basic-chart/helpers.ts","../../basic-chart/index.tsx","../../components/dialogs/chart-editor-dialog.tsx","../../components/editors/chart-editor.tsx","../../components/editors/chart-range-input.tsx","../../hooks/use-chart-editor.ts","../../hooks/use-charts.ts","../../hooks/use-on-create-chart.ts","../../hooks/use-on-delete-chart.ts","../../hooks/use-on-move-chart.ts","../../hooks/use-on-resize-chart.ts","../../hooks/use-on-update-chart.ts","../../interface/create-chart.ts","../../interface/delete-chart.ts","../../interface/move-chart.ts","../../interface/resize-chart.ts","../../interface/shift-chart-ranges.ts","../../interface/update-chart.ts","../../plotly/basic-chart/basic-chart.tsx","../../plotly/basic-chart/helpers.ts","../../plotly/basic-chart/index.tsx","../../utils/aggregation.ts","../../utils/bar-layout.ts","../../utils/boxplot.ts","../../utils/bubble.ts","../../utils/chart-spec-utils.ts","../../utils/echarts-gl-loader.ts","../../utils/error-bars.ts","../../utils/gradient.ts","../../utils/hierarchy.ts","../../utils/histogram.ts","../../utils/of-pie.ts","../../utils/overrides.ts","../../utils/radar.ts","../../utils/region-map-loader.ts","../../utils/region-map.ts","../../utils/stock.ts","../../utils/three-d.ts","../../utils/trendline.ts","../../utils/waterfall.ts","../../utils/webgl.ts"],"version":"5.8.3"}
+{"root":["../../config.ts","../../echarts-gl.d.ts","../../geo-modules.d.ts","../../index.ts","../../plotly-dist.d.ts","../../types.ts","../../vitest.config.ts","../../atoms/editing-chart.atom.ts","../../atoms/pivot-chart.atom.ts","../../basic-chart/basic-chart.tsx","../../basic-chart/helpers.ts","../../basic-chart/index.tsx","../../components/dialogs/chart-editor-dialog.tsx","../../components/dialogs/pivot-chart-dialog.tsx","../../components/editors/chart-editor.tsx","../../components/editors/chart-range-input.tsx","../../hooks/use-chart-editor.ts","../../hooks/use-charts.ts","../../hooks/use-on-create-chart.ts","../../hooks/use-on-delete-chart.ts","../../hooks/use-on-move-chart-to-sheet.ts","../../hooks/use-on-move-chart.ts","../../hooks/use-on-resize-chart.ts","../../hooks/use-on-update-chart.ts","../../interface/create-chart.ts","../../interface/delete-chart.ts","../../interface/move-chart-to-sheet.ts","../../interface/move-chart.ts","../../interface/resize-chart.ts","../../interface/shift-chart-ranges.ts","../../interface/update-chart.ts","../../plotly/basic-chart/basic-chart.tsx","../../plotly/basic-chart/helpers.ts","../../plotly/basic-chart/index.tsx","../../utils/aggregation.ts","../../utils/axis-number-format.ts","../../utils/bar-layout.ts","../../utils/boxplot.ts","../../utils/bubble.ts","../../utils/category-levels.ts","../../utils/chart-image.ts","../../utils/chart-orientation.ts","../../utils/chart-spec-utils.ts","../../utils/chart-styles.ts","../../utils/echarts-gl-loader.ts","../../utils/empty-cells.ts","../../utils/error-bars.ts","../../utils/gradient.ts","../../utils/hierarchy.ts","../../utils/histogram.ts","../../utils/of-pie.ts","../../utils/overrides.ts","../../utils/pie-explosion.ts","../../utils/plotly-click.ts","../../utils/plotly-surface.ts","../../utils/plotly-title.ts","../../utils/radar.ts","../../utils/region-map-loader.ts","../../utils/region-map.ts","../../utils/series-click.ts","../../utils/stock.ts","../../utils/three-d.ts","../../utils/trendline.ts","../../utils/waterfall.ts","../../utils/webgl.ts"],"version":"5.8.3"}

package/dist/cjs/types.d.ts

@@ -14,6 +14,13 @@ export type EChartComponentProps = ChartComponentProps & {
      * Get all effective values from a series
      */
     getSeriesValuesFromRange: ReturnType<typeof useSpreadsheetState>["getSeriesValuesFromRange"];
+    /**
+     * Get the effective cell formats of a range. Feeds Excel's "Linked to
+     * source" number format for value-axis tick labels, data labels and
+     * tooltips. Without it only an explicit axis `numberFormatPattern` is
+     * honored.
+     */
+    getFormattingFromRange?: ReturnType<typeof useSpreadsheetState>["getFormattingFromRange"];
     /**
      * Request edit chart
      * @param chart

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,aAAa,EACd,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAE3E,MAAM,MAAM,oBAAoB,GAAG,mBAAmB,GAAG;IACvD;;OAEG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;OAEG;IACH,wBAAwB,EAAE,UAAU,CAClC,OAAO,mBAAmB,CAC3B,CAAC,0BAA0B,CAAC,CAAC;IAC9B;;OAEG;IACH,wBAAwB,EAAE,UAAU,CAClC,OAAO,mBAAmB,CAC3B,CAAC,0BAA0B,CAAC,CAAC;IAC9B;;;OAGG;IACH,aAAa,CAAC,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,CAAC;IAC3C;;OAEG;IACH,kBAAkB,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,oBAAoB,CAAC,CAAC;CAC7E,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,aAAa,EACd,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAE3E,MAAM,MAAM,oBAAoB,GAAG,mBAAmB,GAAG;IACvD;;OAEG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;OAEG;IACH,wBAAwB,EAAE,UAAU,CAClC,OAAO,mBAAmB,CAC3B,CAAC,0BAA0B,CAAC,CAAC;IAC9B;;OAEG;IACH,wBAAwB,EAAE,UAAU,CAClC,OAAO,mBAAmB,CAC3B,CAAC,0BAA0B,CAAC,CAAC;IAC9B;;;;;OAKG;IACH,sBAAsB,CAAC,EAAE,UAAU,CACjC,OAAO,mBAAmB,CAC3B,CAAC,wBAAwB,CAAC,CAAC;IAC5B;;;OAGG;IACH,aAAa,CAAC,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,CAAC;IAC3C;;OAEG;IACH,kBAAkB,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,oBAAoB,CAAC,CAAC;CAC7E,CAAC"}

package/dist/cjs/utils/axis-number-format.d.ts

@@ -0,0 +1,69 @@
+import type { ChartData, HIDDEN_DIMENSION_STRATEGY, Maybe, SheetRange } from "@rowsncolumns/spreadsheet";
+type RangeFormatReader = (sheetRange: SheetRange, hiddenDimensionStrategy?: HIDDEN_DIMENSION_STRATEGY) => unknown[];
+/**
+ * `General` (or nothing) means "let the renderer pick" — it carries no
+ * formatting. So does the bare-`#` shape the engines infer when a plain
+ * number is typed (`#`, `#.0`): Excel leaves such cells General, and `#`
+ * would blank every fractional tick below 0.5.
+ */
+export declare const isGeneralNumberFormat: (pattern: Maybe<string> | undefined) => boolean;
+/**
+ * The number format of a series' source cells — the first formatted cell of
+ * its first source range, matching Excel which links the axis to the first
+ * series' cell format.
+ */
+export declare const resolveSourceNumberFormat: (sources: SheetRange[] | undefined, getFormattingFromRange: RangeFormatReader | undefined, hiddenDimensionStrategy?: HIDDEN_DIMENSION_STRATEGY | null) => string | undefined;
+/**
+ * Effective number format of one value axis: the axis' explicit
+ * `numberFormatPattern` wins, else the format of the first series bound to
+ * that axis ("Linked to source"), else `undefined` (renderer default).
+ */
+export declare const resolveValueAxisNumberFormat: ({ axisOptions, series, getFormattingFromRange, hiddenDimensionStrategy, }: {
+    axisOptions: Maybe<{
+        numberFormatPattern?: Maybe<string>;
+    }> | undefined;
+    series: Pick<ChartData, "sources">[];
+    getFormattingFromRange: RangeFormatReader | undefined;
+    hiddenDimensionStrategy?: HIDDEN_DIMENSION_STRATEGY | null;
+}) => string | undefined;
+/** Format one numeric value through the resolved pattern; non-numbers pass through. */
+export declare const formatAxisValue: (pattern: string | undefined, value: unknown) => string;
+/** echarts `axisLabel.formatter` / `tooltip.valueFormatter` for a value axis. */
+export declare const valueAxisLabelFormatter: (pattern: string | undefined) => ((value: unknown) => string) | undefined;
+/**
+ * echarts `tooltip.valueFormatter` for a series whose data items are
+ * tuples (candlestick, 3-D points): every number formats through the
+ * pattern; `undefined` when there is no pattern so echarts keeps its
+ * default.
+ */
+export declare const tooltipValueFormatter: (pattern: string | undefined) => ((value: unknown) => string | string[]) | undefined;
+/**
+ * Excel's data labels and tooltips are linked to *each series' own* source
+ * cells, not to the axis: a revenue series formatted `$#,##0` next to a
+ * margin series formatted `0.0%` labels each with its own pattern. One
+ * entry per `spec.series`, `undefined` where the cells are General.
+ */
+export declare const resolveSeriesNumberFormats: (series: Pick<ChartData, "sources">[] | undefined, getFormattingFromRange: RangeFormatReader | undefined, hiddenDimensionStrategy?: HIDDEN_DIMENSION_STRATEGY | null) => (string | undefined)[];
+/** echarts pie / doughnut tooltip: `name: value (percent%)` with the value formatted. */
+export declare const circularTooltipFormatter: (pattern: string | undefined) => (params: {
+    name?: string;
+    value?: unknown;
+    percent?: number;
+}) => string;
+export type PlotlyTickFormat = {
+    tickformat?: string;
+    tickprefix?: string;
+    ticksuffix?: string;
+};
+/**
+ * Translate the numeric subset of a SpreadsheetML pattern into plotly's
+ * d3-format axis settings (`tickformat` + literal prefix / suffix). Plotly
+ * has no per-tick callback, so only patterns made of digit placeholders,
+ * grouping, decimals, `%` and quoted / currency literals convert; anything
+ * else (dates, fractions, scientific, text sections) returns `undefined`
+ * and the axis keeps plotly's default labels. Only the first (positive)
+ * section is used — plotly applies one format to every tick.
+ */
+export declare const numberFormatToPlotlyTicks: (pattern: string | undefined) => PlotlyTickFormat | undefined;
+export {};
+//# sourceMappingURL=axis-number-format.d.ts.map

package/dist/cjs/utils/axis-number-format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"axis-number-format.d.ts","sourceRoot":"","sources":["../../../utils/axis-number-format.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,yBAAyB,EACzB,KAAK,EACL,UAAU,EACX,MAAM,2BAA2B,CAAC;AAWnC,KAAK,iBAAiB,GAAG,CACvB,UAAU,EAAE,UAAU,EACtB,uBAAuB,CAAC,EAAE,yBAAyB,KAChD,OAAO,EAAE,CAAC;AAMf;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,GAAI,SAAS,KAAK,CAAC,MAAM,CAAC,GAAG,SAAS,YAGjC,CAAC;AAExC;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,GACpC,SAAS,UAAU,EAAE,GAAG,SAAS,EACjC,wBAAwB,iBAAiB,GAAG,SAAS,EACrD,0BAA0B,yBAAyB,GAAG,IAAI,KACzD,MAAM,GAAG,SAWX,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,4BAA4B,GAAI,2EAK1C;IACD,WAAW,EAAE,KAAK,CAAC;QAAE,mBAAmB,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;KAAE,CAAC,GAAG,SAAS,CAAC;IACxE,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,EAAE,CAAC;IACrC,sBAAsB,EAAE,iBAAiB,GAAG,SAAS,CAAC;IACtD,uBAAuB,CAAC,EAAE,yBAAyB,GAAG,IAAI,CAAC;CAC5D,KAAG,MAAM,GAAG,SAQZ,CAAC;AAEF,uFAAuF;AACvF,eAAO,MAAM,eAAe,GAC1B,SAAS,MAAM,GAAG,SAAS,EAC3B,OAAO,OAAO,KACb,MAIF,CAAC;AAEF,iFAAiF;AACjF,eAAO,MAAM,uBAAuB,GAAI,SAAS,MAAM,GAAG,SAAS,cAC/C,OAAO,wBAAgD,CAAC;AAE5E;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,GAAI,SAAS,MAAM,GAAG,SAAS,cAEnD,OAAO,mCAIN,CAAC;AAEhB;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B,GACrC,QAAQ,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,EAAE,GAAG,SAAS,EAChD,wBAAwB,iBAAiB,GAAG,SAAS,EACrD,0BAA0B,yBAAyB,GAAG,IAAI,KACzD,CAAC,MAAM,GAAG,SAAS,CAAC,EAOpB,CAAC;AAEJ,yFAAyF;AACzF,eAAO,MAAM,wBAAwB,GAClC,SAAS,MAAM,GAAG,SAAS,MAC3B,QAAQ;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,WAGvD,CAAC;AAET,MAAM,MAAM,gBAAgB,GAAG;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,yBAAyB,GACpC,SAAS,MAAM,GAAG,SAAS,KAC1B,gBAAgB,GAAG,SA4DrB,CAAC"}

package/dist/cjs/utils/axis-number-format.js

@@ -0,0 +1,217 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.numberFormatToPlotlyTicks = exports.circularTooltipFormatter = exports.resolveSeriesNumberFormats = exports.tooltipValueFormatter = exports.valueAxisLabelFormatter = exports.formatAxisValue = exports.resolveValueAxisNumberFormat = exports.resolveSourceNumberFormat = exports.isGeneralNumberFormat = void 0;
+var tslib_1 = require("tslib");
+var utils_1 = require("@rowsncolumns/utils");
+var patternOf = function (format) {
+    var _a;
+    return (_a = format === null || format === void 0 ? void 0 : format.numberFormat) === null || _a === void 0 ? void 0 : _a.pattern;
+};
+/**
+ * `General` (or nothing) means "let the renderer pick" — it carries no
+ * formatting. So does the bare-`#` shape the engines infer when a plain
+ * number is typed (`#`, `#.0`): Excel leaves such cells General, and `#`
+ * would blank every fractional tick below 0.5.
+ */
+var isGeneralNumberFormat = function (pattern) {
+    return !pattern ||
+        pattern.trim().toLowerCase() === "general" ||
+        /^#+(\.[#0]*)?$/.test(pattern.trim());
+};
+exports.isGeneralNumberFormat = isGeneralNumberFormat;
+/**
+ * The number format of a series' source cells — the first formatted cell of
+ * its first source range, matching Excel which links the axis to the first
+ * series' cell format.
+ */
+var resolveSourceNumberFormat = function (sources, getFormattingFromRange, hiddenDimensionStrategy) {
+    var e_1, _a;
+    var _b;
+    var source = sources === null || sources === void 0 ? void 0 : sources[0];
+    if (!source || !getFormattingFromRange)
+        return undefined;
+    try {
+        for (var _c = tslib_1.__values((_b = getFormattingFromRange(source, hiddenDimensionStrategy !== null && hiddenDimensionStrategy !== void 0 ? hiddenDimensionStrategy : undefined)) !== null && _b !== void 0 ? _b : []), _d = _c.next(); !_d.done; _d = _c.next()) {
+            var format = _d.value;
+            var pattern = patternOf(format);
+            if (!(0, exports.isGeneralNumberFormat)(pattern))
+                return pattern !== null && pattern !== void 0 ? pattern : undefined;
+        }
+    }
+    catch (e_1_1) { e_1 = { error: e_1_1 }; }
+    finally {
+        try {
+            if (_d && !_d.done && (_a = _c.return)) _a.call(_c);
+        }
+        finally { if (e_1) throw e_1.error; }
+    }
+    return undefined;
+};
+exports.resolveSourceNumberFormat = resolveSourceNumberFormat;
+/**
+ * Effective number format of one value axis: the axis' explicit
+ * `numberFormatPattern` wins, else the format of the first series bound to
+ * that axis ("Linked to source"), else `undefined` (renderer default).
+ */
+var resolveValueAxisNumberFormat = function (_a) {
+    var _b;
+    var axisOptions = _a.axisOptions, series = _a.series, getFormattingFromRange = _a.getFormattingFromRange, hiddenDimensionStrategy = _a.hiddenDimensionStrategy;
+    var explicit = axisOptions === null || axisOptions === void 0 ? void 0 : axisOptions.numberFormatPattern;
+    if (explicit)
+        return (0, exports.isGeneralNumberFormat)(explicit) ? undefined : explicit;
+    return (0, exports.resolveSourceNumberFormat)((_b = series[0]) === null || _b === void 0 ? void 0 : _b.sources, getFormattingFromRange, hiddenDimensionStrategy);
+};
+exports.resolveValueAxisNumberFormat = resolveValueAxisNumberFormat;
+/** Format one numeric value through the resolved pattern; non-numbers pass through. */
+var formatAxisValue = function (pattern, value) {
+    if (value === undefined || value === null)
+        return "";
+    if (pattern && typeof value === "number")
+        return (0, utils_1.ssfFormat)(pattern, value);
+    return String(value);
+};
+exports.formatAxisValue = formatAxisValue;
+/** echarts `axisLabel.formatter` / `tooltip.valueFormatter` for a value axis. */
+var valueAxisLabelFormatter = function (pattern) {
+    return pattern ? function (value) { return (0, exports.formatAxisValue)(pattern, value); } : undefined;
+};
+exports.valueAxisLabelFormatter = valueAxisLabelFormatter;
+/**
+ * echarts `tooltip.valueFormatter` for a series whose data items are
+ * tuples (candlestick, 3-D points): every number formats through the
+ * pattern; `undefined` when there is no pattern so echarts keeps its
+ * default.
+ */
+var tooltipValueFormatter = function (pattern) {
+    return pattern
+        ? function (value) {
+            return Array.isArray(value)
+                ? value.map(function (entry) { return (0, exports.formatAxisValue)(pattern, entry); })
+                : (0, exports.formatAxisValue)(pattern, value);
+        }
+        : undefined;
+};
+exports.tooltipValueFormatter = tooltipValueFormatter;
+/**
+ * Excel's data labels and tooltips are linked to *each series' own* source
+ * cells, not to the axis: a revenue series formatted `$#,##0` next to a
+ * margin series formatted `0.0%` labels each with its own pattern. One
+ * entry per `spec.series`, `undefined` where the cells are General.
+ */
+var resolveSeriesNumberFormats = function (series, getFormattingFromRange, hiddenDimensionStrategy) {
+    return (series !== null && series !== void 0 ? series : []).map(function (entry) {
+        return (0, exports.resolveSourceNumberFormat)(entry === null || entry === void 0 ? void 0 : entry.sources, getFormattingFromRange, hiddenDimensionStrategy);
+    });
+};
+exports.resolveSeriesNumberFormats = resolveSeriesNumberFormats;
+/** echarts pie / doughnut tooltip: `name: value (percent%)` with the value formatted. */
+var circularTooltipFormatter = function (pattern) {
+    return function (params) {
+        var _a, _b;
+        return "".concat((_a = params.name) !== null && _a !== void 0 ? _a : "", ": ").concat((0, exports.formatAxisValue)(pattern, params.value), " (").concat((_b = params.percent) !== null && _b !== void 0 ? _b : "", "%)");
+    };
+};
+exports.circularTooltipFormatter = circularTooltipFormatter;
+/**
+ * Translate the numeric subset of a SpreadsheetML pattern into plotly's
+ * d3-format axis settings (`tickformat` + literal prefix / suffix). Plotly
+ * has no per-tick callback, so only patterns made of digit placeholders,
+ * grouping, decimals, `%` and quoted / currency literals convert; anything
+ * else (dates, fractions, scientific, text sections) returns `undefined`
+ * and the axis keeps plotly's default labels. Only the first (positive)
+ * section is used — plotly applies one format to every tick.
+ */
+var numberFormatToPlotlyTicks = function (pattern) {
+    var _a;
+    if ((0, exports.isGeneralNumberFormat)(pattern))
+        return undefined;
+    var section = firstSection(pattern);
+    var prefix = "";
+    var suffix = "";
+    var digits = "";
+    var percent = false;
+    var seenDigit = false;
+    for (var i = 0; i < section.length; i++) {
+        var ch = section[i];
+        var literal = function (text) {
+            if (seenDigit)
+                suffix += text;
+            else
+                prefix += text;
+        };
+        if (ch === '"') {
+            var end = section.indexOf('"', i + 1);
+            if (end === -1)
+                return undefined;
+            literal(section.slice(i + 1, end));
+            i = end;
+        }
+        else if (ch === "\\") {
+            literal((_a = section[i + 1]) !== null && _a !== void 0 ? _a : "");
+            i += 1;
+        }
+        else if (ch === "[") {
+            var end = section.indexOf("]", i + 1);
+            if (end === -1)
+                return undefined;
+            var token = section.slice(i + 1, end);
+            // `[$€-407]` locale currency → the symbol; color / condition tokens
+            // carry no text.
+            if (token.startsWith("$")) {
+                var dash = token.indexOf("-");
+                literal(dash === -1 ? token.slice(1) : token.slice(1, dash));
+            }
+            i = end;
+        }
+        else if (ch === "_") {
+            literal(" ");
+            i += 1;
+        }
+        else if (ch === "*") {
+            i += 1;
+        }
+        else if (ch === "#" || ch === "0" || ch === "," || ch === ".") {
+            if (seenDigit && suffix)
+                return undefined;
+            seenDigit = true;
+            digits += ch;
+        }
+        else if (ch === "%") {
+            if (!seenDigit)
+                return undefined;
+            percent = true;
+        }
+        else if ("$€£¥₹ -+()/:".includes(ch)) {
+            literal(ch);
+        }
+        else {
+            return undefined;
+        }
+    }
+    if (!seenDigit)
+        return undefined;
+    var _b = tslib_1.__read(digits.split("."), 2), _c = _b[1], fraction = _c === void 0 ? "" : _c;
+    var grouping = digits.includes(",") ? "," : "";
+    var decimals = fraction.replace(/[^0#]/g, "").length;
+    var tickformat = "".concat(grouping, ".").concat(decimals).concat(percent ? "%" : "f");
+    var result = { tickformat: tickformat };
+    if (prefix)
+        result.tickprefix = prefix;
+    if (suffix)
+        result.ticksuffix = suffix;
+    return result;
+};
+exports.numberFormatToPlotlyTicks = numberFormatToPlotlyTicks;
+var firstSection = function (pattern) {
+    var quoted = false;
+    for (var i = 0; i < pattern.length; i++) {
+        var ch = pattern[i];
+        if (ch === '"')
+            quoted = !quoted;
+        else if (ch === "\\")
+            i += 1;
+        else if (ch === ";" && !quoted)
+            return pattern.slice(0, i);
+    }
+    return pattern;
+};

package/dist/cjs/utils/category-levels.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Hierarchical (multi-level) category axes — what Excel draws for a PivotChart
+ * over nested row fields: the leaf items along the axis with their parent
+ * labels grouped underneath. `ChartSpec.categoryLevels` carries the levels
+ * outermost first, the last one being the plotted categories.
+ */
+export type CategoryLevels = {
+    /** Outer levels, outermost first; each aligned to `leaf` (a parent label repeats per leaf). */
+    outer: string[][];
+    /** The plotted categories. */
+    leaf: string[];
+};
+/** The resolved level values → the axis shape, or `undefined` when there is nothing to group. */
+export declare const resolveCategoryLevels: (levels: ReadonlyArray<ReadonlyArray<unknown>> | undefined | null) => CategoryLevels | undefined;
+/** plotly `multicategory` x: the outer levels first, the leaf labels last. */
+export declare const plotlyMulticategoryX: (levels: CategoryLevels) => string[][];
+/** Index of the first leaf of every run of equal labels in `level`. */
+export declare const groupStarts: (level: ReadonlyArray<string>) => number[];
+/**
+ * echarts has no multi-level category axis: the leaf axis is the real one
+ * (`base` — the caller's styled category axis, series bind to it) and every
+ * outer level becomes a label-only axis below it whose ticks sit on the group
+ * boundaries and whose label is written once per group, at the group's first
+ * leaf.
+ */
+export declare const echartsGroupedCategoryAxes: <T extends Record<string, unknown>>(levels: CategoryLevels, base: T, labelOffset?: number) => Array<Record<string, unknown>>;
+//# sourceMappingURL=category-levels.d.ts.map

package/dist/cjs/utils/category-levels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"category-levels.d.ts","sourceRoot":"","sources":["../../../utils/category-levels.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,cAAc,GAAG;IAC3B,+FAA+F;IAC/F,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC;IAClB,8BAA8B;IAC9B,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB,CAAC;AAKF,iGAAiG;AACjG,eAAO,MAAM,qBAAqB,GAChC,QAAQ,aAAa,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,GAAG,SAAS,GAAG,IAAI,KAC/D,cAAc,GAAG,SAQnB,CAAC;AAEF,8EAA8E;AAC9E,eAAO,MAAM,oBAAoB,GAAI,QAAQ,cAAc,KAAG,MAAM,EAAE,EAGrE,CAAC;AAEF,uEAAuE;AACvE,eAAO,MAAM,WAAW,GAAI,OAAO,aAAa,CAAC,MAAM,CAAC,KAAG,MAAM,EAIzD,CAAC;AAET;;;;;;GAMG;AACH,eAAO,MAAM,0BAA0B,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC1E,QAAQ,cAAc,EACtB,MAAM,CAAC,EACP,oBAAgB,KACf,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA4B/B,CAAC"}

package/dist/cjs/utils/category-levels.js

@@ -0,0 +1,80 @@
+"use strict";
+/**
+ * Hierarchical (multi-level) category axes — what Excel draws for a PivotChart
+ * over nested row fields: the leaf items along the axis with their parent
+ * labels grouped underneath. `ChartSpec.categoryLevels` carries the levels
+ * outermost first, the last one being the plotted categories.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.echartsGroupedCategoryAxes = exports.groupStarts = exports.plotlyMulticategoryX = exports.resolveCategoryLevels = void 0;
+var tslib_1 = require("tslib");
+var text = function (value) {
+    return value === null || value === undefined ? "" : String(value);
+};
+/** The resolved level values → the axis shape, or `undefined` when there is nothing to group. */
+var resolveCategoryLevels = function (levels) {
+    if (!levels || levels.length === 0)
+        return undefined;
+    var leaf = levels[levels.length - 1].map(text);
+    if (leaf.length === 0)
+        return undefined;
+    var outer = levels
+        .slice(0, -1)
+        .map(function (level) { return leaf.map(function (_, index) { return text(level[index]); }); });
+    return { outer: outer, leaf: leaf };
+};
+exports.resolveCategoryLevels = resolveCategoryLevels;
+/** plotly `multicategory` x: the outer levels first, the leaf labels last. */
+var plotlyMulticategoryX = function (levels) { return tslib_1.__spreadArray(tslib_1.__spreadArray([], tslib_1.__read(levels.outer), false), [
+    levels.leaf,
+], false); };
+exports.plotlyMulticategoryX = plotlyMulticategoryX;
+/** Index of the first leaf of every run of equal labels in `level`. */
+var groupStarts = function (level) {
+    return level.reduce(function (starts, label, index) {
+        if (index === 0 || label !== level[index - 1])
+            starts.push(index);
+        return starts;
+    }, []);
+};
+exports.groupStarts = groupStarts;
+/**
+ * echarts has no multi-level category axis: the leaf axis is the real one
+ * (`base` — the caller's styled category axis, series bind to it) and every
+ * outer level becomes a label-only axis below it whose ticks sit on the group
+ * boundaries and whose label is written once per group, at the group's first
+ * leaf.
+ */
+var echartsGroupedCategoryAxes = function (levels, base, labelOffset) {
+    if (labelOffset === void 0) { labelOffset = 24; }
+    var axes = [tslib_1.__assign(tslib_1.__assign({}, base), { data: levels.leaf })];
+    // Innermost outer level sits closest to the leaf axis.
+    tslib_1.__spreadArray([], tslib_1.__read(levels.outer), false).reverse().forEach(function (level, depth) {
+        var _a, _b;
+        var starts = new Set((0, exports.groupStarts)(level));
+        axes.push({
+            type: "category",
+            position: (_a = base.position) !== null && _a !== void 0 ? _a : "bottom",
+            offset: labelOffset * (depth + 1),
+            data: levels.leaf.map(function (_, index) { return "".concat(index); }),
+            show: (_b = base.show) !== null && _b !== void 0 ? _b : true,
+            axisLine: { show: false },
+            splitLine: { show: false },
+            axisTick: {
+                show: true,
+                length: labelOffset,
+                interval: function (index) { return starts.has(index); },
+                alignWithLabel: false,
+            },
+            axisLabel: {
+                interval: 0,
+                formatter: function (_, index) {
+                    return starts.has(index) ? level[index] : "";
+                },
+            },
+            nameLocation: "middle",
+        });
+    });
+    return axes;
+};
+exports.echartsGroupedCategoryAxes = echartsGroupedCategoryAxes;

package/dist/cjs/utils/chart-image.d.ts

@@ -0,0 +1,8 @@
+/**
+ * A `data:image/png;base64,…` URL (what echarts' `getDataURL` and plotly's
+ * `toImage` hand back) as a Blob for the clipboard / print pipeline.
+ * Decoded locally so no fetch is needed. `undefined` for anything that is
+ * not a base64 data URL.
+ */
+export declare const dataUrlToBlob: (dataUrl: string | undefined) => Blob | undefined;
+//# sourceMappingURL=chart-image.d.ts.map

package/dist/cjs/utils/chart-image.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-image.d.ts","sourceRoot":"","sources":["../../../utils/chart-image.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GAAI,SAAS,MAAM,GAAG,SAAS,KAAG,IAAI,GAAG,SAalE,CAAC"}

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

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dataUrlToBlob = void 0;
+/**
+ * A `data:image/png;base64,…` URL (what echarts' `getDataURL` and plotly's
+ * `toImage` hand back) as a Blob for the clipboard / print pipeline.
+ * Decoded locally so no fetch is needed. `undefined` for anything that is
+ * not a base64 data URL.
+ */
+var dataUrlToBlob = function (dataUrl) {
+    if (!dataUrl)
+        return undefined;
+    var match = /^data:([^;,]+)?(;base64)?,([\s\S]*)$/.exec(dataUrl);
+    if (!match || !match[2])
+        return undefined;
+    var mime = match[1] || "image/png";
+    try {
+        var binary = atob(match[3]);
+        var bytes = new Uint8Array(binary.length);
+        for (var i = 0; i < binary.length; i++)
+            bytes[i] = binary.charCodeAt(i);
+        return new Blob([bytes], { type: mime });
+    }
+    catch (_a) {
+        return undefined;
+    }
+};
+exports.dataUrlToBlob = dataUrlToBlob;

package/dist/cjs/utils/chart-orientation.d.ts

@@ -0,0 +1,67 @@
+import type { ChartData, EmbeddedChart, HIDDEN_DIMENSION_STRATEGY, SheetRange } from "@rowsncolumns/spreadsheet";
+type ChartSpec = EmbeddedChart["spec"];
+export type SeriesOrientation = NonNullable<ChartSpec["seriesOrientation"]>;
+/** Formatted text of one cell — the series name / category label source. */
+export type ChartCellLabelGetter = (sheetId: number, rowIndex: number, columnIndex: number) => string | null | undefined;
+/**
+ * Adapt a range reader (the renderers' `getDomainValuesFromRange`) into
+ * the single-cell label getter the orientation helpers take.
+ */
+export declare const cellLabelGetterFromRangeReader: (readRange: (range: SheetRange, hiddenStrategy?: HIDDEN_DIMENSION_STRATEGY | null) => readonly unknown[]) => ChartCellLabelGetter;
+/**
+ * Which way a chart's series run. The explicit flag wins; otherwise a
+ * chart whose every series is a single row spanning several columns is
+ * Excel's series-in-rows shape (OOXML carries no flag — each `<c:ser>` is
+ * its own reference — so imported charts are read this way).
+ */
+export declare const inferSeriesOrientation: (spec: ChartSpec) => SeriesOrientation;
+export declare const flipSeriesOrientation: (orientation: SeriesOrientation) => SeriesOrientation;
+/**
+ * Excel's chart wizard picks series-in-rows when the selection is wider
+ * than it is tall.
+ */
+export declare const pickSeriesOrientationForRange: (range: Omit<SheetRange, "sheetId">) => SeriesOrientation;
+/**
+ * Split a data range the way Excel's chart wizard does. Series in
+ * columns: the first column (beneath the header row) is the category
+ * axis and every further column is one series named by its header cell.
+ * Series in rows is the transpose: the first row (right of the header
+ * column) is the category axis and every further row is a series named
+ * by its first cell. A range only one row (column) tall still yields a
+ * one-cell-deep axis so the chart has something to plot.
+ */
+export declare const deriveChartSeriesFromRange: ({ range, orientation, getFormattedValue, }: {
+    range: SheetRange;
+    orientation: SeriesOrientation;
+    getFormattedValue?: ChartCellLabelGetter;
+}) => {
+    domains: ChartData[];
+    series: ChartData[];
+};
+/**
+ * The block the series tile when they form one rectangle: every series
+ * is a single source on the same sheet, all single columns sharing one
+ * row span (series in columns) or all single rows sharing one column
+ * span (series in rows), and adjacent to each other in order. Undefined
+ * for anything else — there is no meaningful transpose of scattered
+ * sources.
+ */
+export declare const rectangularSeriesBounds: (spec: ChartSpec, orientation: SeriesOrientation) => SheetRange | undefined;
+/** Whether `switchRowColumn` has a transpose to offer for this chart. */
+export declare const canSwitchRowColumn: (spec: ChartSpec) => boolean;
+/**
+ * Excel's "Switch Row/Column". With a `dataRange` the series and
+ * category axis are re-derived from it the other way round. Without one,
+ * rectangular series sources are transposed: each row (column) of the
+ * block becomes a series, named after the old category cell beside it,
+ * and the old series names become the categories (Excel's behaviour —
+ * the names are carried as inline values because the spec stores them
+ * as text, not as a cell reference). Per-series presentation (colours,
+ * trendlines, …) does not survive the transpose, as in Excel. Returns
+ * undefined when the sources cannot be transposed.
+ */
+export declare const switchRowColumn: (spec: ChartSpec, { getFormattedValue }?: {
+    getFormattedValue?: ChartCellLabelGetter;
+}) => ChartSpec | undefined;
+export {};
+//# sourceMappingURL=chart-orientation.d.ts.map

package/dist/cjs/utils/chart-orientation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-orientation.d.ts","sourceRoot":"","sources":["../../../utils/chart-orientation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,aAAa,EACb,yBAAyB,EACzB,UAAU,EACX,MAAM,2BAA2B,CAAC;AAInC,KAAK,SAAS,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;AAEvC,MAAM,MAAM,iBAAiB,GAAG,WAAW,CAAC,SAAS,CAAC,mBAAmB,CAAC,CAAC,CAAC;AAE5E,4EAA4E;AAC5E,MAAM,MAAM,oBAAoB,GAAG,CACjC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,KAChB,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;AAE/B;;;GAGG;AACH,eAAO,MAAM,8BAA8B,GAEvC,WAAW,CACT,KAAK,EAAE,UAAU,EACjB,cAAc,CAAC,EAAE,yBAAyB,GAAG,IAAI,KAC9C,SAAS,OAAO,EAAE,KACtB,oBAaF,CAAC;AAOJ;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,GAAI,MAAM,SAAS,KAAG,iBAQxD,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAChC,aAAa,iBAAiB,KAC7B,iBAAkE,CAAC;AAEtE;;;GAGG;AACH,eAAO,MAAM,6BAA6B,GACxC,OAAO,IAAI,CAAC,UAAU,EAAE,SAAS,CAAC,KACjC,iBAIY,CAAC;AAEhB;;;;;;;;GAQG;AACH,eAAO,MAAM,0BAA0B,GAAI,4CAIxC;IACD,KAAK,EAAE,UAAU,CAAC;IAClB,WAAW,EAAE,iBAAiB,CAAC;IAC/B,iBAAiB,CAAC,EAAE,oBAAoB,CAAC;CAC1C,KAAG;IAAE,OAAO,EAAE,SAAS,EAAE,CAAC;IAAC,MAAM,EAAE,SAAS,EAAE,CAAA;CA4D9C,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,uBAAuB,GAClC,MAAM,SAAS,EACf,aAAa,iBAAiB,KAC7B,UAAU,GAAG,SAsCf,CAAC;AAEF,yEAAyE;AACzE,eAAO,MAAM,kBAAkB,GAAI,MAAM,SAAS,KAAG,OAIrC,CAAC;AAEjB;;;;;;;;;;GAUG;AACH,eAAO,MAAM,eAAe,GAC1B,MAAM,SAAS,EACf,wBAAuB;IAAE,iBAAiB,CAAC,EAAE,oBAAoB,CAAA;CAAO,KACvE,SAAS,GAAG,SA8Ed,CAAC"}