@hsu-react/ui 2.5.6 → 2.5.8

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/Modal/index.d.ts

@@ -6,6 +6,18 @@ export interface ModalProps extends AntdModalProps {
     edgeDetection?: boolean;
     full?: boolean;
     titleButtonGroup?: ButtonProps[];
+    /**
+     * 高度**下界**。给「内容要等接口回来才画得出」的弹窗用：不给下界的话，
+     * 打开那一刻只有标题栏那么高，数据回来再撑开 —— 视觉上跳一下。
+     *
+     * - `true`：用标准档（`modalMinHeight`，700px），后台详情 / 列表 / 记录类弹窗都用它
+     * - 数字：px；字符串：原样当 CSS 长度
+     * - 不传：维持内容自适应 —— **短表单不要传**，否则平白留出一大片空白
+     *
+     * 它只是下界：内容更高照常撑开、照常滚动；并且在样式里与 `90vh` 取小，
+     * 矮窗口下不会被顶出屏幕。
+     */
+    minHeight?: number | string | boolean;
 }
 interface ModalFC extends React.FC<ModalProps> {
     confirm: typeof AntdModal.confirm;

package/es/components/Modal/index.js

@@ -1,5 +1,5 @@
 function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
-var _excluded = ["moveable", "className", "classNames", "open", "onCancel", "onOk", "afterClose", "edgeDetection", "full", "destroyOnClose", "destroyOnHidden", "footer", "title", "titleButtonGroup"];
+var _excluded = ["moveable", "className", "classNames", "styles", "minHeight", "open", "onCancel", "onOk", "afterClose", "edgeDetection", "full", "destroyOnClose", "destroyOnHidden", "footer", "title", "titleButtonGroup"];
 function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
 function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
 function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
@@ -14,14 +14,23 @@ import { useModalElements, useModalDrag } from "./_hooks";
 import Button from "../Button";
 import { mergeSemantic } from "../../utils/semantic";
 import { modalFuncs } from "../../feedback";
+import { modalMinHeight } from "../../styles/tokens";
 import { jsx as _jsx } from "react/jsx-runtime";
 import { Fragment as _Fragment } from "react/jsx-runtime";
 import { jsxs as _jsxs } from "react/jsx-runtime";
+/** `minHeight` prop → CSS 长度。`true` 走标准档，`false` / 不传等于不设下界 */
+var resolveMinHeight = function resolveMinHeight(minHeight) {
+  if (minHeight === undefined || minHeight === false) return undefined;
+  if (minHeight === true) return "".concat(modalMinHeight, "px");
+  return typeof minHeight === "number" ? "".concat(minHeight, "px") : minHeight;
+};
 var Modal = function Modal(props) {
   var _props$moveable = props.moveable,
     moveable = _props$moveable === void 0 ? true : _props$moveable,
     className = props.className,
     classNames = props.classNames,
+    outerStyles = props.styles,
+    minHeight = props.minHeight,
     open = props.open,
     onCancel = props.onCancel,
     onOk = props.onOk,
@@ -65,6 +74,7 @@ var Modal = function Modal(props) {
   var handleOk = function handleOk(e) {
     onOk === null || onOk === void 0 || onOk(e);
   };
+  var resolvedMinHeight = resolveMinHeight(minHeight);
   return /*#__PURE__*/_jsx(AntdModal, _objectSpread(_objectSpread({
     centered: true
   }, moadlConfig), {}, {
@@ -90,6 +100,17 @@ var Modal = function Modal(props) {
         body: "".concat(styles.body, " ").concat((_outer$body = outer.body) !== null && _outer$body !== void 0 ? _outer$body : ""),
         footer: "".concat(styles.footer, " ").concat((_outer$footer = outer.footer) !== null && _outer$footer !== void 0 ? _outer$footer : "", " ").concat(footer === false ? styles.noFooter : "")
       });
+    })
+    /* 下界通过 CSS 变量交给样式表，而不是直接写 `minHeight` 内联样式：
+       clamp（与 90vh 取小）必须在 CSS 里做——`min-height` 在 CSS 里赢过
+       `max-height`，内联写死的话矮窗口会被顶出屏幕 */,
+    styles: mergeSemantic(outerStyles, function (outer) {
+      var _outer$container2;
+      return _objectSpread(_objectSpread({}, outer), {}, {
+        container: _objectSpread(_objectSpread({}, (_outer$container2 = outer.container) !== null && _outer$container2 !== void 0 ? _outer$container2 : {}), resolvedMinHeight ? {
+          "--vita-modal-min-height": resolvedMinHeight
+        } : {})
+      });
     }),
     footer: footer,
     afterClose: function afterClose() {

package/es/components/Modal/index.module.scss

@@ -31,6 +31,13 @@
     width: 100%;
     height: 100%;
     max-height: 90vh;
+    // 高度下界，由 `<Modal minHeight>` 写入 `--vita-modal-min-height`（不传就是 0）。
+    // 内容异步加载的弹窗不给下界的话，打开那一刻只有标题栏那么高，数据回来再撑开。
+    //
+    // 必须在这里与 90vh 取小：CSS 里 `min-height` 的优先级高于 `max-height`，
+    // 直接写 `min-height: 700px` 会让上面那行 `max-height: 90vh` 在矮窗口上失效，
+    // 弹窗被顶出屏幕。
+    min-height: min(var(--vita-modal-min-height, 0px), 90vh);
     padding: 0px 0px 15px;
   }
 

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/layout/Menu/index.module.scss

@@ -28,6 +28,38 @@
     overflow-y: auto;
   }
 
+  /* ===== 滚动条占位不许吃掉菜单项的内缩 =====
+     上面那条规则把「谁滚」定在了菜单根上，但没有把几何契约收完：滚动条一旦
+     **实占宽度**（消费方常见做法：槽宽恒定、只切 thumb 颜色，这样悬浮时不抖），
+     它就从菜单根的内容盒里切走一条 —— 而菜单项的左右外边距量的正是这个内容盒。
+     于是展开子菜单、菜单一超高，右边多出一条空白，左边纹丝不动：
+
+       展开前 菜单项 8..220（左留白 8 / 右留白 10）
+       展开后 菜单项 8..206（左留白 8 / 右留白 24）← 展开的那一项看着「右边距变大了」
+
+     `scrollbar-gutter: stable both-edges` 把这条槽**两侧对称保留**，且不论当下滚不滚
+     都保留：左右留白从此相等，展开 / 收起也不再有宽度变化（连带把「展开那一瞬内容
+     重排」一并去掉）。槽宽由浏览器按该元素实际的滚动条算，**不是写死的 14px** ——
+     消费方把滚动条改窄改宽，留白跟着变。
+
+     配套把菜单项自己的左右外边距清零：留白改由这条槽提供，不再叠加。不清的话
+     留白变成 `8 + 槽宽`（实测 22/24），230px 的侧栏里「MCP 连接器」直接被截断。
+     纵向节奏与嵌套缩进不受影响 —— antd 的行内缩进走的是 padding，不是 margin。
+
+     `@supports` 兜底：不认这个属性的浏览器维持原样，不会两头落空。 */
+  @supports (scrollbar-gutter: stable both-edges) {
+    &:global(.ant-menu-inline) {
+      scrollbar-gutter: stable both-edges;
+
+      :global(.ant-menu-item),
+      :global(.ant-menu-submenu-title) {
+        width: 100%;
+
+        margin-inline: 0px;
+      }
+    }
+  }
+
   /* 子菜单在展开 / 收起动画期间被 rc-motion 逐帧改高度。antd 的
      `.ant-motion-collapse` 自带 overflow hidden，这里补的是**动画结束、类名摘掉
      之后**那一帧：此时 ul 的高度刚回到 auto，若父级恰好差几像素，浏览器会先画出

package/es/styles/tokens.d.ts

@@ -93,6 +93,16 @@ export declare const modalWidth: {
     md: number;
     lg: number;
 };
+/**
+ * 内容异步加载的弹窗的**高度下界**（`<Modal minHeight>` 的默认档）。
+ *
+ * 取 700 不是拍的：`Panel.List.Modal` 从一开始就把自己钉在 `height: 700px`，那是
+ * 「搜索行 ＋ 工具条 ＋ 表头 ＋ 十行左右 ＋ 分页」放得下的高度。详情 / 消息 / 记录这类
+ * 弹窗与它同处一套后台，用同一个下界，纵向节奏才是一套的。
+ *
+ * 它只是**下界**：内容更高照常撑开，并且在 CSS 里与 `90vh` 取小，矮窗口不会被顶出屏幕。
+ */
+export declare const modalMinHeight: number;
 /**
  * 断点。与 `styles/_responsive.scss` 的 mixin 同源，所以 JS 判断不会和 CSS 媒体查询错开。
  */

package/es/styles/tokens.js

@@ -63,6 +63,17 @@ export var controlTokens = raw.control;
  */
 export var modalWidth = raw.modalWidth;
 
+/**
+ * 内容异步加载的弹窗的**高度下界**（`<Modal minHeight>` 的默认档）。
+ *
+ * 取 700 不是拍的：`Panel.List.Modal` 从一开始就把自己钉在 `height: 700px`，那是
+ * 「搜索行 ＋ 工具条 ＋ 表头 ＋ 十行左右 ＋ 分页」放得下的高度。详情 / 消息 / 记录这类
+ * 弹窗与它同处一套后台，用同一个下界，纵向节奏才是一套的。
+ *
+ * 它只是**下界**：内容更高照常撑开，并且在 CSS 里与 `90vh` 取小，矮窗口不会被顶出屏幕。
+ */
+export var modalMinHeight = raw.modalMinHeight;
+
 /**
  * 断点。与 `styles/_responsive.scss` 的 mixin 同源，所以 JS 判断不会和 CSS 媒体查询错开。
  */

package/es/styles/tokens.json

@@ -72,6 +72,7 @@
     "md": 800,
     "lg": 1200
   },
+  "modalMinHeight": 700,
   "breakpoint": {
     "sm": 640,
     "md": 768,

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/Modal/index.d.ts

@@ -6,6 +6,18 @@ export interface ModalProps extends AntdModalProps {
     edgeDetection?: boolean;
     full?: boolean;
     titleButtonGroup?: ButtonProps[];
+    /**
+     * 高度**下界**。给「内容要等接口回来才画得出」的弹窗用：不给下界的话，
+     * 打开那一刻只有标题栏那么高，数据回来再撑开 —— 视觉上跳一下。
+     *
+     * - `true`：用标准档（`modalMinHeight`，700px），后台详情 / 列表 / 记录类弹窗都用它
+     * - 数字：px；字符串：原样当 CSS 长度
+     * - 不传：维持内容自适应 —— **短表单不要传**，否则平白留出一大片空白
+     *
+     * 它只是下界：内容更高照常撑开、照常滚动；并且在样式里与 `90vh` 取小，
+     * 矮窗口下不会被顶出屏幕。
+     */
+    minHeight?: number | string | boolean;
 }
 interface ModalFC extends React.FC<ModalProps> {
     confirm: typeof AntdModal.confirm;

package/lib/components/Modal/index.js

@@ -11,13 +11,22 @@ var _hooks = require("./_hooks");
 var _Button = _interopRequireDefault(require("../Button"));
 var _semantic = require("../../utils/semantic");
 var _feedback = require("../../feedback");
+var _tokens = require("../../styles/tokens");
 var _jsxRuntime = require("react/jsx-runtime");
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+/** `minHeight` prop → CSS 长度。`true` 走标准档，`false` / 不传等于不设下界 */
+const resolveMinHeight = minHeight => {
+  if (minHeight === undefined || minHeight === false) return undefined;
+  if (minHeight === true) return `${_tokens.modalMinHeight}px`;
+  return typeof minHeight === "number" ? `${minHeight}px` : minHeight;
+};
 const Modal = props => {
   const {
     moveable = true,
     className,
     classNames,
+    styles: outerStyles,
+    minHeight,
     open,
     onCancel,
     onOk,
@@ -62,6 +71,7 @@ const Modal = props => {
   const handleOk = e => {
     onOk?.(e);
   };
+  const resolvedMinHeight = resolveMinHeight(minHeight);
   return /*#__PURE__*/(0, _jsxRuntime.jsx)(_antd.Modal, {
     centered: true,
     ...moadlConfig,
@@ -85,6 +95,18 @@ const Modal = props => {
       container: `${_indexModule.default.content} ${outer.container ?? ""}`,
       body: `${_indexModule.default.body} ${outer.body ?? ""}`,
       footer: `${_indexModule.default.footer} ${outer.footer ?? ""} ${footer === false ? _indexModule.default.noFooter : ""}`
+    }))
+    /* 下界通过 CSS 变量交给样式表，而不是直接写 `minHeight` 内联样式：
+       clamp（与 90vh 取小）必须在 CSS 里做——`min-height` 在 CSS 里赢过
+       `max-height`，内联写死的话矮窗口会被顶出屏幕 */,
+    styles: (0, _semantic.mergeSemantic)(outerStyles, outer => ({
+      ...outer,
+      container: {
+        ...(outer.container ?? {}),
+        ...(resolvedMinHeight ? {
+          "--vita-modal-min-height": resolvedMinHeight
+        } : {})
+      }
     })),
     footer: footer,
     afterClose: () => {