@hsu-react/ui 2.4.1 → 2.4.2

package/es/components/Chart/Bar/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 { autoScrollLegend } from "../_utils/autoScrollLegend";
@@ -46,6 +47,8 @@ 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);
@@ -187,13 +190,17 @@ var ChartBar = function ChartBar(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 () {
     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;
@@ -334,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,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 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";
@@ -42,6 +43,8 @@ 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
@@ -183,12 +186,16 @@ var Heatmap = function Heatmap(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;
@@ -225,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,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 { autoScrollLegend } from "../_utils/autoScrollLegend";
@@ -46,6 +47,8 @@ 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);
@@ -184,13 +187,17 @@ var ChartLine = function ChartLine(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 () {
     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;
@@ -331,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;

package/es/components/Chart/_hooks/useContainerReady.js

@@ -0,0 +1,56 @@
+function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
+function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t.return && (u = t.return(), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
+function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
+import { useEffect, useState } 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.
+ */
+var useContainerReady = function useContainerReady(ref) {
+  var _useState = useState(false),
+    _useState2 = _slicedToArray(_useState, 2),
+    ready = _useState2[0],
+    setReady = _useState2[1];
+  useEffect(function () {
+    if (ready) return;
+    var el = ref.current;
+    if (!el) return;
+    var measure = function measure() {
+      var _el$getBoundingClient = el.getBoundingClientRect(),
+        width = _el$getBoundingClient.width,
+        height = _el$getBoundingClient.height;
+      if (width > 0 && height > 0) {
+        setReady(true);
+        return true;
+      }
+      return false;
+    };
+
+    // Already laid out on mount — the common case, and it must not cost an extra frame
+    if (measure()) return;
+    var observer = new ResizeObserver(function () {
+      if (measure()) observer.disconnect();
+    });
+    observer.observe(el);
+    return function () {
+      return observer.disconnect();
+    };
+  }, [ready, ref]);
+  return ready;
+};
+export default useContainerReady;

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

@@ -5,6 +5,7 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.default = void 0;
 var echarts = _interopRequireWildcard(require("echarts"));
+var _useContainerReady = _interopRequireDefault(require("../_hooks/useContainerReady"));
 var _react = _interopRequireWildcard(require("react"));
 var _indexModule = _interopRequireDefault(require("../index.module.scss"));
 var _autoScrollLegend = require("../_utils/autoScrollLegend");
@@ -45,6 +46,8 @@ const ChartBar = props => {
   } = props;
   const chartRef = (0, _react.useRef)(null);
   const chartInstanceRef = (0, _react.useRef)(null);
+  // Defers `echarts.init` until the container has a box — see the hook for why
+  const containerReady = (0, _useContainerReady.default)(chartRef);
   const resizeObserverRef = (0, _react.useRef)(null);
   const prevXAxisKeyRef = (0, _react.useRef)(null);
   const legendScrollRef = (0, _react.useRef)(null);
@@ -192,12 +195,16 @@ const ChartBar = props => {
 
   // Callback for handling chart resize
   const handleResize = (0, _react.useCallback)(() => {
+    // 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
+    const el = chartRef.current;
+    if (!el || el.clientWidth === 0 || el.clientHeight === 0) return;
     chartInstanceRef.current?.resize();
   }, []);
 
   // Initialize the chart
   (0, _react.useEffect)(() => {
-    if (!chartRef.current) return;
+    if (!chartRef.current || !containerReady) return;
 
     // Initialize or reuse the existing instance
     let chart = chartInstanceRef.current;
@@ -327,7 +334,7 @@ const ChartBar = props => {
     };
   }, [chartOption, handleResize, onClick, onLegendSelectChanged, onDataZoomWindowChanged, xAxisData, enableLegendAutoScroll, legendVisibleCount, legendScrollInterval,
   // 图例是否接管滚轮由它推导，漏了会拿到过期的滚动配置
-  normalizedScroll]);
+  normalizedScroll, containerReady]);
 
   // Handle auto play
   (0, _react.useEffect)(() => {