@hi-ui/schema-editable-table 4.0.0-experimental.1

package/lib/esm/features/_overrides/getter.js

@@ -0,0 +1,56 @@
+/** @LICENSE
+ * @hi-ui/schema-editable-table
+ * https://github.com/XiaoMi/hiui/tree/master/packages/schema/schema-editable-table#readme
+ *
+ * Copyright (c) HiUI <mi-hiui@xiaomi.com>.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import { createCell } from '@tanstack/react-table';
+var CustomGetterFeature = {
+  createTable: function createTable(table) {
+    table.$getInnerRef = function $getInnerRef() {
+      var _a;
+      // @ts-expect-error innerRef
+      return (_a = table.options.meta) === null || _a === void 0 ? void 0 : _a.innerRef;
+    };
+    table.$getCell = function $getCell(cellId) {
+      var firstUnderscoreIndex = cellId.indexOf('_');
+      var rowId = cellId.slice(0, firstUnderscoreIndex);
+      var columnId = cellId.slice(firstUnderscoreIndex + 1);
+      var row = table.getRow(rowId);
+      if (!row) return null;
+      var column = table.getColumn(columnId);
+      if (!column) return null;
+      return createCell(table, row, column, columnId);
+    };
+    table.$getRealtimeRowData = function getTableRealtimeRowData(rowId) {
+      var _a;
+      try {
+        var row = table.getRow(rowId);
+        if (!row) return undefined;
+        var subscription = (_a = table.options.meta) === null || _a === void 0 ? void 0 : _a.subscription;
+        if (!subscription) return undefined;
+        var rowIndex = row.index;
+        return subscription.getValue()[rowIndex];
+      } catch (error) {
+        return undefined;
+      }
+    };
+  },
+  createRow: function createRow(row, table) {
+    row.$getRealtimeRowData = function getRealtimeRowData() {
+      // 这里的 row.original 实际上没用
+      // getRealtimeRowData 会返回 undefined 是因为 rowId 可能会被用户误传
+      // 但此处的 rowId 是不会错误的，所以只是留一个 fallback
+      return table.$getRealtimeRowData(row.id) || row.original;
+    };
+  },
+  createCell: function createCell(cell, column, row) {
+    cell.$getRealtimeRowData = function getRealtimeCellRowData() {
+      return row.$getRealtimeRowData();
+    };
+  }
+};
+export { CustomGetterFeature };

package/lib/esm/features/_overrides/grouping.js

@@ -0,0 +1,35 @@
+/** @LICENSE
+ * @hi-ui/schema-editable-table
+ * https://github.com/XiaoMi/hiui/tree/master/packages/schema/schema-editable-table#readme
+ *
+ * Copyright (c) HiUI <mi-hiui@xiaomi.com>.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import { EMPTY_VALUE } from '../../const.js';
+import '../../utils/cls.js';
+import { isEmptyValue } from '../../utils/grouping.js';
+
+/**
+ * 自定义分组特性
+ * 主要用于处理分组值为null或undefined的情况，将不同类型的空值统一为一个特殊标记
+ * 这样所有的空值都会被归为同一组，而不是分散在不同的组中
+ */
+var CustomGroupingFeature = {
+  createRow: function createRow(row) {
+    // 保存原始的getGroupingValue方法
+    var originalGetGroupingValue = row.getGroupingValue;
+    // 重写getGroupingValue方法，统一处理空值
+    row.getGroupingValue = function (columnId) {
+      // 获取原始分组值
+      var value = originalGetGroupingValue.call(this, columnId);
+      // 如果是空值，统一返回特殊标记
+      if (isEmptyValue(value)) {
+        return EMPTY_VALUE;
+      }
+      return value;
+    };
+  }
+};
+export { CustomGroupingFeature };

package/lib/esm/features/_overrides/overrides.js

@@ -0,0 +1,38 @@
+/** @LICENSE
+ * @hi-ui/schema-editable-table
+ * https://github.com/XiaoMi/hiui/tree/master/packages/schema/schema-editable-table#readme
+ *
+ * Copyright (c) HiUI <mi-hiui@xiaomi.com>.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import { dftPageSize } from '../pagination/use-opts.js';
+
+// 内置 Feature 的覆写逻辑
+var OverridesFeature = {
+  createTable: function createTable(table) {
+    // 覆写 resetPagination 方法
+    if (!table.originalResetPagination) table.originalResetPagination = table.resetPagination;
+    table.resetPagination = function resetPagination(defaultState) {
+      var _a;
+      // 先从分页状态中取行数，否则从 table 实例数据上取
+      // 原因是后端分页时，table 实例上只有一页的数据，不准
+      var rowCount = (_a = table.getState().pagination.rowCount) !== null && _a !== void 0 ? _a : table.getRowCount();
+      if (defaultState) {
+        var pageSize = dftPageSize;
+        table.setPagination({
+          pageIndex: 0,
+          pageSize: pageSize,
+          rowCount: rowCount
+        });
+      } else {
+        var pagination = table.initialState.pagination;
+        table.setPagination(Object.assign(Object.assign({}, pagination), {
+          rowCount: rowCount
+        }));
+      }
+    };
+  }
+};
+export { OverridesFeature };

package/lib/esm/features/_overrides/row-selection.js

@@ -0,0 +1,135 @@
+/** @LICENSE
+ * @hi-ui/schema-editable-table
+ * https://github.com/XiaoMi/hiui/tree/master/packages/schema/schema-editable-table#readme
+ *
+ * Copyright (c) HiUI <mi-hiui@xiaomi.com>.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import { Schedular } from '@hi-ui/schema-utils';
+function _createForOfIteratorHelperLoose(o, allowArrayLike) {
+  var it = typeof Symbol !== "undefined" && o[Symbol.iterator] || o["@@iterator"];
+  if (it) return (it = it.call(o)).next.bind(it);
+  if (Array.isArray(o) || (it = _unsupportedIterableToArray(o)) || allowArrayLike && o && typeof o.length === "number") {
+    if (it) o = it;
+    var i = 0;
+    return function () {
+      if (i >= o.length) return {
+        done: true
+      };
+      return {
+        done: false,
+        value: o[i++]
+      };
+    };
+  }
+  throw new TypeError("Invalid attempt to iterate 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;
+}
+var CustomRowSelectionFeature = {
+  createTable: function createTable(table) {
+    table.$rowSelectionCache = {
+      selectedRows: [],
+      selectedRowKeys: [],
+      selectedRowEntries: []
+    };
+    table.$selectedRowsCache = new Map();
+    table.$getRowSelection = function $getRowSelection(state) {
+      var newState = state || table.getState().rowSelection;
+      // 如果 state 为空，则说明不是在变更时调用的，直接返回缓存
+      if (!state) return table.$rowSelectionCache;
+      var innerRef = table.$getInnerRef();
+      var allRows = innerRef.current.subscription.getValue();
+      var preserveSelectedRows = getEnablePreserveSelectedRows();
+      var selectedRowKeys = [];
+      var selectedRows = [];
+      var selectedRowEntries = [];
+      for (var _i = 0, _Object$entries = Object.entries(newState); _i < _Object$entries.length; _i++) {
+        var _Object$entries$_i = _Object$entries[_i],
+          rowId = _Object$entries$_i[0],
+          selected = _Object$entries$_i[1];
+        if (!selected) continue; // selected 应该不可能为 false，此处保留用作保险
+        selectedRowKeys.push(rowId);
+        try {
+          var row = table.getRow(rowId);
+          var rowData = allRows[row.index];
+          selectedRows.push(rowData);
+          selectedRowEntries.push([rowId, rowData]);
+        } catch (error) {
+          // 走到这里，说明 getRow 执行失败了
+          if (preserveSelectedRows) {
+            var _rowData = table.$selectedRowsCache.get(rowId);
+            if (_rowData) {
+              selectedRows.push(_rowData);
+              selectedRowEntries.push([rowId, _rowData]);
+            }
+          }
+        }
+      }
+      var selection = {
+        selectedRows: selectedRows,
+        selectedRowKeys: selectedRowKeys,
+        selectedRowEntries: selectedRowEntries
+      };
+      table.$rowSelectionCache = selection;
+      return selection;
+    };
+    table.$updateSelectedRowsCache = function $updateSelectedRowsCache(entries) {
+      var preserveSelectedRows = getEnablePreserveSelectedRows();
+      // 仅在开启 preserveSelectedRows 时才更新缓存
+      if (preserveSelectedRows) {
+        for (var _iterator = _createForOfIteratorHelperLoose(entries), _step; !(_step = _iterator()).done;) {
+          var _step$value = _step.value,
+            _rowId = _step$value[0],
+            rowData = _step$value[1];
+          table.$selectedRowsCache.set(_rowId, rowData);
+        }
+        // 清除已经取消选择的行的缓存记录
+        var innerRef = table.$getInnerRef();
+        var rowSelectionState = innerRef.current.rowSelectionState;
+        var stateValue = rowSelectionState.getValue();
+        for (var rowId in stateValue) {
+          if (stateValue[rowId] === false) {
+            table.$selectedRowsCache["delete"](rowId);
+          }
+        }
+      }
+    };
+    function getEnablePreserveSelectedRows() {
+      var _a;
+      var innerRef = table.$getInnerRef();
+      return (_a = innerRef.current.propsRef.current.rowSelection) === null || _a === void 0 ? void 0 : _a.preserveSelectedRows;
+    }
+  },
+  createRow: function createRow(row) {
+    row.$afterToggleSelected = function afterToggleSelected() {
+      var parentRows = row.getParentRows();
+      // 父行不会很多，所以直接反序后遍历
+      parentRows.toReversed().forEach(function (parentRow) {
+        // 使用微任务调度则是因为，状态的变更稍微有一点点延迟，会拿不到实时的状态
+        Schedular.nextMicro(function () {
+          var isParentSelected = parentRow.getIsAllSubRowsSelected();
+          parentRow.toggleSelected(isParentSelected, {
+            selectChildren: false
+          });
+        });
+      });
+    };
+  }
+};
+export { CustomRowSelectionFeature };

package/lib/esm/features/async-data/getter.js

@@ -0,0 +1,143 @@
+import _typeof from "@babel/runtime/helpers/esm/typeof";
+/** @LICENSE
+ * @hi-ui/schema-editable-table
+ * https://github.com/XiaoMi/hiui/tree/master/packages/schema/schema-editable-table#readme
+ *
+ * Copyright (c) HiUI <mi-hiui@xiaomi.com>.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import { useEffect } from 'react';
+import { useDebounceFn } from 'ahooks';
+import { isNil } from 'lodash-es';
+import { useReadonlyRef, useDeepCompareFlag, useIsFirstMount } from '@hi-ui/schema-hooks';
+import { useEditableSchemaTableCtx } from '../../ctx.js';
+
+// 单纯只是为了包装一下 useAsyncData
+// ~~避免在 Table 最顶层调用时频繁触发重渲染~~
+// NOTE 上述目的没有达到，暂时先留着吧，指不定后面又有新用途了
+function AsyncDataGetter() {
+  var ctx = useEditableSchemaTableCtx();
+  var innerRef = useReadonlyRef(function () {
+    return ctx;
+  });
+  useAsyncData({
+    innerRef: innerRef
+  });
+  return null;
+}
+function useAsyncData(ctx) {
+  var innerRef = ctx.innerRef;
+  var globalStaticRef = innerRef.current.globalStaticRef;
+  var enableAsyncData = globalStaticRef.current.enableAsyncData;
+  // 分页/筛选状态变更时，table会自动触发重渲染，此处不必单独监听
+  var _innerRef$current = innerRef.current,
+    filterState = _innerRef$current.filterState,
+    sorterState = _innerRef$current.sorterState,
+    paginationState = _innerRef$current.paginationState;
+  // 异步数据源需要监听的状态
+  var _paginationState$getV = paginationState.getValue(),
+    pageSize = _paginationState$getV.pageSize,
+    pageIndex = _paginationState$getV.pageIndex;
+  // 如果启用了远程筛选，则使用筛选状态，否则不监听 filters 变化
+  var filters = filterState.getValue();
+  var effectiveFilters = globalStaticRef.current.enableRemoteFilter ? filters : undefined;
+  var hasFilterChanged = useDeepCompareFlag([effectiveFilters]);
+  var sorters = sorterState.getValue();
+  // 如果启用了远程排序，则使用排序状态，否则不监听 sorters 变化
+  var effectiveSorters = globalStaticRef.current.enableRemoteSorter ? sorters : undefined;
+  var hasSorterChanged = useDeepCompareFlag([effectiveSorters]);
+  // 标记是否初次挂载
+  var isFirstMountRef = useIsFirstMount();
+  var _useDebounceFn = useDebounceFn(function fetchData() {
+      var _a;
+      // 内部主动设置的分页状态，不请求数据
+      // 内部主动设置的分页状态，不请求数据
+      var fromCustomPagination = innerRef.current.table.getState().pagination.$fromCustom;
+      if (fromCustomPagination) return;
+      // 启用 blockInitialRequest 时，初次挂载时不请求数据
+      // 启用 blockInitialRequest 时，初次挂载时不请求数据
+      var propsRef = innerRef.current.propsRef;
+      var blockInitialRequest = (_a = propsRef.current.asyncData) === null || _a === void 0 ? void 0 : _a.blockInitialRequest;
+      if (isFirstMountRef.current && blockInitialRequest) return;
+      // 真实请求逻辑
+      // 真实请求逻辑
+      if (enableAsyncData) {
+        var globalActionsRef = innerRef.current.globalActionsRef;
+        globalActionsRef.current.updateDataSource();
+      }
+    },
+    // 16 毫秒内的变更仅触发一次请求
+    // 以达到短时间内多次状态变更的批处理效果
+    {
+      wait: 16
+    }),
+    fetchData = _useDebounceFn.run;
+  useEffect(function () {
+    fetchData();
+  }, [fetchData,
+  // 不会触发重渲染
+  isFirstMountRef, enableAsyncData, innerRef,
+  // 以下为触发请求接口的值
+  pageSize, pageIndex, hasFilterChanged, hasSorterChanged]);
+}
+function validateResData(data) {
+  // 空值检查
+  if (isNil(data)) {
+    console.warn('EditTable useAsyncData: 主数据不能为空');
+    return false;
+  }
+  // 对象类型检查
+  if (_typeof(data) !== 'object' || Array.isArray(data)) {
+    console.warn('EditTable useAsyncData: useAsyncData: 主数据必须是对象类型');
+    return false;
+  }
+  var pass = true;
+  var res = data;
+  // 必要字段存在性检查
+  if (!('list' in res)) {
+    console.warn('EditTable useAsyncData: 主数据缺少必要字段: list');
+    pass = false;
+  }
+  if (!('total' in res)) {
+    console.warn('EditTable useAsyncData: 主数据缺少必要字段: total');
+    pass = false;
+  }
+  if (!('pageSize' in res)) {
+    console.warn('EditTable useAsyncData: 主数据缺少必要字段: pageSize');
+    pass = false;
+  }
+  if (!('current' in res)) {
+    console.warn('EditTable useAsyncData: 主数据缺少必要字段: current');
+    pass = false;
+  }
+  // 分阶段检查，本阶段未通过，不再检查剩余项目
+  if (!pass) return false;
+  // 字段类型检查
+  if (!Array.isArray(res.list)) {
+    console.warn('EditTable useAsyncData: list字段必须是数组类型');
+    pass = false;
+  }
+  if (typeof res.total !== 'number') {
+    console.warn('EditTable useAsyncData: total字段必须是数字类型');
+    pass = false;
+  }
+  if (typeof res.pageSize !== 'number') {
+    console.warn('EditTable useAsyncData: pageSize字段必须是数字类型');
+    pass = false;
+  }
+  if (typeof res.current !== 'number') {
+    console.warn('EditTable useAsyncData: current字段必须是数字类型');
+    pass = false;
+  }
+  // list数组内容检查
+  if (res.list.some(function (item) {
+    return isNil(item) || _typeof(item) !== 'object' || Array.isArray(item);
+  })) {
+    console.warn('EditTable useAsyncData: list数组的每一项必须是对象类型');
+    pass = false;
+  }
+  return pass;
+}
+export { AsyncDataGetter, useAsyncData, validateResData };

package/lib/esm/features/async-data/normal.js

@@ -0,0 +1,133 @@
+/** @LICENSE
+ * @hi-ui/schema-editable-table
+ * https://github.com/XiaoMi/hiui/tree/master/packages/schema/schema-editable-table#readme
+ *
+ * Copyright (c) HiUI <mi-hiui@xiaomi.com>.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import _regeneratorRuntime from '@babel/runtime/regenerator';
+import { __awaiter } from 'tslib';
+import { useCallback } from 'react';
+import { getPipeGetterValue } from '@hi-ui/schema-utils';
+import { validateResData } from './getter.js';
+function useGetDataSource(ctx) {
+  var innerRef = ctx.innerRef;
+  var getDataSource = useCallback(function getDataSource(customParams) {
+    return __awaiter(this, void 0, void 0, /*#__PURE__*/_regeneratorRuntime.mark(function _callee() {
+      var _a, _innerRef$current, table, globalStaticRef, propsRef, enableAsyncData, _ref, dataSourceFn, dftData, _table$getState, _table$getState$pagin, pageIndex, pageSize, sorting, columnFilters, params, enablePagination, enableRemoteFilter, enableRemoteSorter, pipeParams, beforeRequest, finalParams;
+      return _regeneratorRuntime.wrap(function _callee$(_context) {
+        while (1) {
+          switch (_context.prev = _context.next) {
+            case 0:
+              _innerRef$current = innerRef.current, table = _innerRef$current.table, globalStaticRef = _innerRef$current.globalStaticRef, propsRef = _innerRef$current.propsRef;
+              enableAsyncData = globalStaticRef.current.enableAsyncData;
+              _ref = propsRef.current.asyncData || {}, dataSourceFn = _ref.request;
+              dftData = {
+                list: [],
+                total: 0,
+                pageSize: 0,
+                current: 0
+              };
+              if (!(!enableAsyncData || !dataSourceFn)) {
+                _context.next = 6;
+                break;
+              }
+              return _context.abrupt("return", dftData);
+            case 6:
+              _table$getState = table.getState(), _table$getState$pagin = _table$getState.pagination, pageIndex = _table$getState$pagin.pageIndex, pageSize = _table$getState$pagin.pageSize, sorting = _table$getState.sorting, columnFilters = _table$getState.columnFilters;
+              params = {}; // 分页
+              // 其实只要启用异步数据源，基本上一定会有分页
+              // 还是判断一下吧，就当是用来收窄类型
+              enablePagination = globalStaticRef.current.enablePagination;
+              if (enablePagination) {
+                params.pagination = {
+                  current: pageIndex + 1,
+                  pageSize: pageSize
+                };
+              }
+              // 筛选
+              enableRemoteFilter = globalStaticRef.current.enableRemoteFilter;
+              if (enableRemoteFilter) params.filters = columnFilters;
+              // 排序
+              enableRemoteSorter = globalStaticRef.current.enableRemoteSorter;
+              if (enableRemoteSorter) params.sorters = sorting;
+              // 若有传入 customParams，则使用 customParams 处理 params
+              pipeParams = getPipeGetterValue(params, customParams); // 使用 beforeRequest 处理 pipeParams
+              beforeRequest = ((_a = propsRef.current.asyncData) === null || _a === void 0 ? void 0 : _a.beforeRequest) || function (params) {
+                return params;
+              };
+              _context.next = 18;
+              return beforeRequest(pipeParams);
+            case 18:
+              finalParams = _context.sent;
+              if (finalParams) {
+                _context.next = 21;
+                break;
+              }
+              return _context.abrupt("return", dftData);
+            case 21:
+              return _context.abrupt("return", dataSourceFn(finalParams));
+            case 22:
+            case "end":
+              return _context.stop();
+          }
+        }
+      }, _callee);
+    }));
+  }, [innerRef]);
+  var updateDataSource = useCallback(function updateDataSource(params) {
+    return __awaiter(this, void 0, void 0, /*#__PURE__*/_regeneratorRuntime.mark(function _callee2() {
+      var _a, data, _innerRef$current2, propsRef, globalStaticRef, enableDataValidate, enablePagination, _innerRef$current3, subscription, paginationState, table, _data$pageSize, dataPageSize, _data$current, current, _data$total, rowCount, pageIndex, nextState;
+      return _regeneratorRuntime.wrap(function _callee2$(_context2) {
+        while (1) {
+          switch (_context2.prev = _context2.next) {
+            case 0:
+              _context2.next = 2;
+              return getDataSource(params);
+            case 2:
+              data = _context2.sent;
+              if (data) {
+                _context2.next = 5;
+                break;
+              }
+              return _context2.abrupt("return");
+            case 5:
+              _innerRef$current2 = innerRef.current, propsRef = _innerRef$current2.propsRef, globalStaticRef = _innerRef$current2.globalStaticRef; // 如果启用了数据完整性验证，并且启用了分页，则验证数据
+              enableDataValidate = (_a = propsRef.current.asyncData) === null || _a === void 0 ? void 0 : _a.enableDataValidate;
+              enablePagination = globalStaticRef.current.enablePagination;
+              if (enableDataValidate && enablePagination) validateResData(data);
+              _innerRef$current3 = innerRef.current, subscription = _innerRef$current3.subscription, paginationState = _innerRef$current3.paginationState, table = _innerRef$current3.table; // 表格数据直接更新到主数据订阅
+              subscription.setValue(data.list);
+              // 如果启用了分页，则更新分页状态
+              if (enablePagination) {
+                _data$pageSize = data.pageSize, dataPageSize = _data$pageSize === void 0 ? 10 : _data$pageSize, _data$current = data.current, current = _data$current === void 0 ? 1 : _data$current, _data$total = data.total, rowCount = _data$total === void 0 ? 0 : _data$total;
+                pageIndex = current - 1;
+                nextState = {
+                  pageIndex: pageIndex,
+                  pageSize: dataPageSize,
+                  rowCount: rowCount
+                }; // 更新分页状态订阅
+                paginationState.setValue(nextState);
+                // 最后更新 table 分页状态 // 不触发 onPaginationChange
+                table.setState(function (state) {
+                  return Object.assign(Object.assign({}, state), {
+                    pagination: nextState
+                  });
+                });
+              }
+            case 12:
+            case "end":
+              return _context2.stop();
+          }
+        }
+      }, _callee2);
+    }));
+  }, [getDataSource, innerRef]);
+  return {
+    getDataSource: getDataSource,
+    updateDataSource: updateDataSource
+  };
+}
+export { useGetDataSource };

package/lib/esm/features/async-data/use-data-fetcher.js

@@ -0,0 +1,34 @@
+/** @LICENSE
+ * @hi-ui/schema-editable-table
+ * https://github.com/XiaoMi/hiui/tree/master/packages/schema/schema-editable-table#readme
+ *
+ * Copyright (c) HiUI <mi-hiui@xiaomi.com>.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import { __rest } from 'tslib';
+import { mergeValues } from '@hi-ui/schema-utils';
+import { useRequest } from 'ahooks';
+
+/**
+ * 定义的可编辑表的异步数据请求方法
+ * @desc 默认需要手动调用 fetchData 方法
+ * @desc 本质是 ahooks 的 useRequest 方法
+ */
+function useDataFetcher(getter, extraOpts) {
+  var _a = useRequest(getter, mergeValues({
+      manual: true
+    }, extraOpts)),
+    runAsync = _a.runAsync,
+    rest = __rest(_a, ["runAsync"]);
+  return Object.assign(Object.assign({}, rest), {
+    runAsync: runAsync,
+    fetchData: runAsync
+  });
+}
+/** 定义表格异步数据请求方法 */
+function defineDataFetcher(getter) {
+  return getter;
+}
+export { defineDataFetcher, useDataFetcher };

package/lib/esm/features/async-data/use-reset-data.js

@@ -0,0 +1,79 @@
+/** @LICENSE
+ * @hi-ui/schema-editable-table
+ * https://github.com/XiaoMi/hiui/tree/master/packages/schema/schema-editable-table#readme
+ *
+ * Copyright (c) HiUI <mi-hiui@xiaomi.com>.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import _regeneratorRuntime from '@babel/runtime/regenerator';
+import { __awaiter } from 'tslib';
+import { useCallback } from 'react';
+import { Schedular } from '@hi-ui/schema-utils';
+function useResetDataSource(ctx) {
+  var innerRef = ctx.innerRef;
+  var resetDataSource = useCallback(function resetDataSource(opts) {
+    return __awaiter(this, void 0, void 0, /*#__PURE__*/_regeneratorRuntime.mark(function _callee() {
+      var _a, _innerRef$current, table, globalStaticRef, propsRef, enableAsyncData, prevState, _innerRef$current2, filterState, sorterState, paginationState;
+      return _regeneratorRuntime.wrap(function _callee$(_context) {
+        while (1) {
+          switch (_context.prev = _context.next) {
+            case 0:
+              _innerRef$current = innerRef.current, table = _innerRef$current.table, globalStaticRef = _innerRef$current.globalStaticRef, propsRef = _innerRef$current.propsRef;
+              enableAsyncData = globalStaticRef.current.enableAsyncData;
+              if (enableAsyncData) {
+                _context.next = 4;
+                break;
+              }
+              return _context.abrupt("return");
+            case 4:
+              prevState = table.getState();
+              _innerRef$current2 = innerRef.current, filterState = _innerRef$current2.filterState, sorterState = _innerRef$current2.sorterState, paginationState = _innerRef$current2.paginationState; // 先重置内部订阅
+              filterState.setValue(function (prev) {
+                return prev.length > 0 ? [] : prev;
+              });
+              sorterState.setValue(function (prev) {
+                return prev.length > 0 ? [] : prev;
+              });
+              paginationState.mergeValue({
+                pageIndex: 0,
+                pageSize: (_a = propsRef.current.pagination) === null || _a === void 0 ? void 0 : _a.pageSize
+              });
+              // 再更新表格状态
+              table.setState(function (state) {
+                return Object.assign(Object.assign({}, state), {
+                  columnFilters: filterState.getValue(),
+                  sorting: sorterState.getValue(),
+                  pagination: paginationState.getValue()
+                });
+              });
+              // 有任意一个状态变更，均可触发请求(只触发一次)
+              // 方式是通过暂存的 prevState 来判断前后是否发生变化
+              Schedular.nextMicro(function () {
+                var _a;
+                if (prevState.pagination.pageIndex !== 0) {
+                  return table.setPageIndex(paginationState.getValue().pageIndex);
+                }
+                if (prevState.pagination.pageSize !== ((_a = propsRef.current.pagination) === null || _a === void 0 ? void 0 : _a.pageSize)) {
+                  return table.setPageSize(paginationState.getValue().pageSize);
+                }
+                if (prevState.columnFilters.length > 0) {
+                  return table.setColumnFilters(filterState.getValue());
+                }
+                // 启用强制请求时，无论是否有变化都请求一次
+                if (opts === null || opts === void 0 ? void 0 : opts.forceRequest) {
+                  innerRef.current.globalActionsRef.current.updateDataSource();
+                }
+              });
+            case 11:
+            case "end":
+              return _context.stop();
+          }
+        }
+      }, _callee);
+    }));
+  }, [innerRef]);
+  return resetDataSource;
+}
+export { useResetDataSource };

package/lib/esm/features/column-grouping/get-grouping-config.js

@@ -0,0 +1,22 @@
+/** @LICENSE
+ * @hi-ui/schema-editable-table
+ * https://github.com/XiaoMi/hiui/tree/master/packages/schema/schema-editable-table#readme
+ *
+ * Copyright (c) HiUI <mi-hiui@xiaomi.com>.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import { getBoolConfig } from '@hi-ui/schema-utils';
+function getGroupingConfig(field) {
+  var _a;
+  var groupingConfig = (_a = field.control) === null || _a === void 0 ? void 0 : _a.grouping;
+  if (!groupingConfig) return undefined;
+  var config = getBoolConfig(groupingConfig, {
+    aggregationFn: 'count'
+  }, {
+    mergeDft: true
+  });
+  return config;
+}
+export { getGroupingConfig };