@rowsncolumns/charts 28.1.18 → 28.1.19

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

@@ -0,0 +1,111 @@
+"use strict";
+/**
+ * Excel's line-chart analysis elements (Chart Design → Add Chart Element →
+ * Lines / Up/Down Bars, demo-app-monorepo#49969 FT-08) as echarts bar series
+ * over the category axis:
+ *
+ * - High-low lines — a thin vertical line per category from the lowest to the
+ *   highest value of all the line series (`<c:hiLowLines/>`).
+ * - Up/down bars — a bar per category from the first line series' value to
+ *   the last one's: an up bar (white) where the last is higher, a down bar
+ *   (dark) where it is lower (`<c:upDownBars>`).
+ * - Drop lines — a thin vertical line per category from the axis to the
+ *   highest point (`<c:dropLines/>`).
+ *
+ * Each is a stack of an invisible base plus a visible span, so the bars can
+ * start anywhere on the value axis; `barGap: "-100%"` lays every one of them
+ * over the category's centre instead of side by side.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildChartLineSeries = exports.CHART_LINE_SERIES_PREFIX = void 0;
+var tslib_1 = require("tslib");
+exports.CHART_LINE_SERIES_PREFIX = "rnc-chart-lines-";
+var finite = function (item) {
+    var raw = item !== null && typeof item === "object" && "value" in item
+        ? item.value
+        : item;
+    return typeof raw === "number" && Number.isFinite(raw) ? raw : undefined;
+};
+/** Excel's line colour for these elements: Text 1 at 75% (#404040). */
+var LINE_COLOR = "#404040";
+var spanSeries = function (_a) {
+    var id = _a.id, base = _a.base, span = _a.span, barWidth = _a.barWidth, itemStyle = _a.itemStyle, yAxisIndex = _a.yAxisIndex;
+    var common = tslib_1.__assign({ type: "bar", stack: "".concat(exports.CHART_LINE_SERIES_PREFIX).concat(id), stackStrategy: "all", barWidth: barWidth, barGap: "-100%", silent: true, legendHoverLink: false, tooltip: { show: false }, emphasis: { disabled: true }, label: { show: false }, z: 1 }, (yAxisIndex ? { yAxisIndex: yAxisIndex } : {}));
+    return [
+        tslib_1.__assign(tslib_1.__assign({}, common), { id: "".concat(exports.CHART_LINE_SERIES_PREFIX).concat(id, "-base"), data: base, itemStyle: { color: "transparent" } }),
+        tslib_1.__assign(tslib_1.__assign({}, common), { id: "".concat(exports.CHART_LINE_SERIES_PREFIX).concat(id), data: span, itemStyle: itemStyle }),
+    ];
+};
+/**
+ * The extra series for `options`, given the data of the chart's line series
+ * on one value axis, in spec order.
+ */
+var buildChartLineSeries = function (options, lines, _a) {
+    var _b, _c, _d;
+    var _e = _a === void 0 ? {} : _a, isDarkMode = _e.isDarkMode, yAxisIndex = _e.yAxisIndex;
+    var color = isDarkMode ? "rgba(255,255,255,0.65)" : LINE_COLOR;
+    var length = lines.reduce(function (n, data) { return Math.max(n, data.length); }, 0);
+    var out = [];
+    var extent = function (i) {
+        var values = lines.map(function (data) { return finite(data[i]); }).filter(function (v) { return v !== undefined; });
+        return values.length
+            ? { low: Math.min.apply(Math, tslib_1.__spreadArray([], tslib_1.__read(values), false)), high: Math.max.apply(Math, tslib_1.__spreadArray([], tslib_1.__read(values), false)), count: values.length }
+            : undefined;
+    };
+    if (options.dropLines && lines.length) {
+        var base = [];
+        var span = [];
+        for (var i = 0; i < length; i++) {
+            var e = extent(i);
+            base.push(e ? 0 : null);
+            span.push(e ? e.high : null);
+        }
+        out.push.apply(out, tslib_1.__spreadArray([], tslib_1.__read(spanSeries({ id: "drop", base: base, span: span, barWidth: 1, itemStyle: { color: color }, yAxisIndex: yAxisIndex })), false));
+    }
+    if (options.hiLowLines && lines.length > 1) {
+        var base = [];
+        var span = [];
+        for (var i = 0; i < length; i++) {
+            var e = extent(i);
+            var drawn = e && e.count > 1;
+            base.push(drawn ? e.low : null);
+            span.push(drawn ? e.high - e.low : null);
+        }
+        out.push.apply(out, tslib_1.__spreadArray([], tslib_1.__read(spanSeries({ id: "hilow", base: base, span: span, barWidth: 1, itemStyle: { color: color }, yAxisIndex: yAxisIndex })), false));
+    }
+    if (options.upDownBars && lines.length > 1) {
+        var first = lines[0];
+        var last = lines[lines.length - 1];
+        var up = (_b = options.upDownBars.upColor) !== null && _b !== void 0 ? _b : "#FFFFFF";
+        var down = (_c = options.upDownBars.downColor) !== null && _c !== void 0 ? _c : (isDarkMode ? "#A6A6A6" : "#595959");
+        var base = [];
+        var span = [];
+        for (var i = 0; i < length; i++) {
+            var open_1 = finite(first[i]);
+            var close_1 = finite(last[i]);
+            if (open_1 === undefined || close_1 === undefined) {
+                base.push(null);
+                span.push(null);
+                continue;
+            }
+            base.push(Math.min(open_1, close_1));
+            span.push({
+                value: Math.abs(close_1 - open_1),
+                itemStyle: { color: close_1 >= open_1 ? up : down },
+            });
+        }
+        // `<c:gapWidth>` is the gap as a % of the bar: the bar is 1 / (1 + gap) of the category.
+        var gap = (_d = options.upDownBars.gapWidth) !== null && _d !== void 0 ? _d : 150;
+        var barWidth = "".concat(Math.round(100 / (1 + Math.max(0, gap) / 100)), "%");
+        out.push.apply(out, tslib_1.__spreadArray([], tslib_1.__read(spanSeries({
+            id: "updown",
+            base: base,
+            span: span,
+            barWidth: barWidth,
+            itemStyle: { borderColor: color, borderWidth: 1 },
+            yAxisIndex: yAxisIndex,
+        })), false));
+    }
+    return out;
+};
+exports.buildChartLineSeries = buildChartLineSeries;

package/dist/cjs/utils/data-table.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Excel's chart data table (Add Chart Element → Data Table,
+ * demo-app-monorepo#49969 FT-08): one row per series under the category
+ * axis, each cell under its category, the series name (with its legend key)
+ * at the row's start. Drawn as extra category axes stacked below the plot:
+ * their labels are the formatted values, their axis line the horizontal
+ * border and their ticks — between categories — the vertical borders.
+ */
+export type DataTableOptions = {
+    showHorizontalBorder?: boolean | null;
+    showVerticalBorder?: boolean | null;
+    showOutline?: boolean | null;
+    showLegendKeys?: boolean | null;
+};
+export type DataTableRow = {
+    name: string;
+    color?: string;
+    values: string[];
+};
+/** Row height in pixels: 9 pt text plus padding. */
+export declare const DATA_TABLE_ROW_HEIGHT = 20;
+export declare const dataTableAxes: (rows: ReadonlyArray<DataTableRow>, options: DataTableOptions, { textColor, fontSize, borderColor, firstOffset, }: {
+    textColor: string;
+    fontSize: number;
+    borderColor?: string;
+    /** Below the category labels (the table's header row). */
+    firstOffset?: number;
+}) => Record<string, unknown>[];
+/** Room the row names need left of the plot (approximate glyph width). */
+export declare const dataTableNameWidth: (rows: ReadonlyArray<DataTableRow>, fontSize: number, legendKeys: boolean) => number;
+//# sourceMappingURL=data-table.d.ts.map

package/dist/cjs/utils/data-table.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-table.d.ts","sourceRoot":"","sources":["../../../utils/data-table.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,oBAAoB,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACtC,kBAAkB,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACpC,WAAW,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC7B,cAAc,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CAAC;AAEF,oDAAoD;AACpD,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAExC,eAAO,MAAM,aAAa,GACxB,MAAM,aAAa,CAAC,YAAY,CAAC,EACjC,SAAS,gBAAgB,EACzB,oDAKG;IACD,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,KACA,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAqCtB,CAAC;AAEL,0EAA0E;AAC1E,eAAO,MAAM,kBAAkB,GAC7B,MAAM,aAAa,CAAC,YAAY,CAAC,EACjC,UAAU,MAAM,EAChB,YAAY,OAAO,WAQb,CAAC"}

package/dist/cjs/utils/data-table.js

@@ -0,0 +1,61 @@
+"use strict";
+/**
+ * Excel's chart data table (Add Chart Element → Data Table,
+ * demo-app-monorepo#49969 FT-08): one row per series under the category
+ * axis, each cell under its category, the series name (with its legend key)
+ * at the row's start. Drawn as extra category axes stacked below the plot:
+ * their labels are the formatted values, their axis line the horizontal
+ * border and their ticks — between categories — the vertical borders.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dataTableNameWidth = exports.dataTableAxes = exports.DATA_TABLE_ROW_HEIGHT = void 0;
+/** Row height in pixels: 9 pt text plus padding. */
+exports.DATA_TABLE_ROW_HEIGHT = 20;
+var dataTableAxes = function (rows, options, _a) {
+    var textColor = _a.textColor, fontSize = _a.fontSize, _b = _a.borderColor, borderColor = _b === void 0 ? "#D9D9D9" : _b, _c = _a.firstOffset, firstOffset = _c === void 0 ? 22 : _c;
+    return rows.map(function (row, index) {
+        var _a;
+        var keys = options.showLegendKeys !== false;
+        return {
+            type: "category",
+            position: "bottom",
+            gridIndex: 0,
+            offset: firstOffset + index * exports.DATA_TABLE_ROW_HEIGHT,
+            data: row.values,
+            silent: true,
+            axisLine: {
+                show: options.showHorizontalBorder !== false ||
+                    (options.showOutline !== false && index === rows.length - 1),
+                onZero: false,
+                lineStyle: { color: borderColor },
+            },
+            axisTick: {
+                show: options.showVerticalBorder !== false,
+                interval: 0,
+                length: exports.DATA_TABLE_ROW_HEIGHT,
+                lineStyle: { color: borderColor },
+            },
+            axisLabel: { interval: 0, color: textColor, fontSize: fontSize, margin: 6 },
+            splitLine: { show: false },
+            name: keys ? "{key|\u25A0} ".concat(row.name) : row.name,
+            nameLocation: "start",
+            nameGap: 8,
+            nameTextStyle: {
+                color: textColor,
+                fontSize: fontSize,
+                align: "right",
+                verticalAlign: "top",
+                padding: [6, 0, 0, 0],
+                rich: { key: { color: (_a = row.color) !== null && _a !== void 0 ? _a : textColor, fontSize: fontSize } },
+            },
+        };
+    });
+};
+exports.dataTableAxes = dataTableAxes;
+/** Room the row names need left of the plot (approximate glyph width). */
+var dataTableNameWidth = function (rows, fontSize, legendKeys) {
+    return Math.ceil(rows.reduce(function (width, row) {
+        return Math.max(width, (row.name.length + (legendKeys ? 2 : 0)) * fontSize * 0.6);
+    }, 0)) + 12;
+};
+exports.dataTableNameWidth = dataTableNameWidth;

package/dist/cjs/utils/excel-axis-scale.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Excel's automatic value-axis scale (Format Axis → Bounds / Units left on
+ * "Auto"). Excel does not publish the rule; this is the behaviour Jon Peltier
+ * measured ("How Excel Calculates Automatic Chart Axis Limits",
+ * peltiertech.com) and that LV-05 of demo-app-monorepo#49969 compared:
+ *
+ * - The minimum is 0 when every value is ≥ 0 and the data spans more than a
+ *   sixth of the maximum (the mirror rule pins the maximum to 0 for an
+ *   all-negative series); a narrower positive range starts half its span
+ *   below the smallest value.
+ * - The maximum is the largest value plus 5% of the range, rounded up to the
+ *   next major unit (so data ending at 17 gets an 18 ceiling, 100 gets 120).
+ * - The major unit is the smallest 1-2-5 step that splits the range into at
+ *   most ten intervals.
+ *
+ * echarts' own nicing (1-2-3-5 steps aimed at five intervals) gives steps of
+ * 3 or 25 Excel never draws, so the renderer hands echarts these bounds.
+ */
+export type ExcelAxisScale = {
+    min: number;
+    max: number;
+    interval: number;
+};
+export declare const excelAutoAxisScale: (values: Iterable<number>, fixed?: {
+    min?: number | null;
+    max?: number | null;
+    majorUnit?: number | null;
+}) => ExcelAxisScale | undefined;
+/**
+ * The values a cartesian value axis has to fit: every point of the bar / line
+ * series plotted against `axisIndex`, with stacked series summed per category
+ * (positives and negatives apart, as Excel stacks them).
+ */
+export declare const valueAxisExtentValues: (series: ReadonlyArray<any>, axisIndex: number, axisKey?: "yAxisIndex" | "xAxisIndex") => number[];
+//# sourceMappingURL=excel-axis-scale.d.ts.map

package/dist/cjs/utils/excel-axis-scale.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"excel-axis-scale.d.ts","sourceRoot":"","sources":["../../../utils/excel-axis-scale.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,MAAM,cAAc,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAiB5E,eAAO,MAAM,kBAAkB,GAC7B,QAAQ,QAAQ,CAAC,MAAM,CAAC,EACxB,QAAO;IAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAO,KAClF,cAAc,GAAG,SA6CnB,CAAC;AAYF;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,GAChC,QAAQ,aAAa,CAAC,GAAG,CAAC,EAC1B,WAAW,MAAM,EACjB,UAAS,YAAY,GAAG,YAA2B,KAClD,MAAM,EA6BR,CAAC"}

package/dist/cjs/utils/excel-axis-scale.js

@@ -0,0 +1,210 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.valueAxisExtentValues = exports.excelAutoAxisScale = void 0;
+var tslib_1 = require("tslib");
+var MAX_INTERVALS = 10;
+var niceSteps = function (span) {
+    var exponent = Math.floor(Math.log10(span / MAX_INTERVALS));
+    var steps = [];
+    for (var e = exponent - 1; e <= exponent + 2; e++) {
+        var base = Math.pow(10, e);
+        steps.push(base, 2 * base, 5 * base);
+    }
+    return steps;
+};
+/** Floating-point safe multiple of `step` (`0.1 * 3` would print 0.30000000000000004). */
+var multiple = function (k, step) { return Number((k * step).toPrecision(12)); };
+var excelAutoAxisScale = function (values, fixed) {
+    var e_1, _a, e_2, _b;
+    if (fixed === void 0) { fixed = {}; }
+    var dataMin = Infinity;
+    var dataMax = -Infinity;
+    try {
+        for (var values_1 = tslib_1.__values(values), values_1_1 = values_1.next(); !values_1_1.done; values_1_1 = values_1.next()) {
+            var v = values_1_1.value;
+            if (!Number.isFinite(v))
+                continue;
+            if (v < dataMin)
+                dataMin = v;
+            if (v > dataMax)
+                dataMax = v;
+        }
+    }
+    catch (e_1_1) { e_1 = { error: e_1_1 }; }
+    finally {
+        try {
+            if (values_1_1 && !values_1_1.done && (_a = values_1.return)) _a.call(values_1);
+        }
+        finally { if (e_1) throw e_1.error; }
+    }
+    if (!Number.isFinite(dataMin))
+        return undefined;
+    if (dataMin === dataMax) {
+        // One distinct value: Excel spans 0..value (or value..0).
+        if (dataMin > 0)
+            dataMin = 0;
+        else if (dataMax < 0)
+            dataMax = 0;
+        else
+            dataMax = 1;
+    }
+    var fixedMin = typeof fixed.min === "number" ? fixed.min : undefined;
+    var fixedMax = typeof fixed.max === "number" ? fixed.max : undefined;
+    var lo;
+    if (fixedMin !== undefined)
+        lo = fixedMin;
+    else if (dataMin >= 0)
+        lo = (dataMax - dataMin) / dataMax > 1 / 6 ? 0 : dataMin - (dataMax - dataMin) / 2;
+    else if (dataMax <= 0)
+        lo = dataMin - 0.05 * (0 - dataMin);
+    else
+        lo = dataMin - 0.05 * (dataMax - dataMin);
+    var hi;
+    if (fixedMax !== undefined)
+        hi = fixedMax;
+    else if (dataMax <= 0)
+        hi = (dataMax - dataMin) / -dataMin > 1 / 6 ? 0 : dataMax + (dataMax - dataMin) / 2;
+    else
+        hi = dataMax + 0.05 * (dataMax - lo);
+    if (!(hi > lo))
+        return undefined;
+    var pick = function (step) {
+        var min = fixedMin !== undefined ? fixedMin : multiple(Math.floor(lo / step), step);
+        var max = fixedMax !== undefined ? fixedMax : multiple(Math.ceil(hi / step), step);
+        return { min: min, max: max, interval: step };
+    };
+    if (typeof fixed.majorUnit === "number" && fixed.majorUnit > 0) {
+        return pick(fixed.majorUnit);
+    }
+    try {
+        for (var _c = tslib_1.__values(niceSteps(hi - lo)), _d = _c.next(); !_d.done; _d = _c.next()) {
+            var step = _d.value;
+            var scale = pick(step);
+            if ((scale.max - scale.min) / step <= MAX_INTERVALS + 1e-9)
+                return scale;
+        }
+    }
+    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; }
+    }
+    return undefined;
+};
+exports.excelAutoAxisScale = excelAutoAxisScale;
+var pointValue = function (item) {
+    var raw = item !== null && typeof item === "object" && "value" in item
+        ? item.value
+        : item;
+    if (Array.isArray(raw))
+        return undefined;
+    var n = typeof raw === "number" ? raw : raw == null || raw === "" ? NaN : Number(raw);
+    return Number.isFinite(n) ? n : undefined;
+};
+/**
+ * The values a cartesian value axis has to fit: every point of the bar / line
+ * series plotted against `axisIndex`, with stacked series summed per category
+ * (positives and negatives apart, as Excel stacks them).
+ */
+var valueAxisExtentValues = function (series, axisIndex, axisKey) {
+    var e_3, _a, e_4, _b, e_5, _c, e_6, _d;
+    var _e, _f, _g;
+    if (axisKey === void 0) { axisKey = "yAxisIndex"; }
+    var values = [];
+    var stacks = new Map();
+    var _loop_1 = function (s) {
+        var e_7, _l;
+        if (!s || (s.type !== "bar" && s.type !== "line"))
+            return "continue";
+        // High-low / drop lines and up/down bars only span the plotted values.
+        if (String((_e = s.id) !== null && _e !== void 0 ? _e : "").startsWith("rnc-chart-lines-"))
+            return "continue";
+        if (((_f = s[axisKey]) !== null && _f !== void 0 ? _f : 0) !== axisIndex || !Array.isArray(s.data))
+            return "continue";
+        if (s.stack === undefined) {
+            try {
+                for (var _m = (e_7 = void 0, tslib_1.__values(s.data)), _o = _m.next(); !_o.done; _o = _m.next()) {
+                    var item = _o.value;
+                    var v = pointValue(item);
+                    if (v !== undefined)
+                        values.push(v);
+                }
+            }
+            catch (e_7_1) { e_7 = { error: e_7_1 }; }
+            finally {
+                try {
+                    if (_o && !_o.done && (_l = _m.return)) _l.call(_m);
+                }
+                finally { if (e_7) throw e_7.error; }
+            }
+            return "continue";
+        }
+        var stack = (_g = stacks.get(s.stack)) !== null && _g !== void 0 ? _g : { pos: [], neg: [] };
+        stacks.set(s.stack, stack);
+        s.data.forEach(function (item, i) {
+            var _a;
+            var v = pointValue(item);
+            if (v === undefined)
+                return;
+            var side = v >= 0 ? stack.pos : stack.neg;
+            side[i] = ((_a = side[i]) !== null && _a !== void 0 ? _a : 0) + v;
+        });
+    };
+    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;
+            _loop_1(s);
+        }
+    }
+    catch (e_3_1) { e_3 = { error: e_3_1 }; }
+    finally {
+        try {
+            if (series_1_1 && !series_1_1.done && (_a = series_1.return)) _a.call(series_1);
+        }
+        finally { if (e_3) throw e_3.error; }
+    }
+    try {
+        for (var _h = tslib_1.__values(stacks.values()), _j = _h.next(); !_j.done; _j = _h.next()) {
+            var _k = _j.value, pos = _k.pos, neg = _k.neg;
+            try {
+                for (var pos_1 = (e_5 = void 0, tslib_1.__values(pos)), pos_1_1 = pos_1.next(); !pos_1_1.done; pos_1_1 = pos_1.next()) {
+                    var v = pos_1_1.value;
+                    if (v !== undefined)
+                        values.push(v);
+                }
+            }
+            catch (e_5_1) { e_5 = { error: e_5_1 }; }
+            finally {
+                try {
+                    if (pos_1_1 && !pos_1_1.done && (_c = pos_1.return)) _c.call(pos_1);
+                }
+                finally { if (e_5) throw e_5.error; }
+            }
+            try {
+                for (var neg_1 = (e_6 = void 0, tslib_1.__values(neg)), neg_1_1 = neg_1.next(); !neg_1_1.done; neg_1_1 = neg_1.next()) {
+                    var v = neg_1_1.value;
+                    if (v !== undefined)
+                        values.push(v);
+                }
+            }
+            catch (e_6_1) { e_6 = { error: e_6_1 }; }
+            finally {
+                try {
+                    if (neg_1_1 && !neg_1_1.done && (_d = neg_1.return)) _d.call(neg_1);
+                }
+                finally { if (e_6) throw e_6.error; }
+            }
+        }
+    }
+    catch (e_4_1) { e_4 = { error: e_4_1 }; }
+    finally {
+        try {
+            if (_j && !_j.done && (_b = _h.return)) _b.call(_h);
+        }
+        finally { if (e_4) throw e_4.error; }
+    }
+    return values;
+};
+exports.valueAxisExtentValues = valueAxisExtentValues;

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

@@ -7,6 +7,20 @@ import type { LegendComponentOption } from "echarts";
  * Underline / strikethrough have no canvas text decoration in echarts and
  * are not drawn.
  */
+/**
+ * `ChartTextFormat.fontSize` is in points (OOXML `sz` / 100, the editor's
+ * Size field); echarts draws pixels. 9 pt → 12 px, 14 pt → 18.67 px.
+ */
+export declare const pointsToPixels: (points: number) => number;
+/** An authored point size as pixels, or `fallbackPx` when none is set. */
+export declare const fontSizePx: (points: unknown, fallbackPx: number) => number;
+/**
+ * Excel's chart text defaults (Office 2013+ chart styles): the theme's body
+ * (minor) font, 9 pt in Text 1 at 65% (#595959 on the light theme), and a
+ * 14 pt regular title (RD-24).
+ */
+export declare const CHART_TEXT_PX: number;
+export declare const CHART_TITLE_PX: number;
 export declare const themedTextStyle: (fmt: any, defaults: {
     color: string;
     fontSize: number;
@@ -15,19 +29,26 @@ export declare const themedTextStyle: (fmt: any, defaults: {
 }) => {
     color: any;
     fontFamily: any;
-    fontSize: any;
+    fontSize: number;
     fontWeight: "bold" | "normal";
     fontStyle: "italic" | "normal";
 };
 /** Build an echarts `textStyle` from a parsed `ChartTextFormat`. */
 export declare const textFormatToEchartsTextStyle: (fmt: any) => Record<string, any> | undefined;
 export declare const applyLegendOverrides: (legend: LegendComponentOption, opts: any) => LegendComponentOption;
+/** Excel's Format Axis → Display units: the divisor and the label it shows. */
+export declare const DISPLAY_UNITS: Record<string, {
+    divisor: number;
+    label: string;
+}>;
 /**
  * `numberFormatPattern` is the axis' RESOLVED format (explicit pattern or
  * the linked source-cell format — see `resolveValueAxisNumberFormat`); it
- * becomes the tick-label formatter.
+ * becomes the tick-label formatter. `placement` says which side of the plot
+ * the axis runs along (`x` horizontal, `y` vertical) for Excel's axis
+ * crossing; it defaults to `x` for a category axis and `y` for a value axis.
  */
-export declare const applyAxisOverrides: (axis: any, opts: any, numberFormatPattern?: string, locale?: string) => any;
+export declare const applyAxisOverrides: (axis: any, opts: any, numberFormatPattern?: string, locale?: string, placement?: "x" | "y") => any;
 export declare const dataLabelFormatter: (opts: any, locale?: string, joiner?: string) => (params: any) => string;
 /**
  * The data-label options one series renders with: its own

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;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,GAC1B,KAAK,GAAG,EACR,UAAU;IACR,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;CAChC;;;;gBASG,MAAM,GACN,QAAQ;eACsC,QAAQ,GAAG,QAAQ;CACrE,CAAC;AAEH,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;aAoHhB,CAAC"}
+{"version":3,"file":"overrides.d.ts","sourceRoot":"","sources":["../../../utils/overrides.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAWrD;;;;;;;GAOG;AACH;;;GAGG;AACH,eAAO,MAAM,cAAc,GAAI,QAAQ,MAAM,WACD,CAAC;AAE7C,0EAA0E;AAC1E,eAAO,MAAM,UAAU,GAAI,QAAQ,OAAO,EAAE,YAAY,MAAM,WACkB,CAAC;AAEjF;;;;GAIG;AACH,eAAO,MAAM,aAAa,QAAoB,CAAC;AAC/C,eAAO,MAAM,cAAc,QAAqB,CAAC;AAEjD,eAAO,MAAM,eAAe,GAC1B,KAAK,GAAG,EACR,UAAU;IACR,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;CAChC;;;;gBAMG,MAAM,GACN,QAAQ;eACsC,QAAQ,GAAG,QAAQ;CACrE,CAAC;AAEH,oEAAoE;AACpE,eAAO,MAAM,4BAA4B,GAAI,KAAK,GAAG,oCAWpD,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAC/B,QAAQ,qBAAqB,EAC7B,MAAM,GAAG,KACR,qBA6CF,CAAC;AAEF,+EAA+E;AAC/E,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAU5E,CAAC;AAKF;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,GAC7B,MAAM,GAAG,EACT,MAAM,GAAG,EACT,sBAAsB,MAAM,EAC5B,SAAS,MAAM,EACf,YAAY,GAAG,GAAG,GAAG,QAmGtB,CAAC;AAgBF,eAAO,MAAM,kBAAkB,GAC7B,MAAM,GAAG,EACT,SAAS,MAAM,EAEf,eAAa,MACT,QAAQ,GAAG,WA0DhB,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;;;iCAxGH,GAAG;aA0HhB,CAAC"}