@nokecy/qc-ui 1.0.95 → 1.0.97

package/dist/cjs/ag-grid-plus/context/gridContext.d.ts

@@ -1,125 +1,155 @@
 import React from "react";
 import type { ColumnScheme, QueryScheme, CurrentSchemeDto } from "../shared/storage/schemeStorageAdapter";
-export interface GridPlusContextValue {
+import type { BackendApiAdapterConfig } from "../shared/storage/backendApiAdapter";
+/**
+ * 方案管理 API 接口
+ *
+ * 这些 API 由 useGridSchemes Hook 自动提供，不需要在 Provider 中手动配置
+ */
+export interface SchemeManagementAPI {
     /**
-     * 扩展列，允许运行时动态添加，用于展示用户自定义的列
-     */
-    extensibleColumns: any;
-    /**
-     * 当前表格的列状态信息，包括列的显示/隐藏、顺序、宽度等
-     */
-    columnState: any;
-    /**
-     * 原始完整的列定义，包含所有自定义属性（cellRenderer、valueFormatter、valueEnum 等）
-     * 用于列方案应用时保留这些属性
-     */
-    allColDefs?: import('../types').ExtendedColDef[];
-    /**
-     * 保存当前表格的列状态到服务器（仅保存当前表格）
-     * @param gridKey 表格唯一标识
-     * @param columnState 当前列状态数组
-     */
-    onSaveColumnState: (gridKey: string, columnState: any[]) => void;
-    /**
-     * 将当前列配置应用为"全局默认"，影响所有表格
-     * @param columnState 要应用的列配置
-     */
-    applyToGlobal: (gridKey: string) => void;
-    /**
-     * 恢复当前用户当前表格为"默认列配置"
-     * @param gridKey 表格唯一标识
-     */
-    resetCurrent: (gridKey: string) => void;
-    /**
-     * 恢复所有用户当前表格为"默认列配置"
-     */
-    resetAll: (gridKey: string) => void;
-    /**
-     * 查询表单项列表（用于查询方案管理器）
-     */
-    queryFormItems?: any[];
-    /**
-     * 当前查询项顺序
-     */
-    currentQueryOrder?: string[];
-    /**
-     * 更新查询项顺序
-     */
-    updateQueryOrder?: (order: string[]) => void;
-    /**
-     * 所有列方案，按 GridId 分组
+     * 所有表格的列方案数据
+     * key: gridId, value: 该表格的列方案数组
      */
     columnSchemes?: Record<string, ColumnScheme[]>;
     /**
-     * 所有查询方案，按 GridId 分组
+     * 所有表格的查询方案数据
+     * key: gridId, value: 该表格的查询方案数组
      */
     querySchemes?: Record<string, QueryScheme[]>;
     /**
-     * 当前激活的方案，按 GridId 存储
+     * 所有表格的当前方案
+     * key: gridId, value: 该表格的当前方案ID
      */
     currentSchemes?: Record<string, CurrentSchemeDto>;
     /**
-     * 是否正在加载方案数据
+     * 方案加载状态
      */
     schemesLoading?: boolean;
     /**
-     * 最后同步时间
+     * 最后同步时间戳
      */
     lastSyncTime?: number;
     /**
-     * 保存/更新列方案
-     * @param gridId 表格ID
-     * @param scheme 方案对象
+     * 保存列方案
      */
     saveColumnScheme?: (gridId: string, scheme: ColumnScheme) => Promise<void>;
     /**
      * 删除列方案
-     * @param gridId 表格ID
-     * @param schemeId 方案ID
      */
     deleteColumnScheme?: (gridId: string, schemeId: string) => Promise<void>;
     /**
      * 设置当前列方案
-     * @param gridId 表格ID
-     * @param schemeId 方案ID (null 表示清除)
      */
     setCurrentColumnScheme?: (gridId: string, schemeId: string | null) => Promise<void>;
     /**
-     * 保存/更新查询方案
-     * @param gridId 表格ID
-     * @param scheme 方案对象
+     * 保存查询方案
      */
     saveQueryScheme?: (gridId: string, scheme: QueryScheme) => Promise<void>;
     /**
      * 删除查询方案
-     * @param gridId 表格ID
-     * @param schemeId 方案ID
      */
     deleteQueryScheme?: (gridId: string, schemeId: string) => Promise<void>;
     /**
      * 设置当前查询方案
-     * @param gridId 表格ID
-     * @param schemeId 方案ID (null 表示清除)
      */
     setCurrentQueryScheme?: (gridId: string, schemeId: string | null) => Promise<void>;
     /**
-     * 强制重新加载所有方案
+     * 刷新所有方案数据
      */
     refreshSchemes?: () => Promise<void>;
     /**
      * 获取指定表格的列方案列表
-     * @param gridId 表格ID
      */
     getColumnSchemes?: (gridId: string) => ColumnScheme[];
     /**
      * 获取指定表格的查询方案列表
-     * @param gridId 表格ID
      */
     getQuerySchemes?: (gridId: string) => QueryScheme[];
     /**
      * 获取指定表格的当前方案
-     * @param gridId 表格ID
      */
     getCurrentScheme?: (gridId: string) => CurrentSchemeDto | null;
 }
+/**
+ * GridPlus Context 值接口
+ *
+ * 注意：方案管理 API 不需要在 Provider 中配置，它们由 useGridSchemes Hook 自动提供
+ */
+export interface GridPlusContextValue extends SchemeManagementAPI {
+    /**
+     * 扩展列，允许运行时动态添加，用于展示用户自定义的列
+     */
+    extensibleColumns: any;
+    /**
+     * 当前表格的列状态信息，包括列的显示/隐藏、顺序、宽度等
+     */
+    columnState: any;
+    /**
+     * 原始完整的列定义，包含所有自定义属性（cellRenderer、valueFormatter、valueEnum 等）
+     * 用于列方案应用时保留这些属性
+     */
+    allColDefs?: import('../types').ExtendedColDef[];
+    /**
+     * 保存当前表格的列状态到服务器（仅保存当前表格）
+     * @param gridKey 表格唯一标识
+     * @param columnState 当前列状态数组
+     */
+    onSaveColumnState: (gridKey: string, columnState: any[]) => void;
+    /**
+     * 将当前列配置应用为"全局默认"，影响所有表格
+     * @param columnState 要应用的列配置
+     */
+    applyToGlobal: (gridKey: string) => void;
+    /**
+     * 恢复当前用户当前表格为"默认列配置"
+     * @param gridKey 表格唯一标识
+     */
+    resetCurrent: (gridKey: string) => void;
+    /**
+     * 恢复所有用户当前表格为"默认列配置"
+     */
+    resetAll: (gridKey: string) => void;
+    /**
+     * 查询表单项列表（用于查询方案管理器）
+     */
+    queryFormItems?: any[];
+    /**
+     * 当前查询项顺序
+     */
+    currentQueryOrder?: string[];
+    /**
+     * 更新查询项顺序
+     */
+    updateQueryOrder?: (order: string[]) => void;
+    /**
+     * 后端 API 配置（可选）
+     *
+     * 如果提供此配置，useGridSchemes Hook 将自动使用 BackendApiSchemeAdapter
+     * 否则将使用 LocalStorageSchemeAdapter
+     *
+     * @example
+     * ```tsx
+     * backendApiConfig: {
+     *   apiBaseUrl: 'https://api.example.com',
+     *   getToken: () => localStorage.getItem('token'),
+     *   getUserId: () => localStorage.getItem('userId'),
+     *   timeout: 10000
+     * }
+     * ```
+     */
+    backendApiConfig?: Omit<BackendApiAdapterConfig, 'enableDebugLog'>;
+    /**
+     * 当前用户ID（可选）
+     *
+     * 用于监听用户切换，自动重新加载方案数据
+     * 当此值变化时，系统会自动调用 refreshSchemes() 重新加载所有方案
+     *
+     * @example
+     * ```tsx
+     * currentUserId: currentUser?.id
+     * ```
+     */
+    currentUserId?: string | null;
+}
 export declare const GridPlusContext: React.Context<GridPlusContextValue>;

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

@@ -6,6 +6,18 @@ Object.defineProperty(exports, "__esModule", {
 exports.GridPlusContext = void 0;
 var _react = _interopRequireDefault(require("react"));
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+/**
+ * 方案管理 API 接口
+ *
+ * 这些 API 由 useGridSchemes Hook 自动提供，不需要在 Provider 中手动配置
+ */
+
+/**
+ * GridPlus Context 值接口
+ *
+ * 注意：方案管理 API 不需要在 Provider 中配置，它们由 useGridSchemes Hook 自动提供
+ */
+
 var GridPlusContext = exports.GridPlusContext = /*#__PURE__*/_react.default.createContext({
   extensibleColumns: [],
   columnState: undefined,

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

@@ -58,7 +58,8 @@ 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;
 
   // ========== 状态管理 ==========
 
@@ -145,6 +146,23 @@ function useSchemeManager(config) {
     }
   }, [autoLoad, loadAllSchemes]);
 
+  // 监听用户ID变化，自动重新加载方案（用于用户登录/切换场景）
+  var prevUserIdRef = (0, _react.useRef)(currentUserId);
+  (0, _react.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 = (0, _react.useCallback)( /*#__PURE__*/function () {
@@ -464,19 +482,37 @@ function useSchemeManager(config) {
 }
 
 /**
- * Fallback 模式：当无 Provider 时使用本地状态管理
+ * Fallback 模式：根据后端 API 配置自动选择适配器
  */
-function useFallbackSchemeManager() {
-  var adapter = (0, _react.useRef)(new (require("../shared/storage/localStorageAdapter").LocalStorageSchemeAdapter)({
-    storageKey: 'ag-grid-plus-schemes',
-    enableDebugLog: false
-  })).current;
+function useFallbackSchemeManager(backendApiConfig, currentUserId) {
+  // 根据配置选择适配器
+  var adapter = (0, _react.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 相同的接口
@@ -495,12 +531,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,
@@ -520,17 +587,10 @@ function useFallbackSchemeManager() {
 function useGridSchemes() {
   var context = (0, _react.useContext)(_gridContext.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);
 }

package/dist/cjs/ag-grid-plus/shared/storage/backendApiAdapter.js

@@ -24,7 +24,16 @@ function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e
  * 内部配置类型(所有字段必填)
  */
 /**
- * 后端 API 响应格式
+ * 后端 API 响应格式 - 基础响应
+ */
+/**
+ * 保存方案结果
+ */
+/**
+ * 删除方案结果
+ */
+/**
+ * 设置当前方案结果
  */
 /**
  * 后端 API 方案存储适配器
@@ -184,7 +193,7 @@ var BackendApiSchemeAdapter = exports.BackendApiSchemeAdapter = /*#__PURE__*/fun
             case 0:
               _context2.prev = 0;
               this.log('加载所有方案数据');
-              url = "".concat(this.config.apiBaseUrl, "/api/extra-object/table-scheme/user-schemes");
+              url = "".concat(this.config.apiBaseUrl, "/api/extra-object/table-scheme/schemes");
               _context2.next = 5;
               return this.request(url);
             case 5:
@@ -216,13 +225,13 @@ var BackendApiSchemeAdapter = exports.BackendApiSchemeAdapter = /*#__PURE__*/fun
     key: "saveColumnScheme",
     value: function () {
       var _saveColumnScheme = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee3(gridId, scheme) {
-        var _response$data, url, response;
+        var url, response;
         return _regeneratorRuntime().wrap(function _callee3$(_context3) {
           while (1) switch (_context3.prev = _context3.next) {
             case 0:
               _context3.prev = 0;
               this.log("\u4FDD\u5B58\u5217\u65B9\u6848: ".concat(gridId, " - ").concat(scheme.name));
-              url = "".concat(this.config.apiBaseUrl, "/api/extra-object/table-scheme/column-scheme");
+              url = "".concat(this.config.apiBaseUrl, "/api/extra-object/table-scheme/save-column-scheme");
               _context3.next = 5;
               return this.request(url, {
                 method: 'POST',
@@ -239,8 +248,8 @@ var BackendApiSchemeAdapter = exports.BackendApiSchemeAdapter = /*#__PURE__*/fun
               }
               throw new Error(response.message || '保存失败');
             case 8:
-              this.log('保存成功', (_response$data = response.data) === null || _response$data === void 0 ? void 0 : _response$data.scheme.id);
-              return _context3.abrupt("return", response.data.scheme);
+              this.log('保存成功', response.scheme);
+              return _context3.abrupt("return", response.scheme);
             case 12:
               _context3.prev = 12;
               _context3.t0 = _context3["catch"](0);
@@ -268,10 +277,10 @@ var BackendApiSchemeAdapter = exports.BackendApiSchemeAdapter = /*#__PURE__*/fun
             case 0:
               _context4.prev = 0;
               this.log("\u5220\u9664\u5217\u65B9\u6848: ".concat(gridId, " - ").concat(schemeId));
-              url = "".concat(this.config.apiBaseUrl, "/api/extra-object/table-scheme/column-scheme/").concat(schemeId, "?gridId=").concat(gridId);
+              url = "".concat(this.config.apiBaseUrl, "/api/extra-object/table-scheme/delete-column-scheme?schemeId=").concat(schemeId, "&gridId=").concat(gridId);
               _context4.next = 5;
               return this.request(url, {
-                method: 'DELETE'
+                method: 'POST'
               });
             case 5:
               response = _context4.sent;
@@ -305,13 +314,13 @@ var BackendApiSchemeAdapter = exports.BackendApiSchemeAdapter = /*#__PURE__*/fun
     key: "saveQueryScheme",
     value: function () {
       var _saveQueryScheme = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee5(gridId, scheme) {
-        var _response$data2, url, response;
+        var url, response;
         return _regeneratorRuntime().wrap(function _callee5$(_context5) {
           while (1) switch (_context5.prev = _context5.next) {
             case 0:
               _context5.prev = 0;
               this.log("\u4FDD\u5B58\u67E5\u8BE2\u65B9\u6848: ".concat(gridId, " - ").concat(scheme.name));
-              url = "".concat(this.config.apiBaseUrl, "/api/extra-object/table-scheme/query-scheme");
+              url = "".concat(this.config.apiBaseUrl, "/api/extra-object/table-scheme/save-query-scheme");
               _context5.next = 5;
               return this.request(url, {
                 method: 'POST',
@@ -328,8 +337,8 @@ var BackendApiSchemeAdapter = exports.BackendApiSchemeAdapter = /*#__PURE__*/fun
               }
               throw new Error(response.message || '保存失败');
             case 8:
-              this.log('保存成功', (_response$data2 = response.data) === null || _response$data2 === void 0 ? void 0 : _response$data2.scheme.id);
-              return _context5.abrupt("return", response.data.scheme);
+              this.log('保存成功', response.scheme);
+              return _context5.abrupt("return", response.scheme);
             case 12:
               _context5.prev = 12;
               _context5.t0 = _context5["catch"](0);
@@ -357,10 +366,10 @@ var BackendApiSchemeAdapter = exports.BackendApiSchemeAdapter = /*#__PURE__*/fun
             case 0:
               _context6.prev = 0;
               this.log("\u5220\u9664\u67E5\u8BE2\u65B9\u6848: ".concat(gridId, " - ").concat(schemeId));
-              url = "".concat(this.config.apiBaseUrl, "/api/extra-object/table-scheme/query-scheme/").concat(schemeId, "?gridId=").concat(gridId);
+              url = "".concat(this.config.apiBaseUrl, "/api/extra-object/table-scheme/delete-query-scheme?schemeId=").concat(schemeId, "&gridId=").concat(gridId);
               _context6.next = 5;
               return this.request(url, {
-                method: 'DELETE'
+                method: 'POST'
               });
             case 5:
               response = _context6.sent;
@@ -403,10 +412,10 @@ var BackendApiSchemeAdapter = exports.BackendApiSchemeAdapter = /*#__PURE__*/fun
                 columnSchemeId: columnSchemeId,
                 querySchemeId: querySchemeId
               });
-              url = "".concat(this.config.apiBaseUrl, "/api/extra-object/table-scheme/current-scheme");
+              url = "".concat(this.config.apiBaseUrl, "/api/extra-object/table-scheme/set-current-scheme");
               _context7.next = 5;
               return this.request(url, {
-                method: 'PUT',
+                method: 'POST',
                 body: JSON.stringify({
                   gridId: gridId,
                   columnSchemeId: columnSchemeId,