@nokecy/qc-ui 1.0.70 → 1.0.72

package/dist/cjs/ag-grid-plus/hooks/useGridState.d.ts

@@ -0,0 +1,153 @@
+/**
+ * AG-Grid Plus 状态管理 Hook
+ *
+ * 使用 useReducer 统一管理组件的所有状态,
+ * 替代多个 useState 调用,提高性能和可维护性
+ */
+import { Dispatch } from 'react';
+import { ColumnState } from 'ag-grid-community';
+import type { ExtendedColumnState, ColumnCellConfigMap, QueryFilterState, PaginationState, RowDataArray } from '../types';
+/**
+ * Grid 状态接口
+ */
+export interface GridState {
+    /** Grid 是否已就绪 */
+    ready: boolean;
+    /** 加载状态 */
+    loading: boolean;
+    /** 列状态配置 */
+    columnState?: ExtendedColumnState[];
+    /** 列单元格样式映射 */
+    columnCellClass: ColumnCellConfigMap;
+    /** 行数据 */
+    rowData: RowDataArray;
+    /** 选中的行 */
+    selectRow: any;
+    /** 查询过滤器 */
+    queryFilter: QueryFilterState;
+    /** 排序列 */
+    sortColumn?: ColumnState;
+    /** 分页配置 */
+    pagination: PaginationState;
+    /** 查询表单项顺序 */
+    queryItemsOrder: string[];
+}
+/**
+ * Action 类型枚举
+ */
+export declare enum GridActionType {
+    SET_READY = "SET_READY",
+    SET_LOADING = "SET_LOADING",
+    SET_COLUMN_STATE = "SET_COLUMN_STATE",
+    SET_COLUMN_CELL_CLASS = "SET_COLUMN_CELL_CLASS",
+    SET_ROW_DATA = "SET_ROW_DATA",
+    SET_SELECT_ROW = "SET_SELECT_ROW",
+    SET_QUERY_FILTER = "SET_QUERY_FILTER",
+    SET_SORT_COLUMN = "SET_SORT_COLUMN",
+    SET_PAGINATION = "SET_PAGINATION",
+    UPDATE_PAGINATION = "UPDATE_PAGINATION",
+    SET_QUERY_ITEMS_ORDER = "SET_QUERY_ITEMS_ORDER",
+    RESET_STATE = "RESET_STATE"
+}
+/**
+ * Action 联合类型
+ */
+export type GridAction = {
+    type: GridActionType.SET_READY;
+    payload: boolean;
+} | {
+    type: GridActionType.SET_LOADING;
+    payload: boolean;
+} | {
+    type: GridActionType.SET_COLUMN_STATE;
+    payload: ExtendedColumnState[] | undefined;
+} | {
+    type: GridActionType.SET_COLUMN_CELL_CLASS;
+    payload: ColumnCellConfigMap;
+} | {
+    type: GridActionType.SET_ROW_DATA;
+    payload: RowDataArray;
+} | {
+    type: GridActionType.SET_SELECT_ROW;
+    payload: any;
+} | {
+    type: GridActionType.SET_QUERY_FILTER;
+    payload: QueryFilterState;
+} | {
+    type: GridActionType.SET_SORT_COLUMN;
+    payload: ColumnState | undefined;
+} | {
+    type: GridActionType.SET_PAGINATION;
+    payload: PaginationState;
+} | {
+    type: GridActionType.UPDATE_PAGINATION;
+    payload: Partial<PaginationState>;
+} | {
+    type: GridActionType.SET_QUERY_ITEMS_ORDER;
+    payload: string[];
+} | {
+    type: GridActionType.RESET_STATE;
+    payload: Partial<GridState>;
+};
+/**
+ * Grid 状态 Reducer
+ */
+export declare function gridReducer(state: GridState, action: GridAction): GridState;
+/**
+ * useGridState Hook 配置
+ */
+export interface UseGridStateConfig {
+    /** 初始加载状态 */
+    loading?: boolean;
+    /** 初始分页配置 */
+    pageSize?: number;
+    /** 是否隐藏分页 */
+    hidePagination?: boolean;
+    /** 数据源（用于计算初始 total） */
+    dataSource?: any[];
+}
+/**
+ * useGridState Hook 返回值
+ */
+export interface UseGridStateReturn {
+    /** Grid 状态 */
+    state: GridState;
+    /** Dispatch 函数 */
+    dispatch: Dispatch<GridAction>;
+    /** 便捷的 actions */
+    actions: {
+        setReady: (ready: boolean) => void;
+        setLoading: (loading: boolean) => void;
+        setColumnState: (columnState: ExtendedColumnState[] | undefined) => void;
+        setColumnCellClass: (columnCellClass: ColumnCellConfigMap) => void;
+        setRowData: (rowData: RowDataArray) => void;
+        setSelectRow: (selectRow: any) => void;
+        setQueryFilter: (queryFilter: QueryFilterState) => void;
+        setSortColumn: (sortColumn: ColumnState | undefined) => void;
+        setPagination: (pagination: PaginationState) => void;
+        updatePagination: (pagination: Partial<PaginationState>) => void;
+        setQueryItemsOrder: (order: string[]) => void;
+        resetState: (state: Partial<GridState>) => void;
+    };
+}
+/**
+ * AG-Grid Plus 状态管理 Hook
+ *
+ * @param config 配置对象
+ * @returns 状态和 actions
+ *
+ * @example
+ * ```tsx
+ * const { state, actions } = useGridState({
+ *   loading: false,
+ *   pageSize: 200,
+ *   hidePagination: false
+ * });
+ *
+ * // 使用 actions
+ * actions.setLoading(true);
+ * actions.setRowData(newData);
+ * actions.updatePagination({ current: 2 });
+ * ```
+ */
+export declare function useGridState(config?: UseGridStateConfig): UseGridStateReturn;

package/dist/cjs/ag-grid-plus/hooks/useGridState.js

@@ -0,0 +1,258 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.GridActionType = void 0;
+exports.gridReducer = gridReducer;
+exports.useGridState = useGridState;
+var _react = require("react");
+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 _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
+function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t.return && (u = t.return(), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
+function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
+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; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); } /**
+ * AG-Grid Plus 状态管理 Hook
+ *
+ * 使用 useReducer 统一管理组件的所有状态,
+ * 替代多个 useState 调用,提高性能和可维护性
+ */
+// ============ State 定义 ============
+/**
+ * Grid 状态接口
+ */
+// ============ Action 定义 ============
+/**
+ * Action 类型枚举
+ */
+var GridActionType = exports.GridActionType = /*#__PURE__*/function (GridActionType) {
+  GridActionType["SET_READY"] = "SET_READY";
+  GridActionType["SET_LOADING"] = "SET_LOADING";
+  GridActionType["SET_COLUMN_STATE"] = "SET_COLUMN_STATE";
+  GridActionType["SET_COLUMN_CELL_CLASS"] = "SET_COLUMN_CELL_CLASS";
+  GridActionType["SET_ROW_DATA"] = "SET_ROW_DATA";
+  GridActionType["SET_SELECT_ROW"] = "SET_SELECT_ROW";
+  GridActionType["SET_QUERY_FILTER"] = "SET_QUERY_FILTER";
+  GridActionType["SET_SORT_COLUMN"] = "SET_SORT_COLUMN";
+  GridActionType["SET_PAGINATION"] = "SET_PAGINATION";
+  GridActionType["UPDATE_PAGINATION"] = "UPDATE_PAGINATION";
+  GridActionType["SET_QUERY_ITEMS_ORDER"] = "SET_QUERY_ITEMS_ORDER";
+  GridActionType["RESET_STATE"] = "RESET_STATE";
+  return GridActionType;
+}({});
+/**
+ * Action 联合类型
+ */
+// ============ Reducer 定义 ============
+
+/**
+ * Grid 状态 Reducer
+ */
+function gridReducer(state, action) {
+  switch (action.type) {
+    case GridActionType.SET_READY:
+      return _objectSpread(_objectSpread({}, state), {}, {
+        ready: action.payload
+      });
+    case GridActionType.SET_LOADING:
+      return _objectSpread(_objectSpread({}, state), {}, {
+        loading: action.payload
+      });
+    case GridActionType.SET_COLUMN_STATE:
+      return _objectSpread(_objectSpread({}, state), {}, {
+        columnState: action.payload
+      });
+    case GridActionType.SET_COLUMN_CELL_CLASS:
+      return _objectSpread(_objectSpread({}, state), {}, {
+        columnCellClass: action.payload
+      });
+    case GridActionType.SET_ROW_DATA:
+      return _objectSpread(_objectSpread({}, state), {}, {
+        rowData: action.payload
+      });
+    case GridActionType.SET_SELECT_ROW:
+      return _objectSpread(_objectSpread({}, state), {}, {
+        selectRow: action.payload
+      });
+    case GridActionType.SET_QUERY_FILTER:
+      return _objectSpread(_objectSpread({}, state), {}, {
+        queryFilter: action.payload
+      });
+    case GridActionType.SET_SORT_COLUMN:
+      return _objectSpread(_objectSpread({}, state), {}, {
+        sortColumn: action.payload
+      });
+    case GridActionType.SET_PAGINATION:
+      return _objectSpread(_objectSpread({}, state), {}, {
+        pagination: action.payload
+      });
+    case GridActionType.UPDATE_PAGINATION:
+      return _objectSpread(_objectSpread({}, state), {}, {
+        pagination: _objectSpread(_objectSpread({}, state.pagination), action.payload)
+      });
+    case GridActionType.SET_QUERY_ITEMS_ORDER:
+      return _objectSpread(_objectSpread({}, state), {}, {
+        queryItemsOrder: action.payload
+      });
+    case GridActionType.RESET_STATE:
+      return _objectSpread(_objectSpread({}, state), action.payload);
+    default:
+      return state;
+  }
+}
+
+// ============ Hook 定义 ============
+
+/**
+ * useGridState Hook 配置
+ */
+
+/**
+ * useGridState Hook 返回值
+ */
+
+/**
+ * AG-Grid Plus 状态管理 Hook
+ *
+ * @param config 配置对象
+ * @returns 状态和 actions
+ *
+ * @example
+ * ```tsx
+ * const { state, actions } = useGridState({
+ *   loading: false,
+ *   pageSize: 200,
+ *   hidePagination: false
+ * });
+ *
+ * // 使用 actions
+ * actions.setLoading(true);
+ * actions.setRowData(newData);
+ * actions.updatePagination({ current: 2 });
+ * ```
+ */
+function useGridState() {
+  var config = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
+  var _config$loading = config.loading,
+    initialLoading = _config$loading === void 0 ? false : _config$loading,
+    initialPageSize = config.pageSize,
+    _config$hidePaginatio = config.hidePagination,
+    hidePagination = _config$hidePaginatio === void 0 ? false : _config$hidePaginatio,
+    _config$dataSource = config.dataSource,
+    dataSource = _config$dataSource === void 0 ? [] : _config$dataSource;
+
+  // 计算初始分页配置
+  var initialPagination = {
+    pageSize: initialPageSize !== undefined ? initialPageSize : hidePagination ? 10000 : 200,
+    current: 1,
+    total: dataSource.length
+  };
+
+  // 初始状态
+  var initialState = {
+    ready: false,
+    loading: initialLoading,
+    columnState: undefined,
+    columnCellClass: {},
+    rowData: [],
+    selectRow: {},
+    queryFilter: {},
+    sortColumn: undefined,
+    pagination: initialPagination,
+    queryItemsOrder: []
+  };
+
+  // 使用 useReducer
+  var _useReducer = (0, _react.useReducer)(gridReducer, initialState),
+    _useReducer2 = _slicedToArray(_useReducer, 2),
+    state = _useReducer2[0],
+    dispatch = _useReducer2[1];
+
+  // 创建便捷的 actions
+  var actions = {
+    setReady: function setReady(ready) {
+      return dispatch({
+        type: GridActionType.SET_READY,
+        payload: ready
+      });
+    },
+    setLoading: function setLoading(loading) {
+      return dispatch({
+        type: GridActionType.SET_LOADING,
+        payload: loading
+      });
+    },
+    setColumnState: function setColumnState(columnState) {
+      return dispatch({
+        type: GridActionType.SET_COLUMN_STATE,
+        payload: columnState
+      });
+    },
+    setColumnCellClass: function setColumnCellClass(columnCellClass) {
+      return dispatch({
+        type: GridActionType.SET_COLUMN_CELL_CLASS,
+        payload: columnCellClass
+      });
+    },
+    setRowData: function setRowData(rowData) {
+      return dispatch({
+        type: GridActionType.SET_ROW_DATA,
+        payload: rowData
+      });
+    },
+    setSelectRow: function setSelectRow(selectRow) {
+      return dispatch({
+        type: GridActionType.SET_SELECT_ROW,
+        payload: selectRow
+      });
+    },
+    setQueryFilter: function setQueryFilter(queryFilter) {
+      return dispatch({
+        type: GridActionType.SET_QUERY_FILTER,
+        payload: queryFilter
+      });
+    },
+    setSortColumn: function setSortColumn(sortColumn) {
+      return dispatch({
+        type: GridActionType.SET_SORT_COLUMN,
+        payload: sortColumn
+      });
+    },
+    setPagination: function setPagination(pagination) {
+      return dispatch({
+        type: GridActionType.SET_PAGINATION,
+        payload: pagination
+      });
+    },
+    updatePagination: function updatePagination(pagination) {
+      return dispatch({
+        type: GridActionType.UPDATE_PAGINATION,
+        payload: pagination
+      });
+    },
+    setQueryItemsOrder: function setQueryItemsOrder(order) {
+      return dispatch({
+        type: GridActionType.SET_QUERY_ITEMS_ORDER,
+        payload: order
+      });
+    },
+    resetState: function resetState(newState) {
+      return dispatch({
+        type: GridActionType.RESET_STATE,
+        payload: newState
+      });
+    }
+  };
+  return {
+    state: state,
+    dispatch: dispatch,
+    actions: actions
+  };
+}

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

@@ -5,3 +5,8 @@ import { useGridPlusColumnState } from "./hooks/useGridPlusColumnState";
 import "./ag-grid-theme-builder.css";
 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 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

@@ -15,12 +15,60 @@ Object.defineProperty(exports, "AgGridPlus", {
     return _agGridPlus.default;
   }
 });
+Object.defineProperty(exports, "DEFAULT_SCHEME_NAME", {
+  enumerable: true,
+  get: function get() {
+    return _schemes.DEFAULT_SCHEME_NAME;
+  }
+});
 Object.defineProperty(exports, "GridPlusContext", {
   enumerable: true,
   get: function get() {
     return _gridContext.GridPlusContext;
   }
 });
+Object.defineProperty(exports, "LocalStorageAdapter", {
+  enumerable: true,
+  get: function get() {
+    return _schemes.LocalStorageAdapter;
+  }
+});
+Object.defineProperty(exports, "MAX_SCHEMES_PER_GRID", {
+  enumerable: true,
+  get: function get() {
+    return _schemes.MAX_SCHEMES_PER_GRID;
+  }
+});
+Object.defineProperty(exports, "MAX_SCHEME_NAME_LENGTH", {
+  enumerable: true,
+  get: function get() {
+    return _schemes.MAX_SCHEME_NAME_LENGTH;
+  }
+});
+Object.defineProperty(exports, "STORAGE_PREFIX", {
+  enumerable: true,
+  get: function get() {
+    return _schemes.STORAGE_PREFIX;
+  }
+});
+Object.defineProperty(exports, "SchemeManager", {
+  enumerable: true,
+  get: function get() {
+    return _schemes.SchemeManager;
+  }
+});
+Object.defineProperty(exports, "SchemeSelector", {
+  enumerable: true,
+  get: function get() {
+    return _schemes.SchemeSelector;
+  }
+});
+Object.defineProperty(exports, "checkDuplicateName", {
+  enumerable: true,
+  get: function get() {
+    return _schemes.checkDuplicateName;
+  }
+});
 Object.defineProperty(exports, "convertFilterModel", {
   enumerable: true,
   get: function get() {
@@ -45,6 +93,18 @@ Object.defineProperty(exports, "dateValueFormatter", {
     return _utils.dateValueFormatter;
   }
 });
+Object.defineProperty(exports, "defaultStorageAdapter", {
+  enumerable: true,
+  get: function get() {
+    return _schemes.defaultStorageAdapter;
+  }
+});
+Object.defineProperty(exports, "destroyGlobalSchemeSync", {
+  enumerable: true,
+  get: function get() {
+    return _storage.destroyGlobalSchemeSync;
+  }
+});
 Object.defineProperty(exports, "flatten", {
   enumerable: true,
   get: function get() {
@@ -57,22 +117,126 @@ Object.defineProperty(exports, "flattenTreeDeep", {
     return _utils.flattenTreeDeep;
   }
 });
+Object.defineProperty(exports, "generateUniqueName", {
+  enumerable: true,
+  get: function get() {
+    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() {
     return _utils.toTree;
   }
 });
+Object.defineProperty(exports, "useColumnSchemes", {
+  enumerable: true,
+  get: function get() {
+    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() {
     return _useGridPlusColumnState.useGridPlusColumnState;
   }
 });
+Object.defineProperty(exports, "validateScheme", {
+  enumerable: true,
+  get: function get() {
+    return _schemes.validateScheme;
+  }
+});
+Object.defineProperty(exports, "validateSchemeDescription", {
+  enumerable: true,
+  get: function get() {
+    return _schemes.validateSchemeDescription;
+  }
+});
+Object.defineProperty(exports, "validateSchemeName", {
+  enumerable: true,
+  get: function get() {
+    return _schemes.validateSchemeName;
+  }
+});
 var _agGridPlus = _interopRequireDefault(require("./ag-gridPlus"));
 var _interface = require("./interface");
 var _gridContext = require("./context/gridContext");
 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

@@ -1,6 +1,9 @@
 import { GridApi, ColDef, ColGroupDef } from "ag-grid-community";
 import { AgGridReactProps } from "ag-grid-react";
 import React, { CSSProperties, ReactNode } from "react";
+import type { QueryStorageAdapter } from "./querySchemes/types";
+import type { StorageAdapter as ColumnStorageAdapter } from "./schemes/types";
+import type { GridPlusError } from "./errors";
 interface GridRef {
     onRefresh: () => void;
 }
@@ -53,6 +56,40 @@ interface GridProps extends AgGridReactProps {
      * 选中行变化回调函数
      */
     onSelectedRowsChange?: (selectedRows: any[]) => void;
+    /**
+     * 是否启用查询方案功能
+     */
+    enableQuerySchemes?: boolean;
+    /**
+     * 查询方案存储适配器（可选）
+     * 默认使用 LocalStorage，可传入自定义适配器实现服务端存储
+     */
+    querySchemeStorageAdapter?: QueryStorageAdapter;
+    /**
+     * 查询方案管理器（可选）
+     * 如果不提供，组件会根据 gridKey 自动从全局方案管理器创建
+     */
+    querySchemeManager?: any;
+    /**
+     * 是否启用列配置方案功能
+     * 默认值: true (自动启用)
+     */
+    enableColumnSchemes?: boolean;
+    /**
+     * 列配置方案存储适配器（可选）
+     * 默认使用 LocalStorage，可传入自定义适配器实现服务端存储
+     */
+    columnSchemeStorageAdapter?: ColumnStorageAdapter;
+    /**
+     * 列配置方案管理器（可选）
+     * 如果不提供，组件会根据 gridKey 自动从全局方案管理器创建
+     */
+    columnSchemeManager?: any;
+    /**
+     * 错误处理回调函数
+     * 当组件发生错误时调用，可用于自定义错误处理逻辑
+     */
+    onError?: (error: GridPlusError) => void;
 }
 interface AgGridColumnPropsClone extends ColDef {
     /**

package/dist/cjs/ag-grid-plus/querySchemes/components/QuerySchemesManager.d.ts

@@ -0,0 +1,21 @@
+import React from 'react';
+import type { UseQuerySchemesReturn, QueryFormItemWithOrder } from '../types';
+import './QuerySchemesManager.less';
+export interface QuerySchemesManagerProps {
+    /** 方案管理器 */
+    schemeManager: UseQuerySchemesReturn;
+    /** 表单项列表 */
+    formItems: QueryFormItemWithOrder[];
+    /** 当前查询项顺序 */
+    currentOrder: string[];
+    /** 模态框是否可见 */
+    visible: boolean;
+    /** 关闭回调 */
+    onClose: () => void;
+    /** 顺序变更回调 */
+    onOrderChange: (order: string[]) => void;
+}
+/**
+ * 查询方案管理组件
+ */
+export declare const QuerySchemesManager: React.FC<QuerySchemesManagerProps>;