@nokecy/qc-ui 1.0.70 → 1.0.72

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

@@ -0,0 +1,258 @@
+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 调用,提高性能和可维护性
+ */
+
+import { useReducer } from 'react';
+
+// ============ State 定义 ============
+
+/**
+ * Grid 状态接口
+ */
+
+// ============ Action 定义 ============
+
+/**
+ * Action 类型枚举
+ */
+export var 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
+ */
+export 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 });
+ * ```
+ */
+export 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 = 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/esm/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/esm/ag-grid-plus/index.js

@@ -4,4 +4,9 @@ import { GridPlusContext } from "./context/gridContext";
 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 { 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 { initializeGlobalSchemeSync, getGlobalSyncManager, getGlobalAdapterFactory, isGlobalSyncInitialized, destroyGlobalSchemeSync, syncAllSchemes, getGlobalSyncStatus, hasUnsyncedData, getUnsyncedGrids, useGlobalColumnAdapter, useGlobalQueryAdapter, useGlobalColumnSchemeManager, useGlobalQuerySchemeManager } from "./storage";

package/dist/esm/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/esm/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>;