@hsu-react/ui 0.0.1

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

@@ -0,0 +1,75 @@
+function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+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 { useDebounceEffect, useMutationObserver } from "ahooks";
+import { useRef, useState } from "react";
+var useScrollEnd = function useScrollEnd(props) {
+  var cls = props.cls,
+    ref = props.ref,
+    dataSource = props.dataSource,
+    onScrollEnd = props.onScrollEnd,
+    _props$threshold = props.threshold,
+    threshold = _props$threshold === void 0 ? 50 : _props$threshold,
+    autoScrolling = props.autoScrolling;
+  var _useState = useState(false),
+    _useState2 = _slicedToArray(_useState, 2),
+    ready = _useState2[0],
+    setReady = _useState2[1];
+  var eventHandlersRef = useRef({});
+  useDebounceEffect(function () {
+    var body = null;
+
+    // 清理函数
+    var cleanup = function cleanup() {
+      // 移除事件监听器
+      if (body && eventHandlersRef.current.scroll) {
+        body.removeEventListener("scroll", eventHandlersRef.current.scroll);
+      }
+      eventHandlersRef.current = {};
+    };
+
+    // 当 autoScrolling 开启时，不启用此 hook
+    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) {
+        // 清理之前的监听器
+        cleanup();
+
+        // 添加滚动事件监听器
+        var handleScroll = function handleScroll() {
+          if (!body) {
+            return;
+          }
+
+          // 计算距离底部的距离
+          var scrollTop = body.scrollTop;
+          var scrollHeight = body.scrollHeight;
+          var clientHeight = body.clientHeight;
+          var distanceToBottom = scrollHeight - scrollTop - clientHeight;
+
+          // 当滚动到接近底部时触发
+          if (distanceToBottom <= threshold) {
+            onScrollEnd();
+          }
+        };
+        body.addEventListener("scroll", handleScroll, {
+          passive: true
+        });
+        eventHandlersRef.current = {
+          scroll: handleScroll
+        };
+      }
+    }
+    return cleanup;
+  }, [ref, cls, ready, dataSource, onScrollEnd, threshold, autoScrolling]);
+  useMutationObserver(function () {
+    setReady(true);
+  }, ref, {
+    childList: true,
+    subtree: true
+  });
+};
+export default useScrollEnd;

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

@@ -0,0 +1,16 @@
+/// <reference types="react" />
+import { TableProps } from "..";
+interface Params {
+    pagination?: TableProps["pagination"];
+    scroll?: TableProps["scroll"];
+    scrollAutoHeight?: boolean;
+    ref?: React.RefObject<HTMLDivElement>;
+    dataSource?: TableProps["dataSource"];
+    cls?: string;
+    fillPanel?: boolean;
+    columns?: TableProps["columns"];
+    bordered?: boolean;
+    virtual?: boolean;
+}
+declare const useSetTableHeight: (params: Params) => void;
+export default useSetTableHeight;

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

@@ -0,0 +1,50 @@
+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); }
+function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+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 { useState } from "react";
+import { useEffect } from "react";
+import { useMutationObserver } from "ahooks";
+var useSetTableHeight = function useSetTableHeight(params) {
+  var pagination = params.pagination,
+    scroll = params.scroll,
+    scrollAutoHeight = params.scrollAutoHeight,
+    ref = params.ref,
+    dataSource = params.dataSource,
+    cls = params.cls,
+    fillPanel = params.fillPanel,
+    columns = params.columns,
+    bordered = params.bordered,
+    virtual = params.virtual;
+  var _useState = useState(false),
+    _useState2 = _slicedToArray(_useState, 2),
+    ready = _useState2[0],
+    setReady = _useState2[1];
+  useEffect(function () {
+    if (scroll && ref && ref.current && ready && columns !== null && columns !== void 0 && columns.length && !virtual) {
+      var header = document.querySelector(".".concat(cls, " .ant-table-header"));
+      var body = document.querySelector(".".concat(cls, " .ant-table-tbody"));
+      var _pagination = document.querySelector(".".concat(cls, " .ant-pagination"));
+      var simplePagination = document.querySelector(".".concat(cls, " [class^='PaginationSimple']"));
+      var summary = document.querySelector(".".concat(cls, " .ant-table-summary"));
+      var table = ref.current;
+      var height = "".concat((header === null || header === void 0 ? void 0 : header.offsetHeight) + (body === null || body === void 0 ? void 0 : body.offsetHeight) + (summary ? summary === null || summary === void 0 ? void 0 : summary.offsetHeight : 0) + (pagination ? _pagination ? (_pagination === null || _pagination === void 0 ? void 0 : _pagination.offsetHeight) + 10 : simplePagination ? (simplePagination === null || simplePagination === void 0 ? void 0 : simplePagination.offsetHeight) + 10 : 0 : 0) + (bordered ? 1 : 0) + ((body === null || body === void 0 ? void 0 : body.offsetWidth) > table.offsetWidth ? 5 : 0), "px");
+      if (scrollAutoHeight && !fillPanel) {
+        table.style.height = height;
+        if (_typeof(scroll) === "object" && scroll.y !== false || scroll === true) {
+          table.style.maxHeight = "100%";
+        }
+      }
+    }
+  }, [dataSource, fillPanel, cls, pagination, ref, scroll, scrollAutoHeight, ready, columns, bordered, virtual]);
+  useMutationObserver(function () {
+    setReady(true);
+  }, ref, {
+    childList: true,
+    subtree: true
+  });
+};
+export default useSetTableHeight;

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

@@ -0,0 +1,40 @@
+/// <reference types="react" />
+import { ColumnsType, TableProps } from "..";
+import { AnyObject } from "antd/es/_util/type";
+import { TableRowSelection } from "antd/es/table/interface";
+import { PaginationProps } from "../_components/Pagination";
+interface UseTableColumnsParams<T extends AnyObject> {
+    columns?: ColumnsType<T>;
+    scroll?: boolean | {
+        y: boolean;
+    };
+    autoWidth?: boolean;
+    dataSource?: TableProps<T>["dataSource"];
+    enhanceColumns: (columns?: ColumnsType<T>) => ColumnsType<T> | undefined;
+    serialNumberColumn?: boolean;
+    pagination?: false | PaginationProps;
+    _pageNum: number;
+    _pageSize: number;
+    order?: {
+        k: string;
+        t: "asc" | "desc";
+    };
+    mergeRowDataSource?: readonly T[] | undefined;
+    onChange?: TableProps<T>["onChange"];
+    onOrderChange?: (order?: {
+        k: string;
+        t: "asc" | "desc";
+    }) => void;
+    sorter?: boolean;
+    ref?: React.RefObject<HTMLDivElement>;
+    cls?: string;
+    bordered?: boolean;
+    rowSelection?: TableRowSelection<T>;
+    expandable?: TableProps<T>["expandable"];
+}
+declare const useTableColumns: <T extends AnyObject>(params: UseTableColumnsParams<T>) => {
+    _columns: ColumnsType<T>;
+    renderedColumns: ColumnsType<T> | undefined;
+    handleTableChange: TableProps<T>["onChange"];
+};
+export default useTableColumns;

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

@@ -0,0 +1,275 @@
+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); }
+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; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+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 { useCallback, useMemo, useEffect, useState } from "react";
+import { cloneDeep } from "lodash";
+import { Tooltip } from "antd";
+import Icon from "../../Icon";
+import styles from "../index.module.less";
+import { get_string_size } from "hsu-utils";
+import classNames from "classnames";
+import { getDepartmentRowSpan, HELP_TOOLTIP_CONFIG } from "../_utils/tableUtils";
+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";
+var useTableColumns = function useTableColumns(params) {
+  var _params$columns = params.columns,
+    columns = _params$columns === void 0 ? [] : _params$columns,
+    scroll = params.scroll,
+    autoWidth = params.autoWidth,
+    dataSource = params.dataSource,
+    enhanceColumns = params.enhanceColumns,
+    _params$serialNumberC = params.serialNumberColumn,
+    serialNumberColumn = _params$serialNumberC === void 0 ? false : _params$serialNumberC,
+    pagination = params.pagination,
+    _pageNum = params._pageNum,
+    _pageSize = params._pageSize,
+    order = params.order,
+    mergeRowDataSource = params.mergeRowDataSource,
+    onChange = params.onChange,
+    onOrderChange = params.onOrderChange,
+    sorter = params.sorter,
+    ref = params.ref,
+    cls = params.cls,
+    bordered = params.bordered,
+    rowSelection = params.rowSelection,
+    expandable = params.expandable;
+  var _usePermissions = usePermissions(),
+    checkPermission = _usePermissions.checkPermission;
+  var _useState = useState(null),
+    _useState2 = _slicedToArray(_useState, 2),
+    tableWidth = _useState2[0],
+    setTableWidth = _useState2[1];
+
+  // 监听表格宽度变化
+  useEffect(function () {
+    if (ref !== null && ref !== void 0 && ref.current && cls) {
+      var tableElement = document.querySelector(".".concat(cls, " .ant-table"));
+      if (tableElement) {
+        var updateWidth = function updateWidth() {
+          var width = tableElement.offsetWidth;
+          if (width > 0) {
+            setTableWidth(width);
+          }
+        };
+        updateWidth();
+        var resizeObserver = new ResizeObserver(updateWidth);
+        resizeObserver.observe(tableElement);
+        return function () {
+          return resizeObserver.disconnect();
+        };
+      }
+    }
+  }, [ref, cls]);
+
+  // 处理列的基础设置（权限、宽度、排序等）
+  var _columns = useMemo(function () {
+    var _cloned$map;
+    var cloned = cloneDeep(columns);
+    var newColumns = cloned === null || cloned === void 0 || (_cloned$map = cloned.map(function (item, idx) {
+      var _ref, _item$key;
+      return _objectSpread(_objectSpread({}, item), {}, {
+        width: !item.width ? "100%" : item.width,
+        key: (_ref = (_item$key = item.key) !== null && _item$key !== void 0 ? _item$key : item.dataIndex) !== null && _ref !== void 0 ? _ref : "col_".concat(idx),
+        hidden: !checkPermission(item.hasPermi) || item.hidden,
+        ellipsis: typeof item.ellipsis === "boolean" ? item.ellipsis : true
+      });
+    })) === null || _cloned$map === void 0 || (_cloned$map = _cloned$map.sort(function (a, b) {
+      var _a$sort, _b$sort;
+      return ((_a$sort = a === null || a === void 0 ? void 0 : a.sort) !== null && _a$sort !== void 0 ? _a$sort : 0) - ((_b$sort = b === null || b === void 0 ? void 0 : b.sort) !== null && _b$sort !== void 0 ? _b$sort : 0);
+    })) === null || _cloned$map === void 0 || (_cloned$map = _cloned$map.map(function (item) {
+      if (autoWidth && item.width === "100%" && scroll && (typeof item.title === "string" || typeof item.title === "number")) {
+        var _item$title, _dataSource$reduce;
+        var _get_string_size = get_string_size((_item$title = item.title) === null || _item$title === void 0 ? void 0 : _item$title.toString(), {
+            size: 14
+          }),
+          titleWidth = _get_string_size.width;
+        if (item.help) {
+          titleWidth += 22;
+        }
+        var dataIndexWidth = item.dataIndex ? (_dataSource$reduce = dataSource === null || dataSource === void 0 ? void 0 : dataSource.reduce(function (acc, cur) {
+          var _cur;
+          return Math.max(acc, get_string_size((_cur = cur[item.dataIndex]) === null || _cur === void 0 ? void 0 : _cur.toString(), {
+            size: 14
+          }).width);
+        }, 0)) !== null && _dataSource$reduce !== void 0 ? _dataSource$reduce : 0 : 0;
+        item.width = Math.max(titleWidth, dataIndexWidth) + 32;
+      }
+      return item;
+    })) === null || _cloned$map === void 0 ? void 0 : _cloned$map.map(function (item) {
+      return _objectSpread(_objectSpread({}, item), {}, {
+        width: item.hidden ? 0.01 : item.width,
+        className: classNames(item.className, _defineProperty({}, styles.hidden, item.hidden)),
+        hidden: undefined
+      });
+    });
+    return newColumns;
+  }, [autoWidth, columns, dataSource, checkPermission, scroll]);
+
+  // 渲染列标题
+  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) {
+      return titleContent;
+    }
+    return /*#__PURE__*/_jsxs(_Fragment, {
+      children: [titleContent, /*#__PURE__*/_jsx(Tooltip, _objectSpread(_objectSpread({
+        title: column.help
+      }, HELP_TOOLTIP_CONFIG), {}, {
+        children: /*#__PURE__*/_jsx(Icon, {
+          icon: "material-symbols:help",
+          className: styles.help,
+          fontSize: 16,
+          color: "#999999"
+        })
+      }))]
+    });
+  }, []);
+  var renderColumns = useCallback(function (columns) {
+    var _enhancedColumns3;
+    // 先增强列配置，为 ellipsis 列添加自动 Tooltip
+    var enhancedColumns = enhanceColumns(columns);
+    if (serialNumberColumn && !_columns.find(function (v) {
+      return !!v.children;
+    })) {
+      var _enhancedColumns;
+      (_enhancedColumns = enhancedColumns) === null || _enhancedColumns === void 0 || _enhancedColumns.unshift({
+        title: "序号",
+        dataIndex: "serialNumber",
+        width: 60,
+        align: "center",
+        render: function render(_, __, index) {
+          return pagination ? (_pageNum - 1) * _pageSize + (index + 1) : index + 1;
+        },
+        fixedWidth: true
+      });
+    }
+
+    // 处理 fixedWidth 列的宽度分配（在 enhancedColumns 基础上）
+    if (enhancedColumns && tableWidth && tableWidth > 0) {
+      // 检查是否有 fixedWidth 为 true 的列
+      var hasFixedWidth = enhancedColumns.some(function (col) {
+        return col.fixedWidth === true;
+      });
+      if (hasFixedWidth) {
+        // 过滤出可见列（排除 hidden 列，即宽度为 0.01 的列）
+        var visibleColumns = enhancedColumns.filter(function (col) {
+          return typeof col.width === "number" && col.width > 0.01;
+        });
+
+        // 检查所有可见列是否都有宽度（非"100%"）
+        var allHaveWidth = visibleColumns.every(function (col) {
+          return col.width && col.width !== "100%" && typeof col.width === "number";
+        });
+        if (allHaveWidth && visibleColumns.length > 0) {
+          // 计算所有可见列的宽度总和
+          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（选择列宽度）
+          var adjustedTableWidth = bordered ? tableWidth - 2 : tableWidth;
+          if (rowSelection) {
+            adjustedTableWidth -= 48;
+          }
+          if (expandable) {
+            adjustedTableWidth -= 48;
+          }
+          if (totalWidth < adjustedTableWidth) {
+            var extraWidth = adjustedTableWidth - totalWidth;
+            var nonFixedWidthColumns = visibleColumns.filter(function (col) {
+              return col.fixedWidth !== true;
+            });
+            var nonFixedWidthTotal = nonFixedWidthColumns.reduce(function (sum, col) {
+              var width = typeof col.width === "number" ? col.width : 0;
+              return sum + width;
+            }, 0);
+            if (nonFixedWidthTotal > 0) {
+              var _enhancedColumns2;
+              // 按比例分配多余宽度
+              enhancedColumns = (_enhancedColumns2 = enhancedColumns) === null || _enhancedColumns2 === void 0 ? void 0 : _enhancedColumns2.map(function (col) {
+                // hidden 列（宽度为 0.01）或 fixedWidth 列保持原宽度
+                var currentWidth = typeof col.width === "number" ? col.width : 0;
+                if (col.fixedWidth === true || currentWidth <= 0.01) {
+                  return col;
+                }
+                var ratio = currentWidth / nonFixedWidthTotal;
+                var additionalWidth = extraWidth * ratio;
+                return _objectSpread(_objectSpread({}, col), {}, {
+                  width: +(currentWidth + additionalWidth).toFixed(2)
+                });
+              });
+            }
+          }
+        }
+      }
+    }
+    return (_enhancedColumns3 = enhancedColumns) === null || _enhancedColumns3 === void 0 ? void 0 : _enhancedColumns3.map(function (column) {
+      var orderKey = column.orderKey || column.dataIndex;
+      var isOrderColumn = orderKey && orderKey !== "serialNumber";
+      return _objectSpread(_objectSpread({
+        showSorterTooltip: false,
+        sorter: typeof sorter === "boolean" ? sorter : isOrderColumn ? true : false
+      }, column), {}, {
+        orderKey: orderKey,
+        title: renderColumnTitle(column),
+        children: column !== null && column !== void 0 && column.children ? renderColumns(column.children) : undefined,
+        onCell: function onCell(record, index) {
+          var _column$onCell;
+          var cell = column === null || column === void 0 || (_column$onCell = column.onCell) === null || _column$onCell === void 0 ? void 0 : _column$onCell.call(column, record, index);
+          var rowSpan = 1;
+          if (column.mergeRow) {
+            rowSpan = getDepartmentRowSpan(record, index, mergeRowDataSource, column.dataIndex);
+          }
+          return _objectSpread({
+            rowSpan: rowSpan
+          }, cell);
+        },
+        sortOrder: (order === null || order === void 0 ? void 0 : order.k) === orderKey ? (order === null || order === void 0 ? void 0 : order.t) === "desc" ? "descend" : "ascend" : undefined
+      });
+    });
+  }, [enhanceColumns, serialNumberColumn, _columns, tableWidth, pagination, _pageNum, _pageSize, bordered, rowSelection, expandable, sorter, renderColumnTitle, order, mergeRowDataSource]);
+
+  // 缓存渲染后的列配置
+  var renderedColumns = useMemo(function () {
+    return renderColumns(cloneDeep(_columns));
+  }, [renderColumns, _columns]);
+
+  // 处理排序变化
+  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;
+    var column = sorterResult.column,
+      _order = sorterResult.order;
+    var columnOrderKey = column === null || column === void 0 ? void 0 : column.orderKey;
+    var k = columnOrderKey !== null && columnOrderKey !== void 0 ? columnOrderKey : order === null || order === void 0 ? void 0 : order.k;
+    if (!k || !_order) {
+      onOrderChange === null || onOrderChange === void 0 || onOrderChange(undefined);
+    } else {
+      var t = _order === "ascend" ? "asc" : "desc";
+      onOrderChange === null || onOrderChange === void 0 || onOrderChange({
+        k: k,
+        t: t
+      });
+    }
+  }, [onChange, onOrderChange, order]);
+  return {
+    _columns: _columns,
+    renderedColumns: renderedColumns,
+    handleTableChange: handleTableChange
+  };
+};
+export default useTableColumns;

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

@@ -0,0 +1,26 @@
+/// <reference types="react" />
+import { PaginationProps } from "../_components/Pagination";
+import { TableProps } from "..";
+import { AnyObject } from "antd/es/_util/type";
+interface UseTablePaginationParams<T extends AnyObject> {
+    dataSource?: TableProps<T>["dataSource"];
+    pagination?: false | PaginationProps;
+    staticDataSource?: boolean;
+    current?: number;
+    pageSize?: number;
+    onChangePage?: (page: number, pageSize: number) => void;
+    onShowSizeChange?: (page: number, pageSize: number) => void;
+    onStaticPaginationChange?: (page: number, pageSize: number) => void;
+}
+declare const useTablePagination: <T extends AnyObject>(params: UseTablePaginationParams<T>) => {
+    _pageNum: number;
+    _pageSize: number;
+    _dataSource: readonly T[] | undefined;
+    setPageNum: import("react").Dispatch<import("react").SetStateAction<number>>;
+    setPageSize: import("react").Dispatch<import("react").SetStateAction<number>>;
+    paginatedDataSource: readonly T[] | undefined;
+    mergeRowDataSource: readonly T[] | undefined;
+    handlePageChange: (num: number, size: number) => void;
+    handlePageSizeChange: (page: number, size: number) => void;
+};
+export default useTablePagination;

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

@@ -0,0 +1,91 @@
+function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+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 { useCallback, useEffect, useMemo, useState } from "react";
+import { Equal } from "hsu-utils";
+import usePaginationSync from "./usePaginationSync";
+var useTablePagination = function useTablePagination(params) {
+  var dataSource = params.dataSource,
+    pagination = params.pagination,
+    _params$staticDataSou = params.staticDataSource,
+    staticDataSource = _params$staticDataSou === void 0 ? false : _params$staticDataSou,
+    onChangePage = params.onChangePage,
+    onShowSizeChange = params.onShowSizeChange,
+    onStaticPaginationChange = params.onStaticPaginationChange;
+
+  // 直接传入原始值，不使用默认值，让 usePaginationSync 自行处理
+  var _usePaginationSync = usePaginationSync({
+      current: params.current,
+      pageSize: params.pageSize
+    }),
+    _pageNum = _usePaginationSync._pageNum,
+    _pageSize = _usePaginationSync._pageSize,
+    setPageNum = _usePaginationSync.setPageNum,
+    setPageSize = _usePaginationSync.setPageSize;
+  var _useState = useState([]),
+    _useState2 = _slicedToArray(_useState, 2),
+    _dataSource = _useState2[0],
+    setDataSource = _useState2[1];
+  useEffect(function () {
+    if (!Equal.ObjEqual(dataSource, _dataSource)) {
+      setDataSource(dataSource);
+      if (staticDataSource) {
+        setPageNum(1);
+      }
+    }
+  }, [_dataSource, dataSource, staticDataSource, setPageNum]);
+
+  // 计算分页数据源
+  var paginatedDataSource = useMemo(function () {
+    if (!pagination) return dataSource;
+    if (staticDataSource) {
+      var start = _pageSize * (_pageNum - 1);
+      return _dataSource === null || _dataSource === void 0 ? void 0 : _dataSource.slice(start, start + _pageSize);
+    }
+    return dataSource;
+  }, [pagination, staticDataSource, _dataSource, _pageSize, _pageNum, dataSource]);
+
+  // 计算用于合并行的数据源
+  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]);
+
+  // 处理分页变化
+  var handlePageChange = useCallback(function (num, size) {
+    setPageNum(num);
+    setPageSize(size);
+    onChangePage === null || onChangePage === void 0 || onChangePage(num, size);
+    // 当使用 staticDataSource 时，通过 onStaticPaginationChange 传递变化
+    if (staticDataSource) {
+      onStaticPaginationChange === null || onStaticPaginationChange === void 0 || onStaticPaginationChange(num, size);
+    }
+  }, [onChangePage, onStaticPaginationChange, staticDataSource, setPageNum, setPageSize]);
+
+  // 处理分页大小变化
+  var handlePageSizeChange = useCallback(function (page, size) {
+    setPageNum(page);
+    setPageSize(size);
+    onShowSizeChange === null || onShowSizeChange === void 0 || onShowSizeChange(page, size);
+    // 当使用 staticDataSource 时，通过 onStaticPaginationChange 传递变化
+    if (staticDataSource) {
+      onStaticPaginationChange === null || onStaticPaginationChange === void 0 || onStaticPaginationChange(page, size);
+    }
+  }, [onShowSizeChange, onStaticPaginationChange, staticDataSource, setPageNum, setPageSize]);
+  return {
+    _pageNum: _pageNum,
+    _pageSize: _pageSize,
+    _dataSource: _dataSource,
+    setPageNum: setPageNum,
+    setPageSize: setPageSize,
+    paginatedDataSource: paginatedDataSource,
+    mergeRowDataSource: mergeRowDataSource,
+    handlePageChange: handlePageChange,
+    handlePageSizeChange: handlePageSizeChange
+  };
+};
+export default useTablePagination;

package/es/components/Table/_utils/tableUtils.d.ts

@@ -0,0 +1,23 @@
+/**
+ * 获取相同值的连续行数
+ * @param record 当前行数据
+ * @param index 当前行索引
+ * @param dataSource 数据源
+ * @param key 相同值的key
+ * @returns 相同值的连续行数
+ */
+export declare function getDepartmentRowSpan<T extends Record<string, unknown>>(record: T, index: number, dataSource: T[], key: string): number;
+/**
+ * Tooltip 配置常量
+ */
+export declare const HELP_TOOLTIP_CONFIG: {
+    arrow: boolean;
+    placement: "top";
+    color: string;
+    styles: {
+        body: {
+            color: string;
+            padding: string;
+        };
+    };
+};

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

@@ -0,0 +1,42 @@
+/**
+ * 获取相同值的连续行数
+ * @param record 当前行数据
+ * @param index 当前行索引
+ * @param dataSource 数据源
+ * @param key 相同值的key
+ * @returns 相同值的连续行数
+ */
+export function getDepartmentRowSpan(record, index, dataSource, key) {
+  var current = record[key];
+
+  // 如果不是该值的第一行，返回0（不显示）
+  if (index > 0 && dataSource[index - 1][key] === current) {
+    return 0;
+  }
+
+  // 计算相同值的连续行数
+  var count = 1;
+  for (var i = index + 1; i < dataSource.length; i++) {
+    if (dataSource[i][key] === current) {
+      count++;
+    } else {
+      break;
+    }
+  }
+  return count;
+}
+
+/**
+ * Tooltip 配置常量
+ */
+export var HELP_TOOLTIP_CONFIG = {
+  arrow: false,
+  placement: "top",
+  color: "#f2f4f5",
+  styles: {
+    body: {
+      color: "#131212",
+      padding: "6px 16px"
+    }
+  }
+};