@nokecy/qc-ui 1.0.71 → 1.0.73

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'

package/dist/esm/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/esm/ag-grid-plus/storage/globalSyncManager.js

@@ -272,4 +272,50 @@ export function useGlobalColumnAdapter() {
 export function useGlobalQueryAdapter() {
   var factory = getGlobalAdapterFactory();
   return factory.getQueryAdapter();
+}
+
+/**
+ * React Hook: 使用全局列方案管理器
+ * 自动创建并管理指定 gridId 的列方案管理器
+ *
+ * @param gridId 表格唯一标识
+ * @param options 可选配置
+ * @returns 列方案管理器实例
+ */
+export 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 查询方案管理器实例
+ */
+export 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/esm/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/index.d.ts

@@ -1,4 +1,4 @@
-import { AgGridColumn, AgGridPlus, flattenTreeDeep, GridPlusContext, useGridPlusColumnState, useColumnSchemes, SchemeSelector, SchemeManager, LocalStorageAdapter, defaultStorageAdapter, validateScheme, validateSchemeName, validateSchemeDescription, checkDuplicateName, generateUniqueName, STORAGE_PREFIX, DEFAULT_SCHEME_NAME, MAX_SCHEMES_PER_GRID, MAX_SCHEME_NAME_LENGTH } from "./ag-grid-plus";
+import { AgGridColumn, AgGridPlus, flattenTreeDeep, GridPlusContext, useGridPlusColumnState, useColumnSchemes, SchemeSelector, SchemeManager, LocalStorageAdapter, defaultStorageAdapter, validateScheme, validateSchemeName, validateSchemeDescription, checkDuplicateName, generateUniqueName, STORAGE_PREFIX, DEFAULT_SCHEME_NAME, MAX_SCHEMES_PER_GRID, MAX_SCHEME_NAME_LENGTH, initializeGlobalSchemeSync, getGlobalSyncManager, getGlobalAdapterFactory, isGlobalSyncInitialized, destroyGlobalSchemeSync, syncAllSchemes, getGlobalSyncStatus, hasUnsyncedData, getUnsyncedGrids, useGlobalColumnAdapter, useGlobalQueryAdapter, useGlobalColumnSchemeManager, useGlobalQuerySchemeManager } from "./ag-grid-plus";
 import ArrayTable from "./array-table";
 import ArrayTableIndex from "./array-table-index";
 import { ColumnPresets } from "./array-table/columnHelper";
@@ -21,7 +21,7 @@ import { StandardFormDialog, withStandardForm, FieldCreators, createSelectField,
 import DeleteConfirm from "./deleteConfirm";
 import { RuleBuilder } from "./RuleBuilder";
 import { RegexEditor, useRegexValidation, useTemplateManager, TemplateSelector, TemplateCategory, RegexTester, FlagsSelector, MatchItem, RegexRailroadDiagram } from "./components/RegexEditor";
-export { AgGridColumn, AgGridPlus, ArrayTable, ArrayTableIndex, ColumnPresets, Card, Dashboard, DialogSelect, DraggableModal, Editable, ExtensibleGrid, flattenTreeDeep, FormDesigner, FormProContext, FormProLayout, GridPlusContext, useGridPlusColumnState, ImportModal, QueryBuilder, ToolBar, FullScreenAlert, ConfirmPro, GeneratedListPage, StandardFormDialog, withStandardForm, FieldCreators, createSelectField, createCascaderField, DeleteConfirm, RuleBuilder, RegexEditor, useRegexValidation, useTemplateManager, TemplateSelector, TemplateCategory, RegexTester, FlagsSelector, MatchItem, RegexRailroadDiagram, useColumnSchemes, SchemeSelector, SchemeManager, LocalStorageAdapter, defaultStorageAdapter, validateScheme, validateSchemeName, validateSchemeDescription, checkDuplicateName, generateUniqueName, STORAGE_PREFIX, DEFAULT_SCHEME_NAME, MAX_SCHEMES_PER_GRID, MAX_SCHEME_NAME_LENGTH, };
+export { AgGridColumn, AgGridPlus, ArrayTable, ArrayTableIndex, ColumnPresets, Card, Dashboard, DialogSelect, DraggableModal, Editable, ExtensibleGrid, flattenTreeDeep, FormDesigner, FormProContext, FormProLayout, GridPlusContext, useGridPlusColumnState, ImportModal, QueryBuilder, ToolBar, FullScreenAlert, ConfirmPro, GeneratedListPage, StandardFormDialog, withStandardForm, FieldCreators, createSelectField, createCascaderField, DeleteConfirm, RuleBuilder, RegexEditor, useRegexValidation, useTemplateManager, TemplateSelector, TemplateCategory, RegexTester, FlagsSelector, MatchItem, RegexRailroadDiagram, useColumnSchemes, SchemeSelector, SchemeManager, LocalStorageAdapter, defaultStorageAdapter, validateScheme, validateSchemeName, validateSchemeDescription, checkDuplicateName, generateUniqueName, STORAGE_PREFIX, DEFAULT_SCHEME_NAME, MAX_SCHEMES_PER_GRID, MAX_SCHEME_NAME_LENGTH, initializeGlobalSchemeSync, getGlobalSyncManager, getGlobalAdapterFactory, isGlobalSyncInitialized, destroyGlobalSchemeSync, syncAllSchemes, getGlobalSyncStatus, hasUnsyncedData, getUnsyncedGrids, useGlobalColumnAdapter, useGlobalQueryAdapter, useGlobalColumnSchemeManager, useGlobalQuerySchemeManager, };
 export type * from "./generatedListPage";
 export type * from "./standardFormDialog";
 export type * from "./deleteConfirm";
@@ -30,4 +30,5 @@ export type * from "./fullScreenAlert";
 export type * from "./RuleBuilder";
 export type { ColumnConfig } from "./array-table/columnHelper";
 export type { ColumnScheme, SchemeManagerConfig, StorageAdapter, SchemeValidationResult, UseColumnSchemesReturn, SchemeSelectorProps, SchemeManagerProps, GridPlusContextValue, } from "./ag-grid-plus";
+export type { SyncConfig, SyncManagerEvents, SyncStatus, SchemeConflict, } 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/index.js

@@ -1,6 +1,8 @@
 import { AgGridColumn, AgGridPlus, flattenTreeDeep, GridPlusContext, useGridPlusColumnState,
 // 列配置方案管理
-useColumnSchemes, SchemeSelector, SchemeManager, LocalStorageAdapter, defaultStorageAdapter, validateScheme, validateSchemeName, validateSchemeDescription, checkDuplicateName, generateUniqueName, STORAGE_PREFIX, DEFAULT_SCHEME_NAME, MAX_SCHEMES_PER_GRID, MAX_SCHEME_NAME_LENGTH } from "./ag-grid-plus";
+useColumnSchemes, SchemeSelector, SchemeManager, LocalStorageAdapter, defaultStorageAdapter, validateScheme, validateSchemeName, validateSchemeDescription, checkDuplicateName, generateUniqueName, STORAGE_PREFIX, DEFAULT_SCHEME_NAME, MAX_SCHEMES_PER_GRID, MAX_SCHEME_NAME_LENGTH,
+// 全局方案同步管理
+initializeGlobalSchemeSync, getGlobalSyncManager, getGlobalAdapterFactory, isGlobalSyncInitialized, destroyGlobalSchemeSync, syncAllSchemes, getGlobalSyncStatus, hasUnsyncedData, getUnsyncedGrids, useGlobalColumnAdapter, useGlobalQueryAdapter, useGlobalColumnSchemeManager, useGlobalQuerySchemeManager } from "./ag-grid-plus";
 import ArrayTable from "./array-table";
 import ArrayTableIndex from "./array-table-index";
 import { ColumnPresets } from "./array-table/columnHelper";
@@ -25,10 +27,14 @@ import { RuleBuilder } from "./RuleBuilder";
 import { RegexEditor, useRegexValidation, useTemplateManager, TemplateSelector, TemplateCategory, RegexTester, FlagsSelector, MatchItem, RegexRailroadDiagram } from "./components/RegexEditor";
 export { AgGridColumn, AgGridPlus, ArrayTable, ArrayTableIndex, ColumnPresets, Card, Dashboard, DialogSelect, DraggableModal, Editable, ExtensibleGrid, flattenTreeDeep, FormDesigner, FormProContext, FormProLayout, GridPlusContext, useGridPlusColumnState, ImportModal, QueryBuilder, ToolBar, FullScreenAlert, ConfirmPro, GeneratedListPage, StandardFormDialog, withStandardForm, FieldCreators, createSelectField, createCascaderField, DeleteConfirm, RuleBuilder, RegexEditor, useRegexValidation, useTemplateManager, TemplateSelector, TemplateCategory, RegexTester, FlagsSelector, MatchItem, RegexRailroadDiagram,
 // 列配置方案管理
-useColumnSchemes, SchemeSelector, SchemeManager, LocalStorageAdapter, defaultStorageAdapter, validateScheme, validateSchemeName, validateSchemeDescription, checkDuplicateName, generateUniqueName, STORAGE_PREFIX, DEFAULT_SCHEME_NAME, MAX_SCHEMES_PER_GRID, MAX_SCHEME_NAME_LENGTH };
+useColumnSchemes, SchemeSelector, SchemeManager, LocalStorageAdapter, defaultStorageAdapter, validateScheme, validateSchemeName, validateSchemeDescription, checkDuplicateName, generateUniqueName, STORAGE_PREFIX, DEFAULT_SCHEME_NAME, MAX_SCHEMES_PER_GRID, MAX_SCHEME_NAME_LENGTH,
+// 全局方案同步管理
+initializeGlobalSchemeSync, getGlobalSyncManager, getGlobalAdapterFactory, isGlobalSyncInitialized, destroyGlobalSchemeSync, syncAllSchemes, getGlobalSyncStatus, hasUnsyncedData, getUnsyncedGrids, useGlobalColumnAdapter, useGlobalQueryAdapter, useGlobalColumnSchemeManager, useGlobalQuerySchemeManager };
 
 // 导出类型定义
 
 // 列配置方案管理类型
 
+// 全局方案同步管理类型
+
 // RegexEditor 类型定义 - 使用命名导出避免冲突

package/dist/esm/standardFormDialog/useStandardFormSchema.d.ts

@@ -32,7 +32,7 @@ export declare const createSelectField: (title: string, options: Array<{
     required?: boolean | undefined;
     placeholder?: string | undefined;
     gridSpan?: number | undefined;
-    mode?: "multiple" | "tags" | undefined;
+    mode?: "tags" | "multiple" | undefined;
 } | undefined) => any;
 /**
  * 快速创建常用字段的工具函数集合

package/dist/esm/standardFormDialog/withStandardForm.d.ts

@@ -173,7 +173,7 @@ export declare const createSelectField: (title: string, options: {
 export declare const createCascaderField: (title: string, options: any[], config?: {
     required?: boolean | undefined;
     changeOnSelect?: boolean | undefined;
-    expandTrigger?: "hover" | "click" | undefined;
+    expandTrigger?: "click" | "hover" | undefined;
     placeholder?: string | undefined;
 }) => {
     type: string;
@@ -187,7 +187,7 @@ export declare const createCascaderField: (title: string, options: any[], config
         };
         options: any[];
         changeOnSelect: boolean;
-        expandTrigger: "hover" | "click";
+        expandTrigger: "click" | "hover";
     };
 };
 export default withStandardForm;