@dtjoy/dt-design 1.1.2 → 1.1.5

package/lib/table/InternalTable.js

@@ -0,0 +1,824 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var React = _interopRequireWildcard(require("react"));
+var _constant = require("./constant");
+var _useColumns = require("./features/columns/useColumns");
+var _rcUtil = require("../_util/rcUtil");
+var _clsx4 = require("clsx");
+var _useProxyImperativeHandle = require("../_util/hooks/useProxyImperativeHandle");
+var _is = require("../_util/is");
+var _scrollTo = _interopRequireDefault(require("../_util/scrollTo"));
+var _warning = require("../_util/warning");
+var _useBreakpoint = require("../_util/hooks/useBreakpoint");
+var _useCssVar = _interopRequireDefault(require("../_util/hooks/useCssVar"));
+var _pagination = _interopRequireDefault(require("antd/lib/pagination"));
+var _spin = _interopRequireDefault(require("antd/lib/spin"));
+var _configProvider = require("antd/lib/config-provider");
+var _ExpandIcon = _interopRequireDefault(require("./components/ExpandIcon"));
+var _useContainerWidth = _interopRequireDefault(require("./shared/hooks/useContainerWidth"));
+var _useFilledColumns = _interopRequireDefault(require("./features/columns/useFilledColumns"));
+var _useFilter3 = _interopRequireWildcard(require("./features/filter/useFilter"));
+var _useLazyKVMap3 = _interopRequireDefault(require("./shared/hooks/useLazyKVMap"));
+var _usePagination3 = _interopRequireWildcard(require("./features/pagination/usePagination"));
+var _useSelection3 = _interopRequireDefault(require("./features/selection/useSelection"));
+var _useSorter3 = _interopRequireWildcard(require("./features/sort/useSorter"));
+var _useTitleColumns3 = _interopRequireDefault(require("./features/columns/useTitleColumns"));
+var _RcTable = _interopRequireDefault(require("./components/RcTable"));
+var _VirtualTable = _interopRequireDefault(require("./components/VirtualTable"));
+var _defaultRenderEmpty = _interopRequireDefault(require("antd/lib/config-provider/defaultRenderEmpty"));
+var _resize = require("./features/resize");
+var _editable = require("./features/editable");
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(e) { return e ? t : r; })(e); }
+function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != _typeof(e) && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && Object.prototype.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
+function _extends() { _extends = Object.assign ? Object.assign.bind() : function (target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i]; for (var key in source) { if (Object.prototype.hasOwnProperty.call(source, key)) { target[key] = source[key]; } } } return target; }; return _extends.apply(this, arguments); }
+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; }
+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); }
+/** 稳定的空配置引用 */
+var EMPTY_EDITABLE_CONFIG = {};
+var EMPTY_LIST = [];
+var HeaderTableContext = /*#__PURE__*/React.createContext({});
+var HeaderTable = function HeaderTable(props) {
+  var _React$useContext = React.useContext(HeaderTableContext),
+    ariaProps = _React$useContext.ariaProps,
+    _React$useContext$com = _React$useContext.component,
+    component = _React$useContext$com === void 0 ? 'table' : _React$useContext$com;
+  return /*#__PURE__*/React.createElement(component, _objectSpread(_objectSpread({}, ariaProps), props));
+};
+if (process.env.NODE_ENV !== 'production') {
+  HeaderTable.displayName = 'HeaderTable';
+}
+
+/** Same as `TableProps` but we need record parent render times */
+
+var InternalTable = function InternalTable(props, ref) {
+  var _components$header2, _mergedPagination$cur, _mergedPagination$pag, _mergedPagination$cur2, _mergedPagination$pag2;
+  var customizePrefixCls = props.prefixCls,
+    className = props.className,
+    rootClassName = props.rootClassName,
+    style = props.style,
+    customizeSize = props.size,
+    bordered = props.bordered,
+    customizeDropdownPrefixCls = props.dropdownPrefixCls,
+    dataSource = props.dataSource,
+    pagination = props.pagination,
+    customizeRowSelection = props.rowSelection,
+    customizeRowKey = props.rowKey,
+    rowClassName = props.rowClassName,
+    column = props.column,
+    columns = props.columns,
+    children = props.children,
+    legacyChildrenColumnName = props.childrenColumnName,
+    onChange = props.onChange,
+    getPopupContainer = props.getPopupContainer,
+    loading = props.loading,
+    expandIcon = props.expandIcon,
+    expandable = props.expandable,
+    expandedRowRender = props.expandedRowRender,
+    expandIconColumnIndex = props.expandIconColumnIndex,
+    indentSize = props.indentSize,
+    scroll = props.scroll,
+    sortDirections = props.sortDirections,
+    locale = props.locale,
+    _props$showSorterTool = props.showSorterTooltip,
+    showSorterTooltip = _props$showSorterTool === void 0 ? {
+      target: 'full-header'
+    } : _props$showSorterTool,
+    virtual = props.virtual,
+    _props$resizable = props.resizable,
+    resizable = _props$resizable === void 0 ? false : _props$resizable,
+    onColumnResizeProp = props.onColumnResize,
+    _props$editable = props.editable,
+    editableEnabled = _props$editable === void 0 ? false : _props$editable,
+    onEditableChange = props.onEditableChange,
+    onValidateProp = props.onValidate;
+  var warning = (0, _warning.devUseWarning)('Table');
+  var rawColumns = React.useMemo(function () {
+    return columns || (0, _useColumns.convertChildrenToColumns)(children);
+  }, [columns, children]);
+  var baseColumns = (0, _useFilledColumns.default)(rawColumns, column);
+  var needResponsive = React.useMemo(function () {
+    return baseColumns.some(function (col) {
+      return col.responsive;
+    });
+  }, [baseColumns]);
+  var screens = (0, _useBreakpoint.useBreakpoint)(needResponsive);
+  var mergedColumns = React.useMemo(function () {
+    var matched = new Set(Object.keys(screens).filter(function (m) {
+      return screens[m];
+    }));
+    return baseColumns.filter(function (c) {
+      return !c.responsive || c.responsive.some(function (r) {
+        return matched.has(r);
+      });
+    });
+  }, [baseColumns, screens]);
+
+  // ========================= Column Resize (hasResizableColumns check only) =========================
+  var hasResizableColumns = React.useMemo(function () {
+    return resizable || mergedColumns.some(function (col) {
+      return 'resizable' in col ? col.resizable === true : false;
+    });
+  }, [resizable, mergedColumns]);
+
+  // ========================= Editable =========================
+  var hasEditableColumns = React.useMemo(function () {
+    return editableEnabled || mergedColumns.some(function (col) {
+      var ed = 'editable' in col ? col.editable : undefined;
+      // 与 parseEditableConfig 语义对齐：列显式开启 = true 或任意配置对象；
+      // editable === false（显式关闭）或未配置 → 非显式开启，
+      // 全局开启时由 parseEditableConfig 继承、false 时优先关闭
+      return ed === true || ed !== null && _typeof(ed) === 'object';
+    });
+  }, [editableEnabled, mergedColumns]);
+  var tableProps = (0, _rcUtil.omit)(props, ['className', 'style', 'column', 'columns', 'resizable', 'onColumnResize', 'editable', 'onEditableChange', 'onValidate']);
+  var components = tableProps.components;
+  var ariaProps = (0, _rcUtil.pickAttrs)(tableProps, {
+    aria: true
+  });
+  var hasAriaProps = Object.keys(ariaProps).length > 0;
+  var headerTableContext = React.useMemo(function () {
+    var _components$header;
+    return {
+      ariaProps: ariaProps,
+      component: components === null || components === void 0 || (_components$header = components.header) === null || _components$header === void 0 ? void 0 : _components$header.table
+    };
+  }, [ariaProps, components === null || components === void 0 || (_components$header2 = components.header) === null || _components$header2 === void 0 ? void 0 : _components$header2.table]);
+  var prefixCls = (0, _configProvider.globalConfig)().getPrefixCls('table', customizePrefixCls);
+
+  // ============================= Refs =============================
+  var rootRef = React.useRef(null);
+  var tblRef = React.useRef(null);
+
+  // ========================= Column Resize (hook needs rootRef) =========================
+  var resizeResult = (0, _resize.useResize)({
+    columns: mergedColumns,
+    enabled: resizable,
+    containerRef: rootRef,
+    onColumnResize: onColumnResizeProp,
+    prefixCls: prefixCls
+  });
+  var mergedComponents = React.useMemo(function () {
+    if (!hasAriaProps) return components;
+    return _objectSpread(_objectSpread({}, components), {}, {
+      header: _objectSpread(_objectSpread({}, components === null || components === void 0 ? void 0 : components.header), {}, {
+        table: HeaderTable
+      })
+    });
+  }, [components, hasAriaProps]);
+
+  // Use antd@4 ConfigContext for locale and renderEmpty
+  var _ref = React.useContext(_configProvider.ConfigContext),
+    contextLocale = _ref.locale,
+    renderEmpty = _ref.renderEmpty,
+    getContextPopupContainer = _ref.getPopupContainer;
+  var tableLocale = _objectSpread(_objectSpread({
+    filterTitle: 'Filter',
+    filterConfirm: 'OK',
+    filterReset: 'Reset',
+    filterEmptyText: 'No filters',
+    filterCheckAll: 'Select all items',
+    filterSearchPlaceholder: 'Search in filters',
+    emptyText: (renderEmpty === null || renderEmpty === void 0 ? void 0 : renderEmpty('Table')) || 'No data',
+    selectAll: 'Select current page',
+    selectInvert: 'Invert current page',
+    selectNone: 'Clear all data',
+    selectionAll: 'Select all data',
+    sortTitle: 'Sort',
+    expand: 'Expand row',
+    collapse: 'Collapse row',
+    triggerDesc: 'Click to sort descending',
+    triggerAsc: 'Click to sort ascending',
+    cancelSort: 'Click to cancel sorting'
+  }, contextLocale === null || contextLocale === void 0 ? void 0 : contextLocale.Table), locale);
+  var rawData = dataSource || EMPTY_LIST;
+  var dropdownPrefixCls = (0, _configProvider.globalConfig)().getPrefixCls('dropdown', customizeDropdownPrefixCls);
+  var mergedRowSelection = React.useMemo(function () {
+    return (0, _is.isPlainObject)(customizeRowSelection) ? _objectSpread({}, customizeRowSelection) : customizeRowSelection;
+  }, [customizeRowSelection]);
+  var mergedExpandable = _objectSpread({
+    childrenColumnName: legacyChildrenColumnName,
+    expandIconColumnIndex: expandIconColumnIndex
+  }, expandable);
+  var _mergedExpandable$chi = mergedExpandable.childrenColumnName,
+    childrenColumnName = _mergedExpandable$chi === void 0 ? 'children' : _mergedExpandable$chi;
+  var expandType = React.useMemo(function () {
+    if (rawData.some(function (item) {
+      return item === null || item === void 0 ? void 0 : item[childrenColumnName];
+    })) {
+      return 'nest';
+    }
+    if (expandedRowRender || expandable !== null && expandable !== void 0 && expandable.expandedRowRender) {
+      return 'row';
+    }
+    return null;
+  }, [childrenColumnName, rawData]);
+  var internalRef = {
+    body: React.useRef(null)
+  };
+
+  // ============================ Width =============================
+  var getContainerWidth = (0, _useContainerWidth.default)(prefixCls);
+
+  // 用 resize 后的渲染宽度覆盖列的 width
+  // renderWidth = column.width + 容器剩余空间分配到最后一列（撑满容器，不留空）
+  var finalColumns = React.useMemo(function () {
+    if (!hasResizableColumns) return mergedColumns;
+    return mergedColumns.map(function (col) {
+      var width = resizeResult.getColumnRenderWidth(col);
+      return width != null ? _objectSpread(_objectSpread({}, col), {}, {
+        width: width
+      }) : col;
+    });
+  }, [mergedColumns, hasResizableColumns, resizeResult.renderWidths]);
+
+  // 用于暴露 validate / resetErrors 的 ref
+  var editableMethodsRef = React.useRef(null);
+
+  // 跨页滚动 timer ref（防止组件卸载后 timer 泄漏）
+  var scrollTimerRef = React.useRef(null);
+  React.useEffect(function () {
+    return function () {
+      if (scrollTimerRef.current) clearTimeout(scrollTimerRef.current);
+    };
+  }, []);
+
+  // ============================ RowKey ============================
+  var rowKey = customizeRowKey || 'key';
+
+  // ============================ Scroll ============================
+  // 当 resize 启用且容器宽度已测量时，用 scrollX（= renderWidths 总和）覆盖 scroll.x
+  // 确保 table 宽度 = 列宽总和，避免不匹配导致的滚动条问题
+  var mergedScroll = React.useMemo(function () {
+    if (hasResizableColumns && resizeResult.scrollX != null) {
+      return _objectSpread(_objectSpread({}, scroll), {}, {
+        x: resizeResult.scrollX
+      });
+    }
+    return scroll;
+  }, [scroll, hasResizableColumns, resizeResult.scrollX]);
+  if (process.env.NODE_ENV !== 'production') {
+    warning(!((0, _is.isFunction)(rowKey) && rowKey.length > 1), 'usage', '`index` parameter of `rowKey` function is deprecated. There is no guarantee that it will work as expected.');
+  }
+  var getRowKey = React.useMemo(function () {
+    if ((0, _is.isFunction)(rowKey)) {
+      return rowKey;
+    }
+    return function (record) {
+      return record === null || record === void 0 ? void 0 : record[rowKey];
+    };
+  }, [rowKey]);
+  var _useLazyKVMap = (0, _useLazyKVMap3.default)(rawData, childrenColumnName, getRowKey),
+    _useLazyKVMap2 = _slicedToArray(_useLazyKVMap, 1),
+    getRecordByKey = _useLazyKVMap2[0];
+
+  // 分页偏移量 ref — 用于将 page-local rowIndex 转换为 rawData 全局 index
+  // 修复 BUG: 分页时 EditableCell 收到的是 page-local index，但 useEditable 的
+  // onCellChange / validateCell 用此 index 匹配 rawData，导致跨页编辑写入错误行。
+  var pageOffsetRef = React.useRef(0);
+
+  // mergedData（排序/筛选后、分页前）ref — scrollToRow 按 rowKey 定位行所在页时使用。
+  // useEditable 在 mergedData 计算之前调用，所以用 ref 传递（同 paginationInfoRef 模式）。
+  var mergedDataRef = React.useRef(EMPTY_LIST);
+
+  // 分页控制 ref — validate 时用于自动跳转到错误行所在页
+  // useEditable 在 usePagination 之前调用，所以用 ref 传递
+  var resetPaginationRef = React.useRef(function () {});
+  var paginationInfoRef = React.useRef({
+    current: 1,
+    pageSize: 10,
+    enabled: false
+  });
+
+  // ============================ Editable =============================
+  var editableResult = (0, _editable.useEditable)({
+    columns: mergedColumns,
+    data: rawData,
+    onChange: onEditableChange,
+    onValidate: onValidateProp,
+    getRowKey: getRowKey,
+    childrenColumnName: childrenColumnName,
+    scrollToRow: function scrollToRow(key, idx) {
+      var _paginationInfoRef$cu = paginationInfoRef.current,
+        current = _paginationInfoRef$cu.current,
+        pageSize = _paginationInfoRef$cu.pageSize,
+        enabled = _paginationInfoRef$cu.enabled;
+      // 在 mergedData（排序/筛选后、分页前）中按 key 定位顶层行下标；
+      // 树形子行归属于其顶层祖先。定位失败（无 key / 行被过滤掉）降级为传入下标。
+      var matchRow = function matchRow(row, index) {
+        if (getRowKey(row, index) === key) return true;
+        var children = row === null || row === void 0 ? void 0 : row[childrenColumnName];
+        return Array.isArray(children) && children.some(function (child, ci) {
+          return matchRow(child, ci);
+        });
+      };
+      var list = mergedDataRef.current;
+      var topIndex = -1;
+      for (var i = 0; i < list.length; i += 1) {
+        if (matchRow(list[i], i)) {
+          topIndex = i;
+          break;
+        }
+      }
+      var foundByKey = topIndex !== -1;
+      if (!foundByKey) topIndex = idx;
+      var scrollToRowOnPage = function scrollToRowOnPage(pageLocalIdx) {
+        // key 定位成功时直接按 key 滚动（树形子行也能命中）；否则用页内下标
+        if (foundByKey) {
+          var _tblRef$current;
+          (_tblRef$current = tblRef.current) === null || _tblRef$current === void 0 || _tblRef$current.scrollTo({
+            key: key,
+            align: 'center'
+          });
+        } else {
+          var _tblRef$current2;
+          (_tblRef$current2 = tblRef.current) === null || _tblRef$current2 === void 0 || _tblRef$current2.scrollTo({
+            index: pageLocalIdx,
+            align: 'center'
+          });
+        }
+      };
+      if (enabled && pageSize > 0) {
+        var targetPage = Math.floor(topIndex / pageSize) + 1;
+        if (targetPage !== current) {
+          if ((0, _is.isPlainObject)(pagination) && pagination.current !== undefined) {
+            var _pagination$onChange;
+            // 受控分页：current 由外部持有，内部 setState 无法换页（merge 时受控值优先），
+            // 自动跳页只能通过 onChange 发起请求，由外部响应后更新 current
+            (_pagination$onChange = pagination.onChange) === null || _pagination$onChange === void 0 || _pagination$onChange.call(pagination, targetPage, pageSize);
+          } else {
+            // 切换到错误行所在页
+            resetPaginationRef.current(targetPage, pageSize);
+          }
+          // 等待页面渲染后滚动到错误行（page-local index）
+          var localIdx = topIndex - (targetPage - 1) * pageSize;
+          if (scrollTimerRef.current) clearTimeout(scrollTimerRef.current);
+          scrollTimerRef.current = setTimeout(function () {
+            scrollToRowOnPage(localIdx);
+            scrollTimerRef.current = null;
+          }, 50);
+          return;
+        }
+        // 同页：直接滚动（使用 page-local index）
+        scrollToRowOnPage(topIndex - (current - 1) * pageSize);
+      } else {
+        // 无分页：直接用全局 index 滚动
+        scrollToRowOnPage(topIndex);
+      }
+    },
+    enabled: hasEditableColumns
+  });
+
+  // 暴露 validate / resetErrors 到 ref
+  // validate 不传参数，内部用 dataRef.current 获取最新数据
+  editableMethodsRef.current = hasEditableColumns ? {
+    validate: function validate() {
+      return editableResult.validateAll();
+    },
+    resetErrors: editableResult.resetErrors
+  } : null;
+
+  // 用于稳定 validate / resetErrors 引用，配合 useProxyImperativeHandle deps=[]
+  // 避免 each render 重建 Proxy
+  var validateAllRef = React.useRef(editableResult.validateAll);
+  validateAllRef.current = editableResult.validateAll;
+  var resetErrorsRef = React.useRef(editableResult.resetErrors);
+  resetErrorsRef.current = editableResult.resetErrors;
+  var resetColumnWidthsRef = React.useRef(resizeResult.resetColumnWidths);
+  resetColumnWidthsRef.current = resizeResult.resetColumnWidths;
+
+  // useImperativeHandle 在 commit 阶段执行（DOM ref 已挂载），
+  // 所以直接读 rootRef.current / tblRef.current 即可。
+  // deps=[] 保证只创建一次 Proxy；方法通过 ref 间接访问最新值。
+  (0, _useProxyImperativeHandle.useProxyImperativeHandle)(ref, function () {
+    return {
+      nativeElement: rootRef.current,
+      // 惰性间接调用，不展开 tblRef.current：
+      // 1. 展开会形成首次渲染快照 — RcTable 的 scrollTo 闭包捕获当次 render 的
+      //    mergedData/getRowKey，dataSource/分页变化后用旧数据解析 rowKey 导致找不到/找错行；
+      // 2. 展开会对 getter 提前求值（如虚拟表格 BodyGrid 的 scrollLeft/scrollTop 变成静态数字）。
+      scrollTo: function scrollTo(config) {
+        var _tblRef$current3, _tblRef$current3$scro;
+        return (_tblRef$current3 = tblRef.current) === null || _tblRef$current3 === void 0 || (_tblRef$current3$scro = _tblRef$current3.scrollTo) === null || _tblRef$current3$scro === void 0 ? void 0 : _tblRef$current3$scro.call(_tblRef$current3, config);
+      },
+      validate: function validate() {
+        var _validateAllRef$curre, _validateAllRef$curre2;
+        return (_validateAllRef$curre = (_validateAllRef$curre2 = validateAllRef.current) === null || _validateAllRef$curre2 === void 0 ? void 0 : _validateAllRef$curre2.call(validateAllRef)) !== null && _validateAllRef$curre !== void 0 ? _validateAllRef$curre : Promise.resolve({
+          valid: true,
+          errors: new Map()
+        });
+      },
+      resetErrors: function resetErrors() {
+        var _resetErrorsRef$curre;
+        return (_resetErrorsRef$curre = resetErrorsRef.current) === null || _resetErrorsRef$curre === void 0 ? void 0 : _resetErrorsRef$curre.call(resetErrorsRef);
+      },
+      resetColumnWidths: function resetColumnWidths() {
+        var _resetColumnWidthsRef;
+        return (_resetColumnWidthsRef = resetColumnWidthsRef.current) === null || _resetColumnWidthsRef === void 0 ? void 0 : _resetColumnWidthsRef.call(resetColumnWidthsRef);
+      }
+    };
+  }, []);
+
+  // 可编辑列 transform
+  // 错误状态通过 EditableContext 传递，不需要重建列 transform。
+  // 如果依赖 errors 会导致每次校验都重建整个列结构，引发全表重渲染，严重影响输入性能。
+  var transformEditableColumns = React.useCallback(function (cols) {
+    if (!hasEditableColumns) return cols;
+    return cols.map(function (col) {
+      // 列组（表头合并）：递归处理子列
+      if ('children' in col && col.children) {
+        return _objectSpread(_objectSpread({}, col), {}, {
+          children: transformEditableColumns(col.children)
+        });
+      }
+      var leafCol = col;
+      var parsed = (0, _editable.parseEditableConfig)(leafCol.editable, editableEnabled);
+      if (!parsed.enabled) return col;
+
+      // 全局 editable 开启时，跳过没有 dataIndex 的列（如操作列），
+      // 避免将原始 render 的返回值（React 元素）当作 value 传给 EditableCell，
+      // 导致显示 [object Object]。
+      // 列级显式设置 editable 时仍然生效（用户明确要求编辑此列）。
+      if (!leafCol.editable && !leafCol.dataIndex && leafCol.dataIndex !== 0) {
+        return col;
+      }
+      return _objectSpread(_objectSpread({}, leafCol), {}, {
+        render: function render(value, record, index) {
+          var _parsed$config;
+          // index 是 pageData 的局部索引，加上 pageOffset 后才是 rawData 全局索引。
+          // rowKey 是排序/筛选/树形展开后唯一稳定的行标识：editable 链路（提交、错误查找）
+          // 都以 rowKey 定位，globalRowIndex 仅作无 key 时的降级与列回调参数。
+          var globalRowIndex = index + pageOffsetRef.current;
+          return /*#__PURE__*/React.createElement(_editable.EditableCell
+          // `EditableCell` contracts `dataIndex`/`title` as plain render values;
+          // pass the column config through as-is.
+          , {
+            dataIndex: leafCol.dataIndex,
+            title: leafCol.title,
+            rowKey: getRowKey(record, index),
+            rowIndex: globalRowIndex,
+            record: record,
+            value: value,
+            editableConfig: (_parsed$config = parsed.config) !== null && _parsed$config !== void 0 ? _parsed$config : EMPTY_EDITABLE_CONFIG,
+            prefixCls: prefixCls
+          });
+        }
+      });
+    });
+  }, [hasEditableColumns, editableEnabled, prefixCls, getRowKey]);
+
+  // ============================ Events =============================
+  var changeEventInfo = {};
+  var triggerOnChange = function triggerOnChange(info, action) {
+    var reset = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : false;
+    var changeInfo = _objectSpread(_objectSpread({}, changeEventInfo), info);
+    if (reset) {
+      var _changeEventInfo$rese, _changeInfo$paginatio;
+      (_changeEventInfo$rese = changeEventInfo.resetPagination) === null || _changeEventInfo$rese === void 0 || _changeEventInfo$rese.call(changeEventInfo);
+      if ((_changeInfo$paginatio = changeInfo.pagination) !== null && _changeInfo$paginatio !== void 0 && _changeInfo$paginatio.current) {
+        changeInfo.pagination.current = 1;
+      }
+      if (pagination) {
+        var _pagination$onChange2, _changeInfo$paginatio2;
+        (_pagination$onChange2 = pagination.onChange) === null || _pagination$onChange2 === void 0 || _pagination$onChange2.call(pagination, 1, (_changeInfo$paginatio2 = changeInfo.pagination) === null || _changeInfo$paginatio2 === void 0 ? void 0 : _changeInfo$paginatio2.pageSize);
+      }
+    }
+    if (scroll && scroll.scrollToFirstRowOnChange !== false && internalRef.body.current) {
+      (0, _scrollTo.default)(0, {
+        getContainer: function getContainer() {
+          return internalRef.body.current;
+        }
+      });
+    }
+    onChange === null || onChange === void 0 || onChange(changeInfo.pagination, changeInfo.filters, changeInfo.sorter, {
+      currentDataSource: (0, _useFilter3.getFilterData)((0, _useSorter3.getSortData)(rawData, changeInfo.sorterStates, childrenColumnName), changeInfo.filterStates, childrenColumnName),
+      action: action
+    });
+  };
+
+  // ============================ Sorter =============================
+  var onSorterChange = function onSorterChange(sorter, sorterStates) {
+    triggerOnChange({
+      sorter: sorter,
+      sorterStates: sorterStates
+    }, 'sort', false);
+  };
+  var _useSorter = (0, _useSorter3.default)({
+      prefixCls: prefixCls,
+      mergedColumns: mergedColumns,
+      baseColumns: baseColumns,
+      onSorterChange: onSorterChange,
+      sortDirections: sortDirections || ['ascend', 'descend'],
+      tableLocale: tableLocale,
+      showSorterTooltip: showSorterTooltip
+    }),
+    _useSorter2 = _slicedToArray(_useSorter, 4),
+    transformSorterColumns = _useSorter2[0],
+    sortStates = _useSorter2[1],
+    sorterTitleProps = _useSorter2[2],
+    getSorters = _useSorter2[3];
+  var sortedData = React.useMemo(function () {
+    return (0, _useSorter3.getSortData)(rawData, sortStates, childrenColumnName);
+  }, [childrenColumnName, rawData, sortStates]);
+  changeEventInfo.sorter = getSorters();
+  changeEventInfo.sorterStates = sortStates;
+
+  // ============================ Filter ============================
+  var onFilterChange = function onFilterChange(filters, filterStates) {
+    triggerOnChange({
+      filters: filters,
+      filterStates: filterStates
+    }, 'filter', true);
+  };
+  var _useFilter = (0, _useFilter3.default)({
+      prefixCls: prefixCls,
+      locale: tableLocale,
+      dropdownPrefixCls: dropdownPrefixCls,
+      mergedColumns: mergedColumns,
+      onFilterChange: onFilterChange,
+      getPopupContainer: getPopupContainer || getContextPopupContainer,
+      rootClassName: rootClassName
+    }),
+    _useFilter2 = _slicedToArray(_useFilter, 3),
+    transformFilterColumns = _useFilter2[0],
+    filterStates = _useFilter2[1],
+    filters = _useFilter2[2];
+  var mergedData = (0, _useFilter3.getFilterData)(sortedData, filterStates, childrenColumnName);
+  mergedDataRef.current = mergedData;
+  changeEventInfo.filters = filters;
+  changeEventInfo.filterStates = filterStates;
+
+  // ============================ Column ============================
+  var columnTitleProps = React.useMemo(function () {
+    var mergedFilters = {};
+    Object.keys(filters).forEach(function (filterKey) {
+      if (filters[filterKey] !== null) {
+        mergedFilters[filterKey] = filters[filterKey];
+      }
+    });
+    return _objectSpread(_objectSpread({}, sorterTitleProps), {}, {
+      filters: mergedFilters
+    });
+  }, [sorterTitleProps, filters]);
+  var _useTitleColumns = (0, _useTitleColumns3.default)(columnTitleProps),
+    _useTitleColumns2 = _slicedToArray(_useTitleColumns, 1),
+    transformTitleColumns = _useTitleColumns2[0];
+
+  // ========================== Pagination ==========================
+  var onPaginationChange = function onPaginationChange(current, pageSize) {
+    triggerOnChange({
+      pagination: _objectSpread(_objectSpread({}, changeEventInfo.pagination), {}, {
+        current: current,
+        pageSize: pageSize
+      })
+    }, 'paginate');
+  };
+  var _usePagination = (0, _usePagination3.default)(mergedData.length, onPaginationChange, pagination),
+    _usePagination2 = _slicedToArray(_usePagination, 2),
+    mergedPagination = _usePagination2[0],
+    resetPagination = _usePagination2[1];
+  changeEventInfo.pagination = pagination === false ? {} : (0, _usePagination3.getPaginationParam)(mergedPagination, pagination);
+  changeEventInfo.resetPagination = resetPagination;
+
+  // 更新分页偏移量 ref — 在 transformEditableColumns 中使用
+  // 必须在 pageData 计算之前更新，因为 transformEditableColumns 在渲染期间被调用
+  pageOffsetRef.current = pagination === false || !mergedPagination.pageSize ? 0 : (((_mergedPagination$cur = mergedPagination.current) !== null && _mergedPagination$cur !== void 0 ? _mergedPagination$cur : 1) - 1) * ((_mergedPagination$pag = mergedPagination.pageSize) !== null && _mergedPagination$pag !== void 0 ? _mergedPagination$pag : 10);
+
+  // 更新分页控制 ref — validate 时使用
+  paginationInfoRef.current = {
+    current: (_mergedPagination$cur2 = mergedPagination.current) !== null && _mergedPagination$cur2 !== void 0 ? _mergedPagination$cur2 : 1,
+    pageSize: (_mergedPagination$pag2 = mergedPagination.pageSize) !== null && _mergedPagination$pag2 !== void 0 ? _mergedPagination$pag2 : 10,
+    enabled: pagination !== false
+  };
+  resetPaginationRef.current = resetPagination;
+
+  // ============================= Data =============================
+  var pageData = React.useMemo(function () {
+    if (pagination === false || !mergedPagination.pageSize) {
+      return mergedData;
+    }
+    var _mergedPagination$cur3 = mergedPagination.current,
+      current = _mergedPagination$cur3 === void 0 ? 1 : _mergedPagination$cur3,
+      total = mergedPagination.total,
+      _mergedPagination$pag3 = mergedPagination.pageSize,
+      pageSize = _mergedPagination$pag3 === void 0 ? _usePagination3.DEFAULT_PAGE_SIZE : _mergedPagination$pag3;
+    warning(current > 0, 'usage', '`current` should be positive number.');
+    if (mergedData.length < total) {
+      if (mergedData.length > pageSize) {
+        warning(false, 'usage', '`dataSource` length is less than `pagination.total` but large than `pagination.pageSize`. Please make sure your config correct data with async mode.');
+        return mergedData.slice((current - 1) * pageSize, current * pageSize);
+      }
+      return mergedData;
+    }
+    return mergedData.slice((current - 1) * pageSize, current * pageSize);
+  }, [!!pagination, mergedData, mergedPagination === null || mergedPagination === void 0 ? void 0 : mergedPagination.current, mergedPagination === null || mergedPagination === void 0 ? void 0 : mergedPagination.pageSize, mergedPagination === null || mergedPagination === void 0 ? void 0 : mergedPagination.total]);
+
+  // ========================== Selections ==========================
+  var _useSelection = (0, _useSelection3.default)({
+      prefixCls: prefixCls,
+      data: mergedData,
+      pageData: pageData,
+      getRowKey: getRowKey,
+      getRecordByKey: getRecordByKey,
+      expandType: expandType,
+      childrenColumnName: childrenColumnName,
+      locale: tableLocale,
+      getPopupContainer: getPopupContainer || getContextPopupContainer
+    }, mergedRowSelection),
+    _useSelection2 = _slicedToArray(_useSelection, 2),
+    transformSelectionColumns = _useSelection2[0],
+    selectedKeySet = _useSelection2[1];
+  var internalRowClassName = function internalRowClassName(record, index, indent) {
+    return (0, _clsx4.clsx)(_defineProperty({}, "".concat(prefixCls, "-row-selected"), selectedKeySet.has(getRowKey(record, index))), (0, _is.isFunction)(rowClassName) ? rowClassName(record, index, indent) : rowClassName);
+  };
+
+  // ========================== Expandable ==========================
+
+  mergedExpandable.__PARENT_RENDER_ICON__ = mergedExpandable.expandIcon;
+  mergedExpandable.expandIcon = mergedExpandable.expandIcon || expandIcon || (0, _ExpandIcon.default)(tableLocale);
+  if (expandType === 'nest' && mergedExpandable.expandIconColumnIndex === undefined) {
+    mergedExpandable.expandIconColumnIndex = mergedRowSelection ? 1 : 0;
+  } else if (mergedExpandable.expandIconColumnIndex > 0 && mergedRowSelection) {
+    mergedExpandable.expandIconColumnIndex -= 1;
+  }
+  if (!(0, _is.isNumber)(mergedExpandable.indentSize)) {
+    mergedExpandable.indentSize = (0, _is.isNumber)(indentSize) ? indentSize : 15;
+  }
+
+  // ============================ Render ============================
+  var transformColumns = React.useCallback(function (innerColumns) {
+    var result = transformTitleColumns(transformSelectionColumns(transformFilterColumns(transformSorterColumns(transformEditableColumns(innerColumns)))));
+    // 在 transformColumns 链末端注入 resize（resize 依赖最终列结构）
+    if (hasResizableColumns) {
+      result = (0, _resize.transformResizableColumns)(result, {
+        prefixCls: prefixCls,
+        enabled: hasResizableColumns,
+        isColumnResizable: resizeResult.isColumnResizable,
+        onStartResize: resizeResult.onStartResize,
+        onKeyboardResize: resizeResult.setColumnWidth
+      });
+    }
+    return result;
+  }, [transformSorterColumns, transformFilterColumns, transformSelectionColumns, transformEditableColumns, hasResizableColumns, prefixCls, resizeResult.isColumnResizable, resizeResult.onStartResize]);
+  var topPaginationNode;
+  var bottomPaginationNode;
+  if (pagination !== false && mergedPagination !== null && mergedPagination !== void 0 && mergedPagination.total) {
+    var paginationSize;
+    if (mergedPagination.size) {
+      paginationSize = mergedPagination.size;
+    } else {
+      paginationSize = customizeSize === 'small' || customizeSize === 'middle' ? 'small' : undefined;
+    }
+    var renderPagination = function renderPagination() {
+      var placement = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : 'end';
+      return /*#__PURE__*/React.createElement(_pagination.default, _extends({}, mergedPagination, {
+        className: (0, _clsx4.clsx)("".concat(prefixCls, "-pagination ").concat(prefixCls, "-pagination-").concat(placement), mergedPagination.className),
+        size: paginationSize
+      }));
+    };
+    var placement = mergedPagination.placement,
+      position = mergedPagination.position;
+    var mergedPlacement = placement !== null && placement !== void 0 ? placement : position;
+    var normalizePlacement = function normalizePlacement(pos) {
+      var lowerPos = pos.toLowerCase();
+      if (lowerPos.includes('center')) {
+        return 'center';
+      }
+      return lowerPos.includes('left') || lowerPos.includes('start') ? 'start' : 'end';
+    };
+    if (Array.isArray(mergedPlacement)) {
+      var _map = ['top', 'bottom'].map(function (dir) {
+          return mergedPlacement.find(function (p) {
+            return p.includes(dir);
+          });
+        }),
+        _map2 = _slicedToArray(_map, 2),
+        topPos = _map2[0],
+        bottomPos = _map2[1];
+      var isDisable = mergedPlacement.every(function (p) {
+        return "".concat(p) === 'none';
+      });
+      if (!topPos && !bottomPos && !isDisable) {
+        bottomPaginationNode = renderPagination();
+      }
+      if (topPos) {
+        topPaginationNode = renderPagination(normalizePlacement(topPos));
+      }
+      if (bottomPos) {
+        bottomPaginationNode = renderPagination(normalizePlacement(bottomPos));
+      }
+    } else {
+      bottomPaginationNode = renderPagination();
+    }
+    if (process.env.NODE_ENV !== 'production') {
+      warning.deprecated(!position, 'pagination.position', 'pagination.placement');
+    }
+  }
+
+  // >>>>>>>>> Spinning
+  var spinProps = React.useMemo(function () {
+    if (typeof loading === 'boolean') {
+      return {
+        spinning: loading
+      };
+    } else if ((0, _is.isPlainObject)(loading)) {
+      return _objectSpread({
+        spinning: true
+      }, loading);
+    } else {
+      return undefined;
+    }
+  }, [loading]);
+  var wrappercls = (0, _clsx4.clsx)("".concat(prefixCls, "-wrapper"), _defineProperty(_defineProperty(_defineProperty(_defineProperty({}, "".concat(prefixCls, "-wrapper-rtl"), false), "".concat(prefixCls, "-middle"), customizeSize === 'middle'), "".concat(prefixCls, "-small"), customizeSize === 'small'), "".concat(prefixCls, "-wrapper-resizing"), resizeResult.resizingKey != null), className, rootClassName);
+
+  // ========== empty ==========
+  var mergedEmptyNode = React.useMemo(function () {
+    // When dataSource is null/undefined (detected by reference equality with EMPTY_LIST),
+    // and the table is in a loading state, we only show the loading spinner without the empty placeholder.
+    // For empty arrays (datasource={[]}), both loading and empty states would normally be shown.
+    // discussion https://github.com/ant-design/ant-design/issues/54601#issuecomment-3158091383
+    if (spinProps !== null && spinProps !== void 0 && spinProps.spinning && rawData === EMPTY_LIST) {
+      return null;
+    }
+    if (typeof (locale === null || locale === void 0 ? void 0 : locale.emptyText) !== 'undefined') {
+      return locale.emptyText;
+    }
+    var emptyNode = (renderEmpty === null || renderEmpty === void 0 ? void 0 : renderEmpty('Table')) || (0, _defaultRenderEmpty.default)('Table');
+    return emptyNode;
+  }, [spinProps === null || spinProps === void 0 ? void 0 : spinProps.spinning, rawData, locale === null || locale === void 0 ? void 0 : locale.emptyText, renderEmpty]);
+
+  // ========================== Render ==========================
+  var TableComponent = virtual ? _VirtualTable.default : _RcTable.default;
+
+  // >>> Virtual Table props.
+  var virtualProps = {};
+
+  // Derive virtual row height from the CSS custom property defined in LESS.
+  // Fallback values match the default token calculations when CSS is not ready.
+  var fallbackItemHeight = React.useMemo(function () {
+    switch (customizeSize) {
+      case 'middle':
+        return 47;
+      case 'small':
+        return 39;
+      default:
+        return 55;
+    }
+  }, [customizeSize]);
+  var listItemHeight = (0, _useCssVar.default)(rootRef, "--".concat(prefixCls, "-row-height"), fallbackItemHeight);
+  if (virtual) {
+    virtualProps.listItemHeight = listItemHeight;
+  }
+
+  // ========================== Resize Line ==========================
+  // 竖线 DOM 通过 ref 直接操作，不需要 React state 驱动
+
+  return /*#__PURE__*/React.createElement("div", {
+    ref: rootRef,
+    className: wrappercls,
+    style: style
+  }, hasResizableColumns && /*#__PURE__*/React.createElement("div", {
+    ref: resizeResult.lineRef,
+    className: "".concat(prefixCls, "-resize-line")
+  }), /*#__PURE__*/React.createElement(_spin.default, _extends({
+    spinning: false
+  }, spinProps), topPaginationNode, /*#__PURE__*/React.createElement(_editable.EditableContext.Provider, {
+    value: hasEditableColumns ? editableResult.contextValue : null
+  }, /*#__PURE__*/React.createElement(HeaderTableContext.Provider, {
+    value: headerTableContext
+  }, /*#__PURE__*/React.createElement(TableComponent, _extends({}, virtualProps, tableProps, {
+    components: mergedComponents,
+    scroll: mergedScroll,
+    ref: tblRef,
+    columns: finalColumns,
+    direction: 'ltr',
+    expandable: mergedExpandable,
+    prefixCls: prefixCls,
+    className: (0, _clsx4.clsx)(_defineProperty(_defineProperty(_defineProperty(_defineProperty({}, "".concat(prefixCls, "-middle"), customizeSize === 'middle'), "".concat(prefixCls, "-small"), customizeSize === 'small'), "".concat(prefixCls, "-bordered"), bordered), "".concat(prefixCls, "-empty"), rawData.length === 0)),
+    data: pageData,
+    rowKey: getRowKey,
+    rowClassName: internalRowClassName,
+    emptyText: mergedEmptyNode
+    // Internal
+    ,
+    internalHooks: _constant.INTERNAL_HOOKS,
+    internalRefs: internalRef,
+    transformColumns: transformColumns,
+    getContainerWidth: getContainerWidth
+  })))), bottomPaginationNode));
+};
+var _default = exports.default = /*#__PURE__*/React.forwardRef(InternalTable);