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

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

@@ -0,0 +1,140 @@
+/** @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.
+ */
+'use strict';
+
+Object.defineProperty(exports, '__esModule', {
+  value: true
+});
+var schemaUtils = require('@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) {
+        // 使用微任务调度则是因为，状态的变更稍微有一点点延迟，会拿不到实时的状态
+        schemaUtils.Schedular.nextMicro(function () {
+          var isParentSelected = parentRow.getIsAllSubRowsSelected();
+          parentRow.toggleSelected(isParentSelected, {
+            selectChildren: false
+          });
+        });
+      });
+    };
+  }
+};
+exports.CustomRowSelectionFeature = CustomRowSelectionFeature;

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

@@ -0,0 +1,150 @@
+/** @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.
+ */
+'use strict';
+
+var _typeof = require("@babel/runtime/helpers/typeof");
+Object.defineProperty(exports, '__esModule', {
+  value: true
+});
+var React = require('react');
+var ahooks = require('ahooks');
+var lodashEs = require('lodash-es');
+var schemaHooks = require('@hi-ui/schema-hooks');
+var ctx = require('../../ctx.js');
+
+// 单纯只是为了包装一下 useAsyncData
+// ~~避免在 Table 最顶层调用时频繁触发重渲染~~
+// NOTE 上述目的没有达到，暂时先留着吧，指不定后面又有新用途了
+function AsyncDataGetter() {
+  var ctx$1 = ctx.useEditableSchemaTableCtx();
+  var innerRef = schemaHooks.useReadonlyRef(function () {
+    return ctx$1;
+  });
+  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 = schemaHooks.useDeepCompareFlag([effectiveFilters]);
+  var sorters = sorterState.getValue();
+  // 如果启用了远程排序，则使用排序状态，否则不监听 sorters 变化
+  var effectiveSorters = globalStaticRef.current.enableRemoteSorter ? sorters : undefined;
+  var hasSorterChanged = schemaHooks.useDeepCompareFlag([effectiveSorters]);
+  // 标记是否初次挂载
+  var isFirstMountRef = schemaHooks.useIsFirstMount();
+  var _useDebounceFn = ahooks.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;
+  React.useEffect(function () {
+    fetchData();
+  }, [fetchData,
+  // 不会触发重渲染
+  isFirstMountRef, enableAsyncData, innerRef,
+  // 以下为触发请求接口的值
+  pageSize, pageIndex, hasFilterChanged, hasSorterChanged]);
+}
+function validateResData(data) {
+  // 空值检查
+  if (lodashEs.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 lodashEs.isNil(item) || _typeof(item) !== 'object' || Array.isArray(item);
+  })) {
+    console.warn('EditTable useAsyncData: list数组的每一项必须是对象类型');
+    pass = false;
+  }
+  return pass;
+}
+exports.AsyncDataGetter = AsyncDataGetter;
+exports.useAsyncData = useAsyncData;
+exports.validateResData = validateResData;

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

@@ -0,0 +1,145 @@
+/** @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.
+ */
+'use strict';
+
+var _typeof = require("@babel/runtime/helpers/typeof");
+Object.defineProperty(exports, '__esModule', {
+  value: true
+});
+var _regeneratorRuntime = require('@babel/runtime/regenerator');
+var tslib = require('tslib');
+var React = require('react');
+var schemaUtils = require('@hi-ui/schema-utils');
+var getter = require('./getter.js');
+function _interopDefaultCompat(e) {
+  return e && _typeof(e) === 'object' && 'default' in e ? e : {
+    'default': e
+  };
+}
+var _regeneratorRuntime__default = /*#__PURE__*/_interopDefaultCompat(_regeneratorRuntime);
+function useGetDataSource(ctx) {
+  var innerRef = ctx.innerRef;
+  var getDataSource = React.useCallback(function getDataSource(customParams) {
+    return tslib.__awaiter(this, void 0, void 0, /*#__PURE__*/_regeneratorRuntime__default["default"].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__default["default"].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 = schemaUtils.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 = React.useCallback(function updateDataSource(params) {
+    return tslib.__awaiter(this, void 0, void 0, /*#__PURE__*/_regeneratorRuntime__default["default"].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__default["default"].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) getter.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
+  };
+}
+exports.useGetDataSource = useGetDataSource;

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

@@ -0,0 +1,40 @@
+/** @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.
+ */
+'use strict';
+
+Object.defineProperty(exports, '__esModule', {
+  value: true
+});
+var tslib = require('tslib');
+var schemaUtils = require('@hi-ui/schema-utils');
+var ahooks = require('ahooks');
+
+/**
+ * 定义的可编辑表的异步数据请求方法
+ * @desc 默认需要手动调用 fetchData 方法
+ * @desc 本质是 ahooks 的 useRequest 方法
+ */
+function useDataFetcher(getter, extraOpts) {
+  var _a = ahooks.useRequest(getter, schemaUtils.mergeValues({
+      manual: true
+    }, extraOpts)),
+    runAsync = _a.runAsync,
+    rest = tslib.__rest(_a, ["runAsync"]);
+  return Object.assign(Object.assign({}, rest), {
+    runAsync: runAsync,
+    fetchData: runAsync
+  });
+}
+/** 定义表格异步数据请求方法 */
+function defineDataFetcher(getter) {
+  return getter;
+}
+exports.defineDataFetcher = defineDataFetcher;
+exports.useDataFetcher = useDataFetcher;

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

@@ -0,0 +1,91 @@
+/** @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.
+ */
+'use strict';
+
+var _typeof = require("@babel/runtime/helpers/typeof");
+Object.defineProperty(exports, '__esModule', {
+  value: true
+});
+var _regeneratorRuntime = require('@babel/runtime/regenerator');
+var tslib = require('tslib');
+var React = require('react');
+var schemaUtils = require('@hi-ui/schema-utils');
+function _interopDefaultCompat(e) {
+  return e && _typeof(e) === 'object' && 'default' in e ? e : {
+    'default': e
+  };
+}
+var _regeneratorRuntime__default = /*#__PURE__*/_interopDefaultCompat(_regeneratorRuntime);
+function useResetDataSource(ctx) {
+  var innerRef = ctx.innerRef;
+  var resetDataSource = React.useCallback(function resetDataSource(opts) {
+    return tslib.__awaiter(this, void 0, void 0, /*#__PURE__*/_regeneratorRuntime__default["default"].mark(function _callee() {
+      var _a, _innerRef$current, table, globalStaticRef, propsRef, enableAsyncData, prevState, _innerRef$current2, filterState, sorterState, paginationState;
+      return _regeneratorRuntime__default["default"].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 来判断前后是否发生变化
+              schemaUtils.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;
+}
+exports.useResetDataSource = useResetDataSource;

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

@@ -0,0 +1,27 @@
+/** @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.
+ */
+'use strict';
+
+Object.defineProperty(exports, '__esModule', {
+  value: true
+});
+var schemaUtils = require('@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 = schemaUtils.getBoolConfig(groupingConfig, {
+    aggregationFn: 'count'
+  }, {
+    mergeDft: true
+  });
+  return config;
+}
+exports.getGroupingConfig = getGroupingConfig;

package/lib/cjs/features/column-grouping/use-opts.js

@@ -0,0 +1,42 @@
+/** @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.
+ */
+'use strict';
+
+Object.defineProperty(exports, '__esModule', {
+  value: true
+});
+var reactTable = require('@tanstack/react-table');
+function useRowGroupedOpts(ctx) {
+  return getRowGroupedOptions(ctx);
+}
+/**
+ * 获取列分组配置选项
+ */
+function getRowGroupedOptions(ctx) {
+  var enableRowGrouping = ctx.staticOptsRef.current.enableRowGrouping;
+  if (!enableRowGrouping) {
+    return {
+      enableGrouping: false,
+      onGroupingChange: function onGroupingChange() {
+        // empty onGroupingChange
+        // 起到即使主动设置 grouping 状态，也会被直接忽略的作用
+      }
+    };
+  }
+  return {
+    enableGrouping: true,
+    groupedColumnMode: false,
+    getGroupedRowModel: reactTable.getGroupedRowModel(),
+    autoResetExpanded: false // 数据变化时保持分组的展开状态
+  };
+}
+
+exports.getRowGroupedOptions = getRowGroupedOptions;
+exports.useRowGroupedOpts = useRowGroupedOpts;