@hsu-react/ui 0.0.13 → 0.0.14

package/es/components/Tags/_components/EllipsisTag/index.d.ts

@@ -5,7 +5,7 @@ export interface EllipsisTagProps {
     colors?: string[];
 }
 /**
- * 省略标签组件，显示被省略的标签数量，悬浮时通过 Tooltip 展示所有被省略的标签
+ * Ellipsis tag component: shows the number of omitted tags, and displays all omitted tags in a Tooltip on hover
  */
 declare const EllipsisTag: React.FC<EllipsisTagProps>;
 export default EllipsisTag;

package/es/components/Tags/_components/EllipsisTag/index.js

@@ -5,7 +5,7 @@ import styles from "./index.module.scss";
 import { jsx as _jsx } from "react/jsx-runtime";
 import { jsxs as _jsxs } from "react/jsx-runtime";
 /**
- * 省略标签组件，显示被省略的标签数量，悬浮时通过 Tooltip 展示所有被省略的标签
+ * Ellipsis tag component: shows the number of omitted tags, and displays all omitted tags in a Tooltip on hover
  */
 var EllipsisTag = function EllipsisTag(props) {
   var ellipsisTags = props.ellipsisTags,

package/es/components/Tags/_components/MeasureContainer/index.d.ts

@@ -4,7 +4,7 @@ export interface MeasureContainerProps {
     colors?: string[];
 }
 /**
- * 用于测量标签宽度的隐藏容器
+ * Hidden container used to measure tag widths
  */
 declare const MeasureContainer: React.ForwardRefExoticComponent<MeasureContainerProps & React.RefAttributes<HTMLDivElement>>;
 export default MeasureContainer;

package/es/components/Tags/_components/MeasureContainer/index.js

@@ -4,7 +4,7 @@ import { getTagColor } from "../../_utils";
 import styles from "./index.module.scss";
 import { jsx as _jsx } from "react/jsx-runtime";
 /**
- * 用于测量标签宽度的隐藏容器
+ * Hidden container used to measure tag widths
  */
 var MeasureContainer = /*#__PURE__*/React.forwardRef(function (props, ref) {
   var tags = props.tags,

package/es/components/Tags/_hooks/useVisibleTags.d.ts

@@ -6,10 +6,10 @@ export interface UseVisibleTagsOptions {
     ellipsis?: boolean;
 }
 /**
- * 计算可见标签数量的 Hook
- * @param containerRef 容器引用
- * @param measureRef 测量容器引用
- * @param options 配置选项
- * @returns 可见的标签数量
+ * Hook that computes the number of visible tags
+ * @param containerRef Container ref
+ * @param measureRef Measure container ref
+ * @param options Config options
+ * @returns Number of visible tags
  */
 export declare function useVisibleTags(containerRef: React.RefObject<HTMLDivElement>, measureRef: React.RefObject<HTMLDivElement>, options: UseVisibleTagsOptions): number;

package/es/components/Tags/_hooks/useVisibleTags.js

@@ -7,11 +7,11 @@ function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
 import { useEffect, useState } from "react";
 import { calculateVisibleCount } from "../_utils/calculateVisibleCount";
 /**
- * 计算可见标签数量的 Hook
- * @param containerRef 容器引用
- * @param measureRef 测量容器引用
- * @param options 配置选项
- * @returns 可见的标签数量
+ * Hook that computes the number of visible tags
+ * @param containerRef Container ref
+ * @param measureRef Measure container ref
+ * @param options Config options
+ * @returns Number of visible tags
  */
 export function useVisibleTags(containerRef, measureRef, options) {
   var tags = options.tags,
@@ -26,21 +26,21 @@ export function useVisibleTags(containerRef, measureRef, options) {
     visibleCount = _useState2[0],
     setVisibleCount = _useState2[1];
 
-  // 当 tags 变化时，重置 visibleCount
+  // Reset visibleCount when tags change
   useEffect(function () {
     setVisibleCount(tags.length);
   }, [tags.length]);
 
-  // 如果禁用省略，直接返回所有标签数量
+  // If ellipsis is disabled, just return the total tag count
   useEffect(function () {
     if (!ellipsis) {
       setVisibleCount(tags.length);
     }
   }, [ellipsis, tags.length]);
 
-  // 计算可见的 tag 数量
+  // Compute the number of visible tags
   useEffect(function () {
-    // 如果禁用省略，不进行计算
+    // If ellipsis is disabled, skip the calculation
     if (!ellipsis) {
       return;
     }
@@ -54,11 +54,11 @@ export function useVisibleTags(containerRef, measureRef, options) {
       if (!container || !measureContainer) return;
       var containerWidth = container.offsetWidth;
       if (containerWidth === 0) {
-        // 容器宽度为 0，可能是隐藏状态，不进行计算
+        // Container width is 0, possibly hidden; skip the calculation
         return;
       }
 
-      // 获取所有 tag 元素的实际宽度
+      // Get the actual widths of all tag elements
       var tagElements = measureContainer.children;
       var tagWidths = [];
       for (var i = 0; i < tagElements.length; i++) {
@@ -69,12 +69,12 @@ export function useVisibleTags(containerRef, measureRef, options) {
       setVisibleCount(count);
     };
 
-    // 使用 requestAnimationFrame 确保 DOM 已更新
+    // Use requestAnimationFrame to ensure the DOM has been updated
     var timer = requestAnimationFrame(function () {
       calculate();
     });
 
-    // 监听容器大小变化
+    // Observe container size changes
     var resizeObserver = new ResizeObserver(function () {
       requestAnimationFrame(function () {
         calculate();

package/es/components/Tags/_utils/calculateVisibleCount.d.ts

@@ -1,9 +1,9 @@
 /**
- * 计算可见的标签数量
- * @param containerWidth 容器宽度
- * @param tagWidths 所有标签的宽度数组
- * @param gap 标签之间的间距
- * @param ellipsisTagWidth 省略标签的预估宽度
- * @returns 可见的标签数量
+ * Calculates the number of visible tags
+ * @param containerWidth Container width
+ * @param tagWidths Array of all tag widths
+ * @param gap Gap between tags
+ * @param ellipsisTagWidth Estimated width of the ellipsis tag
+ * @returns Number of visible tags
  */
 export declare function calculateVisibleCount(containerWidth: number, tagWidths: number[], gap?: number, ellipsisTagWidth?: number): number;

package/es/components/Tags/_utils/calculateVisibleCount.js

@@ -1,10 +1,10 @@
 /**
- * 计算可见的标签数量
- * @param containerWidth 容器宽度
- * @param tagWidths 所有标签的宽度数组
- * @param gap 标签之间的间距
- * @param ellipsisTagWidth 省略标签的预估宽度
- * @returns 可见的标签数量
+ * Calculates the number of visible tags
+ * @param containerWidth Container width
+ * @param tagWidths Array of all tag widths
+ * @param gap Gap between tags
+ * @param ellipsisTagWidth Estimated width of the ellipsis tag
+ * @returns Number of visible tags
  */
 export function calculateVisibleCount(containerWidth, tagWidths) {
   var gap = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : 8;
@@ -15,20 +15,20 @@ export function calculateVisibleCount(containerWidth, tagWidths) {
   var usedWidth = 0;
   var count = 0;
 
-  // 遍历所有 tag，计算能显示多少个
+  // Iterate over all tags to compute how many can be displayed
   for (var i = 0; i < tagWidths.length; i++) {
     var tagWidth = tagWidths[i] || 0;
-    // 计算加上当前 tag 后的总宽度
+    // Compute the total width after adding the current tag
     var nextWidth = usedWidth + tagWidth + (i > 0 ? gap : 0);
 
-    // 检查是否需要显示省略标签
+    // Check whether the ellipsis tag needs to be displayed
     if (i < tagWidths.length - 1) {
-      // 不是最后一个 tag，需要预留省略标签的空间
+      // Not the last tag; space must be reserved for the ellipsis tag
       if (nextWidth + gap + ellipsisTagWidth > containerWidth) {
         break;
       }
     } else {
-      // 是最后一个 tag，只需要检查当前宽度
+      // The last tag; only the current width needs to be checked
       if (nextWidth > containerWidth) {
         break;
       }
@@ -37,6 +37,6 @@ export function calculateVisibleCount(containerWidth, tagWidths) {
     usedWidth = nextWidth;
   }
 
-  // 至少显示 0 个（如果连一个都放不下，就只显示省略标签）
+  // Show at least 0 (if not even one fits, show only the ellipsis tag)
   return Math.max(0, count);
 }

package/es/components/Tags/_utils/getTagColor.d.ts

@@ -1,7 +1,7 @@
 /**
- * 根据索引获取标签颜色
- * @param index 标签索引
- * @param colors 颜色数组
- * @returns 颜色值或 undefined
+ * Gets the tag color by index
+ * @param index Tag index
+ * @param colors Color array
+ * @returns Color value or undefined
  */
 export declare function getTagColor(index: number, colors?: string[]): string | undefined;

package/es/components/Tags/_utils/getTagColor.js

@@ -1,8 +1,8 @@
 /**
- * 根据索引获取标签颜色
- * @param index 标签索引
- * @param colors 颜色数组
- * @returns 颜色值或 undefined
+ * Gets the tag color by index
+ * @param index Tag index
+ * @param colors Color array
+ * @returns Color value or undefined
  */
 export function getTagColor(index, colors) {
   if (colors && colors.length > 0) {

package/es/components/Tags/index.js

@@ -27,14 +27,14 @@ var Tags = function Tags(props) {
   var containerRef = useRef(null);
   var measureRef = useRef(null);
 
-  // 使用 hook 计算可见的标签数量
+  // Use the hook to compute the number of visible tags
   var visibleCount = useVisibleTags(containerRef, measureRef, {
     tags: tags,
     ellipsis: ellipsis,
     gap: gap
   });
 
-  // 获取可见的 tags 和省略的 tags
+  // Get the visible tags and the omitted tags
   var visibleTags = tags.slice(0, visibleCount);
   var ellipsisTags = tags.slice(visibleCount);
   return /*#__PURE__*/_jsxs(_Fragment, {

package/es/components/TextEllipsis/index.d.ts

@@ -1,29 +1,29 @@
 import { TooltipProps } from "antd";
 import { ReactNode } from "react";
 export interface TextEllipsisProps {
-    /** 要显示的文本内容 */
+    /** Text content to display */
     children: ReactNode;
-    /** 容器宽度，用于计算 Tooltip 宽度 */
+    /** Container width, used to compute the Tooltip width */
     width?: number | string;
-    /** Tooltip 配置 */
+    /** Tooltip config */
     tooltipConfig?: Omit<TooltipProps, "title" | "children"> & {
-        /** 默认 Tooltip 宽度（当没有设置 width 时使用） */
+        /** Default Tooltip width (used when width is not set) */
         defaultWidth?: number;
     };
-    /** 自定义样式 */
+    /** Custom style */
     style?: React.CSSProperties;
-    /** 自定义类名 */
+    /** Custom class name */
     className?: string;
-    /** 是否禁用 Tooltip（即使文本溢出也不显示） */
+    /** Whether to disable the Tooltip (not shown even when the text overflows) */
     disabled?: boolean;
-    /** 省略号位置，'start' 表示省略前面(...xxx)，'end' 表示省略后面(xxx...) */
+    /** Ellipsis position: 'start' truncates the beginning (...xxx), 'end' truncates the end (xxx...) */
     ellipsisPosition?: "start" | "end";
-    /** container 样式 */
+    /** Container style */
     containerStyle?: React.CSSProperties;
 }
 /**
- * 文本溢出组件
- * 当文本溢出时自动显示 Tooltip，并省略超出文本
+ * Text overflow component
+ * Automatically shows a Tooltip when the text overflows, and truncates the overflowing text
  */
 declare const TextEllipsis: React.FC<TextEllipsisProps>;
 export default TextEllipsis;

package/es/components/TextEllipsis/index.js

@@ -17,13 +17,13 @@ import { Tooltip } from "antd";
 import { useEffect, useRef, useState } from "react";
 import cssStyles from "./index.module.scss";
 
-// 默认 Tooltip 宽度
+// Default Tooltip width
 import { jsx as _jsx } from "react/jsx-runtime";
 import { jsxs as _jsxs } from "react/jsx-runtime";
 var DEFAULT_TOOLTIP_WIDTH = 200;
 /**
- * 文本溢出组件
- * 当文本溢出时自动显示 Tooltip，并省略超出文本
+ * Text overflow component
+ * Automatically shows a Tooltip when the text overflows, and truncates the overflowing text
  */
 var TextEllipsis = function TextEllipsis(_ref) {
   var children = _ref.children,
@@ -46,7 +46,7 @@ var TextEllipsis = function TextEllipsis(_ref) {
     _useState4 = _slicedToArray(_useState3, 2),
     truncatedText = _useState4[0],
     setTruncatedText = _useState4[1];
-  // 容器实际渲染宽度：未声明 width 时（如表格列宽动态分配）作为 Tooltip 宽度
+  // Actual rendered container width: used as the Tooltip width when width is not declared (e.g. dynamically allocated table column widths)
   var _useState5 = useState(0),
     _useState6 = _slicedToArray(_useState5, 2),
     measuredWidth = _useState6[0],
@@ -56,7 +56,7 @@ var TextEllipsis = function TextEllipsis(_ref) {
     var measureElement = measureRef.current;
     if (!element || !measureElement) return;
 
-    // 将 children 转换为字符串
+    // Convert children to a string
     var getTextContent = function getTextContent(node) {
       if (typeof node === "string" || typeof node === "number") {
         return String(node);
@@ -67,7 +67,7 @@ var TextEllipsis = function TextEllipsis(_ref) {
       return "";
     };
 
-    // 同步测量元素的样式
+    // Sync the measure element's styles
     var computedStyle = window.getComputedStyle(element);
     measureElement.style.fontSize = computedStyle.fontSize;
     measureElement.style.fontFamily = computedStyle.fontFamily;
@@ -78,17 +78,17 @@ var TextEllipsis = function TextEllipsis(_ref) {
     measureElement.style.border = computedStyle.border;
     measureElement.style.boxSizing = computedStyle.boxSizing;
 
-    // 计算截断后的文本（省略前面）
+    // Compute the truncated text (truncating the beginning)
     var calculateTruncatedText = function calculateTruncatedText(text, maxWidth) {
       var ellipsis = "...";
 
-      // 如果整个文本都不溢出，直接返回
+      // If the entire text does not overflow, return it directly
       measureElement.textContent = text;
       if (measureElement.offsetWidth <= maxWidth) {
         return text;
       }
 
-      // 二分查找找到合适的截断点
+      // Binary search for the appropriate truncation point
       var left = 0;
       var right = text.length;
       var result = text;
@@ -111,7 +111,7 @@ var TextEllipsis = function TextEllipsis(_ref) {
       setIsOverflow(isTextOverflow);
       setMeasuredWidth(element.clientWidth);
 
-      // 如果是省略前面且文本溢出，需要计算截断后的文本
+      // If truncating the beginning and the text overflows, the truncated text must be computed
       if (ellipsisPosition === "start" && isTextOverflow && textContent) {
         var maxWidth = element.clientWidth;
         var truncated = calculateTruncatedText(textContent, maxWidth);
@@ -122,7 +122,7 @@ var TextEllipsis = function TextEllipsis(_ref) {
     };
     update();
 
-    // 容器宽度动态变化（如表格列宽重分配、窗口 resize）时重测溢出与宽度
+    // Re-measure overflow and width when the container width changes dynamically (e.g. table column width redistribution, window resize)
     var resizeObserver = new ResizeObserver(update);
     resizeObserver.observe(element);
     return function () {
@@ -130,8 +130,8 @@ var TextEllipsis = function TextEllipsis(_ref) {
     };
   }, [children, ellipsisPosition, style]);
 
-  // 计算 Tooltip 的宽度：显式 width 优先；未声明（或百分比）时用容器实际渲染宽度，
-  // 实测不到再回退 defaultWidth
+  // Compute the Tooltip width: an explicit width takes priority; when not declared (or a percentage),
+  // use the container's actual rendered width, falling back to defaultWidth if measurement fails
   var getTooltipWidth = function getTooltipWidth() {
     var _tooltipConfig$defaul;
     var defaultWidth = (_tooltipConfig$defaul = tooltipConfig === null || tooltipConfig === void 0 ? void 0 : tooltipConfig.defaultWidth) !== null && _tooltipConfig$defaul !== void 0 ? _tooltipConfig$defaul : DEFAULT_TOOLTIP_WIDTH;
@@ -143,21 +143,21 @@ var TextEllipsis = function TextEllipsis(_ref) {
   };
   var tooltipWidth = getTooltipWidth();
 
-  // 从 tooltipConfig 中提取配置，移除 defaultWidth
+  // Extract config from tooltipConfig, removing defaultWidth
   var _ref2 = tooltipConfig || {},
     defaultWidth = _ref2.defaultWidth,
     styles = _ref2.styles,
     restTooltipConfig = _objectWithoutProperties(_ref2, _excluded);
   void defaultWidth;
 
-  // 尝试将 children 格式化为 JSON
+  // Try to format children as JSON
   var formatTooltipTitle = function formatTooltipTitle(content) {
     if (typeof content !== "string") return content;
     try {
       var parsed = JSON.parse(content);
       return JSON.stringify(parsed, null, 2);
     } catch (_unused) {
-      // 如果不是有效的 JSON，返回原内容
+      // If not valid JSON, return the original content
       return content;
     }
   };
@@ -173,13 +173,13 @@ var TextEllipsis = function TextEllipsis(_ref) {
       ref: textRef,
       className: "".concat(cssStyles.textElement, " ").concat(ellipsisPosition === "end" ? cssStyles.ellipsisEnd : cssStyles.ellipsisStart, " ").concat(className || ""),
       style: style,
-      title: "" // 禁用浏览器默认 tooltip
+      title: "" // Disable the browser's default tooltip
       ,
       children: ellipsisPosition === "start" ? truncatedText : children
     })]
   });
 
-  // 只在溢出且未禁用时显示 Tooltip
+  // Show the Tooltip only when overflowing and not disabled
   if (isOverflow && !disabled) {
     return /*#__PURE__*/_jsx(Tooltip, _objectSpread(_objectSpread({
       arrow: false,

package/es/components/Tree/_components/TitleSearchBar/index.js

@@ -23,7 +23,7 @@ var TitleSearchBar = function TitleSearchBar(_ref) {
     btnPosition = _ref$btnPosition === void 0 ? "right" : _ref$btnPosition,
     titleClassName = _ref.titleClassName,
     className = _ref.className;
-  // 渲染按钮组
+  // Render the button group
   var renderButtonGroup = useMemo(function () {
     if (!(buttonGroup !== null && buttonGroup !== void 0 && buttonGroup.length)) {
       return null;
@@ -35,7 +35,7 @@ var TitleSearchBar = function TitleSearchBar(_ref) {
       })
     });
   }, [buttonGroup]);
-  // 如果没有内容，不渲染
+  // Do not render if there is no content
   if (!search && !title && !(buttonGroup !== null && buttonGroup !== void 0 && buttonGroup.length)) {
     return null;
   }

package/es/components/Tree/_hooks/useClearNodeTitle.d.ts

@@ -1,8 +1,8 @@
 /// <reference types="react" />
 /**
- * 清除树节点 title 属性的 Hook
- * 当数据变更后，将所有 span.ant-tree-node-content-wrapper 的 title 设置为空
- * @param treeData 树数据
- * @param cls 树组件的唯一类名（用于精确定位）
+ * Hook that clears the title attribute of tree nodes
+ * After data changes, sets the title of all span.ant-tree-node-content-wrapper elements to empty
+ * @param treeData Tree data
+ * @param cls Unique class name of the tree component (used for precise targeting)
  */
 export declare const useClearNodeTitle: <T extends unknown[]>(treeData: T, cls?: string) => import("react").RefObject<HTMLDivElement>;

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

@@ -1,24 +1,24 @@
 import { useEffect, useRef } from "react";
 
 /**
- * 清除树节点 title 属性的 Hook
- * 当数据变更后，将所有 span.ant-tree-node-content-wrapper 的 title 设置为空
- * @param treeData 树数据
- * @param cls 树组件的唯一类名（用于精确定位）
+ * Hook that clears the title attribute of tree nodes
+ * After data changes, sets the title of all span.ant-tree-node-content-wrapper elements to empty
+ * @param treeData Tree data
+ * @param cls Unique class name of the tree component (used for precise targeting)
  */
 export var useClearNodeTitle = function useClearNodeTitle(treeData, cls) {
   var containerRef = useRef(null);
   useEffect(function () {
-    // 使用 requestAnimationFrame 确保 DOM 已更新
+    // Use requestAnimationFrame to ensure the DOM has been updated
     var timer = requestAnimationFrame(function () {
-      // 根据类名查找或使用 ref
+      // Look up by class name, or fall back to the ref
       var container = cls ? document.querySelector(".".concat(cls)) : containerRef.current;
       if (!container) return;
       setTimeout(function () {
-        // 获取所有 ant-tree-node-content-wrapper 元素
+        // Get all ant-tree-node-content-wrapper elements
         var nodes = container.querySelectorAll("span.ant-tree-node-content-wrapper");
 
-        // 清空每个元素的 title 属性
+        // Clear the title attribute of each element
         nodes === null || nodes === void 0 || nodes.forEach(function (node) {
           if (node instanceof HTMLElement) {
             node.title = "";

package/es/components/Tree/_hooks/useTreeCheck.d.ts

@@ -1,7 +1,7 @@
 import { TreeProps as AntdTreeProps } from "antd";
 import { CheckedKeys } from "..";
 /**
- * 处理树勾选的 hook
- * 使用 antd 默认逻辑，不做额外操作
+ * Hook for handling tree checking
+ * Uses antd's default logic without any extra operations
  */
 export declare const useTreeCheck: (setCheckedKeys: React.Dispatch<React.SetStateAction<CheckedKeys | undefined>>, onCheck?: AntdTreeProps["onCheck"], onChange?: ((checked: CheckedKeys) => void) | undefined) => (checked: CheckedKeys, info: Parameters<NonNullable<AntdTreeProps["onCheck"]>>[1]) => void;

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

@@ -1,15 +1,15 @@
 import { useCallback } from "react";
 /**
- * 处理树勾选的 hook
- * 使用 antd 默认逻辑，不做额外操作
+ * Hook for handling tree checking
+ * Uses antd's default logic without any extra operations
  */
 export var useTreeCheck = function useTreeCheck(setCheckedKeys, onCheck, onChange) {
-  // 处理勾选逻辑：直接使用 antd 的默认行为
+  // Handle check logic: directly use antd's default behavior
   var handleCheck = useCallback(function (checked, info) {
     setCheckedKeys(checked);
     onCheck === null || onCheck === void 0 || onCheck(checked, info);
 
-    // 触发 onChange 回调
+    // Trigger the onChange callback
     if (onChange) {
       if (Array.isArray(checked)) {
         onChange({

package/es/components/Tree/_hooks/useTreeSearch.d.ts

@@ -1,7 +1,7 @@
 import { Key } from "react";
 import { TreeData } from "..";
 /**
- * 处理树搜索的 hook
+ * Hook for handling tree search
  */
 export declare const useTreeSearch: (treeData: TreeData[], setExpandedKeys: React.Dispatch<React.SetStateAction<Key[] | undefined>>) => {
     searchKey: string;

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

@@ -9,7 +9,7 @@ import { useCallback, useMemo, useEffect, useState, useRef } from "react";
 import { filterTreeData } from "../_utils";
 
 /**
- * 处理树搜索的 hook
+ * Hook for handling tree search
  */
 export var useTreeSearch = function useTreeSearch(treeData, setExpandedKeys) {
   var _useState = useState(""),
@@ -18,8 +18,8 @@ export var useTreeSearch = function useTreeSearch(treeData, setExpandedKeys) {
     setSearchKey = _useState2[1];
   var prevSearchKeyRef = useRef("");
 
-  // 处理树数据（搜索过滤）
-  // filterTreeData 内部已经处理了数据拷贝，无需额外 cloneDeep
+  // Process tree data (search filtering)
+  // filterTreeData already handles data copying internally, no extra cloneDeep needed
   var filteredTreeData = useMemo(function () {
     if (!searchKey.trim()) {
       return treeData;
@@ -27,24 +27,24 @@ export var useTreeSearch = function useTreeSearch(treeData, setExpandedKeys) {
     return filterTreeData(searchKey, treeData);
   }, [searchKey, treeData]);
 
-  // 处理搜索时的展开逻辑
+  // Handle expand logic while searching
   useEffect(function () {
     var trimmedSearchKey = searchKey.trim();
     var prevTrimmedKey = prevSearchKeyRef.current.trim();
 
-    // 如果搜索关键词没有变化，跳过处理
+    // Skip processing if the search keyword has not changed
     if (trimmedSearchKey === prevTrimmedKey) {
       return;
     }
     prevSearchKeyRef.current = searchKey;
 
-    // 清空搜索时，重置展开状态
+    // When the search is cleared, reset the expanded state
     if (!trimmedSearchKey) {
       setExpandedKeys([]);
       return;
     }
 
-    // 有搜索关键词时，展开所有匹配的节点
+    // When there is a search keyword, expand all matching nodes
     if (!filteredTreeData.length) {
       return;
     }

package/es/components/Tree/_hooks/useTreeState.d.ts

@@ -1,11 +1,11 @@
 import { Key } from "react";
 import { CheckedKeys, TreeData } from "..";
 /**
- * 同步外部 expandedKeys 的 hook
+ * Hook for syncing external expandedKeys
  */
 export declare const useExpandedKeys: (expandedKeysProps?: Key[], defaultExpandedKeys?: Key[]) => readonly [Key[] | undefined, (keys: Key[] | ((prev: Key[] | undefined) => Key[] | undefined) | undefined) => void];
 /**
- * 同步外部 checkedKeys 的 hook
- * 自动规范化：当父级在 checked 中但子项未全选时，将父级设为半选
+ * Hook for syncing external checkedKeys
+ * Auto-normalizes: when a parent is in checked but its children are not all checked, the parent is set to half-checked
  */
 export declare const useCheckedKeys: (checkedKeysProps?: CheckedKeys, treeData?: TreeData[]) => readonly [CheckedKeys | undefined, import("react").Dispatch<import("react").SetStateAction<CheckedKeys | undefined>>];