@nokecy/qc-ui 1.1.39 → 1.1.40

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

@@ -1,153 +0,0 @@
-/**
- * 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/esm/ag-grid-plus/hooks/useGridState.js

@@ -1,258 +0,0 @@
-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
-  };
-}