@hsu-react/ui 2.4.0 → 2.4.2

package/es/components/Chart/Bar/index.js

@@ -8,11 +8,14 @@ function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e
 function _objectWithoutProperties(source, excluded) { if (source == null) return {}; var target = _objectWithoutPropertiesLoose(source, excluded); var key, i; if (Object.getOwnPropertySymbols) { var sourceSymbolKeys = Object.getOwnPropertySymbols(source); for (i = 0; i < sourceSymbolKeys.length; i++) { key = sourceSymbolKeys[i]; if (excluded.indexOf(key) >= 0) continue; if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue; target[key] = source[key]; } } return target; }
 function _objectWithoutPropertiesLoose(source, excluded) { if (source == null) return {}; var target = {}; var sourceKeys = Object.keys(source); var key, i; for (i = 0; i < sourceKeys.length; i++) { key = sourceKeys[i]; if (excluded.indexOf(key) >= 0) continue; target[key] = source[key]; } return target; }
 import * as echarts from "echarts";
+import useContainerReady from "../_hooks/useContainerReady";
 import React, { useCallback, useEffect, useMemo, useRef } from "react";
 import styles from "../index.module.scss";
 import { autoScrollLegend } from "../_utils/autoScrollLegend";
 import { autoScrollByItem } from "../_utils/autoSmooth";
 import { buildCartesianSeriesOptions, createDefaultCategoryXAxis, createDefaultValueYAxis, getSliderShow, percentWindowToIndexWindow, resolveScrollConfig } from "../_utils/cartesian";
+import { resolveChartChrome } from "../_utils/chartTheme";
+import useIsDark from "../../../hooks/useIsDark";
 import { jsx as _jsx } from "react/jsx-runtime";
 var ChartBar = function ChartBar(props) {
   var className = props.className,
@@ -44,18 +47,26 @@ var ChartBar = function ChartBar(props) {
     coreOption = _objectWithoutProperties(props, _excluded);
   var chartRef = useRef(null);
   var chartInstanceRef = useRef(null);
+  // Defers `echarts.init` until the container has a box — see the hook for why
+  var containerReady = useContainerReady(chartRef);
   var resizeObserverRef = useRef(null);
   var prevXAxisKeyRef = useRef(null);
   var legendScrollRef = useRef(null);
   var normalizedScroll = useMemo(function () {
     return resolveScrollConfig(scrollConfig);
   }, [scrollConfig]);
+  // echarts options are plain JS and cannot read the `--vita-*` variables, so the axis and
+  // legend colours have to be resolved against the active appearance here
+  var isDark = useIsDark();
+  var chrome = useMemo(function () {
+    return resolveChartChrome(isDark);
+  }, [isDark]);
 
   // Cache the chart option with useMemo
   var chartOption = useMemo(function () {
     var _xAxisData$length, _ref, _ref2;
-    var def_xAxis = createDefaultCategoryXAxis(xAxisData);
-    var def_yAxis = createDefaultValueYAxis("bar");
+    var def_xAxis = createDefaultCategoryXAxis(xAxisData, chrome);
+    var def_yAxis = createDefaultValueYAxis("bar", chrome);
 
     // Process xAxis config
     var processedXAxis = Array.isArray(xAxis) ? xAxis === null || xAxis === void 0 ? void 0 : xAxis.map(function (item) {
@@ -150,8 +161,7 @@ var ChartBar = function ChartBar(props) {
           data: legendData,
           icon: "circle",
           textStyle: {
-            color: "#373D48",
-            fontSize: 16
+            color: chrome.text
           },
           itemWidth: 8,
           itemHeight: 8
@@ -175,18 +185,22 @@ var ChartBar = function ChartBar(props) {
       series: buildCartesianSeriesOptions("bar", seriesData, series)
     }, coreOption);
     return option;
-  }, [xAxisData, xAxis, yAxis, grid, chartTitle, dataZoom, normalizedScroll, insideDataZoom, sliderDataZoom, title, tooltip, legendData, legend, seriesData, series, enableLegendAutoScroll, coreOption]);
+  }, [xAxisData, xAxis, yAxis, grid, chartTitle, dataZoom, normalizedScroll, insideDataZoom, sliderDataZoom, title, tooltip, legendData, legend, seriesData, series, enableLegendAutoScroll, coreOption, chrome]);
 
   // Callback for handling chart resize
   var handleResize = useCallback(function () {
     var _chartInstanceRef$cur;
+    // A keep-alive tab losing focus fires the observer with a 0×0 box; resizing to that throws
+    // the laid-out canvas away and it has to be rebuilt when the tab comes back
+    var el = chartRef.current;
+    if (!el || el.clientWidth === 0 || el.clientHeight === 0) return;
     (_chartInstanceRef$cur = chartInstanceRef.current) === null || _chartInstanceRef$cur === void 0 || _chartInstanceRef$cur.resize();
   }, []);
 
   // Initialize the chart
   useEffect(function () {
     var _xAxisData$join, _chart$getOption, _chart$getOption2, _opt$legend$, _opt$legend, _ref3;
-    if (!chartRef.current) return;
+    if (!chartRef.current || !containerReady) return;
 
     // Initialize or reuse the existing instance
     var chart = chartInstanceRef.current;
@@ -327,7 +341,7 @@ var ChartBar = function ChartBar(props) {
     };
   }, [chartOption, handleResize, onClick, onLegendSelectChanged, onDataZoomWindowChanged, xAxisData, enableLegendAutoScroll, legendVisibleCount, legendScrollInterval,
   // 图例是否接管滚轮由它推导，漏了会拿到过期的滚动配置
-  normalizedScroll]);
+  normalizedScroll, containerReady]);
 
   // Handle auto play
   useEffect(function () {

package/es/components/Chart/Common/index.js

@@ -8,6 +8,7 @@ function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e
 function _objectWithoutProperties(source, excluded) { if (source == null) return {}; var target = _objectWithoutPropertiesLoose(source, excluded); var key, i; if (Object.getOwnPropertySymbols) { var sourceSymbolKeys = Object.getOwnPropertySymbols(source); for (i = 0; i < sourceSymbolKeys.length; i++) { key = sourceSymbolKeys[i]; if (excluded.indexOf(key) >= 0) continue; if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue; target[key] = source[key]; } } return target; }
 function _objectWithoutPropertiesLoose(source, excluded) { if (source == null) return {}; var target = {}; var sourceKeys = Object.keys(source); var key, i; for (i = 0; i < sourceKeys.length; i++) { key = sourceKeys[i]; if (excluded.indexOf(key) >= 0) continue; target[key] = source[key]; } return target; }
 import React, { useCallback, useEffect, useMemo, useRef } from "react";
+import useContainerReady from "../_hooks/useContainerReady";
 import styles from "../index.module.scss";
 import * as echarts from "echarts";
 import { jsx as _jsx } from "react/jsx-runtime";
@@ -18,6 +19,8 @@ var Common = function Common(props) {
     coreOption = _objectWithoutProperties(props, _excluded);
   var chartRef = useRef(null);
   var chartInstanceRef = useRef(null);
+  // Defers `echarts.init` until the container has a box — see the hook for why
+  var containerReady = useContainerReady(chartRef);
   var resizeObserverRef = useRef(null);
 
   // Cache the chart configuration with useMemo
@@ -29,12 +32,16 @@ var Common = function Common(props) {
   // Callback that handles chart resize
   var handleResize = useCallback(function () {
     var _chartInstanceRef$cur;
+    // A keep-alive tab losing focus fires the observer with a 0×0 box; resizing to that throws
+    // the laid-out canvas away and it has to be rebuilt when the tab comes back
+    var el = chartRef.current;
+    if (!el || el.clientWidth === 0 || el.clientHeight === 0) return;
     (_chartInstanceRef$cur = chartInstanceRef.current) === null || _chartInstanceRef$cur === void 0 || _chartInstanceRef$cur.resize();
   }, []);
 
   // Initialize the chart
   useEffect(function () {
-    if (!chartRef.current) return;
+    if (!chartRef.current || !containerReady) return;
 
     // Initialize or reuse an existing instance
     var chart = chartInstanceRef.current;
@@ -62,7 +69,7 @@ var Common = function Common(props) {
     return function () {
       window.removeEventListener("resize", handleResize);
     };
-  }, [chartOption, handleResize, onChart]);
+  }, [chartOption, handleResize, onChart, containerReady]);
 
   // Clean up resources on component unmount
   useEffect(function () {

package/es/components/Chart/Gauge/index.js

@@ -8,6 +8,7 @@ function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e
 function _objectWithoutProperties(source, excluded) { if (source == null) return {}; var target = _objectWithoutPropertiesLoose(source, excluded); var key, i; if (Object.getOwnPropertySymbols) { var sourceSymbolKeys = Object.getOwnPropertySymbols(source); for (i = 0; i < sourceSymbolKeys.length; i++) { key = sourceSymbolKeys[i]; if (excluded.indexOf(key) >= 0) continue; if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue; target[key] = source[key]; } } return target; }
 function _objectWithoutPropertiesLoose(source, excluded) { if (source == null) return {}; var target = {}; var sourceKeys = Object.keys(source); var key, i; for (i = 0; i < sourceKeys.length; i++) { key = sourceKeys[i]; if (excluded.indexOf(key) >= 0) continue; target[key] = source[key]; } return target; }
 import * as echarts from "echarts";
+import useContainerReady from "../_hooks/useContainerReady";
 import React, { useCallback, useEffect, useMemo, useRef } from "react";
 import styles from "../index.module.scss";
 import { jsx as _jsx } from "react/jsx-runtime";
@@ -31,6 +32,8 @@ var Gauge = function Gauge(props) {
     coreSeries = _objectWithoutProperties(_ref, _excluded);
   var chartRef = useRef(null);
   var chartInstanceRef = useRef(null);
+  // Defers `echarts.init` until the container has a box — see the hook for why
+  var containerReady = useContainerReady(chartRef);
   var resizeObserverRef = useRef(null);
 
   // Cache the chart option with useMemo
@@ -83,12 +86,16 @@ var Gauge = function Gauge(props) {
   // Callback for handling chart resize
   var handleResize = useCallback(function () {
     var _chartInstanceRef$cur;
+    // A keep-alive tab losing focus fires the observer with a 0×0 box; resizing to that throws
+    // the laid-out canvas away and it has to be rebuilt when the tab comes back
+    var el = chartRef.current;
+    if (!el || el.clientWidth === 0 || el.clientHeight === 0) return;
     (_chartInstanceRef$cur = chartInstanceRef.current) === null || _chartInstanceRef$cur === void 0 || _chartInstanceRef$cur.resize();
   }, []);
 
   // Initialize the chart
   useEffect(function () {
-    if (!chartRef.current) return;
+    if (!chartRef.current || !containerReady) return;
 
     // Initialize or reuse the existing instance
     var chart = chartInstanceRef.current;
@@ -113,7 +120,7 @@ var Gauge = function Gauge(props) {
     return function () {
       window.removeEventListener("resize", handleResize);
     };
-  }, [chartOption, handleResize]);
+  }, [chartOption, handleResize, containerReady]);
 
   // Clean up resources when the component unmounts
   useEffect(function () {

package/es/components/Chart/Heatmap/index.js

@@ -14,9 +14,12 @@ function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len
 function _objectWithoutProperties(source, excluded) { if (source == null) return {}; var target = _objectWithoutPropertiesLoose(source, excluded); var key, i; if (Object.getOwnPropertySymbols) { var sourceSymbolKeys = Object.getOwnPropertySymbols(source); for (i = 0; i < sourceSymbolKeys.length; i++) { key = sourceSymbolKeys[i]; if (excluded.indexOf(key) >= 0) continue; if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue; target[key] = source[key]; } } return target; }
 function _objectWithoutPropertiesLoose(source, excluded) { if (source == null) return {}; var target = {}; var sourceKeys = Object.keys(source); var key, i; for (i = 0; i < sourceKeys.length; i++) { key = sourceKeys[i]; if (excluded.indexOf(key) >= 0) continue; target[key] = source[key]; } return target; }
 import React, { useCallback, useEffect, useMemo, useRef } from "react";
+import useContainerReady from "../_hooks/useContainerReady";
 import styles from "../index.module.scss";
 import * as echarts from "echarts";
 import { createDefaultHeatmapXAxis, createDefaultHeatmapYAxis } from "../_utils/heatmap";
+import { resolveChartChrome } from "../_utils/chartTheme";
+import useIsDark from "../../../hooks/useIsDark";
 import { jsx as _jsx } from "react/jsx-runtime";
 var Heatmap = function Heatmap(props) {
   var className = props.className,
@@ -40,7 +43,15 @@ var Heatmap = function Heatmap(props) {
     coreOption = _objectWithoutProperties(props, _excluded);
   var chartRef = useRef(null);
   var chartInstanceRef = useRef(null);
+  // Defers `echarts.init` until the container has a box — see the hook for why
+  var containerReady = useContainerReady(chartRef);
   var resizeObserverRef = useRef(null);
+  // echarts options are plain JS and cannot read the `--vita-*` variables, so the axis and legend
+  // colours have to be resolved against the active appearance here
+  var isDark = useIsDark();
+  var chrome = useMemo(function () {
+    return resolveChartChrome(isDark);
+  }, [isDark]);
 
   // Process the data and generate the chart option
   var chartOption = useMemo(function () {
@@ -85,7 +96,7 @@ var Heatmap = function Heatmap(props) {
       left: "right",
       top: "center",
       textStyle: {
-        color: "#373D48"
+        color: chrome.text
       },
       inRange: {
         color: inRangeColor
@@ -93,7 +104,7 @@ var Heatmap = function Heatmap(props) {
     };
 
     // Process xAxis config
-    var def_xAxis = createDefaultHeatmapXAxis(xAxisData);
+    var def_xAxis = createDefaultHeatmapXAxis(xAxisData, chrome);
     var processedXAxis = Array.isArray(xAxis) ? xAxis === null || xAxis === void 0 ? void 0 : xAxis.map(function (item) {
       return _objectSpread(_objectSpread({}, def_xAxis), {}, {
         data: (item === null || item === void 0 ? void 0 : item.type) === "value" ? undefined : xAxisData
@@ -103,7 +114,7 @@ var Heatmap = function Heatmap(props) {
     }, xAxis);
 
     // Process yAxis config
-    var def_yAxis = createDefaultHeatmapYAxis(yAxisData);
+    var def_yAxis = createDefaultHeatmapYAxis(yAxisData, chrome);
     var processedYAxis = Array.isArray(yAxis) ? yAxis === null || yAxis === void 0 ? void 0 : yAxis.map(function (item) {
       return _objectSpread(_objectSpread({}, def_yAxis), {}, {
         data: (item === null || item === void 0 ? void 0 : item.type) === "value" ? undefined : yAxisData
@@ -170,17 +181,21 @@ var Heatmap = function Heatmap(props) {
       }, series)]
     }, coreOption);
     return option;
-  }, [data, inRangeColor, xAxisData, xAxis, yAxisData, yAxis, propVisualMap, grid, chartTitle, title, tooltip, series, coreOption, zeroColor]);
+  }, [data, inRangeColor, xAxisData, xAxis, yAxisData, yAxis, propVisualMap, grid, chartTitle, title, tooltip, series, coreOption, zeroColor, chrome]);
 
   // Callback for handling chart resize
   var handleResize = useCallback(function () {
     var _chartInstanceRef$cur;
+    // A keep-alive tab losing focus fires the observer with a 0×0 box; resizing to that throws
+    // the laid-out canvas away and it has to be rebuilt when the tab comes back
+    var el = chartRef.current;
+    if (!el || el.clientWidth === 0 || el.clientHeight === 0) return;
     (_chartInstanceRef$cur = chartInstanceRef.current) === null || _chartInstanceRef$cur === void 0 || _chartInstanceRef$cur.resize();
   }, []);
 
   // Initialize the chart
   useEffect(function () {
-    if (!chartRef.current) return;
+    if (!chartRef.current || !containerReady) return;
 
     // Initialize or reuse the existing instance
     var chart = chartInstanceRef.current;
@@ -217,7 +232,7 @@ var Heatmap = function Heatmap(props) {
         (_chartInstanceRef$cur3 = chartInstanceRef.current) === null || _chartInstanceRef$cur3 === void 0 || _chartInstanceRef$cur3.off("click", onClick);
       }
     };
-  }, [chartOption, handleResize, onChart, onClick]);
+  }, [chartOption, handleResize, onChart, onClick, containerReady]);
 
   // Clean up resources when the component unmounts
   useEffect(function () {

package/es/components/Chart/Line/index.js

@@ -8,11 +8,14 @@ function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e
 function _objectWithoutProperties(source, excluded) { if (source == null) return {}; var target = _objectWithoutPropertiesLoose(source, excluded); var key, i; if (Object.getOwnPropertySymbols) { var sourceSymbolKeys = Object.getOwnPropertySymbols(source); for (i = 0; i < sourceSymbolKeys.length; i++) { key = sourceSymbolKeys[i]; if (excluded.indexOf(key) >= 0) continue; if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue; target[key] = source[key]; } } return target; }
 function _objectWithoutPropertiesLoose(source, excluded) { if (source == null) return {}; var target = {}; var sourceKeys = Object.keys(source); var key, i; for (i = 0; i < sourceKeys.length; i++) { key = sourceKeys[i]; if (excluded.indexOf(key) >= 0) continue; target[key] = source[key]; } return target; }
 import * as echarts from "echarts";
+import useContainerReady from "../_hooks/useContainerReady";
 import React, { useCallback, useEffect, useMemo, useRef } from "react";
 import styles from "../index.module.scss";
 import { autoScrollLegend } from "../_utils/autoScrollLegend";
 import { autoScrollByItem } from "../_utils/autoSmooth";
 import { buildCartesianSeriesOptions, createDefaultCategoryXAxis, createDefaultValueYAxis, getSliderShow, percentWindowToIndexWindow, resolveScrollConfig } from "../_utils/cartesian";
+import { resolveChartChrome } from "../_utils/chartTheme";
+import useIsDark from "../../../hooks/useIsDark";
 import { jsx as _jsx } from "react/jsx-runtime";
 var ChartLine = function ChartLine(props) {
   var className = props.className,
@@ -44,18 +47,26 @@ var ChartLine = function ChartLine(props) {
     coreOption = _objectWithoutProperties(props, _excluded);
   var chartRef = useRef(null);
   var chartInstanceRef = useRef(null);
+  // Defers `echarts.init` until the container has a box — see the hook for why
+  var containerReady = useContainerReady(chartRef);
   var resizeObserverRef = useRef(null);
   var prevXAxisKeyRef = useRef(null);
   var legendScrollRef = useRef(null);
   var normalizedScroll = useMemo(function () {
     return resolveScrollConfig(scrollConfig);
   }, [scrollConfig]);
+  // echarts options are plain JS and cannot read the `--vita-*` variables, so the axis and
+  // legend colours have to be resolved against the active appearance here
+  var isDark = useIsDark();
+  var chrome = useMemo(function () {
+    return resolveChartChrome(isDark);
+  }, [isDark]);
 
   // Cache the chart option with useMemo
   var chartOption = useMemo(function () {
     var _xAxisData$length, _ref, _ref2;
-    var def_xAxis = createDefaultCategoryXAxis(xAxisData);
-    var def_yAxis = createDefaultValueYAxis("line");
+    var def_xAxis = createDefaultCategoryXAxis(xAxisData, chrome);
+    var def_yAxis = createDefaultValueYAxis("line", chrome);
 
     // Process xAxis config
     var processedXAxis = Array.isArray(xAxis) ? xAxis === null || xAxis === void 0 ? void 0 : xAxis.map(function (item) {
@@ -144,7 +155,7 @@ var ChartLine = function ChartLine(props) {
           top: "5%",
           icon: "circle",
           textStyle: {
-            color: "#373D48"
+            color: chrome.text
           },
           itemWidth: 8,
           itemHeight: 8
@@ -171,18 +182,22 @@ var ChartLine = function ChartLine(props) {
       series: buildCartesianSeriesOptions("line", seriesData, series)
     }, coreOption);
     return option;
-  }, [xAxisData, xAxis, yAxis, grid, chartTitle, dataZoom, normalizedScroll, insideDataZoom, sliderDataZoom, title, legendData, legend, tooltip, seriesData, series, enableLegendAutoScroll, coreOption]);
+  }, [xAxisData, xAxis, yAxis, grid, chartTitle, dataZoom, normalizedScroll, insideDataZoom, sliderDataZoom, title, legendData, legend, tooltip, seriesData, series, enableLegendAutoScroll, coreOption, chrome]);
 
   // Callback for handling chart resize
   var handleResize = useCallback(function () {
     var _chartInstanceRef$cur;
+    // A keep-alive tab losing focus fires the observer with a 0×0 box; resizing to that throws
+    // the laid-out canvas away and it has to be rebuilt when the tab comes back
+    var el = chartRef.current;
+    if (!el || el.clientWidth === 0 || el.clientHeight === 0) return;
     (_chartInstanceRef$cur = chartInstanceRef.current) === null || _chartInstanceRef$cur === void 0 || _chartInstanceRef$cur.resize();
   }, []);
 
   // Initialize the chart
   useEffect(function () {
     var _xAxisData$join, _chart$getOption, _chart$getOption2, _opt$legend$, _opt$legend, _ref3;
-    if (!chartRef.current) return;
+    if (!chartRef.current || !containerReady) return;
 
     // Initialize or reuse the existing instance
     var chart = chartInstanceRef.current;
@@ -323,7 +338,7 @@ var ChartLine = function ChartLine(props) {
     };
   }, [chartOption, handleResize, onClick, onLegendSelectChanged, onDataZoomWindowChanged, xAxisData, enableLegendAutoScroll, legendVisibleCount, legendScrollInterval,
   // 图例是否接管滚轮由它推导，漏了会拿到过期的滚动配置
-  normalizedScroll]);
+  normalizedScroll, containerReady]);
 
   // Handle auto play
   useEffect(function () {

package/es/components/Chart/Pie/Pie3D/index.js

@@ -2,6 +2,7 @@ var _excluded = ["className", "style", "pieData", "internalDiameterRatio", "auto
 function _objectWithoutProperties(source, excluded) { if (source == null) return {}; var target = _objectWithoutPropertiesLoose(source, excluded); var key, i; if (Object.getOwnPropertySymbols) { var sourceSymbolKeys = Object.getOwnPropertySymbols(source); for (i = 0; i < sourceSymbolKeys.length; i++) { key = sourceSymbolKeys[i]; if (excluded.indexOf(key) >= 0) continue; if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue; target[key] = source[key]; } } return target; }
 function _objectWithoutPropertiesLoose(source, excluded) { if (source == null) return {}; var target = {}; var sourceKeys = Object.keys(source); var key, i; for (i = 0; i < sourceKeys.length; i++) { key = sourceKeys[i]; if (excluded.indexOf(key) >= 0) continue; target[key] = source[key]; } return target; }
 import * as echarts from "echarts";
+import useContainerReady from "../../_hooks/useContainerReady";
 import "echarts-gl";
 import React, { useCallback, useEffect, useMemo, useRef } from "react";
 import { useMouseOverHandler, useGlobalOutHandler } from "./_hooks";
@@ -45,6 +46,8 @@ var ChartPie3D = function ChartPie3D(props) {
     coreOption = _objectWithoutProperties(props, _excluded);
   var chartRef = useRef(null);
   var chartInstanceRef = useRef(null);
+  // Defers `echarts.init` until the container has a box — see the hook for why
+  var containerReady = useContainerReady(chartRef);
   var resizeObserverRef = useRef(null);
   var hoveredIndexRef = useRef("");
   var optionRef = useRef(null);
@@ -67,6 +70,10 @@ var ChartPie3D = function ChartPie3D(props) {
   }, [pieData, internalDiameterRatio, tooltip, alpha, beta, autoRotate, distance, coreOption, minHeight, maxHeight, yOffset, label, enableMouseControl]);
   var handleResize = useCallback(function () {
     var _chartInstanceRef$cur;
+    // A keep-alive tab losing focus fires the observer with a 0×0 box; resizing to that throws
+    // the laid-out canvas away and it has to be rebuilt when the tab comes back
+    var el = chartRef.current;
+    if (!el || el.clientWidth === 0 || el.clientHeight === 0) return;
     (_chartInstanceRef$cur = chartInstanceRef.current) === null || _chartInstanceRef$cur === void 0 || _chartInstanceRef$cur.resize();
   }, []);
   var handleMouseOver = useMouseOverHandler(optionRef, chartInstanceRef, hoveredIndexRef, {
@@ -83,7 +90,7 @@ var ChartPie3D = function ChartPie3D(props) {
     autoRotate: autoRotate
   });
   useEffect(function () {
-    if (!chartRef.current) return;
+    if (!chartRef.current || !containerReady) return;
     var chart = chartInstanceRef.current;
     if (!chart) {
       chart = echarts.init(chartRef.current);
@@ -112,7 +119,7 @@ var ChartPie3D = function ChartPie3D(props) {
         }
       }
     };
-  }, [chartOption, handleResize, handleMouseOver, handleGlobalOut, onChart, onClick]);
+  }, [chartOption, handleResize, handleMouseOver, handleGlobalOut, onChart, onClick, containerReady]);
   useEffect(function () {
     return function () {
       if (resizeObserverRef.current) {

package/es/components/Chart/Pie/index.js

@@ -14,6 +14,7 @@ function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len
 function _objectWithoutProperties(source, excluded) { if (source == null) return {}; var target = _objectWithoutPropertiesLoose(source, excluded); var key, i; if (Object.getOwnPropertySymbols) { var sourceSymbolKeys = Object.getOwnPropertySymbols(source); for (i = 0; i < sourceSymbolKeys.length; i++) { key = sourceSymbolKeys[i]; if (excluded.indexOf(key) >= 0) continue; if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue; target[key] = source[key]; } } return target; }
 function _objectWithoutPropertiesLoose(source, excluded) { if (source == null) return {}; var target = {}; var sourceKeys = Object.keys(source); var key, i; for (i = 0; i < sourceKeys.length; i++) { key = sourceKeys[i]; if (excluded.indexOf(key) >= 0) continue; target[key] = source[key]; } return target; }
 import * as echarts from "echarts";
+import useContainerReady from "../_hooks/useContainerReady";
 import React, { useCallback, useEffect, useMemo, useRef } from "react";
 import { autoScrollLegend } from "../chartUtils";
 import styles from "../index.module.scss";
@@ -49,6 +50,8 @@ var ChartPie = function ChartPie(props) {
     coreOption = _objectWithoutProperties(props, _excluded);
   var chartRef = useRef(null);
   var chartInstanceRef = useRef(null);
+  // Defers `echarts.init` until the container has a box — see the hook for why
+  var containerReady = useContainerReady(chartRef);
   var resizeObserverRef = useRef(null);
   var legendScrollRef = useRef(null);
 
@@ -198,12 +201,16 @@ var ChartPie = function ChartPie(props) {
   // Callback for handling chart resize
   var handleResize = useCallback(function () {
     var _chartInstanceRef$cur;
+    // A keep-alive tab losing focus fires the observer with a 0×0 box; resizing to that throws
+    // the laid-out canvas away and it has to be rebuilt when the tab comes back
+    var el = chartRef.current;
+    if (!el || el.clientWidth === 0 || el.clientHeight === 0) return;
     (_chartInstanceRef$cur = chartInstanceRef.current) === null || _chartInstanceRef$cur === void 0 || _chartInstanceRef$cur.resize();
   }, []);
 
   // Initialize the chart
   useEffect(function () {
-    if (!chartRef.current) return;
+    if (!chartRef.current || !containerReady) return;
 
     // Initialize or reuse the existing instance
     var chart = chartInstanceRef.current;
@@ -261,7 +268,7 @@ var ChartPie = function ChartPie(props) {
         legendScrollRef.current = null;
       }
     };
-  }, [chartOption, handleResize, onChart, onClick, enableLegendAutoScroll, seriesData, legendVisibleCount, legendScrollInterval]);
+  }, [chartOption, handleResize, onChart, onClick, enableLegendAutoScroll, seriesData, legendVisibleCount, legendScrollInterval, containerReady]);
 
   // Clean up resources when the component unmounts
   useEffect(function () {

package/es/components/Chart/Polar/index.js

@@ -8,6 +8,7 @@ function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e
 function _objectWithoutProperties(source, excluded) { if (source == null) return {}; var target = _objectWithoutPropertiesLoose(source, excluded); var key, i; if (Object.getOwnPropertySymbols) { var sourceSymbolKeys = Object.getOwnPropertySymbols(source); for (i = 0; i < sourceSymbolKeys.length; i++) { key = sourceSymbolKeys[i]; if (excluded.indexOf(key) >= 0) continue; if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue; target[key] = source[key]; } } return target; }
 function _objectWithoutPropertiesLoose(source, excluded) { if (source == null) return {}; var target = {}; var sourceKeys = Object.keys(source); var key, i; for (i = 0; i < sourceKeys.length; i++) { key = sourceKeys[i]; if (excluded.indexOf(key) >= 0) continue; target[key] = source[key]; } return target; }
 import * as echarts from "echarts";
+import useContainerReady from "../_hooks/useContainerReady";
 import React, { useCallback, useEffect, useMemo, useRef } from "react";
 import styles from "../index.module.scss";
 import { jsx as _jsx } from "react/jsx-runtime";
@@ -29,6 +30,8 @@ var Polar = function Polar(props) {
     coreOption = _objectWithoutProperties(props, _excluded);
   var chartRef = useRef(null);
   var chartInstanceRef = useRef(null);
+  // Defers `echarts.init` until the container has a box — see the hook for why
+  var containerReady = useContainerReady(chartRef);
   var resizeObserverRef = useRef(null);
 
   // Cache the chart option with useMemo
@@ -135,12 +138,16 @@ var Polar = function Polar(props) {
   // Callback handling chart resize
   var handleResize = useCallback(function () {
     var _chartInstanceRef$cur;
+    // A keep-alive tab losing focus fires the observer with a 0×0 box; resizing to that throws
+    // the laid-out canvas away and it has to be rebuilt when the tab comes back
+    var el = chartRef.current;
+    if (!el || el.clientWidth === 0 || el.clientHeight === 0) return;
     (_chartInstanceRef$cur = chartInstanceRef.current) === null || _chartInstanceRef$cur === void 0 || _chartInstanceRef$cur.resize();
   }, []);
 
   // Initialize the chart
   useEffect(function () {
-    if (!chartRef.current) return;
+    if (!chartRef.current || !containerReady) return;
 
     // Initialize a new instance or reuse the existing one
     var chart = chartInstanceRef.current;
@@ -165,7 +172,7 @@ var Polar = function Polar(props) {
     return function () {
       window.removeEventListener("resize", handleResize);
     };
-  }, [chartOption, handleResize]);
+  }, [chartOption, handleResize, containerReady]);
 
   // Clean up resources on unmount
   useEffect(function () {

package/es/components/Chart/Radar/index.js

@@ -14,6 +14,7 @@ function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e
 function _objectWithoutProperties(source, excluded) { if (source == null) return {}; var target = _objectWithoutPropertiesLoose(source, excluded); var key, i; if (Object.getOwnPropertySymbols) { var sourceSymbolKeys = Object.getOwnPropertySymbols(source); for (i = 0; i < sourceSymbolKeys.length; i++) { key = sourceSymbolKeys[i]; if (excluded.indexOf(key) >= 0) continue; if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue; target[key] = source[key]; } } return target; }
 function _objectWithoutPropertiesLoose(source, excluded) { if (source == null) return {}; var target = {}; var sourceKeys = Object.keys(source); var key, i; for (i = 0; i < sourceKeys.length; i++) { key = sourceKeys[i]; if (excluded.indexOf(key) >= 0) continue; target[key] = source[key]; } return target; }
 import * as echarts from "echarts";
+import useContainerReady from "../_hooks/useContainerReady";
 import React, { useCallback, useEffect, useMemo, useRef } from "react";
 import styles from "../index.module.scss";
 
@@ -40,6 +41,8 @@ var Radar = function Radar(props) {
     coreOption = _objectWithoutProperties(props, _excluded);
   var chartRef = useRef(null);
   var chartInstanceRef = useRef(null);
+  // Defers `echarts.init` until the container has a box — see the hook for why
+  var containerReady = useContainerReady(chartRef);
   var resizeObserverRef = useRef(null);
   var hoveredIndicatorRef = useRef(-1);
   var singleIndicatorEnabled = Boolean(singleIndicatorTooltipProp) && singleIndicatorMode !== undefined;
@@ -154,10 +157,14 @@ var Radar = function Radar(props) {
   }, [indicators, data, color, name, radar, series, coreOption, singleIndicatorEnabled, singleIndicatorFormatter, singleIndicatorRegion]);
   var handleResize = useCallback(function () {
     var _chartInstanceRef$cur;
+    // A keep-alive tab losing focus fires the observer with a 0×0 box; resizing to that throws
+    // the laid-out canvas away and it has to be rebuilt when the tab comes back
+    var el = chartRef.current;
+    if (!el || el.clientWidth === 0 || el.clientHeight === 0) return;
     (_chartInstanceRef$cur = chartInstanceRef.current) === null || _chartInstanceRef$cur === void 0 || _chartInstanceRef$cur.resize();
   }, []);
   useEffect(function () {
-    if (!chartRef.current) return;
+    if (!chartRef.current || !containerReady) return;
     var chart = chartInstanceRef.current;
     if (!chart) {
       chart = echarts.init(chartRef.current);
@@ -281,7 +288,7 @@ var Radar = function Radar(props) {
         }
       }
     };
-  }, [chartOption, handleResize, singleIndicatorEnabled, singleIndicatorRegion, singleIndicatorHighlight, singleIndicatorHoverFill, color]);
+  }, [chartOption, handleResize, singleIndicatorEnabled, singleIndicatorRegion, singleIndicatorHighlight, singleIndicatorHoverFill, color, containerReady]);
   useEffect(function () {
     return function () {
       if (resizeObserverRef.current) {

package/es/components/Chart/Sankey/index.js

@@ -11,6 +11,7 @@ function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key i
 function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
 function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
 import React, { useCallback, useEffect, useMemo, useRef } from "react";
+import useContainerReady from "../_hooks/useContainerReady";
 import styles from "../index.module.scss";
 import * as echarts from "echarts";
 import { jsx as _jsx } from "react/jsx-runtime";
@@ -23,6 +24,8 @@ var Sankey = function Sankey(props) {
     getImage = props.getImage;
   var chartRef = useRef(null);
   var chartInstanceRef = useRef(null);
+  // Defers `echarts.init` until the container has a box — see the hook for why
+  var containerReady = useContainerReady(chartRef);
   var resizeObserverRef = useRef(null);
 
   // Cache the chart option with useMemo
@@ -103,12 +106,16 @@ var Sankey = function Sankey(props) {
   // Callback handling chart resize
   var handleResize = useCallback(function () {
     var _chartInstanceRef$cur;
+    // A keep-alive tab losing focus fires the observer with a 0×0 box; resizing to that throws
+    // the laid-out canvas away and it has to be rebuilt when the tab comes back
+    var el = chartRef.current;
+    if (!el || el.clientWidth === 0 || el.clientHeight === 0) return;
     (_chartInstanceRef$cur = chartInstanceRef.current) === null || _chartInstanceRef$cur === void 0 || _chartInstanceRef$cur.resize();
   }, []);
 
   // Initialize the chart
   useEffect(function () {
-    if (!chartRef.current) return;
+    if (!chartRef.current || !containerReady) return;
 
     // Initialize a new instance or reuse the existing one
     var chart = chartInstanceRef.current;
@@ -142,7 +149,7 @@ var Sankey = function Sankey(props) {
     return function () {
       window.removeEventListener("resize", handleResize);
     };
-  }, [chartOption, handleResize, getImage]);
+  }, [chartOption, handleResize, getImage, containerReady]);
 
   // Clean up resources on unmount
   useEffect(function () {

package/es/components/Chart/Tree/index.js

@@ -5,6 +5,7 @@ function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key i
 function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
 function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
 import React, { useCallback, useEffect, useMemo, useRef } from "react";
+import useContainerReady from "../_hooks/useContainerReady";
 import styles from "../index.module.scss";
 import * as echarts from "echarts";
 import { deepCopy } from "hsu-utils";
@@ -18,6 +19,8 @@ var Tree = function Tree(props) {
     getImage = props.getImage;
   var chartRef = useRef(null);
   var chartInstanceRef = useRef(null);
+  // Defers `echarts.init` until the container has a box — see the hook for why
+  var containerReady = useContainerReady(chartRef);
   var resizeObserverRef = useRef(null);
 
   // Cache the chart option with useMemo
@@ -38,12 +41,16 @@ var Tree = function Tree(props) {
   // Callback handling chart resize
   var handleResize = useCallback(function () {
     var _chartInstanceRef$cur;
+    // A keep-alive tab losing focus fires the observer with a 0×0 box; resizing to that throws
+    // the laid-out canvas away and it has to be rebuilt when the tab comes back
+    var el = chartRef.current;
+    if (!el || el.clientWidth === 0 || el.clientHeight === 0) return;
     (_chartInstanceRef$cur = chartInstanceRef.current) === null || _chartInstanceRef$cur === void 0 || _chartInstanceRef$cur.resize();
   }, []);
 
   // Initialize the chart
   useEffect(function () {
-    if (!chartRef.current) return;
+    if (!chartRef.current || !containerReady) return;
 
     // Initialize a new instance or reuse the existing one
     var chart = chartInstanceRef.current;
@@ -77,7 +84,7 @@ var Tree = function Tree(props) {
     return function () {
       window.removeEventListener("resize", handleResize);
     };
-  }, [chartOption, handleResize, getImage]);
+  }, [chartOption, handleResize, getImage, containerReady]);
 
   // Clean up resources on unmount
   useEffect(function () {

package/es/components/Chart/_hooks/useContainerReady.d.ts

@@ -0,0 +1,18 @@
+import { RefObject } from "react";
+/**
+ * Whether the referenced element has a non-zero box yet.
+ *
+ * `echarts.init` on a 0×0 element logs `Can't get DOM width or height` and builds a canvas with no
+ * size, recovering only on the next `resize()`. A chart hits that path whenever it mounts before
+ * layout has given it space — inside a keep-alive tab that is not the active one, a collapsed
+ * panel, a modal that has not opened yet — so consuming apps see the warning for charts that end
+ * up rendering perfectly well.
+ *
+ * Gating `init` on this flag defers it to the first frame the element actually occupies space.
+ *
+ * It **latches**: once measured, the element going back to 0×0 (a keep-alive tab losing focus)
+ * must not read as "not ready" again, or the init effect would tear the chart down and re-create
+ * it on every tab switch.
+ */
+declare const useContainerReady: (ref: RefObject<HTMLElement | null>) => boolean;
+export default useContainerReady;