@neo4j-ndl/react-charts 1.1.1 → 1.1.3

package/lib/cjs/charts/hooks/use-chart-option.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-chart-option.js","sourceRoot":"","sources":["../../../../src/charts/hooks/use-chart-option.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;GAmBG;;AAmCH,wCA4DC;AA5FD,qCAA2C;AAC3C,iCAA4C;AAE5C,oEAA+D;AAG/D,qDAAuD;AAiBvD;;;;;;;;GAQG;AACH,SAAgB,cAAc,CAAC,EAC7B,QAAQ,EACR,OAAO,EACP,gBAAgB,EAChB,aAAa,EACb,WAAW,EACX,MAAM,EACN,QAAQ,EACR,cAAc,EACd,cAAc,EACd,UAAU,EACV,KAAK,EACL,KAAK,GACgB;IACrB,MAAM,EAAE,cAAc,EAAE,iBAAiB,EAAE,GAAG,IAAA,oCAAmB,GAAE,CAAC;IACpE,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC,GAAG,IAAA,gBAAQ,GAAiB,CAAC;IAEhE,IAAA,iBAAS,EAAC,GAAG,EAAE;QACb,IAAI,cAAc,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;YACpC,OAAO;QACT,CAAC;QAED,MAAM,KAAK,GAAG,IAAA,0BAAgB,EAAC,cAAc,CAAC,OAAO,CAAC,CAAC;QAEvD,MAAM,MAAM,GAAG,IAAA,qCAAgB,EAAC;YAC9B,QAAQ;YACR,OAAO;YACP,gBAAgB;YAChB,aAAa;YACb,cAAc,EAAE,iBAAiB,CAAC,OAAO,IAAI,EAAE;YAC/C,WAAW;YACX,MAAM;YACN,cAAc;YACd,cAAc;YACd,UAAU;YACV,KAAK;YACL,KAAK;SACN,CAAC,CAAC;QAEH,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,SAAS,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QAEnC,cAAc,CAAC,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,SAAS,EAA+B,CAAC,CAAC;IAClE,CAAC,EAAE;QACD,cAAc;QACd,QAAQ;QACR,OAAO;QACP,gBAAgB;QAChB,aAAa;QACb,iBAAiB;QACjB,WAAW;QACX,MAAM;QACN,QAAQ;QACR,cAAc;QACd,cAAc;QACd,UAAU;QACV,KAAK;QACL,KAAK;KACN,CAAC,CAAC;IAEH,OAAO,WAAW,CAAC;AACrB,CAAC","sourcesContent":["/**\n *\n *  Copyright (c) \"Neo4j\"\n *  Neo4j Sweden AB [http://neo4j.com]\n *\n *  This file is part of Neo4j.\n *\n *  Neo4j is free software: you can redistribute it and/or modify\n *  it under the terms of the GNU General Public License as published by\n *  the Free Software Foundation, either version 3 of the License, or\n *  (at your option) any later version.\n *\n *  This program is distributed in the hope that it will be useful,\n *  but WITHOUT ANY WARRANTY; without even the implied warranty of\n *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\n *  GNU General Public License for more details.\n *\n *  You should have received a copy of the GNU General Public License\n *  along with this program.  If not, see <http://www.gnu.org/licenses/>.\n */\n\nimport type { EChartsOption } from 'echarts';\nimport { getInstanceByDom } from 'echarts';\nimport { useEffect, useState } from 'react';\n\nimport { buildChartOption } from '../utils/build-chart-option';\nimport type { ChartProps, EchartsSeries } from '../utils/chart-types';\nimport type { NormalizedThresholdLine } from '../utils/threshold';\nimport { useChartRefsContext } from './use-chart-refs';\n\nexport type UseChartOptionParams = {\n  dataZoom: EChartsOption['dataZoom'];\n  dataset: ChartProps['dataset'];\n  hasCategoryXAxis: boolean;\n  hasSliderZoom: boolean;\n  propsSeries: ChartProps['series'];\n  series: EchartsSeries;\n  settings: ChartProps['settings'];\n  thresholdLines: NormalizedThresholdLine[];\n  toolboxOptions: EChartsOption['toolbox'];\n  userOption: ChartProps['option'];\n  xAxis: EChartsOption['xAxis'];\n  yAxis: EChartsOption['yAxis'];\n};\n\n/**\n * Builds, applies, and exposes the ECharts option for the current React props.\n *\n * `buildChartOption` merges Needle defaults, normalized axes/series, threshold\n * lines, zoom settings, toolbox options, user overrides, and the current legend\n * selection. After `setOption`, the hook returns ECharts' normalized option so\n * downstream code, especially the custom legend, can read the final series and\n * dataset shape ECharts is actually using.\n */\nexport function useChartOption({\n  dataZoom,\n  dataset,\n  hasCategoryXAxis,\n  hasSliderZoom,\n  propsSeries,\n  series,\n  settings,\n  thresholdLines,\n  toolboxOptions,\n  userOption,\n  xAxis,\n  yAxis,\n}: UseChartOptionParams) {\n  const { chartEchartRef, legendSelectedRef } = useChartRefsContext();\n  const [chartOption, setChartOption] = useState<EChartsOption>();\n\n  useEffect(() => {\n    if (chartEchartRef.current === null) {\n      return;\n    }\n\n    const chart = getInstanceByDom(chartEchartRef.current);\n\n    const option = buildChartOption({\n      dataZoom,\n      dataset,\n      hasCategoryXAxis,\n      hasSliderZoom,\n      legendSelected: legendSelectedRef.current || {},\n      propsSeries,\n      series,\n      thresholdLines,\n      toolboxOptions,\n      userOption,\n      xAxis,\n      yAxis,\n    });\n\n    chart?.setOption(option, settings);\n\n    setChartOption(chart?.getOption() as EChartsOption | undefined);\n  }, [\n    chartEchartRef,\n    dataZoom,\n    dataset,\n    hasCategoryXAxis,\n    hasSliderZoom,\n    legendSelectedRef,\n    propsSeries,\n    series,\n    settings,\n    thresholdLines,\n    toolboxOptions,\n    userOption,\n    xAxis,\n    yAxis,\n  ]);\n\n  return chartOption;\n}\n"]}

package/lib/cjs/charts/hooks/use-chart-refs.js

@@ -0,0 +1,52 @@
+"use strict";
+/**
+ *
+ *  Copyright (c) "Neo4j"
+ *  Neo4j Sweden AB [http://neo4j.com]
+ *
+ *  This file is part of Neo4j.
+ *
+ *  Neo4j is free software: you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License as published by
+ *  the Free Software Foundation, either version 3 of the License, or
+ *  (at your option) any later version.
+ *
+ *  This program is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChartRefsProvider = ChartRefsProvider;
+exports.useChartRefsContext = useChartRefsContext;
+const react_1 = require("react");
+const ChartRefsContext = (0, react_1.createContext)(undefined);
+/**
+ * Creates the mutable refs shared between `ChartRender` and legend components.
+ *
+ * `chartEchartRef` points at the ECharts host element, while the legend refs act
+ * as a bridge for state that ECharts needs synchronously during option rebuilds
+ * without forcing extra React renders.
+ */
+function ChartRefsProvider({ children }) {
+    const chartEchartRef = (0, react_1.useRef)(null);
+    const legendSelectedRef = (0, react_1.useRef)({});
+    const legendColorCacheRef = (0, react_1.useRef)(new Map());
+    const refs = (0, react_1.useMemo)(() => ({
+        chartEchartRef,
+        legendColorCacheRef,
+        legendSelectedRef,
+    }), []);
+    return (0, react_1.createElement)(ChartRefsContext.Provider, { value: refs }, children);
+}
+function useChartRefsContext() {
+    const refs = (0, react_1.useContext)(ChartRefsContext);
+    if (refs === undefined) {
+        throw new Error('useChartRefsContext must be used within ChartRefsProvider');
+    }
+    return refs;
+}
+//# sourceMappingURL=use-chart-refs.js.map

package/lib/cjs/charts/hooks/use-chart-refs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-chart-refs.js","sourceRoot":"","sources":["../../../../src/charts/hooks/use-chart-refs.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;GAmBG;;AA0BH,8CAcC;AAED,kDASC;AAjDD,iCAOe;AAQf,MAAM,gBAAgB,GAAG,IAAA,qBAAa,EAAwB,SAAS,CAAC,CAAC;AAEzE;;;;;;GAMG;AACH,SAAgB,iBAAiB,CAAC,EAAE,QAAQ,EAA2B;IACrE,MAAM,cAAc,GAAG,IAAA,cAAM,EAAiB,IAAI,CAAC,CAAC;IACpD,MAAM,iBAAiB,GAAG,IAAA,cAAM,EAA0B,EAAE,CAAC,CAAC;IAC9D,MAAM,mBAAmB,GAAG,IAAA,cAAM,EAAsB,IAAI,GAAG,EAAE,CAAC,CAAC;IACnE,MAAM,IAAI,GAAG,IAAA,eAAO,EAClB,GAAG,EAAE,CAAC,CAAC;QACL,cAAc;QACd,mBAAmB;QACnB,iBAAiB;KAClB,CAAC,EACF,EAAE,CACH,CAAC;IAEF,OAAO,IAAA,qBAAa,EAAC,gBAAgB,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,QAAQ,CAAC,CAAC;AAC7E,CAAC;AAED,SAAgB,mBAAmB;IACjC,MAAM,IAAI,GAAG,IAAA,kBAAU,EAAC,gBAAgB,CAAC,CAAC;IAC1C,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CACb,2DAA2D,CAC5D,CAAC;IACJ,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC","sourcesContent":["/**\n *\n *  Copyright (c) \"Neo4j\"\n *  Neo4j Sweden AB [http://neo4j.com]\n *\n *  This file is part of Neo4j.\n *\n *  Neo4j is free software: you can redistribute it and/or modify\n *  it under the terms of the GNU General Public License as published by\n *  the Free Software Foundation, either version 3 of the License, or\n *  (at your option) any later version.\n *\n *  This program is distributed in the hope that it will be useful,\n *  but WITHOUT ANY WARRANTY; without even the implied warranty of\n *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\n *  GNU General Public License for more details.\n *\n *  You should have received a copy of the GNU General Public License\n *  along with this program.  If not, see <http://www.gnu.org/licenses/>.\n */\n\nimport {\n  createContext,\n  createElement,\n  type ReactNode,\n  useContext,\n  useMemo,\n  useRef,\n} from 'react';\n\nexport type ChartRefs = {\n  chartEchartRef: React.RefObject<HTMLDivElement | null>;\n  legendColorCacheRef: React.RefObject<Map<string, string>>;\n  legendSelectedRef: React.RefObject<Record<string, boolean>>;\n};\n\nconst ChartRefsContext = createContext<ChartRefs | undefined>(undefined);\n\n/**\n * Creates the mutable refs shared between `ChartRender` and legend components.\n *\n * `chartEchartRef` points at the ECharts host element, while the legend refs act\n * as a bridge for state that ECharts needs synchronously during option rebuilds\n * without forcing extra React renders.\n */\nexport function ChartRefsProvider({ children }: { children: ReactNode }) {\n  const chartEchartRef = useRef<HTMLDivElement>(null);\n  const legendSelectedRef = useRef<Record<string, boolean>>({});\n  const legendColorCacheRef = useRef<Map<string, string>>(new Map());\n  const refs = useMemo(\n    () => ({\n      chartEchartRef,\n      legendColorCacheRef,\n      legendSelectedRef,\n    }),\n    [],\n  );\n\n  return createElement(ChartRefsContext.Provider, { value: refs }, children);\n}\n\nexport function useChartRefsContext() {\n  const refs = useContext(ChartRefsContext);\n  if (refs === undefined) {\n    throw new Error(\n      'useChartRefsContext must be used within ChartRefsProvider',\n    );\n  }\n\n  return refs;\n}\n"]}

package/lib/cjs/charts/hooks/use-chart-zoom.js

@@ -0,0 +1,117 @@
+"use strict";
+/**
+ *
+ *  Copyright (c) "Neo4j"
+ *  Neo4j Sweden AB [http://neo4j.com]
+ *
+ *  This file is part of Neo4j.
+ *
+ *  Neo4j is free software: you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License as published by
+ *  the Free Software Foundation, either version 3 of the License, or
+ *  (at your option) any later version.
+ *
+ *  This program is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useChartZoom = useChartZoom;
+const echarts_1 = require("echarts");
+const react_1 = require("react");
+const use_chart_refs_1 = require("./use-chart-refs");
+/**
+ * Owns ECharts zoom interactions and forwards zoom changes to consumers.
+ *
+ * The hook subscribes to ECharts `datazoom` events, enables drag-to-zoom through
+ * ECharts' global cursor API, resets zoom on double click, and clears ECharts'
+ * SVG cursor override after mouse movement so Needle's default cursor styling is
+ * preserved.
+ */
+function useChartZoom({ callbacks, isChartZoomDisabled, }) {
+    const { chartEchartRef } = (0, use_chart_refs_1.useChartRefsContext)();
+    (0, react_1.useEffect)(() => {
+        var _a;
+        const chart = chartEchartRef.current === null
+            ? undefined
+            : (0, echarts_1.getInstanceByDom)(chartEchartRef.current);
+        if (callbacks === null || callbacks === void 0 ? void 0 : callbacks.onZoom) {
+            chart === null || chart === void 0 ? void 0 : chart.on('datazoom', () => {
+                var _a;
+                if (chartEchartRef.current === null) {
+                    return;
+                }
+                const currentChart = (0, echarts_1.getInstanceByDom)(chartEchartRef.current);
+                if (!currentChart) {
+                    return;
+                }
+                const option = currentChart.getOption();
+                if (!option || !option.dataZoom) {
+                    return;
+                }
+                const dataZoom = Array.isArray(option.dataZoom)
+                    ? option.dataZoom[0]
+                    : option.dataZoom;
+                const { startValue, endValue } = dataZoom;
+                (_a = callbacks === null || callbacks === void 0 ? void 0 : callbacks.onZoom) === null || _a === void 0 ? void 0 : _a.call(callbacks, { endValue, startValue });
+            });
+        }
+        const handleMouseMove = () => {
+            // ECharts updates SVG cursor styles on mouse move, so Needle has to
+            // reset it after ECharts' internal handler runs.
+            chart === null || chart === void 0 ? void 0 : chart.getZr().setCursorStyle('default');
+        };
+        const chartChild = (_a = chartEchartRef.current) === null || _a === void 0 ? void 0 : _a.children[0];
+        if (!isChartZoomDisabled) {
+            chartChild === null || chartChild === void 0 ? void 0 : chartChild.addEventListener('mousemove', handleMouseMove);
+        }
+        const handleMouseDown = (params) => {
+            var _a;
+            const event = params.event;
+            const amountOfMouseClicks = event.detail;
+            const isDoubleClick = amountOfMouseClicks === 2;
+            if (isDoubleClick) {
+                if (chart === undefined) {
+                    return;
+                }
+                chart === null || chart === void 0 ? void 0 : chart.dispatchAction({
+                    end: 100,
+                    start: 0,
+                    type: 'dataZoom',
+                });
+                if (callbacks === null || callbacks === void 0 ? void 0 : callbacks.onZoom) {
+                    (_a = callbacks === null || callbacks === void 0 ? void 0 : callbacks.onZoom) === null || _a === void 0 ? void 0 : _a.call(callbacks, { endValue: 100, startValue: 0 });
+                }
+            }
+        };
+        if (!isChartZoomDisabled) {
+            chart === null || chart === void 0 ? void 0 : chart.getZr().on('mousedown', handleMouseDown);
+        }
+        const chartRefCurrentElement = chartEchartRef.current;
+        const element = chartRefCurrentElement === null || chartRefCurrentElement === void 0 ? void 0 : chartRefCurrentElement.children[0];
+        return () => {
+            element === null || element === void 0 ? void 0 : element.removeEventListener('mousemove', handleMouseMove);
+            if (chartRefCurrentElement) {
+                const chart = (0, echarts_1.getInstanceByDom)(chartRefCurrentElement);
+                chart === null || chart === void 0 ? void 0 : chart.getZr().off('mousedown', handleMouseDown);
+            }
+        };
+    });
+    if (chartEchartRef.current !== null && !isChartZoomDisabled) {
+        const chart = (0, echarts_1.getInstanceByDom)(chartEchartRef.current);
+        if (chart) {
+            // Needs to be re-set on every re-render. Sets the selectable zoom area
+            // over the chart body, not the slider.
+            chart.dispatchAction({
+                dataZoomSelectActive: true,
+                key: 'dataZoomSelect',
+                type: 'takeGlobalCursor',
+            });
+        }
+    }
+}
+//# sourceMappingURL=use-chart-zoom.js.map

package/lib/cjs/charts/hooks/use-chart-zoom.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-chart-zoom.js","sourceRoot":"","sources":["../../../../src/charts/hooks/use-chart-zoom.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n *\n *  Copyright (c) \"Neo4j\"\n *  Neo4j Sweden AB [http://neo4j.com]\n *\n *  This file is part of Neo4j.\n *\n *  Neo4j is free software: you can redistribute it and/or modify\n *  it under the terms of the GNU General Public License as published by\n *  the Free Software Foundation, either version 3 of the License, or\n *  (at your option) any later version.\n *\n *  This program is distributed in the hope that it will be useful,\n *  but WITHOUT ANY WARRANTY; without even the implied warranty of\n *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\n *  GNU General Public License for more details.\n *\n *  You should have received a copy of the GNU General Public License\n *  along with this program.  If not, see <http://www.gnu.org/licenses/>.\n */\n\nimport { getInstanceByDom } from 'echarts';\nimport { useEffect } from 'react';\n\nimport type { ChartProps } from '../utils/chart-types';\nimport { useChartRefsContext } from './use-chart-refs';\n\ntype UseChartZoomParams = {\n  callbacks: ChartProps['callbacks'];\n  isChartZoomDisabled: boolean;\n};\n\n/**\n * Owns ECharts zoom interactions and forwards zoom changes to consumers.\n *\n * The hook subscribes to ECharts `datazoom` events, enables drag-to-zoom through\n * ECharts' global cursor API, resets zoom on double click, and clears ECharts'\n * SVG cursor override after mouse movement so Needle's default cursor styling is\n * preserved.\n */\nexport function useChartZoom({\n  callbacks,\n  isChartZoomDisabled,\n}: UseChartZoomParams) {\n  const { chartEchartRef } = useChartRefsContext();\n\n  useEffect(() => {\n    const chart =\n      chartEchartRef.current === null\n        ? undefined\n        : getInstanceByDom(chartEchartRef.current);\n\n    if (callbacks?.onZoom) {\n      chart?.on('datazoom', () => {\n        if (chartEchartRef.current === null) {\n          return;\n        }\n\n        const currentChart = getInstanceByDom(chartEchartRef.current);\n        if (!currentChart) {\n          return;\n        }\n\n        const option = currentChart.getOption();\n        if (!option || !option.dataZoom) {\n          return;\n        }\n\n        const dataZoom = Array.isArray(option.dataZoom)\n          ? option.dataZoom[0]\n          : option.dataZoom;\n        const { startValue, endValue } = dataZoom as {\n          startValue: number;\n          endValue: number;\n        };\n\n        callbacks?.onZoom?.({ endValue, startValue });\n      });\n    }\n\n    const handleMouseMove = () => {\n      // ECharts updates SVG cursor styles on mouse move, so Needle has to\n      // reset it after ECharts' internal handler runs.\n      chart?.getZr().setCursorStyle('default');\n    };\n    const chartChild = chartEchartRef.current?.children[0] as\n      | HTMLElement\n      | undefined;\n    if (!isChartZoomDisabled) {\n      chartChild?.addEventListener('mousemove', handleMouseMove);\n    }\n\n    const handleMouseDown = (params: { event: MouseEvent }) => {\n      const event = params.event;\n      const amountOfMouseClicks = event.detail;\n      const isDoubleClick = amountOfMouseClicks === 2;\n      if (isDoubleClick) {\n        if (chart === undefined) {\n          return;\n        }\n        chart?.dispatchAction({\n          end: 100,\n          start: 0,\n          type: 'dataZoom',\n        });\n        if (callbacks?.onZoom) {\n          callbacks?.onZoom?.({ endValue: 100, startValue: 0 });\n        }\n      }\n    };\n    if (!isChartZoomDisabled) {\n      chart?.getZr().on('mousedown', handleMouseDown);\n    }\n\n    const chartRefCurrentElement = chartEchartRef.current;\n    const element = chartRefCurrentElement?.children[0];\n    return () => {\n      element?.removeEventListener('mousemove', handleMouseMove);\n\n      if (chartRefCurrentElement) {\n        const chart = getInstanceByDom(chartRefCurrentElement);\n        chart?.getZr().off('mousedown', handleMouseDown);\n      }\n    };\n  });\n\n  if (chartEchartRef.current !== null && !isChartZoomDisabled) {\n    const chart = getInstanceByDom(chartEchartRef.current);\n    if (chart) {\n      // Needs to be re-set on every re-render. Sets the selectable zoom area\n      // over the chart body, not the slider.\n      chart.dispatchAction({\n        dataZoomSelectActive: true,\n        key: 'dataZoomSelect',\n        type: 'takeGlobalCursor',\n      });\n    }\n  }\n}\n"]}

package/lib/cjs/charts/hooks/use-legend-interactions.js

@@ -0,0 +1,149 @@
+"use strict";
+/**
+ *
+ *  Copyright (c) "Neo4j"
+ *  Neo4j Sweden AB [http://neo4j.com]
+ *
+ *  This file is part of Neo4j.
+ *
+ *  Neo4j is free software: you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License as published by
+ *  the Free Software Foundation, either version 3 of the License, or
+ *  (at your option) any later version.
+ *
+ *  This program is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useLegendSelection = useLegendSelection;
+exports.useLegendHoverHighlight = useLegendHoverHighlight;
+const echarts_1 = require("echarts");
+const react_1 = require("react");
+const legend_utils_1 = require("../utils/legend-utils");
+const threshold_1 = require("../utils/threshold");
+const use_chart_refs_1 = require("./use-chart-refs");
+const LEGEND_HOVER_HIGHLIGHT_DELAY_MS = 80;
+const LEGEND_SELECTION_EVENT_TYPES = [
+    'legendselectchanged',
+    'legendselectall',
+    'legendselected',
+    'legendunselected',
+];
+const getAllSeriesSelected = (series) => Object.fromEntries(series.map((s) => { var _a; return [(_a = s.name) !== null && _a !== void 0 ? _a : '', true]; }));
+const hasSelectionForCurrentSeries = (selection, series) => {
+    const selectedNames = Object.keys(selection);
+    return (selectedNames.length === series.length &&
+        series.every((s) => { var _a; return Object.prototype.hasOwnProperty.call(selection, (_a = s.name) !== null && _a !== void 0 ? _a : ''); }));
+};
+const filterThresholdLineSelection = (selected) => Object.fromEntries(Object.entries(selected).filter(([key]) => { var _a; return !((_a = (0, threshold_1.isThresholdLine)(key)) !== null && _a !== void 0 ? _a : false); }));
+const clearTimeoutRef = (timeoutRef) => {
+    if (timeoutRef.current) {
+        clearTimeout(timeoutRef.current);
+    }
+};
+const createLegendSelectionEventHandler = (chart, eventType, setSelectedSeries) => (params) => {
+    var _a;
+    if (typeof params !== 'object' ||
+        params === null ||
+        !('selected' in params) ||
+        params.selected === null) {
+        return;
+    }
+    if (eventType === 'legendselectchanged') {
+        (0, legend_utils_1.resetAllSeriesHighlight)(chart);
+    }
+    setSelectedSeries(filterThresholdLineSelection((_a = params.selected) !== null && _a !== void 0 ? _a : {}));
+};
+/**
+ * Owns React legend selection and keeps it synchronized with ECharts.
+ *
+ * Current series changes preserve existing selection by name, new series default
+ * to visible, removed series are dropped, and ECharts legend events update the
+ * React state used to render legend items.
+ */
+function useLegendSelection({ series }) {
+    const { chartEchartRef, legendSelectedRef } = (0, use_chart_refs_1.useChartRefsContext)();
+    const initialSelected = (0, react_1.useMemo)(() => getAllSeriesSelected(series), [series]);
+    const [selectedSeries, setSelectedSeries] = (0, react_1.useState)(initialSelected);
+    const renderedSelectedSeries = hasSelectionForCurrentSeries(selectedSeries, series)
+        ? selectedSeries
+        : initialSelected;
+    (0, react_1.useEffect)(() => {
+        var _a, _b, _c;
+        const prev = (_a = legendSelectedRef.current) !== null && _a !== void 0 ? _a : {};
+        const next = {};
+        for (const s of series) {
+            const name = (_b = s.name) !== null && _b !== void 0 ? _b : '';
+            next[name] = (_c = prev[name]) !== null && _c !== void 0 ? _c : true;
+        }
+        setSelectedSeries(next);
+    }, [legendSelectedRef, series]);
+    (0, react_1.useEffect)(() => {
+        legendSelectedRef.current = selectedSeries;
+    }, [legendSelectedRef, selectedSeries]);
+    (0, react_1.useEffect)(() => {
+        if (chartEchartRef.current === null) {
+            return;
+        }
+        const chart = (0, echarts_1.getInstanceByDom)(chartEchartRef.current);
+        if (!chart) {
+            return;
+        }
+        const eventHandlers = LEGEND_SELECTION_EVENT_TYPES.map((eventType) => {
+            const handler = createLegendSelectionEventHandler(chart, eventType, setSelectedSeries);
+            chart.on(eventType, handler);
+            return { eventType, handler };
+        });
+        return () => {
+            eventHandlers.forEach(({ eventType, handler }) => {
+                chart.off(eventType, handler);
+            });
+        };
+    }, [chartEchartRef]);
+    return { renderedSelectedSeries };
+}
+/**
+ * Creates a delayed ECharts highlighter for legend item hover state.
+ *
+ * Legend hover moves often happen as a quick leave/enter pair between adjacent
+ * items. Keeping separate highlight and downplay timers lets the next hover
+ * cancel the previous opposite action, preventing the chart from flickering
+ * between emphasized and reset states. Deselected legend items are ignored so
+ * hidden series do not get emphasized through hover.
+ */
+function useLegendHoverHighlight({ selectedSeries, series, }) {
+    const { chartEchartRef } = (0, use_chart_refs_1.useChartRefsContext)();
+    const highlightTimeOut = (0, react_1.useRef)(null);
+    const downplayTimeOut = (0, react_1.useRef)(null);
+    (0, react_1.useEffect)(() => {
+        return () => {
+            clearTimeoutRef(highlightTimeOut);
+            clearTimeoutRef(downplayTimeOut);
+        };
+    }, []);
+    const toggleHighlight = (0, react_1.useCallback)((seriesToUpdate, shouldHighlight) => {
+        const isDeselected = seriesToUpdate.name === undefined
+            ? false
+            : !selectedSeries[seriesToUpdate.name];
+        if (isDeselected) {
+            return;
+        }
+        const timeoutToClear = shouldHighlight
+            ? downplayTimeOut
+            : highlightTimeOut;
+        const timeoutToSet = shouldHighlight ? highlightTimeOut : downplayTimeOut;
+        if (timeoutToClear.current) {
+            clearTimeout(timeoutToClear.current);
+        }
+        timeoutToSet.current = setTimeout(() => {
+            (0, legend_utils_1.highlightOrDownplaySeries)(chartEchartRef, series, selectedSeries, [seriesToUpdate], shouldHighlight ? 'highlight' : 'downplay');
+        }, LEGEND_HOVER_HIGHLIGHT_DELAY_MS);
+    }, [chartEchartRef, selectedSeries, series]);
+    return { toggleHighlight };
+}
+//# sourceMappingURL=use-legend-interactions.js.map

package/lib/cjs/charts/hooks/use-legend-interactions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-legend-interactions.js","sourceRoot":"","sources":["../../../../src/charts/hooks/use-legend-interactions.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n *\n *  Copyright (c) \"Neo4j\"\n *  Neo4j Sweden AB [http://neo4j.com]\n *\n *  This file is part of Neo4j.\n *\n *  Neo4j is free software: you can redistribute it and/or modify\n *  it under the terms of the GNU General Public License as published by\n *  the Free Software Foundation, either version 3 of the License, or\n *  (at your option) any later version.\n *\n *  This program is distributed in the hope that it will be useful,\n *  but WITHOUT ANY WARRANTY; without even the implied warranty of\n *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\n *  GNU General Public License for more details.\n *\n *  You should have received a copy of the GNU General Public License\n *  along with this program.  If not, see <http://www.gnu.org/licenses/>.\n */\n\nimport { type EChartsType, getInstanceByDom } from 'echarts';\nimport {\n  type Dispatch,\n  type MutableRefObject,\n  type SetStateAction,\n  useCallback,\n  useEffect,\n  useMemo,\n  useRef,\n  useState,\n} from 'react';\n\nimport type { LegendProps } from '../utils/chart-types';\nimport {\n  highlightOrDownplaySeries,\n  resetAllSeriesHighlight,\n} from '../utils/legend-utils';\nimport { isThresholdLine } from '../utils/threshold';\nimport { useChartRefsContext } from './use-chart-refs';\n\nconst LEGEND_HOVER_HIGHLIGHT_DELAY_MS = 80;\nconst LEGEND_SELECTION_EVENT_TYPES = [\n  'legendselectchanged',\n  'legendselectall',\n  'legendselected',\n  'legendunselected',\n] as const;\n\ntype LegendSeries = LegendProps['series'];\ntype LegendSelectionEventType = (typeof LEGEND_SELECTION_EVENT_TYPES)[number];\n\ntype LegendSelectionEventParams = {\n  selected?: Record<string, boolean> | null;\n};\n\ntype UseLegendHoverHighlightParams = {\n  selectedSeries: Record<string, boolean>;\n  series: LegendSeries;\n};\n\ntype UseLegendSelectionParams = {\n  series: LegendProps['series'];\n};\n\nconst getAllSeriesSelected = (series: LegendProps['series']) =>\n  Object.fromEntries(series.map((s) => [s.name ?? '', true]));\n\nconst hasSelectionForCurrentSeries = (\n  selection: Record<string, boolean>,\n  series: LegendProps['series'],\n) => {\n  const selectedNames = Object.keys(selection);\n\n  return (\n    selectedNames.length === series.length &&\n    series.every((s) =>\n      Object.prototype.hasOwnProperty.call(selection, s.name ?? ''),\n    )\n  );\n};\n\nconst filterThresholdLineSelection = (selected: Record<string, boolean>) =>\n  Object.fromEntries(\n    Object.entries(selected).filter(\n      ([key]) => !(isThresholdLine(key) ?? false),\n    ),\n  );\n\nconst clearTimeoutRef = (\n  timeoutRef: MutableRefObject<ReturnType<typeof setTimeout> | null>,\n) => {\n  if (timeoutRef.current) {\n    clearTimeout(timeoutRef.current);\n  }\n};\n\nconst createLegendSelectionEventHandler =\n  (\n    chart: EChartsType,\n    eventType: LegendSelectionEventType,\n    setSelectedSeries: Dispatch<SetStateAction<Record<string, boolean>>>,\n  ) =>\n  (params: unknown) => {\n    if (\n      typeof params !== 'object' ||\n      params === null ||\n      !('selected' in params) ||\n      params.selected === null\n    ) {\n      return;\n    }\n\n    if (eventType === 'legendselectchanged') {\n      resetAllSeriesHighlight(chart);\n    }\n\n    setSelectedSeries(\n      filterThresholdLineSelection(\n        (params as LegendSelectionEventParams).selected ?? {},\n      ),\n    );\n  };\n\n/**\n * Owns React legend selection and keeps it synchronized with ECharts.\n *\n * Current series changes preserve existing selection by name, new series default\n * to visible, removed series are dropped, and ECharts legend events update the\n * React state used to render legend items.\n */\nexport function useLegendSelection({ series }: UseLegendSelectionParams) {\n  const { chartEchartRef, legendSelectedRef } = useChartRefsContext();\n  const initialSelected = useMemo(() => getAllSeriesSelected(series), [series]);\n  const [selectedSeries, setSelectedSeries] =\n    useState<Record<string, boolean>>(initialSelected);\n\n  const renderedSelectedSeries = hasSelectionForCurrentSeries(\n    selectedSeries,\n    series,\n  )\n    ? selectedSeries\n    : initialSelected;\n\n  useEffect(() => {\n    const prev = legendSelectedRef.current ?? {};\n    const next: Record<string, boolean> = {};\n\n    for (const s of series) {\n      const name = s.name ?? '';\n      next[name] = prev[name] ?? true;\n    }\n\n    setSelectedSeries(next);\n  }, [legendSelectedRef, series]);\n\n  useEffect(() => {\n    legendSelectedRef.current = selectedSeries;\n  }, [legendSelectedRef, selectedSeries]);\n\n  useEffect(() => {\n    if (chartEchartRef.current === null) {\n      return;\n    }\n\n    const chart = getInstanceByDom(chartEchartRef.current);\n    if (!chart) {\n      return;\n    }\n\n    const eventHandlers = LEGEND_SELECTION_EVENT_TYPES.map((eventType) => {\n      const handler = createLegendSelectionEventHandler(\n        chart,\n        eventType,\n        setSelectedSeries,\n      );\n      chart.on(eventType, handler);\n\n      return { eventType, handler };\n    });\n\n    return () => {\n      eventHandlers.forEach(({ eventType, handler }) => {\n        chart.off(eventType, handler);\n      });\n    };\n  }, [chartEchartRef]);\n\n  return { renderedSelectedSeries };\n}\n\n/**\n * Creates a delayed ECharts highlighter for legend item hover state.\n *\n * Legend hover moves often happen as a quick leave/enter pair between adjacent\n * items. Keeping separate highlight and downplay timers lets the next hover\n * cancel the previous opposite action, preventing the chart from flickering\n * between emphasized and reset states. Deselected legend items are ignored so\n * hidden series do not get emphasized through hover.\n */\nexport function useLegendHoverHighlight({\n  selectedSeries,\n  series,\n}: UseLegendHoverHighlightParams) {\n  const { chartEchartRef } = useChartRefsContext();\n  const highlightTimeOut = useRef<ReturnType<typeof setTimeout> | null>(null);\n  const downplayTimeOut = useRef<ReturnType<typeof setTimeout> | null>(null);\n\n  useEffect(() => {\n    return () => {\n      clearTimeoutRef(highlightTimeOut);\n      clearTimeoutRef(downplayTimeOut);\n    };\n  }, []);\n\n  const toggleHighlight = useCallback(\n    (\n      seriesToUpdate: { name: string; color: string },\n      shouldHighlight: boolean,\n    ) => {\n      const isDeselected =\n        seriesToUpdate.name === undefined\n          ? false\n          : !selectedSeries[seriesToUpdate.name];\n\n      if (isDeselected) {\n        return;\n      }\n\n      const timeoutToClear = shouldHighlight\n        ? downplayTimeOut\n        : highlightTimeOut;\n      const timeoutToSet = shouldHighlight ? highlightTimeOut : downplayTimeOut;\n\n      if (timeoutToClear.current) {\n        clearTimeout(timeoutToClear.current);\n      }\n\n      timeoutToSet.current = setTimeout(() => {\n        highlightOrDownplaySeries(\n          chartEchartRef,\n          series,\n          selectedSeries,\n          [seriesToUpdate],\n          shouldHighlight ? 'highlight' : 'downplay',\n        );\n      }, LEGEND_HOVER_HIGHLIGHT_DELAY_MS);\n    },\n    [chartEchartRef, selectedSeries, series],\n  );\n\n  return { toggleHighlight };\n}\n"]}

package/lib/cjs/charts/hooks/use-legend-series.js

@@ -0,0 +1,181 @@
+"use strict";
+/**
+ *
+ *  Copyright (c) "Neo4j"
+ *  Neo4j Sweden AB [http://neo4j.com]
+ *
+ *  This file is part of Neo4j.
+ *
+ *  Neo4j is free software: you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License as published by
+ *  the Free Software Foundation, either version 3 of the License, or
+ *  (at your option) any later version.
+ *
+ *  This program is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useLegendSeries = useLegendSeries;
+const echarts_1 = require("echarts");
+const react_1 = require("react");
+const threshold_1 = require("../utils/threshold");
+const use_chart_refs_1 = require("./use-chart-refs");
+const isThresholdLineSeries = (series) => series.type === 'line' &&
+    typeof series.name === 'string' &&
+    (0, threshold_1.isThresholdLine)(series.name);
+const getDatasetForSeries = (optionDataset, series) => {
+    const datasetList = Array.isArray(optionDataset)
+        ? optionDataset
+        : [optionDataset];
+    if (series.datasetId && Array.isArray(optionDataset)) {
+        return datasetList.find((dataset) => (dataset === null || dataset === void 0 ? void 0 : dataset.id) === series.datasetId);
+    }
+    if (series.datasetIndex !== undefined) {
+        return datasetList[series.datasetIndex];
+    }
+    return datasetList[0];
+};
+const isRecord = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+const getCachedLegendColor = ({ chart, isAllVisible, legendColorCacheRef, name, seriesIndex, dataIndexInside, }) => {
+    var _a;
+    const freshColor = chart === null || chart === void 0 ? void 0 : chart.getVisual({ dataIndexInside, seriesIndex }, 'color');
+    if (isAllVisible && typeof freshColor === 'string') {
+        legendColorCacheRef.current.set(name, freshColor);
+    }
+    return ((_a = legendColorCacheRef.current.get(name)) !== null && _a !== void 0 ? _a : (typeof freshColor === 'string' ? freshColor : '#000000'));
+};
+const createPieLegendSeriesItem = ({ chart, dataIndexInside, isAllVisible, legendColorCacheRef, name, seriesIndex, }) => ({
+    color: getCachedLegendColor({
+        chart,
+        dataIndexInside,
+        isAllVisible,
+        legendColorCacheRef,
+        name,
+        seriesIndex,
+    }),
+    name,
+});
+const getPieLegendSeriesFromArrayRows = ({ chart, dataset, encodedItemName, isAllVisible, legendColorCacheRef, seriesIndex, }) => {
+    const source = dataset === null || dataset === void 0 ? void 0 : dataset.source;
+    if (!Array.isArray(source) || !Array.isArray(source[0])) {
+        return [];
+    }
+    const itemNameIndex = source[0].findIndex((item) => item === encodedItemName);
+    if (itemNameIndex === -1) {
+        return [];
+    }
+    return source.slice(1).flatMap((row, rowIndex) => {
+        if (!Array.isArray(row)) {
+            return [];
+        }
+        return createPieLegendSeriesItem({
+            chart,
+            dataIndexInside: rowIndex,
+            isAllVisible,
+            legendColorCacheRef,
+            name: String(row[itemNameIndex]),
+            seriesIndex,
+        });
+    });
+};
+const getPieLegendSeriesFromObjectRows = ({ chart, dataset, encodedItemName, isAllVisible, legendColorCacheRef, seriesIndex, }) => {
+    const source = dataset === null || dataset === void 0 ? void 0 : dataset.source;
+    if (!Array.isArray(source) || typeof encodedItemName !== 'string') {
+        return [];
+    }
+    return source.flatMap((row, rowIndex) => {
+        if (!isRecord(row) || !(encodedItemName in row)) {
+            return [];
+        }
+        return createPieLegendSeriesItem({
+            chart,
+            dataIndexInside: rowIndex,
+            isAllVisible,
+            legendColorCacheRef,
+            name: String(row[encodedItemName]),
+            seriesIndex,
+        });
+    });
+};
+const getPieLegendSeries = (params) => {
+    var _a;
+    const source = (_a = params.dataset) === null || _a === void 0 ? void 0 : _a.source;
+    if (!Array.isArray(source) || source.length === 0) {
+        return [];
+    }
+    return Array.isArray(source[0])
+        ? getPieLegendSeriesFromArrayRows(params)
+        : getPieLegendSeriesFromObjectRows(params);
+};
+/**
+ * Derives Needle legend rows from ECharts' normalized option and visual state.
+ *
+ * Standard series map one-to-one with legend items. Pie charts instead create a
+ * legend item for each data row, so the hook reads the encoded item-name column
+ * from the dataset and asks ECharts for each slice color. Fresh colors are
+ * cached while all slices are visible because ECharts reports dimmed colors for
+ * deselected slices.
+ *
+ * The hook waits until the first chart resize has completed so color lookups run
+ * against an initialized ECharts instance.
+ */
+function useLegendSeries({ chartOption, isWaitingForFirstResize, }) {
+    const { chartEchartRef, legendColorCacheRef, legendSelectedRef } = (0, use_chart_refs_1.useChartRefsContext)();
+    return (0, react_1.useMemo)(() => {
+        var _a;
+        if (chartEchartRef.current === null || isWaitingForFirstResize) {
+            return;
+        }
+        const chart = (0, echarts_1.getInstanceByDom)(chartEchartRef.current);
+        const optionSeries = (_a = chartOption === null || chartOption === void 0 ? void 0 : chartOption.series) !== null && _a !== void 0 ? _a : [];
+        const optionDataset = chartOption === null || chartOption === void 0 ? void 0 : chartOption.dataset;
+        const isAllLegendSeriesVisible = Object.values(legendSelectedRef.current).every((v) => v);
+        const legendSeries = [];
+        if (Array.isArray(optionSeries)) {
+            optionSeries.forEach((currentSeries, index) => {
+                var _a;
+                if (currentSeries === null) {
+                    return;
+                }
+                else if (isThresholdLineSeries(currentSeries)) {
+                    return;
+                }
+                else if (currentSeries.type === 'pie') {
+                    legendSeries.push(...getPieLegendSeries({
+                        chart,
+                        dataset: getDatasetForSeries(optionDataset, currentSeries),
+                        encodedItemName: (_a = currentSeries.encode) === null || _a === void 0 ? void 0 : _a.itemName,
+                        isAllVisible: isAllLegendSeriesVisible,
+                        legendColorCacheRef,
+                        seriesIndex: index,
+                    }));
+                    return;
+                }
+                else {
+                    const name = currentSeries.name;
+                    if (name === undefined) {
+                        return;
+                    }
+                    const color = chart === null || chart === void 0 ? void 0 : chart.getVisual({ seriesIndex: index }, 'color');
+                    legendSeries.push({
+                        color: typeof color === 'string' ? color : '#000000',
+                        name: String(name),
+                    });
+                }
+            });
+        }
+        return legendSeries;
+    }, [
+        chartEchartRef,
+        chartOption,
+        isWaitingForFirstResize,
+        legendColorCacheRef,
+        legendSelectedRef,
+    ]);
+}
+//# sourceMappingURL=use-legend-series.js.map

package/lib/cjs/charts/hooks/use-legend-series.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-legend-series.js","sourceRoot":"","sources":["../../../../src/charts/hooks/use-legend-series.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n *\n *  Copyright (c) \"Neo4j\"\n *  Neo4j Sweden AB [http://neo4j.com]\n *\n *  This file is part of Neo4j.\n *\n *  Neo4j is free software: you can redistribute it and/or modify\n *  it under the terms of the GNU General Public License as published by\n *  the Free Software Foundation, either version 3 of the License, or\n *  (at your option) any later version.\n *\n *  This program is distributed in the hope that it will be useful,\n *  but WITHOUT ANY WARRANTY; without even the implied warranty of\n *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\n *  GNU General Public License for more details.\n *\n *  You should have received a copy of the GNU General Public License\n *  along with this program.  If not, see <http://www.gnu.org/licenses/>.\n */\n\nimport type {\n  DatasetComponentOption,\n  EChartsOption,\n  EChartsType,\n} from 'echarts';\nimport { getInstanceByDom } from 'echarts';\nimport { useMemo } from 'react';\n\nimport type {\n  LegendProps,\n  NeedleSeries,\n  SeriesOption,\n} from '../utils/chart-types';\nimport { isThresholdLine } from '../utils/threshold';\nimport { type ChartRefs, useChartRefsContext } from './use-chart-refs';\n\ntype UseLegendSeriesParams = {\n  chartOption: EChartsOption | undefined;\n  isWaitingForFirstResize: boolean;\n};\n\ntype LegendSeries = LegendProps['series'];\ntype NeedleSeriesItem = NeedleSeries[number];\ntype SeriesWithDataset = SeriesOption & {\n  datasetId?: string;\n  datasetIndex?: number;\n};\n\ntype PieLegendSeriesParams = {\n  chart: EChartsType | undefined;\n  dataset: DatasetComponentOption | undefined;\n  encodedItemName: unknown;\n  isAllVisible: boolean;\n  legendColorCacheRef: ChartRefs['legendColorCacheRef'];\n  seriesIndex: number;\n};\n\ntype GetCachedLegendColorParams = {\n  chart: EChartsType | undefined;\n  dataIndexInside: number;\n  isAllVisible: boolean;\n  legendColorCacheRef: ChartRefs['legendColorCacheRef'];\n  name: string;\n  seriesIndex: number;\n};\n\nconst isThresholdLineSeries = (series: NeedleSeriesItem) =>\n  series.type === 'line' &&\n  typeof series.name === 'string' &&\n  isThresholdLine(series.name);\n\nconst getDatasetForSeries = (\n  optionDataset: EChartsOption['dataset'],\n  series: SeriesWithDataset,\n) => {\n  const datasetList = Array.isArray(optionDataset)\n    ? optionDataset\n    : [optionDataset];\n\n  if (series.datasetId && Array.isArray(optionDataset)) {\n    return datasetList.find((dataset) => dataset?.id === series.datasetId);\n  }\n\n  if (series.datasetIndex !== undefined) {\n    return datasetList[series.datasetIndex];\n  }\n\n  return datasetList[0];\n};\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  typeof value === 'object' && value !== null && !Array.isArray(value);\n\nconst getCachedLegendColor = ({\n  chart,\n  isAllVisible,\n  legendColorCacheRef,\n  name,\n  seriesIndex,\n  dataIndexInside,\n}: GetCachedLegendColorParams) => {\n  const freshColor = chart?.getVisual(\n    { dataIndexInside, seriesIndex },\n    'color',\n  );\n\n  if (isAllVisible && typeof freshColor === 'string') {\n    legendColorCacheRef.current.set(name, freshColor);\n  }\n\n  return (\n    legendColorCacheRef.current.get(name) ??\n    (typeof freshColor === 'string' ? freshColor : '#000000')\n  );\n};\n\nconst createPieLegendSeriesItem = ({\n  chart,\n  dataIndexInside,\n  isAllVisible,\n  legendColorCacheRef,\n  name,\n  seriesIndex,\n}: GetCachedLegendColorParams) => ({\n  color: getCachedLegendColor({\n    chart,\n    dataIndexInside,\n    isAllVisible,\n    legendColorCacheRef,\n    name,\n    seriesIndex,\n  }),\n  name,\n});\n\nconst getPieLegendSeriesFromArrayRows = ({\n  chart,\n  dataset,\n  encodedItemName,\n  isAllVisible,\n  legendColorCacheRef,\n  seriesIndex,\n}: PieLegendSeriesParams): LegendSeries => {\n  const source = dataset?.source;\n  if (!Array.isArray(source) || !Array.isArray(source[0])) {\n    return [];\n  }\n\n  const itemNameIndex = source[0].findIndex((item) => item === encodedItemName);\n  if (itemNameIndex === -1) {\n    return [];\n  }\n\n  return source.slice(1).flatMap((row, rowIndex) => {\n    if (!Array.isArray(row)) {\n      return [];\n    }\n\n    return createPieLegendSeriesItem({\n      chart,\n      dataIndexInside: rowIndex,\n      isAllVisible,\n      legendColorCacheRef,\n      name: String(row[itemNameIndex]),\n      seriesIndex,\n    });\n  });\n};\n\nconst getPieLegendSeriesFromObjectRows = ({\n  chart,\n  dataset,\n  encodedItemName,\n  isAllVisible,\n  legendColorCacheRef,\n  seriesIndex,\n}: PieLegendSeriesParams): LegendSeries => {\n  const source = dataset?.source;\n  if (!Array.isArray(source) || typeof encodedItemName !== 'string') {\n    return [];\n  }\n\n  return source.flatMap((row, rowIndex) => {\n    if (!isRecord(row) || !(encodedItemName in row)) {\n      return [];\n    }\n\n    return createPieLegendSeriesItem({\n      chart,\n      dataIndexInside: rowIndex,\n      isAllVisible,\n      legendColorCacheRef,\n      name: String(row[encodedItemName]),\n      seriesIndex,\n    });\n  });\n};\n\nconst getPieLegendSeries = (params: PieLegendSeriesParams): LegendSeries => {\n  const source = params.dataset?.source;\n  if (!Array.isArray(source) || source.length === 0) {\n    return [];\n  }\n\n  return Array.isArray(source[0])\n    ? getPieLegendSeriesFromArrayRows(params)\n    : getPieLegendSeriesFromObjectRows(params);\n};\n\n/**\n * Derives Needle legend rows from ECharts' normalized option and visual state.\n *\n * Standard series map one-to-one with legend items. Pie charts instead create a\n * legend item for each data row, so the hook reads the encoded item-name column\n * from the dataset and asks ECharts for each slice color. Fresh colors are\n * cached while all slices are visible because ECharts reports dimmed colors for\n * deselected slices.\n *\n * The hook waits until the first chart resize has completed so color lookups run\n * against an initialized ECharts instance.\n */\nexport function useLegendSeries({\n  chartOption,\n  isWaitingForFirstResize,\n}: UseLegendSeriesParams): LegendSeries | undefined {\n  const { chartEchartRef, legendColorCacheRef, legendSelectedRef } =\n    useChartRefsContext();\n\n  return useMemo(() => {\n    if (chartEchartRef.current === null || isWaitingForFirstResize) {\n      return;\n    }\n\n    const chart = getInstanceByDom(chartEchartRef.current);\n    const optionSeries = (chartOption?.series as NeedleSeries) ?? [];\n    const optionDataset = chartOption?.dataset;\n    const isAllLegendSeriesVisible = Object.values(\n      legendSelectedRef.current,\n    ).every((v) => v);\n\n    const legendSeries: LegendSeries = [];\n    if (Array.isArray(optionSeries)) {\n      optionSeries.forEach((currentSeries, index) => {\n        if (currentSeries === null) {\n          return;\n        } else if (isThresholdLineSeries(currentSeries)) {\n          return;\n        } else if (currentSeries.type === 'pie') {\n          legendSeries.push(\n            ...getPieLegendSeries({\n              chart,\n              dataset: getDatasetForSeries(\n                optionDataset,\n                currentSeries as SeriesWithDataset,\n              ),\n              encodedItemName: currentSeries.encode?.itemName,\n              isAllVisible: isAllLegendSeriesVisible,\n              legendColorCacheRef,\n              seriesIndex: index,\n            }),\n          );\n          return;\n        } else {\n          const name = currentSeries.name;\n\n          if (name === undefined) {\n            return;\n          }\n\n          const color = chart?.getVisual({ seriesIndex: index }, 'color');\n          legendSeries.push({\n            color: typeof color === 'string' ? color : '#000000',\n            name: String(name),\n          });\n        }\n      });\n    }\n    return legendSeries;\n  }, [\n    chartEchartRef,\n    chartOption,\n    isWaitingForFirstResize,\n    legendColorCacheRef,\n    legendSelectedRef,\n  ]);\n}\n"]}