@hsu-react/ui 2.5.6 → 2.5.7

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/lib/components/Checkbox/CheckboxGroup/index.js

@@ -13,12 +13,15 @@ function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { de
 function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function (e) { return e ? t : r; })(e); }
 function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != typeof e && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && Object.prototype.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
 const Group = _antd.Checkbox.Group;
+
+// 解构默认值写成字面量会每次渲染新建一个数组，进依赖数组就让 memo 恒不命中；提到模块级常量
+const EMPTY_OPTIONS = [];
 const CheckboxGroup = props => {
   const {
     className,
     outline,
     hasAll,
-    options = [],
+    options = EMPTY_OPTIONS,
     value,
     onChange,
     layout = "horizontal",

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

@@ -10,12 +10,14 @@ var _CodeMirror = _interopRequireDefault(require("../../CodeMirror"));
 var _ItemContainer = _interopRequireDefault(require("../ItemContainer"));
 var _jsxRuntime = require("react/jsx-runtime");
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+// 解构默认值写成字面量会每次渲染新建一个数组，进依赖数组就让 memo 恒不命中；提到模块级常量
+const EMPTY_RULES = [];
 const FormCodeMirror = props => {
   const {
     componentProps = {},
     className: itemClassName,
     disabled,
-    rules = [],
+    rules = EMPTY_RULES,
     name,
     ...formItemProps
   } = props;

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

@@ -14,11 +14,14 @@ var _usePermissions = _interopRequireDefault(require("../../../hooks/usePermissi
 var _cssSupports = require("../../../utils/cssSupports");
 var _hsuUtils = require("hsu-utils");
 var _useLabelSize = _interopRequireDefault(require("./_hooks/useLabelSize"));
+var _useShallowStable = _interopRequireDefault(require("../../../hooks/useShallowStable"));
 var _useInputSize = _interopRequireDefault(require("./_hooks/useInputSize"));
 var _jsxRuntime = require("react/jsx-runtime");
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function (e) { return e ? t : r; })(e); }
 function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != typeof e && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && Object.prototype.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
+// 解构默认值写成字面量会每次渲染新建一个对象，进依赖数组就让 memo 恒不命中；提到模块级常量
+const EMPTY_TIPS = {};
 const ItemContainer = props => {
   const {
     children,
@@ -42,7 +45,7 @@ const ItemContainer = props => {
     colon,
     label,
     labelRender,
-    tips = {},
+    tips = EMPTY_TIPS,
     horizontalAlignment = "start",
     hideRequired = false,
     labelClassName,
@@ -61,8 +64,15 @@ const ItemContainer = props => {
   const {
     icon = "material-symbols:help",
     iconClassName,
-    ...tipsConfig
+    ...restTipsConfig
   } = tips;
+  // rest 解构出来的对象每次渲染都是新引用，直接进依赖数组会让 memo 恒不命中。
+  // useShallowStable 让它回到值语义：内容浅相等就复用同一引用，真变了立刻透出新引用。
+  const tipsConfig = (0, _useShallowStable.default)(restTipsConfig);
+  // memo 只需要知道「有没有配 tips」，把对象本身放进依赖数组等于按引用比：
+  // 消费方写内联 `tips={{ ... }}`（最常见的写法）就让 label 的 memo 恒不命中。
+  // 拆成布尔量后依赖回到值语义。
+  const hasTips = Object.keys(tips).length > 0;
   const {
     permitted
   } = (0, _usePermissions.default)(hasPermi);
@@ -72,7 +82,7 @@ const ItemContainer = props => {
     if (hideLabel) {
       return undefined;
     }
-    return Object.keys(tips).length ? /*#__PURE__*/(0, _jsxRuntime.jsxs)(_jsxRuntime.Fragment, {
+    return hasTips ? /*#__PURE__*/(0, _jsxRuntime.jsxs)(_jsxRuntime.Fragment, {
       children: [/*#__PURE__*/(0, _jsxRuntime.jsx)("span", {
         className: (0, _classnames.default)(_indexModule.default.labelContent, labelClassName),
         children: /*#__PURE__*/(0, _jsxRuntime.jsx)("span", {
@@ -124,7 +134,7 @@ const 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]);
   const {
     width: _labelWidth,
     height: _labelHeight,
@@ -165,9 +175,9 @@ const ItemContainer = props => {
       [_indexModule.default[requiredPosition]]: requiredPosition,
       [_indexModule.default.hideRequired]: hideRequired,
       [_indexModule.default[horizontalAlignment]]: layout === "horizontal" && horizontalAlignment,
-      [_indexModule.default.hasLabelContent]: !!Object.keys(tips).length,
+      [_indexModule.default.hasLabelContent]: hasTips,
       [_indexModule.default.hideAdditiona]: hideAdditiona,
-      [_indexModule.default.legacyHasLabelExtra]: legacyHasSelector && layout === "vertical" && !hideLabel && !!label && !!labelExtra && !Object.keys(tips).length
+      [_indexModule.default.legacyHasLabelExtra]: legacyHasSelector && layout === "vertical" && !hideLabel && !!label && !!labelExtra && !hasTips
     }),
     colon: typeof colon === "boolean" ? colon : layout === "horizontal" && requiredPosition === "before",
     label: labelRender ? labelRender(_label) : _label,

package/lib/components/Operate/index.js

@@ -18,6 +18,9 @@ var _jsxRuntime = require("react/jsx-runtime");
 function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function (e) { return e ? t : r; })(e); }
 function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != typeof e && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && Object.prototype.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+// 解构默认值写成字面量会每次渲染新建一个数组，进依赖数组就让 memo 恒不命中；提到模块级常量
+const EMPTY_MENU = [];
+
 /**
  * Render an icon
  * @param icon - Icon configuration
@@ -44,7 +47,7 @@ const Operate = props => {
   const {
     title,
     className,
-    menu = [],
+    menu = EMPTY_MENU,
     icon,
     delete: isDelete,
     popconfirm,

package/lib/components/Pagination/index.js

@@ -14,10 +14,12 @@ var _jsxRuntime = require("react/jsx-runtime");
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function (e) { return e ? t : r; })(e); }
 function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != typeof e && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && Object.prototype.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
+// 解构默认值写成字面量会每次渲染新建一个数组，进依赖数组就让 memo 恒不命中；提到模块级常量
+const EMPTY_PAGE_SIZE_OPTIONS = [];
 const Pagination = props => {
   const {
     simple,
-    pageSizeOptions = [],
+    pageSizeOptions = EMPTY_PAGE_SIZE_OPTIONS,
     showSizeChanger,
     onShowSizeChange,
     onChange,

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

@@ -15,6 +15,9 @@ var _useSearchExpand = require("./useSearchExpand");
 var _utils = require("../_utils");
 var _indexModule = _interopRequireDefault(require("../index.module.scss"));
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+// 解构默认值写成字面量会每次渲染新建一个数组，进依赖数组就让 memo 恒不命中；提到模块级常量
+const EMPTY_SEARCH_ITEMS = [];
+
 /**
  * Extracts the common logic shared by all Search components
  */
@@ -22,7 +25,7 @@ const useSearchCommon = params => {
   const {
     form,
     searchItems,
-    moreSearchItems = [],
+    moreSearchItems = EMPTY_SEARCH_ITEMS,
     searchData,
     hasPermi,
     beforeButtonGroup,

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

@@ -19,6 +19,8 @@ var _jsxRuntime = require("react/jsx-runtime");
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function (e) { return e ? t : r; })(e); }
 function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != typeof e && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && Object.prototype.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
+// 解构默认值写成字面量会每次渲染新建一个数组，进依赖数组就让 memo 恒不命中；提到模块级常量
+const EMPTY_OPTIONS = [];
 const AutoCompleteSelect = props => {
   const {
     prefix,
@@ -32,7 +34,7 @@ const AutoCompleteSelect = props => {
     popupClassName,
     filterOption: customFilterOption,
     onChange,
-    options = [],
+    options = EMPTY_OPTIONS,
     placement = "bottomLeft",
     onDropdownVisibleChange,
     popupMatchSelectWidth,

package/lib/components/Spreadsheet/index.js

@@ -11,20 +11,26 @@ var _hsuUtils = require("hsu-utils");
 require("x-data-spreadsheet/dist/xspreadsheet.css");
 var _classnames = _interopRequireDefault(require("classnames"));
 var _xlsxspread = require("./xlsxspread");
+var _useShallowStable = _interopRequireDefault(require("../../hooks/useShallowStable"));
 var _jsxRuntime = require("react/jsx-runtime");
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function (e) { return e ? t : r; })(e); }
 function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != typeof e && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && Object.prototype.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
+// 解构默认值写成字面量会每次渲染新建一个对象，进依赖数组就让 effect 每渲染必重跑；提到模块级常量
+const EMPTY_X_OPTIONS = {};
 const Spreadsheet = props => {
   const {
     data,
-    xOptions = {},
+    xOptions = EMPTY_X_OPTIONS,
     className
   } = props;
   const {
     showBottomTool = true,
-    ...xOptionsRest
+    ...restXOptions
   } = xOptions;
+  // rest 解构出来的对象每次渲染都是新引用，直接进依赖数组会让 memo 恒不命中。
+  // useShallowStable 让它回到值语义：内容浅相等就复用同一引用，真变了立刻透出新引用。
+  const xOptionsRest = (0, _useShallowStable.default)(restXOptions);
   const ref = (0, _react.useRef)(null);
   const containerRef = (0, _react.useRef)(null);
   const id = (0, _react.useMemo)(() => (0, _hsuUtils.generateRandomStr)(10), []);

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

@@ -15,6 +15,9 @@ var _tableUtils = require("../_utils/tableUtils");
 var _usePermissions = _interopRequireDefault(require("../../../hooks/usePermissions"));
 var _jsxRuntime = require("react/jsx-runtime");
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+// 解构默认值写成字面量会每次渲染新建一个数组，进依赖数组就让 memo 恒不命中；提到模块级常量
+const EMPTY_COLUMNS = [];
+
 // measureAlign columns: measured at 14px, consistent with the table body and autoWidth title measurement
 const 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
@@ -56,7 +59,7 @@ const getMeasureAlignWidth = (column, dataSource) => {
 };
 const useTableColumns = params => {
   const {
-    columns = [],
+    columns = EMPTY_COLUMNS,
     scroll,
     autoWidth,
     dataSource,

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

@@ -34,11 +34,14 @@ const useExpandedKeys = (expandedKeysProps, defaultExpandedKeys) => {
     }
   }, [defaultExpandedKeys, expandedKeysProps]);
 
-  // Wrap setExpandedKeys to mark that the user has manually interacted
-  const handleSetExpandedKeys = keys => {
+  // Wrap setExpandedKeys to mark that the user has manually interacted.
+  // 必须 useCallback：这个函数被 Tree 的 handleExpand 当依赖用，
+  // 每渲染新建一个就让那个 useCallback 恒不命中——展开回调每渲染换引用透给 antd Tree。
+  // 函数体只碰 ref 和状态 setter，两者都恒定，所以依赖数组是空的。
+  const handleSetExpandedKeys = (0, _react.useCallback)(keys => {
     hasUserInteractedRef.current = true;
     setExpandedKeys(keys);
-  };
+  }, []);
   return [expandedKeys, handleSetExpandedKeys];
 };
 

package/lib/components/Tree/index.js

@@ -17,11 +17,14 @@ var _useClearNodeTitle = require("./_hooks/useClearNodeTitle");
 var _utils = require("./_utils");
 var _TextEllipsis = _interopRequireDefault(require("../TextEllipsis"));
 var _usePermissions = _interopRequireDefault(require("../../hooks/usePermissions"));
+var _useShallowStable = _interopRequireDefault(require("../../hooks/useShallowStable"));
 var _cssSupports = require("../../utils/cssSupports");
 var _jsxRuntime = require("react/jsx-runtime");
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function (e) { return e ? t : r; })(e); }
 function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != typeof e && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && Object.prototype.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
+// 解构默认值写成字面量会每次渲染新建一个数组，进依赖数组就让 memo 恒不命中；提到模块级常量
+const EMPTY_TREE_DATA = [];
 const Tree = props => {
   const {
     title,
@@ -31,7 +34,7 @@ const Tree = props => {
     titleClassName,
     className,
     search,
-    treeData = [],
+    treeData = EMPTY_TREE_DATA,
     onChange,
     onCheck,
     onSelect,
@@ -52,8 +55,11 @@ const Tree = props => {
     onSelectPath,
     allowDeselect = true,
     titleSearchBarClassName,
-    ...treeConfig
+    ...restTreeConfig
   } = props;
+  // rest 解构出来的对象每次渲染都是新引用，直接进依赖数组会让 memo 恒不命中。
+  // useShallowStable 让它回到值语义：内容浅相等就复用同一引用，真变了立刻透出新引用。
+  const treeConfig = (0, _useShallowStable.default)(restTreeConfig);
   const {
     permitted
   } = (0, _usePermissions.default)(hasPermi);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hsu-react/ui",
-  "version": "2.5.6",
+  "version": "2.5.7",
   "description": "一套基于 React + Ant Design 的中后台业务组件库",
   "license": "MIT",
   "type": "module",