@rowsncolumns/charts 28.0.0 → 28.1.1

package/dist/esm/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/esm/plotly/basic-chart/helpers.js

@@ -10,6 +10,9 @@ export const chartTypeToPlotlyType = (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/esm/tsconfig.esm.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/esm/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/esm/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/esm/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/esm/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/esm/utils/axis-number-format.js

@@ -0,0 +1,170 @@
+import { ssfFormat } from "@rowsncolumns/utils";
+const patternOf = (format) => format
+    ?.numberFormat?.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.
+ */
+export const isGeneralNumberFormat = (pattern) => !pattern ||
+    pattern.trim().toLowerCase() === "general" ||
+    /^#+(\.[#0]*)?$/.test(pattern.trim());
+/**
+ * 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 const resolveSourceNumberFormat = (sources, getFormattingFromRange, hiddenDimensionStrategy) => {
+    const source = sources?.[0];
+    if (!source || !getFormattingFromRange)
+        return undefined;
+    for (const format of getFormattingFromRange(source, hiddenDimensionStrategy ?? undefined) ?? []) {
+        const pattern = patternOf(format);
+        if (!isGeneralNumberFormat(pattern))
+            return pattern ?? undefined;
+    }
+    return 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 const resolveValueAxisNumberFormat = ({ axisOptions, series, getFormattingFromRange, hiddenDimensionStrategy, }) => {
+    const explicit = axisOptions?.numberFormatPattern;
+    if (explicit)
+        return isGeneralNumberFormat(explicit) ? undefined : explicit;
+    return resolveSourceNumberFormat(series[0]?.sources, getFormattingFromRange, hiddenDimensionStrategy);
+};
+/** Format one numeric value through the resolved pattern; non-numbers pass through. */
+export const formatAxisValue = (pattern, value) => {
+    if (value === undefined || value === null)
+        return "";
+    if (pattern && typeof value === "number")
+        return ssfFormat(pattern, value);
+    return String(value);
+};
+/** echarts `axisLabel.formatter` / `tooltip.valueFormatter` for a value axis. */
+export const valueAxisLabelFormatter = (pattern) => pattern ? (value) => formatAxisValue(pattern, value) : 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 const tooltipValueFormatter = (pattern) => pattern
+    ? (value) => Array.isArray(value)
+        ? value.map((entry) => formatAxisValue(pattern, entry))
+        : formatAxisValue(pattern, value)
+    : 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 const resolveSeriesNumberFormats = (series, getFormattingFromRange, hiddenDimensionStrategy) => (series ?? []).map((entry) => resolveSourceNumberFormat(entry?.sources, getFormattingFromRange, hiddenDimensionStrategy));
+/** echarts pie / doughnut tooltip: `name: value (percent%)` with the value formatted. */
+export const circularTooltipFormatter = (pattern) => (params) => `${params.name ?? ""}: ${formatAxisValue(pattern, params.value)} (${params.percent ?? ""}%)`;
+/**
+ * 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 const numberFormatToPlotlyTicks = (pattern) => {
+    if (isGeneralNumberFormat(pattern))
+        return undefined;
+    const section = firstSection(pattern);
+    let prefix = "";
+    let suffix = "";
+    let digits = "";
+    let percent = false;
+    let seenDigit = false;
+    for (let i = 0; i < section.length; i++) {
+        const ch = section[i];
+        const literal = (text) => {
+            if (seenDigit)
+                suffix += text;
+            else
+                prefix += text;
+        };
+        if (ch === '"') {
+            const end = section.indexOf('"', i + 1);
+            if (end === -1)
+                return undefined;
+            literal(section.slice(i + 1, end));
+            i = end;
+        }
+        else if (ch === "\\") {
+            literal(section[i + 1] ?? "");
+            i += 1;
+        }
+        else if (ch === "[") {
+            const end = section.indexOf("]", i + 1);
+            if (end === -1)
+                return undefined;
+            const token = section.slice(i + 1, end);
+            // `[$€-407]` locale currency → the symbol; color / condition tokens
+            // carry no text.
+            if (token.startsWith("$")) {
+                const 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;
+    const [, fraction = ""] = digits.split(".");
+    const grouping = digits.includes(",") ? "," : "";
+    const decimals = fraction.replace(/[^0#]/g, "").length;
+    const tickformat = `${grouping}.${decimals}${percent ? "%" : "f"}`;
+    const result = { tickformat };
+    if (prefix)
+        result.tickprefix = prefix;
+    if (suffix)
+        result.ticksuffix = suffix;
+    return result;
+};
+const firstSection = (pattern) => {
+    let quoted = false;
+    for (let i = 0; i < pattern.length; i++) {
+        const 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/esm/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/esm/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/esm/utils/category-levels.js

@@ -0,0 +1,65 @@
+/**
+ * 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.
+ */
+const text = (value) => value === null || value === undefined ? "" : String(value);
+/** The resolved level values → the axis shape, or `undefined` when there is nothing to group. */
+export const resolveCategoryLevels = (levels) => {
+    if (!levels || levels.length === 0)
+        return undefined;
+    const leaf = levels[levels.length - 1].map(text);
+    if (leaf.length === 0)
+        return undefined;
+    const outer = levels
+        .slice(0, -1)
+        .map((level) => leaf.map((_, index) => text(level[index])));
+    return { outer, leaf };
+};
+/** plotly `multicategory` x: the outer levels first, the leaf labels last. */
+export const plotlyMulticategoryX = (levels) => [
+    ...levels.outer,
+    levels.leaf,
+];
+/** Index of the first leaf of every run of equal labels in `level`. */
+export const groupStarts = (level) => level.reduce((starts, label, index) => {
+    if (index === 0 || label !== level[index - 1])
+        starts.push(index);
+    return starts;
+}, []);
+/**
+ * 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 const echartsGroupedCategoryAxes = (levels, base, labelOffset = 24) => {
+    const axes = [{ ...base, data: levels.leaf }];
+    // Innermost outer level sits closest to the leaf axis.
+    [...levels.outer].reverse().forEach((level, depth) => {
+        const starts = new Set(groupStarts(level));
+        axes.push({
+            type: "category",
+            position: base.position ?? "bottom",
+            offset: labelOffset * (depth + 1),
+            data: levels.leaf.map((_, index) => `${index}`),
+            show: base.show ?? true,
+            axisLine: { show: false },
+            splitLine: { show: false },
+            axisTick: {
+                show: true,
+                length: labelOffset,
+                interval: (index) => starts.has(index),
+                alignWithLabel: false,
+            },
+            axisLabel: {
+                interval: 0,
+                formatter: (_, index) => starts.has(index) ? level[index] : "",
+            },
+            nameLocation: "middle",
+        });
+    });
+    return axes;
+};

package/dist/esm/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/esm/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/esm/utils/chart-image.js

@@ -0,0 +1,24 @@
+/**
+ * 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 const dataUrlToBlob = (dataUrl) => {
+    if (!dataUrl)
+        return undefined;
+    const match = /^data:([^;,]+)?(;base64)?,([\s\S]*)$/.exec(dataUrl);
+    if (!match || !match[2])
+        return undefined;
+    const mime = match[1] || "image/png";
+    try {
+        const binary = atob(match[3]);
+        const bytes = new Uint8Array(binary.length);
+        for (let i = 0; i < binary.length; i++)
+            bytes[i] = binary.charCodeAt(i);
+        return new Blob([bytes], { type: mime });
+    }
+    catch {
+        return undefined;
+    }
+};

package/dist/esm/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/esm/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"}