@hsu-react/ui 0.0.13 → 0.0.15

package/lib/components/Table/_utils/tableUtils.js

@@ -6,22 +6,22 @@ Object.defineProperty(exports, "__esModule", {
 exports.HELP_TOOLTIP_CONFIG = void 0;
 exports.getDepartmentRowSpan = getDepartmentRowSpan;
 /**
- * 获取相同值的连续行数
- * @param record 当前行数据
- * @param index 当前行索引
- * @param dataSource 数据源
- * @param key 相同值的key
- * @returns 相同值的连续行数
+ * Gets the number of consecutive rows with the same value
+ * @param record Current row data
+ * @param index Current row index
+ * @param dataSource Data source
+ * @param key Key of the shared value
+ * @returns Number of consecutive rows with the same value
  */
 function getDepartmentRowSpan(record, index, dataSource, key) {
   const current = record[key];
 
-  // 如果不是该值的第一行，返回0（不显示）
+  // If this is not the first row with the value, return 0 (not displayed)
   if (index > 0 && dataSource[index - 1][key] === current) {
     return 0;
   }
 
-  // 计算相同值的连续行数
+  // Count consecutive rows with the same value
   let count = 1;
   for (let i = index + 1; i < dataSource.length; i++) {
     if (dataSource[i][key] === current) {
@@ -34,15 +34,15 @@ function getDepartmentRowSpan(record, index, dataSource, key) {
 }
 
 /**
- * Tooltip 配置常量
+ * Tooltip config constants
  */
 const HELP_TOOLTIP_CONFIG = exports.HELP_TOOLTIP_CONFIG = {
   arrow: false,
   placement: "top",
-  color: "#f2f4f5",
+  color: "var(--cf-subtle)",
   styles: {
     body: {
-      color: "#131212",
+      color: "var(--cf-text)",
       padding: "6px 16px"
     }
   }

package/lib/components/Table/index.d.ts

@@ -25,13 +25,16 @@ export interface ColumnType<RecordType> extends AntColumnType<RecordType> {
     fixedWidth?: boolean;
     ellipsisPosition?: "start" | "end";
     /**
-     * 定宽对齐列：列标题随 align 居中，单元格内容放进按本列最宽内容
-     * 测量出的定宽块内右对齐，使各行右边缘对齐、整体在列内居中（适合数字/金额列）。
+     * Fixed-width aligned column: the column title is centered per align, and cell content
+     * is placed right-aligned inside a fixed-width block measured from the column's widest
+     * content, so all rows' right edges align and the block is centered within the column
+     * (suitable for number/amount columns).
      */
     measureAlign?: boolean;
     /**
-     * measureAlign 列测量宽度所用的文本。默认取 dataIndex 原始值；当单元格由 render
-     * 产出复合/JSX 内容（无法从 dataIndex 直接得到展示文本）时，用它提供与展示一致的文本。
+     * Text used to measure the width of a measureAlign column. Defaults to the raw dataIndex
+     * value; when the cell renders composite/JSX content via render (so the display text cannot
+     * be derived from dataIndex directly), use this to provide text matching what is displayed.
      */
     measureText?: (record: RecordType) => string;
 }
@@ -72,14 +75,14 @@ export interface TableProps<RecordType = AnyObject> extends Omit<AntdTableProps<
     antdTableClassName?: string;
     autoScrolling?: boolean;
     autoScrollingInterval?: number;
-    /** smooth 模式自动滚动速度，单位 px/s，默认 25 */
+    /** Auto-scroll speed in smooth mode, in px/s, default 25 */
     autoScrollingSpeed?: number;
     autoScrollMode?: "smooth" | "row";
-    /** 自动滚动到末尾后是否循环回到顶部，默认 true */
+    /** Whether to loop back to the top after auto-scrolling to the end, default true */
     autoScrollLoop?: boolean;
-    /** 循环模式："reset" 回到顶部重新滚动（默认），"seamless" 无缝衔接继续滚动 */
+    /** Loop mode: "reset" returns to the top and scrolls again (default), "seamless" continues scrolling without a visible jump */
     autoScrollLoopMode?: "reset" | "seamless";
-    /** 自动滚动偏移量阈值（px），可滚动溢出超过该值后才启动自动滚动，默认 0 */
+    /** Auto-scroll offset threshold (px); auto-scrolling starts only when the scrollable overflow exceeds this value, default 0 */
     autoScrollingOffset?: number;
     hideEmpty?: boolean;
     ellipsisTooltipConfig?: EllipsisTooltipConfig;

package/lib/components/Table/index.module.scss

@@ -71,10 +71,10 @@
       &:global(.ant-table-row-selected) {
         :global(.ant-table-cell) {
           &:global(.ant-table-column-sort) {
-            background: rgba(19, 194, 194, 0.12);
+            background: color-mix(in srgb, var(--primary-color) 12%, transparent);
 
             &:global(.ant-table-cell-row-hover) {
-              background: rgba(19, 194, 194, 0.22);
+              background: color-mix(in srgb, var(--primary-color) 22%, transparent);
             }
           }
         }
@@ -143,7 +143,7 @@
     }
   }
 
-  // 表格
+  // Table
   .antdTable {
     border-color: var(--cf-border-weak);
 

package/lib/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/lib/components/Tags/_components/EllipsisTag/index.js

@@ -11,7 +11,7 @@ var _indexModule = _interopRequireDefault(require("./index.module.scss"));
 var _jsxRuntime = require("react/jsx-runtime");
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 /**
- * 省略标签组件，显示被省略的标签数量，悬浮时通过 Tooltip 展示所有被省略的标签
+ * Ellipsis tag component: shows the number of omitted tags, and displays all omitted tags in a Tooltip on hover
  */
 const EllipsisTag = props => {
   const {

package/lib/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/lib/components/Tags/_components/MeasureContainer/index.js

@@ -11,7 +11,7 @@ var _indexModule = _interopRequireDefault(require("./index.module.scss"));
 var _jsxRuntime = require("react/jsx-runtime");
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 /**
- * 用于测量标签宽度的隐藏容器
+ * Hidden container used to measure tag widths
  */
 const MeasureContainer = /*#__PURE__*/_react.default.forwardRef((props, ref) => {
   const {

package/lib/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/lib/components/Tags/_hooks/useVisibleTags.js

@@ -7,11 +7,11 @@ exports.useVisibleTags = useVisibleTags;
 var _react = require("react");
 var _calculateVisibleCount = require("../_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
  */
 function useVisibleTags(containerRef, measureRef, options) {
   const {
@@ -22,21 +22,21 @@ function useVisibleTags(containerRef, measureRef, options) {
   } = options;
   const [visibleCount, setVisibleCount] = (0, _react.useState)(tags.length);
 
-  // 当 tags 变化时，重置 visibleCount
+  // Reset visibleCount when tags change
   (0, _react.useEffect)(() => {
     setVisibleCount(tags.length);
   }, [tags.length]);
 
-  // 如果禁用省略，直接返回所有标签数量
+  // If ellipsis is disabled, just return the total tag count
   (0, _react.useEffect)(() => {
     if (!ellipsis) {
       setVisibleCount(tags.length);
     }
   }, [ellipsis, tags.length]);
 
-  // 计算可见的 tag 数量
+  // Compute the number of visible tags
   (0, _react.useEffect)(() => {
-    // 如果禁用省略，不进行计算
+    // If ellipsis is disabled, skip the calculation
     if (!ellipsis) {
       return;
     }
@@ -50,11 +50,11 @@ function useVisibleTags(containerRef, measureRef, options) {
       if (!container || !measureContainer) return;
       const 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
       const tagElements = measureContainer.children;
       const tagWidths = [];
       for (let i = 0; i < tagElements.length; i++) {
@@ -65,12 +65,12 @@ function useVisibleTags(containerRef, measureRef, options) {
       setVisibleCount(count);
     };
 
-    // 使用 requestAnimationFrame 确保 DOM 已更新
+    // Use requestAnimationFrame to ensure the DOM has been updated
     const timer = requestAnimationFrame(() => {
       calculate();
     });
 
-    // 监听容器大小变化
+    // Observe container size changes
     const resizeObserver = new ResizeObserver(() => {
       requestAnimationFrame(() => {
         calculate();

package/lib/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/lib/components/Tags/_utils/calculateVisibleCount.js

@@ -5,12 +5,12 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.calculateVisibleCount = calculateVisibleCount;
 /**
- * 计算可见的标签数量
- * @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
  */
 function calculateVisibleCount(containerWidth, tagWidths, gap = 8, ellipsisTagWidth = 60) {
   if (containerWidth === 0 || tagWidths.length === 0) {
@@ -19,20 +19,20 @@ function calculateVisibleCount(containerWidth, tagWidths, gap = 8, ellipsisTagWi
   let usedWidth = 0;
   let count = 0;
 
-  // 遍历所有 tag，计算能显示多少个
+  // Iterate over all tags to compute how many can be displayed
   for (let i = 0; i < tagWidths.length; i++) {
     const tagWidth = tagWidths[i] || 0;
-    // 计算加上当前 tag 后的总宽度
+    // Compute the total width after adding the current tag
     const 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;
       }
@@ -41,6 +41,6 @@ function calculateVisibleCount(containerWidth, tagWidths, gap = 8, ellipsisTagWi
     usedWidth = nextWidth;
   }
 
-  // 至少显示 0 个（如果连一个都放不下，就只显示省略标签）
+  // Show at least 0 (if not even one fits, show only the ellipsis tag)
   return Math.max(0, count);
 }

package/lib/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/lib/components/Tags/_utils/getTagColor.js

@@ -5,10 +5,10 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.getTagColor = getTagColor;
 /**
- * 根据索引获取标签颜色
- * @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
  */
 function getTagColor(index, colors) {
   if (colors && colors.length > 0) {

package/lib/components/Tags/index.js

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

package/lib/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/lib/components/TextEllipsis/index.js

@@ -9,11 +9,11 @@ var _react = require("react");
 var _indexModule = _interopRequireDefault(require("./index.module.scss"));
 var _jsxRuntime = require("react/jsx-runtime");
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
-// 默认 Tooltip 宽度
+// Default Tooltip width
 const DEFAULT_TOOLTIP_WIDTH = 200;
 /**
- * 文本溢出组件
- * 当文本溢出时自动显示 Tooltip，并省略超出文本
+ * Text overflow component
+ * Automatically shows a Tooltip when the text overflows, and truncates the overflowing text
  */
 const TextEllipsis = ({
   children,
@@ -29,14 +29,14 @@ const TextEllipsis = ({
   const measureRef = (0, _react.useRef)(null);
   const [isOverflow, setIsOverflow] = (0, _react.useState)(false);
   const [truncatedText, setTruncatedText] = (0, _react.useState)(children);
-  // 容器实际渲染宽度：未声明 width 时（如表格列宽动态分配）作为 Tooltip 宽度
+  // Actual rendered container width: used as the Tooltip width when width is not declared (e.g. dynamically allocated table column widths)
   const [measuredWidth, setMeasuredWidth] = (0, _react.useState)(0);
   (0, _react.useEffect)(() => {
     const element = textRef.current;
     const measureElement = measureRef.current;
     if (!element || !measureElement) return;
 
-    // 将 children 转换为字符串
+    // Convert children to a string
     const getTextContent = node => {
       if (typeof node === "string" || typeof node === "number") {
         return String(node);
@@ -47,7 +47,7 @@ const TextEllipsis = ({
       return "";
     };
 
-    // 同步测量元素的样式
+    // Sync the measure element's styles
     const computedStyle = window.getComputedStyle(element);
     measureElement.style.fontSize = computedStyle.fontSize;
     measureElement.style.fontFamily = computedStyle.fontFamily;
@@ -58,17 +58,17 @@ const TextEllipsis = ({
     measureElement.style.border = computedStyle.border;
     measureElement.style.boxSizing = computedStyle.boxSizing;
 
-    // 计算截断后的文本（省略前面）
+    // Compute the truncated text (truncating the beginning)
     const calculateTruncatedText = (text, maxWidth) => {
       const 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
       let left = 0;
       let right = text.length;
       let result = text;
@@ -91,7 +91,7 @@ const TextEllipsis = ({
       setIsOverflow(isTextOverflow);
       setMeasuredWidth(element.clientWidth);
 
-      // 如果是省略前面且文本溢出，需要计算截断后的文本
+      // If truncating the beginning and the text overflows, the truncated text must be computed
       if (ellipsisPosition === "start" && isTextOverflow && textContent) {
         const maxWidth = element.clientWidth;
         const truncated = calculateTruncatedText(textContent, maxWidth);
@@ -102,14 +102,14 @@ const TextEllipsis = ({
     };
     update();
 
-    // 容器宽度动态变化（如表格列宽重分配、窗口 resize）时重测溢出与宽度
+    // Re-measure overflow and width when the container width changes dynamically (e.g. table column width redistribution, window resize)
     const resizeObserver = new ResizeObserver(update);
     resizeObserver.observe(element);
     return () => resizeObserver.disconnect();
   }, [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
   const getTooltipWidth = () => {
     const defaultWidth = tooltipConfig?.defaultWidth ?? DEFAULT_TOOLTIP_WIDTH;
     const dynamicWidth = measuredWidth > 0 ? measuredWidth : defaultWidth;
@@ -120,7 +120,7 @@ const TextEllipsis = ({
   };
   const tooltipWidth = getTooltipWidth();
 
-  // 从 tooltipConfig 中提取配置，移除 defaultWidth
+  // Extract config from tooltipConfig, removing defaultWidth
   const {
     defaultWidth,
     styles,
@@ -128,14 +128,14 @@ const TextEllipsis = ({
   } = tooltipConfig || {};
   void defaultWidth;
 
-  // 尝试将 children 格式化为 JSON
+  // Try to format children as JSON
   const formatTooltipTitle = content => {
     if (typeof content !== "string") return content;
     try {
       const parsed = JSON.parse(content);
       return JSON.stringify(parsed, null, 2);
     } catch {
-      // 如果不是有效的 JSON，返回原内容
+      // If not valid JSON, return the original content
       return content;
     }
   };
@@ -151,13 +151,13 @@ const TextEllipsis = ({
       ref: textRef,
       className: `${_indexModule.default.textElement} ${ellipsisPosition === "end" ? _indexModule.default.ellipsisEnd : _indexModule.default.ellipsisStart} ${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__*/(0, _jsxRuntime.jsx)(_antd.Tooltip, {
       arrow: false,

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

@@ -25,7 +25,7 @@ const TitleSearchBar = ({
   titleClassName,
   className
 }) => {
-  // 渲染按钮组
+  // Render the button group
   const renderButtonGroup = (0, _react.useMemo)(() => {
     if (!buttonGroup?.length) {
       return null;
@@ -37,7 +37,7 @@ const TitleSearchBar = ({
       }, idx))
     });
   }, [buttonGroup]);
-  // 如果没有内容，不渲染
+  // Do not render if there is no content
   if (!search && !title && !buttonGroup?.length) {
     return null;
   }

package/lib/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/lib/components/Tree/_hooks/useClearNodeTitle.js

@@ -6,24 +6,24 @@ Object.defineProperty(exports, "__esModule", {
 exports.useClearNodeTitle = void 0;
 var _react = require("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)
  */
 const useClearNodeTitle = (treeData, cls) => {
   const containerRef = (0, _react.useRef)(null);
   (0, _react.useEffect)(() => {
-    // 使用 requestAnimationFrame 确保 DOM 已更新
+    // Use requestAnimationFrame to ensure the DOM has been updated
     const timer = requestAnimationFrame(() => {
-      // 根据类名查找或使用 ref
+      // Look up by class name, or fall back to the ref
       const container = cls ? document.querySelector(`.${cls}`) : containerRef.current;
       if (!container) return;
       setTimeout(() => {
-        // 获取所有 ant-tree-node-content-wrapper 元素
+        // Get all ant-tree-node-content-wrapper elements
         const nodes = container.querySelectorAll("span.ant-tree-node-content-wrapper");
 
-        // 清空每个元素的 title 属性
+        // Clear the title attribute of each element
         nodes?.forEach(node => {
           if (node instanceof HTMLElement) {
             node.title = "";

package/lib/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/lib/components/Tree/_hooks/useTreeCheck.js

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

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