@rowsncolumns/charts 28.1.18 → 28.1.19

package/dist/esm/components/editors/fields/axis-options-fields.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"axis-options-fields.d.ts","sourceRoot":"","sources":["../../../../../components/editors/fields/axis-options-fields.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,KAAK,MAAM,OAAO,CAAC;AAK1B;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,GAAI,qDAM/B;IACD,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,OAAO,GAAG,UAAU,CAAC;IAC3B,KAAK,EAAE,gBAAgB,GAAG,IAAI,GAAG,SAAS,CAAC;IAC3C,QAAQ,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACvC,gEAAgE;IAChE,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B,sBAoEA,CAAC"}
+{"version":3,"file":"axis-options-fields.d.ts","sourceRoot":"","sources":["../../../../../components/editors/fields/axis-options-fields.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,KAAK,MAAM,OAAO,CAAC;AAgC1B;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB,GAAI,qDAM/B;IACD,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,OAAO,GAAG,UAAU,CAAC;IAC3B,KAAK,EAAE,gBAAgB,GAAG,IAAI,GAAG,SAAS,CAAC;IAC3C,QAAQ,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACvC,gEAAgE;IAChE,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B,sBAkNA,CAAC"}

package/dist/esm/components/editors/fields/axis-options-fields.js

@@ -1,10 +1,31 @@
 import React from "react";
-import { CheckboxField, NumberField, TextField } from "./primitives";
+import { CheckboxField, NumberField, SelectField, TextField, } from "./primitives";
 import { TextFormatFields } from "./text-format-fields";
+const TICK_MARKS = [
+    { value: "none", label: "None" },
+    { value: "in", label: "Inside" },
+    { value: "out", label: "Outside" },
+    { value: "cross", label: "Cross" },
+];
+const DISPLAY_UNIT_OPTIONS = [
+    { value: "", label: "None" },
+    { value: "hundreds", label: "Hundreds" },
+    { value: "thousands", label: "Thousands" },
+    { value: "tenThousands", label: "10000" },
+    { value: "hundredThousands", label: "100000" },
+    { value: "millions", label: "Millions" },
+    { value: "tenMillions", label: "10000000" },
+    { value: "hundredMillions", label: "100000000" },
+    { value: "billions", label: "Billions" },
+    { value: "trillions", label: "Trillions" },
+];
 /**
- * One axis' options (`ChartAxisOptions`): a value axis has a scale
- * (min / max / logarithmic), both have direction, gridlines, visibility
- * and tick-label font; a value axis also has its number format.
+ * One axis' options (`ChartAxisOptions`) — Excel's Format Axis pane
+ * (demo-app-monorepo#49969 FT-08): a value axis has its bounds, log scale
+ * and base, major / minor units, display units and number format; a
+ * category axis its label / tick-mark intervals; both have where the other
+ * axis crosses, direction, major / minor gridlines, tick marks, visibility
+ * and tick-label font.
  */
 export const AxisOptionsFields = ({ label, kind, value, onChange, gridlinesDefault = true, }) => {
     const set = (patch) => onChange({ ...(value ?? {}), ...patch });
@@ -13,9 +34,39 @@ export const AxisOptionsFields = ({ label, kind, value, onChange, gridlinesDefau
         kind === "value" ? (React.createElement("div", { className: "flex flex-wrap gap-2 items-end" },
             React.createElement(NumberField, { label: "Min", ariaLabel: `${label} min`, value: value?.min, onChange: (min) => set({ min }), placeholder: "Auto" }),
             React.createElement(NumberField, { label: "Max", ariaLabel: `${label} max`, value: value?.max, onChange: (max) => set({ max }), placeholder: "Auto" }))) : null,
-        kind === "value" ? (React.createElement(CheckboxField, { label: "Logarithmic scale", ariaLabel: `${label} logarithmic scale`, checked: Boolean(value?.logarithmic), onChange: (on) => set({ logarithmic: on || undefined }) })) : null,
+        kind === "value" ? (React.createElement("div", { className: "flex flex-wrap gap-2 items-end" },
+            React.createElement(NumberField, { label: "Major unit", ariaLabel: `${label} major unit`, value: value?.majorUnit, min: 0, onChange: (majorUnit) => set({ majorUnit }), placeholder: "Auto" }),
+            React.createElement(NumberField, { label: "Minor unit", ariaLabel: `${label} minor unit`, value: value?.minorUnit, min: 0, onChange: (minorUnit) => set({ minorUnit }), placeholder: "Auto" }))) : (React.createElement("div", { className: "flex flex-wrap gap-2 items-end" },
+            React.createElement(NumberField, { label: "Label interval", ariaLabel: `${label} interval between labels`, value: value?.tickLabelSkip, min: 1, step: 1, onChange: (tickLabelSkip) => set({ tickLabelSkip }), placeholder: "Auto" }),
+            React.createElement(NumberField, { label: "Tick interval", ariaLabel: `${label} interval between tick marks`, value: value?.tickMarkSkip, min: 1, step: 1, onChange: (tickMarkSkip) => set({ tickMarkSkip }), placeholder: "1" }))),
+        kind === "value" ? (React.createElement("div", { className: "flex flex-wrap gap-2 items-end" },
+            React.createElement(CheckboxField, { label: "Logarithmic scale", ariaLabel: `${label} logarithmic scale`, checked: Boolean(value?.logarithmic), onChange: (on) => set({ logarithmic: on || undefined }) }),
+            value?.logarithmic ? (React.createElement(NumberField, { label: "Base", ariaLabel: `${label} logarithmic base`, value: value?.logBase, min: 2, max: 1000, onChange: (logBase) => set({ logBase }), placeholder: "10" })) : null)) : null,
+        kind === "value" ? (React.createElement("div", { className: "flex flex-wrap gap-2 items-end" },
+            React.createElement(SelectField, { label: "Display units", ariaLabel: `${label} display units`, value: (value?.displayUnits ?? ""), options: DISPLAY_UNIT_OPTIONS, onChange: (unit) => set({ displayUnits: unit === "" ? undefined : unit }) }),
+            value?.displayUnits ? (React.createElement(CheckboxField, { label: "Show display units label", ariaLabel: `${label} show display units label`, checked: value?.showDisplayUnitsLabel !== false, onChange: (on) => set({ showDisplayUnitsLabel: on ? undefined : false }) })) : null)) : null,
+        React.createElement("div", { className: "flex flex-wrap gap-2 items-end" },
+            React.createElement(SelectField, { label: "Crosses other axis", ariaLabel: `${label} crosses`, value: typeof value?.crossesAt === "number"
+                    ? "value"
+                    : value?.crosses === "max"
+                        ? "max"
+                        : "autoZero", options: [
+                    { value: "autoZero", label: "Automatic" },
+                    { value: "value", label: "At value" },
+                    { value: "max", label: "At maximum" },
+                ], onChange: (crossing) => set(crossing === "value"
+                    ? { crosses: undefined, crossesAt: value?.crossesAt ?? 0 }
+                    : {
+                        crosses: crossing === "max" ? "max" : undefined,
+                        crossesAt: undefined,
+                    }) }),
+            typeof value?.crossesAt === "number" ? (React.createElement(NumberField, { label: "At", ariaLabel: `${label} crosses at`, value: value.crossesAt, onChange: (crossesAt) => set({ crossesAt: crossesAt ?? 0 }) })) : null),
         React.createElement(CheckboxField, { label: "Reverse direction", ariaLabel: `${label} reverse direction`, checked: Boolean(value?.reverse), onChange: (on) => set({ reverse: on || undefined }) }),
         React.createElement(CheckboxField, { label: "Gridlines", ariaLabel: `${label} gridlines`, checked: value?.showMajorGridlines ?? gridlinesDefault, onChange: (showMajorGridlines) => set({ showMajorGridlines }) }),
+        kind === "value" ? (React.createElement(CheckboxField, { label: "Minor gridlines", ariaLabel: `${label} minor gridlines`, checked: Boolean(value?.showMinorGridlines), onChange: (on) => set({ showMinorGridlines: on || undefined }) })) : null,
+        React.createElement("div", { className: "flex flex-wrap gap-2 items-end" },
+            React.createElement(SelectField, { label: "Major tick marks", ariaLabel: `${label} major tick marks`, value: value?.majorTickMark ?? "out", options: TICK_MARKS, onChange: (mark) => set({ majorTickMark: mark === "out" ? undefined : mark }) }),
+            React.createElement(SelectField, { label: "Minor tick marks", ariaLabel: `${label} minor tick marks`, value: value?.minorTickMark ?? "none", options: TICK_MARKS, onChange: (mark) => set({ minorTickMark: mark === "none" ? undefined : mark }) })),
         React.createElement(CheckboxField, { label: "Show axis", ariaLabel: `${label} visible`, checked: value?.visible !== false, onChange: (on) => set({ visible: on ? undefined : false }) }),
         kind === "value" ? (React.createElement(TextField, { label: "Number format", ariaLabel: `${label} number format`, value: value?.numberFormatPattern, onChange: (numberFormatPattern) => set({ numberFormatPattern }), placeholder: "Linked to source" })) : null,
         React.createElement(TextFormatFields, { label: `${label} font`, collapsible: true, value: value?.textFormat, onChange: (textFormat) => set({ textFormat }) })));

package/dist/esm/components/editors/fields/chart-elements-fields.d.ts

@@ -0,0 +1,15 @@
+import React from "react";
+type ElementKey = "hiLowLines" | "dropLines" | "upDownBars" | "dataTable";
+/**
+ * Excel's Add Chart Element → Lines (High-Low, Drop), Up/Down Bars and Data
+ * Table (demo-app-monorepo#49969 FT-08). High-low lines and up/down bars are
+ * line-chart elements, drop lines line and area; every category chart can
+ * carry a data table.
+ */
+export declare const ChartElementsFields: ({ chartType, spec, onChange, }: {
+    chartType: string;
+    spec: Partial<Record<ElementKey, any>>;
+    onChange(key: ElementKey | "dataTable.showLegendKeys", value: unknown): void;
+}) => React.JSX.Element;
+export {};
+//# sourceMappingURL=chart-elements-fields.d.ts.map

package/dist/esm/components/editors/fields/chart-elements-fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-elements-fields.d.ts","sourceRoot":"","sources":["../../../../../components/editors/fields/chart-elements-fields.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B,KAAK,UAAU,GAAG,YAAY,GAAG,WAAW,GAAG,YAAY,GAAG,WAAW,CAAC;AAE1E;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,GAAI,gCAIjC;IACD,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC,CAAC;IACvC,QAAQ,CAAC,GAAG,EAAE,UAAU,GAAG,0BAA0B,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;CAC9E,sBAuCA,CAAC"}

package/dist/esm/components/editors/fields/chart-elements-fields.js

@@ -0,0 +1,17 @@
+import React from "react";
+import { CheckboxField } from "./primitives";
+/**
+ * Excel's Add Chart Element → Lines (High-Low, Drop), Up/Down Bars and Data
+ * Table (demo-app-monorepo#49969 FT-08). High-low lines and up/down bars are
+ * line-chart elements, drop lines line and area; every category chart can
+ * carry a data table.
+ */
+export const ChartElementsFields = ({ chartType, spec, onChange, }) => {
+    const isLine = chartType === "line";
+    return (React.createElement("div", { className: "flex flex-col gap-1 pb-2" },
+        isLine ? (React.createElement(CheckboxField, { label: "High-low lines", checked: Boolean(spec.hiLowLines), onChange: (on) => onChange("hiLowLines", on || undefined) })) : null,
+        isLine || chartType === "area" ? (React.createElement(CheckboxField, { label: "Drop lines", checked: Boolean(spec.dropLines), onChange: (on) => onChange("dropLines", on || undefined) })) : null,
+        isLine ? (React.createElement(CheckboxField, { label: "Up/down bars", checked: Boolean(spec.upDownBars), onChange: (on) => onChange("upDownBars", on ? {} : undefined) })) : null,
+        React.createElement(CheckboxField, { label: "Data table", checked: Boolean(spec.dataTable), onChange: (on) => onChange("dataTable", on ? {} : undefined) }),
+        spec.dataTable ? (React.createElement(CheckboxField, { label: "Show legend keys", checked: spec.dataTable.showLegendKeys !== false, onChange: (on) => onChange("dataTable.showLegendKeys", on ? undefined : false) })) : null));
+};

package/dist/esm/components/editors/fields/series-format-fields.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"series-format-fields.d.ts","sourceRoot":"","sources":["../../../../../components/editors/fields/series-format-fields.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EAGV,MAAM,2BAA2B,CAAC;AAEnC,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAqC5E;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,GAAI,8CAKhC;IACD,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,SAAS,CAAC;IAClB,YAAY,EAAE,uBAAuB,CAAC;IACtC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC;CAC3C,sBAoXA,CAAC"}
+{"version":3,"file":"series-format-fields.d.ts","sourceRoot":"","sources":["../../../../../components/editors/fields/series-format-fields.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EAGV,MAAM,2BAA2B,CAAC;AAEnC,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAqC5E;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,GAAI,8CAKhC;IACD,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,SAAS,CAAC;IAClB,YAAY,EAAE,uBAAuB,CAAC;IACtC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC;CAC3C,sBAkZA,CAAC"}

package/dist/esm/components/editors/fields/series-format-fields.js

@@ -139,5 +139,13 @@ export const SeriesFormatFields = ({ sheetId, series, capabilities, onChange, })
                             },
                         ],
                     }) }, "Add point color")))) : null,
-        capabilities.hasDataLabels ? (React.createElement(DataLabelsFields, { perSeries: true, value: series.dataLabels, capabilities: capabilities, onChange: (dataLabels) => onChange({ dataLabels }) })) : null));
+        capabilities.hasDataLabels ? (React.createElement(DataLabelsFields, { perSeries: true, value: series.dataLabels, capabilities: capabilities, onChange: (dataLabels) => onChange({ dataLabels }) })) : null,
+        capabilities.hasDataLabels ? (React.createElement("div", { className: "flex flex-col gap-1" },
+            React.createElement("label", { className: "font-system text-xs" }, "Label values from cells"),
+            React.createElement(ChartRangeInput, { sheetId: sheetId, range: series.dataLabels?.valueFromCells ?? undefined, onChangeRange: (valueFromCells) => onChange({
+                    dataLabels: { ...(series.dataLabels ?? {}), show: true, valueFromCells },
+                }), placeholder: "Select a label range", className: "mb-0" }),
+            series.dataLabels?.valueFromCells ? (React.createElement("button", { type: "button", className: "font-system text-xs text-rnc-muted-foreground underline self-start", onClick: () => onChange({
+                    dataLabels: { ...(series.dataLabels ?? {}), valueFromCells: undefined },
+                }) }, "Clear label range")) : null)) : null));
 };

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-capabilities.ts","../../components/editors/chart-editor.tsx","../../components/editors/chart-range-input.tsx","../../components/editors/fields/axis-options-fields.tsx","../../components/editors/fields/chart-type-options.tsx","../../components/editors/fields/data-labels-fields.tsx","../../components/editors/fields/primitives.tsx","../../components/editors/fields/series-format-fields.tsx","../../components/editors/fields/series-name-field.tsx","../../components/editors/fields/text-format-fields.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/plot.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/doughnut.ts","../../utils/echarts-gl-loader.ts","../../utils/echarts-overlays.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/series-name.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-capabilities.ts","../../components/editors/chart-editor.tsx","../../components/editors/chart-range-input.tsx","../../components/editors/fields/axis-options-fields.tsx","../../components/editors/fields/chart-elements-fields.tsx","../../components/editors/fields/chart-type-options.tsx","../../components/editors/fields/data-labels-fields.tsx","../../components/editors/fields/primitives.tsx","../../components/editors/fields/series-format-fields.tsx","../../components/editors/fields/series-name-field.tsx","../../components/editors/fields/text-format-fields.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/plot.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-lines.ts","../../utils/chart-orientation.ts","../../utils/chart-spec-utils.ts","../../utils/chart-styles.ts","../../utils/data-table.ts","../../utils/doughnut.ts","../../utils/echarts-gl-loader.ts","../../utils/echarts-overlays.ts","../../utils/empty-cells.ts","../../utils/error-bars.ts","../../utils/excel-axis-scale.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/series-name.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/chart-lines.d.ts

@@ -0,0 +1,36 @@
+/**
+ * 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.
+ */
+export declare const CHART_LINE_SERIES_PREFIX = "rnc-chart-lines-";
+export type ChartLineOptions = {
+    hiLowLines?: boolean | null;
+    dropLines?: boolean | null;
+    upDownBars?: {
+        gapWidth?: number | null;
+        upColor?: string | null;
+        downColor?: string | null;
+    } | null;
+};
+/**
+ * The extra series for `options`, given the data of the chart's line series
+ * on one value axis, in spec order.
+ */
+export declare const buildChartLineSeries: (options: ChartLineOptions, lines: ReadonlyArray<ReadonlyArray<unknown>>, { isDarkMode, yAxisIndex }?: {
+    isDarkMode?: boolean;
+    yAxisIndex?: number;
+}) => Record<string, unknown>[];
+//# sourceMappingURL=chart-lines.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chart-lines.d.ts","sourceRoot":"","sources":["../../../utils/chart-lines.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,eAAO,MAAM,wBAAwB,qBAAqB,CAAC;AAE3D,MAAM,MAAM,gBAAgB,GAAG;IAC7B,UAAU,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC5B,SAAS,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC3B,UAAU,CAAC,EAAE;QACX,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACzB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACxB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KAC3B,GAAG,IAAI,CAAC;CACV,CAAC;AAqDF;;;GAGG;AACH,eAAO,MAAM,oBAAoB,GAC/B,SAAS,gBAAgB,EACzB,OAAO,aAAa,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,EAC5C,6BAA4B;IAAE,UAAU,CAAC,EAAE,OAAO,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAO,KAC7E,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAuEzB,CAAC"}

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

@@ -0,0 +1,121 @@
+/**
+ * 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.
+ */
+export const CHART_LINE_SERIES_PREFIX = "rnc-chart-lines-";
+const finite = (item) => {
+    const 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). */
+const LINE_COLOR = "#404040";
+const spanSeries = ({ id, base, span, barWidth, itemStyle, yAxisIndex, }) => {
+    const common = {
+        type: "bar",
+        stack: `${CHART_LINE_SERIES_PREFIX}${id}`,
+        stackStrategy: "all",
+        barWidth,
+        barGap: "-100%",
+        silent: true,
+        legendHoverLink: false,
+        tooltip: { show: false },
+        emphasis: { disabled: true },
+        label: { show: false },
+        z: 1,
+        ...(yAxisIndex ? { yAxisIndex } : {}),
+    };
+    return [
+        {
+            ...common,
+            id: `${CHART_LINE_SERIES_PREFIX}${id}-base`,
+            data: base,
+            itemStyle: { color: "transparent" },
+        },
+        { ...common, id: `${CHART_LINE_SERIES_PREFIX}${id}`, data: span, itemStyle },
+    ];
+};
+/**
+ * The extra series for `options`, given the data of the chart's line series
+ * on one value axis, in spec order.
+ */
+export const buildChartLineSeries = (options, lines, { isDarkMode, yAxisIndex } = {}) => {
+    const color = isDarkMode ? "rgba(255,255,255,0.65)" : LINE_COLOR;
+    const length = lines.reduce((n, data) => Math.max(n, data.length), 0);
+    const out = [];
+    const extent = (i) => {
+        const values = lines.map((data) => finite(data[i])).filter((v) => v !== undefined);
+        return values.length
+            ? { low: Math.min(...values), high: Math.max(...values), count: values.length }
+            : undefined;
+    };
+    if (options.dropLines && lines.length) {
+        const base = [];
+        const span = [];
+        for (let i = 0; i < length; i++) {
+            const e = extent(i);
+            base.push(e ? 0 : null);
+            span.push(e ? e.high : null);
+        }
+        out.push(...spanSeries({ id: "drop", base, span, barWidth: 1, itemStyle: { color }, yAxisIndex }));
+    }
+    if (options.hiLowLines && lines.length > 1) {
+        const base = [];
+        const span = [];
+        for (let i = 0; i < length; i++) {
+            const e = extent(i);
+            const drawn = e && e.count > 1;
+            base.push(drawn ? e.low : null);
+            span.push(drawn ? e.high - e.low : null);
+        }
+        out.push(...spanSeries({ id: "hilow", base, span, barWidth: 1, itemStyle: { color }, yAxisIndex }));
+    }
+    if (options.upDownBars && lines.length > 1) {
+        const first = lines[0];
+        const last = lines[lines.length - 1];
+        const up = options.upDownBars.upColor ?? "#FFFFFF";
+        const down = options.upDownBars.downColor ?? (isDarkMode ? "#A6A6A6" : "#595959");
+        const base = [];
+        const span = [];
+        for (let i = 0; i < length; i++) {
+            const open = finite(first[i]);
+            const close = finite(last[i]);
+            if (open === undefined || close === undefined) {
+                base.push(null);
+                span.push(null);
+                continue;
+            }
+            base.push(Math.min(open, close));
+            span.push({
+                value: Math.abs(close - open),
+                itemStyle: { color: close >= open ? up : down },
+            });
+        }
+        // `<c:gapWidth>` is the gap as a % of the bar: the bar is 1 / (1 + gap) of the category.
+        const gap = options.upDownBars.gapWidth ?? 150;
+        const barWidth = `${Math.round(100 / (1 + Math.max(0, gap) / 100))}%`;
+        out.push(...spanSeries({
+            id: "updown",
+            base,
+            span,
+            barWidth,
+            itemStyle: { borderColor: color, borderWidth: 1 },
+            yAxisIndex,
+        }));
+    }
+    return out;
+};

package/dist/esm/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/esm/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/esm/utils/data-table.js

@@ -0,0 +1,48 @@
+/**
+ * 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.
+ */
+/** Row height in pixels: 9 pt text plus padding. */
+export const DATA_TABLE_ROW_HEIGHT = 20;
+export const dataTableAxes = (rows, options, { textColor, fontSize, borderColor = "#D9D9D9", firstOffset = 22, }) => rows.map((row, index) => {
+    const keys = options.showLegendKeys !== false;
+    return {
+        type: "category",
+        position: "bottom",
+        gridIndex: 0,
+        offset: firstOffset + index * 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: DATA_TABLE_ROW_HEIGHT,
+            lineStyle: { color: borderColor },
+        },
+        axisLabel: { interval: 0, color: textColor, fontSize, margin: 6 },
+        splitLine: { show: false },
+        name: keys ? `{key|■} ${row.name}` : row.name,
+        nameLocation: "start",
+        nameGap: 8,
+        nameTextStyle: {
+            color: textColor,
+            fontSize,
+            align: "right",
+            verticalAlign: "top",
+            padding: [6, 0, 0, 0],
+            rich: { key: { color: row.color ?? textColor, fontSize } },
+        },
+    };
+});
+/** Room the row names need left of the plot (approximate glyph width). */
+export const dataTableNameWidth = (rows, fontSize, legendKeys) => Math.ceil(rows.reduce((width, row) => Math.max(width, (row.name.length + (legendKeys ? 2 : 0)) * fontSize * 0.6), 0)) + 12;

package/dist/esm/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/esm/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/esm/utils/excel-axis-scale.js

@@ -0,0 +1,122 @@
+const MAX_INTERVALS = 10;
+const niceSteps = (span) => {
+    const exponent = Math.floor(Math.log10(span / MAX_INTERVALS));
+    const steps = [];
+    for (let e = exponent - 1; e <= exponent + 2; e++) {
+        const base = 10 ** e;
+        steps.push(base, 2 * base, 5 * base);
+    }
+    return steps;
+};
+/** Floating-point safe multiple of `step` (`0.1 * 3` would print 0.30000000000000004). */
+const multiple = (k, step) => Number((k * step).toPrecision(12));
+export const excelAutoAxisScale = (values, fixed = {}) => {
+    let dataMin = Infinity;
+    let dataMax = -Infinity;
+    for (const v of values) {
+        if (!Number.isFinite(v))
+            continue;
+        if (v < dataMin)
+            dataMin = v;
+        if (v > dataMax)
+            dataMax = v;
+    }
+    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;
+    }
+    const fixedMin = typeof fixed.min === "number" ? fixed.min : undefined;
+    const fixedMax = typeof fixed.max === "number" ? fixed.max : undefined;
+    let 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);
+    let 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;
+    const pick = (step) => {
+        const min = fixedMin !== undefined ? fixedMin : multiple(Math.floor(lo / step), step);
+        const max = fixedMax !== undefined ? fixedMax : multiple(Math.ceil(hi / step), step);
+        return { min, max, interval: step };
+    };
+    if (typeof fixed.majorUnit === "number" && fixed.majorUnit > 0) {
+        return pick(fixed.majorUnit);
+    }
+    for (const step of niceSteps(hi - lo)) {
+        const scale = pick(step);
+        if ((scale.max - scale.min) / step <= MAX_INTERVALS + 1e-9)
+            return scale;
+    }
+    return undefined;
+};
+const pointValue = (item) => {
+    const raw = item !== null && typeof item === "object" && "value" in item
+        ? item.value
+        : item;
+    if (Array.isArray(raw))
+        return undefined;
+    const 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).
+ */
+export const valueAxisExtentValues = (series, axisIndex, axisKey = "yAxisIndex") => {
+    const values = [];
+    const stacks = new Map();
+    for (const s of series) {
+        if (!s || (s.type !== "bar" && s.type !== "line"))
+            continue;
+        // High-low / drop lines and up/down bars only span the plotted values.
+        if (String(s.id ?? "").startsWith("rnc-chart-lines-"))
+            continue;
+        if ((s[axisKey] ?? 0) !== axisIndex || !Array.isArray(s.data))
+            continue;
+        if (s.stack === undefined) {
+            for (const item of s.data) {
+                const v = pointValue(item);
+                if (v !== undefined)
+                    values.push(v);
+            }
+            continue;
+        }
+        const stack = stacks.get(s.stack) ?? { pos: [], neg: [] };
+        stacks.set(s.stack, stack);
+        s.data.forEach((item, i) => {
+            const v = pointValue(item);
+            if (v === undefined)
+                return;
+            const side = v >= 0 ? stack.pos : stack.neg;
+            side[i] = (side[i] ?? 0) + v;
+        });
+    }
+    for (const { pos, neg } of stacks.values()) {
+        for (const v of pos)
+            if (v !== undefined)
+                values.push(v);
+        for (const v of neg)
+            if (v !== undefined)
+                values.push(v);
+    }
+    return values;
+};

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