@hsu-react/ui 2.4.1 → 2.4.3

package/es/layout/NavTabBar/_hooks/useTabPath.js

@@ -14,7 +14,7 @@ function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o =
 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 { useCallback, useEffect, useState } from "react";
+import { useCallback, useEffect, useMemo, useState } from "react";
 import { useLocation } from "react-router";
 import { checkTabPathMatch } from "../_utils/pathMatch";
 import { array_is_includes } from "hsu-utils";
@@ -25,6 +25,19 @@ export var useTabPath = function useTabPath(_ref) {
   var items = _ref.items,
     affixRouter = _ref.affixRouter;
   var location = useLocation();
+
+  /**
+   * Keyed on the *contents* of `affixRouter`, not on the array itself.
+   *
+   * Callers pass an inline literal (`affixRouter={[HOME]}`), and omitting the prop hands the
+   * component a fresh `[]` default on every render — either way the array identity changes each
+   * time. Depending on it directly re-runs the effect below on every render, and that effect
+   * calls setState, so the whole thing becomes a render loop.
+   */
+  var affixKey = affixRouter.join("\x01");
+  var affixSet = useMemo(function () {
+    return new Set(affixKey ? affixKey.split("\x01") : []);
+  }, [affixKey]);
   var _useState = useState(""),
     _useState2 = _slicedToArray(_useState, 2),
     tabKey = _useState2[0],
@@ -43,7 +56,7 @@ export var useTabPath = function useTabPath(_ref) {
         _checkAffix(item.children);
       } else {
         // Check whether it is an affixed route
-        var isAffix = affixRouter.includes(item.key) || item.affix;
+        var isAffix = affixSet.has(item.key) || item.affix;
         if (isAffix) {
           setOpenkeys(function (prev) {
             var find = prev.find(function (i) {
@@ -57,7 +70,7 @@ export var useTabPath = function useTabPath(_ref) {
         }
       }
     });
-  }, [affixRouter]);
+  }, [affixSet]);
   var _checkPath = useCallback(function (items, parents) {
     var pathname = decodeURI(location.pathname);
     var search = location.search;
@@ -79,36 +92,48 @@ export var useTabPath = function useTabPath(_ref) {
             // Handle param routes
             setTabKey("".concat(pathname).concat(search));
             setOpenkeys(function (prev) {
+              var nextKey = "".concat(pathname).concat(search);
               var find = prev.find(function (i) {
                 return i.key.split("?")[0] === pathname;
               });
               if (find) {
+                // Already on this key: return `prev` untouched. `map` builds a new array
+                // every time, and React treats a new reference as a state change — which is
+                // the other half of the render loop above.
+                if (find.key === nextKey) {
+                  return prev;
+                }
                 return prev.map(function (i) {
                   return i.key.split("?")[0] === pathname ? _objectSpread(_objectSpread({}, i), {}, {
-                    key: "".concat(pathname).concat(search)
+                    key: nextKey
                   }) : i;
                 });
               }
               return [].concat(_toConsumableArray(prev), [_objectSpread(_objectSpread({}, item), {}, {
-                key: "".concat(pathname).concat(search)
+                key: nextKey
               })]);
             });
           } else {
             // Handle plain routes
             setTabKey("".concat(item.key).concat(search));
             setOpenkeys(function (prev) {
+              var nextKey = "".concat(item.key).concat(search);
               var find = prev.find(function (i) {
                 return i.key.split("?")[0] === item.key;
               });
               if (find) {
+                // Same as above: an unchanged tab must not produce a new reference
+                if (find.key === nextKey) {
+                  return prev;
+                }
                 return prev.map(function (i) {
                   return i.key.split("?")[0] === item.key ? _objectSpread(_objectSpread({}, i), {}, {
-                    key: "".concat(item.key).concat(search)
+                    key: nextKey
                   }) : i;
                 });
               }
               return [].concat(_toConsumableArray(prev), [_objectSpread(_objectSpread({}, item), {}, {
-                key: "".concat(item.key).concat(search)
+                key: nextKey
               })]);
             });
           }
@@ -116,12 +141,24 @@ export var useTabPath = function useTabPath(_ref) {
       }
     });
   }, [location.pathname, location.search]);
+
+  /**
+   * Closing the last tab navigates to `basePath` — but when that tab *was* `basePath`, the
+   * location never changes, so path matching would not re-run and the bar would be left empty
+   * while its page is still on screen. Going empty has to re-trigger the match on its own.
+   *
+   * This settles rather than looping: re-matching adds the tab back, which flips `isEmpty` and
+   * runs the effect once more, and that pass finds the tab already present and returns the same
+   * state object — so React stops there. (Only true because the setters below bail out when
+   * nothing changed; without that this would spin.)
+   */
+  var isEmpty = openKeys.length === 0;
   useEffect(function () {
     // Handle affixed routes first to populate openKeys
     _checkAffix(items);
     // Then run path matching
     _checkPath(items);
-  }, [_checkAffix, _checkPath, items]);
+  }, [_checkAffix, _checkPath, items, isEmpty]);
   return {
     tabKey: tabKey,
     setTabKey: setTabKey,

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)(() => {

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

@@ -5,6 +5,7 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.default = void 0;
 var _react = _interopRequireWildcard(require("react"));
+var _useContainerReady = _interopRequireDefault(require("../_hooks/useContainerReady"));
 var _indexModule = _interopRequireDefault(require("../index.module.scss"));
 var echarts = _interopRequireWildcard(require("echarts"));
 var _jsxRuntime = require("react/jsx-runtime");
@@ -20,6 +21,8 @@ const Common = 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);
 
   // Cache the chart configuration with useMemo
@@ -32,12 +35,16 @@ const Common = props => {
 
   // Callback that handles 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 an existing instance
     let chart = chartInstanceRef.current;
@@ -65,7 +72,7 @@ const Common = props => {
     return () => {
       window.removeEventListener("resize", handleResize);
     };
-  }, [chartOption, handleResize, onChart]);
+  }, [chartOption, handleResize, onChart, containerReady]);
 
   // Clean up resources on component unmount
   (0, _react.useEffect)(() => {

package/lib/components/Chart/Gauge/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 _jsxRuntime = require("react/jsx-runtime");
@@ -32,6 +33,8 @@ const Gauge = props => {
   } = series;
   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);
 
   // Cache the chart option with useMemo
@@ -92,12 +95,16 @@ const Gauge = 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;
@@ -122,7 +129,7 @@ const Gauge = props => {
     return () => {
       window.removeEventListener("resize", handleResize);
     };
-  }, [chartOption, handleResize]);
+  }, [chartOption, handleResize, containerReady]);
 
   // Clean up resources when the component unmounts
   (0, _react.useEffect)(() => {

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

@@ -5,6 +5,7 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.default = void 0;
 var _react = _interopRequireWildcard(require("react"));
+var _useContainerReady = _interopRequireDefault(require("../_hooks/useContainerReady"));
 var _indexModule = _interopRequireDefault(require("../index.module.scss"));
 var echarts = _interopRequireWildcard(require("echarts"));
 var _heatmap = require("../_utils/heatmap");
@@ -37,6 +38,8 @@ const Heatmap = 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);
   // 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
@@ -182,12 +185,16 @@ const Heatmap = 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;
@@ -222,7 +229,7 @@ const Heatmap = props => {
         chartInstanceRef.current?.off("click", onClick);
       }
     };
-  }, [chartOption, handleResize, onChart, onClick]);
+  }, [chartOption, handleResize, onChart, onClick, containerReady]);
 
   // Clean up resources when the component unmounts
   (0, _react.useEffect)(() => {

package/lib/components/Chart/Line/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 ChartLine = 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);
@@ -189,12 +192,16 @@ const ChartLine = 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;
@@ -324,7 +331,7 @@ const ChartLine = props => {
     };
   }, [chartOption, handleResize, onClick, onLegendSelectChanged, onDataZoomWindowChanged, xAxisData, enableLegendAutoScroll, legendVisibleCount, legendScrollInterval,
   // 图例是否接管滚轮由它推导，漏了会拿到过期的滚动配置
-  normalizedScroll]);
+  normalizedScroll, containerReady]);
 
   // Handle auto play
   (0, _react.useEffect)(() => {

package/lib/components/Chart/Pie/Pie3D/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"));
 require("echarts-gl");
 var _react = _interopRequireWildcard(require("react"));
 var _hooks = require("./_hooks");
@@ -41,6 +42,8 @@ const ChartPie3D = 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 hoveredIndexRef = (0, _react.useRef)("");
   const optionRef = (0, _react.useRef)(null);
@@ -62,6 +65,10 @@ const ChartPie3D = props => {
     });
   }, [pieData, internalDiameterRatio, tooltip, alpha, beta, autoRotate, distance, coreOption, minHeight, maxHeight, yOffset, label, enableMouseControl]);
   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();
   }, []);
   const handleMouseOver = (0, _hooks.useMouseOverHandler)(optionRef, chartInstanceRef, hoveredIndexRef, {
@@ -78,7 +85,7 @@ const ChartPie3D = props => {
     autoRotate
   });
   (0, _react.useEffect)(() => {
-    if (!chartRef.current) return;
+    if (!chartRef.current || !containerReady) return;
     let chart = chartInstanceRef.current;
     if (!chart) {
       chart = echarts.init(chartRef.current);
@@ -107,7 +114,7 @@ const ChartPie3D = props => {
         }
       }
     };
-  }, [chartOption, handleResize, handleMouseOver, handleGlobalOut, onChart, onClick]);
+  }, [chartOption, handleResize, handleMouseOver, handleGlobalOut, onChart, onClick, containerReady]);
   (0, _react.useEffect)(() => {
     return () => {
       if (resizeObserverRef.current) {

package/lib/components/Chart/Pie/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 _chartUtils = require("../chartUtils");
 var _indexModule = _interopRequireDefault(require("../index.module.scss"));
@@ -38,6 +39,8 @@ const ChartPie = 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 legendScrollRef = (0, _react.useRef)(null);
 
@@ -191,12 +194,16 @@ const ChartPie = 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;
@@ -252,7 +259,7 @@ const 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
   (0, _react.useEffect)(() => {

package/lib/components/Chart/Polar/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 _jsxRuntime = require("react/jsx-runtime");
@@ -30,6 +31,8 @@ const Polar = 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);
 
   // Cache the chart option with useMemo
@@ -144,12 +147,16 @@ const Polar = props => {
 
   // Callback 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 a new instance or reuse the existing one
     let chart = chartInstanceRef.current;
@@ -174,7 +181,7 @@ const Polar = props => {
     return () => {
       window.removeEventListener("resize", handleResize);
     };
-  }, [chartOption, handleResize]);
+  }, [chartOption, handleResize, containerReady]);
 
   // Clean up resources on unmount
   (0, _react.useEffect)(() => {

package/lib/components/Chart/Radar/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 _jsxRuntime = require("react/jsx-runtime");
@@ -33,6 +34,8 @@ const Radar = 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 hoveredIndicatorRef = (0, _react.useRef)(-1);
   const singleIndicatorEnabled = Boolean(singleIndicatorTooltipProp) && singleIndicatorMode !== undefined;
@@ -144,10 +147,14 @@ const Radar = props => {
     return option;
   }, [indicators, data, color, name, radar, series, coreOption, singleIndicatorEnabled, singleIndicatorFormatter, singleIndicatorRegion]);
   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();
   }, []);
   (0, _react.useEffect)(() => {
-    if (!chartRef.current) return;
+    if (!chartRef.current || !containerReady) return;
     let chart = chartInstanceRef.current;
     if (!chart) {
       chart = echarts.init(chartRef.current);
@@ -263,7 +270,7 @@ const Radar = props => {
         }
       }
     };
-  }, [chartOption, handleResize, singleIndicatorEnabled, singleIndicatorRegion, singleIndicatorHighlight, singleIndicatorHoverFill, color]);
+  }, [chartOption, handleResize, singleIndicatorEnabled, singleIndicatorRegion, singleIndicatorHighlight, singleIndicatorHoverFill, color, containerReady]);
   (0, _react.useEffect)(() => {
     return () => {
       if (resizeObserverRef.current) {

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

@@ -5,6 +5,7 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.default = void 0;
 var _react = _interopRequireWildcard(require("react"));
+var _useContainerReady = _interopRequireDefault(require("../_hooks/useContainerReady"));
 var _indexModule = _interopRequireDefault(require("../index.module.scss"));
 var echarts = _interopRequireWildcard(require("echarts"));
 var _jsxRuntime = require("react/jsx-runtime");
@@ -22,6 +23,8 @@ const Sankey = 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);
 
   // Cache the chart option with useMemo
@@ -103,12 +106,16 @@ const Sankey = props => {
 
   // Callback 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 a new instance or reuse the existing one
     let chart = chartInstanceRef.current;
@@ -142,7 +149,7 @@ const Sankey = props => {
     return () => {
       window.removeEventListener("resize", handleResize);
     };
-  }, [chartOption, handleResize, getImage]);
+  }, [chartOption, handleResize, getImage, containerReady]);
 
   // Clean up resources on unmount
   (0, _react.useEffect)(() => {

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

@@ -5,6 +5,7 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.default = void 0;
 var _react = _interopRequireWildcard(require("react"));
+var _useContainerReady = _interopRequireDefault(require("../_hooks/useContainerReady"));
 var _indexModule = _interopRequireDefault(require("../index.module.scss"));
 var echarts = _interopRequireWildcard(require("echarts"));
 var _hsuUtils = require("hsu-utils");
@@ -23,6 +24,8 @@ const Tree = 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);
 
   // Cache the chart option with useMemo
@@ -43,12 +46,16 @@ const Tree = props => {
 
   // Callback 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 a new instance or reuse the existing one
     let chart = chartInstanceRef.current;
@@ -82,7 +89,7 @@ const Tree = props => {
     return () => {
       window.removeEventListener("resize", handleResize);
     };
-  }, [chartOption, handleResize, getImage]);
+  }, [chartOption, handleResize, getImage, containerReady]);
 
   // Clean up resources on unmount
   (0, _react.useEffect)(() => {

package/lib/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;