@rowsncolumns/charts 28.1.7 → 28.1.10

package/dist/cjs/utils/hierarchy.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.toPlotlyHierarchy = exports.buildHierarchyTree = exports.extractHierarchyRows = exports.getHierarchyHeaderTitle = void 0;
+exports.hierarchyNodeColors = exports.toPlotlyHierarchy = exports.buildHierarchyTree = exports.extractHierarchyRows = exports.getHierarchyHeaderTitle = void 0;
 var tslib_1 = require("tslib");
 var flattenChartData = function (chartData, extractor, hiddenStrategy, skipFirstRow) {
     if (skipFirstRow === void 0) { skipFirstRow = false; }
@@ -22,10 +22,6 @@ var toLabelString = function (value) {
         return "";
     return "".concat(value).trim();
 };
-var toParentLabel = function (value) {
-    var label = toLabelString(value);
-    return label === "" ? null : label;
-};
 var toNumericValue = function (value) {
     if (typeof value === "number" && Number.isFinite(value)) {
         return value;
@@ -79,75 +75,186 @@ var getHierarchyHeaderTitle = function (spec, options) {
     return undefined;
 };
 exports.getHierarchyHeaderTitle = getHierarchyHeaderTitle;
+/**
+ * Lay the rows out as Excel does: one column per level (`parentLabels`
+ * entries, top level first) and the label column as the innermost level.
+ * Returns, per row, the filled level cells up to the row's leaf.
+ *
+ * A blank level cell BEFORE the row's first filled cell means "same as the
+ * row above" (Excel writes a parent only on the first row of its group).
+ * A blank AFTER the last filled cell ends the branch there — that cell is
+ * the row's leaf, so a shorter branch (`Services | Training | <blank>`)
+ * is a leaf of the second level, not `Services > Training > <previous
+ * item>` as plain per-column fill-down would make it.
+ */
+var layoutHierarchyLevels = function (levelColumns, rowCount) {
+    var filled = [];
+    var above = levelColumns.map(function () { return ""; });
+    var _loop_1 = function (row) {
+        var cells = levelColumns.map(function (column) { var _a; return (_a = column[row]) !== null && _a !== void 0 ? _a : ""; });
+        var firstFilled = cells.findIndex(function (cell) { return cell !== ""; });
+        if (firstFilled === -1) {
+            // An entirely blank row defines nothing (and inherits nothing).
+            filled.push([]);
+            return "continue";
+        }
+        var effective = cells.map(function (cell, level) { var _a; return level < firstFilled ? (_a = above[level]) !== null && _a !== void 0 ? _a : "" : cell; });
+        var lastFilled = effective.length - 1;
+        while (lastFilled >= 0 && effective[lastFilled] === "")
+            lastFilled--;
+        // The row's own levels end at its last filled cell; the cells past it
+        // stay blank for the rows below (they inherit up to the leaf only).
+        above = effective.map(function (cell, level) { return (level <= lastFilled ? cell : ""); });
+        filled.push(effective.slice(0, lastFilled + 1).filter(function (cell) { return cell !== ""; }));
+    };
+    for (var row = 0; row < rowCount; row++) {
+        _loop_1(row);
+    }
+    return filled;
+};
 var extractHierarchyRows = function (spec, options) {
+    var _a, _b;
     var getDomainValuesFromRange = options.getDomainValuesFromRange, getSeriesValuesFromRange = options.getSeriesValuesFromRange;
     var hiddenStrategy = options.hiddenDimensionStrategy;
     var skipHeaders = spec.useFirstRowAsHeaders !== false;
     var labels = flattenChartData(spec.labels, getDomainValuesFromRange, hiddenStrategy, skipHeaders).map(toLabelString);
-    var parents = flattenChartData(spec.parentLabels, getDomainValuesFromRange, hiddenStrategy, skipHeaders);
+    // Each `parentLabels` entry is one hierarchy level (top level first).
+    var parentLevels = ((_a = spec.parentLabels) !== null && _a !== void 0 ? _a : []).map(function (entry) {
+        return flattenChartData([entry], getDomainValuesFromRange, hiddenStrategy, skipHeaders).map(toLabelString);
+    });
     var sizes = flattenChartData(spec.sizeData, getSeriesValuesFromRange, hiddenStrategy, skipHeaders);
+    // A single parent column whose values name other rows' labels is a flat
+    // adjacency list (Google Sheets' label / parent-label model): every row
+    // is its own node and a blank parent means a root. Excel's level layout
+    // never lists a level name in the label column.
+    var labelSet = new Set(labels.filter(function (label) { return label !== ""; }));
+    var isAdjacencyList = parentLevels.length === 1 &&
+        parentLevels[0].some(function (parent) { return parent !== "" && labelSet.has(parent); });
     var rows = [];
-    var seenLabels = new Set();
-    for (var i = 0; i < labels.length; i++) {
-        var label = labels[i];
-        if (!label)
+    var seenPaths = new Set();
+    if (isAdjacencyList) {
+        var parents = parentLevels[0];
+        for (var i = 0; i < labels.length; i++) {
+            var label = labels[i];
+            if (!label)
+                continue;
+            if (seenPaths.has(label)) {
+                throw new Error("Duplicate hierarchy label detected: ".concat(label));
+            }
+            seenPaths.add(label);
+            var parent_1 = (_b = parents[i]) !== null && _b !== void 0 ? _b : "";
+            rows.push({
+                label: label,
+                parent: parent_1 === "" ? null : parent_1,
+                value: toNumericValue(sizes[i]),
+            });
+        }
+        return rows;
+    }
+    var rowCount = Math.max.apply(Math, tslib_1.__spreadArray([labels.length], tslib_1.__read(parentLevels.map(function (level) { return level.length; })), false));
+    var levels = layoutHierarchyLevels(tslib_1.__spreadArray(tslib_1.__spreadArray([], tslib_1.__read(parentLevels), false), [labels], false), rowCount);
+    for (var i = 0; i < rowCount; i++) {
+        var cells = levels[i];
+        if (!cells || cells.length === 0)
             continue;
-        if (seenLabels.has(label)) {
+        var label = cells[cells.length - 1];
+        var path = cells.slice(0, -1);
+        var key = tslib_1.__spreadArray(tslib_1.__spreadArray([], tslib_1.__read(path), false), [label], false).join("\u0000");
+        if (seenPaths.has(key)) {
             throw new Error("Duplicate hierarchy label detected: ".concat(label));
         }
-        seenLabels.add(label);
+        seenPaths.add(key);
         rows.push({
             label: label,
-            parent: toParentLabel(parents[i]),
+            parent: path.length ? path[path.length - 1] : null,
             value: toNumericValue(sizes[i]),
+            path: path,
         });
     }
     return rows;
 };
 exports.extractHierarchyRows = extractHierarchyRows;
-var getOrCreateNode = function (nodes, name) {
-    var existing = nodes.get(name);
-    if (existing)
-        return existing;
-    var node = {
-        name: name,
-        value: 0,
-        parent: null,
-        children: new Set(),
+var PATH_SEPARATOR = "/";
+/**
+ * The full path of every row, top level first, ending with the row's own
+ * label. A row carrying `path` (Excel's level layout) is placed under it;
+ * a legacy adjacency row names its parent, which is another row's label,
+ * so its path is that row's path plus itself (chained up to a root).
+ */
+var resolveRowPaths = function (rows) {
+    var byLabel = new Map();
+    rows.forEach(function (row) {
+        if (row.label && !row.path && !byLabel.has(row.label)) {
+            byLabel.set(row.label, row);
+        }
+    });
+    var memo = new Map();
+    var resolve = function (row, visiting) {
+        var cached = memo.get(row);
+        if (cached)
+            return cached;
+        var path;
+        if (row.path) {
+            path = tslib_1.__spreadArray(tslib_1.__spreadArray([], tslib_1.__read(row.path), false), [row.label], false);
+        }
+        else {
+            var parentName = row.parent && row.parent !== row.label ? row.parent : null;
+            var parentRow = parentName ? byLabel.get(parentName) : undefined;
+            if (parentRow && parentRow !== row && !visiting.has(parentRow)) {
+                visiting.add(row);
+                path = tslib_1.__spreadArray(tslib_1.__spreadArray([], tslib_1.__read(resolve(parentRow, visiting)), false), [row.label], false);
+                visiting.delete(row);
+            }
+            else {
+                path = parentName ? [parentName, row.label] : [row.label];
+            }
+        }
+        memo.set(row, path);
+        return path;
     };
-    nodes.set(name, node);
-    return node;
+    return rows.map(function (row) { return resolve(row, new Set()); });
 };
 var buildHierarchyTree = function (rows) {
-    var nodes = new Map();
-    rows.forEach(function (row) {
+    var roots = new Map();
+    var nodeAt = function (path) {
+        var level = roots;
+        var node;
+        path.forEach(function (name, depth) {
+            var existing = level.get(name);
+            if (existing) {
+                node = existing;
+            }
+            else {
+                node = {
+                    name: name,
+                    id: path.slice(0, depth + 1).join(PATH_SEPARATOR),
+                    value: 0,
+                    children: new Map(),
+                };
+                level.set(name, node);
+            }
+            level = node.children;
+        });
+        return node;
+    };
+    var paths = resolveRowPaths(rows);
+    rows.forEach(function (row, index) {
         var _a;
         if (!row.label)
             return;
-        var labelNode = getOrCreateNode(nodes, row.label);
-        var numericValue = (_a = row.value) !== null && _a !== void 0 ? _a : 0;
-        labelNode.value += numericValue;
-        var parentName = row.parent && row.parent !== row.label ? row.parent : null;
-        if (parentName) {
-            var parentNode = getOrCreateNode(nodes, parentName);
-            parentNode.children.add(row.label);
-            if (labelNode.parent == null) {
-                labelNode.parent = parentName;
-            }
-        }
+        var node = nodeAt(paths[index]);
+        node.value += (_a = row.value) !== null && _a !== void 0 ? _a : 0;
     });
     var buildNode = function (internal) {
         var children = internal.children.size > 0
-            ? Array.from(internal.children).map(function (childName) {
-                return buildNode(getOrCreateNode(nodes, childName));
-            })
+            ? Array.from(internal.children.values()).map(buildNode)
             : undefined;
         var value = children && children.length > 0
             ? children.reduce(function (sum, child) { var _a; return sum + ((_a = child.value) !== null && _a !== void 0 ? _a : 0); }, 0)
             : internal.value;
         var node = {
             name: internal.name,
-            id: internal.name,
+            id: internal.id,
             value: value,
         };
         if (children && children.length > 0) {
@@ -155,32 +262,49 @@ var buildHierarchyTree = function (rows) {
         }
         return node;
     };
-    var roots = [];
-    nodes.forEach(function (internal) {
-        if (internal.parent == null) {
-            roots.push(buildNode(internal));
-        }
-    });
-    return roots;
+    return Array.from(roots.values()).map(buildNode);
 };
 exports.buildHierarchyTree = buildHierarchyTree;
 var toPlotlyHierarchy = function (rows) {
     var tree = (0, exports.buildHierarchyTree)(rows);
     var labels = [];
+    var ids = [];
     var parents = [];
     var values = [];
-    var traverse = function (nodes, parentName) {
+    var depths = [];
+    var traverse = function (nodes, parentId, depth) {
         nodes.forEach(function (node) {
-            var _a;
+            var _a, _b, _c;
             labels.push(node.name);
-            parents.push(parentName !== null && parentName !== void 0 ? parentName : "");
-            values.push((_a = node.value) !== null && _a !== void 0 ? _a : 0);
+            ids.push((_a = node.id) !== null && _a !== void 0 ? _a : node.name);
+            parents.push(parentId);
+            values.push((_b = node.value) !== null && _b !== void 0 ? _b : 0);
+            depths.push(depth);
             if (node.children) {
-                traverse(node.children, node.name);
+                traverse(node.children, (_c = node.id) !== null && _c !== void 0 ? _c : node.name, depth + 1);
             }
         });
     };
-    traverse(tree, null);
-    return { labels: labels, parents: parents, values: values };
+    traverse(tree, "", 0);
+    return { labels: labels, ids: ids, parents: parents, values: values, depths: depths };
 };
 exports.toPlotlyHierarchy = toPlotlyHierarchy;
+/**
+ * One solid colour per top-level category, inherited by every descendant
+ * (Excel colours a treemap / sunburst by its first level), in tree order.
+ * Returns the colour per node of `toPlotlyHierarchy`'s flat arrays.
+ */
+var hierarchyNodeColors = function (hierarchy, palette) {
+    var colorById = new Map();
+    var rootIndex = 0;
+    return hierarchy.ids.map(function (id, index) {
+        var _a, _b;
+        var parentId = hierarchy.parents[index];
+        var color = parentId === ""
+            ? (_a = palette[rootIndex++ % Math.max(1, palette.length)]) !== null && _a !== void 0 ? _a : ""
+            : (_b = colorById.get(parentId)) !== null && _b !== void 0 ? _b : "";
+        colorById.set(id, color);
+        return color;
+    });
+};
+exports.hierarchyNodeColors = hierarchyNodeColors;

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

@@ -9,6 +9,15 @@ export declare const applyLegendOverrides: (legend: LegendComponentOption, opts:
  */
 export declare const applyAxisOverrides: (axis: any, opts: any, numberFormatPattern?: string, locale?: string) => any;
 export declare const dataLabelFormatter: (opts: any, locale?: string) => (params: any) => string;
+/**
+ * The data-label options one series renders with: its own
+ * `ChartData.dataLabels` when it has them (OOXML's `<c:ser><c:dLbls>`
+ * override — `{ show: false }` turns a labelled chart's labels off for
+ * that series alone), else the chart-level `ChartSpec.dataLabels`.
+ */
+export declare const resolveSeriesDataLabels: <T>(chartLevel: T | null | undefined, series: {
+    dataLabels?: T | null;
+} | null | undefined) => T | null | undefined;
 export declare const buildSeriesLabelOption: (opts: any, seriesType?: string, locale?: string) => {
     readonly show: true;
     readonly position: any;

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

@@ -1 +1 @@
-{"version":3,"file":"overrides.d.ts","sourceRoot":"","sources":["../../../utils/overrides.ts"],"names":[],"mappings":"AAAA,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,EAC5B,SAAS,MAAM,QA4BhB,CAAC;AAgBF,eAAO,MAAM,kBAAkB,GAAI,MAAM,GAAG,EAAE,SAAS,MAAM,MAAM,QAAQ,GAAG,WAiC7E,CAAC;AAgCF,eAAO,MAAM,sBAAsB,GACjC,MAAM,GAAG,EACT,aAAa,MAAM,EACnB,SAAS,MAAM;;;iCApE0D,GAAG;aAiF7E,CAAC"}
+{"version":3,"file":"overrides.d.ts","sourceRoot":"","sources":["../../../utils/overrides.ts"],"names":[],"mappings":"AAAA,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,EAC5B,SAAS,MAAM,QA4BhB,CAAC;AAgBF,eAAO,MAAM,kBAAkB,GAAI,MAAM,GAAG,EAAE,SAAS,MAAM,MAAM,QAAQ,GAAG,WA+C7E,CAAC;AAgCF;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,GAAI,CAAC,EACvC,YAAY,CAAC,GAAG,IAAI,GAAG,SAAS,EAChC,QAAQ;IAAE,UAAU,CAAC,EAAE,CAAC,GAAG,IAAI,CAAA;CAAE,GAAG,IAAI,GAAG,SAAS,KACnD,CAAC,GAAG,IAAI,GAAG,SAA6C,CAAC;AAE5D,eAAO,MAAM,sBAAsB,GACjC,MAAM,GAAG,EACT,aAAa,MAAM,EACnB,SAAS,MAAM;;;iCA7F0D,GAAG;aA0G7E,CAAC"}

package/dist/cjs/utils/overrides.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.buildSeriesLabelOption = exports.dataLabelFormatter = exports.applyAxisOverrides = exports.applyLegendOverrides = exports.textFormatToEchartsTextStyle = void 0;
+exports.buildSeriesLabelOption = exports.resolveSeriesDataLabels = exports.dataLabelFormatter = exports.applyAxisOverrides = exports.applyLegendOverrides = exports.textFormatToEchartsTextStyle = void 0;
 var tslib_1 = require("tslib");
 var axis_number_format_1 = require("./axis-number-format");
 // Map ChartSpec.legend / dataLabels / axisOptions to ECharts option
@@ -141,7 +141,11 @@ var dataLabelFormatter = function (opts, locale) { return function (params) {
         !opts.showSeriesName
         ? true
         : !!opts.showValue;
-    if (showVal && params.value !== undefined) {
+    // A scatter / bubble point's value is its [x, y, size] tuple: the label's
+    // value is Y and the bubble size is the third entry (#1068).
+    var isPointTuple = Array.isArray(params.value);
+    var pointValue = isPointTuple ? params.value[1] : params.value;
+    if (showVal && pointValue !== undefined) {
         // PERCENT_STACKED stores the raw value on the data object so the
         // label can still surface the dollar amount instead of the
         // normalized percentage. Plain stacked / clustered have just a
@@ -149,7 +153,10 @@ var dataLabelFormatter = function (opts, locale) { return function (params) {
         var originalValue = typeof params.data === "object" && params.data
             ? params.data.originalValue
             : undefined;
-        parts.push(formatLabelValue(params.value, originalValue, opts.numberFormatPattern, locale));
+        parts.push(formatLabelValue(pointValue, originalValue, opts.numberFormatPattern, locale));
+    }
+    if (opts.showBubbleSize && isPointTuple && params.value.length > 2) {
+        parts.push(formatLabelValue(params.value[2], undefined, opts.numberFormatPattern, locale));
     }
     return parts.join(": ");
 }; };
@@ -183,6 +190,14 @@ var ECHARTS_POINT_DLBL_POS = {
     right: "right",
 };
 var POINT_SERIES_TYPES = new Set(["line", "scatter", "effectScatter"]);
+/**
+ * The data-label options one series renders with: its own
+ * `ChartData.dataLabels` when it has them (OOXML's `<c:ser><c:dLbls>`
+ * override — `{ show: false }` turns a labelled chart's labels off for
+ * that series alone), else the chart-level `ChartSpec.dataLabels`.
+ */
+var resolveSeriesDataLabels = function (chartLevel, series) { var _a; return (_a = series === null || series === void 0 ? void 0 : series.dataLabels) !== null && _a !== void 0 ? _a : chartLevel; };
+exports.resolveSeriesDataLabels = resolveSeriesDataLabels;
 var buildSeriesLabelOption = function (opts, seriesType, locale) {
     var _a;
     if (!(opts === null || opts === void 0 ? void 0 : opts.show))

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

@@ -16,15 +16,41 @@ export type RadarSeriesInput = {
 };
 export type RadarIndicator = {
     name: string;
+    min: number;
     max: number;
 };
+export type RadarAxisScale = {
+    min: number;
+    max: number;
+};
+/** The value-axis options a radar's common scale reads (`ChartAxisOptions`). */
+export type RadarAxisOptions = {
+    min?: number | null;
+    max?: number | null;
+    visible?: boolean | null;
+} | null | undefined;
+/**
+ * The next "nice" axis bound at or above `value` — the top tick a value
+ * axis would auto-scale to: the step is 1 / 2 / 5 × a power of ten sized
+ * for about five divisions, and the bound is the first multiple of that
+ * step at or above the value (9 → 10, 33 → 40, 0.7 → 0.8).
+ */
+export declare const niceAxisCeiling: (value: number) => number;
+/**
+ * One value scale shared by every radar axis, as Excel draws it: `max` is
+ * the spec's `valueAxisOptions.max` when set, else the largest value across
+ * all series and categories rounded up to a nice bound (never below 1);
+ * `min` is `valueAxisOptions.min` when set (and below `max`), else 0.
+ */
+export declare const radarValueScale: (series: RadarSeriesInput[], axisOptions?: RadarAxisOptions) => RadarAxisScale;
 /**
- * Build echarts radar indicators from category labels and series.
- * The `max` per indicator is the largest value seen across all series at
- * that category (rounded up a touch so the polygon doesn't touch the
- * rim). When every series is empty at an index, `max` defaults to 1.
+ * Build echarts radar indicators from category labels and series. Every
+ * indicator carries the SAME `min` / `max` — the common scale of
+ * {@link radarValueScale} — so values on different axes compare, and a
+ * single series draws the shape of its data rather than a regular polygon
+ * (rowsncolumns/spreadsheet#1066).
  */
-export declare const buildRadarIndicators: (categories: (string | number | boolean | null | undefined)[], series: RadarSeriesInput[]) => RadarIndicator[];
+export declare const buildRadarIndicators: (categories: (string | number | boolean | null | undefined)[], series: RadarSeriesInput[], axisOptions?: RadarAxisOptions) => RadarIndicator[];
 /**
  * Shape series into echarts radar data: one entry per series with its
  * value vector aligned to the indicator order. Missing/non-numeric

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

@@ -1 +1 @@
-{"version":3,"file":"radar.d.ts","sourceRoot":"","sources":["../../../utils/radar.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,CAAC;CACvC,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAQ3D;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,GAC/B,YAAY,CAAC,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,EAC5D,QAAQ,gBAAgB,EAAE,KACzB,cAAc,EAahB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,GAC/B,QAAQ,gBAAgB,EAAE,EAC1B,gBAAgB,MAAM,KACrB,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAQzC,CAAC"}
+{"version":3,"file":"radar.d.ts","sourceRoot":"","sources":["../../../utils/radar.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,CAAC;CACvC,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAQxE,MAAM,MAAM,cAAc,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1D,gFAAgF;AAChF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CAC1B,GAAG,IAAI,GAAG,SAAS,CAAC;AAErB;;;;;GAKG;AACH,eAAO,MAAM,eAAe,GAAI,OAAO,MAAM,KAAG,MAW/C,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,eAAe,GAC1B,QAAQ,gBAAgB,EAAE,EAC1B,cAAc,gBAAgB,KAC7B,cAaF,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,GAC/B,YAAY,CAAC,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,EAC5D,QAAQ,gBAAgB,EAAE,EAC1B,cAAc,gBAAgB,KAC7B,cAAc,EAGhB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,GAC/B,QAAQ,gBAAgB,EAAE,EAC1B,gBAAgB,MAAM,KACrB,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAQzC,CAAC"}

package/dist/cjs/utils/radar.js

@@ -12,7 +12,7 @@
  * labels and per-series numeric values.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.buildRadarSeriesData = exports.buildRadarIndicators = void 0;
+exports.buildRadarSeriesData = exports.buildRadarIndicators = exports.radarValueScale = exports.niceAxisCeiling = void 0;
 var tslib_1 = require("tslib");
 var isFiniteNum = function (v) {
     return typeof v === "number" && Number.isFinite(v);
@@ -21,36 +21,76 @@ var toNumber = function (v) {
     return isFiniteNum(v) ? v : 0;
 };
 /**
- * Build echarts radar indicators from category labels and series.
- * The `max` per indicator is the largest value seen across all series at
- * that category (rounded up a touch so the polygon doesn't touch the
- * rim). When every series is empty at an index, `max` defaults to 1.
+ * The next "nice" axis bound at or above `value` — the top tick a value
+ * axis would auto-scale to: the step is 1 / 2 / 5 × a power of ten sized
+ * for about five divisions, and the bound is the first multiple of that
+ * step at or above the value (9 → 10, 33 → 40, 0.7 → 0.8).
  */
-var buildRadarIndicators = function (categories, series) {
-    return categories.map(function (label, i) {
-        var e_1, _a;
-        var max = 0;
-        try {
-            for (var series_1 = tslib_1.__values(series), series_1_1 = series_1.next(); !series_1_1.done; series_1_1 = series_1.next()) {
-                var s = series_1_1.value;
-                var v = s.values[i];
-                if (isFiniteNum(v))
-                    max = Math.max(max, v);
-            }
-        }
-        catch (e_1_1) { e_1 = { error: e_1_1 }; }
-        finally {
+var niceAxisCeiling = function (value) {
+    if (!isFiniteNum(value) || value <= 0)
+        return 1;
+    var rough = value / 5;
+    var magnitude = Math.pow(10, Math.floor(Math.log10(rough)));
+    var residual = rough / magnitude;
+    var step = (residual <= 1 ? 1 : residual <= 2 ? 2 : residual <= 5 ? 5 : 10) *
+        magnitude;
+    var ceiling = Math.ceil(value / step - 1e-9) * step;
+    // Avoid 0.30000000000000004-style bounds from the float arithmetic.
+    return Number(ceiling.toPrecision(12));
+};
+exports.niceAxisCeiling = niceAxisCeiling;
+/**
+ * One value scale shared by every radar axis, as Excel draws it: `max` is
+ * the spec's `valueAxisOptions.max` when set, else the largest value across
+ * all series and categories rounded up to a nice bound (never below 1);
+ * `min` is `valueAxisOptions.min` when set (and below `max`), else 0.
+ */
+var radarValueScale = function (series, axisOptions) {
+    var e_1, _a, e_2, _b;
+    var largest = 0;
+    try {
+        for (var series_1 = tslib_1.__values(series), series_1_1 = series_1.next(); !series_1_1.done; series_1_1 = series_1.next()) {
+            var s = series_1_1.value;
             try {
-                if (series_1_1 && !series_1_1.done && (_a = series_1.return)) _a.call(series_1);
+                for (var _c = (e_2 = void 0, tslib_1.__values(s.values)), _d = _c.next(); !_d.done; _d = _c.next()) {
+                    var v = _d.value;
+                    if (isFiniteNum(v))
+                        largest = Math.max(largest, v);
+                }
+            }
+            catch (e_2_1) { e_2 = { error: e_2_1 }; }
+            finally {
+                try {
+                    if (_d && !_d.done && (_b = _c.return)) _b.call(_c);
+                }
+                finally { if (e_2) throw e_2.error; }
             }
-            finally { if (e_1) throw e_1.error; }
         }
-        return {
-            name: String(label !== null && label !== void 0 ? label : ""),
-            // Pad by 10% so the outermost ring has breathing room; never 0.
-            max: max > 0 ? max * 1.1 : 1,
-        };
-    });
+    }
+    catch (e_1_1) { e_1 = { error: e_1_1 }; }
+    finally {
+        try {
+            if (series_1_1 && !series_1_1.done && (_a = series_1.return)) _a.call(series_1);
+        }
+        finally { if (e_1) throw e_1.error; }
+    }
+    var max = isFiniteNum(axisOptions === null || axisOptions === void 0 ? void 0 : axisOptions.max)
+        ? axisOptions.max
+        : (0, exports.niceAxisCeiling)(largest);
+    var min = isFiniteNum(axisOptions === null || axisOptions === void 0 ? void 0 : axisOptions.min) && axisOptions.min < max ? axisOptions.min : 0;
+    return { min: min, max: max };
+};
+exports.radarValueScale = radarValueScale;
+/**
+ * Build echarts radar indicators from category labels and series. Every
+ * indicator carries the SAME `min` / `max` — the common scale of
+ * {@link radarValueScale} — so values on different axes compare, and a
+ * single series draws the shape of its data rather than a regular polygon
+ * (rowsncolumns/spreadsheet#1066).
+ */
+var buildRadarIndicators = function (categories, series, axisOptions) {
+    var _a = (0, exports.radarValueScale)(series, axisOptions), min = _a.min, max = _a.max;
+    return categories.map(function (label) { return ({ name: String(label !== null && label !== void 0 ? label : ""), min: min, max: max }); });
 };
 exports.buildRadarIndicators = buildRadarIndicators;
 /**

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

@@ -43,6 +43,12 @@ export type TrendlineResult = {
  * @param values  Raw y-values; the 1-based category position is used as x
  *                for the fit, the 0-based index is reported in the points.
  * @param spec    Trendline parameters (type/order/period/forecast).
+ * @param xValues Scatter / bubble only — the series' real X values, index-
+ *                aligned with `values`. The fit then runs on (x, y) pairs
+ *                (a regression of Y on X, what Excel draws on an XY chart;
+ *                the point index is wrong for unevenly spaced X), the
+ *                forecast extends the X range by that many X units, and the
+ *                points carry real X coordinates sampled across the range.
  */
 export declare const computeTrendline: (values: (number | null | undefined)[], spec?: {
     type?: TrendlineType | null;
@@ -50,5 +56,5 @@ export declare const computeTrendline: (values: (number | null | undefined)[], s
     period?: number | null;
     forecastForward?: number | null;
     forecastBackward?: number | null;
-}) => TrendlineResult | null;
+}, xValues?: (number | null | undefined)[] | null) => TrendlineResult | null;
 //# sourceMappingURL=trendline.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"trendline.d.ts","sourceRoot":"","sources":["../../../utils/trendline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,MAAM,MAAM,aAAa,GACrB,QAAQ,GACR,KAAK,GACL,KAAK,GACL,MAAM,GACN,OAAO,GACP,WAAW,CAAC;AAEhB,6FAA6F;AAC7F,MAAM,MAAM,cAAc,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtD,MAAM,MAAM,eAAe,GAAG;IAC5B,sEAAsE;IACtE,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,uEAAuE;IACvE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB,CAAC;AAsJF;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,GAC3B,QAAQ,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,EACrC,OAAM;IACJ,IAAI,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B,KACL,eAAe,GAAG,IAiGpB,CAAC"}
+{"version":3,"file":"trendline.d.ts","sourceRoot":"","sources":["../../../utils/trendline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,MAAM,MAAM,aAAa,GACrB,QAAQ,GACR,KAAK,GACL,KAAK,GACL,MAAM,GACN,OAAO,GACP,WAAW,CAAC;AAEhB,6FAA6F;AAC7F,MAAM,MAAM,cAAc,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtD,MAAM,MAAM,eAAe,GAAG;IAC5B,sEAAsE;IACtE,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,uEAAuE;IACvE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB,CAAC;AAkKF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,gBAAgB,GAC3B,QAAQ,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,EACrC,OAAM;IACJ,IAAI,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B,EACN,UAAU,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,GAAG,IAAI,KAC7C,eAAe,GAAG,IA+HpB,CAAC"}