@nokecy/qc-ui 1.1.39 → 1.1.41

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

@@ -1,88 +0,0 @@
-import { GridApi } from 'ag-grid-community';
-/**
- * 计算类型
- */
-export type CalculationType = 'sum' | 'avg' | 'standardDeviation' | false;
-/**
- * 计算列配置
- */
-export interface CalculationColumn {
-    field: string;
-    calculateType: CalculationType;
-    /** 小数位数，默认 2 */
-    transactionAmount?: number;
-    /** 是否使用千分位格式化 */
-    formatWithCommas?: boolean;
-    /** 自定义渲染器（如果存在则跳过计算） */
-    cellRenderer?: any;
-}
-/**
- * Hook 配置接口
- */
-export interface UseAgGridCalculationConfig {
-    /** Grid API 引用 */
-    gridApi?: GridApi;
-    /** 所有列定义 */
-    allColDefs?: import('../types').ExtendedColDef[];
-    /** 行数据 */
-    rowData: any[];
-}
-/**
- * Hook 返回值接口
- */
-export interface UseAgGridCalculationReturn {
-    /** 计算并更新底部固定行 */
-    calculateSum: () => void;
-    /** 处理筛选变化 */
-    onFilterChanged: () => void;
-}
-/**
- * 验证数值有效性
- */
-declare function isValidNumber(value: any): boolean;
-/**
- * 格式化数字（添加千分位）
- */
-declare function formatNumber(value: number, decimalPlaces?: number): string;
-/**
- * 求和函数
- */
-declare function sumFn(field: string, displayedData: any[]): number;
-/**
- * 平均值函数
- */
-declare function avgFn(field: string, displayedData: any[]): number;
-/**
- * 标准差函数
- */
-declare function standardDeviationFn(field: string, displayedData: any[]): number;
-/**
- * AG-Grid 计算列管理 Hook
- *
- * @description
- * 处理 AG-Grid 底部固定行的聚合计算（求和、平均值、标准差）
- *
- * @example
- * ```tsx
- * const { calculateSum, onFilterChanged } = useAgGridCalculation({
- *   gridApi,
- *   allColDefs,
- *   rowData
- * });
- *
- * // 在筛选变化时调用
- * <AgGridReact onFilterChanged={onFilterChanged} />
- * ```
- */
-export declare function useAgGridCalculation(config: UseAgGridCalculationConfig): UseAgGridCalculationReturn;
-/**
- * 导出工具函数供外部使用
- */
-export declare const calculationUtils: {
-    isValidNumber: typeof isValidNumber;
-    formatNumber: typeof formatNumber;
-    sumFn: typeof sumFn;
-    avgFn: typeof avgFn;
-    standardDeviationFn: typeof standardDeviationFn;
-};
-export {};

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

@@ -1,217 +0,0 @@
-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

@@ -1,91 +0,0 @@
-/// <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: import('../types').ExtendedColDef[]) => any;
-    /** 所有列定义 */
-    allColDefs?: import('../types').ExtendedColDef[];
-}
-/**
- * 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

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