@nokecy/qc-ui-components 0.0.0-stage → 2.0.0-beta.0

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

@@ -0,0 +1,335 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.QC_GRID_ONLY_PROPS = exports.QC_COL_DEF_ONLY_PROPS = exports.QC_COL_DEF_CONTEXT_KEY = void 0;
+exports.createRowIdResolver = createRowIdResolver;
+exports.getQcColDefProp = getQcColDefProp;
+exports.pickLegacySelectionOptions = pickLegacySelectionOptions;
+exports.resolveLegacySelectionOptions = resolveLegacySelectionOptions;
+exports.restoreQcColDef = restoreQcColDef;
+exports.sanitizeColDefs = sanitizeColDefs;
+exports.sanitizeGridOptions = sanitizeGridOptions;
+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 _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 _toConsumableArray(arr) { return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableSpread(); }
+function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _iterableToArray(iter) { if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter); }
+function _arrayWithoutHoles(arr) { if (Array.isArray(arr)) return _arrayLikeToArray(arr); }
+function _createForOfIteratorHelper(o, allowArrayLike) { var it = typeof Symbol !== "undefined" && o[Symbol.iterator] || o["@@iterator"]; if (!it) { if (Array.isArray(o) || (it = _unsupportedIterableToArray(o)) || allowArrayLike && o && typeof o.length === "number") { if (it) o = it; var i = 0; var F = function F() {}; return { s: F, n: function n() { if (i >= o.length) return { done: true }; return { done: false, value: o[i++] }; }, e: function e(_e) { throw _e; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var normalCompletion = true, didErr = false, err; return { s: function s() { it = it.call(o); }, n: function n() { var step = it.next(); normalCompletion = step.done; return step; }, e: function e(_e2) { didErr = true; err = _e2; }, f: function f() { try { if (!normalCompletion && it.return != null) it.return(); } finally { if (didErr) throw err; } } }; }
+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 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 _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); }
+/**
+ * AgGridPlus 与 AG-Grid 33 之间的兼容层（纯函数，无 React 依赖）。
+ *
+ * 1. qc-ui 专属 colDef / gridOptions 属性在传给 AG-Grid 之前集中剥离，否则 AG-Grid 会在控制台报
+ *    「invalid colDef / gridOptions property」。colDef 上的专属属性收进 `colDef.context[QC_COL_DEF_CONTEXT_KEY]`，
+ *    qc-ui 内部需要时通过 `getQcColDefProp` / `restoreQcColDef` 读回（renderDefaultCell、查询表单等）。
+ * 2. 调用方传入的 v32.2 以前的选择类旧选项映射为 v33 对象 API（rowSelection / cellSelection），业务写法保持有效。
+ * 3. getRowId 一律返回字符串（AG-Grid error #25），同一个解析器也供选中行比对使用，保证类型一致。
+ *
+ * 新增 qc-ui 专属属性时只需改下面两份清单。
+ *
+ * @author nokecy
+ */
+
+/** colDef.context 中存放被剥离的 qc-ui 专属列属性的键 */
+var QC_COL_DEF_CONTEXT_KEY = exports.QC_COL_DEF_CONTEXT_KEY = '__qc';
+
+/**
+ * qc-ui 专属 colDef 属性清单（AG-Grid 不认识）。
+ * 注意：`fixed` / `pinned` 不在此列——列固定的别名处理不属于本层。
+ */
+var QC_COL_DEF_ONLY_PROPS = exports.QC_COL_DEF_ONLY_PROPS = ['exactQuery', 'hideInTable', 'hideInSearch', 'queryField', 'queryDatePrecision', 'ellipsis', 'valueEnum', 'enumFallbackRenderer', 'searchComponent', 'searchComponentProps', 'searchSort', 'enum', 'calculateType', 'transactionAmount', 'formatWithCommas', 'customCellRenderer', 'align', 'dataIndex', 'groupName'];
+
+/** 已废弃、由 {@link resolveLegacySelectionOptions} 映射到 rowSelection 的列选择标志 */
+var LEGACY_COL_DEF_SELECTION_PROPS = ['checkboxSelection', 'headerCheckboxSelection', 'headerCheckboxSelectionFilteredOnly', 'headerCheckboxSelectionCurrentPageOnly', 'showDisabledCheckboxes'];
+
+/**
+ * qc-ui 专属 gridOptions 清单（AgGridPlus 自己消费，或历史文档遗留的无内部用途属性）。
+ * `enableQuerySchemes`、`defaultToolbarSlot` 目前没有内部消费者，仅为兼容旧写法而吞掉。
+ */
+var QC_GRID_ONLY_PROPS = exports.QC_GRID_ONLY_PROPS = ['pageSizeOptions', 'pageSize', 'hidePagination', 'gridColumnState', 'initParams', 'onError', 'onRefresh', 'enableQuerySchemes', 'defaultToolbarSlot'];
+/** 剥离单个 colDef（含分组 children）；没有可剥离内容时返回原引用 */
+function sanitizeColDef(def) {
+  var _out2;
+  if (!def || _typeof(def) !== 'object') return def;
+  var src = def;
+  var out;
+  var qc;
+  var ensureCopy = function ensureCopy() {
+    var _out;
+    return (_out = out) !== null && _out !== void 0 ? _out : out = _objectSpread({}, src);
+  };
+  var _iterator = _createForOfIteratorHelper(QC_COL_DEF_ONLY_PROPS),
+    _step;
+  try {
+    for (_iterator.s(); !(_step = _iterator.n()).done;) {
+      var _qc;
+      var key = _step.value;
+      if (!(key in src)) continue;
+      ensureCopy();
+      delete out[key];
+      if (src[key] !== undefined) ((_qc = qc) !== null && _qc !== void 0 ? _qc : qc = {})[key] = src[key];
+    }
+  } catch (err) {
+    _iterator.e(err);
+  } finally {
+    _iterator.f();
+  }
+  var _iterator2 = _createForOfIteratorHelper(LEGACY_COL_DEF_SELECTION_PROPS),
+    _step2;
+  try {
+    for (_iterator2.s(); !(_step2 = _iterator2.n()).done;) {
+      var _key = _step2.value;
+      if (!(_key in src)) continue;
+      ensureCopy();
+      delete out[_key];
+    }
+  } catch (err) {
+    _iterator2.e(err);
+  } finally {
+    _iterator2.f();
+  }
+  if (Array.isArray(src.children)) {
+    var children = src.children.map(sanitizeColDef);
+    if (children.some(function (child, i) {
+      return child !== src.children[i];
+    })) ensureCopy().children = children;
+  }
+  if (qc) {
+    var _src$context;
+    ensureCopy().context = _objectSpread(_objectSpread({}, src.context), {}, _defineProperty({}, QC_COL_DEF_CONTEXT_KEY, _objectSpread(_objectSpread({}, (_src$context = src.context) === null || _src$context === void 0 ? void 0 : _src$context[QC_COL_DEF_CONTEXT_KEY]), qc)));
+  }
+  return (_out2 = out) !== null && _out2 !== void 0 ? _out2 : src;
+}
+
+/** 剥离一组列定义中的 qc-ui 专属属性（幂等） */
+function sanitizeColDefs(defs) {
+  if (!Array.isArray(defs)) return defs;
+  var next = defs.map(sanitizeColDef);
+  return next.some(function (d, i) {
+    return d !== defs[i];
+  }) ? next : defs;
+}
+
+/** 读取列上的 qc-ui 专属属性：先看顶层（未净化的定义），再看 context（已净化的定义） */
+function getQcColDefProp(colDef, key) {
+  var _colDef$key, _colDef$context;
+  if (!colDef) return undefined;
+  return (_colDef$key = colDef[key]) !== null && _colDef$key !== void 0 ? _colDef$key : (_colDef$context = colDef.context) === null || _colDef$context === void 0 || (_colDef$context = _colDef$context[QC_COL_DEF_CONTEXT_KEY]) === null || _colDef$context === void 0 ? void 0 : _colDef$context[key];
+}
+
+/** 把 context 里的专属属性还原到顶层，供查询表单等只认顶层字段的内部代码使用 */
+function restoreQcColDef(colDef) {
+  var _colDef$context2;
+  var qc = colDef === null || colDef === void 0 || (_colDef$context2 = colDef.context) === null || _colDef$context2 === void 0 ? void 0 : _colDef$context2[QC_COL_DEF_CONTEXT_KEY];
+  return qc ? _objectSpread(_objectSpread({}, colDef), qc) : colDef;
+}
+
+/** 剥离 gridOptions 层的 qc-ui 专属属性 */
+function sanitizeGridOptions(options) {
+  var out = _objectSpread({}, options);
+  var _iterator3 = _createForOfIteratorHelper(QC_GRID_ONLY_PROPS),
+    _step3;
+  try {
+    for (_iterator3.s(); !(_step3 = _iterator3.n()).done;) {
+      var key = _step3.value;
+      delete out[key];
+    }
+  } catch (err) {
+    _iterator3.e(err);
+  } finally {
+    _iterator3.f();
+  }
+  return out;
+}
+
+/**
+ * 创建 getRowId 解析器：返回值一律转字符串；用户函数返回 null/undefined 时回退默认生成，
+ * 避免出现 "undefined" / "null" 这类重复 ID。选中行比对与 AG-Grid 共用它，类型天然一致。
+ */
+function createRowIdResolver(userGetRowId, fallback) {
+  return function (params) {
+    var raw = userGetRowId ? userGetRowId(params) : undefined;
+    return raw === undefined || raw === null ? String(fallback(params)) : String(raw);
+  };
+}
+var LEGACY_SELECTION_GRID_KEYS = ['enableRangeSelection', 'enableRangeHandle', 'enableFillHandle', 'suppressMultiRangeSelection', 'fillHandleDirection', 'fillOperation', 'suppressClearOnFillReduction', 'suppressCopyRowsToClipboard', 'suppressRowClickSelection', 'suppressRowDeselection', 'rowMultiSelectWithClick', 'groupSelectsChildren', 'groupSelectsFiltered', 'isRowSelectable'];
+var LEGACY_EVENT_RENAMES = {
+  onRangeSelectionChanged: 'onCellSelectionChanged',
+  onRangeDeleteStart: 'onCellSelectionDeleteStart',
+  onRangeDeleteEnd: 'onCellSelectionDeleteEnd'
+};
+
+/** 从透传 props 中挑出旧版选择选项（体积很小，便于做深比较稳定引用） */
+function pickLegacySelectionOptions(props) {
+  var out = {};
+  for (var _i = 0, _arr = [].concat(LEGACY_SELECTION_GRID_KEYS, _toConsumableArray(Object.keys(LEGACY_EVENT_RENAMES))); _i < _arr.length; _i++) {
+    var key = _arr[_i];
+    if (key in props) out[key] = props[key];
+  }
+  return out;
+}
+
+/** 汇总一组列定义（含分组 children）上的旧选择标志 */
+function collectColDefSelectionFlags(defs) {
+  var flags = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
+  if (!Array.isArray(defs)) return flags;
+  var _iterator4 = _createForOfIteratorHelper(defs),
+    _step4;
+  try {
+    for (_iterator4.s(); !(_step4 = _iterator4.n()).done;) {
+      var def = _step4.value;
+      if (!def || _typeof(def) !== 'object') continue;
+      if (def.checkboxSelection && flags.checkboxSelection === undefined) flags.checkboxSelection = def.checkboxSelection;
+      if (def.headerCheckboxSelection) flags.headerCheckboxSelection = true;
+      if (def.headerCheckboxSelectionFilteredOnly) flags.headerCheckboxSelectionFilteredOnly = true;
+      if (def.headerCheckboxSelectionCurrentPageOnly) flags.headerCheckboxSelectionCurrentPageOnly = true;
+      if (def.showDisabledCheckboxes) flags.showDisabledCheckboxes = true;
+      collectColDefSelectionFlags(def.children, flags);
+    }
+  } catch (err) {
+    _iterator4.e(err);
+  } finally {
+    _iterator4.f();
+  }
+  return flags;
+}
+
+/**
+ * 把组件的选择相关输入（rowSelection 字符串/对象、enableClickSelection、旧版 gridOptions / colDef 选项）
+ * 统一解析成 AG-Grid 33 的 rowSelection 对象与 cellSelection。用户在对象里显式写的值优先于旧选项。
+ */
+function resolveLegacySelectionOptions(input) {
+  var _ref, _input$enableClickSel;
+  var legacy = input.legacy,
+    propsRowSelection = input.rowSelection;
+  var consumed = LEGACY_SELECTION_GRID_KEYS.filter(function (k) {
+    return k in legacy;
+  });
+
+  // ---- 点击选择 ----
+  var legacyClick = legacy.suppressRowClickSelection ? false : legacy.suppressRowDeselection ? 'enableSelection' : undefined;
+  var clickSelection = (_ref = (_input$enableClickSel = input.enableClickSelection) !== null && _input$enableClickSel !== void 0 ? _input$enableClickSel : legacyClick) !== null && _ref !== void 0 ? _ref : true;
+
+  // ---- 基础对象 ----
+  var rowSelection;
+  if (propsRowSelection && _typeof(propsRowSelection) === 'object') {
+    rowSelection = _objectSpread({}, propsRowSelection);
+    if (rowSelection.enableClickSelection === undefined) {
+      rowSelection.enableClickSelection = clickSelection;
+      rowSelection.enableSelectionWithoutKeys = clickSelection !== false && rowSelection.mode !== 'singleRow';
+    }
+  } else if (propsRowSelection) {
+    var isMulti = propsRowSelection !== 'single';
+    rowSelection = {
+      mode: isMulti ? 'multiRow' : 'singleRow',
+      enableClickSelection: clickSelection,
+      enableSelectionWithoutKeys: isMulti && clickSelection !== false
+    };
+  } else {
+    rowSelection = {
+      mode: 'singleRow',
+      enableClickSelection: clickSelection
+    };
+  }
+  var isMultiRow = rowSelection.mode === 'multiRow';
+  var fill = function fill(key, value) {
+    if (value !== undefined && rowSelection[key] === undefined) rowSelection[key] = value;
+  };
+
+  // ---- gridOptions 旧选项 ----
+  fill('isRowSelectable', legacy.isRowSelectable);
+  if (legacy.rowMultiSelectWithClick) fill('enableSelectionWithoutKeys', true);
+  if (isMultiRow) fill('groupSelects', legacy.groupSelectsFiltered ? 'filteredDescendants' : legacy.groupSelectsChildren ? 'descendants' : undefined);
+  // 旧默认即「不复制整行」，与 v33 copySelectedRows 默认值一致；只有显式 false 才需要开启
+  if (legacy.suppressCopyRowsToClipboard === false) fill('copySelectedRows', true);
+
+  // ---- colDef 旧选择标志 ----
+  var colFlags = collectColDefSelectionFlags(input.columnDefs);
+  fill('checkboxes', colFlags.checkboxSelection);
+  if (isMultiRow) {
+    fill('headerCheckbox', colFlags.headerCheckboxSelection ? true : undefined);
+    fill('selectAll', colFlags.headerCheckboxSelectionFilteredOnly ? 'filtered' : colFlags.headerCheckboxSelectionCurrentPageOnly ? 'currentPage' : undefined);
+  }
+  fill('hideDisabledCheckboxes', colFlags.showDisabledCheckboxes ? false : undefined);
+
+  // ---- autoGroupColumnDef（树形）上的旧复选框 ----
+  var autoGroupColumnDef = input.autoGroupColumnDef;
+  if (autoGroupColumnDef) {
+    var g = autoGroupColumnDef;
+    // 不映射成 checkboxLocation: 'autoGroupColumn'：qc-ui 的树形分组列用自定义渲染器（CustomGroupCellRenderer），
+    // 不渲染 AG-Grid 内置的分组复选框；复选框统一由选择列（selectionColumn）承担。
+    if (g.checkboxSelection) fill('checkboxes', g.checkboxSelection);
+    if (isMultiRow && g.headerCheckboxSelection) fill('headerCheckbox', true);
+    if (isMultiRow) fill('selectAll', g.headerCheckboxSelectionFilteredOnly ? 'filtered' : g.headerCheckboxSelectionCurrentPageOnly ? 'currentPage' : undefined);
+    if (LEGACY_COL_DEF_SELECTION_PROPS.some(function (k) {
+      return k in g;
+    })) {
+      autoGroupColumnDef = _objectSpread({}, g);
+      var _iterator5 = _createForOfIteratorHelper(LEGACY_COL_DEF_SELECTION_PROPS),
+        _step5;
+      try {
+        for (_iterator5.s(); !(_step5 = _iterator5.n()).done;) {
+          var k = _step5.value;
+          delete autoGroupColumnDef[k];
+        }
+      } catch (err) {
+        _iterator5.e(err);
+      } finally {
+        _iterator5.f();
+      }
+    }
+  }
+
+  // ---- 单元格范围选择 ----
+  // 历史行为：AgGridPlus 固定开启范围选择，调用方的 enableRangeSelection 取值不起作用，这里保持开启。
+  var cellSelection = true;
+  var cell = {};
+  if (legacy.suppressMultiRangeSelection) cell.suppressMultiRanges = true;
+  if (legacy.enableFillHandle) {
+    cell.handle = _objectSpread(_objectSpread(_objectSpread({
+      mode: 'fill'
+    }, legacy.fillHandleDirection ? {
+      direction: legacy.fillHandleDirection
+    } : {}), legacy.fillOperation ? {
+      setFillValue: legacy.fillOperation
+    } : {}), legacy.suppressClearOnFillReduction ? {
+      suppressClearOnFillReduction: true
+    } : {});
+  } else if (legacy.enableRangeHandle) {
+    cell.handle = {
+      mode: 'range'
+    };
+  }
+  if (Object.keys(cell).length > 0) cellSelection = cell;
+
+  // ---- 旧事件名 ----
+  var eventHandlers = {};
+  for (var _i2 = 0, _Object$entries = Object.entries(LEGACY_EVENT_RENAMES); _i2 < _Object$entries.length; _i2++) {
+    var _Object$entries$_i = _slicedToArray(_Object$entries[_i2], 2),
+      oldName = _Object$entries$_i[0],
+      newName = _Object$entries$_i[1];
+    if (oldName in legacy) {
+      consumed.push(oldName);
+      if (legacy[oldName] && legacy[newName] === undefined) eventHandlers[newName] = legacy[oldName];
+    }
+  }
+  return {
+    rowSelection: rowSelection,
+    cellSelection: cellSelection,
+    autoGroupColumnDef: autoGroupColumnDef,
+    eventHandlers: eventHandlers,
+    consumedLegacyKeys: consumed
+  };
+}

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

@@ -0,0 +1,27 @@
+/**
+ * AG-Grid 底部汇总聚合纯函数(从 ag-gridPlus.tsx 抽出,行为原样)。
+ * @author nokecy
+ */
+export interface CalculationColumnConfig {
+    field: string;
+    calculateType: 'sum' | 'avg' | 'standardDeviation';
+    transactionAmount?: number;
+    formatWithCommas?: boolean;
+    cellRenderer?: any;
+}
+export interface CalculationColumnDefinition {
+    field?: string;
+    calculateType?: CalculationColumnConfig['calculateType'] | false;
+    transactionAmount?: number;
+    formatWithCommas?: boolean;
+    children?: CalculationColumnDefinition[];
+}
+/** 分组表头只是展示结构；原生固定合计行要读取所有叶子数值列。@author nokecy */
+export declare const getCalculationColumns: (columns: CalculationColumnDefinition[]) => CalculationColumnConfig[];
+/** 精确数值字符串参与汇总；空值、非法文本及非有限数字跳过。@author nokecy */
+export declare const isValidNumber: (value: any) => boolean;
+export declare const sumField: (field: string, data: any[]) => number | string;
+export declare const avgField: (field: string, data: any[]) => number | string;
+export declare const stdDevField: (field: string, data: any[]) => number | string;
+export declare const formatWithCommas: (value: number | string, places?: number) => string;
+export declare const computeAggregationRow: (calcColFields: CalculationColumnConfig[], data: any[]) => any[];

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

@@ -0,0 +1,125 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.sumField = exports.stdDevField = exports.isValidNumber = exports.getCalculationColumns = exports.formatWithCommas = exports.computeAggregationRow = exports.avgField = void 0;
+var _lodash = require("lodash");
+var _businessDecimal = require("../../shared/businessDecimal");
+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; }
+/**
+ * AG-Grid 底部汇总聚合纯函数(从 ag-gridPlus.tsx 抽出,行为原样)。
+ * @author nokecy
+ */
+
+/** 分组表头只是展示结构；原生固定合计行要读取所有叶子数值列。@author nokecy */
+var getCalculationColumns = exports.getCalculationColumns = function getCalculationColumns(columns) {
+  return columns.flatMap(function (column) {
+    if (column.children) return getCalculationColumns(column.children);
+    if (!column.field || !column.calculateType) return [];
+    return [{
+      field: column.field,
+      calculateType: column.calculateType,
+      transactionAmount: column.transactionAmount,
+      formatWithCommas: column.formatWithCommas
+    }];
+  });
+};
+
+/** 精确数值字符串参与汇总；空值、非法文本及非有限数字跳过。@author nokecy */
+var isValidNumber = exports.isValidNumber = function isValidNumber(value) {
+  return typeof value === 'number' && Number.isFinite(value) || typeof value === 'string' && /^[+-]?(?:\d+(?:\.\d*)?|\.\d+)(?:[eE][+-]?\d+)?$/.test(value);
+};
+var valuesOf = function valuesOf(field, data) {
+  return data.filter(function (row) {
+    return row && isValidNumber(row[field]);
+  }).map(function (row) {
+    return row[field];
+  });
+};
+var resultOf = function resultOf(value, values) {
+  return values.some(function (value) {
+    return typeof value === 'string';
+  }) ? value.toFixed() : value.toNumber();
+};
+var sumField = exports.sumField = function sumField(field, data) {
+  var values = valuesOf(field, data);
+  return resultOf(values.reduce(function (sum, value) {
+    return sum.plus(value);
+  }, new _businessDecimal.BusinessDecimal(0)), values);
+};
+var avgField = exports.avgField = function avgField(field, data) {
+  var values = valuesOf(field, data);
+  return values.length ? resultOf(new _businessDecimal.BusinessDecimal(sumField(field, data)).div(values.length), values) : 0;
+};
+var stdDevField = exports.stdDevField = function stdDevField(field, data) {
+  var values = valuesOf(field, data);
+  if (!values.length) return 0;
+  var mean = new _businessDecimal.BusinessDecimal(sumField(field, data)).div(values.length);
+  var variance = values.reduce(function (sum, value) {
+    return sum.plus(new _businessDecimal.BusinessDecimal(value).minus(mean).pow(2));
+  }, new _businessDecimal.BusinessDecimal(0)).div(values.length);
+  return resultOf(variance.sqrt(), values);
+};
+var formatWithCommas = exports.formatWithCommas = function formatWithCommas(value) {
+  var places = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 2;
+  var _Exact$toFixed$split = new _businessDecimal.BusinessDecimal(value).toFixed(places).split('.'),
+    _Exact$toFixed$split2 = _slicedToArray(_Exact$toFixed$split, 2),
+    whole = _Exact$toFixed$split2[0],
+    fraction = _Exact$toFixed$split2[1];
+  return whole.replace(/\B(?=(\d{3})+(?!\d))/g, ',') + (fraction === undefined ? '' : '.' + fraction);
+};
+var roundedResult = function roundedResult(value, places) {
+  return typeof value === 'string' ? new _businessDecimal.BusinessDecimal(value).toDecimalPlaces(places).toFixed() : new _businessDecimal.BusinessDecimal(value).toDecimalPlaces(places).toNumber();
+};
+
+/** 精确接口默认保留十位小数；数值型兼容原有两位规则。@author nokecy */
+var precisionOf = function precisionOf(column, value) {
+  var _column$transactionAm;
+  return (_column$transactionAm = column.transactionAmount) !== null && _column$transactionAm !== void 0 ? _column$transactionAm : typeof value === 'string' ? 10 : 2;
+};
+
+// sum 求和 / avg 平均值 / standardDeviation 标准差
+var computeAggregationRow = exports.computeAggregationRow = function computeAggregationRow(calcColFields, data) {
+  var calculateArrCopy = [];
+  var calculateData = {
+    id: (0, _lodash.uniqueId)()
+  };
+  calcColFields.forEach(function (i) {
+    if (!i.cellRenderer) {
+      switch (i.calculateType) {
+        case 'sum':
+          {
+            var total = sumField(i.field, data);
+            var sumPrecision = precisionOf(i, total);
+            var sumValue = roundedResult(total, sumPrecision);
+            calculateData[i.field] = i.formatWithCommas ? formatWithCommas(sumValue, sumPrecision) : sumValue;
+            break;
+          }
+        case 'avg':
+          {
+            var average = avgField(i.field, data);
+            calculateData[i.field] = roundedResult(average, precisionOf(i, average));
+            break;
+          }
+        case 'standardDeviation':
+          {
+            var deviation = stdDevField(i.field, data);
+            calculateData[i.field] = roundedResult(deviation, precisionOf(i, deviation));
+            break;
+          }
+        default:
+          break;
+      }
+    }
+  });
+  if (Object.keys(calculateData).length > 0) {
+    calculateArrCopy.push(calculateData);
+  }
+  return calculateArrCopy;
+};

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

@@ -0,0 +1,137 @@
+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;
+/**
+ * 把「推断出的数据类型」翻译成列定义片段。
+ *
+ * dataType.type 是数据类型（number/string/...），不是 AG Grid 的列类型（columnTypes）。
+ * 早先是把整个 dataType 摊进 colDef，等于给列设了 type:"number"——而注册的 columnTypes 里
+ * 根本没有叫 number 的类型，这个字段一直没生效。
+ *
+ * 普通数值列右对齐；合计另由 calculateType 显式控制。
+ * 用 valueEnum 表示分类的数值列（状态码之类）不动。
+ *
+ * @author nokecy
+ */
+export declare function toColumnType(dataType?: DataTypeInference): {
+    calculateType?: any;
+    type?: string;
+};
+/** 显式列类型只控制显示方式，不遮蔽数值对齐或显式合计配置。@author nokecy */
+export declare function mergeInferredColumnType<T extends object>(column: T, dataType?: DataTypeInference): T & ReturnType<typeof toColumnType>;
+/**
+ * 处理枚举列定义 —— **枚举列渲染的唯一实现**。
+ *
+ * `cellRenderer` 必须在 `...col` 展开**之后**写入：否则业务传入的 `cellRenderer` 会把枚举映射盖掉，
+ * 列退回原始码；反过来，业务也无法靠自己的 `cellRenderer` 接管枚举列（这正是本函数的职责边界）。
+ *
+ * 命中枚举项：按 `match.color` 上色。`color` 是 **CSS 颜色**，语义档名（`success` 等）不是合法 CSS，
+ * 会被浏览器静默忽略、整列退回正文色 —— 消费方需用 `gridValueEnum()` 之类适配层先转成色值。
+ *
+ * **未命中枚举**（`null` / `undefined` / 空串 / 后端新增了码值而前端枚举未跟上）：
+ * - 列上配了 `enumFallbackRenderer` → 交给它渲染。业务侧据此输出中性「—」/「未知（原码）」，
+ *   不必再改壳；
+ * - 没配 → 原样返回该值（历史行为，保持向后兼容）。
+ *
+ * @param col 原始列定义
+ * @param dataType 数据类型（决定是否右对齐，见 {@link toColumnType}）
+ * @param background 单元格底色（hex）。传入则把枚举颜色压/提到够读的对比度；不传则 color 原样输出
+ * @returns 处理后的列定义
+ * @author nokecy
+ */
+export declare function processEnumColumn(col: any, dataType?: DataTypeInference, background?: string): ColDef;
+/**
+ * 处理省略列定义
+ *
+ * @param col 原始列定义
+ * @returns 处理后的列定义
+ */
+export declare function processEllipsisColumn(col: any): ColDef;
+/**
+ * 默认单元格渲染：固定行（合计等）显示原值；数据行有自定义渲染器（`customCellRenderer`）时交给它；
+ * 否则显示 `valueFormatted`（列上配了 `valueFormatter` 时由 AG Grid 算好），没配则显示原值。
+ *
+ * 以前这里直接返回 `params.value`，普通列（没有 `type`、没有自定义渲染器）上写的 `valueFormatter`
+ * 被绕过：状态码列显示原码、「0/1」列显示 0/1，而不是格式化后的文字。
+ * 固定行保持原行为：格式化函数多按数据行写，空值常被格式化成「—」，不能让合计行冒出占位符。
+ *
+ * @author nokecy
+ */
+export declare function renderDefaultCell(params: ICellRendererParams): any;
+/**
+ * 创建自定义单元格渲染器包装
+ *
+ * @param _customRenderer 保留参数，实际取列上的 `customCellRenderer`
+ * @returns 包装后的渲染器
+ */
+export declare function createCellRenderer(_customRenderer?: any): typeof renderDefaultCell;
+/**
+ * 构建查询表单项
+ *
+ * @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[];