@nokecy/qc-ui 1.0.70 → 1.0.71

package/dist/cjs/ag-grid-plus/types.d.ts

@@ -0,0 +1,310 @@
+/**
+ * AG-Grid Plus 完整类型定义
+ *
+ * 此文件定义了 AgGridPlus 组件的所有核心类型接口,
+ * 用于替换代码中的 any 类型,提高类型安全性
+ */
+import { ColumnState, GridApi, ColDef } from 'ag-grid-community';
+import { ReactNode } from 'react';
+/**
+ * 分页状态
+ */
+export interface PaginationState {
+    /** 当前页码 (1-based) */
+    current: number;
+    /** 每页显示条数 */
+    pageSize: number;
+    /** 总数据量 */
+    total: number;
+}
+/**
+ * 选中行状态
+ */
+export interface SelectionState {
+    /** 选中的行键值集合 */
+    [key: string]: boolean;
+}
+/**
+ * 查询过滤器状态
+ */
+export interface QueryFilterState {
+    /** 字段到过滤值的映射 */
+    [field: string]: any;
+}
+/**
+ * 列单元格样式配置
+ */
+export interface ColumnCellConfig {
+    /** 单元格样式类 */
+    cellClass?: string;
+    /** 是否禁用表头过滤按钮 */
+    suppressHeaderFilterButton?: boolean;
+    /** 分组名称 */
+    groupName?: string;
+}
+/**
+ * 列单元格配置映射
+ */
+export type ColumnCellConfigMap = Record<string, ColumnCellConfig>;
+/**
+ * 请求参数
+ */
+export interface RequestParams {
+    /** 跳过的记录数 (分页用) */
+    skipCount: number;
+    /** 最大返回记录数 (分页用) */
+    maxResultCount: number;
+    /** 当前页码 */
+    current: number;
+    /** 排序字段 */
+    sort?: string;
+    /** 过滤器参数 */
+    filter?: any;
+    /** 额外的网格参数 */
+    [key: string]: any;
+}
+/**
+ * 请求响应
+ */
+export interface RequestResponse<T = any> {
+    /** 数据列表 */
+    items: T[];
+    /** 总记录数 */
+    totalCount: number;
+    /** 错误信息 (可选) */
+    error?: string;
+    /** 响应状态码 (可选) */
+    statusCode?: number;
+}
+/**
+ * 请求函数签名
+ */
+export type RequestFunction<T = any> = (params: RequestParams, sort: string | undefined, filter: any) => Promise<RequestResponse<T>>;
+/**
+ * 树形数据节点
+ */
+export interface TreeNode<T = any> {
+    /** 节点唯一标识 */
+    [key: string]: any;
+    /** 子节点数组 */
+    children?: TreeNode<T>[];
+}
+/**
+ * 树形数据配置
+ */
+export interface TreeDataConfig {
+    /** 树节点键名 (默认: "id") */
+    treeKeyName?: string;
+    /** 父节点键名 (默认: "parentId") */
+    treeParentName?: string;
+}
+/**
+ * 枚举值项
+ */
+export interface ValueEnumItem {
+    /** 枚举值 */
+    value: any;
+    /** 显示标签 */
+    label: string;
+    /** 标签颜色 (可选) */
+    color?: string;
+    /** 是否为默认值 (可选) */
+    default?: boolean;
+}
+/**
+ * 计算类型
+ */
+export type CalculationType = 'sum' | 'avg' | 'standardDeviation' | false;
+/**
+ * 扩展的列定义 (已在 interface.tsx 中定义为 AgGridColumnPropsClone)
+ * 此处提供类型引用和文档
+ */
+export interface ExtendedColDef extends ColDef {
+    /** 是否精确查询 */
+    exactQuery?: boolean;
+    /** 是否在表格中隐藏 */
+    hideInTable?: boolean;
+    /** 是否在搜索表单中隐藏 */
+    hideInSearch?: boolean;
+    /** 查询字段名 (不同于显示字段) */
+    queryField?: string;
+    /** 是否文本缩略显示并使用 tooltip */
+    ellipsis?: boolean;
+    /** 枚举值配置 */
+    valueEnum?: ValueEnumItem[];
+    /** 自定义搜索组件 */
+    searchComponent?: ReactNode | ((props: any) => JSX.Element);
+    /** 搜索组件属性 */
+    searchComponentProps?: any;
+    /** 搜索表单排序顺序 */
+    searchSort?: number;
+    /** 列计算类型 */
+    calculateType?: CalculationType;
+    /** 计算结果小数位数 (默认: 2) */
+    transactionAmount?: number;
+    /** 是否使用千分位格式化 */
+    formatWithCommas?: boolean;
+    /** 自定义单元格渲染器 (用于跳过计算) */
+    customCellRenderer?: (params: any) => any;
+}
+/**
+ * 扩展的列状态 (包含 AG-Grid 列状态 + 自定义属性)
+ */
+export interface ExtendedColumnState extends ColumnState {
+    /** 列字段名 */
+    field?: string;
+    /** 单元格样式类 */
+    cellClass?: string;
+    /** 是否禁用表头过滤按钮 */
+    suppressHeaderFilterButton?: boolean;
+    /** 分组名称 */
+    groupName?: string;
+    /** 其他自定义属性 */
+    [key: string]: any;
+}
+/**
+ * 工具栏渲染函数参数
+ */
+export interface ToolBarRenderParams {
+    /** Grid API 引用 */
+    gridApi?: GridApi;
+    /** 筛选字符串 */
+    filter?: string;
+    /** 查询过滤器对象 */
+    queryFilter?: QueryFilterState;
+    /** 分页信息 */
+    paginationInfo?: {
+        current: number;
+        skipCount: number;
+        maxResultCount: number;
+    };
+}
+/**
+ * 工具栏渲染函数签名
+ */
+export type ToolBarRenderFunction = (gridApi?: GridApi, filter?: string, queryFilter?: QueryFilterState, paginationInfo?: ToolBarRenderParams['paginationInfo']) => ReactNode[];
+/**
+ * 查询表单项
+ */
+export interface QueryFormItem {
+    /** 字段名 */
+    field: string;
+    /** 表头名称 */
+    headerName: string;
+    /** 排序顺序 */
+    order: number;
+    /** 是否精确查询 */
+    exactQuery?: boolean;
+    /** 搜索组件 */
+    searchComponent?: ReactNode | ((props: any) => JSX.Element);
+    /** 搜索组件属性 */
+    searchComponentProps?: any;
+    /** 枚举值 */
+    valueEnum?: ValueEnumItem[];
+    /** 其他扩展属性 */
+    [key: string]: any;
+}
+/**
+ * 查询表单带顺序的项 (继承自 querySchemes)
+ */
+export interface QueryFormItemWithOrder extends QueryFormItem {
+    /** 显示顺序 */
+    order: number;
+}
+/**
+ * Grid 引用方法
+ */
+export interface GridRefMethods {
+    /** 刷新数据 */
+    onRefresh: () => void;
+}
+/**
+ * 数据类型推断结果
+ */
+export interface DataTypeInference {
+    /** 数据类型 */
+    type: 'number' | 'string' | 'boolean' | 'date';
+    /** 计算类型 (仅对数值类型有效) */
+    calculateType?: CalculationType;
+}
+/**
+ * Grid 上下文值
+ */
+export interface GridPlusContextValue {
+    /** 查询方案管理器 */
+    querySchemeManager?: any;
+    /** 列配置方案管理器 */
+    columnSchemeManager?: any;
+    /** Grid API 引用 */
+    gridApi?: GridApi;
+    /** 是否就绪 */
+    ready: boolean;
+}
+/**
+ * 分页大小选项
+ */
+export type PageSizeOptions = number[];
+/**
+ * 默认分页配置
+ */
+export interface DefaultPaginationConfig {
+    /** 默认分页大小 */
+    pageSize: number;
+    /** 分页大小选项 */
+    pageSizeOptions: PageSizeOptions;
+    /** 隐藏分页时的默认大小 */
+    hidePaginationSize: number;
+}
+/**
+ * 选中行变化回调
+ */
+export type OnSelectedRowsChange = (selectedRows: any[]) => void;
+/**
+ * Grid 就绪回调
+ */
+export type OnGridReady = (params: {
+    api: GridApi;
+    columnApi?: any;
+}) => void;
+/**
+ * 方案变化回调
+ */
+export type OnSchemeChange<T> = (scheme: T | null) => void;
+/**
+ * 方案保存回调
+ */
+export type OnSchemeSave<T> = (scheme: T) => void;
+/**
+ * 方案删除回调
+ */
+export type OnSchemeDelete = (schemeId: string) => void;
+/**
+ * 可空类型
+ */
+export type Nullable<T> = T | null | undefined;
+/**
+ * 记录类型 (键值对)
+ */
+export type RecordType<K extends string | number | symbol = string, V = any> = Record<K, V>;
+/**
+ * 深度部分可选
+ */
+export type DeepPartial<T> = {
+    [P in keyof T]?: T[P] extends object ? DeepPartial<T[P]> : T[P];
+};
+/**
+ * 列定义数组类型
+ */
+export type ColumnDefs = ExtendedColDef[];
+/**
+ * 列状态数组类型
+ */
+export type ColumnStates = ExtendedColumnState[];
+/**
+ * 行数据数组类型
+ */
+export type RowDataArray<T = any> = T[];
+/**
+ * 查询表单项数组类型
+ */
+export type QueryFormItems = QueryFormItem[];

package/dist/cjs/ag-grid-plus/types.js

@@ -0,0 +1,5 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});

package/dist/cjs/ag-grid-plus/utils/columnProcessors.d.ts

@@ -0,0 +1,95 @@
+import { ColDef, ICellRendererParams } from 'ag-grid-community';
+/**
+ * 扩展的列状态接口
+ */
+export interface ExtendedColumnState {
+    field?: string;
+    cellClass?: string;
+    suppressHeaderFilterButton?: boolean;
+    groupName?: string;
+    [key: string]: any;
+}
+/**
+ * 列单元格配置映射
+ */
+export interface ColumnCellConfig {
+    cellClass?: string;
+    suppressHeaderFilterButton?: boolean;
+    groupName?: string;
+}
+/**
+ * 枚举值项
+ */
+export interface ValueEnumItem {
+    value: any;
+    label: string;
+    color?: string;
+    default?: boolean;
+}
+/**
+ * 数据类型推断结果
+ */
+export interface DataTypeInference {
+    type: 'number' | 'string' | 'boolean' | 'date';
+    calculateType?: 'sum' | 'avg' | 'standardDeviation' | false;
+}
+/**
+ * 处理列状态，提取单元格配置
+ *
+ * @param columnState 列状态数组
+ * @returns 字段到配置的映射
+ */
+export declare function handleGridPlusColumnState(columnState: ExtendedColumnState[]): Record<string, ColumnCellConfig>;
+/**
+ * 推断数据类型
+ *
+ * @param data 数据对象
+ * @param colName 列名
+ * @param valueEnum 枚举值
+ * @returns 数据类型推断结果
+ */
+export declare function inferDataType(data: any, colName: string, valueEnum?: ValueEnumItem[]): DataTypeInference | undefined;
+/**
+ * 处理枚举列定义
+ *
+ * @param col 原始列定义
+ * @param dataType 数据类型
+ * @returns 处理后的列定义
+ */
+export declare function processEnumColumn(col: any, dataType?: DataTypeInference): ColDef;
+/**
+ * 处理省略列定义
+ *
+ * @param col 原始列定义
+ * @returns 处理后的列定义
+ */
+export declare function processEllipsisColumn(col: any): ColDef;
+/**
+ * 创建自定义单元格渲染器包装
+ *
+ * @param customRenderer 自定义渲染器
+ * @returns 包装后的渲染器
+ */
+export declare function createCellRenderer(customRenderer: any): (params: ICellRendererParams) => any;
+/**
+ * 构建查询表单项
+ *
+ * @param colDefs 列定义数组
+ * @returns 查询表单项数组
+ */
+export declare function buildQueryFormItems(colDefs: any[]): any[];
+/**
+ * 应用列单元格配置
+ *
+ * @param columnDefs 列定义数组
+ * @param columnCellConfig 单元格配置映射
+ * @returns 应用配置后的列定义
+ */
+export declare function applyColumnCellConfig(columnDefs: any[], columnCellConfig: Record<string, ColumnCellConfig>): any[];
+/**
+ * 过滤隐藏列
+ *
+ * @param columnDefs 列定义数组
+ * @returns 过滤后的列定义
+ */
+export declare function filterHiddenColumns(columnDefs: any[]): any[];

package/dist/cjs/ag-grid-plus/utils/columnProcessors.js

@@ -0,0 +1,265 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.applyColumnCellConfig = applyColumnCellConfig;
+exports.buildQueryFormItems = buildQueryFormItems;
+exports.createCellRenderer = createCellRenderer;
+exports.filterHiddenColumns = filterHiddenColumns;
+exports.handleGridPlusColumnState = handleGridPlusColumnState;
+exports.inferDataType = inferDataType;
+exports.processEllipsisColumn = processEllipsisColumn;
+exports.processEnumColumn = processEnumColumn;
+var _isArray2 = _interopRequireDefault(require("lodash/isArray"));
+var _react = _interopRequireDefault(require("react"));
+var _antd = require("antd");
+var _antdV = require("@formily/antd-v5");
+var _constants = require("./constants");
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+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); }
+var Text = _antd.Typography.Text;
+
+/**
+ * 扩展的列状态接口
+ */
+
+/**
+ * 列单元格配置映射
+ */
+
+/**
+ * 枚举值项
+ */
+
+/**
+ * 数据类型推断结果
+ */
+
+/**
+ * 处理列状态，提取单元格配置
+ *
+ * @param columnState 列状态数组
+ * @returns 字段到配置的映射
+ */
+function handleGridPlusColumnState(columnState) {
+  var cellConfigMap = {};
+  if ((0, _isArray2.default)(columnState)) {
+    columnState.forEach(function (item) {
+      if (item.field && (item.cellClass || item.suppressHeaderFilterButton !== undefined || item.groupName)) {
+        cellConfigMap[item.field] = {
+          cellClass: item.cellClass,
+          suppressHeaderFilterButton: item.suppressHeaderFilterButton,
+          groupName: item.groupName
+        };
+      }
+    });
+  }
+  return cellConfigMap;
+}
+
+/**
+ * 推断数据类型
+ *
+ * @param data 数据对象
+ * @param colName 列名
+ * @param valueEnum 枚举值
+ * @returns 数据类型推断结果
+ */
+function inferDataType(data, colName, valueEnum) {
+  var value = data[colName];
+  if (typeof value === 'number') {
+    // 如果有枚举值，说明是分类数据，不进行计算
+    var shouldCalculate = !valueEnum || valueEnum.length === 0;
+    return {
+      type: 'number',
+      calculateType: shouldCalculate ? 'sum' : false
+    };
+  }
+  if (typeof value === 'boolean') {
+    return {
+      type: 'boolean',
+      calculateType: false
+    };
+  }
+  if (value instanceof Date) {
+    return {
+      type: 'date',
+      calculateType: false
+    };
+  }
+  return undefined;
+}
+
+/**
+ * 处理枚举列定义
+ *
+ * @param col 原始列定义
+ * @param dataType 数据类型
+ * @returns 处理后的列定义
+ */
+function processEnumColumn(col, dataType) {
+  var _defaultItems$0$value, _defaultItems$;
+  if (!col.valueEnum || !Array.isArray(col.valueEnum)) {
+    return col;
+  }
+
+  // 统计默认值
+  var defaultItems = col.valueEnum.filter(function (item) {
+    return item.default;
+  });
+  var isMultiple = defaultItems.length > 1;
+  var defaultValue = isMultiple ? defaultItems.map(function (item) {
+    return item.value;
+  }) : (_defaultItems$0$value = (_defaultItems$ = defaultItems[0]) === null || _defaultItems$ === void 0 ? void 0 : _defaultItems$.value) !== null && _defaultItems$0$value !== void 0 ? _defaultItems$0$value : undefined;
+
+  // 值格式化函数
+  var valueFormatter = function valueFormatter(params) {
+    var match = col.valueEnum.find(function (item) {
+      return item.value == params.value;
+    });
+    return match ? match.label : params.value;
+  };
+  return _objectSpread(_objectSpread(_objectSpread({}, dataType), col), {}, {
+    cellRenderer: function cellRenderer(params) {
+      var match = col.valueEnum.find(function (item) {
+        return item.value == params.value;
+      });
+      if (match) {
+        var color = match.color || '#ffffff';
+        return /*#__PURE__*/_react.default.createElement("span", {
+          style: {
+            color: color,
+            backgroundColor: 'transparent',
+            fontWeight: 500
+          }
+        }, match.label);
+      }
+      return params.value;
+    },
+    filterParams: _objectSpread(_objectSpread({}, col.filterParams || {}), {}, {
+      valueFormatter: valueFormatter
+    }),
+    searchComponent: _antdV.Select,
+    searchComponentProps: {
+      options: col.valueEnum.map(function (item) {
+        return {
+          label: item.label,
+          value: item.value
+        };
+      }),
+      mode: isMultiple ? 'multiple' : undefined,
+      defaultValue: defaultValue
+    }
+  });
+}
+
+/**
+ * 处理省略列定义
+ *
+ * @param col 原始列定义
+ * @returns 处理后的列定义
+ */
+function processEllipsisColumn(col) {
+  if (!col.ellipsis) {
+    return col;
+  }
+  return _objectSpread(_objectSpread({}, col), {}, {
+    cellRenderer: function cellRenderer(_ref) {
+      var value = _ref.value;
+      return /*#__PURE__*/_react.default.createElement(Text, {
+        ellipsis: {
+          tooltip: value
+        },
+        style: {
+          display: 'flex',
+          justifyContent: 'center',
+          alignItems: 'center'
+        }
+      }, value);
+    }
+  });
+}
+
+/**
+ * 创建自定义单元格渲染器包装
+ *
+ * @param customRenderer 自定义渲染器
+ * @returns 包装后的渲染器
+ */
+function createCellRenderer(customRenderer) {
+  return function (params) {
+    var value = params.value,
+      node = params.node,
+      colDef = params.colDef;
+
+    // 固定行或没有自定义渲染器时，直接返回值
+    if (node.isRowPinned() || !colDef.customCellRenderer) {
+      return value;
+    }
+
+    // 使用自定义渲染器
+    return colDef.customCellRenderer(params);
+  };
+}
+
+/**
+ * 构建查询表单项
+ *
+ * @param colDefs 列定义数组
+ * @returns 查询表单项数组
+ */
+function buildQueryFormItems(colDefs) {
+  return colDefs.filter(function (col) {
+    return col.filter !== false && !col.hideInSearch;
+  }).map(function (col) {
+    var _col$queryField, _col$searchSort;
+    return _objectSpread({
+      field: (_col$queryField = col.queryField) !== null && _col$queryField !== void 0 ? _col$queryField : col.field,
+      headerName: col.headerName,
+      order: (_col$searchSort = col.searchSort) !== null && _col$searchSort !== void 0 ? _col$searchSort : _constants.DEFAULT_SEARCH_SORT_ORDER
+    }, col);
+  });
+}
+
+/**
+ * 应用列单元格配置
+ *
+ * @param columnDefs 列定义数组
+ * @param columnCellConfig 单元格配置映射
+ * @returns 应用配置后的列定义
+ */
+function applyColumnCellConfig(columnDefs, columnCellConfig) {
+  return columnDefs.map(function (colDef) {
+    var cellConfig = columnCellConfig[colDef.field];
+    if (cellConfig) {
+      if (cellConfig.cellClass) {
+        colDef.cellClass = cellConfig.cellClass;
+      }
+      if (cellConfig.groupName) {
+        colDef.groupName = cellConfig.groupName;
+      }
+      if (cellConfig.suppressHeaderFilterButton !== undefined) {
+        colDef.suppressHeaderFilterButton = !cellConfig.suppressHeaderFilterButton;
+      }
+    }
+    return colDef;
+  });
+}
+
+/**
+ * 过滤隐藏列
+ *
+ * @param columnDefs 列定义数组
+ * @returns 过滤后的列定义
+ */
+function filterHiddenColumns(columnDefs) {
+  return columnDefs.filter(function (col) {
+    return !col.hideInTable;
+  });
+}

package/dist/cjs/ag-grid-plus/utils/constants.d.ts

@@ -0,0 +1,41 @@
+/**
+ * AG-Grid Plus 常量定义
+ */
+/**
+ * 列状态应用延迟（毫秒）
+ * AG-Grid 需要延迟应用列状态以确保 DOM 已就绪
+ */
+export declare const COLUMN_STATE_APPLY_DELAY = 10;
+/**
+ * 默认查询表单排序顺序
+ * 用于未指定 searchSort 的列
+ */
+export declare const DEFAULT_SEARCH_SORT_ORDER = 999;
+/**
+ * 默认分页大小选项
+ */
+export declare const DEFAULT_PAGE_SIZE_OPTIONS: number[];
+/**
+ * 默认分页大小
+ */
+export declare const DEFAULT_PAGE_SIZE = 200;
+/**
+ * 隐藏分页时的默认分页大小
+ */
+export declare const DEFAULT_PAGE_SIZE_WHEN_HIDDEN = 10000;
+/**
+ * 计算列默认小数位数
+ */
+export declare const DEFAULT_DECIMAL_PLACES = 2;
+/**
+ * 空数据默认提示文本
+ */
+export declare const DEFAULT_EMPTY_TEXT = "\u6CA1\u6709\u627E\u5230\u6570\u636E\uFF0C\u8BD5\u8BD5\u8C03\u6574\u7B5B\u9009\u6761\u4EF6\u5427\uFF01";
+/**
+ * 请求防抖延迟（毫秒）
+ */
+export declare const REQUEST_DEBOUNCE_DELAY = 300;
+/**
+ * 列配置保存防抖延迟（毫秒）
+ */
+export declare const COLUMN_STATE_SAVE_DEBOUNCE_DELAY = 300;