@nokecy/qc-ui 1.0.69 → 1.0.71

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

@@ -0,0 +1,224 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.calculationUtils = void 0;
+exports.useAgGridCalculation = useAgGridCalculation;
+var _uniqueId2 = _interopRequireDefault(require("lodash/uniqueId"));
+var _sumBy2 = _interopRequireDefault(require("lodash/sumBy"));
+var _react = require("react");
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+/**
+ * 计算类型
+ */
+
+/**
+ * 计算列配置
+ */
+
+/**
+ * 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 (0, _sumBy2.default)(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 = (0, _sumBy2.default)(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} />
+ * ```
+ */
+function useAgGridCalculation(config) {
+  var gridApi = config.gridApi,
+    allColDefs = config.allColDefs,
+    rowData = config.rowData;
+
+  /**
+   * 计算并更新底部固定行
+   */
+  var calculateSum = (0, _react.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: (0, _uniqueId2.default)('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 = (0, _react.useCallback)(function () {
+    calculateSum();
+  }, [calculateSum]);
+
+  /**
+   * 监听列定义和行数据变化，自动计算
+   */
+  (0, _react.useEffect)(function () {
+    calculateSum();
+  }, [allColDefs, rowData, calculateSum]);
+  return {
+    calculateSum: calculateSum,
+    onFilterChanged: onFilterChanged
+  };
+}
+
+/**
+ * 导出工具函数供外部使用
+ */
+var calculationUtils = exports.calculationUtils = {
+  isValidNumber: isValidNumber,
+  formatNumber: formatNumber,
+  sumFn: sumFn,
+  avgFn: avgFn,
+  standardDeviationFn: standardDeviationFn
+};

package/dist/cjs/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/cjs/ag-grid-plus/hooks/useAgGridData.js

@@ -0,0 +1,230 @@
+"use strict";
+
+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); }
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useAgGridData = useAgGridData;
+var _react = require("react");
+var _antd = require("antd");
+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; }
+/**
+ * 分页状态接口
+ */
+
+/**
+ * 请求参数接口
+ */
+
+/**
+ * 请求响应接口
+ */
+
+/**
+ * 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' }
+ * });
+ * ```
+ */
+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 = (0, _react.useState)(false),
+    _useState2 = _slicedToArray(_useState, 2),
+    ready = _useState2[0],
+    setReady = _useState2[1];
+  var _useState3 = (0, _react.useState)(loadingProps !== null && loadingProps !== void 0 ? loadingProps : false),
+    _useState4 = _slicedToArray(_useState3, 2),
+    loading = _useState4[0],
+    setLoading = _useState4[1];
+  var _useState5 = (0, _react.useState)([]),
+    _useState6 = _slicedToArray(_useState5, 2),
+    rowData = _useState6[0],
+    setRowData = _useState6[1];
+  var _useState7 = (0, _react.useState)({}),
+    _useState8 = _slicedToArray(_useState7, 2),
+    queryFilter = _useState8[0],
+    setQueryFilter = _useState8[1];
+  var _useState9 = (0, _react.useState)(),
+    _useState10 = _slicedToArray(_useState9, 2),
+    sortColumn = _useState10[0],
+    setSortColumn = _useState10[1];
+
+  // 初始化分页参数
+  var _useState11 = (0, _react.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 = (0, _react.useRef)(false);
+
+  /**
+   * 发起数据请求
+   */
+  var onRequest = (0, _react.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);
+      _antd.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 = (0, _react.useCallback)(function () {
+    if (request) {
+      onRequest(queryFilter);
+    }
+  }, [request, queryFilter, onRequest]);
+
+  /**
+   * 处理排序变化
+   */
+  var handleSortChanged = (0, _react.useCallback)(function (columnApi) {
+    var sortedColumn = columnApi.getColumnState().find(function (col) {
+      return Boolean(col.sort);
+    });
+    setSortColumn(sortedColumn);
+  }, []);
+
+  /**
+   * 监听外部 loading 状态变化
+   */
+  (0, _react.useEffect)(function () {
+    if (loadingProps !== undefined) {
+      setLoading(loadingProps);
+    }
+  }, [loadingProps]);
+
+  /**
+   * 监听静态数据源变化
+   */
+  (0, _react.useEffect)(function () {
+    if (dataSource) {
+      setRowData(dataSource);
+      setPagination(function (prev) {
+        return _objectSpread(_objectSpread({}, prev), {}, {
+          total: dataSource.length
+        });
+      });
+    }
+  }, [dataSource]);
+
+  /**
+   * 自动请求数据（当相关参数变化时）
+   */
+  (0, _react.useEffect)(function () {
+    if (ready && request) {
+      onRequest(queryFilter);
+    }
+  }, [ready, pagination.pageSize, pagination.current]);
+
+  // 监听 gridParams 和 sortColumn 变化（使用 JSON 序列化进行比较）
+  var gridParamsRef = (0, _react.useRef)(gridParams);
+  var sortColumnRef = (0, _react.useRef)(sortColumn);
+  (0, _react.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/cjs/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;