@nokecy/qc-ui 1.1.38 → 1.1.40

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

@@ -8,6 +8,7 @@ exports.useDerivedGridState = useDerivedGridState;
 exports.useSchemeDataFlow = useSchemeDataFlow;
 exports.useSchemeSource = useSchemeSource;
 var _react = require("react");
+var _logger = require("../utils/logger");
 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; }
@@ -44,7 +45,7 @@ function useSchemeSource(gridKey, schemeData) {
     querySchemes = schemeData.querySchemes,
     currentSchemes = schemeData.currentSchemes;
   return (0, _react.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;
 
@@ -112,6 +113,15 @@ function useSchemeSource(gridKey, schemeData) {
         isUsingGlobalQueryFallback = true;
       }
     }
+    _logger.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,
@@ -138,15 +148,32 @@ function useSchemeSource(gridKey, schemeData) {
  */
 function useDerivedGridState(currentScheme, allColDefs) {
   return (0, _react.useMemo)(function () {
+    var _currentScheme$column;
+    _logger.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.logger.debug('[useDerivedGridState] 返回 null (缺少必要数据)');
       return null;
     }
     try {
+      var _result$;
       var _require = require("../setting/columnGroupUtils"),
         flatConfigToGridState = _require.flatConfigToGridState;
 
       // 转换并缓存结果
       var result = flatConfigToGridState(currentScheme.columnConfig, allColDefs);
+      _logger.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);
@@ -174,6 +201,15 @@ function useDerivedColumnState(currentScheme, allColDefs) {
 
       // 转换列状态，传入原始列定义以检测新增列
       var result = flatConfigToColumnState(currentScheme.columnConfig, allColDefs);
+      _logger.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/cjs/ag-grid-plus/context/useSchemeManager.js

@@ -7,6 +7,7 @@ Object.defineProperty(exports, "__esModule", {
 exports.useGridSchemes = useGridSchemes;
 exports.useSchemeManager = useSchemeManager;
 var _react = require("react");
+var _logger = require("../utils/logger");
 var _gridContext = require("./gridContext");
 var _antd = require("antd");
 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; }
@@ -104,34 +105,39 @@ function useSchemeManager(config) {
           loadingRef.current = true;
           setLoading(true);
           _context.prev = 4;
-          _context.next = 7;
+          _logger.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.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) {
             _antd.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 时自动加载
@@ -146,6 +152,10 @@ function useSchemeManager(config) {
   (0, _react.useEffect)(function () {
     // 只有在用户ID实际变化且已经加载过数据时才重新加载
     if (currentUserId !== prevUserIdRef.current && loadedRef.current) {
+      _logger.logger.debug('[useSchemeManager] 用户切换，重新加载方案', {
+        from: prevUserIdRef.current,
+        to: currentUserId
+      });
       prevUserIdRef.current = currentUserId;
       loadedRef.current = false;
       loadAllSchemes();
@@ -163,9 +173,12 @@ function useSchemeManager(config) {
         while (1) switch (_context2.prev = _context2.next) {
           case 0:
             _context2.prev = 0;
-            _context2.next = 3;
+            _logger.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) {
@@ -180,18 +193,19 @@ function useSchemeManager(config) {
               }
               return _objectSpread(_objectSpread({}, prev), {}, _defineProperty({}, gridId, schemes));
             });
-            _context2.next = 11;
+            _logger.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);
@@ -204,9 +218,12 @@ function useSchemeManager(config) {
         while (1) switch (_context3.prev = _context3.next) {
           case 0:
             _context3.prev = 0;
-            _context3.next = 3;
+            _logger.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;
@@ -222,8 +239,14 @@ 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.logger.debug('[useSchemeManager] 删除的是当前方案,自动切换', {
+                  deletedSchemeId: schemeId,
+                  defaultSchemeId: newSchemeId,
+                  defaultSchemeName: (_defaultScheme2 = defaultScheme) === null || _defaultScheme2 === void 0 ? void 0 : _defaultScheme2.name
+                });
+
                 // 如果存在默认方案,同步到适配器
                 if (newSchemeId) {
                   var _prev$gridId2;
@@ -245,18 +268,19 @@ function useSchemeManager(config) {
               }
               return prev;
             });
-            _context3.next = 11;
+            _logger.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);
@@ -269,29 +293,32 @@ function useSchemeManager(config) {
         while (1) switch (_context4.prev = _context4.next) {
           case 0:
             _context4.prev = 0;
+            _logger.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.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);
@@ -307,9 +334,12 @@ function useSchemeManager(config) {
         while (1) switch (_context5.prev = _context5.next) {
           case 0:
             _context5.prev = 0;
-            _context5.next = 3;
+            _logger.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) {
@@ -324,18 +354,19 @@ function useSchemeManager(config) {
               }
               return _objectSpread(_objectSpread({}, prev), {}, _defineProperty({}, gridId, schemes));
             });
-            _context5.next = 11;
+            _logger.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);
@@ -347,9 +378,12 @@ function useSchemeManager(config) {
         while (1) switch (_context6.prev = _context6.next) {
           case 0:
             _context6.prev = 0;
-            _context6.next = 3;
+            _logger.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) {
@@ -368,18 +402,19 @@ function useSchemeManager(config) {
               }
               return prev;
             });
-            _context6.next = 11;
+            _logger.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);
@@ -392,29 +427,32 @@ function useSchemeManager(config) {
         while (1) switch (_context7.prev = _context7.next) {
           case 0:
             _context7.prev = 0;
+            _logger.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.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);
@@ -477,26 +515,27 @@ function useSchemeManager(config) {
             throw new Error('当前存储适配器不支持全局配置功能');
           case 5:
             _context9.prev = 5;
-            _context9.next = 8;
+            _logger.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;
             _antd.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);
@@ -519,31 +558,32 @@ function useSchemeManager(config) {
             throw new Error('当前存储适配器不支持全局配置功能');
           case 2:
             _context10.prev = 2;
-            _context10.next = 5;
+            _logger.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:
             _antd.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);
@@ -566,26 +606,27 @@ function useSchemeManager(config) {
             throw new Error('当前存储适配器不支持全局配置功能');
           case 2:
             _context11.prev = 2;
-            _context11.next = 5;
+            _logger.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:
             _antd.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/cjs/ag-grid-plus/errors/ErrorBoundary.d.ts

@@ -31,6 +31,6 @@ export declare class ErrorBoundary extends Component<ErrorBoundaryProps, ErrorBo
      * 重置错误状态,重新渲染组件
      */
     handleRetry: () => void;
-    render(): string | number | boolean | React.JSX.Element | Iterable<React.ReactNode> | null | undefined;
+    render(): string | number | boolean | Iterable<React.ReactNode> | React.JSX.Element | null | undefined;
 }
 export {};

package/dist/cjs/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/cjs/ag-grid-plus/hooks/index.js

@@ -3,49 +3,17 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-var _exportNames = {
-  useGridPlusColumnState: true
-};
 Object.defineProperty(exports, "useGridPlusColumnState", {
   enumerable: true,
   get: function get() {
     return _useGridPlusColumnState.useGridPlusColumnState;
   }
 });
-var _useAgGridData = require("./useAgGridData");
-Object.keys(_useAgGridData).forEach(function (key) {
-  if (key === "default" || key === "__esModule") return;
-  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
-  if (key in exports && exports[key] === _useAgGridData[key]) return;
-  Object.defineProperty(exports, key, {
-    enumerable: true,
-    get: function get() {
-      return _useAgGridData[key];
-    }
-  });
-});
-var _useAgGridCalculation = require("./useAgGridCalculation");
-Object.keys(_useAgGridCalculation).forEach(function (key) {
-  if (key === "default" || key === "__esModule") return;
-  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
-  if (key in exports && exports[key] === _useAgGridCalculation[key]) return;
-  Object.defineProperty(exports, key, {
-    enumerable: true,
-    get: function get() {
-      return _useAgGridCalculation[key];
-    }
-  });
-});
-var _useGridState = require("./useGridState");
-Object.keys(_useGridState).forEach(function (key) {
-  if (key === "default" || key === "__esModule") return;
-  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
-  if (key in exports && exports[key] === _useGridState[key]) return;
-  Object.defineProperty(exports, key, {
-    enumerable: true,
-    get: function get() {
-      return _useGridState[key];
-    }
-  });
+Object.defineProperty(exports, "useRowId", {
+  enumerable: true,
+  get: function get() {
+    return _useRowId.useRowId;
+  }
 });
-var _useGridPlusColumnState = require("./useGridPlusColumnState");
+var _useGridPlusColumnState = require("./useGridPlusColumnState");
+var _useRowId = require("./useRowId");

package/dist/cjs/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/cjs/ag-grid-plus/hooks/useRowId.js

@@ -0,0 +1,57 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useRowId = useRowId;
+var _react = require("react");
+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); }
+/**
+ * 行唯一 ID 生成 Hook(从 ag-gridPlus.tsx 抽出,逻辑原样)。
+ *
+ * 策略(按优先级):
+ * 1. 常见 ID 字段 id/_id/key/uid/uuid(基本类型直取;对象取 value 或 id 属性)
+ * 2. WeakMap 缓存命中
+ * 3. 生成 `${gridKey|grid}-row-{counter}-{timestamp}` 并缓存
+ *
+ * @author nokecy
+ */
+function useRowId(gridKey) {
+  var rowIdCacheRef = (0, _react.useRef)(new WeakMap());
+  var rowIdCounterRef = (0, _react.useRef)(0);
+  var generateUniqueRowId = (0, _react.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
+  };
+}