@hsu-react/ui 0.0.13 → 0.0.15

package/es/components/Select/_utils/getElementPosition.d.ts

@@ -1,12 +1,13 @@
 /**
- * 获取元素相对于视口的顶部位置。
- * 下拉框为 position: fixed（相对视口定位），故此处必须返回视口坐标，
- * 不能叠加 document.scrollTop——否则当文档本身可滚动时（如文档站长页面），
- * 下拉框会被定位到 scrollTop 像素之外而“消失”。
- * 在固定布局（document 不滚动，scrollTop=0）下与原行为一致。
+ * Get the element's top position relative to the viewport.
+ * The dropdown uses position: fixed (positioned relative to the viewport), so this must
+ * return viewport coordinates and must NOT add document.scrollTop — otherwise, when the
+ * document itself is scrollable (e.g. docs-site long pages), the dropdown would be
+ * positioned scrollTop pixels away and "disappear".
+ * In fixed layouts (document does not scroll, scrollTop=0) this matches the original behavior.
  */
 export declare function getElementTop(element: HTMLDivElement): number;
 /**
- * 获取元素相对于视口的左侧位置（同上，配合 position: fixed）。
+ * Get the element's left position relative to the viewport (same as above, for position: fixed).
  */
 export declare function getElementLeft(element: HTMLDivElement): number;

package/es/components/Select/_utils/getElementPosition.js

@@ -1,16 +1,17 @@
 /**
- * 获取元素相对于视口的顶部位置。
- * 下拉框为 position: fixed（相对视口定位），故此处必须返回视口坐标，
- * 不能叠加 document.scrollTop——否则当文档本身可滚动时（如文档站长页面），
- * 下拉框会被定位到 scrollTop 像素之外而“消失”。
- * 在固定布局（document 不滚动，scrollTop=0）下与原行为一致。
+ * Get the element's top position relative to the viewport.
+ * The dropdown uses position: fixed (positioned relative to the viewport), so this must
+ * return viewport coordinates and must NOT add document.scrollTop — otherwise, when the
+ * document itself is scrollable (e.g. docs-site long pages), the dropdown would be
+ * positioned scrollTop pixels away and "disappear".
+ * In fixed layouts (document does not scroll, scrollTop=0) this matches the original behavior.
  */
 export function getElementTop(element) {
   return element.getBoundingClientRect().top;
 }
 
 /**
- * 获取元素相对于视口的左侧位置（同上，配合 position: fixed）。
+ * Get the element's left position relative to the viewport (same as above, for position: fixed).
  */
 export function getElementLeft(element) {
   return element.getBoundingClientRect().left;

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

@@ -6,12 +6,12 @@
 
   width: 100%;
   height: 100%;
-  // 父级未给定高度时（height:100% 解析为 auto），保证最小高度，
-  // 与 Input 等录入控件高度一致，避免被压扁或在搜索行中高度异常。
+  // When the parent has no explicit height (height:100% resolves to auto), guarantee a min height
+  // consistent with Input and other form controls, so it is neither squashed nor mis-sized in search rows.
   min-height: 32px;
   padding: 0px 11px;
 
-  // CF 风格：随外观切换的描边输入控件
+  // CF style: outlined input control that follows appearance switching
   border: 1px solid var(--cf-border);
   border-radius: 6px;
 
@@ -54,7 +54,7 @@
   &.focused {
     border-color: var(--primary-color);
 
-    box-shadow: 0 0 0 2px rgba(19, 194, 194, 0.12);
+    box-shadow: 0 0 0 2px color-mix(in srgb, var(--primary-color) 12%, transparent);
 
     outline: 0;
   }
@@ -81,20 +81,20 @@
   }
 
   &:has(> :global(.ant-select-status-error)) {
-    border: 1px solid #ff4d4f;
+    border: 1px solid var(--cf-error);
 
     .prefix,
     .suffix {
-      color: #ff4d4f;
+      color: var(--cf-error);
     }
   }
 
   &.legacyHasErrorStatus {
-    border: 1px solid #ff4d4f;
+    border: 1px solid var(--cf-error);
 
     .prefix,
     .suffix {
-      color: #ff4d4f;
+      color: var(--cf-error);
     }
   }
 

package/es/components/Spreadsheet/xlsxspread.js

@@ -1,6 +1,6 @@
 import * as XLSX from "xlsx";
 
-// 定义类型接口
+// Type interface definitions
 
 export function stox(wb) {
   var _wb$SheetNames;
@@ -14,7 +14,7 @@ export function stox(wb) {
     };
     var ws = wb.Sheets[name];
 
-    // 检查 ws["!ref"] 是否存在
+    // Check whether ws["!ref"] exists
     if (!ws["!ref"]) {
       out.push(o);
       return;

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

@@ -1,5 +1,5 @@
-// 让开关在表单/录入场景中与 Input、Select 等控件保持一致的 32px 最小高度。
-// 开关本体（pill）保持原始尺寸，由该容器居中占位，故不会被拉大。
+// Keep the switch at the same 32px min height as Input, Select and other controls in form/input scenarios.
+// The switch itself (pill) keeps its original size; this container centers it, so it is not stretched.
 .SwitchWrapper {
   display: inline-flex;
   align-items: center;

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

@@ -20,13 +20,13 @@
     padding: 0px 15px;
 
     font-size: 14px;
-    color: #31455c;
+    color: var(--cf-text);
 
     transition: all 0.3s;
 
     cursor: pointer;
 
-    border: 1px solid rgba(49, 69, 92, 0.2);
+    border: 1px solid var(--cf-border);
 
     &:not(:first-child) {
       margin-left: -1px;
@@ -45,11 +45,11 @@
     }
 
     &:hover {
-      color: #489dff;
+      color: var(--primary-color);
     }
 
     &.active {
-      background: #489dff;
+      background: var(--primary-color);
 
       color: #fff;
 
@@ -78,12 +78,12 @@
       background: transparent !important;
 
       font-size: 16px !important;
-      color: #4d4d4d !important;
+      color: var(--cf-text) !important;
 
       transition: all 0.2s;
 
       &:hover {
-        color: #0364f5 !important;
+        color: var(--primary-color) !important;
       }
 
       &::after {
@@ -103,10 +103,10 @@
       &.active {
         font-weight: 500;
         font-size: 16px;
-        color: #0364f5 !important;
+        color: var(--primary-color) !important;
 
         &::after {
-          background: #0364f5;
+          background: var(--primary-color);
         }
       }
     }

package/es/components/Table/_components/Pagination/index.js

@@ -35,7 +35,7 @@ var Pagination = function Pagination(props) {
     showTotal = props.showTotal,
     align = props.align;
   var selectRef = useRef(null);
-  // 直接传入原始值，不使用默认值，让 usePaginationSync 自行处理
+  // Pass the raw values directly without defaults; let usePaginationSync handle them itself
   var _usePaginationSync = usePaginationSync({
       current: props.current,
       pageSize: props.pageSize
@@ -109,7 +109,7 @@ var Pagination = function Pagination(props) {
     });
   }
   return /*#__PURE__*/_jsx(AntdPagination, _objectSpread(_objectSpread({}, props), {}, {
-    // 没有外部传入时使用内部状态
+    // Use internal state when no external value is provided
     current: (_props$current = props.current) !== null && _props$current !== void 0 ? _props$current : _pageNum,
     pageSize: (_props$pageSize2 = props.pageSize) !== null && _props$pageSize2 !== void 0 ? _props$pageSize2 : _pageSize,
     total: total,
@@ -117,7 +117,7 @@ var Pagination = function Pagination(props) {
     align: align,
     className: classNames(styles.Pagination, className, _defineProperty({}, styles.bordered, bordered)),
     onChange: function onChange(page, size) {
-      // 没有外部传入时，更新内部状态
+      // Update internal state when no external value is provided
       if (props.current === undefined) setPageNum(page);
       if (props.pageSize === undefined) setPageSize(size);
       _onChange === null || _onChange === void 0 || _onChange(page, size);

package/es/components/Table/_hooks/useAutoScrolling.d.ts

@@ -10,7 +10,7 @@ interface UseAutoScrollingProps {
     onAutoScrollEndAdd?: () => Promise<boolean>;
     autoScrollMode?: "smooth" | "row";
     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";
     autoScrollingOffset?: number;
 }

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

@@ -52,7 +52,7 @@ var useAutoScrolling = function useAutoScrolling(props) {
   var prevDataSourceRef = useRef(dataSource);
   var hoverHandlersRef = useRef({});
 
-  // seamless 模式相关
+  // Seamless mode related
   var isSeamless = autoScrollLoopMode === "seamless" && autoScrollLoop;
   var originalRowsHeightRef = useRef(0);
   var clonedNodesRef = useRef([]);
@@ -82,7 +82,7 @@ var useAutoScrolling = function useAutoScrolling(props) {
       height += row.offsetHeight;
     });
 
-    // 内容不足一屏时不需要无缝滚动
+    // No seamless scrolling needed when content is less than one screen
     if (height <= body.clientHeight) return;
     originalRowsHeightRef.current = height;
     var clones = [];
@@ -313,7 +313,7 @@ var useAutoScrolling = function useAutoScrolling(props) {
         return;
       }
       if (isSeamless && seamlessReadyRef.current) {
-        // 无缝模式下不会真正到底，直接继续滚动
+        // In seamless mode the scroll never actually reaches the bottom; just keep scrolling
         phaseRef.current = "idle";
       } else if (isAtBottom(body)) {
         if (onAutoScrollEndAdd) {
@@ -337,7 +337,7 @@ var useAutoScrolling = function useAutoScrolling(props) {
       return;
     }
 
-    // 内容不足一屏时，也按“滚动到底”处理，触发 load-more 逻辑
+    // When content is less than one screen, treat it as "scrolled to bottom" too, triggering the load-more logic
     if (!bodyScrollable) {
       phaseRef.current = "wait";
       waitUntilRef.current = performance.now() + interval;
@@ -380,14 +380,15 @@ var useAutoScrolling = function useAutoScrolling(props) {
     var body = getBody();
     if (!changed || !body) return;
 
-    // 无缝模式：实时刷新场景下保留滚动进度，clone 节点交由 loop 在下一帧按需重建，
-    // 避免每次轮询都把 scrollTop 重置为 0 导致用户视觉上"不滚动"。
+    // Seamless mode: in real-time refresh scenarios keep the scroll progress; clone nodes are
+    // rebuilt on demand by loop on the next frame, avoiding resetting scrollTop to 0 on every
+    // poll, which would make it look like the table "isn't scrolling".
     if (isSeamless) {
       cleanupClones();
       return;
     }
     if (onAutoScrollEndAdd) {
-      // 当 load-more 模式且此前已停止时，有新数据后恢复自动滚动
+      // In load-more mode, if scrolling had stopped, resume auto-scrolling when new data arrives
       if (phaseRef.current === "stopped") {
         phaseRef.current = autoScrollMode === "row" ? "wait" : "idle";
         waitUntilRef.current = autoScrollMode === "row" ? performance.now() + interval : 0;

package/es/components/Table/_hooks/useEllipsisTooltip.d.ts

@@ -1,7 +1,7 @@
 import { ColumnsType, EllipsisTooltipConfig } from "..";
 import { AnyObject } from "antd/es/_util/type";
 /**
- * 为设置了 ellipsis 且没有自定义 render 的列自动添加溢出检测和 Tooltip
+ * Automatically adds overflow detection and a Tooltip for columns that set ellipsis and have no custom render
  */
 declare const useEllipsisTooltip: <T extends AnyObject>(tooltipConfig?: EllipsisTooltipConfig) => {
     enhanceColumns: (columns?: ColumnsType<T>) => ColumnsType<T> | undefined;

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

@@ -9,28 +9,28 @@ import TextEllipsis from "../../TextEllipsis";
 import React from "react";
 
 /**
- * 为设置了 ellipsis 且没有自定义 render 的列自动添加溢出检测和 Tooltip
+ * Automatically adds overflow detection and a Tooltip for columns that set ellipsis and have no custom render
  */
 var useEllipsisTooltip = function useEllipsisTooltip(tooltipConfig) {
   var enhanceColumns = useCallback(function (columns) {
     return columns === null || columns === void 0 ? void 0 : columns.map(function (column) {
-      // 递归处理子列
+      // Recursively process child columns
       if (column.children) {
         return _objectSpread(_objectSpread({}, column), {}, {
           children: enhanceColumns(column.children)
         });
       }
 
-      // 如果设置了 ellipsis 且没有自定义 render
+      // If ellipsis is set and there is no custom render
       if (column.ellipsis && !column.render && column.dataIndex) {
         return _objectSpread(_objectSpread({}, column), {}, {
           render: function render(text) {
             var _column$ellipsisPosit;
-            // 获取实际的显示值
+            // Get the actual display value
             var displayValue = typeof text === "string" || typeof text === "number" ? text : String(text !== null && text !== void 0 ? text : "");
 
-            // 不传 width：由 TextEllipsis 实测单元格实际渲染宽度作为 Tooltip 宽度
-            // （声明的列宽经 fixedWidth 比例分配后与实际宽度并不一致）
+            // Do not pass width: let TextEllipsis measure the cell's actual rendered width as the Tooltip width
+            // (the declared column width, after fixedWidth proportional allocation, does not match the actual width)
             return /*#__PURE__*/React.createElement(TextEllipsis, {
               tooltipConfig: tooltipConfig,
               children: displayValue,

package/es/components/Table/_hooks/usePaginationSync.d.ts

@@ -4,9 +4,9 @@ interface UsePaginationSyncParams {
     pageSize?: number;
 }
 /**
- * 分页状态同步 hook
- * 用于同步外部传入的 current 和 pageSize 到内部状态
- * 注意：只有明确传入 current/pageSize 时才会进行同步，undefined 时不受默认值影响
+ * Pagination state sync hook
+ * Syncs externally provided current and pageSize into internal state
+ * Note: sync only happens when current/pageSize is explicitly provided; undefined is not affected by defaults
  */
 declare const usePaginationSync: (params: UsePaginationSyncParams) => {
     _pageNum: number;

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

@@ -6,9 +6,9 @@ function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" !=
 function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
 import { useEffect, useState } from "react";
 /**
- * 分页状态同步 hook
- * 用于同步外部传入的 current 和 pageSize 到内部状态
- * 注意：只有明确传入 current/pageSize 时才会进行同步，undefined 时不受默认值影响
+ * Pagination state sync hook
+ * Syncs externally provided current and pageSize into internal state
+ * Note: sync only happens when current/pageSize is explicitly provided; undefined is not affected by defaults
  */
 var usePaginationSync = function usePaginationSync(params) {
   var current = params.current,
@@ -22,13 +22,13 @@ var usePaginationSync = function usePaginationSync(params) {
     _pageSize = _useState4[0],
     setPageSize = _useState4[1];
   useEffect(function () {
-    // 只有明确传入 current 时才同步
+    // Sync only when current is explicitly provided
     if (current !== undefined && current !== _pageNum) {
       setPageNum(current);
     }
   }, [_pageNum, current]);
   useEffect(function () {
-    // 只有明确传入 pageSize 时才同步
+    // Sync only when pageSize is explicitly provided
     if (pageSize !== undefined && pageSize !== _pageSize) {
       setPageSize(pageSize);
     }

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

@@ -22,35 +22,35 @@ var useScrollEnd = function useScrollEnd(props) {
   useDebounceEffect(function () {
     var body = null;
 
-    // 清理函数
+    // Cleanup function
     var cleanup = function cleanup() {
-      // 移除事件监听器
+      // Remove event listeners
       if (body && eventHandlersRef.current.scroll) {
         body.removeEventListener("scroll", eventHandlersRef.current.scroll);
       }
       eventHandlersRef.current = {};
     };
 
-    // 当 autoScrolling 开启时，不启用此 hook
+    // Do not enable this hook when autoScrolling is on
     if (ref && ref.current && ready && onScrollEnd && dataSource !== null && dataSource !== void 0 && dataSource.length && !autoScrolling) {
       body = document.querySelector(".".concat(cls, " .ant-table-body"));
       if (body && body.scrollHeight > body.clientHeight) {
-        // 清理之前的监听器
+        // Clean up previous listeners
         cleanup();
 
-        // 添加滚动事件监听器
+        // Add scroll event listener
         var handleScroll = function handleScroll() {
           if (!body) {
             return;
           }
 
-          // 计算距离底部的距离
+          // Compute the distance to the bottom
           var scrollTop = body.scrollTop;
           var scrollHeight = body.scrollHeight;
           var clientHeight = body.clientHeight;
           var distanceToBottom = scrollHeight - scrollTop - clientHeight;
 
-          // 当滚动到接近底部时触发
+          // Trigger when scrolled close to the bottom
           if (distanceToBottom <= threshold) {
             onScrollEnd();
           }

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

@@ -22,16 +22,16 @@ 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";
-// measureAlign 列：与表体、autoWidth 标题测量一致，统一按 14px 测量
+// measureAlign columns: measured at 14px, consistent with the table body and autoWidth title measurement
 var MEASURE_ALIGN_FONT_SIZE = 14;
-// Canvas measureText 仅返回 advance width，较 DOM 实际渲染偏窄约 1px，补 2px 缓冲避免最宽行被挤压
+// 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
 var MEASURE_ALIGN_BUFFER_PX = 2;
-// 单元格左右内边距合计的默认值（默认 --td-padding: 4px 8px），用于把列宽抬到能放下定宽内容块
+// Default total horizontal cell padding (default --td-padding: 4px 8px), used to raise the column width enough to fit the fixed-width content block
 var MEASURE_ALIGN_CELL_PADDING_PX = 16;
 
 /**
- * 解析 tdPadding（CSS padding 简写）的左右内边距合计；
- * 未传或解析不出时回退默认值（与默认 --td-padding: 4px 8px 一致）。
+ * Parses the total horizontal padding from tdPadding (CSS padding shorthand);
+ * falls back to the default when absent or unparsable (matching the default --td-padding: 4px 8px).
  */
 var getCellHorizontalPadding = function getCellHorizontalPadding(tdPadding) {
   if (!tdPadding) return MEASURE_ALIGN_CELL_PADDING_PX;
@@ -44,13 +44,13 @@ var getCellHorizontalPadding = function getCellHorizontalPadding(tdPadding) {
     return MEASURE_ALIGN_CELL_PADDING_PX;
   }
 
-  // CSS 简写：1 值=四边；2/3 值=第 2 个为左右；4 值=右+左
+  // CSS shorthand: 1 value = all four sides; 2/3 values = the 2nd is left/right; 4 values = right + left
   if (parts.length === 1) return parts[0] * 2;
   if (parts.length === 4) return parts[1] + parts[3];
   return parts[1] * 2;
 };
 
-// 计算 measureAlign 列的定宽（取本列所有行展示文本的最大像素宽）
+// Computes the fixed width for a measureAlign column (the max pixel width of the display text across all rows in the column)
 var getMeasureAlignWidth = function getMeasureAlignWidth(column, dataSource) {
   if (!(dataSource !== null && dataSource !== void 0 && dataSource.length)) return 0;
   var measureText = column.measureText,
@@ -94,7 +94,7 @@ var useTableColumns = function useTableColumns(params) {
     tableWidth = _useState2[0],
     setTableWidth = _useState2[1];
 
-  // 监听表格宽度变化
+  // Observe table width changes
   useEffect(function () {
     if (ref !== null && ref !== void 0 && ref.current && cls) {
       var tableElement = document.querySelector(".".concat(cls, " .ant-table"));
@@ -115,7 +115,7 @@ var useTableColumns = function useTableColumns(params) {
     }
   }, [ref, cls]);
 
-  // 处理列的基础设置（权限、宽度、排序等）
+  // Handle basic column setup (permissions, width, sorting, etc.)
   var _columns = useMemo(function () {
     var _cloned$map;
     var cloned = cloneDeep(columns);
@@ -149,8 +149,9 @@ var useTableColumns = function useTableColumns(params) {
         item.width = Math.max(titleWidth, dataIndexWidth) + 32;
       }
 
-      // measureAlign 列：列宽须容得下最宽行的定宽内容块 + 单元格左右内边距，
-      // 否则出现超长值（如 +3357.52%）时内容会被列宽截断；声明的 width 只作下限。
+      // measureAlign columns: the column width must fit the widest row's fixed-width content block
+      // plus horizontal cell padding, otherwise very long values (e.g. +3357.52%) get truncated
+      // by the column width; the declared width only serves as a lower bound.
       if (item.measureAlign && typeof item.width === "number") {
         var measured = getMeasureAlignWidth(item, dataSource);
         if (measured > 0) {
@@ -168,7 +169,7 @@ var useTableColumns = function useTableColumns(params) {
     return newColumns;
   }, [autoWidth, columns, dataSource, checkPermission, scroll, tdPadding]);
 
-  // 渲染列标题
+  // Render column titles
   var renderColumnTitle = useCallback(function (column) {
     var titleContent = column !== null && column !== void 0 && column.titleSort ? column.titleSort : column.renderTitle ? column.renderTitle(column.title || "") : column.title;
     if (!column.help) {
@@ -182,14 +183,14 @@ var useTableColumns = function useTableColumns(params) {
           icon: "material-symbols:help",
           className: styles.help,
           fontSize: 16,
-          color: "#999999"
+          color: "var(--cf-text-3)"
         })
       }))]
     });
   }, []);
   var renderColumns = useCallback(function (columns) {
     var _enhancedColumns3;
-    // 先增强列配置，为 ellipsis 列添加自动 Tooltip
+    // First enhance the column config, adding an automatic Tooltip for ellipsis columns
     var enhancedColumns = enhanceColumns(columns);
     if (serialNumberColumn && !_columns.find(function (v) {
       return !!v.children;
@@ -207,32 +208,32 @@ var useTableColumns = function useTableColumns(params) {
       });
     }
 
-    // 处理 fixedWidth 列的宽度分配（在 enhancedColumns 基础上）
+    // Handle width allocation for fixedWidth columns (based on enhancedColumns)
     if (enhancedColumns && tableWidth && tableWidth > 0) {
-      // 检查是否有 fixedWidth 为 true 的列
+      // Check whether any column has fixedWidth set to true
       var hasFixedWidth = enhancedColumns.some(function (col) {
         return col.fixedWidth === true;
       });
       if (hasFixedWidth) {
-        // 过滤出可见列（排除 hidden 列，即宽度为 0.01 的列）
+        // Filter out visible columns (excluding hidden columns, i.e. those with width 0.01)
         var visibleColumns = enhancedColumns.filter(function (col) {
           return typeof col.width === "number" && col.width > 0.01;
         });
 
-        // 检查所有可见列是否都有宽度（非"100%"）
+        // Check whether all visible columns have a width (not "100%")
         var allHaveWidth = visibleColumns.every(function (col) {
           return col.width && col.width !== "100%" && typeof col.width === "number";
         });
         if (allHaveWidth && visibleColumns.length > 0) {
-          // 计算所有可见列的宽度总和
+          // Compute the total width of all visible columns
           var totalWidth = visibleColumns.reduce(function (sum, col) {
             var width = typeof col.width === "number" ? col.width : 0;
             return sum + width;
           }, 0);
 
-          // 如果总和小于表格宽度，按比例分配给非 fixedWidth 的可见列
-          // 当 bordered 为 true 时，tableWidth 需要减去 2（边框宽度）
-          // 当有 rowSelection 时，tableWidth 需要减去 48（选择列宽度）
+          // If the total is less than the table width, distribute proportionally to visible non-fixedWidth columns
+          // When bordered is true, subtract 2 from tableWidth (border width)
+          // When rowSelection is present, subtract 48 from tableWidth (selection column width)
           var adjustedTableWidth = bordered ? tableWidth - 2 : tableWidth;
           if (rowSelection) {
             adjustedTableWidth -= 48;
@@ -251,9 +252,9 @@ var useTableColumns = function useTableColumns(params) {
             }, 0);
             if (nonFixedWidthTotal > 0) {
               var _enhancedColumns2;
-              // 按比例分配多余宽度
+              // Distribute the extra width proportionally
               enhancedColumns = (_enhancedColumns2 = enhancedColumns) === null || _enhancedColumns2 === void 0 ? void 0 : _enhancedColumns2.map(function (col) {
-                // hidden 列（宽度为 0.01）或 fixedWidth 列保持原宽度
+                // hidden columns (width 0.01) and fixedWidth columns keep their original width
                 var currentWidth = typeof col.width === "number" ? col.width : 0;
                 if (col.fixedWidth === true || currentWidth <= 0.01) {
                   return col;
@@ -273,8 +274,9 @@ var useTableColumns = function useTableColumns(params) {
       var orderKey = column.orderKey || column.dataIndex;
       var isOrderColumn = orderKey && orderKey !== "serialNumber";
 
-      // measureAlign 列：把展示内容包进定宽右对齐块（块随列 align 居中），各行右边缘对齐。
-      // 不适用于 render 返回 { children, rowSpan } 这类 RenderedCell 的合并单元格场景。
+      // measureAlign columns: wrap the display content in a fixed-width right-aligned block
+      // (the block is centered per the column align), so all rows' right edges align.
+      // Not applicable to merged-cell scenarios where render returns a RenderedCell like { children, rowSpan }.
       var render = column.render;
       if (column.measureAlign) {
         var cellWidth = getMeasureAlignWidth(column, dataSource);
@@ -316,12 +318,12 @@ var useTableColumns = function useTableColumns(params) {
     });
   }, [enhanceColumns, serialNumberColumn, _columns, tableWidth, pagination, _pageNum, _pageSize, bordered, rowSelection, expandable, sorter, renderColumnTitle, order, mergeRowDataSource, dataSource]);
 
-  // 缓存渲染后的列配置
+  // Cache the rendered column config
   var renderedColumns = useMemo(function () {
     return renderColumns(cloneDeep(_columns));
   }, [renderColumns, _columns]);
 
-  // 处理排序变化
+  // Handle sort changes
   var handleTableChange = useCallback(function (pagination, filters, sorter, extra) {
     onChange === null || onChange === void 0 || onChange(pagination, filters, sorter, extra);
     var sorterResult = Array.isArray(sorter) ? sorter[0] : sorter;

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

@@ -16,7 +16,7 @@ var useTablePagination = function useTablePagination(params) {
     onShowSizeChange = params.onShowSizeChange,
     onStaticPaginationChange = params.onStaticPaginationChange;
 
-  // 直接传入原始值，不使用默认值，让 usePaginationSync 自行处理
+  // Pass the raw values directly without defaults; let usePaginationSync handle them itself
   var _usePaginationSync = usePaginationSync({
       current: params.current,
       pageSize: params.pageSize
@@ -38,7 +38,7 @@ var useTablePagination = function useTablePagination(params) {
     }
   }, [_dataSource, dataSource, staticDataSource, setPageNum]);
 
-  // 计算分页数据源
+  // Compute the paginated data source
   var paginatedDataSource = useMemo(function () {
     if (!pagination) return dataSource;
     if (staticDataSource) {
@@ -48,30 +48,30 @@ var useTablePagination = function useTablePagination(params) {
     return dataSource;
   }, [pagination, staticDataSource, _dataSource, _pageSize, _pageNum, dataSource]);
 
-  // 计算用于合并行的数据源
+  // Compute the data source used for merged rows
   var mergeRowDataSource = useMemo(function () {
     if (!pagination) return dataSource;
     var start = _pageSize * (_pageNum - 1);
     return _dataSource === null || _dataSource === void 0 ? void 0 : _dataSource.slice(start, start + _pageSize);
   }, [pagination, _dataSource, _pageSize, _pageNum, dataSource]);
 
-  // 处理分页变化
+  // Handle pagination changes
   var handlePageChange = useCallback(function (num, size) {
     setPageNum(num);
     setPageSize(size);
     onChangePage === null || onChangePage === void 0 || onChangePage(num, size);
-    // 当使用 staticDataSource 时，通过 onStaticPaginationChange 传递变化
+    // When staticDataSource is used, propagate the change via onStaticPaginationChange
     if (staticDataSource) {
       onStaticPaginationChange === null || onStaticPaginationChange === void 0 || onStaticPaginationChange(num, size);
     }
   }, [onChangePage, onStaticPaginationChange, staticDataSource, setPageNum, setPageSize]);
 
-  // 处理分页大小变化
+  // Handle page size changes
   var handlePageSizeChange = useCallback(function (page, size) {
     setPageNum(page);
     setPageSize(size);
     onShowSizeChange === null || onShowSizeChange === void 0 || onShowSizeChange(page, size);
-    // 当使用 staticDataSource 时，通过 onStaticPaginationChange 传递变化
+    // When staticDataSource is used, propagate the change via onStaticPaginationChange
     if (staticDataSource) {
       onStaticPaginationChange === null || onStaticPaginationChange === void 0 || onStaticPaginationChange(page, size);
     }