@nokecy/qc-ui 1.1.37 → 1.1.39

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

@@ -18,34 +18,35 @@ 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';
 
-/**
- * useSchemeManager Hook 配置
+/**
+ * useSchemeManager Hook 配置
  */
 
-/**
- * 集中式方案管理 Hook
- *
- * 用于 GridPlusContext.Provider 中初始化方案管理功能
- *
- * @example
- * ```tsx
- * function AppProvider({ children }) {
- *   const adapter = new BackendApiSchemeAdapter({ ... });
- *   const schemeManager = useSchemeManager({ adapter });
- *
- *   return (
- *     <GridPlusContext.Provider value={{
- *       ...otherValues,
- *       ...schemeManager
- *     }}>
- *       {children}
- *     </GridPlusContext.Provider>
- *   );
- * }
- * ```
+/**
+ * 集中式方案管理 Hook
+ *
+ * 用于 GridPlusContext.Provider 中初始化方案管理功能
+ *
+ * @example
+ * ```tsx
+ * function AppProvider({ children }) {
+ *   const adapter = new BackendApiSchemeAdapter({ ... });
+ *   const schemeManager = useSchemeManager({ adapter });
+ *
+ *   return (
+ *     <GridPlusContext.Provider value={{
+ *       ...otherValues,
+ *       ...schemeManager
+ *     }}>
+ *       {children}
+ *     </GridPlusContext.Provider>
+ *   );
+ * }
+ * ```
  */
 export function useSchemeManager(config) {
   var adapter = config.adapter,
@@ -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);
@@ -433,9 +471,9 @@ export function useSchemeManager(config) {
 
   // ========== 全局配置操作 ==========
 
-  /**
-   * 处理全局配置操作的错误
-   * @author nokecy
+  /**
+   * 处理全局配置操作的错误
+   * @author nokecy
    */
   var handleGlobalConfigError = useCallback(function (error, defaultMessage) {
     var _error$response;
@@ -446,9 +484,9 @@ export function useSchemeManager(config) {
     }
   }, []);
 
-  /**
-   * 将方案应用到全局（管理员操作）
-   * @author nokecy
+  /**
+   * 将方案应用到全局（管理员操作）
+   * @author nokecy
    */
   var applySchemeToGlobal = useCallback( /*#__PURE__*/function () {
     var _ref9 = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee9(gridId, schemeId) {
@@ -471,35 +509,36 @@ 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);
     };
   }(), [adapter, currentSchemes, refreshSchemes, handleGlobalConfigError]);
 
-  /**
-   * 重置当前用户配置，回退到全局配置
-   * @author nokecy
+  /**
+   * 重置当前用户配置，回退到全局配置
+   * @author nokecy
    */
   var resetToGlobal = useCallback( /*#__PURE__*/function () {
     var _ref10 = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee10(gridId) {
@@ -513,40 +552,41 @@ 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);
     };
   }(), [adapter, refreshSchemes, handleGlobalConfigError]);
 
-  /**
-   * 重置所有用户配置（管理员操作）
-   * @author nokecy
+  /**
+   * 重置所有用户配置（管理员操作）
+   * @author nokecy
    */
   var resetAllUsers = useCallback( /*#__PURE__*/function () {
     var _ref11 = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee11(gridId) {
@@ -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);
@@ -624,64 +665,64 @@ export function useSchemeManager(config) {
   };
 }
 
-/**
- * 在组件中使用集中式方案管理
- *
- * ⚠️ 必须在 Provider 中传入 SchemeManager 状态，否则抛出错误
- *
- * @example
- * ```tsx
- * // 1. 创建适配器和方案管理器
- * function App() {
- *   const adapter = useMemo(
- *     () => new BackendApiSchemeAdapter({
- *       apiBaseUrl: 'https://api.example.com',
- *       getToken: () => localStorage.getItem('token'),
- *       getUserId: () => localStorage.getItem('userId')
- *     }),
- *     []
- *   );
- *
- *   const schemeManager = useSchemeManager({
- *     adapter,
- *     autoLoad: true,
- *     showErrorMessage: true,
- *     currentUserId: currentUser?.id
- *   });
- *
- *   // 2. 传入 Provider
- *   return (
- *     <GridPlusContext.Provider value={{
- *       extensibleColumns: [],
- *       columnState: undefined,
- *       onSaveColumnState: () => {},
- *       applyToGlobal: () => {},
- *       resetCurrent: () => {},
- *       resetAll: () => {},
- *       queryFormItems: [],
- *       ...schemeManager  // 展开方案管理状态
- *     }}>
- *       <MyGrid />
- *     </GridPlusContext.Provider>
- *   );
- * }
- *
- * // 3. 在子组件中使用
- * function MyGrid() {
- *   const {
- *     columnSchemes,
- *     saveColumnScheme,
- *     setCurrentColumnScheme
- *   } = useGridSchemes();
- *
- *   const gridId = 'my-grid';
- *   const schemes = columnSchemes?.[gridId] || [];
- *
- *   const handleSave = async () => {
- *     await saveColumnScheme?.(gridId, newScheme);
- *   };
- * }
- * ```
+/**
+ * 在组件中使用集中式方案管理
+ *
+ * ⚠️ 必须在 Provider 中传入 SchemeManager 状态，否则抛出错误
+ *
+ * @example
+ * ```tsx
+ * // 1. 创建适配器和方案管理器
+ * function App() {
+ *   const adapter = useMemo(
+ *     () => new BackendApiSchemeAdapter({
+ *       apiBaseUrl: 'https://api.example.com',
+ *       getToken: () => localStorage.getItem('token'),
+ *       getUserId: () => localStorage.getItem('userId')
+ *     }),
+ *     []
+ *   );
+ *
+ *   const schemeManager = useSchemeManager({
+ *     adapter,
+ *     autoLoad: true,
+ *     showErrorMessage: true,
+ *     currentUserId: currentUser?.id
+ *   });
+ *
+ *   // 2. 传入 Provider
+ *   return (
+ *     <GridPlusContext.Provider value={{
+ *       extensibleColumns: [],
+ *       columnState: undefined,
+ *       onSaveColumnState: () => {},
+ *       applyToGlobal: () => {},
+ *       resetCurrent: () => {},
+ *       resetAll: () => {},
+ *       queryFormItems: [],
+ *       ...schemeManager  // 展开方案管理状态
+ *     }}>
+ *       <MyGrid />
+ *     </GridPlusContext.Provider>
+ *   );
+ * }
+ *
+ * // 3. 在子组件中使用
+ * function MyGrid() {
+ *   const {
+ *     columnSchemes,
+ *     saveColumnScheme,
+ *     setCurrentColumnScheme
+ *   } = useGridSchemes();
+ *
+ *   const gridId = 'my-grid';
+ *   const schemes = columnSchemes?.[gridId] || [];
+ *
+ *   const handleSave = async () => {
+ *     await saveColumnScheme?.(gridId, newScheme);
+ *   };
+ * }
+ * ```
  */
 export function useGridSchemes() {
   var context = useContext(GridPlusContext);