@nokecy/qc-ui 1.1.31 → 1.1.32

package/dist/cjs/ag-grid-plus/shared/permissions/globalConfigPermissions.d.ts

@@ -0,0 +1,22 @@
+/**
+ * 全局配置权限信息
+ * 由使用端（业务应用）统一传入，而非从后端 API 获取
+ * @author nokecy
+ *
+ * @example
+ * ```tsx
+ * <GridPlusContext.Provider value={{
+ *   ...schemeManager,
+ *   globalConfigPermissions: {
+ *     canApplyToGlobal: currentUser.hasPermission('TableScheme.ManageGlobalConfig'),
+ *     canResetAllUsers: currentUser.hasPermission('TableScheme.ManageGlobalConfig'),
+ *   }
+ * }}>
+ * ```
+ */
+export interface GlobalConfigPermissions {
+    /** 是否可以应用到全局 */
+    canApplyToGlobal: boolean;
+    /** 是否可以重置所有用户配置 */
+    canResetAllUsers: boolean;
+}

package/dist/cjs/ag-grid-plus/shared/permissions/globalConfigPermissions.js

@@ -0,0 +1,5 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});

package/dist/cjs/ag-grid-plus/shared/storage/localStorageAdapter.d.ts

@@ -42,6 +42,24 @@ export declare class LocalStorageSchemeAdapter implements SchemeStorageAdapter {
     saveQueryScheme(gridId: string, scheme: QueryScheme): Promise<QueryScheme>;
     deleteQueryScheme(gridId: string, schemeId: string): Promise<void>;
     setCurrentScheme(gridId: string, columnSchemeId: string | null, querySchemeId: string | null): Promise<void>;
+    /**
+     * 将方案应用到全局
+     * LocalStorage 实现: 将方案标记为 isGlobal=true
+     * @author nokecy
+     */
+    applyToGlobal(gridId: string, schemeId: string): Promise<string>;
+    /**
+     * 重置为全局配置
+     * LocalStorage 实现: 清除当前方案选择，让其回退到全局方案
+     * @author nokecy
+     */
+    resetToGlobal(gridId: string): Promise<void>;
+    /**
+     * 重置所有用户配置
+     * LocalStorage 实现: 删除所有非全局方案，清除当前方案选择
+     * @author nokecy
+     */
+    resetAllUsers(gridId: string): Promise<void>;
     /**
      * 清除所有数据
      */

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

@@ -325,10 +325,124 @@ var LocalStorageSchemeAdapter = exports.LocalStorageSchemeAdapter = /*#__PURE__*
         return _setCurrentScheme.apply(this, arguments);
       }
       return setCurrentScheme;
+    }() // ========== 全局配置操作（模拟实现） ==========
+    /**
+     * 将方案应用到全局
+     * LocalStorage 实现: 将方案标记为 isGlobal=true
+     * @author nokecy
+     */
+  }, {
+    key: "applyToGlobal",
+    value: function () {
+      var _applyToGlobal = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee7(gridId, schemeId) {
+        var data, schemes, scheme;
+        return _regeneratorRuntime().wrap(function _callee7$(_context7) {
+          while (1) switch (_context7.prev = _context7.next) {
+            case 0:
+              data = this.readData();
+              schemes = data.columnSchemes[gridId] || [];
+              scheme = schemes.find(function (s) {
+                return s.id === schemeId;
+              });
+              if (scheme) {
+                _context7.next = 5;
+                break;
+              }
+              throw new Error("\u65B9\u6848\u4E0D\u5B58\u5728: ".concat(schemeId));
+            case 5:
+              // 先将所有方案的 isGlobal 设为 false
+              schemes.forEach(function (s) {
+                s.isGlobal = false;
+              });
+
+              // 将目标方案标记为全局方案
+              scheme.isGlobal = true;
+              scheme.updatedAt = Date.now();
+              this.log("\u5E94\u7528\u5230\u5168\u5C40: ".concat(gridId, " - ").concat(scheme.name));
+              this.writeData(data);
+              return _context7.abrupt("return", schemeId);
+            case 11:
+            case "end":
+              return _context7.stop();
+          }
+        }, _callee7, this);
+      }));
+      function applyToGlobal(_x12, _x13) {
+        return _applyToGlobal.apply(this, arguments);
+      }
+      return applyToGlobal;
+    }()
+    /**
+     * 重置为全局配置
+     * LocalStorage 实现: 清除当前方案选择，让其回退到全局方案
+     * @author nokecy
+     */
+  }, {
+    key: "resetToGlobal",
+    value: (function () {
+      var _resetToGlobal = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee8(gridId) {
+        var data;
+        return _regeneratorRuntime().wrap(function _callee8$(_context8) {
+          while (1) switch (_context8.prev = _context8.next) {
+            case 0:
+              data = this.readData(); // 清除当前用户的列方案选择
+              if (data.currentSchemes[gridId]) {
+                data.currentSchemes[gridId].columnSchemeId = null;
+              }
+              this.log("\u91CD\u7F6E\u4E3A\u5168\u5C40\u914D\u7F6E: ".concat(gridId));
+              this.writeData(data);
+            case 4:
+            case "end":
+              return _context8.stop();
+          }
+        }, _callee8, this);
+      }));
+      function resetToGlobal(_x14) {
+        return _resetToGlobal.apply(this, arguments);
+      }
+      return resetToGlobal;
+    }()
+    /**
+     * 重置所有用户配置
+     * LocalStorage 实现: 删除所有非全局方案，清除当前方案选择
+     * @author nokecy
+     */
+    )
+  }, {
+    key: "resetAllUsers",
+    value: (function () {
+      var _resetAllUsers = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee9(gridId) {
+        var data, schemes;
+        return _regeneratorRuntime().wrap(function _callee9$(_context9) {
+          while (1) switch (_context9.prev = _context9.next) {
+            case 0:
+              data = this.readData();
+              schemes = data.columnSchemes[gridId] || []; // 只保留全局方案
+              data.columnSchemes[gridId] = schemes.filter(function (s) {
+                return s.isGlobal;
+              });
+
+              // 清除当前方案选择
+              if (data.currentSchemes[gridId]) {
+                data.currentSchemes[gridId].columnSchemeId = null;
+              }
+              this.log("\u91CD\u7F6E\u6240\u6709\u7528\u6237\u914D\u7F6E: ".concat(gridId, "\uFF0C\u4FDD\u7559 ").concat(data.columnSchemes[gridId].length, " \u4E2A\u5168\u5C40\u65B9\u6848"));
+              this.writeData(data);
+            case 6:
+            case "end":
+              return _context9.stop();
+          }
+        }, _callee9, this);
+      }));
+      function resetAllUsers(_x15) {
+        return _resetAllUsers.apply(this, arguments);
+      }
+      return resetAllUsers;
     }() // ========== 工具方法 ==========
     /**
      * 清除所有数据
      */
+    )
   }, {
     key: "clearAll",
     value: function clearAll() {

package/dist/cjs/ag-grid-plus/shared/storage/schemeStorageAdapter.d.ts

@@ -101,6 +101,8 @@ export interface ColumnScheme {
     updatedAt?: number;
     /** 创建用户ID（可选） */
     createdBy?: string;
+    /** 方案来源标识（便于前端区分展示，由前端计算） */
+    isGlobal?: boolean;
 }
 /**
  * 方案同步数据结构
@@ -172,6 +174,29 @@ export interface SchemeStorageAdapter {
      * @param querySchemeId 查询方案ID (null 表示清除)
      */
     setCurrentScheme(gridId: string, columnSchemeId: string | null, querySchemeId: string | null): Promise<void>;
+    /**
+     * 将方案应用到全局（管理员操作）
+     * 将指定的用户方案复制为 UserId=null 的全局方案
+     * @param gridId 表格标识
+     * @param schemeId 源方案ID（用户的方案）
+     * @returns 全局方案ID
+     * @throws 403 - 无权限
+     * @throws 404 - 源方案不存在
+     */
+    applyToGlobal?(gridId: string, schemeId: string): Promise<string>;
+    /**
+     * 重置当前用户配置，回退到全局配置
+     * 删除当前用户在指定表格的所有个人方案
+     * @param gridId 表格标识
+     */
+    resetToGlobal?(gridId: string): Promise<void>;
+    /**
+     * 重置所有用户配置（管理员操作）
+     * 删除指定表格下所有用户的个人方案，保留全局方案
+     * @param gridId 表格标识
+     * @throws 403 - 无权限
+     */
+    resetAllUsers?(gridId: string): Promise<void>;
 }
 /**
  * 适配器配置基类

package/dist/cjs/index.d.ts

@@ -29,5 +29,5 @@ export type * from "./importModal";
 export type * from "./fullScreenAlert";
 export type * from "./RuleBuilder";
 export type { ColumnConfig } from "./array-table/columnHelper";
-export type { CentralizedColumnScheme, QueryScheme, SchemeStorageAdapter, SchemeSyncDataDto, CurrentSchemeDto, SchemeStorageConfig, LocalStorageAdapterConfig, BackendApiAdapterConfig, UseSchemeManagerConfig, GridPlusContextValue, } from "./ag-grid-plus";
+export type { CentralizedColumnScheme, QueryScheme, SchemeStorageAdapter, SchemeSyncDataDto, CurrentSchemeDto, SchemeStorageConfig, LocalStorageAdapterConfig, BackendApiAdapterConfig, UseSchemeManagerConfig, GridPlusContextValue, GlobalConfigPermissions, } from "./ag-grid-plus";
 export type { ParseResult as RegexParseResult, ValidationResult as RegexValidationResult, RegexError, ComplexityMetrics, ASTNode, AstRegExp, RegexTemplate, TestResult as RegexTestResult, CodeMirrorWrapperProps, RegexEditorProps, RegexFlags, MatchResult, RegexTesterProps, FlagsSelectorProps, MatchItemProps, RegexRailroadDiagramProps, } from "./components/RegexEditor";

package/dist/esm/ag-grid-plus/ag-gridPlus.js

@@ -92,7 +92,11 @@ function AgGridPlus(props) {
     extensibleColumns = _useGridPlusColumnSta.extensibleColumns,
     applyToGlobal = _useGridPlusColumnSta.applyToGlobal,
     resetCurrent = _useGridPlusColumnSta.resetCurrent,
-    resetAll = _useGridPlusColumnSta.resetAll;
+    resetAll = _useGridPlusColumnSta.resetAll,
+    globalConfigPermissions = _useGridPlusColumnSta.globalConfigPermissions,
+    applySchemeToGlobal = _useGridPlusColumnSta.applySchemeToGlobal,
+    resetToGlobal = _useGridPlusColumnSta.resetToGlobal,
+    resetAllUsers = _useGridPlusColumnSta.resetAllUsers;
   var gridRef = useRef();
   var apiRef = useRef();
   var allColDefsRef = useRef([]);
@@ -1245,7 +1249,12 @@ function AgGridPlus(props) {
       refreshSchemes: refreshSchemes,
       getColumnSchemes: getColumnSchemes,
       getQuerySchemes: getQuerySchemes,
-      getCurrentScheme: getCurrentScheme
+      getCurrentScheme: getCurrentScheme,
+      // ========== 全局配置 API（透传给子组件） ==========
+      globalConfigPermissions: globalConfigPermissions,
+      applySchemeToGlobal: applySchemeToGlobal,
+      resetToGlobal: resetToGlobal,
+      resetAllUsers: resetAllUsers
     };
   }, [extensibleColumns, gridPlusColumnState, allColDefsRef.current,
   // 【修复】添加到依赖数组
@@ -1253,7 +1262,9 @@ function AgGridPlus(props) {
   // 【新增】添加初始列定义到依赖数组
   onSaveColumnState, applyToGlobal, resetCurrent, resetAll, currentQueryScheme, queryItemsOrder, queryFormItems,
   // 方案管理依赖
-  columnSchemes, querySchemes, currentSchemes, schemesLoading, lastSyncTime, saveColumnScheme, deleteColumnScheme, saveQueryScheme, deleteQueryScheme, setCurrentColumnScheme, setCurrentQueryScheme, refreshSchemes, getColumnSchemes, getQuerySchemes, getCurrentScheme]);
+  columnSchemes, querySchemes, currentSchemes, schemesLoading, lastSyncTime, saveColumnScheme, deleteColumnScheme, saveQueryScheme, deleteQueryScheme, setCurrentColumnScheme, setCurrentQueryScheme, refreshSchemes, getColumnSchemes, getQuerySchemes, getCurrentScheme,
+  // 全局配置依赖
+  globalConfigPermissions, applySchemeToGlobal, resetToGlobal, resetAllUsers]);
   return /*#__PURE__*/React.createElement(GridPlusContext.Provider, {
     value: gridPlusContextValue
   }, /*#__PURE__*/React.createElement(Spin, {

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

@@ -1,5 +1,6 @@
 import React from "react";
 import type { ColumnScheme, QueryScheme, CurrentSchemeDto } from "../shared/storage/schemeStorageAdapter";
+import type { GlobalConfigPermissions } from '../shared/permissions/globalConfigPermissions';
 /**
  * 方案管理 API 接口
  *
@@ -144,5 +145,26 @@ export interface GridPlusContextValue extends SchemeManagementAPI {
      * 此字段由 useSchemeManager 自动管理，无需手动设置
      */
     currentUserId?: string | null;
+    /**
+     * 将当前列配置应用为全局默认（管理员操作）
+     * @param gridId 表格标识
+     * @param schemeId 源方案ID（可选，不传则使用当前激活的方案）
+     */
+    applySchemeToGlobal?: (gridId: string, schemeId?: string) => Promise<void>;
+    /**
+     * 重置当前用户配置，回退到全局配置
+     * @param gridId 表格标识
+     */
+    resetToGlobal?: (gridId: string) => Promise<void>;
+    /**
+     * 重置所有用户配置（管理员操作）
+     * @param gridId 表格标识
+     */
+    resetAllUsers?: (gridId: string) => Promise<void>;
+    /**
+     * 全局配置权限信息
+     * 由使用端（业务应用）传入，用于前端根据权限动态显示/隐藏操作按钮
+     */
+    globalConfigPermissions?: GlobalConfigPermissions;
 }
 export declare const GridPlusContext: React.Context<GridPlusContextValue>;

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

@@ -51,6 +51,9 @@ export declare function useSchemeManager(config: UseSchemeManagerConfig): {
     getColumnSchemes: (gridId: string) => ColumnScheme[];
     getQuerySchemes: (gridId: string) => QueryScheme[];
     getCurrentScheme: (gridId: string) => CurrentSchemeDto | null;
+    applySchemeToGlobal: (gridId: string, schemeId?: string) => Promise<string>;
+    resetToGlobal: (gridId: string) => Promise<void>;
+    resetAllUsers: (gridId: string) => Promise<void>;
 };
 /**
  * 在组件中使用集中式方案管理

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

@@ -430,6 +430,161 @@ export function useSchemeManager(config) {
       }
     }, _callee8);
   })), [loadAllSchemes]);
+
+  // ========== 全局配置操作 ==========
+
+  /**
+   * 处理全局配置操作的错误
+   * @author nokecy
+   */
+  var handleGlobalConfigError = useCallback(function (error, defaultMessage) {
+    var _error$response;
+    if (((_error$response = error.response) === null || _error$response === void 0 ? void 0 : _error$response.status) === 403) {
+      message.error('没有权限执行此操作');
+    } else {
+      message.error(error.message || defaultMessage);
+    }
+  }, []);
+
+  /**
+   * 将方案应用到全局（管理员操作）
+   * @author nokecy
+   */
+  var applySchemeToGlobal = useCallback( /*#__PURE__*/function () {
+    var _ref9 = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee9(gridId, schemeId) {
+      var _currentSchemes$gridI3;
+      var targetSchemeId, globalSchemeId;
+      return _regeneratorRuntime().wrap(function _callee9$(_context9) {
+        while (1) switch (_context9.prev = _context9.next) {
+          case 0:
+            targetSchemeId = schemeId || ((_currentSchemes$gridI3 = currentSchemes[gridId]) === null || _currentSchemes$gridI3 === void 0 ? void 0 : _currentSchemes$gridI3.columnSchemeId);
+            if (targetSchemeId) {
+              _context9.next = 3;
+              break;
+            }
+            throw new Error('没有可应用的方案');
+          case 3:
+            if (adapter.applyToGlobal) {
+              _context9.next = 5;
+              break;
+            }
+            throw new Error('当前存储适配器不支持全局配置功能');
+          case 5:
+            _context9.prev = 5;
+            _context9.next = 8;
+            return adapter.applyToGlobal(gridId, targetSchemeId);
+          case 8:
+            globalSchemeId = _context9.sent;
+            message.success('已应用到全局配置');
+            _context9.next = 12;
+            return refreshSchemes();
+          case 12:
+            return _context9.abrupt("return", globalSchemeId);
+          case 15:
+            _context9.prev = 15;
+            _context9.t0 = _context9["catch"](5);
+            console.error('[useSchemeManager] 应用到全局失败:', _context9.t0);
+            handleGlobalConfigError(_context9.t0, '应用到全局失败');
+            throw _context9.t0;
+          case 20:
+          case "end":
+            return _context9.stop();
+        }
+      }, _callee9, null, [[5, 15]]);
+    }));
+    return function (_x13, _x14) {
+      return _ref9.apply(this, arguments);
+    };
+  }(), [adapter, currentSchemes, refreshSchemes, handleGlobalConfigError]);
+
+  /**
+   * 重置当前用户配置，回退到全局配置
+   * @author nokecy
+   */
+  var resetToGlobal = useCallback( /*#__PURE__*/function () {
+    var _ref10 = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee10(gridId) {
+      return _regeneratorRuntime().wrap(function _callee10$(_context10) {
+        while (1) switch (_context10.prev = _context10.next) {
+          case 0:
+            if (adapter.resetToGlobal) {
+              _context10.next = 2;
+              break;
+            }
+            throw new Error('当前存储适配器不支持全局配置功能');
+          case 2:
+            _context10.prev = 2;
+            _context10.next = 5;
+            return adapter.resetToGlobal(gridId);
+          case 5:
+            setCurrentSchemes(function (prev) {
+              return _objectSpread(_objectSpread({}, prev), {}, _defineProperty({}, gridId, _objectSpread(_objectSpread({}, prev[gridId]), {}, {
+                columnSchemeId: null
+              })));
+            });
+            _context10.next = 8;
+            return refreshSchemes();
+          case 8:
+            message.success('已重置为全局配置');
+            _context10.next = 16;
+            break;
+          case 11:
+            _context10.prev = 11;
+            _context10.t0 = _context10["catch"](2);
+            console.error('[useSchemeManager] 重置为全局配置失败:', _context10.t0);
+            handleGlobalConfigError(_context10.t0, '重置失败');
+            throw _context10.t0;
+          case 16:
+          case "end":
+            return _context10.stop();
+        }
+      }, _callee10, null, [[2, 11]]);
+    }));
+    return function (_x15) {
+      return _ref10.apply(this, arguments);
+    };
+  }(), [adapter, refreshSchemes, handleGlobalConfigError]);
+
+  /**
+   * 重置所有用户配置（管理员操作）
+   * @author nokecy
+   */
+  var resetAllUsers = useCallback( /*#__PURE__*/function () {
+    var _ref11 = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee11(gridId) {
+      return _regeneratorRuntime().wrap(function _callee11$(_context11) {
+        while (1) switch (_context11.prev = _context11.next) {
+          case 0:
+            if (adapter.resetAllUsers) {
+              _context11.next = 2;
+              break;
+            }
+            throw new Error('当前存储适配器不支持全局配置功能');
+          case 2:
+            _context11.prev = 2;
+            _context11.next = 5;
+            return adapter.resetAllUsers(gridId);
+          case 5:
+            _context11.next = 7;
+            return refreshSchemes();
+          case 7:
+            message.success('已重置所有用户配置');
+            _context11.next = 15;
+            break;
+          case 10:
+            _context11.prev = 10;
+            _context11.t0 = _context11["catch"](2);
+            console.error('[useSchemeManager] 重置所有用户配置失败:', _context11.t0);
+            handleGlobalConfigError(_context11.t0, '重置失败');
+            throw _context11.t0;
+          case 15:
+          case "end":
+            return _context11.stop();
+        }
+      }, _callee11, null, [[2, 10]]);
+    }));
+    return function (_x16) {
+      return _ref11.apply(this, arguments);
+    };
+  }(), [adapter, refreshSchemes, handleGlobalConfigError]);
   var getColumnSchemes = useCallback(function (gridId) {
     return columnSchemes[gridId] || [];
   }, [columnSchemes]);
@@ -461,7 +616,11 @@ export function useSchemeManager(config) {
     refreshSchemes: refreshSchemes,
     getColumnSchemes: getColumnSchemes,
     getQuerySchemes: getQuerySchemes,
-    getCurrentScheme: getCurrentScheme
+    getCurrentScheme: getCurrentScheme,
+    // 全局配置操作
+    applySchemeToGlobal: applySchemeToGlobal,
+    resetToGlobal: resetToGlobal,
+    resetAllUsers: resetAllUsers
   };
 }
 

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

@@ -12,3 +12,4 @@ export type { SchemeStorageAdapter, SchemeSyncDataDto, CurrentSchemeDto, SchemeS
 export type { UseSchemeManagerConfig } from "./context/useSchemeManager";
 export type { BackendApiAdapterConfig } from "./shared/storage/backendApiAdapter";
 export type { LocalStorageAdapterConfig } from "./shared/storage/localStorageAdapter";
+export type { GlobalConfigPermissions } from "./shared/permissions/globalConfigPermissions";

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

@@ -13,5 +13,7 @@ export { useSchemeManager, useGridSchemes } from "./context/useSchemeManager";
 export { LocalStorageSchemeAdapter } from "./shared/storage/localStorageAdapter";
 export { BackendApiSchemeAdapter } from "./shared/storage/backendApiAdapter";
 
+// 权限相关类型
+
 // 注意: 旧的查询方案管理功能已废弃
 // 相关导出已移除，请使用集中式方案管理 API (useSchemeManager/useGridSchemes)