@rowsncolumns/charts 28.1.10 → 28.1.12

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

@@ -46,5 +46,11 @@ export declare const toPlotlyHierarchy: (rows: HierarchyRow[]) => PlotlyHierarch
  * Returns the colour per node of `toPlotlyHierarchy`'s flat arrays.
  */
 export declare const hierarchyNodeColors: (hierarchy: Pick<PlotlyHierarchy, "ids" | "parents">, palette: string[]) => string[];
+/**
+ * Black or white, whichever reads on `background` (a `#rgb` / `#rrggbb`
+ * colour; anything else gets white) — for a treemap banner filled with
+ * its category's colour (rowsncolumns/spreadsheet#1086).
+ */
+export declare const contrastTextColor: (background: string | undefined) => string;
 export {};
 //# sourceMappingURL=hierarchy.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"hierarchy.d.ts","sourceRoot":"","sources":["../../../utils/hierarchy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,SAAS,EACT,UAAU,EACV,YAAY,EACb,MAAM,2BAA2B,CAAC;AAEnC,KAAK,SAAS,GAAG,CACf,KAAK,EAAE,UAAU,EACjB,cAAc,CAAC,EAAE,SAAS,CAAC,yBAAyB,CAAC,KAClD,CAAC,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,CAAC;AAEtD,MAAM,MAAM,YAAY,GAAG;IACzB,mEAAmE;IACnE,KAAK,EAAE,MAAM,CAAC;IACd,wEAAwE;IACxE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,CAAC,EAAE,aAAa,EAAE,CAAC;CAC5B,CAAC;AAEF,KAAK,cAAc,GAAG;IACpB,wBAAwB,EAAE,SAAS,CAAC;IACpC,wBAAwB,EAAE,SAAS,CAAC;IACpC,uBAAuB,CAAC,EAAE,SAAS,CAAC,yBAAyB,CAAC,CAAC;CAChE,CAAC;AA0CF,eAAO,MAAM,uBAAuB,GAClC,MAAM,YAAY,EAClB,SAAS,cAAc,KACtB,MAAM,GAAG,SAgBX,CAAC;AAyCF,eAAO,MAAM,oBAAoB,GAC/B,MAAM,YAAY,EAClB,SAAS,cAAc,KACtB,YAAY,EAiFd,CAAC;AAiDF,eAAO,MAAM,kBAAkB,GAAI,MAAM,YAAY,EAAE,KAAG,aAAa,EAmDtE,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,4BAA4B;IAC5B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,6EAA6E;IAC7E,GAAG,EAAE,MAAM,EAAE,CAAC;IACd,yCAAyC;IACzC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,oCAAoC;IACpC,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAI,MAAM,YAAY,EAAE,KAAG,eAwBxD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,GAC9B,WAAW,IAAI,CAAC,eAAe,EAAE,KAAK,GAAG,SAAS,CAAC,EACnD,SAAS,MAAM,EAAE,KAChB,MAAM,EAYR,CAAC"}
+{"version":3,"file":"hierarchy.d.ts","sourceRoot":"","sources":["../../../utils/hierarchy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,SAAS,EACT,UAAU,EACV,YAAY,EACb,MAAM,2BAA2B,CAAC;AAEnC,KAAK,SAAS,GAAG,CACf,KAAK,EAAE,UAAU,EACjB,cAAc,CAAC,EAAE,SAAS,CAAC,yBAAyB,CAAC,KAClD,CAAC,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,CAAC;AAEtD,MAAM,MAAM,YAAY,GAAG;IACzB,mEAAmE;IACnE,KAAK,EAAE,MAAM,CAAC;IACd,wEAAwE;IACxE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,CAAC,EAAE,aAAa,EAAE,CAAC;CAC5B,CAAC;AAEF,KAAK,cAAc,GAAG;IACpB,wBAAwB,EAAE,SAAS,CAAC;IACpC,wBAAwB,EAAE,SAAS,CAAC;IACpC,uBAAuB,CAAC,EAAE,SAAS,CAAC,yBAAyB,CAAC,CAAC;CAChE,CAAC;AA0CF,eAAO,MAAM,uBAAuB,GAClC,MAAM,YAAY,EAClB,SAAS,cAAc,KACtB,MAAM,GAAG,SAgBX,CAAC;AAyCF,eAAO,MAAM,oBAAoB,GAC/B,MAAM,YAAY,EAClB,SAAS,cAAc,KACtB,YAAY,EAiFd,CAAC;AAiDF,eAAO,MAAM,kBAAkB,GAAI,MAAM,YAAY,EAAE,KAAG,aAAa,EAmDtE,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,4BAA4B;IAC5B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,6EAA6E;IAC7E,GAAG,EAAE,MAAM,EAAE,CAAC;IACd,yCAAyC;IACzC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,oCAAoC;IACpC,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAI,MAAM,YAAY,EAAE,KAAG,eAwBxD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,GAC9B,WAAW,IAAI,CAAC,eAAe,EAAE,KAAK,GAAG,SAAS,CAAC,EACnD,SAAS,MAAM,EAAE,KAChB,MAAM,EAYR,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,GAAI,YAAY,MAAM,GAAG,SAAS,KAAG,MAelE,CAAC"}

package/dist/cjs/utils/hierarchy.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.hierarchyNodeColors = exports.toPlotlyHierarchy = exports.buildHierarchyTree = exports.extractHierarchyRows = exports.getHierarchyHeaderTitle = void 0;
+exports.contrastTextColor = 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; }
@@ -308,3 +308,25 @@ var hierarchyNodeColors = function (hierarchy, palette) {
     });
 };
 exports.hierarchyNodeColors = hierarchyNodeColors;
+/**
+ * Black or white, whichever reads on `background` (a `#rgb` / `#rrggbb`
+ * colour; anything else gets white) — for a treemap banner filled with
+ * its category's colour (rowsncolumns/spreadsheet#1086).
+ */
+var contrastTextColor = function (background) {
+    var hex = (background !== null && background !== void 0 ? background : "").trim().replace(/^#/, "");
+    var full = hex.length === 3
+        ? hex
+            .split("")
+            .map(function (c) { return c + c; })
+            .join("")
+        : hex;
+    if (!/^[0-9a-f]{6}$/i.test(full))
+        return "#ffffff";
+    var r = parseInt(full.slice(0, 2), 16);
+    var g = parseInt(full.slice(2, 4), 16);
+    var b = parseInt(full.slice(4, 6), 16);
+    var luminance = (0.299 * r + 0.587 * g + 0.114 * b) / 255;
+    return luminance > 0.6 ? "#000000" : "#ffffff";
+};
+exports.contrastTextColor = contrastTextColor;

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

@@ -39,8 +39,47 @@ export declare const isParetoSpec: (spec: {
  */
 export declare const computePareto: (bins: HistogramBins) => ParetoData;
 /**
- * Bin a set of numeric values into `binCount` equal-width bins.
- * When `binCount` is omitted, uses Sturges' rule: ceil(log2(n) + 1).
+ * Excel's `<cx:binning>` options (rowsncolumns/spreadsheet#1087). Any of
+ * them present switches the histogram to Excel's conventions: intervals
+ * closed on the right by default and automatic bins by Excel's rule.
  */
-export declare const binHistogram: (values: (number | null | undefined)[], binCount?: number | null) => HistogramBins;
+export type HistogramBinningOptions = {
+    /** Fixed bin width (`<cx:binSize>`); wins over `binCount`. */
+    binSize?: number | null;
+    /** Which side of an interval is closed (`intervalClosed`); Excel's default is `r`. */
+    intervalClosed?: "l" | "r" | null;
+    /** Values above this collect in a final `> overflow` bin. */
+    overflow?: number | null;
+    /** Values below this collect in a first `< underflow` bin. */
+    underflow?: number | null;
+};
+/** True when the spec authored any Excel binning option. */
+export declare const hasExcelBinning: (options: HistogramBinningOptions | null | undefined) => boolean;
+/**
+ * Excel's automatic bin width: Scott's normal reference rule,
+ * 3.5 · σ / ∛n with the sample standard deviation, rounded up to two
+ * significant digits. For the 20 values 12 … 95 of #1087 (σ ≈ 23.86) that
+ * is 30.77 → 31, i.e. Excel's three bins [12, 43], (43, 74], (74, 105].
+ */
+export declare const excelAutoBinWidth: (numeric: number[]) => number;
+/**
+ * Bin a set of numeric values into equal-width bins.
+ *
+ * Default (no Excel options): `binCount` bins over [min, max], closed on
+ * the left — or Sturges' rule, ceil(log2(n) + 1), when `binCount` is
+ * omitted. With Excel binning options (#1087): bins start at the minimum
+ * (or the underflow bound), are `binSize` wide — else (max − min) /
+ * `binCount`, else Excel's automatic width — closed on the right unless
+ * `intervalClosed` is `l`, and values beyond `overflow` / `underflow`
+ * collect in their own end bins.
+ */
+export declare const binHistogram: (values: (number | null | undefined)[], binCount?: number | null, options?: HistogramBinningOptions | null) => HistogramBins;
+export type HistogramAggregateType = "SUM" | "AVERAGE" | "COUNT" | "MAX" | "MIN" | "MEDIAN";
+/**
+ * Excel's histogram "By Category" / Pareto over categories
+ * (`<cx:aggregation/>`, #1087): one column per distinct category in order
+ * of first appearance, its value the aggregate (sum by default) of the
+ * series values of that category — instead of binning the values.
+ */
+export declare const aggregateByCategory: (categories: (string | number | null | undefined)[], values: (number | null | undefined)[], aggregateType?: HistogramAggregateType | null | undefined) => HistogramBins;
 //# sourceMappingURL=histogram.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"histogram.d.ts","sourceRoot":"","sources":["../../../utils/histogram.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,gDAAgD;IAChD,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,mEAAmE;IACnE,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB;;;;OAIG;IACH,kBAAkB,EAAE,MAAM,EAAE,CAAC;CAC9B,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,YAAY,GAAI,MAAM;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC,KAAG,OAGgD,CAAC;AAErD;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GAAI,MAAM,aAAa,KAAG,UAmBnD,CAAC;AASF;;;GAGG;AACH,eAAO,MAAM,YAAY,GACvB,QAAQ,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,EACrC,WAAW,MAAM,GAAG,IAAI,KACvB,aA0CF,CAAC"}
+{"version":3,"file":"histogram.d.ts","sourceRoot":"","sources":["../../../utils/histogram.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,gDAAgD;IAChD,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,mEAAmE;IACnE,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB;;;;OAIG;IACH,kBAAkB,EAAE,MAAM,EAAE,CAAC;CAC9B,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,YAAY,GAAI,MAAM;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC,KAAG,OAGgD,CAAC;AAErD;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GAAI,MAAM,aAAa,KAAG,UAmBnD,CAAC;AAUF;;;;GAIG;AACH,MAAM,MAAM,uBAAuB,GAAG;IACpC,8DAA8D;IAC9D,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,sFAAsF;IACtF,cAAc,CAAC,EAAE,GAAG,GAAG,GAAG,GAAG,IAAI,CAAC;IAClC,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,8DAA8D;IAC9D,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B,CAAC;AAKF,4DAA4D;AAC5D,eAAO,MAAM,eAAe,GAC1B,SAAS,uBAAuB,GAAG,IAAI,GAAG,SAAS,KAClD,OAQA,CAAC;AASJ;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,GAAI,SAAS,MAAM,EAAE,KAAG,MASrD,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,YAAY,GACvB,QAAQ,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,EACrC,WAAW,MAAM,GAAG,IAAI,EACxB,UAAU,uBAAuB,GAAG,IAAI,KACvC,aA4CF,CAAC;AAiFF,MAAM,MAAM,sBAAsB,GAC9B,KAAK,GACL,SAAS,GACT,OAAO,GACP,KAAK,GACL,KAAK,GACL,QAAQ,CAAC;AAEb;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,GAC9B,YAAY,CAAC,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,EAClD,QAAQ,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,EACrC,gBAAe,sBAAsB,GAAG,IAAI,GAAG,SAAiB,KAC/D,aA0CF,CAAC"}

package/dist/cjs/utils/histogram.js

@@ -7,7 +7,7 @@
  * here and emits a bar series with the bin labels as the x-axis category.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.binHistogram = exports.computePareto = exports.isParetoSpec = void 0;
+exports.aggregateByCategory = exports.binHistogram = exports.excelAutoBinWidth = exports.hasExcelBinning = exports.computePareto = exports.isParetoSpec = void 0;
 var tslib_1 = require("tslib");
 /**
  * True when a chart spec should render as a Pareto chart: either a
@@ -53,18 +53,65 @@ exports.computePareto = computePareto;
 var formatBinBound = function (value) {
     if (!Number.isFinite(value))
         return String(value);
+    if (value === 0)
+        return "0";
     var abs = Math.abs(value);
     if (abs >= 1000 || abs < 0.01)
         return value.toExponential(2);
     return Number.parseFloat(value.toFixed(2)).toString();
 };
+var isFinite_ = function (v) {
+    return typeof v === "number" && Number.isFinite(v);
+};
+/** True when the spec authored any Excel binning option. */
+var hasExcelBinning = function (options) {
+    return Boolean(options &&
+        (isFinite_(options.binSize) ||
+            options.intervalClosed === "l" ||
+            options.intervalClosed === "r" ||
+            isFinite_(options.overflow) ||
+            isFinite_(options.underflow)));
+};
+exports.hasExcelBinning = hasExcelBinning;
+/** Round up to two significant digits (31 for 30.77, 0.038 for 0.0377). */
+var ceilToTwoSignificant = function (value) {
+    if (!(value > 0))
+        return value;
+    var magnitude = Math.pow(10, (Math.floor(Math.log10(value)) - 1));
+    return Math.ceil(value / magnitude - 1e-9) * magnitude;
+};
 /**
- * Bin a set of numeric values into `binCount` equal-width bins.
- * When `binCount` is omitted, uses Sturges' rule: ceil(log2(n) + 1).
+ * Excel's automatic bin width: Scott's normal reference rule,
+ * 3.5 · σ / ∛n with the sample standard deviation, rounded up to two
+ * significant digits. For the 20 values 12 … 95 of #1087 (σ ≈ 23.86) that
+ * is 30.77 → 31, i.e. Excel's three bins [12, 43], (43, 74], (74, 105].
  */
-var binHistogram = function (values, binCount) {
+var excelAutoBinWidth = function (numeric) {
+    var n = numeric.length;
+    if (n < 2)
+        return 1;
+    var mean = numeric.reduce(function (sum, v) { return sum + v; }, 0) / n;
+    var variance = numeric.reduce(function (sum, v) { return sum + Math.pow((v - mean), 2); }, 0) / (n - 1);
+    var sigma = Math.sqrt(variance);
+    if (!(sigma > 0))
+        return 1;
+    return ceilToTwoSignificant((3.5 * sigma) / Math.cbrt(n));
+};
+exports.excelAutoBinWidth = excelAutoBinWidth;
+/**
+ * Bin a set of numeric values into equal-width bins.
+ *
+ * Default (no Excel options): `binCount` bins over [min, max], closed on
+ * the left — or Sturges' rule, ceil(log2(n) + 1), when `binCount` is
+ * omitted. With Excel binning options (#1087): bins start at the minimum
+ * (or the underflow bound), are `binSize` wide — else (max − min) /
+ * `binCount`, else Excel's automatic width — closed on the right unless
+ * `intervalClosed` is `l`, and values beyond `overflow` / `underflow`
+ * collect in their own end bins.
+ */
+var binHistogram = function (values, binCount, options) {
     var e_1, _a, e_2, _b;
-    var numeric = values.filter(function (v) { return typeof v === "number" && Number.isFinite(v); });
+    var numeric = values.filter(isFinite_);
     if (numeric.length === 0) {
         return { labels: [], counts: [] };
     }
@@ -86,6 +133,9 @@ var binHistogram = function (values, binCount) {
         }
         finally { if (e_1) throw e_1.error; }
     }
+    if ((0, exports.hasExcelBinning)(options)) {
+        return binExcel(numeric, min, max, binCount, options);
+    }
     var sturges = Math.max(1, Math.ceil(Math.log2(numeric.length) + 1));
     var bins = typeof binCount === "number" && binCount > 0
         ? Math.floor(binCount)
@@ -123,3 +173,141 @@ var binHistogram = function (values, binCount) {
     return { labels: labels, counts: counts };
 };
 exports.binHistogram = binHistogram;
+var binExcel = function (numeric, min, max, binCount, options) {
+    var e_3, _a;
+    var rightClosed = options.intervalClosed !== "l";
+    var underflow = isFinite_(options.underflow) ? options.underflow : null;
+    var overflow = isFinite_(options.overflow) ? options.overflow : null;
+    // The regular bins span the values between the end bins.
+    var inRange = numeric.filter(function (v) {
+        return (underflow === null || v >= underflow) &&
+            (overflow === null || v <= overflow);
+    });
+    var start = underflow !== null && underflow !== void 0 ? underflow : (inRange.length ? Math.min.apply(Math, tslib_1.__spreadArray([], tslib_1.__read(inRange), false)) : min);
+    var end = overflow !== null && overflow !== void 0 ? overflow : (inRange.length ? Math.max.apply(Math, tslib_1.__spreadArray([], tslib_1.__read(inRange), false)) : max);
+    var span = end - start;
+    var width;
+    if (isFinite_(options.binSize) && options.binSize > 0) {
+        width = options.binSize;
+    }
+    else if (typeof binCount === "number" && binCount > 0) {
+        width = span > 0 ? span / Math.floor(binCount) : 1;
+    }
+    else {
+        width = (0, exports.excelAutoBinWidth)(inRange.length ? inRange : numeric);
+    }
+    // Enough bins to reach the last value; a right-closed layout needs one
+    // more when the span is an exact multiple (the boundary value belongs to
+    // the bin below, so the top bin stays).
+    var bins = span > 0 ? Math.ceil(span / width - 1e-9) : 1;
+    bins = Math.max(1, bins);
+    var counts = new Array(bins).fill(0);
+    var edges = Array.from({ length: bins + 1 }, function (_, i) { return start + width * i; });
+    var under = 0;
+    var over = 0;
+    try {
+        for (var numeric_3 = tslib_1.__values(numeric), numeric_3_1 = numeric_3.next(); !numeric_3_1.done; numeric_3_1 = numeric_3.next()) {
+            var v = numeric_3_1.value;
+            if (underflow !== null && v < underflow) {
+                under++;
+                continue;
+            }
+            if (overflow !== null && v > overflow) {
+                over++;
+                continue;
+            }
+            var idx = void 0;
+            if (rightClosed) {
+                // (lo, hi]: a value on a boundary belongs to the bin below it; the
+                // first bin also takes its own lower bound.
+                idx = Math.ceil((v - start) / width - 1e-9) - 1;
+                if (idx < 0)
+                    idx = 0;
+            }
+            else {
+                idx = Math.floor((v - start) / width + 1e-9);
+            }
+            if (idx >= bins)
+                idx = bins - 1;
+            counts[idx]++;
+        }
+    }
+    catch (e_3_1) { e_3 = { error: e_3_1 }; }
+    finally {
+        try {
+            if (numeric_3_1 && !numeric_3_1.done && (_a = numeric_3.return)) _a.call(numeric_3);
+        }
+        finally { if (e_3) throw e_3.error; }
+    }
+    var labels = edges.slice(0, -1).map(function (lo, i) {
+        var hi = edges[i + 1];
+        if (rightClosed) {
+            var opening = i === 0 ? "[" : "(";
+            return "".concat(opening).concat(formatBinBound(lo), ", ").concat(formatBinBound(hi), "]");
+        }
+        var closing = i === bins - 1 ? "]" : ")";
+        return "[".concat(formatBinBound(lo), ", ").concat(formatBinBound(hi)).concat(closing);
+    });
+    if (underflow !== null) {
+        labels.unshift("< ".concat(formatBinBound(underflow)));
+        counts.unshift(under);
+    }
+    if (overflow !== null) {
+        labels.push("> ".concat(formatBinBound(overflow)));
+        counts.push(over);
+    }
+    return { labels: labels, counts: counts };
+};
+/**
+ * Excel's histogram "By Category" / Pareto over categories
+ * (`<cx:aggregation/>`, #1087): one column per distinct category in order
+ * of first appearance, its value the aggregate (sum by default) of the
+ * series values of that category — instead of binning the values.
+ */
+var aggregateByCategory = function (categories, values, aggregateType) {
+    if (aggregateType === void 0) { aggregateType = "SUM"; }
+    var groups = new Map();
+    var order = [];
+    var count = Math.max(categories.length, values.length);
+    for (var i = 0; i < count; i++) {
+        var raw = categories[i];
+        var label = raw === null || raw === undefined ? "" : "".concat(raw).trim();
+        if (label === "")
+            continue;
+        if (!groups.has(label)) {
+            groups.set(label, []);
+            order.push(label);
+        }
+        var v = values[i];
+        if (isFinite_(v))
+            groups.get(label).push(v);
+    }
+    var reduce = function (nums) {
+        if (nums.length === 0)
+            return 0;
+        switch (aggregateType !== null && aggregateType !== void 0 ? aggregateType : "SUM") {
+            case "COUNT":
+                return nums.length;
+            case "AVERAGE":
+                return nums.reduce(function (a, b) { return a + b; }, 0) / nums.length;
+            case "MAX":
+                return Math.max.apply(Math, tslib_1.__spreadArray([], tslib_1.__read(nums), false));
+            case "MIN":
+                return Math.min.apply(Math, tslib_1.__spreadArray([], tslib_1.__read(nums), false));
+            case "MEDIAN": {
+                var sorted = tslib_1.__spreadArray([], tslib_1.__read(nums), false).sort(function (a, b) { return a - b; });
+                var mid = Math.floor(sorted.length / 2);
+                return sorted.length % 2
+                    ? sorted[mid]
+                    : (sorted[mid - 1] + sorted[mid]) / 2;
+            }
+            default:
+                return nums.reduce(function (a, b) { return a + b; }, 0);
+        }
+    };
+    return {
+        labels: order,
+        counts: order.map(function (label) { var _a; return reduce((_a = groups.get(label)) !== null && _a !== void 0 ? _a : []); }),
+    };
+};
+exports.aggregateByCategory = aggregateByCategory;

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

@@ -8,7 +8,7 @@ export declare const applyLegendOverrides: (legend: LegendComponentOption, opts:
  * becomes the tick-label formatter.
  */
 export declare const applyAxisOverrides: (axis: any, opts: any, numberFormatPattern?: string, locale?: string) => any;
-export declare const dataLabelFormatter: (opts: any, locale?: string) => (params: any) => string;
+export declare const dataLabelFormatter: (opts: any, locale?: string, joiner?: 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>`

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,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"}
+{"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,GAC7B,MAAM,GAAG,EACT,SAAS,MAAM,EAEf,eAAa,MACT,QAAQ,GAAG,WAoDhB,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;;;iCAlGH,GAAG;aA+GhB,CAAC"}

package/dist/cjs/utils/overrides.js

@@ -126,40 +126,50 @@ exports.applyAxisOverrides = applyAxisOverrides;
  * — Excel's behaviour.
  */
 var formatLabelValue = function (rawValue, originalValue, pattern, locale) { return (0, axis_number_format_1.formatAxisValue)(pattern, originalValue !== null && originalValue !== void 0 ? originalValue : rawValue, locale); };
-var dataLabelFormatter = function (opts, locale) { return function (params) {
-    var parts = [];
-    if (opts.showSeriesName && params.seriesName)
-        parts.push(params.seriesName);
-    if (opts.showCategoryName && params.name)
-        parts.push(params.name);
-    if (opts.showPercent && params.percent !== undefined) {
-        parts.push("".concat(params.percent, "%"));
-    }
-    var showVal = opts.showValue !== false &&
-        !opts.showCategoryName &&
-        !opts.showPercent &&
-        !opts.showSeriesName
-        ? true
-        : !!opts.showValue;
-    // 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
-        // scalar `value`.
-        var originalValue = typeof params.data === "object" && params.data
-            ? params.data.originalValue
-            : undefined;
-        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(": ");
-}; };
+var dataLabelFormatter = function (opts, locale, 
+// A treemap block stacks the parts (name, value) on their own lines.
+joiner) {
+    if (joiner === void 0) { joiner = ": "; }
+    return function (params) {
+        var parts = [];
+        if (opts.showSeriesName && params.seriesName)
+            parts.push(params.seriesName);
+        if (opts.showCategoryName && params.name)
+            parts.push(params.name);
+        if (opts.showPercent && params.percent !== undefined) {
+            parts.push("".concat(params.percent, "%"));
+        }
+        // The value shows by default unless another field was asked for instead:
+        // an importer records only the flags that are ON, so `<c:showVal val="0"/>`
+        // + `<c:showBubbleSize val="1"/>` arrives as `{ showBubbleSize: true }` and
+        // must label the bubble with its size alone (#1068 / #1079).
+        var showVal = opts.showValue !== false &&
+            !opts.showCategoryName &&
+            !opts.showPercent &&
+            !opts.showSeriesName &&
+            !opts.showBubbleSize
+            ? true
+            : !!opts.showValue;
+        // 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
+            // scalar `value`.
+            var originalValue = typeof params.data === "object" && params.data
+                ? params.data.originalValue
+                : undefined;
+            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(joiner);
+    };
+};
 exports.dataLabelFormatter = dataLabelFormatter;
 var ECHARTS_DLBL_POS = {
     center: "inside",

package/dist/esm/basic-chart/basic-chart.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"basic-chart.d.ts","sourceRoot":"","sources":["../../../basic-chart/basic-chart.tsx"],"names":[],"mappings":"AAkEA,OAAO,KAAiD,MAAM,OAAO,CAAC;AAEtE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAmRrD,MAAM,MAAM,eAAe,GAAG,oBAAoB,CAAC;AAgFnD,eAAO,MAAM,UAAU,GAAI,gPAkBxB,eAAe,sBA4+GjB,CAAC"}
+{"version":3,"file":"basic-chart.d.ts","sourceRoot":"","sources":["../../../basic-chart/basic-chart.tsx"],"names":[],"mappings":"AAkEA,OAAO,KAAiD,MAAM,OAAO,CAAC;AAEtE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAsTrD,MAAM,MAAM,eAAe,GAAG,oBAAoB,CAAC;AAiGnD,eAAO,MAAM,UAAU,GAAI,gPAkBxB,eAAe,sBA8kHjB,CAAC"}