@rowsncolumns/charts 28.1.1 → 28.1.4

package/dist/esm/components/editors/chart-editor.js

@@ -482,13 +482,13 @@ export const ChartEditor = ({ chart, sheetId, onSubmit, onRequestMoveChart, getF
                         }))),
                     React.createElement(Stack, { direction: "vertical", className: "gap-1 pb-2" },
                         React.createElement("label", { className: "font-system text-sm" }, "Quick layout"),
-                        React.createElement("select", { className: "border border-rnc-border rounded-sm px-1 py-1 text-xs bg-transparent w-32", value: "", "aria-label": "Quick layout", onChange: (e) => {
+                        React.createElement("select", { className: "border border-rnc-border rounded-sm px-1 py-1 text-xs bg-transparent w-32", value: values.spec.quickLayout ?? "", "aria-label": "Quick layout", onChange: (e) => {
                                 const layout = CHART_QUICK_LAYOUTS.find((entry) => String(entry.id) === e.target.value);
                                 if (layout) {
                                     setFieldValue("spec", applyChartQuickLayout(values.spec, layout));
                                 }
                             } },
-                            React.createElement("option", { value: "" }, "Choose a layout\u2026"),
+                            React.createElement("option", { value: "", disabled: true }, "Choose a layout\u2026"),
                             CHART_QUICK_LAYOUTS.map((layout) => (React.createElement("option", { key: layout.id, value: layout.id }, layout.label))))),
                     React.createElement("div", null,
                         React.createElement(Button, { type: "button", size: "xs", onClick: () => setFieldValue("spec", resetChartToMatchStyle(values.spec)) }, "Reset to match style")),

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

@@ -1 +1 @@
-{"version":3,"file":"basic-chart.d.ts","sourceRoot":"","sources":["../../../../plotly/basic-chart/basic-chart.tsx"],"names":[],"mappings":"AA6BA,OAAO,KAAiD,MAAM,OAAO,CAAC;AAGtE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AA4VxD,MAAM,MAAM,eAAe,GAAG,oBAAoB,CAAC;AA0FnD,eAAO,MAAM,UAAU,GAAI,wOAiBxB,eAAe,sBAmrEjB,CAAC"}
+{"version":3,"file":"basic-chart.d.ts","sourceRoot":"","sources":["../../../../plotly/basic-chart/basic-chart.tsx"],"names":[],"mappings":"AA6BA,OAAO,KAAiD,MAAM,OAAO,CAAC;AAGtE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AA+WxD,MAAM,MAAM,eAAe,GAAG,oBAAoB,CAAC;AA0FnD,eAAO,MAAM,UAAU,GAAI,wOAiBxB,eAAe,sBAg0EjB,CAAC"}

package/dist/esm/plotly/basic-chart/basic-chart.js

@@ -6,17 +6,18 @@ import { debug, isAFormula, isNil, ssfFormat } from "@rowsncolumns/utils";
 import React, { useCallback, useMemo, useRef, useState } from "react";
 import Plot from "react-plotly.js";
 import { aggregateSeriesByDomain, getDomainValuesForAxis, sanitizeDomainValues, shouldAggregateSeries, } from "../../utils/aggregation";
-import { formatAxisValue, numberFormatToPlotlyTicks, resolveSeriesNumberFormats, resolveValueAxisNumberFormat, } from "../../utils/axis-number-format";
+import { formatAxisValue, numberFormatToPlotlyTicks, resolveSeriesNumberFormats, resolveValueAxisNumberFormat, valueAxisNameGap, } from "../../utils/axis-number-format";
 import { computeBoxplotSummary } from "../../utils/boxplot";
 import { createBubbleSizeScale, prepareBubbleSeriesData, toLabelString, } from "../../utils/bubble";
 import { canSwitchRowColumn, cellLabelGetterFromRangeReader, switchRowColumn, } from "../../utils/chart-orientation";
 import { dataUrlToBlob } from "../../utils/chart-image";
 import { getChartPalette } from "../../utils/chart-styles";
 import { coerceCalculatedLabel } from "../../utils/chart-spec-utils";
-import { applyEmptyCellsPolicy, connectsAcrossEmptyCells, isLineLikeChartType, } from "../../utils/empty-cells";
+import { applyEmptyCellsPolicy, connectsAcrossEmptyCells, isLineLikeChartType, isolatedPointIndexes, } from "../../utils/empty-cells";
 import { computeErrorBars, resolveCustomErrorBarValues, } from "../../utils/error-bars";
 import { plotlyMulticategoryX, resolveCategoryLevels, } from "../../utils/category-levels";
 import { gradientToPlotly } from "../../utils/gradient";
+import { BAND_GAP, legendLabelsFrom, measureTextWidth, reservePlotlyLegendBand, } from "../../utils/legend-layout";
 import { plotlyTitleText } from "../../utils/plotly-title";
 import { explosionToPlotlyPull, resolveExplosion, } from "../../utils/pie-explosion";
 import { resolvePlotlyClickSelection, wasDragged, } from "../../utils/plotly-click";
@@ -115,6 +116,16 @@ const applyLegendOverridesPlotly = (legend, opts) => {
     next.font = applyTextFormatToFont(next.font, opts.textFormat);
     return { legend: next, showlegend: true };
 };
+/**
+ * `title.standoff` for a VALUE axis. Without it plotly places the axis title
+ * a fixed ~34px from the axis line and only nudges it off the tick labels
+ * after measuring them — a currency axis ("$2,000,000.00") is wider than
+ * that, and on the first paint (before `automargin` has grown the margin)
+ * the title lands on top of its own tick labels. With a standoff plotly
+ * positions the title at `tick-label depth + standoff`, so it always clears
+ * the labels, and `automargin` grows the margin to fit (#37265 A8).
+ */
+const VALUE_AXIS_TITLE_STANDOFF = 12;
 /**
  * `numberFormatPattern` is the axis' RESOLVED format (explicit pattern or
  * the linked source-cell format). Plotly formats ticks AND hover values
@@ -1006,7 +1017,7 @@ export const BasicChart = ({ width, height, chart, theme, isDarkMode, sheetId, r
         // to 100 (plotly `groupnorm`); Excel's "Line with Markers"
         // (spec.showMarkers) or a series' own marker switches the line trace
         // to lines+markers, and a series marker of "none" hides them.
-        const lineTraceVariant = (series, effectiveChartType) => {
+        const lineTraceVariant = (series, effectiveChartType, values) => {
             if (effectiveChartType !== "line" && effectiveChartType !== "area") {
                 return {};
             }
@@ -1027,6 +1038,22 @@ export const BasicChart = ({ width, height, chart, theme, isDarkMode, sheetId, r
                         size: marker?.size ?? 6,
                     };
                 }
+                else {
+                    // A marker-less line draws nothing for a point with a gap on both sides (a data
+                    // row followed by a blank row — the first row included), so that row vanishes from
+                    // the chart. Excel plots an isolated marker there: keep the line and give only those
+                    // points a marker (plotly's `marker.size` / `marker.opacity` are per-point arrays;
+                    // a 0-size, 0-opacity marker paints nothing on the connected points).
+                    const isolated = new Set(isolatedPointIndexes(values, connectsAcrossEmptyCells(spec, true)));
+                    if (isolated.size) {
+                        extra.mode = "lines+markers";
+                        extra.marker = {
+                            symbol: "circle",
+                            size: values.map((_, i) => (isolated.has(i) ? 6 : 0)),
+                            opacity: values.map((_, i) => (isolated.has(i) ? 1 : 0)),
+                        };
+                    }
+                }
             }
             return extra;
         };
@@ -1714,7 +1741,7 @@ export const BasicChart = ({ width, height, chart, theme, isDarkMode, sheetId, r
                     name: dataLabel,
                     stackgroup: isStacked ? "one" : undefined,
                     ...seriesTraceStyle,
-                    ...lineTraceVariant(series, effectiveChartType),
+                    ...lineTraceVariant(series, effectiveChartType, seriesData.values),
                 };
                 // Ties the trace back to spec.series for click selection
                 trace.meta = {
@@ -1744,7 +1771,7 @@ export const BasicChart = ({ width, height, chart, theme, isDarkMode, sheetId, r
                     name: dataLabel,
                     stackgroup: isStacked ? "one" : undefined,
                     ...seriesTraceStyle,
-                    ...lineTraceVariant(series, effectiveChartType),
+                    ...lineTraceVariant(series, effectiveChartType, numericValues),
                 };
                 // Ties the trace back to spec.series for click selection
                 trace.meta = {
@@ -1786,6 +1813,65 @@ export const BasicChart = ({ width, height, chart, theme, isDarkMode, sheetId, r
             getFormattingFromRange,
             hiddenDimensionStrategy: spec.hiddenDimensionStrategy,
         });
+        // Legend position / visibility from the spec, then a band reserved
+        // for it outside the axis titles and tick labels so it never paints
+        // over them — Excel shrinks the plot area instead (#986).
+        const { legend: legendOverrides, showlegend } = applyLegendOverridesPlotly({ font: { color: textColor } }, spec.legend);
+        const axisFontSize = 12;
+        const primaryValues = traces.flatMap((trace) => {
+            const values = isHorizontalBarChart ? trace?.x : trace?.y;
+            return trace?.[valueAxisKey] === secondaryValueAxisRef || !Array.isArray(values)
+                ? []
+                : values;
+        });
+        // Tick-label depth of the left axis: value labels formatted from the
+        // plotted extremes on a vertical chart, the widest category on a
+        // horizontal bar; plus the rotated axis title band when present.
+        const leftAxisLabelDepth = isHorizontalBarChart
+            ? Math.ceil(Math.max(0, ...(domainData ?? []).map((label) => measureTextWidth(String(label ?? ""), axisFontSize)))) + 8
+            : valueAxisNameGap({
+                values: primaryValues,
+                pattern: primaryAxisNumberFormat,
+                fontSize: axisFontSize,
+                minimum: 0,
+            }) -
+                axisFontSize -
+                6;
+        const leftAxisDepth = leftAxisLabelDepth +
+            (spec.verticalAxisTitle
+                ? VALUE_AXIS_TITLE_STANDOFF + Math.ceil(axisFontSize * 1.3)
+                : 0);
+        const rightAxisDepth = hasSecondaryAxis && !isHorizontalBarChart
+            ? valueAxisNameGap({
+                values: traces.flatMap((trace) => trace?.[valueAxisKey] === secondaryValueAxisRef && Array.isArray(trace?.y)
+                    ? trace.y
+                    : []),
+                pattern: secondaryAxisNumberFormat,
+                fontSize: axisFontSize,
+                minimum: 0,
+            }) -
+                axisFontSize -
+                6
+            : 0;
+        const bottomAxisTitleStandoff = isHorizontalBarChart
+            ? VALUE_AXIS_TITLE_STANDOFF
+            : BAND_GAP;
+        const legendBand = reservePlotlyLegendBand({
+            position: spec.legend?.position,
+            visible: showlegend !== false,
+            labels: legendLabelsFrom(undefined, traces.map((trace) => trace?.name)),
+            legendFontSize: spec.legend?.textFormat?.fontSize ?? axisFontSize,
+            width: Math.max(0, (width ?? 0) - 2),
+            height: Math.max(0, (height ?? 0) - 2),
+            hasTitle: Boolean(title),
+            titleFontSize: authoredTitleFmt?.fontSize ?? 16,
+            hasBottomAxisTitle: Boolean(spec.horizontalAxisTitle),
+            hasLeftAxisTitle: Boolean(spec.verticalAxisTitle),
+            leftAxisDepth,
+            rightAxisDepth,
+            bottomAxisTitleStandoff,
+            axisFontSize,
+        });
         const newLayout = {
             title: {
                 text: plotlyTitleText(title, spec.titleTextFormat),
@@ -1796,7 +1882,32 @@ export const BasicChart = ({ width, height, chart, theme, isDarkMode, sheetId, r
                 }, authoredTitleFmt),
                 x: 0.02, // Small left margin (0.02 = 2% from left edge)
                 xanchor: "left",
+                ...legendBand.title,
             },
+            showlegend: showlegend === undefined ? true : showlegend,
+            legend: { ...legendOverrides, ...(legendBand.legend ?? {}) },
+            margin: legendBand.margin,
+            autosize: true,
+            // Bar/column stacking. Plotly's `barmode: "stack"` stacks bars
+            // at the same X (or Y for horizontal). `barnorm: "percent"`
+            // normalises each category's stack to 100% — Excel's
+            // `percentStacked` grouping. Default is grouped (clustered).
+            ...((spec.chartType === "bar" || spec.chartType === "column") &&
+                spec.stackedType
+                ? {
+                    barmode: spec.stackedType === "STACKED" ||
+                        spec.stackedType === "PERCENT_STACKED"
+                        ? "stack"
+                        : "group",
+                    ...(isPercentStackedBars ? { barnorm: "percent" } : {}),
+                }
+                : {}),
+            // gapWidth — Excel stores 0..500 as a percentage of bar width.
+            // Plotly's `bargap` is a fraction of the slot (0..1). Approx:
+            // gapWidth=150 (default) → ~0.4 bargap.
+            ...(typeof spec.gapWidth === "number"
+                ? { bargap: Math.max(0, Math.min(0.95, spec.gapWidth / 400)) }
+                : {}),
             font: {
                 family: "Untitled Sans, apple-system, sans-serif",
                 size: 12,
@@ -1808,6 +1919,7 @@ export const BasicChart = ({ width, height, chart, theme, isDarkMode, sheetId, r
                 title: {
                     text: spec.horizontalAxisTitle ?? "",
                     font: { color: textColor },
+                    standoff: bottomAxisTitleStandoff,
                 },
                 automargin: true,
                 showgrid: true,
@@ -1827,6 +1939,9 @@ export const BasicChart = ({ width, height, chart, theme, isDarkMode, sheetId, r
                 title: {
                     text: spec.verticalAxisTitle ?? "",
                     font: { color: textColor },
+                    ...(isHorizontalBarChart
+                        ? {}
+                        : { standoff: VALUE_AXIS_TITLE_STANDOFF }),
                 },
                 showgrid: !isHorizontalBarChart,
                 gridcolor: gridColor,
@@ -1845,7 +1960,10 @@ export const BasicChart = ({ width, height, chart, theme, isDarkMode, sheetId, r
             ...(hasSecondaryAxis
                 ? {
                     [isHorizontalBarChart ? "xaxis2" : "yaxis2"]: applyAxisOverridesPlotly({
-                        title: { font: { color: textColor } },
+                        title: {
+                            font: { color: textColor },
+                            standoff: VALUE_AXIS_TITLE_STANDOFF,
+                        },
                         overlaying: isHorizontalBarChart ? "x" : "y",
                         side: isHorizontalBarChart ? "top" : "right",
                         showgrid: false,
@@ -1875,6 +1993,18 @@ export const BasicChart = ({ width, height, chart, theme, isDarkMode, sheetId, r
                     },
                 }
                 : {}),
+            // Of-pie composite — connector-line shapes plus (bar-of-pie) the
+            // hidden secondary axes and stacked bar mode. Spread last: an
+            // of-pie is a single pie series, so its `xaxis2`/`yaxis2` own the
+            // secondary-axis slots.
+            ...(ofPieExtras
+                ? {
+                    shapes: ofPieExtras.shapes,
+                    ...(ofPieExtras.barmode ? { barmode: ofPieExtras.barmode } : {}),
+                    ...(ofPieExtras.xaxis2 ? { xaxis2: ofPieExtras.xaxis2 } : {}),
+                    ...(ofPieExtras.yaxis2 ? { yaxis2: ofPieExtras.yaxis2 } : {}),
+                }
+                : {}),
         };
         // Phase 5.1: apply data labels per trace, and set the doughnut hole
         // when chartType === "doughnut".

package/dist/esm/tsconfig.esm.tsbuildinfo

@@ -1 +1 @@
-{"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"}
+{"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/legend-layout.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/utils/axis-number-format.d.ts

@@ -65,5 +65,19 @@ export type PlotlyTickFormat = {
  * section is used — plotly applies one format to every tick.
  */
 export declare const numberFormatToPlotlyTicks: (pattern: string | undefined) => PlotlyTickFormat | undefined;
+/**
+ * echarts `nameGap` for a value axis whose title sits in the middle, rotated
+ * beside the tick labels. The gap is the distance from the axis line to the
+ * title's centre, so it must clear the tick labels' full width: the labels
+ * ("$2,000.00", "1,500,000") are formatted from the plotted extremes and
+ * measured; the fixed default of 50px only fits labels up to ~4 digits and
+ * lets a currency axis title paint over its own tick labels.
+ */
+export declare const valueAxisNameGap: ({ values, pattern, fontSize, minimum, }: {
+    values: readonly unknown[];
+    pattern: string | undefined;
+    fontSize?: number;
+    minimum?: number;
+}) => number;
 export {};
 //# sourceMappingURL=axis-number-format.d.ts.map

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

@@ -1 +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"}
+{"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;AA2BF;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,GAAI,yCAK9B;IACD,MAAM,EAAE,SAAS,OAAO,EAAE,CAAC;IAC3B,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,KAAG,MAgBH,CAAC"}

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

@@ -168,3 +168,39 @@ const firstSection = (pattern) => {
     }
     return pattern;
 };
+/** Approximate rendered width of an axis tick label in px at `fontSize` (canvas when available). */
+const measureLabelWidth = (text, fontSize) => {
+    if (typeof document !== "undefined") {
+        const ctx = document.createElement("canvas").getContext("2d");
+        if (ctx) {
+            ctx.font = `${fontSize}px sans-serif`;
+            const width = ctx.measureText(text).width;
+            if (Number.isFinite(width) && width > 0)
+                return width;
+        }
+    }
+    // Headless fallback: ~0.6em per character (digits / punctuation heavy).
+    return text.length * fontSize * 0.6;
+};
+/**
+ * echarts `nameGap` for a value axis whose title sits in the middle, rotated
+ * beside the tick labels. The gap is the distance from the axis line to the
+ * title's centre, so it must clear the tick labels' full width: the labels
+ * ("$2,000.00", "1,500,000") are formatted from the plotted extremes and
+ * measured; the fixed default of 50px only fits labels up to ~4 digits and
+ * lets a currency axis title paint over its own tick labels.
+ */
+export const valueAxisNameGap = ({ values, pattern, fontSize = 12, minimum = 50, }) => {
+    const numbers = values.filter((v) => typeof v === "number" && Number.isFinite(v));
+    if (!numbers.length)
+        return minimum;
+    const min = Math.min(...numbers, 0);
+    const max = Math.max(...numbers, 0);
+    // echarts' default axis label puts thousands separators on plain numbers.
+    const defaultLabel = (v) => v.toLocaleString("en-US");
+    const labels = [min, max].map((v) => pattern ? formatAxisValue(pattern, v) : defaultLabel(v));
+    const widest = Math.max(...labels.map((l) => measureLabelWidth(l, fontSize)));
+    // 8px tick-label margin + the rotated title's own line box + breathing room.
+    const AXIS_LABEL_MARGIN = 8;
+    return Math.max(minimum, Math.ceil(widest + AXIS_LABEL_MARGIN + fontSize + 6));
+};

package/dist/esm/utils/chart-styles.d.ts

@@ -60,7 +60,11 @@ export type ChartStylePreset = {
  */
 export declare const CHART_STYLES: readonly ChartStylePreset[];
 export declare const applyChartStyle: (spec: ChartSpec, style: ChartStylePreset) => ChartSpec;
-/** A Quick Layouts gallery entry — where the title, legend, labels and axis titles go. */
+/**
+ * A Quick Layouts gallery entry — where the title, legend, labels and axis
+ * titles go. `applyChartQuickLayout` stamps the entry's `id` on
+ * `spec.quickLayout` so the editor's control shows the applied layout.
+ */
 export type ChartQuickLayout = {
     id: number;
     label: string;

package/dist/esm/utils/chart-styles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chart-styles.d.ts","sourceRoot":"","sources":["../../../utils/chart-styles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,SAAS,EAEV,MAAM,2BAA2B,CAAC;AAEnC;;;;;;GAMG;AAEH,wFAAwF;AACxF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,UAAU,GAAG,eAAe,CAAC;IACnC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,EAAE,SAAS,iBAAiB,EA4C5D,CAAC;AAsBF;;;GAGG;AACH,eAAO,MAAM,sBAAsB,GACjC,MAAM,SAAS,EACf,SAAS,iBAAiB,KACzB,SAGD,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,GAAI,MAAM,SAAS,KAAG,SAC9B,CAAC;AAE5B;;;GAGG;AACH,eAAO,MAAM,eAAe,GAC1B,MAAM,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,GAAG,SAAS,EAC5C,UAAU,SAAS,MAAM,EAAE,KAC1B,MAAM,EAGU,CAAC;AAEpB;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,2CAA2C;IAC3C,OAAO,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAChD,KAAK,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,CAAC;CACnC,CAAC;AAmDF;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,EAAE,SAAS,gBAAgB,EAwInD,CAAC;AAEF,eAAO,MAAM,eAAe,GAC1B,MAAM,SAAS,EACf,OAAO,gBAAgB,KACtB,SAA8B,CAAC;AAElC,0FAA0F;AAC1F,MAAM,MAAM,gBAAgB,GAAG;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,CAAC;CACnC,CAAC;AA0BF;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,SAAS,gBAAgB,EAqE1D,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAChC,MAAM,SAAS,EACf,QAAQ,gBAAgB,KACvB,SAA+B,CAAC"}
+{"version":3,"file":"chart-styles.d.ts","sourceRoot":"","sources":["../../../utils/chart-styles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,SAAS,EAEV,MAAM,2BAA2B,CAAC;AAEnC;;;;;;GAMG;AAEH,wFAAwF;AACxF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,UAAU,GAAG,eAAe,CAAC;IACnC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,EAAE,SAAS,iBAAiB,EA4C5D,CAAC;AAsBF;;;GAGG;AACH,eAAO,MAAM,sBAAsB,GACjC,MAAM,SAAS,EACf,SAAS,iBAAiB,KACzB,SAGD,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,GAAI,MAAM,SAAS,KAAG,SAC9B,CAAC;AAE5B;;;GAGG;AACH,eAAO,MAAM,eAAe,GAC1B,MAAM,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,GAAG,SAAS,EAC5C,UAAU,SAAS,MAAM,EAAE,KAC1B,MAAM,EAGU,CAAC;AAEpB;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,2CAA2C;IAC3C,OAAO,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAChD,KAAK,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,CAAC;CACnC,CAAC;AAmDF;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,EAAE,SAAS,gBAAgB,EAwInD,CAAC;AAEF,eAAO,MAAM,eAAe,GAC1B,MAAM,SAAS,EACf,OAAO,gBAAgB,KACtB,SAA8B,CAAC;AAElC;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,CAAC;CACnC,CAAC;AA0BF;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,SAAS,gBAAgB,EAqE1D,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAChC,MAAM,SAAS,EACf,QAAQ,gBAAgB,KACvB,SAAgE,CAAC"}

package/dist/esm/utils/chart-styles.js

@@ -354,4 +354,4 @@ export const CHART_QUICK_LAYOUTS = [
         }),
     },
 ];
-export const applyChartQuickLayout = (spec, layout) => layout.apply(spec);
+export const applyChartQuickLayout = (spec, layout) => ({ ...layout.apply(spec), quickLayout: layout.id });

package/dist/esm/utils/empty-cells.d.ts

@@ -26,5 +26,14 @@ export declare const connectsAcrossEmptyCells: (spec: EmptyCellsSpec, lineLike:
  *   pre-2016 #N/A behaviour), and any other series leaves a gap.
  */
 export declare const applyEmptyCellsPolicy: (values: readonly (number | null | undefined)[], rawValues: readonly unknown[], spec: EmptyCellsSpec, lineLike: boolean) => (number | null)[];
+/**
+ * Indexes of the plotted points that have no plottable neighbour to draw a
+ * line segment to — a value between two gaps (or at an edge next to a gap).
+ * A line-only series (no markers) draws nothing for them, so a row of data
+ * followed by a blank row vanishes from the chart; Excel still plots an
+ * isolated marker there. When the series connects across gaps every point
+ * links to the next plotted one, so only a lone single point is isolated.
+ */
+export declare const isolatedPointIndexes: (values: readonly (number | null | undefined)[], connectAcrossGaps?: boolean) => number[];
 export {};
 //# sourceMappingURL=empty-cells.d.ts.map

package/dist/esm/utils/empty-cells.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"empty-cells.d.ts","sourceRoot":"","sources":["../../../utils/empty-cells.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE/D,KAAK,SAAS,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;AAEvC,MAAM,MAAM,gBAAgB,GAAG,WAAW,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC,CAAC;AAEpE,KAAK,cAAc,GAAG,IAAI,CAAC,SAAS,EAAE,YAAY,GAAG,eAAe,CAAC,CAAC;AAetE,eAAO,MAAM,iBAAiB,GAAI,OAAO,OAAO,KAAG,OACuB,CAAC;AAE3E,gCAAgC;AAChC,eAAO,MAAM,mBAAmB,GAAI,MAAM,cAAc,KAAG,gBAChC,CAAC;AAE5B,mEAAmE;AACnE,eAAO,MAAM,mBAAmB,GAC9B,WAAW,SAAS,CAAC,WAAW,CAAC,GAAG,IAAI,GAAG,SAAS,KACnD,OAAuD,CAAC;AAE3D;;;GAGG;AACH,eAAO,MAAM,wBAAwB,GACnC,MAAM,cAAc,EACpB,UAAU,OAAO,KAChB,OAA8D,CAAC;AAElE;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,qBAAqB,GAChC,QAAQ,SAAS,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,EAC9C,WAAW,SAAS,OAAO,EAAE,EAC7B,MAAM,cAAc,EACpB,UAAU,OAAO,KAChB,CAAC,MAAM,GAAG,IAAI,CAAC,EA4BjB,CAAC"}
+{"version":3,"file":"empty-cells.d.ts","sourceRoot":"","sources":["../../../utils/empty-cells.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE/D,KAAK,SAAS,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;AAEvC,MAAM,MAAM,gBAAgB,GAAG,WAAW,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC,CAAC;AAEpE,KAAK,cAAc,GAAG,IAAI,CAAC,SAAS,EAAE,YAAY,GAAG,eAAe,CAAC,CAAC;AAetE,eAAO,MAAM,iBAAiB,GAAI,OAAO,OAAO,KAAG,OACuB,CAAC;AAE3E,gCAAgC;AAChC,eAAO,MAAM,mBAAmB,GAAI,MAAM,cAAc,KAAG,gBAChC,CAAC;AAE5B,mEAAmE;AACnE,eAAO,MAAM,mBAAmB,GAC9B,WAAW,SAAS,CAAC,WAAW,CAAC,GAAG,IAAI,GAAG,SAAS,KACnD,OAAuD,CAAC;AAE3D;;;GAGG;AACH,eAAO,MAAM,wBAAwB,GACnC,MAAM,cAAc,EACpB,UAAU,OAAO,KAChB,OAA8D,CAAC;AAElE;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,qBAAqB,GAChC,QAAQ,SAAS,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,EAC9C,WAAW,SAAS,OAAO,EAAE,EAC7B,MAAM,cAAc,EACpB,UAAU,OAAO,KAChB,CAAC,MAAM,GAAG,IAAI,CAAC,EA4BjB,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,GAC/B,QAAQ,SAAS,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,EAC9C,2BAAyB,KACxB,MAAM,EAYR,CAAC"}

package/dist/esm/utils/empty-cells.js

@@ -65,3 +65,24 @@ export const applyEmptyCellsPolicy = (values, rawValues, spec, lineLike) => {
     }
     return plotted;
 };
+/**
+ * Indexes of the plotted points that have no plottable neighbour to draw a
+ * line segment to — a value between two gaps (or at an edge next to a gap).
+ * A line-only series (no markers) draws nothing for them, so a row of data
+ * followed by a blank row vanishes from the chart; Excel still plots an
+ * isolated marker there. When the series connects across gaps every point
+ * links to the next plotted one, so only a lone single point is isolated.
+ */
+export const isolatedPointIndexes = (values, connectAcrossGaps = false) => {
+    const plotted = (i) => i >= 0 && i < values.length && typeof values[i] === "number";
+    const indexes = [];
+    if (connectAcrossGaps) {
+        const all = values.flatMap((_, i) => (plotted(i) ? [i] : []));
+        return all.length === 1 ? all : [];
+    }
+    for (let i = 0; i < values.length; i++) {
+        if (plotted(i) && !plotted(i - 1) && !plotted(i + 1))
+            indexes.push(i);
+    }
+    return indexes;
+};

package/dist/esm/utils/legend-layout.d.ts

@@ -0,0 +1,168 @@
+export type LegendBandPosition = "top" | "bottom" | "left" | "right" | "topRight" | "none";
+/** Space kept between neighbouring bands (legend ↔ axis title ↔ labels). */
+export declare const BAND_GAP = 8;
+/** Inset of the outermost band from the chart frame. */
+export declare const EDGE_PAD = 10;
+/** echarts `legend.padding` default used by both adapters' legend boxes. */
+export declare const LEGEND_PADDING = 10;
+/** echarts `legend.itemGap` default. */
+export declare const LEGEND_ITEM_GAP = 10;
+/** Approximate rendered width of `text` at `fontSize` (canvas when available). */
+export declare const measureTextWidth: (text: string, fontSize: number) => number;
+export type LegendBandInput = {
+    /** Legend entry labels, one per item. */
+    labels: readonly string[];
+    /** Legend text size in px. */
+    fontSize?: number;
+    /** Legend icon width in px. */
+    itemWidth?: number;
+    /** Gap between items (and between wrapped rows / columns) in px. */
+    itemGap?: number;
+    /** Legend box padding in px (each side). */
+    padding?: number;
+    /** Horizontal (top / bottom) or vertical (left / right) item flow. */
+    orientation: "horizontal" | "vertical";
+    /** Frame width available to a horizontal legend before it wraps. */
+    availableWidth: number;
+    /** Frame height available to a vertical legend before it wraps. */
+    availableHeight: number;
+};
+export type LegendBand = {
+    /** Rows of items (horizontal legends wrap long series lists). */
+    rows: number;
+    /** Columns of items (vertical legends wrap when taller than the frame). */
+    columns: number;
+    /** Rendered width in px including padding. */
+    width: number;
+    /** Rendered height in px including padding. */
+    height: number;
+};
+/**
+ * Estimate the legend's rendered box from its items. Horizontal legends
+ * pack items greedily into rows no wider than the frame; vertical legends
+ * stack items and spill into a new column when taller than the frame.
+ */
+export declare const estimateLegendBand: ({ labels, fontSize, itemWidth, itemGap, padding, orientation, availableWidth, availableHeight, }: LegendBandInput) => LegendBand;
+/**
+ * Pull the legend entry labels out of an echarts `legend.data` (strings or
+ * `{ name }` items); falls back to the series names, which is what echarts
+ * itself lists when `data` is empty.
+ */
+export declare const legendLabelsFrom: (legendData: readonly unknown[] | undefined, seriesNames: readonly unknown[]) => string[];
+/**
+ * Depth (px) of one row of echarts axis tick labels measured from the axis
+ * line: 5px tick + 8px label margin + one 12px line, rounded up. With
+ * `grid.containLabel` this is the part the grid already accounts for; the
+ * axis title sits beyond it.
+ */
+export declare const echartsAxisLabelDepth: (fontSize?: number) => number;
+/**
+ * echarts `nameGap` for a category axis whose title sits in the middle
+ * below the tick labels: clear one row of labels plus a small gap, measured
+ * to the title's centre line.
+ */
+export declare const categoryAxisNameGap: (fontSize?: number) => number;
+/** Height of the echarts chart-title band (padding 10 each side + one line). */
+export declare const echartsTitleBand: (titleFontSize?: number) => number;
+export type EchartsLegendBandInput = {
+    /** Resolved legend position (`undefined` = echarts default: top). */
+    position: LegendBandPosition | null | undefined;
+    /** Whether the legend renders at all (`show !== false` and has items). */
+    visible: boolean;
+    labels: readonly string[];
+    legendFontSize?: number;
+    legendItemWidth?: number;
+    width: number;
+    height: number;
+    /** A chart title is drawn across the top. */
+    hasTitle: boolean;
+    titleFontSize?: number;
+    /** The bottom axis carries a title (`name`). */
+    hasBottomAxisTitle: boolean;
+    /** `nameGap` used for the bottom axis title (px from axis line to title centre). */
+    bottomAxisNameGap: number;
+    /** The left axis carries a title (`name`). */
+    hasLeftAxisTitle: boolean;
+    axisFontSize?: number;
+};
+export type EchartsLegendBandLayout = {
+    band: LegendBand;
+    grid: {
+        left: number;
+        right: number;
+        top: number;
+        bottom: number;
+        containLabel: true;
+    };
+    /** Legend placement to spread over the positioned legend option. */
+    legend: {
+        top?: number | string;
+        bottom?: number | string;
+        left?: number | string;
+        right?: number | string;
+    };
+};
+/**
+ * Echarts cartesian geometry with a band reserved for the legend in its
+ * position, outside the axis-title band, outside the tick labels.
+ */
+export declare const reserveEchartsLegendBand: ({ position, visible, labels, legendFontSize, legendItemWidth, width, height, hasTitle, titleFontSize, hasBottomAxisTitle, bottomAxisNameGap, hasLeftAxisTitle, axisFontSize, }: EchartsLegendBandInput) => EchartsLegendBandLayout;
+export type PlotlyLegendBandInput = {
+    /** Resolved legend position (`undefined` = plotly default: right). */
+    position: LegendBandPosition | null | undefined;
+    visible: boolean;
+    labels: readonly string[];
+    legendFontSize?: number;
+    width: number;
+    height: number;
+    hasTitle: boolean;
+    titleFontSize?: number;
+    hasBottomAxisTitle: boolean;
+    hasLeftAxisTitle: boolean;
+    /**
+     * Px from the left axis line to the outer edge of its tick labels (and
+     * title when present) — what the legend must clear on the left.
+     */
+    leftAxisDepth: number;
+    /** Same for a secondary value axis drawn on the right (0 when absent). */
+    rightAxisDepth?: number;
+    /** `title.standoff` the caller sets on the bottom axis (px labels → title). */
+    bottomAxisTitleStandoff?: number;
+    axisFontSize?: number;
+};
+export type PlotlyLegendBandLayout = {
+    band: LegendBand;
+    margin: {
+        l: number;
+        r: number;
+        t: number;
+        b: number;
+    };
+    /** Legend anchor + orientation to spread over the legend option. */
+    legend: {
+        orientation: "h" | "v";
+        x: number;
+        y: number;
+        xanchor: "left" | "center" | "right";
+        yanchor: "top" | "middle" | "bottom";
+    } | null;
+    /** Bottom axis title standoff (px between tick labels and title). */
+    bottomAxisTitleStandoff: number;
+    /** Title pinned to the top of the container so it never drifts into the legend band. */
+    title: {
+        yref: "container";
+        y: number;
+        yanchor: "top";
+        pad: {
+            t: number;
+        };
+    };
+};
+/**
+ * Plotly geometry with a band reserved for the legend in its position.
+ * Legend coordinates are paper-relative (fractions of the plot area), so
+ * they are derived from the margins this returns; `automargin` on the
+ * axes may still grow a margin further for unusually deep tick labels.
+ */
+export declare const reservePlotlyLegendBand: ({ position, visible, labels, legendFontSize, width, height, hasTitle, titleFontSize, hasBottomAxisTitle, hasLeftAxisTitle, leftAxisDepth, rightAxisDepth, bottomAxisTitleStandoff, axisFontSize, }: PlotlyLegendBandInput) => PlotlyLegendBandLayout;
+//# sourceMappingURL=legend-layout.d.ts.map

package/dist/esm/utils/legend-layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"legend-layout.d.ts","sourceRoot":"","sources":["../../../utils/legend-layout.ts"],"names":[],"mappings":"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"}