@hsu-react/ui 2.5.5 → 2.5.7

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

@@ -17,6 +17,7 @@ import { buildCartesianSeriesOptions, createDefaultCategoryXAxis, createDefaultV
 import { resolveChartChrome } from "../_utils/chartTheme";
 import useIsDark from "../../../hooks/useIsDark";
 import useLatestRef from "../../../hooks/useLatestRef";
+import useShallowStable from "../../../hooks/useShallowStable";
 import { jsx as _jsx } from "react/jsx-runtime";
 var ChartBar = function ChartBar(props) {
   var className = props.className,
@@ -45,7 +46,11 @@ var ChartBar = function ChartBar(props) {
     legendVisibleCount = _props$legendVisibleC === void 0 ? 8 : _props$legendVisibleC,
     _props$legendScrollIn = props.legendScrollInterval,
     legendScrollInterval = _props$legendScrollIn === void 0 ? 1500 : _props$legendScrollIn,
-    coreOption = _objectWithoutProperties(props, _excluded);
+    restOption = _objectWithoutProperties(props, _excluded);
+  // rest 解构出来的对象每次渲染都是新引用，直接进依赖数组会让 chartOption 的 memo
+  // 恒不命中 —— 父组件每渲染一次就重跑一次 setOption(notMerge)，动画重播、悬浮态被清掉。
+  // useShallowStable 让它回到值语义：内容浅相等就复用同一引用，真变了立刻透出新引用。
+  var coreOption = useShallowStable(restOption);
   var chartRef = useRef(null);
   var chartInstanceRef = useRef(null);
   // Defers `echarts.init` until the container has a box — see the hook for why

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

@@ -22,6 +22,7 @@ import styles from "../index.module.scss";
 import * as echarts from "echarts";
 import { defaultBubbleColorList, drawCircles } from "../_utils/bubble";
 import { useLatestRef } from "../../../hooks/useLatestRef";
+import useShallowStable from "../../../hooks/useShallowStable";
 
 // Extended data item type containing all properties the chart needs
 import { jsx as _jsx } from "react/jsx-runtime";
@@ -38,7 +39,11 @@ var Bubble = function Bubble(props) {
     title = props.title,
     onChart = props.onChart,
     onClick = props.onClick,
-    coreOption = _objectWithoutProperties(props, _excluded);
+    restOption = _objectWithoutProperties(props, _excluded);
+  // rest 解构出来的对象每次渲染都是新引用，直接进依赖数组会让 chartOption 的 memo
+  // 恒不命中 —— 父组件每渲染一次就重跑一次 setOption(notMerge)，动画重播、悬浮态被清掉。
+  // useShallowStable 让它回到值语义：内容浅相等就复用同一引用，真变了立刻透出新引用。
+  var coreOption = useShallowStable(restOption);
   var chartRef = useRef(null);
   var chartInstanceRef = useRef(null);
   var resizeObserverRef = useRef(null);

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

@@ -12,12 +12,17 @@ import useContainerReady from "../_hooks/useContainerReady";
 import styles from "../index.module.scss";
 import * as echarts from "echarts";
 import { useLatestRef } from "../../../hooks/useLatestRef";
+import useShallowStable from "../../../hooks/useShallowStable";
 import { jsx as _jsx } from "react/jsx-runtime";
 var Common = function Common(props) {
   var className = props.className,
     style = props.style,
     onChart = props.onChart,
-    coreOption = _objectWithoutProperties(props, _excluded);
+    restOption = _objectWithoutProperties(props, _excluded);
+  // rest 解构出来的对象每次渲染都是新引用，直接进依赖数组会让 chartOption 的 memo
+  // 恒不命中 —— 父组件每渲染一次就重跑一次 setOption(notMerge)，动画重播、悬浮态被清掉。
+  // useShallowStable 让它回到值语义：内容浅相等就复用同一引用，真变了立刻透出新引用。
+  var coreOption = useShallowStable(restOption);
   var chartRef = useRef(null);
   var chartInstanceRef = useRef(null);
   // Defers `echarts.init` until the container has a box — see the hook for why

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

@@ -11,6 +11,7 @@ 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 useShallowStable from "../../../hooks/useShallowStable";
 import { jsx as _jsx } from "react/jsx-runtime";
 var Gauge = function Gauge(props) {
   var className = props.className,
@@ -29,7 +30,11 @@ var Gauge = function Gauge(props) {
     title = _ref.title,
     _ref$color = _ref.color,
     color = _ref$color === void 0 ? "#1675FB" : _ref$color,
-    coreSeries = _objectWithoutProperties(_ref, _excluded);
+    restSeries = _objectWithoutProperties(_ref, _excluded);
+  // rest 解构出来的对象每次渲染都是新引用，直接进依赖数组会让 chartOption 的 memo
+  // 恒不命中 —— 父组件每渲染一次就重跑一次 setOption(notMerge)，动画重播、悬浮态被清掉。
+  // useShallowStable 让它回到值语义：内容浅相等就复用同一引用，真变了立刻透出新引用。
+  var coreSeries = useShallowStable(restSeries);
   var chartRef = useRef(null);
   var chartInstanceRef = useRef(null);
   // Defers `echarts.init` until the container has a box — see the hook for why

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

@@ -21,7 +21,10 @@ import { createDefaultHeatmapXAxis, createDefaultHeatmapYAxis } from "../_utils/
 import { resolveChartChrome } from "../_utils/chartTheme";
 import useIsDark from "../../../hooks/useIsDark";
 import { useLatestRef } from "../../../hooks/useLatestRef";
+import useShallowStable from "../../../hooks/useShallowStable";
 import { jsx as _jsx } from "react/jsx-runtime";
+// 解构默认值写成字面量会每次渲染新建一个数组，进依赖数组就让 memo 恒不命中；提到模块级常量
+var DEFAULT_IN_RANGE_COLOR = ["#8BCCFB", "#75C3FB", "#5AB5F6", "#42AEFA", "#2DA1F5", "#0F89E1", "#056FBB", "#025794", "#0A4089"];
 var Heatmap = function Heatmap(props) {
   var className = props.className,
     style = props.style,
@@ -40,8 +43,12 @@ var Heatmap = function Heatmap(props) {
     onClick = props.onClick,
     zeroColor = props.zeroColor,
     _props$inRangeColor = props.inRangeColor,
-    inRangeColor = _props$inRangeColor === void 0 ? ["#8BCCFB", "#75C3FB", "#5AB5F6", "#42AEFA", "#2DA1F5", "#0F89E1", "#056FBB", "#025794", "#0A4089"] : _props$inRangeColor,
-    coreOption = _objectWithoutProperties(props, _excluded);
+    inRangeColor = _props$inRangeColor === void 0 ? DEFAULT_IN_RANGE_COLOR : _props$inRangeColor,
+    restOption = _objectWithoutProperties(props, _excluded);
+  // rest 解构出来的对象每次渲染都是新引用，直接进依赖数组会让 chartOption 的 memo
+  // 恒不命中 —— 父组件每渲染一次就重跑一次 setOption(notMerge)，动画重播、悬浮态被清掉。
+  // useShallowStable 让它回到值语义：内容浅相等就复用同一引用，真变了立刻透出新引用。
+  var coreOption = useShallowStable(restOption);
   var chartRef = useRef(null);
   var chartInstanceRef = useRef(null);
   // Defers `echarts.init` until the container has a box — see the hook for why

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

@@ -17,6 +17,7 @@ import { buildCartesianSeriesOptions, createDefaultCategoryXAxis, createDefaultV
 import { resolveChartChrome } from "../_utils/chartTheme";
 import useIsDark from "../../../hooks/useIsDark";
 import useLatestRef from "../../../hooks/useLatestRef";
+import useShallowStable from "../../../hooks/useShallowStable";
 import { jsx as _jsx } from "react/jsx-runtime";
 var ChartLine = function ChartLine(props) {
   var className = props.className,
@@ -45,7 +46,11 @@ var ChartLine = function ChartLine(props) {
     legendVisibleCount = _props$legendVisibleC === void 0 ? 8 : _props$legendVisibleC,
     _props$legendScrollIn = props.legendScrollInterval,
     legendScrollInterval = _props$legendScrollIn === void 0 ? 1500 : _props$legendScrollIn,
-    coreOption = _objectWithoutProperties(props, _excluded);
+    restOption = _objectWithoutProperties(props, _excluded);
+  // rest 解构出来的对象每次渲染都是新引用，直接进依赖数组会让 chartOption 的 memo
+  // 恒不命中 —— 父组件每渲染一次就重跑一次 setOption(notMerge)，动画重播、悬浮态被清掉。
+  // useShallowStable 让它回到值语义：内容浅相等就复用同一引用，真变了立刻透出新引用。
+  var coreOption = useShallowStable(restOption);
   var chartRef = useRef(null);
   var chartInstanceRef = useRef(null);
   // Defers `echarts.init` until the container has a box — see the hook for why

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

@@ -9,7 +9,15 @@ import { useMouseOverHandler, useGlobalOutHandler } from "./_hooks";
 import { getPie3DOption } from "./_utils/option";
 import styles from "../../index.module.scss";
 import { useLatestRef } from "../../../../hooks/useLatestRef";
+import useShallowStable from "../../../../hooks/useShallowStable";
 import { jsx as _jsx } from "react/jsx-runtime";
+// 解构默认值写成字面量会每次渲染新建一个对象，进依赖数组就让 memo 恒不命中；提到模块级常量
+var DEFAULT_TOOLTIP = {
+  show: false
+};
+var DEFAULT_LABEL = {
+  show: true
+};
 var ChartPie3D = function ChartPie3D(props) {
   var className = props.className,
     style = props.style,
@@ -33,18 +41,18 @@ var ChartPie3D = function ChartPie3D(props) {
     _props$yOffset = props.yOffset,
     yOffset = _props$yOffset === void 0 ? -0.2 : _props$yOffset,
     _props$tooltip = props.tooltip,
-    tooltip = _props$tooltip === void 0 ? {
-      show: false
-    } : _props$tooltip,
+    tooltip = _props$tooltip === void 0 ? DEFAULT_TOOLTIP : _props$tooltip,
     _props$label = props.label,
-    label = _props$label === void 0 ? {
-      show: true
-    } : _props$label,
+    label = _props$label === void 0 ? DEFAULT_LABEL : _props$label,
     _props$enableMouseCon = props.enableMouseControl,
     enableMouseControl = _props$enableMouseCon === void 0 ? false : _props$enableMouseCon,
     onChart = props.onChart,
     onClick = props.onClick,
-    coreOption = _objectWithoutProperties(props, _excluded);
+    restOption = _objectWithoutProperties(props, _excluded);
+  // rest 解构出来的对象每次渲染都是新引用，直接进依赖数组会让 chartOption 的 memo
+  // 恒不命中 —— 父组件每渲染一次就重跑一次 setOption(notMerge)，动画重播、悬浮态被清掉。
+  // useShallowStable 让它回到值语义：内容浅相等就复用同一引用，真变了立刻透出新引用。
+  var coreOption = useShallowStable(restOption);
   var chartRef = useRef(null);
   var chartInstanceRef = useRef(null);
   // Defers `echarts.init` until the container has a box — see the hook for why

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

@@ -20,7 +20,10 @@ import { autoScrollLegend } from "../chartUtils";
 import styles from "../index.module.scss";
 import ChartPie3D from "./Pie3D";
 import { useLatestRef } from "../../../hooks/useLatestRef";
+import useShallowStable from "../../../hooks/useShallowStable";
 import { jsx as _jsx } from "react/jsx-runtime";
+// 解构默认值写成字面量会每次渲染新建一个数组，进依赖数组就让 memo 恒不命中；提到模块级常量
+var EMPTY_EXTEND_SERIES = [];
 var ChartPie = function ChartPie(props) {
   var className = props.className,
     style = props.style,
@@ -32,7 +35,7 @@ var ChartPie = function ChartPie(props) {
     title = props.title,
     onChart = props.onChart,
     _props$extendSeries = props.extendSeries,
-    extendSeries = _props$extendSeries === void 0 ? [] : _props$extendSeries,
+    extendSeries = _props$extendSeries === void 0 ? EMPTY_EXTEND_SERIES : _props$extendSeries,
     onClick = props.onClick,
     _props$enableLegendAu = props.enableLegendAutoScroll,
     enableLegendAutoScroll = _props$enableLegendAu === void 0 ? false : _props$enableLegendAu,
@@ -48,7 +51,11 @@ var ChartPie = function ChartPie(props) {
     spanAngle = _props$spanAngle === void 0 ? 180 : _props$spanAngle,
     center = props.center,
     radius = props.radius,
-    coreOption = _objectWithoutProperties(props, _excluded);
+    restOption = _objectWithoutProperties(props, _excluded);
+  // rest 解构出来的对象每次渲染都是新引用，直接进依赖数组会让 chartOption 的 memo
+  // 恒不命中 —— 父组件每渲染一次就重跑一次 setOption(notMerge)，动画重播、悬浮态被清掉。
+  // useShallowStable 让它回到值语义：内容浅相等就复用同一引用，真变了立刻透出新引用。
+  var coreOption = useShallowStable(restOption);
   var chartRef = useRef(null);
   var chartInstanceRef = useRef(null);
   // Defers `echarts.init` until the container has a box — see the hook for why

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

@@ -11,7 +11,10 @@ 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 useShallowStable from "../../../hooks/useShallowStable";
 import { jsx as _jsx } from "react/jsx-runtime";
+// 解构默认值写成字面量会每次渲染新建一个数组，进依赖数组就让 memo 恒不命中；提到模块级常量
+var DEFAULT_COLOR = ["#00FFA3", "#00FFA3"];
 var Polar = function Polar(props) {
   var className = props.className,
     style = props.style,
@@ -26,8 +29,12 @@ var Polar = function Polar(props) {
     textStyle = props.textStyle,
     seriesData = props.seriesData,
     _props$color = props.color,
-    color = _props$color === void 0 ? ["#00FFA3", "#00FFA3"] : _props$color,
-    coreOption = _objectWithoutProperties(props, _excluded);
+    color = _props$color === void 0 ? DEFAULT_COLOR : _props$color,
+    restOption = _objectWithoutProperties(props, _excluded);
+  // rest 解构出来的对象每次渲染都是新引用，直接进依赖数组会让 chartOption 的 memo
+  // 恒不命中 —— 父组件每渲染一次就重跑一次 setOption(notMerge)，动画重播、悬浮态被清掉。
+  // useShallowStable 让它回到值语义：内容浅相等就复用同一引用，真变了立刻透出新引用。
+  var coreOption = useShallowStable(restOption);
   var chartRef = useRef(null);
   var chartInstanceRef = useRef(null);
   // Defers `echarts.init` until the container has a box — see the hook for why

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

@@ -17,6 +17,7 @@ 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 useShallowStable from "../../../hooks/useShallowStable";
 
 /** Single-indicator tooltip trigger mode
  * - `point`  triggers only when hovering data points/lines (native echarts item trigger)
@@ -38,7 +39,11 @@ var Radar = function Radar(props) {
     singleIndicatorTooltipProp = _props$singleIndicato === void 0 ? false : _props$singleIndicato,
     singleIndicatorMode = props.singleIndicatorMode,
     singleIndicatorHoverFill = props.singleIndicatorHoverFill,
-    coreOption = _objectWithoutProperties(props, _excluded);
+    restOption = _objectWithoutProperties(props, _excluded);
+  // rest 解构出来的对象每次渲染都是新引用，直接进依赖数组会让 chartOption 的 memo
+  // 恒不命中 —— 父组件每渲染一次就重跑一次 setOption(notMerge)，动画重播、悬浮态被清掉。
+  // useShallowStable 让它回到值语义：内容浅相等就复用同一引用，真变了立刻透出新引用。
+  var coreOption = useShallowStable(restOption);
   var chartRef = useRef(null);
   var chartInstanceRef = useRef(null);
   // Defers `echarts.init` until the container has a box — see the hook for why

package/es/components/Checkbox/CheckboxGroup/index.js

@@ -14,12 +14,15 @@ import styles from "./index.module.scss";
 import { jsx as _jsx } from "react/jsx-runtime";
 import { jsxs as _jsxs } from "react/jsx-runtime";
 var Group = Checkbox.Group;
+
+// 解构默认值写成字面量会每次渲染新建一个数组，进依赖数组就让 memo 恒不命中；提到模块级常量
+var EMPTY_OPTIONS = [];
 var CheckboxGroup = function CheckboxGroup(props) {
   var className = props.className,
     outline = props.outline,
     hasAll = props.hasAll,
     _props$options = props.options,
-    options = _props$options === void 0 ? [] : _props$options,
+    options = _props$options === void 0 ? EMPTY_OPTIONS : _props$options,
     value = props.value,
     onChange = props.onChange,
     _props$layout = props.layout,

package/es/components/FormItem/FormCodeMirror/index.js

@@ -22,6 +22,8 @@ import { Form } from "antd";
 import CodeMirror from "../../CodeMirror";
 import ItemContainer from "../ItemContainer";
 import { jsx as _jsx } from "react/jsx-runtime";
+// 解构默认值写成字面量会每次渲染新建一个数组，进依赖数组就让 memo 恒不命中；提到模块级常量
+var EMPTY_RULES = [];
 var FormCodeMirror = function FormCodeMirror(props) {
   var _componentProps$readO;
   var _props$componentProps = props.componentProps,
@@ -29,7 +31,7 @@ var FormCodeMirror = function FormCodeMirror(props) {
     itemClassName = props.className,
     disabled = props.disabled,
     _props$rules = props.rules,
-    rules = _props$rules === void 0 ? [] : _props$rules,
+    rules = _props$rules === void 0 ? EMPTY_RULES : _props$rules,
     name = props.name,
     formItemProps = _objectWithoutProperties(props, _excluded);
   var enableLint = componentProps.enableLint !== false;

package/es/components/FormItem/ItemContainer/index.js

@@ -24,10 +24,13 @@ import usePermissions from "../../../hooks/usePermissions";
 import { isLegacyHasSelectorBrowser } from "../../../utils/cssSupports";
 import { generateRandomStr } from "hsu-utils";
 import useLabelSize from "./_hooks/useLabelSize";
+import useShallowStable from "../../../hooks/useShallowStable";
 import useInputSize from "./_hooks/useInputSize";
 import { jsx as _jsx } from "react/jsx-runtime";
 import { Fragment as _Fragment } from "react/jsx-runtime";
 import { jsxs as _jsxs } from "react/jsx-runtime";
+// 解构默认值写成字面量会每次渲染新建一个对象，进依赖数组就让 memo 恒不命中；提到模块级常量
+var EMPTY_TIPS = {};
 var ItemContainer = function ItemContainer(props) {
   var children = props.children,
     className = props.className,
@@ -55,7 +58,7 @@ var ItemContainer = function ItemContainer(props) {
     label = props.label,
     labelRender = props.labelRender,
     _props$tips = props.tips,
-    tips = _props$tips === void 0 ? {} : _props$tips,
+    tips = _props$tips === void 0 ? EMPTY_TIPS : _props$tips,
     _props$horizontalAlig = props.horizontalAlignment,
     horizontalAlignment = _props$horizontalAlig === void 0 ? "start" : _props$horizontalAlig,
     _props$hideRequired = props.hideRequired,
@@ -80,7 +83,14 @@ var ItemContainer = function ItemContainer(props) {
   var _tips$icon = tips.icon,
     icon = _tips$icon === void 0 ? "material-symbols:help" : _tips$icon,
     iconClassName = tips.iconClassName,
-    tipsConfig = _objectWithoutProperties(tips, _excluded2);
+    restTipsConfig = _objectWithoutProperties(tips, _excluded2);
+  // rest 解构出来的对象每次渲染都是新引用，直接进依赖数组会让 memo 恒不命中。
+  // useShallowStable 让它回到值语义：内容浅相等就复用同一引用，真变了立刻透出新引用。
+  var tipsConfig = useShallowStable(restTipsConfig);
+  // memo 只需要知道「有没有配 tips」，把对象本身放进依赖数组等于按引用比：
+  // 消费方写内联 `tips={{ ... }}`（最常见的写法）就让 label 的 memo 恒不命中。
+  // 拆成布尔量后依赖回到值语义。
+  var hasTips = Object.keys(tips).length > 0;
   var _usePermissions = usePermissions(hasPermi),
     permitted = _usePermissions.permitted;
   var cls = useMemo(function () {
@@ -91,7 +101,7 @@ var ItemContainer = function ItemContainer(props) {
     if (hideLabel) {
       return undefined;
     }
-    return Object.keys(tips).length ? /*#__PURE__*/_jsxs(_Fragment, {
+    return hasTips ? /*#__PURE__*/_jsxs(_Fragment, {
       children: [/*#__PURE__*/_jsx("span", {
         className: classNames(styles.labelContent, labelClassName),
         children: /*#__PURE__*/_jsx("span", {
@@ -137,7 +147,7 @@ var ItemContainer = function ItemContainer(props) {
         children: labelExtra
       })]
     }) : undefined;
-  }, [tips, labelClassName, label, tipsConfig, icon, iconClassName, labelExtra, labelExtraClassName, labelEllipsis, labelBreak, hideLabel]);
+  }, [hasTips, labelClassName, label, tipsConfig, icon, iconClassName, labelExtra, labelExtraClassName, labelEllipsis, labelBreak, hideLabel]);
   var _useLabelSize = useLabelSize({
       labelWidth: labelWidth,
       labelHeight: labelHeight,
@@ -167,7 +177,7 @@ var ItemContainer = function ItemContainer(props) {
       required: required,
       message: requiredMsg !== null && requiredMsg !== void 0 ? requiredMsg : en ? "".concat(PlaceholderDictEn[type || "INPUT"]) : "".concat(PlaceholderDict[type || "INPUT"])
     }].concat(_toConsumableArray(rules)),
-    className: classNames(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty({}, cls, true), styles.formItem, true), className !== null && className !== void 0 ? className : "", true), styles[layout], layout), styles[requiredPosition], requiredPosition), styles.hideRequired, hideRequired), styles[horizontalAlignment], layout === "horizontal" && horizontalAlignment), styles.hasLabelContent, !!Object.keys(tips).length), styles.hideAdditiona, hideAdditiona), styles.legacyHasLabelExtra, legacyHasSelector && layout === "vertical" && !hideLabel && !!label && !!labelExtra && !Object.keys(tips).length)),
+    className: classNames(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty({}, cls, true), styles.formItem, true), className !== null && className !== void 0 ? className : "", true), styles[layout], layout), styles[requiredPosition], requiredPosition), styles.hideRequired, hideRequired), styles[horizontalAlignment], layout === "horizontal" && horizontalAlignment), styles.hasLabelContent, hasTips), styles.hideAdditiona, hideAdditiona), styles.legacyHasLabelExtra, legacyHasSelector && layout === "vertical" && !hideLabel && !!label && !!labelExtra && !hasTips)),
     colon: typeof colon === "boolean" ? colon : layout === "horizontal" && requiredPosition === "before",
     label: labelRender ? labelRender(_label) : _label,
     style: _objectSpread({

package/es/components/Operate/index.js

@@ -25,6 +25,9 @@ import classNames from "classnames";
 import moreImg from "./more.png";
 import { jsx as _jsx } from "react/jsx-runtime";
 import { jsxs as _jsxs } from "react/jsx-runtime";
+// 解构默认值写成字面量会每次渲染新建一个数组，进依赖数组就让 memo 恒不命中；提到模块级常量
+var EMPTY_MENU = [];
+
 /**
  * Render an icon
  * @param icon - Icon configuration
@@ -51,7 +54,7 @@ var Operate = function Operate(props) {
   var title = props.title,
     className = props.className,
     _props$menu = props.menu,
-    menu = _props$menu === void 0 ? [] : _props$menu,
+    menu = _props$menu === void 0 ? EMPTY_MENU : _props$menu,
     icon = props.icon,
     isDelete = props.delete,
     popconfirm = props.popconfirm,

package/es/components/Pagination/index.js

@@ -18,11 +18,13 @@ import styles from "./index.module.scss";
 import usePaginationSync from "./_hooks/usePaginationSync";
 import { jsx as _jsx } from "react/jsx-runtime";
 import { jsxs as _jsxs } from "react/jsx-runtime";
+// 解构默认值写成字面量会每次渲染新建一个数组，进依赖数组就让 memo 恒不命中；提到模块级常量
+var EMPTY_PAGE_SIZE_OPTIONS = [];
 var Pagination = function Pagination(props) {
   var _props$current, _props$pageSize2;
   var simple = props.simple,
     _props$pageSizeOption = props.pageSizeOptions,
-    pageSizeOptions = _props$pageSizeOption === void 0 ? [] : _props$pageSizeOption,
+    pageSizeOptions = _props$pageSizeOption === void 0 ? EMPTY_PAGE_SIZE_OPTIONS : _props$pageSizeOption,
     showSizeChanger = props.showSizeChanger,
     _onShowSizeChange = props.onShowSizeChange,
     _onChange = props.onChange,

package/es/components/Search/_hooks/useSearchCommon.js

@@ -18,6 +18,9 @@ import { useAdaptiveColumnNum } from "./useAdaptiveColumnNum";
 import { useSearchExpand } from "./useSearchExpand";
 import { cleanSearchData, calculateVisibleItems, calculateButtonGroupAndColumnWidth, shouldDisplayExtraItem } from "../_utils";
 import styles from "../index.module.scss";
+// 解构默认值写成字面量会每次渲染新建一个数组，进依赖数组就让 memo 恒不命中；提到模块级常量
+var EMPTY_SEARCH_ITEMS = [];
+
 /**
  * Extracts the common logic shared by all Search components
  */
@@ -25,7 +28,7 @@ export var useSearchCommon = function useSearchCommon(params) {
   var form = params.form,
     searchItems = params.searchItems,
     _params$moreSearchIte = params.moreSearchItems,
-    moreSearchItems = _params$moreSearchIte === void 0 ? [] : _params$moreSearchIte,
+    moreSearchItems = _params$moreSearchIte === void 0 ? EMPTY_SEARCH_ITEMS : _params$moreSearchIte,
     searchData = params.searchData,
     hasPermi = params.hasPermi,
     beforeButtonGroup = params.beforeButtonGroup,

package/es/components/Select/AutoCompleteSelect/index.js

@@ -27,6 +27,8 @@ import Icon from "../../Icon";
 import { isLegacyHasSelectorBrowser } from "../../../utils/cssSupports";
 import { jsx as _jsx } from "react/jsx-runtime";
 import { jsxs as _jsxs } from "react/jsx-runtime";
+// 解构默认值写成字面量会每次渲染新建一个数组，进依赖数组就让 memo 恒不命中；提到模块级常量
+var EMPTY_OPTIONS = [];
 var AutoCompleteSelect = function AutoCompleteSelect(props) {
   var prefix = props.prefix,
     suffix = props.suffix,
@@ -40,7 +42,7 @@ var AutoCompleteSelect = function AutoCompleteSelect(props) {
     customFilterOption = props.filterOption,
     onChange = props.onChange,
     _props$options = props.options,
-    options = _props$options === void 0 ? [] : _props$options,
+    options = _props$options === void 0 ? EMPTY_OPTIONS : _props$options,
     _props$placement = props.placement,
     placement = _props$placement === void 0 ? "bottomLeft" : _props$placement,
     onDropdownVisibleChange = props.onDropdownVisibleChange,

package/es/components/Spreadsheet/index.js

@@ -20,15 +20,21 @@ import { Equal, generateRandomStr } from "hsu-utils";
 import "x-data-spreadsheet/dist/xspreadsheet.css";
 import classNames from "classnames";
 import { stox } from "./xlsxspread";
+import useShallowStable from "../../hooks/useShallowStable";
 import { jsx as _jsx } from "react/jsx-runtime";
+// 解构默认值写成字面量会每次渲染新建一个对象，进依赖数组就让 effect 每渲染必重跑；提到模块级常量
+var EMPTY_X_OPTIONS = {};
 var Spreadsheet = function Spreadsheet(props) {
   var data = props.data,
     _props$xOptions = props.xOptions,
-    xOptions = _props$xOptions === void 0 ? {} : _props$xOptions,
+    xOptions = _props$xOptions === void 0 ? EMPTY_X_OPTIONS : _props$xOptions,
     className = props.className;
   var _xOptions$showBottomT = xOptions.showBottomTool,
     showBottomTool = _xOptions$showBottomT === void 0 ? true : _xOptions$showBottomT,
-    xOptionsRest = _objectWithoutProperties(xOptions, _excluded);
+    restXOptions = _objectWithoutProperties(xOptions, _excluded);
+  // rest 解构出来的对象每次渲染都是新引用，直接进依赖数组会让 memo 恒不命中。
+  // useShallowStable 让它回到值语义：内容浅相等就复用同一引用，真变了立刻透出新引用。
+  var xOptionsRest = useShallowStable(restXOptions);
   var ref = useRef(null);
   var containerRef = useRef(null);
   var id = useMemo(function () {

package/es/components/Table/_hooks/useTableColumns.js

@@ -22,6 +22,9 @@ import usePermissions from "../../../hooks/usePermissions";
 import { jsx as _jsx } from "react/jsx-runtime";
 import { Fragment as _Fragment } from "react/jsx-runtime";
 import { jsxs as _jsxs } from "react/jsx-runtime";
+// 解构默认值写成字面量会每次渲染新建一个数组，进依赖数组就让 memo 恒不命中；提到模块级常量
+var EMPTY_COLUMNS = [];
+
 // measureAlign columns: measured at 14px, consistent with the table body and autoWidth title measurement
 var MEASURE_ALIGN_FONT_SIZE = 14;
 // Canvas measureText only returns the advance width, about 1px narrower than the actual DOM rendering; add a 2px buffer to avoid squeezing the widest row
@@ -66,7 +69,7 @@ var getMeasureAlignWidth = function getMeasureAlignWidth(column, dataSource) {
 };
 var useTableColumns = function useTableColumns(params) {
   var _params$columns = params.columns,
-    columns = _params$columns === void 0 ? [] : _params$columns,
+    columns = _params$columns === void 0 ? EMPTY_COLUMNS : _params$columns,
     scroll = params.scroll,
     autoWidth = params.autoWidth,
     dataSource = params.dataSource,

package/es/components/Tree/_hooks/useTreeState.js

@@ -4,7 +4,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 { useEffect, useState, useMemo, useRef } from "react";
+import { useEffect, useState, useMemo, useRef, useCallback } from "react";
 import { Equal } from "hsu-utils";
 import { normalizeCheckedKeys } from "../_utils/normalizeCheckedKeys";
 
@@ -38,11 +38,14 @@ export var useExpandedKeys = function useExpandedKeys(expandedKeysProps, default
     }
   }, [defaultExpandedKeys, expandedKeysProps]);
 
-  // Wrap setExpandedKeys to mark that the user has manually interacted
-  var handleSetExpandedKeys = function handleSetExpandedKeys(keys) {
+  // Wrap setExpandedKeys to mark that the user has manually interacted.
+  // 必须 useCallback：这个函数被 Tree 的 handleExpand 当依赖用，
+  // 每渲染新建一个就让那个 useCallback 恒不命中——展开回调每渲染换引用透给 antd Tree。
+  // 函数体只碰 ref 和状态 setter，两者都恒定，所以依赖数组是空的。
+  var handleSetExpandedKeys = useCallback(function (keys) {
     hasUserInteractedRef.current = true;
     setExpandedKeys(keys);
-  };
+  }, []);
   return [expandedKeys, handleSetExpandedKeys];
 };
 

package/es/components/Tree/index.js

@@ -26,9 +26,12 @@ import { useClearNodeTitle } from "./_hooks/useClearNodeTitle";
 import { getExpandedKeysByLevel, getNodePath } from "./_utils";
 import TextEllipsis from "../TextEllipsis";
 import usePermissions from "../../hooks/usePermissions";
+import useShallowStable from "../../hooks/useShallowStable";
 import { isLegacyHasSelectorBrowser } from "../../utils/cssSupports";
 import { jsx as _jsx } from "react/jsx-runtime";
 import { jsxs as _jsxs } from "react/jsx-runtime";
+// 解构默认值写成字面量会每次渲染新建一个数组，进依赖数组就让 memo 恒不命中；提到模块级常量
+var EMPTY_TREE_DATA = [];
 var Tree = function Tree(props) {
   var title = props.title,
     _titleRender = props.titleRender,
@@ -38,7 +41,7 @@ var Tree = function Tree(props) {
     className = props.className,
     search = props.search,
     _props$treeData = props.treeData,
-    treeData = _props$treeData === void 0 ? [] : _props$treeData,
+    treeData = _props$treeData === void 0 ? EMPTY_TREE_DATA : _props$treeData,
     onChange = props.onChange,
     onCheck = props.onCheck,
     onSelect = props.onSelect,
@@ -61,7 +64,10 @@ var Tree = function Tree(props) {
     _props$allowDeselect = props.allowDeselect,
     allowDeselect = _props$allowDeselect === void 0 ? true : _props$allowDeselect,
     titleSearchBarClassName = props.titleSearchBarClassName,
-    treeConfig = _objectWithoutProperties(props, _excluded);
+    restTreeConfig = _objectWithoutProperties(props, _excluded);
+  // rest 解构出来的对象每次渲染都是新引用，直接进依赖数组会让 memo 恒不命中。
+  // useShallowStable 让它回到值语义：内容浅相等就复用同一引用，真变了立刻透出新引用。
+  var treeConfig = useShallowStable(restTreeConfig);
   var _usePermissions = usePermissions(hasPermi),
     permitted = _usePermissions.permitted;
   var legacyHasSelector = isLegacyHasSelectorBrowser();

package/es/hooks/useShallowStable.d.ts

@@ -0,0 +1,32 @@
+/**
+ * 把一个**内容没变、但每次渲染都新建**的对象收敛成**引用恒定**的对象：
+ * 浅比较（自有键 ＋ `Object.is` 比值）相等就继续返回上一次那个引用。
+ *
+ * 用途只有一个：让它可以直接进 `useMemo` / `useEffect` 的依赖数组。
+ *
+ * React 的依赖数组按 `Object.is` 比引用，所以依赖里只要混进一个「每次渲染都新建
+ * 的对象」，memo 就**恒不命中**、effect 就**每渲染必重跑**。组件内部最容易出现
+ * 这种对象的地方是 rest 解构：
+ *
+ * ```tsx
+ * const { className, style, ...coreOption } = props; // coreOption 每次都是新对象
+ * const option = useMemo(() => ({ ...coreOption }), [coreOption]); // 永远不命中
+ * ```
+ *
+ * 消费方就算把每一个 prop 都 memo 好，也躲不掉——新对象是组件自己建的。
+ * 正确写法是让这个对象回到值语义：
+ *
+ * ```tsx
+ * const { className, style, ...restOption } = props;
+ * const coreOption = useShallowStable(restOption); // 内容不变 → 引用不变
+ * ```
+ *
+ * 注意这**不是**「缓存结果跳过副作用」：memo 该重算时照样重算、effect 该重跑时
+ * 照样重跑——只要 rest 里任何一个值真的变了，浅比较就不相等，新引用立刻透出去。
+ *
+ * 渲染期间读写 ref 的安全性：并发渲染下被丢弃的那次渲染可能已经把 ref 换成了它
+ * 自己的对象，但那个对象与当次 props 浅相等，所以后续渲染拿到的引用**内容永远
+ * 与当前 props 一致**，不会读到过期值。
+ */
+export declare function useShallowStable<T extends object>(value: T): T;
+export default useShallowStable;

package/es/hooks/useShallowStable.js

@@ -0,0 +1,54 @@
+import { useRef } from "react";
+
+/**
+ * 把一个**内容没变、但每次渲染都新建**的对象收敛成**引用恒定**的对象：
+ * 浅比较（自有键 ＋ `Object.is` 比值）相等就继续返回上一次那个引用。
+ *
+ * 用途只有一个：让它可以直接进 `useMemo` / `useEffect` 的依赖数组。
+ *
+ * React 的依赖数组按 `Object.is` 比引用，所以依赖里只要混进一个「每次渲染都新建
+ * 的对象」，memo 就**恒不命中**、effect 就**每渲染必重跑**。组件内部最容易出现
+ * 这种对象的地方是 rest 解构：
+ *
+ * ```tsx
+ * const { className, style, ...coreOption } = props; // coreOption 每次都是新对象
+ * const option = useMemo(() => ({ ...coreOption }), [coreOption]); // 永远不命中
+ * ```
+ *
+ * 消费方就算把每一个 prop 都 memo 好，也躲不掉——新对象是组件自己建的。
+ * 正确写法是让这个对象回到值语义：
+ *
+ * ```tsx
+ * const { className, style, ...restOption } = props;
+ * const coreOption = useShallowStable(restOption); // 内容不变 → 引用不变
+ * ```
+ *
+ * 注意这**不是**「缓存结果跳过副作用」：memo 该重算时照样重算、effect 该重跑时
+ * 照样重跑——只要 rest 里任何一个值真的变了，浅比较就不相等，新引用立刻透出去。
+ *
+ * 渲染期间读写 ref 的安全性：并发渲染下被丢弃的那次渲染可能已经把 ref 换成了它
+ * 自己的对象，但那个对象与当次 props 浅相等，所以后续渲染拿到的引用**内容永远
+ * 与当前 props 一致**，不会读到过期值。
+ */
+export function useShallowStable(value) {
+  var ref = useRef(value);
+  if (!shallowEqual(ref.current, value)) {
+    ref.current = value;
+  }
+  return ref.current;
+}
+function shallowEqual(a, b) {
+  if (Object.is(a, b)) return true;
+  var aKeys = Object.keys(a);
+  var bKeys = Object.keys(b);
+  if (aKeys.length !== bKeys.length) return false;
+  for (var _i = 0, _aKeys = aKeys; _i < _aKeys.length; _i++) {
+    var key = _aKeys[_i];
+    if (!Object.prototype.hasOwnProperty.call(b, key)) return false;
+    if (!Object.is(a[key], b[key])) {
+      return false;
+    }
+  }
+  return true;
+}
+export default useShallowStable;