@rowsncolumns/charts 27.0.34 → 28.1.0

package/dist/cjs/utils/plotly-click.js

@@ -0,0 +1,49 @@
+"use strict";
+/**
+ * plotly click → chart selection (rowsncolumns/spreadsheet#668 C-37 / C-38).
+ *
+ * The plotly renderer is interactive with `layout.dragmode: false`: plotly
+ * reports `plotly_click` but never starts a drag, so a body drag reaches
+ * the embed's move handler instead. plotly does not track that drag either
+ * and treats the mouseup as a click, so the caller compares the click's
+ * pointer position with where the pointer went down.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolvePlotlyClickSelection = exports.wasDragged = exports.CLICK_DRAG_TOLERANCE_PX = void 0;
+/** Pointer travel (px) beyond which a mouseup is a drag, not a click. */
+exports.CLICK_DRAG_TOLERANCE_PX = 3;
+var wasDragged = function (pointerDown, clickEvent) {
+    if (!pointerDown || !clickEvent)
+        return false;
+    var clientX = clickEvent.clientX, clientY = clickEvent.clientY;
+    if (typeof clientX !== "number" || typeof clientY !== "number")
+        return false;
+    return (Math.abs(clientX - pointerDown.x) > exports.CLICK_DRAG_TOLERANCE_PX ||
+        Math.abs(clientY - pointerDown.y) > exports.CLICK_DRAG_TOLERANCE_PX);
+};
+exports.wasDragged = wasDragged;
+/**
+ * The `spec.series` entry (and data point) a plotly click lands on. Traces
+ * tagged with `meta.rncSeriesIndex` resolve through the tag; untagged ones
+ * map by curve position while it fits; anything else is not a series.
+ */
+var resolvePlotlyClickSelection = function (points, seriesCount) {
+    var _a;
+    var point = points === null || points === void 0 ? void 0 : points[0];
+    if (!point)
+        return undefined;
+    var meta = (_a = point.data) === null || _a === void 0 ? void 0 : _a.meta;
+    var seriesIndex = typeof (meta === null || meta === void 0 ? void 0 : meta.rncSeriesIndex) === "number"
+        ? meta.rncSeriesIndex
+        : point.curveNumber < seriesCount
+            ? point.curveNumber
+            : undefined;
+    if (seriesIndex === undefined || seriesIndex >= seriesCount) {
+        return undefined;
+    }
+    var dataIndex = point.pointNumber;
+    return typeof dataIndex === "number" && dataIndex >= 0
+        ? { seriesIndex: seriesIndex, dataIndex: dataIndex }
+        : { seriesIndex: seriesIndex };
+};
+exports.resolvePlotlyClickSelection = resolvePlotlyClickSelection;

package/dist/cjs/utils/plotly-surface.d.ts

@@ -0,0 +1,14 @@
+/**
+ * plotly traces for Excel's Surface family (rowsncolumns/spreadsheet#668
+ * C-33): `surface3DChart` (3-D Surface) is a WebGL `surface`, `surfaceChart`
+ * (Contour) is the same height grid seen from above as an SVG `contour`.
+ * Both take z as one row per series, one column per category.
+ */
+import { type ThreeDSeriesInput } from "./three-d";
+export type SurfaceToken = "SURFACE" | "SURFACE_3D";
+/** plotly `colorscale` — the shared surface ramp spread over 0..1. */
+export declare const surfaceColorscale: () => Array<[number, string]>;
+/** The z matrix (series rows × category columns) plotly's grid traces take. */
+export declare const buildSurfaceZ: (series: ThreeDSeriesInput[]) => number[][];
+export declare const buildPlotlySurfaceTrace: (token: SurfaceToken, series: ThreeDSeriesInput[], categories: string[], seriesNames: string[], seriesNumberFormats?: (string | undefined)[]) => Record<string, unknown>;
+//# sourceMappingURL=plotly-surface.d.ts.map

package/dist/cjs/utils/plotly-surface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plotly-surface.d.ts","sourceRoot":"","sources":["../../../utils/plotly-surface.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAIL,KAAK,iBAAiB,EACvB,MAAM,WAAW,CAAC;AAEnB,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,YAAY,CAAC;AAEpD,sEAAsE;AACtE,eAAO,MAAM,iBAAiB,QAAO,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAIvD,CAAC;AAEL,+EAA+E;AAC/E,eAAO,MAAM,aAAa,GAAI,QAAQ,iBAAiB,EAAE,KAAG,MAAM,EAAE,EASnE,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAClC,OAAO,YAAY,EACnB,QAAQ,iBAAiB,EAAE,EAC3B,YAAY,MAAM,EAAE,EACpB,aAAa,MAAM,EAAE,EACrB,sBAAqB,CAAC,MAAM,GAAG,SAAS,CAAC,EAAO,KAC/C,MAAM,CAAC,MAAM,EAAE,OAAO,CAwBxB,CAAC"}

package/dist/cjs/utils/plotly-surface.js

@@ -0,0 +1,64 @@
+"use strict";
+/**
+ * plotly traces for Excel's Surface family (rowsncolumns/spreadsheet#668
+ * C-33): `surface3DChart` (3-D Surface) is a WebGL `surface`, `surfaceChart`
+ * (Contour) is the same height grid seen from above as an SVG `contour`.
+ * Both take z as one row per series, one column per category.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildPlotlySurfaceTrace = exports.buildSurfaceZ = exports.surfaceColorscale = void 0;
+var tslib_1 = require("tslib");
+var axis_number_format_1 = require("./axis-number-format");
+var three_d_1 = require("./three-d");
+/** plotly `colorscale` — the shared surface ramp spread over 0..1. */
+var surfaceColorscale = function () {
+    return three_d_1.SURFACE_COLOR_RAMP.map(function (color, index) { return [
+        index / Math.max(1, three_d_1.SURFACE_COLOR_RAMP.length - 1),
+        color,
+    ]; });
+};
+exports.surfaceColorscale = surfaceColorscale;
+/** The z matrix (series rows × category columns) plotly's grid traces take. */
+var buildSurfaceZ = function (series) {
+    var e_1, _a;
+    var categoryCount = (0, three_d_1.getCategoryCount)(series);
+    var rows = series.map(function () {
+        return new Array(categoryCount).fill(0);
+    });
+    try {
+        for (var _b = tslib_1.__values((0, three_d_1.buildSurfaceData)(series)), _c = _b.next(); !_c.done; _c = _b.next()) {
+            var _d = tslib_1.__read(_c.value, 3), x = _d[0], y = _d[1], z = _d[2];
+            rows[y][x] = z;
+        }
+    }
+    catch (e_1_1) { e_1 = { error: e_1_1 }; }
+    finally {
+        try {
+            if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
+        }
+        finally { if (e_1) throw e_1.error; }
+    }
+    return rows;
+};
+exports.buildSurfaceZ = buildSurfaceZ;
+var buildPlotlySurfaceTrace = function (token, series, categories, seriesNames, seriesNumberFormats) {
+    if (seriesNumberFormats === void 0) { seriesNumberFormats = []; }
+    var z = (0, exports.buildSurfaceZ)(series);
+    // Hover text formats each cell with its series' own source cells.
+    var text = z.map(function (row, y) {
+        return row.map(function (value) { return (0, axis_number_format_1.formatAxisValue)(seriesNumberFormats[y], value); });
+    });
+    var shared = {
+        z: z,
+        x: categories,
+        y: seriesNames,
+        text: text,
+        colorscale: (0, exports.surfaceColorscale)(),
+        showscale: true,
+        hovertemplate: "%{y}<br>%{x}: %{text}<extra></extra>",
+        meta: { rncSeriesIndex: 0 },
+    };
+    return token === "SURFACE"
+        ? tslib_1.__assign(tslib_1.__assign({ type: "contour" }, shared), { contours: { coloring: "heatmap", showlines: true }, line: { width: 1 } }) : tslib_1.__assign({ type: "surface" }, shared);
+};
+exports.buildPlotlySurfaceTrace = buildPlotlySurfaceTrace;

package/dist/cjs/utils/plotly-title.d.ts

@@ -0,0 +1,12 @@
+/**
+ * The chart title text for a plotly layout. Plotly's `layout.title.font`
+ * carries family / size / colour but no weight or style, while the title
+ * text itself is rendered as pseudo-HTML — so an authored bold / italic
+ * (`titleTextFormat`, from OOXML `<a:rPr b="1" i="1">`) is emitted as `<b>`
+ * / `<i>` tags around the text, which plotly renders (#668 C-51).
+ */
+export declare const plotlyTitleText: (title: string | null | undefined, format?: {
+    bold?: boolean | null;
+    italic?: boolean | null;
+} | null) => string | undefined;
+//# sourceMappingURL=plotly-title.d.ts.map

package/dist/cjs/utils/plotly-title.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plotly-title.d.ts","sourceRoot":"","sources":["../../../utils/plotly-title.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,GAC1B,OAAO,MAAM,GAAG,IAAI,GAAG,SAAS,EAChC,SAAS;IAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,CAAA;CAAE,GAAG,IAAI,KACjE,MAAM,GAAG,SAYX,CAAC"}

package/dist/cjs/utils/plotly-title.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.plotlyTitleText = void 0;
+/**
+ * The chart title text for a plotly layout. Plotly's `layout.title.font`
+ * carries family / size / colour but no weight or style, while the title
+ * text itself is rendered as pseudo-HTML — so an authored bold / italic
+ * (`titleTextFormat`, from OOXML `<a:rPr b="1" i="1">`) is emitted as `<b>`
+ * / `<i>` tags around the text, which plotly renders (#668 C-51).
+ */
+var plotlyTitleText = function (title, format) {
+    if (title === undefined || title === null) {
+        return undefined;
+    }
+    var text = title;
+    if (format === null || format === void 0 ? void 0 : format.italic) {
+        text = "<i>".concat(text, "</i>");
+    }
+    if (format === null || format === void 0 ? void 0 : format.bold) {
+        text = "<b>".concat(text, "</b>");
+    }
+    return text;
+};
+exports.plotlyTitleText = plotlyTitleText;

package/dist/cjs/utils/series-click.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Maps a click inside a rendered chart back to the `spec.series` entry it
+ * belongs to, so the grid can highlight that series' source range like
+ * Excel does when a series is selected.
+ */
+/**
+ * echarts series id for `spec.series[specIndex]`. `sourceIndex` is `0` for the
+ * base series — a series drawn from several ranges renders as ONE echarts
+ * series over their union (Excel). Base series carry it so a click resolves
+ * without depending on the order overlays (trendlines, error bars) are
+ * appended in.
+ */
+export declare const chartSeriesId: (specIndex: number, sourceIndex: number) => string;
+/**
+ * The `spec.series` index a tagged echarts series id carries, or
+ * `undefined` for untagged (overlay / echarts auto) ids.
+ */
+export declare const chartSeriesSpecIndex: (id: string | null | undefined) => number | undefined;
+/**
+ * The data point a chart click lands on, as a category index into the
+ * series' source range, or `undefined` when the click has no per-point
+ * meaning (a radar item is a whole series; overlays carry none).
+ */
+export declare const resolveClickedDataIndex: (params: SeriesClickParams | null | undefined) => number | undefined;
+export type SeriesClickParams = {
+    seriesId?: string | null;
+    seriesIndex?: number | null;
+    seriesType?: string | null;
+    dataIndex?: number | null;
+};
+/**
+ * The `spec.series` index a chart click lands on, or `undefined` when the
+ * click cannot be attributed to a series (overlay, connector, empty area).
+ * Tagged base series resolve through their id; a radar chart is one echarts
+ * series whose data items are the spec series; other untagged series
+ * (pie slices, stock roles, waterfall bars…) map by position while it fits.
+ */
+export declare const resolveClickedSeriesIndex: (params: SeriesClickParams | null | undefined, seriesCount: number) => number | undefined;
+//# sourceMappingURL=series-click.d.ts.map

package/dist/cjs/utils/series-click.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"series-click.d.ts","sourceRoot":"","sources":["../../../utils/series-click.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,GAAI,WAAW,MAAM,EAAE,aAAa,MAAM,WAClB,CAAC;AAEnD;;;GAGG;AACH,eAAO,MAAM,oBAAoB,GAC/B,IAAI,MAAM,GAAG,IAAI,GAAG,SAAS,KAC5B,MAAM,GAAG,SAMX,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,GAClC,QAAQ,iBAAiB,GAAG,IAAI,GAAG,SAAS,KAC3C,MAAM,GAAG,SAMX,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB,GACpC,QAAQ,iBAAiB,GAAG,IAAI,GAAG,SAAS,EAC5C,aAAa,MAAM,KAClB,MAAM,GAAG,SAmBX,CAAC"}

package/dist/cjs/utils/series-click.js

@@ -0,0 +1,75 @@
+"use strict";
+/**
+ * Maps a click inside a rendered chart back to the `spec.series` entry it
+ * belongs to, so the grid can highlight that series' source range like
+ * Excel does when a series is selected.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveClickedSeriesIndex = exports.resolveClickedDataIndex = exports.chartSeriesSpecIndex = exports.chartSeriesId = void 0;
+var SERIES_ID_PREFIX = "rnc-series-";
+/**
+ * echarts series id for `spec.series[specIndex]`. `sourceIndex` is `0` for the
+ * base series — a series drawn from several ranges renders as ONE echarts
+ * series over their union (Excel). Base series carry it so a click resolves
+ * without depending on the order overlays (trendlines, error bars) are
+ * appended in.
+ */
+var chartSeriesId = function (specIndex, sourceIndex) {
+    return "".concat(SERIES_ID_PREFIX).concat(specIndex, "-").concat(sourceIndex);
+};
+exports.chartSeriesId = chartSeriesId;
+/**
+ * The `spec.series` index a tagged echarts series id carries, or
+ * `undefined` for untagged (overlay / echarts auto) ids.
+ */
+var chartSeriesSpecIndex = function (id) {
+    if (typeof id !== "string" || !id.startsWith(SERIES_ID_PREFIX)) {
+        return undefined;
+    }
+    var specIndex = Number.parseInt(id.slice(SERIES_ID_PREFIX.length), 10);
+    return Number.isFinite(specIndex) ? specIndex : undefined;
+};
+exports.chartSeriesSpecIndex = chartSeriesSpecIndex;
+/**
+ * The data point a chart click lands on, as a category index into the
+ * series' source range, or `undefined` when the click has no per-point
+ * meaning (a radar item is a whole series; overlays carry none).
+ */
+var resolveClickedDataIndex = function (params) {
+    if (!params || params.seriesType === "radar")
+        return undefined;
+    var dataIndex = params.dataIndex;
+    return typeof dataIndex === "number" && dataIndex >= 0
+        ? dataIndex
+        : undefined;
+};
+exports.resolveClickedDataIndex = resolveClickedDataIndex;
+/**
+ * The `spec.series` index a chart click lands on, or `undefined` when the
+ * click cannot be attributed to a series (overlay, connector, empty area).
+ * Tagged base series resolve through their id; a radar chart is one echarts
+ * series whose data items are the spec series; other untagged series
+ * (pie slices, stock roles, waterfall bars…) map by position while it fits.
+ */
+var resolveClickedSeriesIndex = function (params, seriesCount) {
+    if (!params)
+        return undefined;
+    var id = typeof params.seriesId === "string" ? params.seriesId : "";
+    if (id.startsWith(SERIES_ID_PREFIX)) {
+        var specIndex = (0, exports.chartSeriesSpecIndex)(id);
+        return specIndex !== undefined && specIndex < seriesCount
+            ? specIndex
+            : undefined;
+    }
+    if (params.seriesType === "radar") {
+        var dataIndex = params.dataIndex;
+        return typeof dataIndex === "number" && dataIndex < seriesCount
+            ? dataIndex
+            : undefined;
+    }
+    var seriesIndex = params.seriesIndex;
+    return typeof seriesIndex === "number" && seriesIndex < seriesCount
+        ? seriesIndex
+        : undefined;
+};
+exports.resolveClickedSeriesIndex = resolveClickedSeriesIndex;

package/dist/cjs/utils/three-d.d.ts

@@ -16,8 +16,12 @@
  * - LINE_3D   -> `line3D`  (one polyline per series at its series-index depth)
  * - AREA_3D   -> `line3D`  (echarts-gl has no area3D; the polyline keeps the
  *                          authored depth layout)
- * - SURFACE / SURFACE_3D -> `surface` (values grid as z-heights over the
+ * - SURFACE_3D -> `surface` (values grid as z-heights over the
  *                          categories × series plane)
+ * - SURFACE   -> null      (Excel's Contour is the top-down view of the same
+ *                          grid; the renderer draws it as a 2-D heatmap over
+ *                          categories × series — `buildContourData` — with
+ *                          no WebGL involved)
  * - PIE_3D    -> null      (echarts-gl has no pie3D; the renderer keeps the
  *                          existing 2-D pie fallback rather than faking it)
  */
@@ -48,6 +52,18 @@ export declare const is3DSpec: (spec: {
  * - non-3-D / unknown tokens.
  */
 export declare const resolve3DRenderKind: (sourceChartType?: string | null) => ThreeDRenderKind | null;
+/** Excel's Contour: the surface grid seen from above, as a flat heatmap. */
+export declare const isContourSpec: (spec: {
+    sourceChartType?: string | null;
+} | null | undefined) => boolean;
+/** One heatmap cell: [category index, series index, value]; `"-"` is an empty cell. */
+export type ContourPoint = [number, number, number | "-"];
+/**
+ * Flatten the categories × series value matrix into echarts `heatmap`
+ * data. Unlike `buildSurfaceData` (which needs a full grid of heights)
+ * an empty cell stays empty (`"-"`) instead of dropping to 0.
+ */
+export declare const buildContourData: (series: ThreeDSeriesInput[]) => ContourPoint[];
 export type ThreeDSeriesInput = {
     /** Resolved series display name (legend / y-axis label). */
     name: string;

package/dist/cjs/utils/three-d.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"three-d.d.ts","sourceRoot":"","sources":["../../../utils/three-d.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,QAAA,MAAM,cAAc,8EAOV,CAAC;AAEX,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/D,wDAAwD;AACxD,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;AAI9D;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,GAChC,kBAAkB,MAAM,GAAG,IAAI,KAC9B,gBAAgB,GAAG,IAIrB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,GACnB,MAAM;IAAE,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAAG,IAAI,GAAG,SAAS,KAC3D,OAAgE,CAAC;AAEpE;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,GAC9B,kBAAkB,MAAM,GAAG,IAAI,KAC9B,gBAAgB,GAAG,IAcrB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,iEAAiE;IACjE,MAAM,EAAE,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,CAAC;CACvC,CAAC;AAEF,wDAAwD;AACxD,MAAM,MAAM,WAAW,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAKnD,8DAA8D;AAC9D,eAAO,MAAM,gBAAgB,GAAI,QAAQ,iBAAiB,EAAE,KAAG,MACO,CAAC;AAEvE;;;;GAIG;AACH,eAAO,MAAM,cAAc,GAAI,QAAQ,iBAAiB,EAAE,KAAG,WAAW,EAUvE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,GAC5B,QAAQ,iBAAiB,EAAE,KAC1B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,WAAW,EAAE,CAAA;CAAE,EASpC,CAAC;AAEL;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,GAC3B,QAAQ,iBAAiB,EAAE,KAC1B,WAAW,EAcb,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,cAAc,GAAI,QAAQ,WAAW,EAAE,KAAG,CAAC,MAAM,EAAE,MAAM,CASrE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,SAAS,MAAM,EAY/C,CAAC"}
+{"version":3,"file":"three-d.d.ts","sourceRoot":"","sources":["../../../utils/three-d.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,QAAA,MAAM,cAAc,8EAOV,CAAC;AAEX,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/D,wDAAwD;AACxD,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;AAI9D;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,GAChC,kBAAkB,MAAM,GAAG,IAAI,KAC9B,gBAAgB,GAAG,IAIrB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,GACnB,MAAM;IAAE,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAAG,IAAI,GAAG,SAAS,KAC3D,OAAgE,CAAC;AAEpE;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,GAC9B,kBAAkB,MAAM,GAAG,IAAI,KAC9B,gBAAgB,GAAG,IAcrB,CAAC;AAEF,4EAA4E;AAC5E,eAAO,MAAM,aAAa,GACxB,MAAM;IAAE,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAAG,IAAI,GAAG,SAAS,KAC3D,OAAqE,CAAC;AAEzE,uFAAuF;AACvF,MAAM,MAAM,YAAY,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,GAAG,CAAC,CAAC;AAE1D;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAC3B,QAAQ,iBAAiB,EAAE,KAC1B,YAAY,EAcd,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,iEAAiE;IACjE,MAAM,EAAE,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,CAAC;CACvC,CAAC;AAEF,wDAAwD;AACxD,MAAM,MAAM,WAAW,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAKnD,8DAA8D;AAC9D,eAAO,MAAM,gBAAgB,GAAI,QAAQ,iBAAiB,EAAE,KAAG,MACO,CAAC;AAEvE;;;;GAIG;AACH,eAAO,MAAM,cAAc,GAAI,QAAQ,iBAAiB,EAAE,KAAG,WAAW,EAUvE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,GAC5B,QAAQ,iBAAiB,EAAE,KAC1B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,WAAW,EAAE,CAAA;CAAE,EASpC,CAAC;AAEL;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,GAC3B,QAAQ,iBAAiB,EAAE,KAC1B,WAAW,EAcb,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,cAAc,GAAI,QAAQ,WAAW,EAAE,KAAG,CAAC,MAAM,EAAE,MAAM,CASrE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,SAAS,MAAM,EAY/C,CAAC"}

package/dist/cjs/utils/three-d.js

@@ -17,13 +17,17 @@
  * - LINE_3D   -> `line3D`  (one polyline per series at its series-index depth)
  * - AREA_3D   -> `line3D`  (echarts-gl has no area3D; the polyline keeps the
  *                          authored depth layout)
- * - SURFACE / SURFACE_3D -> `surface` (values grid as z-heights over the
+ * - SURFACE_3D -> `surface` (values grid as z-heights over the
  *                          categories × series plane)
+ * - SURFACE   -> null      (Excel's Contour is the top-down view of the same
+ *                          grid; the renderer draws it as a 2-D heatmap over
+ *                          categories × series — `buildContourData` — with
+ *                          no WebGL involved)
  * - PIE_3D    -> null      (echarts-gl has no pie3D; the renderer keeps the
  *                          existing 2-D pie fallback rather than faking it)
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SURFACE_COLOR_RAMP = exports.getValueExtent = exports.buildSurfaceData = exports.buildLine3DSeries = exports.buildBar3DData = exports.getCategoryCount = exports.resolve3DRenderKind = exports.is3DSpec = exports.normalize3DSourceType = void 0;
+exports.SURFACE_COLOR_RAMP = exports.getValueExtent = exports.buildSurfaceData = exports.buildLine3DSeries = exports.buildBar3DData = exports.getCategoryCount = exports.buildContourData = exports.isContourSpec = exports.resolve3DRenderKind = exports.is3DSpec = exports.normalize3DSourceType = void 0;
 var tslib_1 = require("tslib");
 var THREE_D_TOKENS = [
     "BAR_3D",
@@ -68,15 +72,39 @@ var resolve3DRenderKind = function (sourceChartType) {
         case "LINE_3D":
         case "AREA_3D":
             return "line3D";
-        case "SURFACE":
         case "SURFACE_3D":
             return "surface";
         default:
-            // PIE_3D and non-3-D tokens: keep the 2-D fallback rendering.
+            // SURFACE (contour — drawn flat), PIE_3D and non-3-D tokens: keep
+            // the 2-D rendering.
             return null;
     }
 };
 exports.resolve3DRenderKind = resolve3DRenderKind;
+/** Excel's Contour: the surface grid seen from above, as a flat heatmap. */
+var isContourSpec = function (spec) { return (0, exports.normalize3DSourceType)(spec === null || spec === void 0 ? void 0 : spec.sourceChartType) === "SURFACE"; };
+exports.isContourSpec = isContourSpec;
+/**
+ * Flatten the categories × series value matrix into echarts `heatmap`
+ * data. Unlike `buildSurfaceData` (which needs a full grid of heights)
+ * an empty cell stays empty (`"-"`) instead of dropping to 0.
+ */
+var buildContourData = function (series) {
+    var categoryCount = (0, exports.getCategoryCount)(series);
+    var points = [];
+    series.forEach(function (entry, seriesIndex) {
+        for (var categoryIndex = 0; categoryIndex < categoryCount; categoryIndex++) {
+            var value = entry.values[categoryIndex];
+            points.push([
+                categoryIndex,
+                seriesIndex,
+                isFiniteNumber(value) ? value : "-",
+            ]);
+        }
+    });
+    return points;
+};
+exports.buildContourData = buildContourData;
 var isFiniteNumber = function (value) {
     return typeof value === "number" && Number.isFinite(value);
 };

package/dist/esm/atoms/pivot-chart.atom.d.ts

@@ -0,0 +1,14 @@
+import type { CellInterface, SelectionArea } from "@rowsncolumns/common-types";
+import type { SelectionAttributes } from "@rowsncolumns/spreadsheet";
+/** Insert → PivotChart: where the chart goes and what the user had selected. */
+export type PivotChartRequest = {
+    sheetId: number;
+    activeCell: CellInterface;
+    selections: SelectionArea<SelectionAttributes>[];
+};
+export declare const pivotChartRequestAtom: import("jotai").PrimitiveAtom<PivotChartRequest | undefined> & {
+    init: PivotChartRequest | undefined;
+};
+export declare const usePivotChartRequest: () => [PivotChartRequest | undefined, (args_0: PivotChartRequest | ((prev: PivotChartRequest | undefined) => PivotChartRequest | undefined) | undefined) => void];
+export declare const useSetPivotChartRequest: () => (args_0: PivotChartRequest | ((prev: PivotChartRequest | undefined) => PivotChartRequest | undefined) | undefined) => void;
+//# sourceMappingURL=pivot-chart.atom.d.ts.map

package/dist/esm/atoms/pivot-chart.atom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pivot-chart.atom.d.ts","sourceRoot":"","sources":["../../../atoms/pivot-chart.atom.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC/E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAGrE,gFAAgF;AAChF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,aAAa,CAAC;IAC1B,UAAU,EAAE,aAAa,CAAC,mBAAmB,CAAC,EAAE,CAAC;CAClD,CAAC;AAEF,eAAO,MAAM,qBAAqB;;CAEjC,CAAC;AAEF,eAAO,MAAM,oBAAoB,mKAAuC,CAAC;AACzE,eAAO,MAAM,uBAAuB,kIAA0C,CAAC"}

package/dist/esm/atoms/pivot-chart.atom.js

@@ -0,0 +1,4 @@
+import { atom, useAtom, useSetAtom } from "jotai";
+export const pivotChartRequestAtom = atom(undefined);
+export const usePivotChartRequest = () => useAtom(pivotChartRequestAtom);
+export const useSetPivotChartRequest = () => useSetAtom(pivotChartRequestAtom);

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

@@ -1,5 +1,5 @@
 import React from "react";
 import type { EChartComponentProps } from "../types";
 export type BasicChartProps = EChartComponentProps;
-export declare const BasicChart: ({ width, height, chart, theme, isDarkMode, sheetId, readonly, getDomainValuesFromRange, getSeriesValuesFromRange, onDeleteChart, onRequestEdit, onRequestCalculate, isSelected, }: BasicChartProps) => React.JSX.Element;
+export declare const BasicChart: ({ width, height, chart, theme, isDarkMode, sheetId, readonly, getDomainValuesFromRange, getSeriesValuesFromRange, getFormattingFromRange, onDeleteChart, onUpdateChart, onRequestEdit, onRequestCalculate, isSelected, fieldButtons, }: BasicChartProps) => React.JSX.Element;
 //# sourceMappingURL=basic-chart.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"basic-chart.d.ts","sourceRoot":"","sources":["../../../basic-chart/basic-chart.tsx"],"names":[],"mappings":"AAqDA,OAAO,KAAiD,MAAM,OAAO,CAAC;AAEtE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAiNrD,MAAM,MAAM,eAAe,GAAG,oBAAoB,CAAC;AA+DnD,eAAO,MAAM,UAAU,GAAI,mLAcxB,eAAe,sBAolFjB,CAAC"}
+{"version":3,"file":"basic-chart.d.ts","sourceRoot":"","sources":["../../../basic-chart/basic-chart.tsx"],"names":[],"mappings":"AA4DA,OAAO,KAAiD,MAAM,OAAO,CAAC;AAEtE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AA0PrD,MAAM,MAAM,eAAe,GAAG,oBAAoB,CAAC;AAkEnD,eAAO,MAAM,UAAU,GAAI,wOAiBxB,eAAe,sBAmuGjB,CAAC"}