@nokecy/qc-ui 1.0.71 → 1.0.72

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

@@ -27,10 +27,11 @@ var _locale = require("./locale");
 var _gridContext = require("./context/gridContext");
 var _querySchemes = require("./querySchemes");
 var _schemes = require("./schemes");
+var _globalSyncManager = require("./storage/globalSyncManager");
 var _sanitize = require("./utils/sanitize");
 var _errors = require("./errors");
 var _logger = require("./utils/logger");
-var _excluded = ["style", "loading", "params", "request", "dataSource", "treeKeyName", "treeParentName", "rowData", "gridRef", "headerTitle", "toolBarRender", "search", "hideTool", "onGridReady", "gridKey", "children", "defaultSearchExpand", "overlayNoRowsTemplateText", "queryDefaultRows", "onSelectedRowsChange", "enableQuerySchemes", "querySchemeStorageAdapter", "enableColumnSchemes", "columnSchemeStorageAdapter"];
+var _excluded = ["style", "loading", "params", "request", "dataSource", "treeKeyName", "treeParentName", "rowData", "gridRef", "headerTitle", "toolBarRender", "search", "hideTool", "onGridReady", "gridKey", "children", "defaultSearchExpand", "overlayNoRowsTemplateText", "queryDefaultRows", "onSelectedRowsChange", "enableQuerySchemes", "querySchemeStorageAdapter", "querySchemeManager", "enableColumnSchemes", "columnSchemeStorageAdapter", "columnSchemeManager"];
 function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(e) { return e ? t : r; })(e); }
 function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != _typeof(e) && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && Object.prototype.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
@@ -76,11 +77,13 @@ function AgGridPlus(props) {
     queryDefaultRows = props.queryDefaultRows,
     onSelectedRowsChange = props.onSelectedRowsChange,
     _props$enableQuerySch = props.enableQuerySchemes,
-    enableQuerySchemes = _props$enableQuerySch === void 0 ? false : _props$enableQuerySch,
+    enableQuerySchemes = _props$enableQuerySch === void 0 ? true : _props$enableQuerySch,
     querySchemeStorageAdapter = props.querySchemeStorageAdapter,
+    propsQuerySchemeManager = props.querySchemeManager,
     _props$enableColumnSc = props.enableColumnSchemes,
     enableColumnSchemes = _props$enableColumnSc === void 0 ? true : _props$enableColumnSc,
     columnSchemeStorageAdapter = props.columnSchemeStorageAdapter,
+    propsColumnSchemeManager = props.columnSchemeManager,
     rest = _objectWithoutProperties(props, _excluded);
   var _useGridPlusColumnSta = (0, _.useGridPlusColumnState)(),
     onSaveColumnState = _useGridPlusColumnSta.onSaveColumnState,
@@ -139,10 +142,15 @@ function AgGridPlus(props) {
     queryItemsOrder = _useState20[0],
     setQueryItemsOrder = _useState20[1];
 
-  // 初始化查询方案管理器
-  var querySchemeManager = enableQuerySchemes && gridKey ? (0, _querySchemes.useQuerySchemes)({
+  // 尝试获取全局适配器（如果已初始化）
+  var globalQueryAdapter = (0, _globalSyncManager.isGlobalSyncInitialized)() ? (0, _globalSyncManager.useGlobalQueryAdapter)() : undefined;
+  var globalColumnAdapter = (0, _globalSyncManager.isGlobalSyncInitialized)() ? (0, _globalSyncManager.useGlobalColumnAdapter)() : undefined;
+
+  // 自动创建查询方案管理器（如果未通过 props 提供）
+  var autoQuerySchemeManager = enableQuerySchemes && gridKey && !propsQuerySchemeManager ? (0, _querySchemes.useQuerySchemes)({
     gridId: gridKey,
-    storageAdapter: querySchemeStorageAdapter,
+    // 优先使用全局适配器，否则使用 props 传入的适配器
+    storageAdapter: globalQueryAdapter || querySchemeStorageAdapter,
     onSchemeChange: function onSchemeChange(scheme) {
       if (scheme) {
         setQueryItemsOrder(scheme.itemsOrder);
@@ -150,11 +158,15 @@ function AgGridPlus(props) {
     }
   }) : undefined;
 
+  // 优先使用 props 提供的管理器，否则使用自动创建的
+  var querySchemeManager = propsQuerySchemeManager || autoQuerySchemeManager;
+
   // ============ 列配置方案管理 ============
-  // 初始化列配置方案管理器
-  var columnSchemeManager = enableColumnSchemes && gridKey ? (0, _schemes.useColumnSchemes)({
+  // 自动创建列配置方案管理器（如果未通过 props 提供）
+  var autoColumnSchemeManager = enableColumnSchemes && gridKey && !propsColumnSchemeManager ? (0, _schemes.useColumnSchemes)({
     gridId: gridKey,
-    storageAdapter: columnSchemeStorageAdapter,
+    // 优先使用全局适配器，否则使用 props 传入的适配器
+    storageAdapter: globalColumnAdapter || columnSchemeStorageAdapter,
     enableAutoSave: true,
     onSchemeChange: function onSchemeChange(scheme) {
       if (scheme && apiRef.current) {
@@ -165,6 +177,9 @@ function AgGridPlus(props) {
       }
     }
   }) : undefined;
+
+  // 优先使用 props 提供的管理器，否则使用自动创建的
+  var columnSchemeManager = propsColumnSchemeManager || autoColumnSchemeManager;
   (0, _react.useImperativeHandle)(propsGridRef, function () {
     return gridRef.current;
   });

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

@@ -8,3 +8,5 @@ export { dateValueFormatter, dateTimeValueFormatter, convertFilterModel, convert
 export { useColumnSchemes, LocalStorageAdapter, defaultStorageAdapter, validateScheme, validateSchemeName, validateSchemeDescription, checkDuplicateName, generateUniqueName, STORAGE_PREFIX, DEFAULT_SCHEME_NAME, MAX_SCHEMES_PER_GRID, MAX_SCHEME_NAME_LENGTH, SchemeSelector, SchemeManager } from "./schemes";
 export type { ColumnScheme, SchemeManagerConfig, StorageAdapter, SchemeValidationResult, UseColumnSchemesReturn, SchemeSelectorProps, SchemeManagerProps } from "./schemes";
 export type { GridPlusContextValue } from "./context/gridContext";
+export { initializeGlobalSchemeSync, getGlobalSyncManager, getGlobalAdapterFactory, isGlobalSyncInitialized, destroyGlobalSchemeSync, syncAllSchemes, getGlobalSyncStatus, hasUnsyncedData, getUnsyncedGrids, useGlobalColumnAdapter, useGlobalQueryAdapter, useGlobalColumnSchemeManager, useGlobalQuerySchemeManager } from "./storage";
+export type { SyncConfig, SyncManagerEvents, SyncStatus, SchemeConflict } from "./storage";

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

@@ -99,6 +99,12 @@ Object.defineProperty(exports, "defaultStorageAdapter", {
     return _schemes.defaultStorageAdapter;
   }
 });
+Object.defineProperty(exports, "destroyGlobalSchemeSync", {
+  enumerable: true,
+  get: function get() {
+    return _storage.destroyGlobalSchemeSync;
+  }
+});
 Object.defineProperty(exports, "flatten", {
   enumerable: true,
   get: function get() {
@@ -117,6 +123,54 @@ Object.defineProperty(exports, "generateUniqueName", {
     return _schemes.generateUniqueName;
   }
 });
+Object.defineProperty(exports, "getGlobalAdapterFactory", {
+  enumerable: true,
+  get: function get() {
+    return _storage.getGlobalAdapterFactory;
+  }
+});
+Object.defineProperty(exports, "getGlobalSyncManager", {
+  enumerable: true,
+  get: function get() {
+    return _storage.getGlobalSyncManager;
+  }
+});
+Object.defineProperty(exports, "getGlobalSyncStatus", {
+  enumerable: true,
+  get: function get() {
+    return _storage.getGlobalSyncStatus;
+  }
+});
+Object.defineProperty(exports, "getUnsyncedGrids", {
+  enumerable: true,
+  get: function get() {
+    return _storage.getUnsyncedGrids;
+  }
+});
+Object.defineProperty(exports, "hasUnsyncedData", {
+  enumerable: true,
+  get: function get() {
+    return _storage.hasUnsyncedData;
+  }
+});
+Object.defineProperty(exports, "initializeGlobalSchemeSync", {
+  enumerable: true,
+  get: function get() {
+    return _storage.initializeGlobalSchemeSync;
+  }
+});
+Object.defineProperty(exports, "isGlobalSyncInitialized", {
+  enumerable: true,
+  get: function get() {
+    return _storage.isGlobalSyncInitialized;
+  }
+});
+Object.defineProperty(exports, "syncAllSchemes", {
+  enumerable: true,
+  get: function get() {
+    return _storage.syncAllSchemes;
+  }
+});
 Object.defineProperty(exports, "toTree", {
   enumerable: true,
   get: function get() {
@@ -129,6 +183,30 @@ Object.defineProperty(exports, "useColumnSchemes", {
     return _schemes.useColumnSchemes;
   }
 });
+Object.defineProperty(exports, "useGlobalColumnAdapter", {
+  enumerable: true,
+  get: function get() {
+    return _storage.useGlobalColumnAdapter;
+  }
+});
+Object.defineProperty(exports, "useGlobalColumnSchemeManager", {
+  enumerable: true,
+  get: function get() {
+    return _storage.useGlobalColumnSchemeManager;
+  }
+});
+Object.defineProperty(exports, "useGlobalQueryAdapter", {
+  enumerable: true,
+  get: function get() {
+    return _storage.useGlobalQueryAdapter;
+  }
+});
+Object.defineProperty(exports, "useGlobalQuerySchemeManager", {
+  enumerable: true,
+  get: function get() {
+    return _storage.useGlobalQuerySchemeManager;
+  }
+});
 Object.defineProperty(exports, "useGridPlusColumnState", {
   enumerable: true,
   get: function get() {
@@ -160,4 +238,5 @@ var _useGridPlusColumnState = require("./hooks/useGridPlusColumnState");
 require("./ag-grid-theme-builder.css");
 var _utils = require("./utils");
 var _schemes = require("./schemes");
+var _storage = require("./storage");
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }

package/dist/cjs/ag-grid-plus/interface.d.ts

@@ -65,6 +65,11 @@ interface GridProps extends AgGridReactProps {
      * 默认使用 LocalStorage，可传入自定义适配器实现服务端存储
      */
     querySchemeStorageAdapter?: QueryStorageAdapter;
+    /**
+     * 查询方案管理器（可选）
+     * 如果不提供，组件会根据 gridKey 自动从全局方案管理器创建
+     */
+    querySchemeManager?: any;
     /**
      * 是否启用列配置方案功能
      * 默认值: true (自动启用)
@@ -75,6 +80,11 @@ interface GridProps extends AgGridReactProps {
      * 默认使用 LocalStorage，可传入自定义适配器实现服务端存储
      */
     columnSchemeStorageAdapter?: ColumnStorageAdapter;
+    /**
+     * 列配置方案管理器（可选）
+     * 如果不提供，组件会根据 gridKey 自动从全局方案管理器创建
+     */
+    columnSchemeManager?: any;
     /**
      * 错误处理回调函数
      * 当组件发生错误时调用，可用于自定义错误处理逻辑

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

@@ -19,6 +19,16 @@ export declare class SchemeSyncManager {
     private autoSaveTimer?;
     private backgroundSyncTimer?;
     constructor(config: SyncConfig, events?: SyncManagerEvents);
+    /**
+     * 获取方案的完整 API URL (GET请求)
+     * @private
+     */
+    private getGetApiUrl;
+    /**
+     * 同步方案的完整 API URL (PUT请求)
+     * @private
+     */
+    private getSyncApiUrl;
     /**
      * 初始化：从服务器加载所有数据
      */

package/dist/cjs/ag-grid-plus/storage/SchemeSyncManager.js

@@ -25,6 +25,8 @@ function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e
  * 默认配置
  */
 var DEFAULT_CONFIG = {
+  getApiPath: '/api/v1/ag-grid-plus/schemes',
+  syncApiPath: '/api/v1/ag-grid-plus/schemes',
   autoSaveDelay: 3000,
   backgroundSyncInterval: 300000,
   // 5分钟
@@ -72,7 +74,7 @@ var SchemeSyncManager = exports.SchemeSyncManager = /*#__PURE__*/function () {
           type: 'application/json'
         });
         if (navigator.sendBeacon) {
-          navigator.sendBeacon("".concat(_this.config.apiBaseUrl, "/api/v1/ag-grid-plus/schemes"), blob);
+          navigator.sendBeacon(_this.getSyncApiUrl(), blob);
         }
       }
     });
@@ -95,9 +97,29 @@ var SchemeSyncManager = exports.SchemeSyncManager = /*#__PURE__*/function () {
   }
 
   /**
-   * 初始化：从服务器加载所有数据
+   * 获取方案的完整 API URL (GET请求)
+   * @private
    */
   _createClass(SchemeSyncManager, [{
+    key: "getGetApiUrl",
+    value: function getGetApiUrl() {
+      return "".concat(this.config.apiBaseUrl).concat(this.config.getApiPath);
+    }
+
+    /**
+     * 同步方案的完整 API URL (PUT请求)
+     * @private
+     */
+  }, {
+    key: "getSyncApiUrl",
+    value: function getSyncApiUrl() {
+      return "".concat(this.config.apiBaseUrl).concat(this.config.syncApiPath);
+    }
+
+    /**
+     * 初始化：从服务器加载所有数据
+     */
+  }, {
     key: "initialize",
     value: (function () {
       var _initialize = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee() {
@@ -114,7 +136,7 @@ var SchemeSyncManager = exports.SchemeSyncManager = /*#__PURE__*/function () {
             case 3:
               _context.prev = 3;
               _context.next = 6;
-              return this.fetchWithRetry("".concat(this.config.apiBaseUrl, "/api/v1/ag-grid-plus/schemes"), {
+              return this.fetchWithRetry(this.getGetApiUrl(), {
                 method: 'GET',
                 headers: {
                   'Content-Type': 'application/json'
@@ -394,7 +416,7 @@ var SchemeSyncManager = exports.SchemeSyncManager = /*#__PURE__*/function () {
 
               // 发送同步请求
               _context2.next = 19;
-              return this.fetchWithRetry("".concat(this.config.apiBaseUrl, "/api/v1/ag-grid-plus/schemes"), {
+              return this.fetchWithRetry(this.getSyncApiUrl(), {
                 method: 'PUT',
                 headers: {
                   'Content-Type': 'application/json'

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

@@ -72,3 +72,29 @@ export declare function useGlobalColumnAdapter(): import("./MemoryStorageAdapter
  * 简化组件中的使用
  */
 export declare function useGlobalQueryAdapter(): import("./MemoryStorageAdapter").QueryMemoryStorageAdapter;
+/**
+ * React Hook: 使用全局列方案管理器
+ * 自动创建并管理指定 gridId 的列方案管理器
+ *
+ * @param gridId 表格唯一标识
+ * @param options 可选配置
+ * @returns 列方案管理器实例
+ */
+export declare function useGlobalColumnSchemeManager(gridId: string, options?: {
+    enableAutoSave?: boolean;
+    onSchemeChange?: (scheme: any) => void;
+    onSchemeSave?: (scheme: any) => void;
+}): any;
+/**
+ * React Hook: 使用全局查询方案管理器
+ * 自动创建并管理指定 gridId 的查询方案管理器
+ *
+ * @param gridId 表格唯一标识
+ * @param options 可选配置
+ * @returns 查询方案管理器实例
+ */
+export declare function useGlobalQuerySchemeManager(gridId: string, options?: {
+    enableAutoSave?: boolean;
+    onSchemeChange?: (scheme: any) => void;
+    onSchemeSave?: (scheme: any) => void;
+}): any;

package/dist/cjs/ag-grid-plus/storage/globalSyncManager.js

@@ -13,7 +13,9 @@ exports.initializeGlobalSchemeSync = initializeGlobalSchemeSync;
 exports.isGlobalSyncInitialized = isGlobalSyncInitialized;
 exports.syncAllSchemes = syncAllSchemes;
 exports.useGlobalColumnAdapter = useGlobalColumnAdapter;
+exports.useGlobalColumnSchemeManager = useGlobalColumnSchemeManager;
 exports.useGlobalQueryAdapter = useGlobalQueryAdapter;
+exports.useGlobalQuerySchemeManager = useGlobalQuerySchemeManager;
 var _SchemeSyncManager = require("./SchemeSyncManager");
 var _MemoryStorageAdapter = require("./MemoryStorageAdapter");
 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); }
@@ -284,4 +286,50 @@ function useGlobalColumnAdapter() {
 function useGlobalQueryAdapter() {
   var factory = getGlobalAdapterFactory();
   return factory.getQueryAdapter();
+}
+
+/**
+ * React Hook: 使用全局列方案管理器
+ * 自动创建并管理指定 gridId 的列方案管理器
+ *
+ * @param gridId 表格唯一标识
+ * @param options 可选配置
+ * @returns 列方案管理器实例
+ */
+function useGlobalColumnSchemeManager(gridId, options) {
+  var _options$enableAutoSa;
+  // 动态导入 useSchemeManager Hook
+  var _require = require("../shared/hooks/useSchemeManager"),
+    useSchemeManager = _require.useSchemeManager;
+  var columnAdapter = useGlobalColumnAdapter();
+  return useSchemeManager({
+    gridId: gridId,
+    storageAdapter: columnAdapter,
+    enableAutoSave: (_options$enableAutoSa = options === null || options === void 0 ? void 0 : options.enableAutoSave) !== null && _options$enableAutoSa !== void 0 ? _options$enableAutoSa : true,
+    onSchemeChange: options === null || options === void 0 ? void 0 : options.onSchemeChange,
+    onSchemeSave: options === null || options === void 0 ? void 0 : options.onSchemeSave
+  });
+}
+
+/**
+ * React Hook: 使用全局查询方案管理器
+ * 自动创建并管理指定 gridId 的查询方案管理器
+ *
+ * @param gridId 表格唯一标识
+ * @param options 可选配置
+ * @returns 查询方案管理器实例
+ */
+function useGlobalQuerySchemeManager(gridId, options) {
+  var _options$enableAutoSa2;
+  // 动态导入 useSchemeManager Hook
+  var _require2 = require("../shared/hooks/useSchemeManager"),
+    useSchemeManager = _require2.useSchemeManager;
+  var queryAdapter = useGlobalQueryAdapter();
+  return useSchemeManager({
+    gridId: gridId,
+    storageAdapter: queryAdapter,
+    enableAutoSave: (_options$enableAutoSa2 = options === null || options === void 0 ? void 0 : options.enableAutoSave) !== null && _options$enableAutoSa2 !== void 0 ? _options$enableAutoSa2 : true,
+    onSchemeChange: options === null || options === void 0 ? void 0 : options.onSchemeChange,
+    onSchemeSave: options === null || options === void 0 ? void 0 : options.onSchemeSave
+  });
 }

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

@@ -71,6 +71,25 @@ export interface ConflictData {
     /** 冲突原因 */
     reason: string;
 }
+/**
+ * 方案冲突（别名）
+ */
+export type SchemeConflict = ConflictData;
+/**
+ * 同步状态信息
+ */
+export interface SyncStatus {
+    /** 是否已初始化 */
+    initialized: boolean;
+    /** 是否正在同步 */
+    syncing: boolean;
+    /** 最后同步时间 */
+    lastSyncTime: number;
+    /** 是否有未同步数据 */
+    hasDirtyData: boolean;
+    /** 有未同步数据的表格ID列表 */
+    dirtyGrids: string[];
+}
 /**
  * 脏数据标记类型
  */
@@ -81,6 +100,18 @@ export type DirtyType = 'column' | 'query' | 'current';
 export interface SyncConfig {
     /** API 基础路径 */
     apiBaseUrl: string;
+    /**
+     * 获取方案API路径（可选）
+     * 默认值: '/api/v1/ag-grid-plus/schemes'
+     * 用于GET请求，获取所有方案数据
+     */
+    getApiPath?: string;
+    /**
+     * 同步方案API路径（可选）
+     * 默认值: '/api/v1/ag-grid-plus/schemes'
+     * 用于PUT请求，同步保存方案数据
+     */
+    syncApiPath?: string;
     /** 自动保存延迟（毫秒），默认 3000 */
     autoSaveDelay?: number;
     /** 后台同步间隔（毫秒），默认 300000 (5分钟) */

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

@@ -1,7 +1,7 @@
 import _sumBy from "lodash/sumBy";
 import _uniqueId from "lodash/uniqueId";
 import _isArray from "lodash/isArray";
-var _excluded = ["style", "loading", "params", "request", "dataSource", "treeKeyName", "treeParentName", "rowData", "gridRef", "headerTitle", "toolBarRender", "search", "hideTool", "onGridReady", "gridKey", "children", "defaultSearchExpand", "overlayNoRowsTemplateText", "queryDefaultRows", "onSelectedRowsChange", "enableQuerySchemes", "querySchemeStorageAdapter", "enableColumnSchemes", "columnSchemeStorageAdapter"];
+var _excluded = ["style", "loading", "params", "request", "dataSource", "treeKeyName", "treeParentName", "rowData", "gridRef", "headerTitle", "toolBarRender", "search", "hideTool", "onGridReady", "gridKey", "children", "defaultSearchExpand", "overlayNoRowsTemplateText", "queryDefaultRows", "onSelectedRowsChange", "enableQuerySchemes", "querySchemeStorageAdapter", "querySchemeManager", "enableColumnSchemes", "columnSchemeStorageAdapter", "columnSchemeManager"];
 function _extends() { _extends = Object.assign ? Object.assign.bind() : function (target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i]; for (var key in source) { if (Object.prototype.hasOwnProperty.call(source, key)) { target[key] = source[key]; } } } return target; }; return _extends.apply(this, arguments); }
 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; }
@@ -37,6 +37,7 @@ import { localeText } from "./locale";
 import { GridPlusContext } from "./context/gridContext";
 import { useQuerySchemes, useQueryOrderManager } from "./querySchemes";
 import { useColumnSchemes } from "./schemes";
+import { useGlobalColumnAdapter, useGlobalQueryAdapter, isGlobalSyncInitialized } from "./storage/globalSyncManager";
 import { createSafeHtmlTemplate } from "./utils/sanitize";
 import { GridPlusError, ErrorType, ErrorSeverity } from "./errors";
 import { logger } from "./utils/logger";
@@ -68,11 +69,13 @@ function AgGridPlus(props) {
     queryDefaultRows = props.queryDefaultRows,
     onSelectedRowsChange = props.onSelectedRowsChange,
     _props$enableQuerySch = props.enableQuerySchemes,
-    enableQuerySchemes = _props$enableQuerySch === void 0 ? false : _props$enableQuerySch,
+    enableQuerySchemes = _props$enableQuerySch === void 0 ? true : _props$enableQuerySch,
     querySchemeStorageAdapter = props.querySchemeStorageAdapter,
+    propsQuerySchemeManager = props.querySchemeManager,
     _props$enableColumnSc = props.enableColumnSchemes,
     enableColumnSchemes = _props$enableColumnSc === void 0 ? true : _props$enableColumnSc,
     columnSchemeStorageAdapter = props.columnSchemeStorageAdapter,
+    propsColumnSchemeManager = props.columnSchemeManager,
     rest = _objectWithoutProperties(props, _excluded);
   var _useGridPlusColumnSta = useGridPlusColumnState(),
     onSaveColumnState = _useGridPlusColumnSta.onSaveColumnState,
@@ -131,10 +134,15 @@ function AgGridPlus(props) {
     queryItemsOrder = _useState20[0],
     setQueryItemsOrder = _useState20[1];
 
-  // 初始化查询方案管理器
-  var querySchemeManager = enableQuerySchemes && gridKey ? useQuerySchemes({
+  // 尝试获取全局适配器（如果已初始化）
+  var globalQueryAdapter = isGlobalSyncInitialized() ? useGlobalQueryAdapter() : undefined;
+  var globalColumnAdapter = isGlobalSyncInitialized() ? useGlobalColumnAdapter() : undefined;
+
+  // 自动创建查询方案管理器（如果未通过 props 提供）
+  var autoQuerySchemeManager = enableQuerySchemes && gridKey && !propsQuerySchemeManager ? useQuerySchemes({
     gridId: gridKey,
-    storageAdapter: querySchemeStorageAdapter,
+    // 优先使用全局适配器，否则使用 props 传入的适配器
+    storageAdapter: globalQueryAdapter || querySchemeStorageAdapter,
     onSchemeChange: function onSchemeChange(scheme) {
       if (scheme) {
         setQueryItemsOrder(scheme.itemsOrder);
@@ -142,11 +150,15 @@ function AgGridPlus(props) {
     }
   }) : undefined;
 
+  // 优先使用 props 提供的管理器，否则使用自动创建的
+  var querySchemeManager = propsQuerySchemeManager || autoQuerySchemeManager;
+
   // ============ 列配置方案管理 ============
-  // 初始化列配置方案管理器
-  var columnSchemeManager = enableColumnSchemes && gridKey ? useColumnSchemes({
+  // 自动创建列配置方案管理器（如果未通过 props 提供）
+  var autoColumnSchemeManager = enableColumnSchemes && gridKey && !propsColumnSchemeManager ? useColumnSchemes({
     gridId: gridKey,
-    storageAdapter: columnSchemeStorageAdapter,
+    // 优先使用全局适配器，否则使用 props 传入的适配器
+    storageAdapter: globalColumnAdapter || columnSchemeStorageAdapter,
     enableAutoSave: true,
     onSchemeChange: function onSchemeChange(scheme) {
       if (scheme && apiRef.current) {
@@ -157,6 +169,9 @@ function AgGridPlus(props) {
       }
     }
   }) : undefined;
+
+  // 优先使用 props 提供的管理器，否则使用自动创建的
+  var columnSchemeManager = propsColumnSchemeManager || autoColumnSchemeManager;
   useImperativeHandle(propsGridRef, function () {
     return gridRef.current;
   });

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

@@ -8,3 +8,5 @@ export { dateValueFormatter, dateTimeValueFormatter, convertFilterModel, convert
 export { useColumnSchemes, LocalStorageAdapter, defaultStorageAdapter, validateScheme, validateSchemeName, validateSchemeDescription, checkDuplicateName, generateUniqueName, STORAGE_PREFIX, DEFAULT_SCHEME_NAME, MAX_SCHEMES_PER_GRID, MAX_SCHEME_NAME_LENGTH, SchemeSelector, SchemeManager } from "./schemes";
 export type { ColumnScheme, SchemeManagerConfig, StorageAdapter, SchemeValidationResult, UseColumnSchemesReturn, SchemeSelectorProps, SchemeManagerProps } from "./schemes";
 export type { GridPlusContextValue } from "./context/gridContext";
+export { initializeGlobalSchemeSync, getGlobalSyncManager, getGlobalAdapterFactory, isGlobalSyncInitialized, destroyGlobalSchemeSync, syncAllSchemes, getGlobalSyncStatus, hasUnsyncedData, getUnsyncedGrids, useGlobalColumnAdapter, useGlobalQueryAdapter, useGlobalColumnSchemeManager, useGlobalQuerySchemeManager } from "./storage";
+export type { SyncConfig, SyncManagerEvents, SyncStatus, SchemeConflict } from "./storage";

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

@@ -7,4 +7,6 @@ export { AgGridPlus, AgGridColumn, GridPlusContext, useGridPlusColumnState };
 export { dateValueFormatter, dateTimeValueFormatter, convertFilterModel, convertSortModel, flattenTreeDeep, toTree, flatten } from "./utils";
 
 // 导出列配置方案管理功能
-export { useColumnSchemes, LocalStorageAdapter, defaultStorageAdapter, validateScheme, validateSchemeName, validateSchemeDescription, checkDuplicateName, generateUniqueName, STORAGE_PREFIX, DEFAULT_SCHEME_NAME, MAX_SCHEMES_PER_GRID, MAX_SCHEME_NAME_LENGTH, SchemeSelector, SchemeManager } from "./schemes";
+export { useColumnSchemes, LocalStorageAdapter, defaultStorageAdapter, validateScheme, validateSchemeName, validateSchemeDescription, checkDuplicateName, generateUniqueName, STORAGE_PREFIX, DEFAULT_SCHEME_NAME, MAX_SCHEMES_PER_GRID, MAX_SCHEME_NAME_LENGTH, SchemeSelector, SchemeManager } from "./schemes";
+// 导出全局方案同步管理功能
+export { initializeGlobalSchemeSync, getGlobalSyncManager, getGlobalAdapterFactory, isGlobalSyncInitialized, destroyGlobalSchemeSync, syncAllSchemes, getGlobalSyncStatus, hasUnsyncedData, getUnsyncedGrids, useGlobalColumnAdapter, useGlobalQueryAdapter, useGlobalColumnSchemeManager, useGlobalQuerySchemeManager } from "./storage";

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

@@ -65,6 +65,11 @@ interface GridProps extends AgGridReactProps {
      * 默认使用 LocalStorage，可传入自定义适配器实现服务端存储
      */
     querySchemeStorageAdapter?: QueryStorageAdapter;
+    /**
+     * 查询方案管理器（可选）
+     * 如果不提供，组件会根据 gridKey 自动从全局方案管理器创建
+     */
+    querySchemeManager?: any;
     /**
      * 是否启用列配置方案功能
      * 默认值: true (自动启用)
@@ -75,6 +80,11 @@ interface GridProps extends AgGridReactProps {
      * 默认使用 LocalStorage，可传入自定义适配器实现服务端存储
      */
     columnSchemeStorageAdapter?: ColumnStorageAdapter;
+    /**
+     * 列配置方案管理器（可选）
+     * 如果不提供，组件会根据 gridKey 自动从全局方案管理器创建
+     */
+    columnSchemeManager?: any;
     /**
      * 错误处理回调函数
      * 当组件发生错误时调用，可用于自定义错误处理逻辑

package/dist/esm/ag-grid-plus/storage/SchemeSyncManager.d.ts

@@ -19,6 +19,16 @@ export declare class SchemeSyncManager {
     private autoSaveTimer?;
     private backgroundSyncTimer?;
     constructor(config: SyncConfig, events?: SyncManagerEvents);
+    /**
+     * 获取方案的完整 API URL (GET请求)
+     * @private
+     */
+    private getGetApiUrl;
+    /**
+     * 同步方案的完整 API URL (PUT请求)
+     * @private
+     */
+    private getSyncApiUrl;
     /**
      * 初始化：从服务器加载所有数据
      */

package/dist/esm/ag-grid-plus/storage/SchemeSyncManager.js

@@ -19,6 +19,8 @@ function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e
  * 默认配置
  */
 var DEFAULT_CONFIG = {
+  getApiPath: '/api/v1/ag-grid-plus/schemes',
+  syncApiPath: '/api/v1/ag-grid-plus/schemes',
   autoSaveDelay: 3000,
   backgroundSyncInterval: 300000,
   // 5分钟
@@ -66,7 +68,7 @@ export var SchemeSyncManager = /*#__PURE__*/function () {
           type: 'application/json'
         });
         if (navigator.sendBeacon) {
-          navigator.sendBeacon("".concat(_this.config.apiBaseUrl, "/api/v1/ag-grid-plus/schemes"), blob);
+          navigator.sendBeacon(_this.getSyncApiUrl(), blob);
         }
       }
     });
@@ -89,9 +91,29 @@ export var SchemeSyncManager = /*#__PURE__*/function () {
   }
 
   /**
-   * 初始化：从服务器加载所有数据
+   * 获取方案的完整 API URL (GET请求)
+   * @private
    */
   _createClass(SchemeSyncManager, [{
+    key: "getGetApiUrl",
+    value: function getGetApiUrl() {
+      return "".concat(this.config.apiBaseUrl).concat(this.config.getApiPath);
+    }
+
+    /**
+     * 同步方案的完整 API URL (PUT请求)
+     * @private
+     */
+  }, {
+    key: "getSyncApiUrl",
+    value: function getSyncApiUrl() {
+      return "".concat(this.config.apiBaseUrl).concat(this.config.syncApiPath);
+    }
+
+    /**
+     * 初始化：从服务器加载所有数据
+     */
+  }, {
     key: "initialize",
     value: (function () {
       var _initialize = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee() {
@@ -108,7 +130,7 @@ export var SchemeSyncManager = /*#__PURE__*/function () {
             case 3:
               _context.prev = 3;
               _context.next = 6;
-              return this.fetchWithRetry("".concat(this.config.apiBaseUrl, "/api/v1/ag-grid-plus/schemes"), {
+              return this.fetchWithRetry(this.getGetApiUrl(), {
                 method: 'GET',
                 headers: {
                   'Content-Type': 'application/json'
@@ -388,7 +410,7 @@ export var SchemeSyncManager = /*#__PURE__*/function () {
 
               // 发送同步请求
               _context2.next = 19;
-              return this.fetchWithRetry("".concat(this.config.apiBaseUrl, "/api/v1/ag-grid-plus/schemes"), {
+              return this.fetchWithRetry(this.getSyncApiUrl(), {
                 method: 'PUT',
                 headers: {
                   'Content-Type': 'application/json'