@nokecy/qc-ui 1.0.70 → 1.0.72

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

@@ -0,0 +1,217 @@
+import _uniqueId from "lodash/uniqueId";
+import _sumBy from "lodash/sumBy";
+import { useCallback, useEffect } from 'react';
+
+/**
+ * 计算类型
+ */
+
+/**
+ * 计算列配置
+ */
+
+/**
+ * Hook 配置接口
+ */
+
+/**
+ * Hook 返回值接口
+ */
+
+/**
+ * 验证数值有效性
+ */
+function isValidNumber(value) {
+  return typeof value === 'number' && !isNaN(value);
+}
+
+/**
+ * 格式化数字（添加千分位）
+ */
+function formatNumber(value) {
+  var decimalPlaces = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 2;
+  return value.toLocaleString(undefined, {
+    minimumFractionDigits: decimalPlaces,
+    maximumFractionDigits: decimalPlaces
+  });
+}
+
+/**
+ * 求和函数
+ */
+function sumFn(field, displayedData) {
+  return _sumBy(displayedData, function (cur) {
+    if (cur && isValidNumber(cur[field])) {
+      return cur[field];
+    }
+    return 0;
+  });
+}
+
+/**
+ * 平均值函数
+ */
+function avgFn(field, displayedData) {
+  var validItems = displayedData.filter(function (cur) {
+    return cur && cur[field] !== undefined && cur[field] !== null;
+  });
+  if (validItems.length === 0) return 0;
+  var sum = sumFn(field, displayedData);
+  return sum / validItems.length;
+}
+
+/**
+ * 标准差函数
+ */
+function standardDeviationFn(field, displayedData) {
+  var validValues = displayedData.filter(function (cur) {
+    return isValidNumber(cur[field]);
+  });
+  var count = validValues.length;
+  if (count === 0) return 0;
+  var mean = sumFn(field, displayedData) / count;
+  var variance = _sumBy(displayedData, function (cur) {
+    if (cur && cur[field] !== undefined && cur[field] !== null) {
+      var diff = cur[field] - mean;
+      return diff * diff;
+    }
+    return 0;
+  }) / count;
+  return Math.sqrt(variance);
+}
+
+/**
+ * 执行计算
+ */
+function calculate(column, displayedData) {
+  var field = column.field,
+    calculateType = column.calculateType,
+    _column$transactionAm = column.transactionAmount,
+    transactionAmount = _column$transactionAm === void 0 ? 2 : _column$transactionAm,
+    formatWithCommas = column.formatWithCommas;
+  var result;
+  switch (calculateType) {
+    case 'sum':
+      result = sumFn(field, displayedData);
+      break;
+    case 'avg':
+      result = avgFn(field, displayedData);
+      break;
+    case 'standardDeviation':
+      result = standardDeviationFn(field, displayedData);
+      break;
+    default:
+      return 0;
+  }
+
+  // 格式化结果
+  var fixedResult = Number(result.toFixed(transactionAmount));
+  return formatWithCommas ? formatNumber(fixedResult, transactionAmount) : fixedResult;
+}
+
+/**
+ * AG-Grid 计算列管理 Hook
+ *
+ * @description
+ * 处理 AG-Grid 底部固定行的聚合计算（求和、平均值、标准差）
+ *
+ * @example
+ * ```tsx
+ * const { calculateSum, onFilterChanged } = useAgGridCalculation({
+ *   gridApi,
+ *   allColDefs,
+ *   rowData
+ * });
+ *
+ * // 在筛选变化时调用
+ * <AgGridReact onFilterChanged={onFilterChanged} />
+ * ```
+ */
+export function useAgGridCalculation(config) {
+  var gridApi = config.gridApi,
+    allColDefs = config.allColDefs,
+    rowData = config.rowData;
+
+  /**
+   * 计算并更新底部固定行
+   */
+  var calculateSum = useCallback(function () {
+    if (!gridApi || !allColDefs) {
+      gridApi === null || gridApi === void 0 || gridApi.setGridOption('pinnedBottomRowData', undefined);
+      return;
+    }
+
+    // 获取筛选后的数据
+    var displayedData = [];
+    gridApi.forEachNodeAfterFilter(function (node) {
+      displayedData.push(node.data);
+    });
+    if (displayedData.length === 0) {
+      gridApi.setGridOption('pinnedBottomRowData', undefined);
+      return;
+    }
+
+    // 提取需要计算的列
+    var calcColumns = allColDefs.filter(function (col) {
+      return col.calculateType && col.calculateType !== false;
+    }).map(function (col) {
+      return {
+        field: col.field,
+        calculateType: col.calculateType,
+        transactionAmount: col.transactionAmount || 2,
+        formatWithCommas: col.formatWithCommas,
+        cellRenderer: col.cellRenderer
+      };
+    });
+    if (calcColumns.length === 0) {
+      gridApi.setGridOption('pinnedBottomRowData', undefined);
+      return;
+    }
+
+    // 执行计算
+    var calculatedData = {
+      id: _uniqueId('calc_')
+    };
+    calcColumns.forEach(function (column) {
+      // 如果有自定义渲染器，跳过计算
+      if (!column.cellRenderer) {
+        calculatedData[column.field] = calculate(column, displayedData);
+      }
+    });
+
+    // 更新底部固定行
+    if (Object.keys(calculatedData).length > 1) {
+      // 除了 id 之外还有其他字段
+      gridApi.setGridOption('pinnedBottomRowData', [calculatedData]);
+    }
+  }, [gridApi, allColDefs]);
+
+  /**
+   * 处理筛选变化
+   */
+  var onFilterChanged = useCallback(function () {
+    calculateSum();
+  }, [calculateSum]);
+
+  /**
+   * 监听列定义和行数据变化，自动计算
+   */
+  useEffect(function () {
+    calculateSum();
+  }, [allColDefs, rowData, calculateSum]);
+  return {
+    calculateSum: calculateSum,
+    onFilterChanged: onFilterChanged
+  };
+}
+
+/**
+ * 导出工具函数供外部使用
+ */
+export var calculationUtils = {
+  isValidNumber: isValidNumber,
+  formatNumber: formatNumber,
+  sumFn: sumFn,
+  avgFn: avgFn,
+  standardDeviationFn: standardDeviationFn
+};

package/dist/esm/ag-grid-plus/hooks/useAgGridData.d.ts

@@ -0,0 +1,91 @@
+/// <reference types="react" />
+import { GridApi, ColumnState } from 'ag-grid-community';
+/**
+ * 分页状态接口
+ */
+export interface PaginationState {
+    pageSize: number;
+    current: number;
+    total: number;
+}
+/**
+ * 请求参数接口
+ */
+export interface RequestParams {
+    filter: any;
+    current: number;
+    skipCount: number;
+    maxResultCount: number;
+    sorter: string;
+    [key: string]: any;
+}
+/**
+ * 请求响应接口
+ */
+export interface RequestResponse {
+    data: any[];
+    total: number;
+}
+/**
+ * Hook 配置接口
+ */
+export interface UseAgGridDataConfig {
+    /** 请求函数 */
+    request?: (params: RequestParams, sort: any, filter: any) => Promise<RequestResponse>;
+    /** 静态数据源 */
+    dataSource?: any[];
+    /** 初始分页大小 */
+    pageSize?: number;
+    /** 是否隐藏分页 */
+    hidePagination?: boolean;
+    /** 外部 loading 状态 */
+    loading?: boolean;
+    /** 额外的请求参数 */
+    gridParams?: any;
+    /** 列过滤模型转换函数 */
+    convertFilterModel?: (queryFilter: any, colDefs: any[]) => any;
+    /** 所有列定义 */
+    allColDefs?: any[];
+}
+/**
+ * Hook 返回值接口
+ */
+export interface UseAgGridDataReturn {
+    rowData: any[];
+    loading: boolean;
+    pagination: PaginationState;
+    queryFilter: any;
+    sortColumn?: ColumnState;
+    ready: boolean;
+    setRowData: React.Dispatch<React.SetStateAction<any[]>>;
+    setLoading: React.Dispatch<React.SetStateAction<boolean>>;
+    setPagination: React.Dispatch<React.SetStateAction<PaginationState>>;
+    setQueryFilter: React.Dispatch<React.SetStateAction<any>>;
+    setSortColumn: React.Dispatch<React.SetStateAction<ColumnState | undefined>>;
+    setReady: React.Dispatch<React.SetStateAction<boolean>>;
+    onRequest: (filter: any) => void;
+    onRefresh: () => void;
+    handleSortChanged: (columnApi: GridApi) => void;
+}
+/**
+ * AG-Grid 数据获取和分页管理 Hook
+ *
+ * @description
+ * 处理 AG-Grid 的数据请求、分页、排序、筛选等逻辑
+ *
+ * @example
+ * ```tsx
+ * const {
+ *   rowData,
+ *   loading,
+ *   pagination,
+ *   onRequest,
+ *   onRefresh
+ * } = useAgGridData({
+ *   request: fetchData,
+ *   pageSize: 50,
+ *   gridParams: { status: 'active' }
+ * });
+ * ```
+ */
+export declare function useAgGridData(config: UseAgGridDataConfig): UseAgGridDataReturn;

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

@@ -0,0 +1,225 @@
+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; }
+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); }
+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; }
+import { useState, useEffect, useCallback, useRef } from 'react';
+import { message } from 'antd';
+
+/**
+ * 分页状态接口
+ */
+
+/**
+ * 请求参数接口
+ */
+
+/**
+ * 请求响应接口
+ */
+
+/**
+ * Hook 配置接口
+ */
+
+/**
+ * Hook 返回值接口
+ */
+
+/**
+ * 获取排序字符串
+ */
+function getSort(columnState) {
+  return columnState ? "".concat(columnState.colId, " ").concat(columnState.sort) : '';
+}
+
+/**
+ * AG-Grid 数据获取和分页管理 Hook
+ *
+ * @description
+ * 处理 AG-Grid 的数据请求、分页、排序、筛选等逻辑
+ *
+ * @example
+ * ```tsx
+ * const {
+ *   rowData,
+ *   loading,
+ *   pagination,
+ *   onRequest,
+ *   onRefresh
+ * } = useAgGridData({
+ *   request: fetchData,
+ *   pageSize: 50,
+ *   gridParams: { status: 'active' }
+ * });
+ * ```
+ */
+export function useAgGridData(config) {
+  var request = config.request,
+    dataSource = config.dataSource,
+    initialPageSize = config.pageSize,
+    hidePagination = config.hidePagination,
+    loadingProps = config.loading,
+    gridParams = config.gridParams,
+    convertFilterModel = config.convertFilterModel,
+    allColDefs = config.allColDefs;
+
+  // 状态管理
+  var _useState = useState(false),
+    _useState2 = _slicedToArray(_useState, 2),
+    ready = _useState2[0],
+    setReady = _useState2[1];
+  var _useState3 = useState(loadingProps !== null && loadingProps !== void 0 ? loadingProps : false),
+    _useState4 = _slicedToArray(_useState3, 2),
+    loading = _useState4[0],
+    setLoading = _useState4[1];
+  var _useState5 = useState([]),
+    _useState6 = _slicedToArray(_useState5, 2),
+    rowData = _useState6[0],
+    setRowData = _useState6[1];
+  var _useState7 = useState({}),
+    _useState8 = _slicedToArray(_useState7, 2),
+    queryFilter = _useState8[0],
+    setQueryFilter = _useState8[1];
+  var _useState9 = useState(),
+    _useState10 = _slicedToArray(_useState9, 2),
+    sortColumn = _useState10[0],
+    setSortColumn = _useState10[1];
+
+  // 初始化分页参数
+  var _useState11 = useState({
+      pageSize: initialPageSize !== null && initialPageSize !== void 0 ? initialPageSize : hidePagination ? 10000 : 200,
+      current: 1,
+      total: dataSource ? dataSource.length : 0
+    }),
+    _useState12 = _slicedToArray(_useState11, 2),
+    pagination = _useState12[0],
+    setPagination = _useState12[1];
+
+  // 用于防止不必要的请求
+  var requestInProgressRef = useRef(false);
+
+  /**
+   * 发起数据请求
+   */
+  var onRequest = useCallback(function (filter) {
+    if (!request || requestInProgressRef.current) return;
+    requestInProgressRef.current = true;
+    setLoading(true);
+
+    // 转换筛选模型
+    var convertedFilter = convertFilterModel && allColDefs ? convertFilterModel(filter, allColDefs) : filter;
+    var params = _objectSpread(_objectSpread({
+      filter: convertedFilter
+    }, gridParams), {}, {
+      current: pagination.current,
+      skipCount: pagination.current === 1 ? 0 : (pagination.current - 1) * pagination.pageSize,
+      maxResultCount: pagination.pageSize,
+      sorter: getSort(sortColumn)
+    });
+    request(params, undefined, filter).then(function (response) {
+      var newRowData = response.data;
+      var rowCount = response.total;
+      setRowData(newRowData);
+      setPagination(function (prev) {
+        return _objectSpread(_objectSpread({}, prev), {}, {
+          total: rowCount
+        });
+      });
+    }).catch(function (error) {
+      console.error('[useAgGridData] 请求失败:', error);
+      message.error((error === null || error === void 0 ? void 0 : error.message) || '数据加载失败，请重试');
+    }).finally(function () {
+      setLoading(false);
+      requestInProgressRef.current = false;
+    });
+  }, [request, gridParams, pagination.current, pagination.pageSize, sortColumn, convertFilterModel, allColDefs]);
+
+  /**
+   * 刷新数据
+   */
+  var onRefresh = useCallback(function () {
+    if (request) {
+      onRequest(queryFilter);
+    }
+  }, [request, queryFilter, onRequest]);
+
+  /**
+   * 处理排序变化
+   */
+  var handleSortChanged = useCallback(function (columnApi) {
+    var sortedColumn = columnApi.getColumnState().find(function (col) {
+      return Boolean(col.sort);
+    });
+    setSortColumn(sortedColumn);
+  }, []);
+
+  /**
+   * 监听外部 loading 状态变化
+   */
+  useEffect(function () {
+    if (loadingProps !== undefined) {
+      setLoading(loadingProps);
+    }
+  }, [loadingProps]);
+
+  /**
+   * 监听静态数据源变化
+   */
+  useEffect(function () {
+    if (dataSource) {
+      setRowData(dataSource);
+      setPagination(function (prev) {
+        return _objectSpread(_objectSpread({}, prev), {}, {
+          total: dataSource.length
+        });
+      });
+    }
+  }, [dataSource]);
+
+  /**
+   * 自动请求数据（当相关参数变化时）
+   */
+  useEffect(function () {
+    if (ready && request) {
+      onRequest(queryFilter);
+    }
+  }, [ready, pagination.pageSize, pagination.current]);
+
+  // 监听 gridParams 和 sortColumn 变化（使用 JSON 序列化进行比较）
+  var gridParamsRef = useRef(gridParams);
+  var sortColumnRef = useRef(sortColumn);
+  useEffect(function () {
+    var gridParamsChanged = JSON.stringify(gridParams) !== JSON.stringify(gridParamsRef.current);
+    var sortColumnChanged = JSON.stringify(sortColumn) !== JSON.stringify(sortColumnRef.current);
+    if (ready && request && (gridParamsChanged || sortColumnChanged)) {
+      gridParamsRef.current = gridParams;
+      sortColumnRef.current = sortColumn;
+      onRequest(queryFilter);
+    }
+  }, [gridParams, sortColumn, ready, request, queryFilter, onRequest]);
+  return {
+    rowData: rowData,
+    loading: loading,
+    pagination: pagination,
+    queryFilter: queryFilter,
+    sortColumn: sortColumn,
+    ready: ready,
+    setRowData: setRowData,
+    setLoading: setLoading,
+    setPagination: setPagination,
+    setQueryFilter: setQueryFilter,
+    setSortColumn: setSortColumn,
+    setReady: setReady,
+    onRequest: onRequest,
+    onRefresh: onRefresh,
+    handleSortChanged: handleSortChanged
+  };
+}

package/dist/esm/ag-grid-plus/hooks/useGridPlusColumnState.d.ts

@@ -2,11 +2,4 @@
  * 使用 GridPlusContext 的 Hook
  * 用于访问列状态管理相关的方法和数据
  */
-export declare const useGridPlusColumnState: () => {
-    extensibleColumns: any;
-    columnState: any;
-    onSaveColumnState: (gridKey: string, columnState: any[]) => void;
-    applyToGlobal: (gridKey: string) => void;
-    resetCurrent: (gridKey: string) => void;
-    resetAll: (gridKey: string) => void;
-};
+export declare const useGridPlusColumnState: () => import("../context/gridContext").GridPlusContextValue;

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