@nokecy/qc-ui 1.1.57 → 1.1.59

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

@@ -441,11 +441,10 @@ function AgGridPlus(props) {
   // 辅助函数: 获取数据类型
   var getDataType = function getDataType(data, colName, valueEnum) {
     if (typeof data[colName] === 'number') {
-      // 如果有枚举值，说明是分类数据，不进行计算;否则默认求和
-      var shouldCalculate = !valueEnum || valueEnum.length === 0;
+      // 数值只用于列对齐；底部合计必须由 calculateType 显式声明。@author nokecy
       return {
         type: "number",
-        calculateType: shouldCalculate ? "sum" : false
+        calculateType: valueEnum !== null && valueEnum !== void 0 && valueEnum.length ? false : undefined
       };
     }
     return undefined;
@@ -473,11 +472,11 @@ function AgGridPlus(props) {
       return (0, _columnProcessors.processEnumColumn)(col, dataType);
     }
     if (col.type || typeof col.cellRenderer == "string") {
-      return _objectSpread({}, col);
+      return (0, _columnProcessors.mergeInferredColumnType)(col, dataType);
     }
     //@ts-ignore
     if (col !== null && col !== void 0 && col.ellipsis) {
-      return _objectSpread(_objectSpread({}, col), {}, {
+      return _objectSpread(_objectSpread({}, (0, _columnProcessors.mergeInferredColumnType)(col, dataType)), {}, {
         cellRenderer: function cellRenderer(_ref) {
           var value = _ref.value;
           return /*#__PURE__*/_react.default.createElement(Text, {
@@ -494,12 +493,12 @@ function AgGridPlus(props) {
       });
     }
     if (col.cellRenderer) {
-      return _objectSpread(_objectSpread({}, col), {}, {
+      return _objectSpread(_objectSpread({}, (0, _columnProcessors.mergeInferredColumnType)(col, dataType)), {}, {
         customCellRenderer: col.cellRenderer,
         cellRenderer: cellRenderer
       });
     }
-    return _objectSpread(_objectSpread(_objectSpread({}, (0, _columnProcessors.toColumnType)(dataType)), col), {}, {
+    return _objectSpread(_objectSpread({}, (0, _columnProcessors.mergeInferredColumnType)(col, dataType)), {}, {
       customCellRenderer: col.cellRenderer,
       cellRenderer: cellRenderer
     });
@@ -886,6 +885,10 @@ function AgGridPlus(props) {
       onRetry: onRefresh
     };
   }, [loadError, accessible, filtered, overlayNoRowsTemplateText, emptyState, onRefresh]);
+  // 调用方自带空态浮层时让位，见 resolveNoRowsOverlay。@author nokecy
+  var noRowsOverlay = (0, _react.useMemo)(function () {
+    return (0, _emptyState.resolveNoRowsOverlay)(_NoRowsOverlay.default, noRowsOverlayParams, rest.noRowsOverlayComponent, rest.noRowsOverlayComponentParams);
+  }, [noRowsOverlayParams, rest.noRowsOverlayComponent, rest.noRowsOverlayComponentParams]);
   (0, _react.useEffect)(function () {
     gridRef.current = {
       onRefresh: onRefresh
@@ -949,6 +952,7 @@ function AgGridPlus(props) {
     }
   };
   var calculateSum = (0, _react.useCallback)(function () {
+    if (props.pinnedBottomRowData !== undefined) return;
     var displayedData = [];
     if (apiRef.current) {
       apiRef.current.forEachNodeAfterFilter(function (node) {
@@ -960,22 +964,16 @@ function AgGridPlus(props) {
       (_apiRef$current4 = apiRef.current) === null || _apiRef$current4 === void 0 || _apiRef$current4.setGridOption('pinnedBottomRowData', undefined);
       return;
     }
-    var calcColFields = allColDefs.filter(function (col) {
-      return col.calculateType;
-    }).map(function (col) {
-      return {
-        field: col.field,
-        calculateType: col.calculateType,
-        transactionAmount: col.transactionAmount || 2,
-        formatWithCommas: col.formatWithCommas
-      };
-    });
+    var calcColFields = (0, _aggregation.getCalculationColumns)(allColDefs);
     if (calcColFields.length > 0) {
       var _apiRef$current5;
       var calculatedValues = (0, _aggregation.computeAggregationRow)(calcColFields, displayedData);
       (_apiRef$current5 = apiRef.current) === null || _apiRef$current5 === void 0 || _apiRef$current5.setGridOption('pinnedBottomRowData', calculatedValues);
+    } else {
+      var _apiRef$current6;
+      (_apiRef$current6 = apiRef.current) === null || _apiRef$current6 === void 0 || _apiRef$current6.setGridOption('pinnedBottomRowData', undefined);
     }
-  }, [allColDefs]);
+  }, [allColDefs, props.pinnedBottomRowData]);
   var onFilterChanged = function onFilterChanged(event) {
     calculateSum();
   };
@@ -1329,8 +1327,8 @@ function AgGridPlus(props) {
       ensureDomOrder: true,
       columnHoverHighlight: true
     },
-    noRowsOverlayComponent: _NoRowsOverlay.default,
-    noRowsOverlayComponentParams: noRowsOverlayParams
+    noRowsOverlayComponent: noRowsOverlay.component,
+    noRowsOverlayComponentParams: noRowsOverlay.params
     // 加载中不显示空态：外层 Spin 已经在转，再叠一句「暂无数据」会让用户
     // 以为真的没数据（冒烟截图里这两者确实同时出现过）。@author nokecy
     ,
@@ -1369,8 +1367,8 @@ function AgGridPlus(props) {
     },
     onDragStopped: function onDragStopped(e) {
       if (apiRef.current) {
-        var _apiRef$current6;
-        var _columnState = (_apiRef$current6 = apiRef.current) === null || _apiRef$current6 === void 0 ? void 0 : _apiRef$current6.getColumnState();
+        var _apiRef$current7;
+        var _columnState = (_apiRef$current7 = apiRef.current) === null || _apiRef$current7 === void 0 ? void 0 : _apiRef$current7.getColumnState();
         setColumnState(_columnState);
 
         // onColumnStateChanged && onColumnStateChanged(columnState)

package/dist/cjs/ag-grid-plus/index.less

@@ -48,3 +48,9 @@
 .custom-cell-right {
   text-align: right !important;
 }
+
+// 空态浮层里的「重试」「新建」「清空筛选」要能点：AG-Grid 给 .ag-overlay 设了 pointer-events: none，
+// 只给加载浮层放开，空态浮层里的按钮因此点不到。只放开可交互元素，空白处仍穿透到表格。@author nokecy
+.ag-overlay-no-rows-wrapper :is(button, a, input, [role='button']) {
+  pointer-events: auto;
+}

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

@@ -9,6 +9,15 @@ export interface CalculationColumnConfig {
     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[];
 export declare const isValidNumber: (value: any) => boolean;
 export declare const sumField: (field: string, data: any[]) => number;
 export declare const avgField: (field: string, data: any[]) => number;

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

@@ -4,7 +4,7 @@ function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" ==
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.sumField = exports.stdDevField = exports.isValidNumber = exports.formatWithCommas = exports.computeAggregationRow = exports.avgField = void 0;
+exports.sumField = exports.stdDevField = exports.isValidNumber = exports.getCalculationColumns = exports.formatWithCommas = exports.computeAggregationRow = exports.avgField = void 0;
 var _lodash = _interopRequireWildcard(require("lodash"));
 function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(e) { return e ? t : r; })(e); }
 function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != _typeof(e) && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && Object.prototype.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
@@ -13,6 +13,20 @@ function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e;
  * @author nokecy
  */
 
+/** 分组表头只是展示结构；原生固定合计行要读取所有叶子数值列。@author nokecy */
+var getCalculationColumns = exports.getCalculationColumns = function getCalculationColumns(columns) {
+  return columns.flatMap(function (column) {
+    var _column$transactionAm;
+    if (column.children) return getCalculationColumns(column.children);
+    if (!column.field || !column.calculateType) return [];
+    return [{
+      field: column.field,
+      calculateType: column.calculateType,
+      transactionAmount: (_column$transactionAm = column.transactionAmount) !== null && _column$transactionAm !== void 0 ? _column$transactionAm : 2,
+      formatWithCommas: column.formatWithCommas
+    }];
+  });
+};
 var isValidNumber = exports.isValidNumber = function isValidNumber(value) {
   return typeof value === 'number' && !isNaN(value);
 };

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

@@ -56,8 +56,8 @@ export declare function inferDataType(data: any, colName: string, valueEnum?: Va
  * 早先是把整个 dataType 摊进 colDef，等于给列设了 type:"number"——而注册的 columnTypes 里
  * 根本没有叫 number 的类型，这个字段一直没生效。
  *
- * 数量型数值列真正该有的是右对齐：位数对齐了才能一眼比大小。只有 calculateType 为真
- * （可求和的数量型）才右对齐；用 valueEnum 表示分类的数值列（状态码之类）不动。
+ * 普通数值列右对齐；合计另由 calculateType 显式控制。
+ * 用 valueEnum 表示分类的数值列（状态码之类）不动。
  *
  * @author nokecy
  */
@@ -65,6 +65,8 @@ 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>;
 /**
  * 处理枚举列定义 —— **枚举列渲染的唯一实现**。
  *

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

@@ -9,6 +9,7 @@ exports.createCellRenderer = createCellRenderer;
 exports.filterHiddenColumns = filterHiddenColumns;
 exports.handleGridPlusColumnState = handleGridPlusColumnState;
 exports.inferDataType = inferDataType;
+exports.mergeInferredColumnType = mergeInferredColumnType;
 exports.processEllipsisColumn = processEllipsisColumn;
 exports.processEnumColumn = processEnumColumn;
 exports.toColumnType = toColumnType;
@@ -75,11 +76,10 @@ function handleGridPlusColumnState(columnState) {
 function inferDataType(data, colName, valueEnum) {
   var value = data[colName];
   if (typeof value === 'number') {
-    // 如果有枚举值，说明是分类数据，不进行计算
-    var shouldCalculate = !valueEnum || valueEnum.length === 0;
+    // 数值只决定对齐；合计必须由列定义显式声明。@author nokecy
     return {
       type: 'number',
-      calculateType: shouldCalculate ? 'sum' : false
+      calculateType: valueEnum !== null && valueEnum !== void 0 && valueEnum.length ? false : undefined
     };
   }
   if (typeof value === 'boolean') {
@@ -104,17 +104,19 @@ function inferDataType(data, colName, valueEnum) {
  * 早先是把整个 dataType 摊进 colDef，等于给列设了 type:"number"——而注册的 columnTypes 里
  * 根本没有叫 number 的类型，这个字段一直没生效。
  *
- * 数量型数值列真正该有的是右对齐：位数对齐了才能一眼比大小。只有 calculateType 为真
- * （可求和的数量型）才右对齐；用 valueEnum 表示分类的数值列（状态码之类）不动。
+ * 普通数值列右对齐；合计另由 calculateType 显式控制。
+ * 用 valueEnum 表示分类的数值列（状态码之类）不动。
  *
  * @author nokecy
  */
 function toColumnType(dataType) {
   if (!dataType) return {};
-  if (dataType.type === 'number' && dataType.calculateType) {
-    return {
+  if (dataType.type === 'number' && dataType.calculateType !== false) {
+    return dataType.calculateType ? {
       calculateType: dataType.calculateType,
       type: 'rightAligned'
+    } : {
+      type: 'rightAligned'
     };
   }
   return {
@@ -122,6 +124,11 @@ function toColumnType(dataType) {
   };
 }
 
+/** 显式列类型只控制显示方式，不遮蔽数值对齐或显式合计配置。@author nokecy */
+function mergeInferredColumnType(column, dataType) {
+  return _objectSpread(_objectSpread({}, toColumnType(dataType)), column);
+}
+
 /**
  * 处理枚举列定义 —— **枚举列渲染的唯一实现**。
  *

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

@@ -40,3 +40,15 @@ export declare function resolveEmptyText(state: {
     override?: string;
     texts?: EmptyStateTexts;
 }): string;
+/**
+ * 选出空态浮层组件及其入参。
+ * 调用方传了 `noRowsOverlayComponent` 就用调用方的：宿主往往有自己的空态（例如无数据时带「新建」按钮、
+ * 外部筛选栏的「清空筛选」），此前内置浮层写死在 `...rest` 之后，把它们全部覆盖掉了。
+ * 入参合并：内置的 branch / text / onRetry 照样传给自定义组件，调用方同名入参优先。
+ *
+ * @author nokecy
+ */
+export declare function resolveNoRowsOverlay<C, P extends object>(builtIn: C, builtInParams: P, custom?: C | null, customParams?: Record<string, any> | null): {
+    component: C;
+    params: P & Record<string, any>;
+};

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

@@ -7,6 +7,12 @@ exports.DEFAULT_EMPTY_TEXTS = void 0;
 exports.hasEffectiveFilter = hasEffectiveFilter;
 exports.resolveEmptyBranch = resolveEmptyBranch;
 exports.resolveEmptyText = resolveEmptyText;
+exports.resolveNoRowsOverlay = resolveNoRowsOverlay;
+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); }
 /**
  * 表格空态四分。
@@ -74,4 +80,19 @@ function resolveEmptyText(state) {
   if (state.override) return state.override;
   var branch = resolveEmptyBranch(state);
   return (_state$texts$branch = (_state$texts = state.texts) === null || _state$texts === void 0 ? void 0 : _state$texts[branch]) !== null && _state$texts$branch !== void 0 ? _state$texts$branch : DEFAULT_EMPTY_TEXTS[branch];
+}
+
+/**
+ * 选出空态浮层组件及其入参。
+ * 调用方传了 `noRowsOverlayComponent` 就用调用方的：宿主往往有自己的空态（例如无数据时带「新建」按钮、
+ * 外部筛选栏的「清空筛选」），此前内置浮层写死在 `...rest` 之后，把它们全部覆盖掉了。
+ * 入参合并：内置的 branch / text / onRetry 照样传给自定义组件，调用方同名入参优先。
+ *
+ * @author nokecy
+ */
+function resolveNoRowsOverlay(builtIn, builtInParams, custom, customParams) {
+  return {
+    component: custom !== null && custom !== void 0 ? custom : builtIn,
+    params: customParams ? _objectSpread(_objectSpread({}, builtInParams), customParams) : builtInParams
+  };
 }

package/dist/esm/ag-grid-plus/ag-gridPlus.js

@@ -36,7 +36,7 @@ import ToolBar from "./toolBar";
 import SettingItem from "./settingItem";
 import { RedoOutlined, FilterOutlined } from '@ant-design/icons';
 import { convertFilterModel, dateTimeValueFormatter, dateValueFormatter, flatten, toTree } from "./utils";
-import { processEnumColumn, toColumnType } from "./utils/columnProcessors";
+import { mergeInferredColumnType, processEnumColumn } from "./utils/columnProcessors";
 import AdvancedQueryBuilder from "./queryForm/AdvancedQueryBuilder";
 import { v4 as uuidv4 } from 'uuid';
 import Setting from "./setting";
@@ -46,7 +46,7 @@ import _, { isArray } from 'lodash';
 import CustomGroupCellRenderer from "./_utils/customGroupCellRenderer";
 import NoRowsOverlay from "./shared/NoRowsOverlay";
 import { DEFAULT_PAGE_SIZE_OPTIONS } from "./utils/constants";
-import { hasEffectiveFilter, resolveEmptyBranch, resolveEmptyText } from "./utils/emptyState";
+import { hasEffectiveFilter, resolveEmptyBranch, resolveEmptyText, resolveNoRowsOverlay } from "./utils/emptyState";
 import processColumnGroups from "./_utils/processColumnGroups";
 import flattenColumnState from "./_utils/processFormColumnState";
 import { localeText } from "./locale";
@@ -55,7 +55,7 @@ import { QueryFormContext } from "./context/queryFormContext";
 import { useGridSchemes } from "./context/useSchemeManager";
 import { useSchemeDataFlow } from "./context/useSchemeDataFlow";
 import { extractItemsOrder, extractHiddenFields } from "./shared/utils/schemeDataMigration";
-import { computeAggregationRow } from "./utils/aggregation";
+import { computeAggregationRow, getCalculationColumns } from "./utils/aggregation";
 import { sortFormItemsByOrder, filterHiddenFormItems } from "./utils/queryFormDerivation";
 import { filterVisibleSelectedRows } from "./utils/rowSelection";
 import { buildFilterString, pageToSkipCount } from "./utils/requestParams";
@@ -433,11 +433,10 @@ function AgGridPlus(props) {
   // 辅助函数: 获取数据类型
   var getDataType = function getDataType(data, colName, valueEnum) {
     if (typeof data[colName] === 'number') {
-      // 如果有枚举值，说明是分类数据，不进行计算;否则默认求和
-      var shouldCalculate = !valueEnum || valueEnum.length === 0;
+      // 数值只用于列对齐；底部合计必须由 calculateType 显式声明。@author nokecy
       return {
         type: "number",
-        calculateType: shouldCalculate ? "sum" : false
+        calculateType: valueEnum !== null && valueEnum !== void 0 && valueEnum.length ? false : undefined
       };
     }
     return undefined;
@@ -465,11 +464,11 @@ function AgGridPlus(props) {
       return processEnumColumn(col, dataType);
     }
     if (col.type || typeof col.cellRenderer == "string") {
-      return _objectSpread({}, col);
+      return mergeInferredColumnType(col, dataType);
     }
     //@ts-ignore
     if (col !== null && col !== void 0 && col.ellipsis) {
-      return _objectSpread(_objectSpread({}, col), {}, {
+      return _objectSpread(_objectSpread({}, mergeInferredColumnType(col, dataType)), {}, {
         cellRenderer: function cellRenderer(_ref) {
           var value = _ref.value;
           return /*#__PURE__*/React.createElement(Text, {
@@ -486,12 +485,12 @@ function AgGridPlus(props) {
       });
     }
     if (col.cellRenderer) {
-      return _objectSpread(_objectSpread({}, col), {}, {
+      return _objectSpread(_objectSpread({}, mergeInferredColumnType(col, dataType)), {}, {
         customCellRenderer: col.cellRenderer,
         cellRenderer: cellRenderer
       });
     }
-    return _objectSpread(_objectSpread(_objectSpread({}, toColumnType(dataType)), col), {}, {
+    return _objectSpread(_objectSpread({}, mergeInferredColumnType(col, dataType)), {}, {
       customCellRenderer: col.cellRenderer,
       cellRenderer: cellRenderer
     });
@@ -878,6 +877,10 @@ function AgGridPlus(props) {
       onRetry: onRefresh
     };
   }, [loadError, accessible, filtered, overlayNoRowsTemplateText, emptyState, onRefresh]);
+  // 调用方自带空态浮层时让位，见 resolveNoRowsOverlay。@author nokecy
+  var noRowsOverlay = useMemo(function () {
+    return resolveNoRowsOverlay(NoRowsOverlay, noRowsOverlayParams, rest.noRowsOverlayComponent, rest.noRowsOverlayComponentParams);
+  }, [noRowsOverlayParams, rest.noRowsOverlayComponent, rest.noRowsOverlayComponentParams]);
   useEffect(function () {
     gridRef.current = {
       onRefresh: onRefresh
@@ -941,6 +944,7 @@ function AgGridPlus(props) {
     }
   };
   var calculateSum = useCallback(function () {
+    if (props.pinnedBottomRowData !== undefined) return;
     var displayedData = [];
     if (apiRef.current) {
       apiRef.current.forEachNodeAfterFilter(function (node) {
@@ -952,22 +956,16 @@ function AgGridPlus(props) {
       (_apiRef$current4 = apiRef.current) === null || _apiRef$current4 === void 0 || _apiRef$current4.setGridOption('pinnedBottomRowData', undefined);
       return;
     }
-    var calcColFields = allColDefs.filter(function (col) {
-      return col.calculateType;
-    }).map(function (col) {
-      return {
-        field: col.field,
-        calculateType: col.calculateType,
-        transactionAmount: col.transactionAmount || 2,
-        formatWithCommas: col.formatWithCommas
-      };
-    });
+    var calcColFields = getCalculationColumns(allColDefs);
     if (calcColFields.length > 0) {
       var _apiRef$current5;
       var calculatedValues = computeAggregationRow(calcColFields, displayedData);
       (_apiRef$current5 = apiRef.current) === null || _apiRef$current5 === void 0 || _apiRef$current5.setGridOption('pinnedBottomRowData', calculatedValues);
+    } else {
+      var _apiRef$current6;
+      (_apiRef$current6 = apiRef.current) === null || _apiRef$current6 === void 0 || _apiRef$current6.setGridOption('pinnedBottomRowData', undefined);
     }
-  }, [allColDefs]);
+  }, [allColDefs, props.pinnedBottomRowData]);
   var onFilterChanged = function onFilterChanged(event) {
     calculateSum();
   };
@@ -1321,8 +1319,8 @@ function AgGridPlus(props) {
       ensureDomOrder: true,
       columnHoverHighlight: true
     },
-    noRowsOverlayComponent: NoRowsOverlay,
-    noRowsOverlayComponentParams: noRowsOverlayParams
+    noRowsOverlayComponent: noRowsOverlay.component,
+    noRowsOverlayComponentParams: noRowsOverlay.params
     // 加载中不显示空态：外层 Spin 已经在转，再叠一句「暂无数据」会让用户
     // 以为真的没数据（冒烟截图里这两者确实同时出现过）。@author nokecy
     ,
@@ -1361,8 +1359,8 @@ function AgGridPlus(props) {
     },
     onDragStopped: function onDragStopped(e) {
       if (apiRef.current) {
-        var _apiRef$current6;
-        var _columnState = (_apiRef$current6 = apiRef.current) === null || _apiRef$current6 === void 0 ? void 0 : _apiRef$current6.getColumnState();
+        var _apiRef$current7;
+        var _columnState = (_apiRef$current7 = apiRef.current) === null || _apiRef$current7 === void 0 ? void 0 : _apiRef$current7.getColumnState();
         setColumnState(_columnState);
 
         // onColumnStateChanged && onColumnStateChanged(columnState)

package/dist/esm/ag-grid-plus/index.less

@@ -48,3 +48,9 @@
 .custom-cell-right {
   text-align: right !important;
 }
+
+// 空态浮层里的「重试」「新建」「清空筛选」要能点：AG-Grid 给 .ag-overlay 设了 pointer-events: none，
+// 只给加载浮层放开，空态浮层里的按钮因此点不到。只放开可交互元素，空白处仍穿透到表格。@author nokecy
+.ag-overlay-no-rows-wrapper :is(button, a, input, [role='button']) {
+  pointer-events: auto;
+}

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

@@ -9,6 +9,15 @@ export interface CalculationColumnConfig {
     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[];
 export declare const isValidNumber: (value: any) => boolean;
 export declare const sumField: (field: string, data: any[]) => number;
 export declare const avgField: (field: string, data: any[]) => number;

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

@@ -5,6 +5,20 @@ import _, { uniqueId } from 'lodash';
  * @author nokecy
  */
 
+/** 分组表头只是展示结构；原生固定合计行要读取所有叶子数值列。@author nokecy */
+export var getCalculationColumns = function getCalculationColumns(columns) {
+  return columns.flatMap(function (column) {
+    var _column$transactionAm;
+    if (column.children) return getCalculationColumns(column.children);
+    if (!column.field || !column.calculateType) return [];
+    return [{
+      field: column.field,
+      calculateType: column.calculateType,
+      transactionAmount: (_column$transactionAm = column.transactionAmount) !== null && _column$transactionAm !== void 0 ? _column$transactionAm : 2,
+      formatWithCommas: column.formatWithCommas
+    }];
+  });
+};
 export var isValidNumber = function isValidNumber(value) {
   return typeof value === 'number' && !isNaN(value);
 };

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

@@ -56,8 +56,8 @@ export declare function inferDataType(data: any, colName: string, valueEnum?: Va
  * 早先是把整个 dataType 摊进 colDef，等于给列设了 type:"number"——而注册的 columnTypes 里
  * 根本没有叫 number 的类型，这个字段一直没生效。
  *
- * 数量型数值列真正该有的是右对齐：位数对齐了才能一眼比大小。只有 calculateType 为真
- * （可求和的数量型）才右对齐；用 valueEnum 表示分类的数值列（状态码之类）不动。
+ * 普通数值列右对齐；合计另由 calculateType 显式控制。
+ * 用 valueEnum 表示分类的数值列（状态码之类）不动。
  *
  * @author nokecy
  */
@@ -65,6 +65,8 @@ 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>;
 /**
  * 处理枚举列定义 —— **枚举列渲染的唯一实现**。
  *

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

@@ -60,11 +60,10 @@ export function handleGridPlusColumnState(columnState) {
 export function inferDataType(data, colName, valueEnum) {
   var value = data[colName];
   if (typeof value === 'number') {
-    // 如果有枚举值，说明是分类数据，不进行计算
-    var shouldCalculate = !valueEnum || valueEnum.length === 0;
+    // 数值只决定对齐；合计必须由列定义显式声明。@author nokecy
     return {
       type: 'number',
-      calculateType: shouldCalculate ? 'sum' : false
+      calculateType: valueEnum !== null && valueEnum !== void 0 && valueEnum.length ? false : undefined
     };
   }
   if (typeof value === 'boolean') {
@@ -89,17 +88,19 @@ export function inferDataType(data, colName, valueEnum) {
  * 早先是把整个 dataType 摊进 colDef，等于给列设了 type:"number"——而注册的 columnTypes 里
  * 根本没有叫 number 的类型，这个字段一直没生效。
  *
- * 数量型数值列真正该有的是右对齐：位数对齐了才能一眼比大小。只有 calculateType 为真
- * （可求和的数量型）才右对齐；用 valueEnum 表示分类的数值列（状态码之类）不动。
+ * 普通数值列右对齐；合计另由 calculateType 显式控制。
+ * 用 valueEnum 表示分类的数值列（状态码之类）不动。
  *
  * @author nokecy
  */
 export function toColumnType(dataType) {
   if (!dataType) return {};
-  if (dataType.type === 'number' && dataType.calculateType) {
-    return {
+  if (dataType.type === 'number' && dataType.calculateType !== false) {
+    return dataType.calculateType ? {
       calculateType: dataType.calculateType,
       type: 'rightAligned'
+    } : {
+      type: 'rightAligned'
     };
   }
   return {
@@ -107,6 +108,11 @@ export function toColumnType(dataType) {
   };
 }
 
+/** 显式列类型只控制显示方式，不遮蔽数值对齐或显式合计配置。@author nokecy */
+export function mergeInferredColumnType(column, dataType) {
+  return _objectSpread(_objectSpread({}, toColumnType(dataType)), column);
+}
+
 /**
  * 处理枚举列定义 —— **枚举列渲染的唯一实现**。
  *

package/dist/esm/ag-grid-plus/utils/emptyState.d.ts

@@ -40,3 +40,15 @@ export declare function resolveEmptyText(state: {
     override?: string;
     texts?: EmptyStateTexts;
 }): string;
+/**
+ * 选出空态浮层组件及其入参。
+ * 调用方传了 `noRowsOverlayComponent` 就用调用方的：宿主往往有自己的空态（例如无数据时带「新建」按钮、
+ * 外部筛选栏的「清空筛选」），此前内置浮层写死在 `...rest` 之后，把它们全部覆盖掉了。
+ * 入参合并：内置的 branch / text / onRetry 照样传给自定义组件，调用方同名入参优先。
+ *
+ * @author nokecy
+ */
+export declare function resolveNoRowsOverlay<C, P extends object>(builtIn: C, builtInParams: P, custom?: C | null, customParams?: Record<string, any> | null): {
+    component: C;
+    params: P & Record<string, any>;
+};

package/dist/esm/ag-grid-plus/utils/emptyState.js

@@ -1,3 +1,8 @@
+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); }
 /**
  * 表格空态四分。
@@ -65,4 +70,19 @@ export function resolveEmptyText(state) {
   if (state.override) return state.override;
   var branch = resolveEmptyBranch(state);
   return (_state$texts$branch = (_state$texts = state.texts) === null || _state$texts === void 0 ? void 0 : _state$texts[branch]) !== null && _state$texts$branch !== void 0 ? _state$texts$branch : DEFAULT_EMPTY_TEXTS[branch];
+}
+
+/**
+ * 选出空态浮层组件及其入参。
+ * 调用方传了 `noRowsOverlayComponent` 就用调用方的：宿主往往有自己的空态（例如无数据时带「新建」按钮、
+ * 外部筛选栏的「清空筛选」），此前内置浮层写死在 `...rest` 之后，把它们全部覆盖掉了。
+ * 入参合并：内置的 branch / text / onRetry 照样传给自定义组件，调用方同名入参优先。
+ *
+ * @author nokecy
+ */
+export function resolveNoRowsOverlay(builtIn, builtInParams, custom, customParams) {
+  return {
+    component: custom !== null && custom !== void 0 ? custom : builtIn,
+    params: customParams ? _objectSpread(_objectSpread({}, builtInParams), customParams) : builtInParams
+  };
 }