@nokecy/qc-ui 1.0.95 → 1.0.96

package/dist/esm/ag-grid-plus/context/useSchemeManager.d.ts

@@ -10,6 +10,8 @@ export interface UseSchemeManagerConfig {
     autoLoad?: boolean;
     /** 加载失败时是否显示错误提示,默认 true */
     showErrorMessage?: boolean;
+    /** 当前用户ID，用于监听用户切换 */
+    currentUserId?: string | null;
 }
 /**
  * 集中式方案管理 Hook
@@ -53,12 +55,43 @@ export declare function useSchemeManager(config: UseSchemeManagerConfig): {
 /**
  * 在组件中使用集中式方案管理
  *
- * 支持两种模式:
- * 1. Context 模式: 从 GridPlusContext.Provider 获取全局状态
- * 2. Fallback 模式: 使用本地 Hook 实例 + LocalStorage
+ * 支持两种模式（根据 Context 配置自动选择）:
+ * 1. Backend API 模式: Context 提供 backendApiConfig，使用后端适配器
+ * 2. LocalStorage 模式: 不提供配置，使用本地存储适配器
  *
  * @example
  * ```tsx
+ * // 模式1：提供后端 API 配置
+ * <GridPlusContext.Provider value={{
+ *   extensibleColumns: [],
+ *   columnState: undefined,
+ *   onSaveColumnState: () => {},
+ *   applyToGlobal: () => {},
+ *   resetCurrent: () => {},
+ *   resetAll: () => {},
+ *   queryFormItems: [],
+ *   backendApiConfig: {
+ *     apiBaseUrl: 'https://api.example.com',
+ *     getToken: () => localStorage.getItem('token'),
+ *     getUserId: () => localStorage.getItem('userId')
+ *   }
+ * }}>
+ *   <MyGrid />
+ * </GridPlusContext.Provider>
+ *
+ * // 模式2：无配置，自动使用 LocalStorage
+ * <GridPlusContext.Provider value={{
+ *   extensibleColumns: [],
+ *   columnState: undefined,
+ *   onSaveColumnState: () => {},
+ *   applyToGlobal: () => {},
+ *   resetCurrent: () => {},
+ *   resetAll: () => {},
+ *   queryFormItems: []
+ * }}>
+ *   <MyGrid />
+ * </GridPlusContext.Provider>
+ *
  * function MyGrid() {
  *   const {
  *     columnSchemes,

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

@@ -52,7 +52,8 @@ export function useSchemeManager(config) {
     _config$autoLoad = config.autoLoad,
     autoLoad = _config$autoLoad === void 0 ? true : _config$autoLoad,
     _config$showErrorMess = config.showErrorMessage,
-    showErrorMessage = _config$showErrorMess === void 0 ? true : _config$showErrorMess;
+    showErrorMessage = _config$showErrorMess === void 0 ? true : _config$showErrorMess,
+    currentUserId = config.currentUserId;
 
   // ========== 状态管理 ==========
 
@@ -139,6 +140,23 @@ export function useSchemeManager(config) {
     }
   }, [autoLoad, loadAllSchemes]);
 
+  // 监听用户ID变化，自动重新加载方案（用于用户登录/切换场景）
+  var prevUserIdRef = useRef(currentUserId);
+  useEffect(function () {
+    // 只有在用户ID实际变化且已经加载过数据时才重新加载
+    if (currentUserId !== prevUserIdRef.current && loadedRef.current) {
+      console.log('[useSchemeManager] 用户切换，重新加载方案', {
+        from: prevUserIdRef.current,
+        to: currentUserId
+      });
+      prevUserIdRef.current = currentUserId;
+      loadedRef.current = false;
+      loadAllSchemes();
+    } else {
+      prevUserIdRef.current = currentUserId;
+    }
+  }, [currentUserId, loadAllSchemes]);
+
   // ========== 列方案操作 ==========
 
   var saveColumnScheme = useCallback( /*#__PURE__*/function () {
@@ -458,19 +476,37 @@ export function useSchemeManager(config) {
 }
 
 /**
- * Fallback 模式：当无 Provider 时使用本地状态管理
+ * Fallback 模式：根据后端 API 配置自动选择适配器
  */
-function useFallbackSchemeManager() {
-  var adapter = useRef(new (require("../shared/storage/localStorageAdapter").LocalStorageSchemeAdapter)({
-    storageKey: 'ag-grid-plus-schemes',
-    enableDebugLog: false
-  })).current;
+function useFallbackSchemeManager(backendApiConfig, currentUserId) {
+  // 根据配置选择适配器
+  var adapter = useRef(function () {
+    if (backendApiConfig) {
+      // 如果提供了后端 API 配置，使用后端适配器
+      var _require = require("../shared/storage/backendApiAdapter"),
+        BackendApiSchemeAdapter = _require.BackendApiSchemeAdapter;
+      console.log('[useFallbackSchemeManager] 使用后端 API 适配器');
+      return new BackendApiSchemeAdapter(_objectSpread(_objectSpread({}, backendApiConfig), {}, {
+        enableDebugLog: false
+      }));
+    } else {
+      // 否则使用本地存储适配器
+      var _require2 = require("../shared/storage/localStorageAdapter"),
+        LocalStorageSchemeAdapter = _require2.LocalStorageSchemeAdapter;
+      console.log('[useFallbackSchemeManager] 使用本地存储适配器');
+      return new LocalStorageSchemeAdapter({
+        storageKey: 'ag-grid-plus-schemes',
+        enableDebugLog: false
+      });
+    }
+  }).current();
 
-  // 使用本地 Hook 实例进行状态管理
+  // 使用选定的适配器进行状态管理
   var manager = useSchemeManager({
     adapter: adapter,
     autoLoad: true,
-    showErrorMessage: true
+    showErrorMessage: true,
+    currentUserId: currentUserId
   });
 
   // 返回与 Context 相同的接口
@@ -489,12 +525,43 @@ function useFallbackSchemeManager() {
 /**
  * 在组件中使用集中式方案管理
  *
- * 支持两种模式:
- * 1. Context 模式: 从 GridPlusContext.Provider 获取全局状态
- * 2. Fallback 模式: 使用本地 Hook 实例 + LocalStorage
+ * 支持两种模式（根据 Context 配置自动选择）:
+ * 1. Backend API 模式: Context 提供 backendApiConfig，使用后端适配器
+ * 2. LocalStorage 模式: 不提供配置，使用本地存储适配器
  *
  * @example
  * ```tsx
+ * // 模式1：提供后端 API 配置
+ * <GridPlusContext.Provider value={{
+ *   extensibleColumns: [],
+ *   columnState: undefined,
+ *   onSaveColumnState: () => {},
+ *   applyToGlobal: () => {},
+ *   resetCurrent: () => {},
+ *   resetAll: () => {},
+ *   queryFormItems: [],
+ *   backendApiConfig: {
+ *     apiBaseUrl: 'https://api.example.com',
+ *     getToken: () => localStorage.getItem('token'),
+ *     getUserId: () => localStorage.getItem('userId')
+ *   }
+ * }}>
+ *   <MyGrid />
+ * </GridPlusContext.Provider>
+ *
+ * // 模式2：无配置，自动使用 LocalStorage
+ * <GridPlusContext.Provider value={{
+ *   extensibleColumns: [],
+ *   columnState: undefined,
+ *   onSaveColumnState: () => {},
+ *   applyToGlobal: () => {},
+ *   resetCurrent: () => {},
+ *   resetAll: () => {},
+ *   queryFormItems: []
+ * }}>
+ *   <MyGrid />
+ * </GridPlusContext.Provider>
+ *
  * function MyGrid() {
  *   const {
  *     columnSchemes,
@@ -514,17 +581,10 @@ function useFallbackSchemeManager() {
 export function useGridSchemes() {
   var context = useContext(GridPlusContext);
 
-  // 检查是否有完整的方案管理 API
-  var hasSchemeApi = !!(context.saveColumnScheme && context.deleteColumnScheme && context.setCurrentColumnScheme && context.saveQueryScheme && context.deleteQueryScheme && context.setCurrentQueryScheme);
-
-  // 如果 Context 提供了完整 API，直接使用
-  if (hasSchemeApi) {
-    return context;
-  }
-
-  // 否则使用 fallback 模式
-  console.warn('[useGridSchemes] Context 未提供方案管理 API，使用 Fallback 模式（LocalStorage + 本地状态）');
+  // 根据后端 API 配置自动选择适配器
+  var adapterType = context !== null && context !== void 0 && context.backendApiConfig ? '后端 API' : 'LocalStorage';
+  console.log("[useGridSchemes] \u4F7F\u7528 ".concat(adapterType, " \u9002\u914D\u5668"));
 
   // eslint-disable-next-line react-hooks/rules-of-hooks
-  return useFallbackSchemeManager();
+  return useFallbackSchemeManager(context === null || context === void 0 ? void 0 : context.backendApiConfig, context === null || context === void 0 ? void 0 : context.currentUserId);
 }