@nokecy/qc-ui 1.1.38 → 1.1.40

package/dist/esm/ag-grid-plus/context/useSchemeDataFlow.js

@@ -5,6 +5,7 @@ function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key i
 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); }
 import { useMemo } from 'react';
+import { logger } from "../utils/logger";
 
 /**
  * 【P1 架构优化】单向数据流 Hook
@@ -36,7 +37,7 @@ export function useSchemeSource(gridKey, schemeData) {
     querySchemes = schemeData.querySchemes,
     currentSchemes = schemeData.currentSchemes;
   return useMemo(function () {
-    var _currentSchemes$gridK, _currentSchemes$gridK2;
+    var _currentSchemes$gridK, _currentSchemes$gridK2, _currentColumnScheme;
     var schemes = (columnSchemes === null || columnSchemes === void 0 ? void 0 : columnSchemes[gridKey]) || [];
     var currentColumnSchemeId = currentSchemes === null || currentSchemes === void 0 || (_currentSchemes$gridK = currentSchemes[gridKey]) === null || _currentSchemes$gridK === void 0 ? void 0 : _currentSchemes$gridK.columnSchemeId;
 
@@ -104,6 +105,15 @@ export function useSchemeSource(gridKey, schemeData) {
         isUsingGlobalQueryFallback = true;
       }
     }
+    logger.debug('[useSchemeSource] 方案数据源:', {
+      gridKey: gridKey,
+      schemes: schemes,
+      currentColumnSchemeId: currentColumnSchemeId,
+      currentColumnScheme: currentColumnScheme,
+      hasCurrentScheme: !!currentColumnScheme,
+      isUsingGlobalFallback: isUsingGlobalFallback,
+      columnConfigLength: (_currentColumnScheme = currentColumnScheme) === null || _currentColumnScheme === void 0 || (_currentColumnScheme = _currentColumnScheme.columnConfig) === null || _currentColumnScheme === void 0 ? void 0 : _currentColumnScheme.length
+    });
     return {
       // 列方案
       columnSchemes: schemes,
@@ -130,15 +140,32 @@ export function useSchemeSource(gridKey, schemeData) {
  */
 export function useDerivedGridState(currentScheme, allColDefs) {
   return useMemo(function () {
+    var _currentScheme$column;
+    logger.debug('[useDerivedGridState] 输入参数:', {
+      hasScheme: !!currentScheme,
+      schemeId: currentScheme === null || currentScheme === void 0 ? void 0 : currentScheme.id,
+      configLength: currentScheme === null || currentScheme === void 0 || (_currentScheme$column = currentScheme.columnConfig) === null || _currentScheme$column === void 0 ? void 0 : _currentScheme$column.length,
+      allColDefsLength: allColDefs === null || allColDefs === void 0 ? void 0 : allColDefs.length
+    });
     if (!(currentScheme !== null && currentScheme !== void 0 && currentScheme.columnConfig) || !allColDefs || allColDefs.length === 0) {
+      logger.debug('[useDerivedGridState] 返回 null (缺少必要数据)');
       return null;
     }
     try {
+      var _result$;
       var _require = require("../setting/columnGroupUtils"),
         flatConfigToGridState = _require.flatConfigToGridState;
 
       // 转换并缓存结果
       var result = flatConfigToGridState(currentScheme.columnConfig, allColDefs);
+      logger.debug('[useDerivedGridState] 转换成功:', {
+        resultLength: result === null || result === void 0 ? void 0 : result.length,
+        columnOrder: result === null || result === void 0 ? void 0 : result.map(function (col) {
+          return col.field;
+        }),
+        firstColumn: result === null || result === void 0 || (_result$ = result[0]) === null || _result$ === void 0 ? void 0 : _result$.field,
+        fullResult: result
+      });
       return result;
     } catch (error) {
       console.error('[useDerivedGridState] 转换失败:', error);
@@ -166,6 +193,15 @@ export function useDerivedColumnState(currentScheme, allColDefs) {
 
       // 转换列状态，传入原始列定义以检测新增列
       var result = flatConfigToColumnState(currentScheme.columnConfig, allColDefs);
+      logger.debug('[useDerivedColumnState] 转换结果:', {
+        schemeId: currentScheme.id,
+        columnConfigLength: currentScheme.columnConfig.length,
+        resultLength: result === null || result === void 0 ? void 0 : result.length,
+        columnOrder: result === null || result === void 0 ? void 0 : result.map(function (r) {
+          return r.colId;
+        }),
+        fullResult: result
+      });
       return result;
     } catch (error) {
       console.error('[useDerivedColumnState] 转换失败:', error);

package/dist/esm/ag-grid-plus/context/useSchemeManager.js

@@ -18,6 +18,7 @@ function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len
 function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t.return && (u = t.return(), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
 function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
 import { useContext, useEffect, useState, useCallback, useRef } from 'react';
+import { logger } from "../utils/logger";
 import { GridPlusContext } from "./gridContext";
 import { message } from 'antd';
 
@@ -98,34 +99,39 @@ export function useSchemeManager(config) {
           loadingRef.current = true;
           setLoading(true);
           _context.prev = 4;
-          _context.next = 7;
+          logger.debug('[useSchemeManager] 开始加载所有方案数据');
+          _context.next = 8;
           return adapter.loadAllSchemes();
-        case 7:
+        case 8:
           data = _context.sent;
           setColumnSchemes(data.columnSchemes || {});
           setQuerySchemes(data.querySchemes || {});
           setCurrentSchemes(data.currentSchemes || {});
           setLastSyncTime(data.syncTime);
           loadedRef.current = true;
-          _context.next = 19;
+          logger.debug('[useSchemeManager] 加载完成', {
+            columnSchemes: Object.keys(data.columnSchemes || {}).length,
+            querySchemes: Object.keys(data.querySchemes || {}).length
+          });
+          _context.next = 21;
           break;
-        case 15:
-          _context.prev = 15;
+        case 17:
+          _context.prev = 17;
           _context.t0 = _context["catch"](4);
           console.error('[useSchemeManager] 加载失败:', _context.t0);
           if (showErrorMessage) {
             message.error('加载方案失败');
           }
-        case 19:
-          _context.prev = 19;
+        case 21:
+          _context.prev = 21;
           setLoading(false);
           loadingRef.current = false;
-          return _context.finish(19);
-        case 23:
+          return _context.finish(21);
+        case 25:
         case "end":
           return _context.stop();
       }
-    }, _callee, null, [[4, 15, 19, 23]]);
+    }, _callee, null, [[4, 17, 21, 25]]);
   })), [adapter, showErrorMessage]);
 
   // 组件 mount 时自动加载
@@ -140,6 +146,10 @@ export function useSchemeManager(config) {
   useEffect(function () {
     // 只有在用户ID实际变化且已经加载过数据时才重新加载
     if (currentUserId !== prevUserIdRef.current && loadedRef.current) {
+      logger.debug('[useSchemeManager] 用户切换，重新加载方案', {
+        from: prevUserIdRef.current,
+        to: currentUserId
+      });
       prevUserIdRef.current = currentUserId;
       loadedRef.current = false;
       loadAllSchemes();
@@ -157,9 +167,12 @@ export function useSchemeManager(config) {
         while (1) switch (_context2.prev = _context2.next) {
           case 0:
             _context2.prev = 0;
-            _context2.next = 3;
+            logger.debug("[useSchemeManager] \u4FDD\u5B58\u5217\u65B9\u6848: ".concat(gridId, " - ").concat(scheme.name));
+
+            // 调用适配器保存
+            _context2.next = 4;
             return adapter.saveColumnScheme(gridId, scheme);
-          case 3:
+          case 4:
             savedScheme = _context2.sent;
             // 更新本地状态
             setColumnSchemes(function (prev) {
@@ -174,18 +187,19 @@ export function useSchemeManager(config) {
               }
               return _objectSpread(_objectSpread({}, prev), {}, _defineProperty({}, gridId, schemes));
             });
-            _context2.next = 11;
+            logger.debug('[useSchemeManager] 保存成功');
+            _context2.next = 13;
             break;
-          case 7:
-            _context2.prev = 7;
+          case 9:
+            _context2.prev = 9;
             _context2.t0 = _context2["catch"](0);
             console.error('[useSchemeManager] 保存列方案失败:', _context2.t0);
             throw _context2.t0;
-          case 11:
+          case 13:
           case "end":
             return _context2.stop();
         }
-      }, _callee2, null, [[0, 7]]);
+      }, _callee2, null, [[0, 9]]);
     }));
     return function (_x, _x2) {
       return _ref2.apply(this, arguments);
@@ -198,9 +212,12 @@ export function useSchemeManager(config) {
         while (1) switch (_context3.prev = _context3.next) {
           case 0:
             _context3.prev = 0;
-            _context3.next = 3;
+            logger.debug("[useSchemeManager] \u5220\u9664\u5217\u65B9\u6848: ".concat(gridId, " - ").concat(schemeId));
+
+            // 调用适配器删除
+            _context3.next = 4;
             return adapter.deleteColumnScheme(gridId, schemeId);
-          case 3:
+          case 4:
             setColumnSchemes(function (prev) {
               var schemes = (prev[gridId] || []).filter(function (s) {
                 return s.id !== schemeId;
@@ -216,8 +233,14 @@ export function useSchemeManager(config) {
             setCurrentSchemes(function (prev) {
               var _prev$gridId;
               if (((_prev$gridId = prev[gridId]) === null || _prev$gridId === void 0 ? void 0 : _prev$gridId.columnSchemeId) === schemeId) {
-                var _defaultScheme;
+                var _defaultScheme, _defaultScheme2;
                 var newSchemeId = ((_defaultScheme = defaultScheme) === null || _defaultScheme === void 0 ? void 0 : _defaultScheme.id) || null;
+                logger.debug('[useSchemeManager] 删除的是当前方案,自动切换', {
+                  deletedSchemeId: schemeId,
+                  defaultSchemeId: newSchemeId,
+                  defaultSchemeName: (_defaultScheme2 = defaultScheme) === null || _defaultScheme2 === void 0 ? void 0 : _defaultScheme2.name
+                });
+
                 // 如果存在默认方案,同步到适配器
                 if (newSchemeId) {
                   var _prev$gridId2;
@@ -239,18 +262,19 @@ export function useSchemeManager(config) {
               }
               return prev;
             });
-            _context3.next = 11;
+            logger.debug('[useSchemeManager] 删除成功');
+            _context3.next = 13;
             break;
-          case 7:
-            _context3.prev = 7;
+          case 9:
+            _context3.prev = 9;
             _context3.t0 = _context3["catch"](0);
             console.error('[useSchemeManager] 删除列方案失败:', _context3.t0);
             throw _context3.t0;
-          case 11:
+          case 13:
           case "end":
             return _context3.stop();
         }
-      }, _callee3, null, [[0, 7]]);
+      }, _callee3, null, [[0, 9]]);
     }));
     return function (_x3, _x4) {
       return _ref3.apply(this, arguments);
@@ -263,29 +287,32 @@ export function useSchemeManager(config) {
         while (1) switch (_context4.prev = _context4.next) {
           case 0:
             _context4.prev = 0;
+            logger.debug("[useSchemeManager] \u8BBE\u7F6E\u5F53\u524D\u5217\u65B9\u6848: ".concat(gridId, " - ").concat(schemeId));
+
             // 获取当前的查询方案ID
             querySchemeId = ((_currentSchemes$gridI = currentSchemes[gridId]) === null || _currentSchemes$gridI === void 0 ? void 0 : _currentSchemes$gridI.querySchemeId) || null; // 调用适配器设置
-            _context4.next = 4;
+            _context4.next = 5;
             return adapter.setCurrentScheme(gridId, schemeId, querySchemeId);
-          case 4:
+          case 5:
             // 更新本地状态
             setCurrentSchemes(function (prev) {
               return _objectSpread(_objectSpread({}, prev), {}, _defineProperty({}, gridId, _objectSpread(_objectSpread({}, prev[gridId] || {}), {}, {
                 columnSchemeId: schemeId
               })));
             });
-            _context4.next = 11;
+            logger.debug('[useSchemeManager] 设置成功');
+            _context4.next = 13;
             break;
-          case 7:
-            _context4.prev = 7;
+          case 9:
+            _context4.prev = 9;
             _context4.t0 = _context4["catch"](0);
             console.error('[useSchemeManager] 设置当前列方案失败:', _context4.t0);
             throw _context4.t0;
-          case 11:
+          case 13:
           case "end":
             return _context4.stop();
         }
-      }, _callee4, null, [[0, 7]]);
+      }, _callee4, null, [[0, 9]]);
     }));
     return function (_x5, _x6) {
       return _ref4.apply(this, arguments);
@@ -301,9 +328,12 @@ export function useSchemeManager(config) {
         while (1) switch (_context5.prev = _context5.next) {
           case 0:
             _context5.prev = 0;
-            _context5.next = 3;
+            logger.debug("[useSchemeManager] \u4FDD\u5B58\u67E5\u8BE2\u65B9\u6848: ".concat(gridId, " - ").concat(scheme.name));
+
+            // 调用适配器保存
+            _context5.next = 4;
             return adapter.saveQueryScheme(gridId, scheme);
-          case 3:
+          case 4:
             savedScheme = _context5.sent;
             // 更新本地状态
             setQuerySchemes(function (prev) {
@@ -318,18 +348,19 @@ export function useSchemeManager(config) {
               }
               return _objectSpread(_objectSpread({}, prev), {}, _defineProperty({}, gridId, schemes));
             });
-            _context5.next = 11;
+            logger.debug('[useSchemeManager] 保存成功');
+            _context5.next = 13;
             break;
-          case 7:
-            _context5.prev = 7;
+          case 9:
+            _context5.prev = 9;
             _context5.t0 = _context5["catch"](0);
             console.error('[useSchemeManager] 保存查询方案失败:', _context5.t0);
             throw _context5.t0;
-          case 11:
+          case 13:
           case "end":
             return _context5.stop();
         }
-      }, _callee5, null, [[0, 7]]);
+      }, _callee5, null, [[0, 9]]);
     }));
     return function (_x7, _x8) {
       return _ref5.apply(this, arguments);
@@ -341,9 +372,12 @@ export function useSchemeManager(config) {
         while (1) switch (_context6.prev = _context6.next) {
           case 0:
             _context6.prev = 0;
-            _context6.next = 3;
+            logger.debug("[useSchemeManager] \u5220\u9664\u67E5\u8BE2\u65B9\u6848: ".concat(gridId, " - ").concat(schemeId));
+
+            // 调用适配器删除
+            _context6.next = 4;
             return adapter.deleteQueryScheme(gridId, schemeId);
-          case 3:
+          case 4:
             // 更新本地状态
             setQuerySchemes(function (prev) {
               var schemes = (prev[gridId] || []).filter(function (s) {
@@ -362,18 +396,19 @@ export function useSchemeManager(config) {
               }
               return prev;
             });
-            _context6.next = 11;
+            logger.debug('[useSchemeManager] 删除成功');
+            _context6.next = 13;
             break;
-          case 7:
-            _context6.prev = 7;
+          case 9:
+            _context6.prev = 9;
             _context6.t0 = _context6["catch"](0);
             console.error('[useSchemeManager] 删除查询方案失败:', _context6.t0);
             throw _context6.t0;
-          case 11:
+          case 13:
           case "end":
             return _context6.stop();
         }
-      }, _callee6, null, [[0, 7]]);
+      }, _callee6, null, [[0, 9]]);
     }));
     return function (_x9, _x10) {
       return _ref6.apply(this, arguments);
@@ -386,29 +421,32 @@ export function useSchemeManager(config) {
         while (1) switch (_context7.prev = _context7.next) {
           case 0:
             _context7.prev = 0;
+            logger.debug("[useSchemeManager] \u8BBE\u7F6E\u5F53\u524D\u67E5\u8BE2\u65B9\u6848: ".concat(gridId, " - ").concat(schemeId));
+
             // 获取当前的列方案ID
             columnSchemeId = ((_currentSchemes$gridI2 = currentSchemes[gridId]) === null || _currentSchemes$gridI2 === void 0 ? void 0 : _currentSchemes$gridI2.columnSchemeId) || null; // 调用适配器设置
-            _context7.next = 4;
+            _context7.next = 5;
             return adapter.setCurrentScheme(gridId, columnSchemeId, schemeId);
-          case 4:
+          case 5:
             // 更新本地状态
             setCurrentSchemes(function (prev) {
               return _objectSpread(_objectSpread({}, prev), {}, _defineProperty({}, gridId, _objectSpread(_objectSpread({}, prev[gridId] || {}), {}, {
                 querySchemeId: schemeId
               })));
             });
-            _context7.next = 11;
+            logger.debug('[useSchemeManager] 设置成功');
+            _context7.next = 13;
             break;
-          case 7:
-            _context7.prev = 7;
+          case 9:
+            _context7.prev = 9;
             _context7.t0 = _context7["catch"](0);
             console.error('[useSchemeManager] 设置当前查询方案失败:', _context7.t0);
             throw _context7.t0;
-          case 11:
+          case 13:
           case "end":
             return _context7.stop();
         }
-      }, _callee7, null, [[0, 7]]);
+      }, _callee7, null, [[0, 9]]);
     }));
     return function (_x11, _x12) {
       return _ref7.apply(this, arguments);
@@ -471,26 +509,27 @@ export function useSchemeManager(config) {
             throw new Error('当前存储适配器不支持全局配置功能');
           case 5:
             _context9.prev = 5;
-            _context9.next = 8;
+            logger.debug("[useSchemeManager] \u5E94\u7528\u5230\u5168\u5C40: ".concat(gridId, " - ").concat(targetSchemeId));
+            _context9.next = 9;
             return adapter.applyToGlobal(gridId, targetSchemeId);
-          case 8:
+          case 9:
             globalSchemeId = _context9.sent;
             message.success('已应用到全局配置');
-            _context9.next = 12;
+            _context9.next = 13;
             return refreshSchemes();
-          case 12:
+          case 13:
             return _context9.abrupt("return", globalSchemeId);
-          case 15:
-            _context9.prev = 15;
+          case 16:
+            _context9.prev = 16;
             _context9.t0 = _context9["catch"](5);
             console.error('[useSchemeManager] 应用到全局失败:', _context9.t0);
             handleGlobalConfigError(_context9.t0, '应用到全局失败');
             throw _context9.t0;
-          case 20:
+          case 21:
           case "end":
             return _context9.stop();
         }
-      }, _callee9, null, [[5, 15]]);
+      }, _callee9, null, [[5, 16]]);
     }));
     return function (_x13, _x14) {
       return _ref9.apply(this, arguments);
@@ -513,31 +552,32 @@ export function useSchemeManager(config) {
             throw new Error('当前存储适配器不支持全局配置功能');
           case 2:
             _context10.prev = 2;
-            _context10.next = 5;
+            logger.debug("[useSchemeManager] \u91CD\u7F6E\u4E3A\u5168\u5C40\u914D\u7F6E: ".concat(gridId));
+            _context10.next = 6;
             return adapter.resetToGlobal(gridId);
-          case 5:
+          case 6:
             setCurrentSchemes(function (prev) {
               return _objectSpread(_objectSpread({}, prev), {}, _defineProperty({}, gridId, _objectSpread(_objectSpread({}, prev[gridId]), {}, {
                 columnSchemeId: null
               })));
             });
-            _context10.next = 8;
+            _context10.next = 9;
             return refreshSchemes();
-          case 8:
+          case 9:
             message.success('已重置为全局配置');
-            _context10.next = 16;
+            _context10.next = 17;
             break;
-          case 11:
-            _context10.prev = 11;
+          case 12:
+            _context10.prev = 12;
             _context10.t0 = _context10["catch"](2);
             console.error('[useSchemeManager] 重置为全局配置失败:', _context10.t0);
             handleGlobalConfigError(_context10.t0, '重置失败');
             throw _context10.t0;
-          case 16:
+          case 17:
           case "end":
             return _context10.stop();
         }
-      }, _callee10, null, [[2, 11]]);
+      }, _callee10, null, [[2, 12]]);
     }));
     return function (_x15) {
       return _ref10.apply(this, arguments);
@@ -560,26 +600,27 @@ export function useSchemeManager(config) {
             throw new Error('当前存储适配器不支持全局配置功能');
           case 2:
             _context11.prev = 2;
-            _context11.next = 5;
+            logger.debug("[useSchemeManager] \u91CD\u7F6E\u6240\u6709\u7528\u6237\u914D\u7F6E: ".concat(gridId));
+            _context11.next = 6;
             return adapter.resetAllUsers(gridId);
-          case 5:
-            _context11.next = 7;
+          case 6:
+            _context11.next = 8;
             return refreshSchemes();
-          case 7:
+          case 8:
             message.success('已重置所有用户配置');
-            _context11.next = 15;
+            _context11.next = 16;
             break;
-          case 10:
-            _context11.prev = 10;
+          case 11:
+            _context11.prev = 11;
             _context11.t0 = _context11["catch"](2);
             console.error('[useSchemeManager] 重置所有用户配置失败:', _context11.t0);
             handleGlobalConfigError(_context11.t0, '重置失败');
             throw _context11.t0;
-          case 15:
+          case 16:
           case "end":
             return _context11.stop();
         }
-      }, _callee11, null, [[2, 10]]);
+      }, _callee11, null, [[2, 11]]);
     }));
     return function (_x16) {
       return _ref11.apply(this, arguments);

package/dist/esm/ag-grid-plus/hooks/index.d.ts

@@ -1,7 +1,5 @@
 /**
  * AG-Grid Plus Hooks
  */
-export * from './useAgGridData';
-export * from './useAgGridCalculation';
-export * from './useGridState';
 export { useGridPlusColumnState } from './useGridPlusColumnState';
+export { useRowId } from './useRowId';

package/dist/esm/ag-grid-plus/hooks/index.js

@@ -2,9 +2,5 @@
  * AG-Grid Plus Hooks
  */
 
-export * from "./useAgGridData";
-export * from "./useAgGridCalculation";
-export * from "./useGridState";
-
-// 导出 useGridPlusColumnState (已存在)
-export { useGridPlusColumnState } from "./useGridPlusColumnState";
+export { useGridPlusColumnState } from "./useGridPlusColumnState";
+export { useRowId } from "./useRowId";

package/dist/esm/ag-grid-plus/hooks/useRowId.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 行唯一 ID 生成 Hook(从 ag-gridPlus.tsx 抽出,逻辑原样)。
+ *
+ * 策略(按优先级):
+ * 1. 常见 ID 字段 id/_id/key/uid/uuid(基本类型直取;对象取 value 或 id 属性)
+ * 2. WeakMap 缓存命中
+ * 3. 生成 `${gridKey|grid}-row-{counter}-{timestamp}` 并缓存
+ *
+ * @author nokecy
+ */
+export declare function useRowId(gridKey?: string): {
+    generateUniqueRowId: (data: any) => string;
+};

package/dist/esm/ag-grid-plus/hooks/useRowId.js

@@ -0,0 +1,52 @@
+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); }
+import { useCallback, useRef } from 'react';
+
+/**
+ * 行唯一 ID 生成 Hook(从 ag-gridPlus.tsx 抽出,逻辑原样)。
+ *
+ * 策略(按优先级):
+ * 1. 常见 ID 字段 id/_id/key/uid/uuid(基本类型直取;对象取 value 或 id 属性)
+ * 2. WeakMap 缓存命中
+ * 3. 生成 `${gridKey|grid}-row-{counter}-{timestamp}` 并缓存
+ *
+ * @author nokecy
+ */
+export function useRowId(gridKey) {
+  var rowIdCacheRef = useRef(new WeakMap());
+  var rowIdCounterRef = useRef(0);
+  var generateUniqueRowId = useCallback(function (data) {
+    if (!data || _typeof(data) !== 'object') {
+      return "row-empty-".concat(rowIdCounterRef.current++);
+    }
+    var commonIdFields = ['id', '_id', 'key', 'uid', 'uuid'];
+    for (var _i = 0, _commonIdFields = commonIdFields; _i < _commonIdFields.length; _i++) {
+      var field = _commonIdFields[_i];
+      var value = data[field];
+      if (value !== undefined && value !== null && value !== '') {
+        var fieldId = void 0;
+        if (_typeof(value) === 'object' && value !== null) {
+          if (value.value !== undefined) {
+            fieldId = String(value.value);
+          } else if (value.id !== undefined) {
+            fieldId = String(value.id);
+          } else {
+            fieldId = "".concat(field, "-").concat(JSON.stringify(value));
+          }
+        } else {
+          fieldId = String(value);
+        }
+        return fieldId;
+      }
+    }
+    var cachedId = rowIdCacheRef.current.get(data);
+    if (cachedId) {
+      return cachedId;
+    }
+    var uniqueId = "".concat(gridKey || 'grid', "-row-").concat(rowIdCounterRef.current++, "-").concat(Date.now());
+    rowIdCacheRef.current.set(data, uniqueId);
+    return uniqueId;
+  }, [gridKey]);
+  return {
+    generateUniqueRowId: generateUniqueRowId
+  };
+}

package/dist/esm/ag-grid-plus/interface.d.ts

@@ -19,9 +19,18 @@ interface GridProps extends AgGridReactProps {
     headerTitle?: React.ReactNode;
     columnDefs?: (AgGridColumnPropsClone | ColGroupDef<any>)[] | null;
     toolBarRender?: (gridApi?: GridApi, filter?: string, queryFilter?: any, paginationInfo?: {
+        /** @deprecated 改用 page */
         current: number;
+        /** @deprecated 改用 page/pageSize */
         skipCount: number;
+        /** @deprecated 改用 page/pageSize */
         maxResultCount: number;
+        /** 当前页码（1-based）
+         * @author nokecy */
+        page?: number;
+        /** 每页条数
+         * @author nokecy */
+        pageSize?: number;
     }) => React.ReactNode[];
     defaultSearchExpand?: Boolean;
     /**