@nokecy/qc-ui 1.1.72 → 1.1.74

package/dist/cjs/toolBar/index.js

@@ -1,35 +1,69 @@
 "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.default = void 0;
-var _react = _interopRequireDefault(require("react"));
+var _react = _interopRequireWildcard(require("react"));
 var _antd = require("antd");
 require("./index.less");
-var _excluded = ["children", "className", "extra", "style", "renderContent", "getTargetContainer"];
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+var _excluded = ["children", "className", "extra", "identity", "banner", "style", "renderContent", "getTargetContainer"];
+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; }
 function _objectWithoutProperties(source, excluded) { if (source == null) return {}; var target = _objectWithoutPropertiesLoose(source, excluded); var key, i; if (Object.getOwnPropertySymbols) { var sourceSymbolKeys = Object.getOwnPropertySymbols(source); for (i = 0; i < sourceSymbolKeys.length; i++) { key = sourceSymbolKeys[i]; if (excluded.indexOf(key) >= 0) continue; if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue; target[key] = source[key]; } } return target; }
 function _objectWithoutPropertiesLoose(source, excluded) { if (source == null) return {}; var target = {}; var sourceKeys = Object.keys(source); var key, i; for (i = 0; i < sourceKeys.length; i++) { key = sourceKeys[i]; if (excluded.indexOf(key) >= 0) continue; target[key] = source[key]; } return target; }
+/** 详情、表单共用工具栏：按实际操作元素统一留出间距，宽度不足时换行。@author nokecy */
 var ToolBar = function ToolBar(props) {
   var children = props.children,
     className = props.className,
     extra = props.extra,
+    identity = props.identity,
+    banner = props.banner,
     style = props.style,
     renderContent = props.renderContent,
     getTargetContainer = props.getTargetContainer,
     restProps = _objectWithoutProperties(props, _excluded);
+  var _theme$useToken = _antd.theme.useToken(),
+    token = _theme$useToken.token; // 单据操作栏跟随宿主主题。@author nokecy
+  var barRef = (0, _react.useRef)(null);
+  // @author nokecy：KeepAlive 内容区独立滚动，吸顶应相对其视口，避免定位到应用顶栏下面。
+  var defaultTarget = (0, _react.useCallback)(function () {
+    var _barRef$current$paren, _barRef$current;
+    var parent = (_barRef$current$paren = (_barRef$current = barRef.current) === null || _barRef$current === void 0 ? void 0 : _barRef$current.parentElement) !== null && _barRef$current$paren !== void 0 ? _barRef$current$paren : null;
+    while (parent) {
+      if (/auto|scroll/.test(getComputedStyle(parent).overflowY)) return parent;
+      parent = parent.parentElement;
+    }
+    return window;
+  }, []);
   return /*#__PURE__*/_react.default.createElement(_antd.Affix, {
     offsetTop: 2,
     style: style,
     offsetBottom: 2,
-    target: getTargetContainer
+    target: getTargetContainer || defaultTarget
   }, /*#__PURE__*/_react.default.createElement("div", {
-    className: "antd-tool-bar"
-  }, /*#__PURE__*/_react.default.createElement("div", {
-    className: "antd-tool-bar-left".trim()
-  }, /*#__PURE__*/_react.default.createElement(_antd.Space, null, extra)), /*#__PURE__*/_react.default.createElement("div", {
-    className: "antd-tool-bar-right".trim()
-  }, /*#__PURE__*/_react.default.createElement(_antd.Space, null, children))));
+    ref: barRef,
+    className: "antd-tool-bar",
+    style: {
+      backgroundColor: token.colorBgContainer,
+      color: token.colorText,
+      borderBlockStartColor: token.colorBorderSecondary,
+      gap: token.marginXS,
+      paddingBlock: token.paddingXXS
+    }
+  }, banner && /*#__PURE__*/_react.default.createElement("div", {
+    className: "antd-tool-bar-banner"
+  }, banner), /*#__PURE__*/_react.default.createElement("div", {
+    className: "antd-tool-bar-left",
+    style: {
+      gap: token.marginXS
+    }
+  }, extra, identity), /*#__PURE__*/_react.default.createElement("div", {
+    className: "antd-tool-bar-right",
+    style: {
+      gap: token.marginXS
+    }
+  }, children)));
 };
 var _default = exports.default = ToolBar;

package/dist/cjs/toolBar/index.less

@@ -1,25 +1,43 @@
 .antd-tool-bar {
 	display: flex;
+	flex-wrap: wrap;
 	align-items: center;
 	box-sizing: border-box;
 	width: 100%;
-	color: rgba(0, 0, 0, 0.88);
 	line-height: 40px;
-	background-color: rgba(255, 255, 255);
-	-webkit-backdrop-filter: blur(8px);
+	backdrop-filter: blur(8px);
 	backdrop-filter: blur(8px);
 	transition: all 0.2s ease 0s;
 	inset-inline-end: 0;
 	padding-inline: 16px;
 	padding-block: 0;
-	border-block-start: 1px solid rgba(5, 5, 5, 0.06);
+	// 颜色由组件读取主题 token；子区域继承正文色。
+	border-block-start: 1px solid;
+}
+
+.antd-tool-bar-banner {
+	flex: 1 0 100%;
+	min-width: 0;
+	line-height: normal;
 }
 
 .antd-tool-bar-left {
-	flex: 1;
-	color: rgba(0, 0, 0, 0.88);
+	flex: 1 0 auto;
+	color: inherit;
+}
+
+.antd-tool-bar-right {
+	margin-inline-start: auto;
+	justify-content: flex-end;
+    color: inherit;
 }
 
+/* 直接排列组件输出的按钮，React Fragment 内的按钮也获得相同间距。@author nokecy */
+.antd-tool-bar-left,
 .antd-tool-bar-right {
-    color: rgba(0, 0, 0, 0.88);
+	display: flex;
+	flex-wrap: wrap;
+	align-items: center;
+	min-width: 0;
+	max-width: 100%;
 }

package/dist/cjs/utils/businessDecimal.d.ts

@@ -0,0 +1,11 @@
+import Decimal from 'decimal.js';
+/** 业务值保留十进制文本，运算使用十进制库；整型标识和时间不经过此入口。@author nokecy */
+export declare const BusinessDecimal: typeof Decimal;
+export type DecimalValue = string | number | Decimal | null | undefined;
+export declare const decimal: (value: DecimalValue) => Decimal;
+export declare const decimalText: (value: DecimalValue) => string;
+export declare const nonNegativeDecimal: (value: DecimalValue) => string;
+export declare const roundDecimal: (value: DecimalValue, places: number) => string;
+export declare const sumDecimals: (values: DecimalValue[]) => string;
+/** 指定取位规则显示，千分位直接处理文本，不转换为 JavaScript number。@author nokecy */
+export declare const formatDecimal: (value: DecimalValue, places?: number, minimumPlaces?: number) => string;

package/dist/cjs/utils/businessDecimal.js

@@ -0,0 +1,53 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.sumDecimals = exports.roundDecimal = exports.nonNegativeDecimal = exports.formatDecimal = exports.decimalText = exports.decimal = exports.BusinessDecimal = void 0;
+var _decimal = _interopRequireDefault(require("decimal.js"));
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+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; }
+/** 业务值保留十进制文本，运算使用十进制库；整型标识和时间不经过此入口。@author nokecy */
+var BusinessDecimal = exports.BusinessDecimal = _decimal.default.clone({
+  precision: 64,
+  rounding: _decimal.default.ROUND_HALF_UP,
+  toExpNeg: -64,
+  toExpPos: 64
+});
+var decimal = exports.decimal = function decimal(value) {
+  return new BusinessDecimal(value == null || value === '' ? '0' : value);
+};
+var decimalText = exports.decimalText = function decimalText(value) {
+  return decimal(value).toFixed();
+};
+var nonNegativeDecimal = exports.nonNegativeDecimal = function nonNegativeDecimal(value) {
+  return BusinessDecimal.max(0, decimal(value)).toFixed();
+};
+var roundDecimal = exports.roundDecimal = function roundDecimal(value, places) {
+  return decimal(value).toDecimalPlaces(places).toFixed();
+};
+var sumDecimals = exports.sumDecimals = function sumDecimals(values) {
+  return values.reduce(function (sum, value) {
+    return sum.plus(decimal(value));
+  }, decimal('0')).toFixed();
+};
+
+/** 指定取位规则显示，千分位直接处理文本，不转换为 JavaScript number。@author nokecy */
+var formatDecimal = exports.formatDecimal = function formatDecimal(value) {
+  var places = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 6;
+  var minimumPlaces = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : 0;
+  if (value == null || value === '') return '';
+  var _decimal$toFixed$spli = decimal(value).toFixed(places).split('.'),
+    _decimal$toFixed$spli2 = _slicedToArray(_decimal$toFixed$spli, 2),
+    integer = _decimal$toFixed$spli2[0],
+    _decimal$toFixed$spli3 = _decimal$toFixed$spli2[1],
+    fraction = _decimal$toFixed$spli3 === void 0 ? '' : _decimal$toFixed$spli3;
+  while (fraction.length > minimumPlaces && fraction.endsWith('0')) fraction = fraction.slice(0, -1);
+  integer = integer.replace(/\B(?=(\d{3})+(?!\d))/g, ',');
+  return fraction ? "".concat(integer, ".").concat(fraction) : integer;
+};

package/dist/cjs/utils/contrast.d.ts

@@ -0,0 +1,40 @@
+/**
+ * 对比度计算与「够读的主色」派生。
+ *
+ * 背景：品牌绿 #00b96b 落在白底上只有 2.58:1，而正文文字要 4.5:1、非文本要 3:1（WCAG 2.1）。
+ * antd 从它派生的最深一档 colorPrimaryActive 也只有 3.90:1——够非文本，够不到文字。
+ * 所以菜单选中态、行内操作按钮这些「用主色写字」的地方，靠 antd 自带档位解决不了。
+ *
+ * 这里按色相不变、只压明度的方式派生出刚好达标的一档：绿还是那个绿，但读得清。
+ * 写成纯函数而不是写死一个色值，是因为四个客户各有各的主色，写死就只对信诚成立。
+ *
+ * 验收方法沿用登录页复核那套：实测计算，不看源码想当然。
+ *
+ * @author nokecy
+ */
+/** hex -> [r, g, b]，每项 0~255。 */
+export declare function toRgb(hex: string): [number, number, number];
+/** WCAG 相对亮度。 */
+export declare function relativeLuminance(hex: string): number;
+/** WCAG 对比度，1 ~ 21。 */
+export declare function contrastRatio(a: string, b: string): number;
+/** hex -> [h(0~360), s(0~1), l(0~1)]。 */
+export declare function toHsl(hex: string): [number, number, number];
+/** [h, s, l] -> hex。 */
+export declare function fromHsl(h: number, s: number, l: number): string;
+/**
+ * 压暗到刚好满足对比度要求的一档，色相与饱和度保持不变。
+ *
+ * @param hex     起始色（通常是品牌主色）
+ * @param against 要压在什么底色上，默认白底
+ * @param min     目标对比度，正文 4.5、非文本 3
+ */
+export declare function darkenUntilContrast(hex: string, { against, min }?: {
+    against?: string | undefined;
+    min?: number | undefined;
+}): string;
+/** 深色表面上的文字保持色相，提亮至正文对比度。@author nokecy */
+export declare function lightenUntilContrast(hex: string, { against, min }?: {
+    against?: string | undefined;
+    min?: number | undefined;
+}): string;

package/dist/cjs/utils/contrast.js

@@ -0,0 +1,153 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.contrastRatio = contrastRatio;
+exports.darkenUntilContrast = darkenUntilContrast;
+exports.fromHsl = fromHsl;
+exports.lightenUntilContrast = lightenUntilContrast;
+exports.relativeLuminance = relativeLuminance;
+exports.toHsl = toHsl;
+exports.toRgb = toRgb;
+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; }
+/**
+ * 对比度计算与「够读的主色」派生。
+ *
+ * 背景：品牌绿 #00b96b 落在白底上只有 2.58:1，而正文文字要 4.5:1、非文本要 3:1（WCAG 2.1）。
+ * antd 从它派生的最深一档 colorPrimaryActive 也只有 3.90:1——够非文本，够不到文字。
+ * 所以菜单选中态、行内操作按钮这些「用主色写字」的地方，靠 antd 自带档位解决不了。
+ *
+ * 这里按色相不变、只压明度的方式派生出刚好达标的一档：绿还是那个绿，但读得清。
+ * 写成纯函数而不是写死一个色值，是因为四个客户各有各的主色，写死就只对信诚成立。
+ *
+ * 验收方法沿用登录页复核那套：实测计算，不看源码想当然。
+ *
+ * @author nokecy
+ */
+
+var WHITE = '#ffffff';
+var expand = function expand(hex) {
+  var raw = hex.replace('#', '');
+  return raw.length === 3 ? raw.split('').map(function (c) {
+    return c + c;
+  }).join('') : raw;
+};
+
+/** hex -> [r, g, b]，每项 0~255。 */
+function toRgb(hex) {
+  var value = parseInt(expand(hex), 16);
+  return [value >> 16 & 255, value >> 8 & 255, value & 255];
+}
+var channelLuminance = function channelLuminance(channel) {
+  var v = channel / 255;
+  return v <= 0.03928 ? v / 12.92 : Math.pow((v + 0.055) / 1.055, 2.4);
+};
+
+/** WCAG 相对亮度。 */
+function relativeLuminance(hex) {
+  var _toRgb = toRgb(hex),
+    _toRgb2 = _slicedToArray(_toRgb, 3),
+    r = _toRgb2[0],
+    g = _toRgb2[1],
+    b = _toRgb2[2];
+  return 0.2126 * channelLuminance(r) + 0.7152 * channelLuminance(g) + 0.0722 * channelLuminance(b);
+}
+
+/** WCAG 对比度，1 ~ 21。 */
+function contrastRatio(a, b) {
+  var _sort = [relativeLuminance(a), relativeLuminance(b)].sort(function (x, y) {
+      return y - x;
+    }),
+    _sort2 = _slicedToArray(_sort, 2),
+    lighter = _sort2[0],
+    darker = _sort2[1];
+  return (lighter + 0.05) / (darker + 0.05);
+}
+
+/** hex -> [h(0~360), s(0~1), l(0~1)]。 */
+function toHsl(hex) {
+  var _ref = toRgb(hex).map(function (v) {
+      return v / 255;
+    }),
+    _ref2 = _slicedToArray(_ref, 3),
+    r = _ref2[0],
+    g = _ref2[1],
+    b = _ref2[2];
+  var max = Math.max(r, g, b);
+  var min = Math.min(r, g, b);
+  var l = (max + min) / 2;
+  var d = max - min;
+  if (d === 0) return [0, 0, l];
+  var s = d / (1 - Math.abs(2 * l - 1));
+  var h;
+  if (max === r) h = 60 * ((g - b) / d % 6);else if (max === g) h = 60 * ((b - r) / d + 2);else h = 60 * ((r - g) / d + 4);
+  return [(h + 360) % 360, s, l];
+}
+
+/** [h, s, l] -> hex。 */
+function fromHsl(h, s, l) {
+  var c = (1 - Math.abs(2 * l - 1)) * s;
+  var x = c * (1 - Math.abs(h / 60 % 2 - 1));
+  var m = l - c / 2;
+  var table = [[c, x, 0], [x, c, 0], [0, c, x], [0, x, c], [x, 0, c], [c, 0, x]];
+  var _table$Math$min = _slicedToArray(table[Math.min(5, Math.floor((h % 360 + 360) % 360 / 60))], 3),
+    r = _table$Math$min[0],
+    g = _table$Math$min[1],
+    b = _table$Math$min[2];
+  var toHex = function toHex(v) {
+    return Math.round((v + m) * 255).toString(16).padStart(2, '0');
+  };
+  return "#".concat(toHex(r)).concat(toHex(g)).concat(toHex(b));
+}
+
+/**
+ * 压暗到刚好满足对比度要求的一档，色相与饱和度保持不变。
+ *
+ * @param hex     起始色（通常是品牌主色）
+ * @param against 要压在什么底色上，默认白底
+ * @param min     目标对比度，正文 4.5、非文本 3
+ */
+function darkenUntilContrast(hex) {
+  var _ref3 = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {},
+    _ref3$against = _ref3.against,
+    against = _ref3$against === void 0 ? WHITE : _ref3$against,
+    _ref3$min = _ref3.min,
+    min = _ref3$min === void 0 ? 4.5 : _ref3$min;
+  var _toHsl = toHsl(hex),
+    _toHsl2 = _slicedToArray(_toHsl, 3),
+    h = _toHsl2[0],
+    s = _toHsl2[1],
+    l = _toHsl2[2];
+  if (contrastRatio(hex, against) >= min) return hex;
+  for (var step = 1; step <= 100; step++) {
+    var candidate = fromHsl(h, s, Math.max(0, l - step / 100));
+    if (contrastRatio(candidate, against) >= min) return candidate;
+  }
+  return '#000000';
+}
+
+/** 深色表面上的文字保持色相，提亮至正文对比度。@author nokecy */
+function lightenUntilContrast(hex) {
+  var _ref4 = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {},
+    _ref4$against = _ref4.against,
+    against = _ref4$against === void 0 ? '#141414' : _ref4$against,
+    _ref4$min = _ref4.min,
+    min = _ref4$min === void 0 ? 4.5 : _ref4$min;
+  var _toHsl3 = toHsl(hex),
+    _toHsl4 = _slicedToArray(_toHsl3, 3),
+    h = _toHsl4[0],
+    s = _toHsl4[1],
+    l = _toHsl4[2];
+  if (contrastRatio(hex, against) >= min) return hex;
+  for (var step = 1; step <= 100; step++) {
+    var candidate = fromHsl(h, s, Math.min(1, l + step / 100));
+    if (contrastRatio(candidate, against) >= min) return candidate;
+  }
+  return '#ffffff';
+}

package/dist/esm/adapters/pagedApiAdapter.d.ts

@@ -13,6 +13,8 @@ export interface GenericPagedQuery {
     filter?: string;
     /** 排序表达式,如 "name asc"。 */
     sorter?: string;
+    /** 表格请求的原始筛选对象（请求函数的第三个参数）；需要把它放进后端请求体的适配器才读取。 */
+    record?: any;
 }
 /** 分页 API 适配器。 */
 export interface PagedApiAdapter {

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

@@ -1,4 +1,4 @@
-var _excluded = ["style", "loading", "params", "request", "dataSource", "treeKeyName", "treeParentName", "rowData", "gridRef", "headerTitle", "toolBarRender", "search", "hideTool", "onGridReady", "gridKey", "children", "defaultSearchExpand", "overlayNoRowsTemplateText", "queryDefaultRows", "onSelectedRowsChange", "emptyState", "accessible", "enableClickSelection", "rowSelection", "useNativeTreeFilter", "entityType"];
+var _excluded = ["style", "loading", "params", "request", "dataSource", "treeKeyName", "treeParentName", "rowData", "gridRef", "headerTitle", "toolBarRender", "search", "hideTool", "onGridReady", "gridKey", "children", "defaultSearchExpand", "overlayNoRowsTemplateText", "queryDefaultRows", "onSelectedRowsChange", "emptyState", "accessible", "enableClickSelection", "rowSelection", "useNativeTreeFilter", "entityType", "valueEnumContrast"];
 function _extends() { _extends = Object.assign ? Object.assign.bind() : function (target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i]; for (var key in source) { if (Object.prototype.hasOwnProperty.call(source, key)) { target[key] = source[key]; } } } return target; }; return _extends.apply(this, arguments); }
 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 _toConsumableArray(arr) { return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableSpread(); }
@@ -109,6 +109,8 @@ function AgGridPlus(props) {
     _props$useNativeTreeF = props.useNativeTreeFilter,
     useNativeTreeFilter = _props$useNativeTreeF === void 0 ? false : _props$useNativeTreeF,
     entityType = props.entityType,
+    _props$valueEnumContr = props.valueEnumContrast,
+    valueEnumContrast = _props$valueEnumContr === void 0 ? false : _props$valueEnumContr,
     rest = _objectWithoutProperties(props, _excluded);
   var _useGridPlusColumnSta = useGridPlusColumnState(),
     onSaveColumnState = _useGridPlusColumnSta.onSaveColumnState,
@@ -462,7 +464,7 @@ function AgGridPlus(props) {
     if (col.valueEnum && Array.isArray(col.valueEnum)) {
       // 枚举列渲染只走一处实现，见 columnProcessors.processEnumColumn
       // （命中上色、未命中交给 col.enumFallbackRenderer，都没配则回原始码）
-      return processEnumColumn(col, dataType);
+      return processEnumColumn(col, dataType, valueEnumContrast ? token.colorBgContainer : undefined);
     }
     if (col.type || typeof col.cellRenderer == "string") {
       return mergeInferredColumnType(col, dataType);
@@ -568,7 +570,7 @@ function AgGridPlus(props) {
       });
     }
     return cols;
-  }, [React.Children.count(children), props.columnDefs, extensibleColumns, gridKey, entityType, hostEntityExtensions, typeInferenceRow]);
+  }, [React.Children.count(children), props.columnDefs, extensibleColumns, gridKey, entityType, hostEntityExtensions, typeInferenceRow, valueEnumContrast ? token.colorBgContainer : undefined]);
 
   // 稳定化 gridParams 和 sortColumn 的引用(深比较,内容不变即复用旧引用)
   var stableGridParams = useDeepCompareStable(gridParams);

package/dist/esm/ag-grid-plus/interface.d.ts

@@ -7,6 +7,12 @@ interface GridRef {
     onRefresh: () => void;
 }
 interface GridProps extends AgGridReactProps {
+    /**
+     * 为 true 时，`valueEnum[].color` 按当前主题底色自动收成够读（WCAG 正文 4.5:1）的 CSS 色：
+     * 语义档名（success/warning…）与预设名（cyan/pink…）换成真实色值，过浅的 hex 压暗（深色主题则提亮），
+     * 缺省色写成 `inherit`。默认 false：color 按 CSS 原样输出，保持既有行为。@author nokecy
+     */
+    valueEnumContrast?: boolean;
     hideTool?: boolean;
     style?: CSSProperties;
     params?: any;

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

@@ -5,7 +5,7 @@
 export interface CalculationColumnConfig {
     field: string;
     calculateType: 'sum' | 'avg' | 'standardDeviation';
-    transactionAmount: number;
+    transactionAmount?: number;
     formatWithCommas?: boolean;
     cellRenderer?: any;
 }
@@ -18,9 +18,10 @@ export interface 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;
-export declare const avgField: (field: string, data: any[]) => number;
-export declare const stdDevField: (field: string, data: any[]) => number;
-export declare const formatWithCommas: (value: number) => string;
+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/esm/ag-grid-plus/utils/aggregation.js

@@ -1,4 +1,11 @@
-import _, { uniqueId } from 'lodash';
+function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
+function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t.return && (u = t.return(), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
+function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
+import { uniqueId } from 'lodash';
+import { BusinessDecimal as Exact } from "../../utils/businessDecimal";
 
 /**
  * AG-Grid 底部汇总聚合纯函数(从 ag-gridPlus.tsx 抽出,行为原样)。
@@ -8,63 +15,68 @@ import _, { uniqueId } from 'lodash';
 /** 分组表头只是展示结构；原生固定合计行要读取所有叶子数值列。@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,
+      transactionAmount: column.transactionAmount,
       formatWithCommas: column.formatWithCommas
     }];
   });
 };
+
+/** 精确数值字符串参与汇总；空值、非法文本及非有限数字跳过。@author nokecy */
 export var isValidNumber = function isValidNumber(value) {
-  return typeof value === 'number' && !isNaN(value);
+  return typeof value === 'number' && Number.isFinite(value) || typeof value === 'string' && /^[+-]?(?:\d+(?:\.\d*)?|\.\d+)(?:[eE][+-]?\d+)?$/.test(value);
 };
-export var sumField = function sumField(field, data) {
-  return _.sumBy(data, function (cur) {
-    if (cur && isValidNumber(cur[field])) {
-      return cur[field];
-    }
-    return 0;
+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();
+};
+export var sumField = function sumField(field, data) {
+  var values = valuesOf(field, data);
+  return resultOf(values.reduce(function (sum, value) {
+    return sum.plus(value);
+  }, new Exact(0)), values);
+};
 export var avgField = function avgField(field, data) {
-  // 分子分母口径统一为「有效数字」,避免除零得 NaN
-  var validValues = data.filter(function (cur) {
-    return cur && isValidNumber(cur[field]);
-  });
-  if (validValues.length === 0) return 0;
-  var sum = _.sumBy(validValues, function (cur) {
-    return cur[field];
-  });
-  return sum / validValues.length;
+  var values = valuesOf(field, data);
+  return values.length ? resultOf(new Exact(sumField(field, data)).div(values.length), values) : 0;
 };
-
-// 注:现存口径小瑕疵——mean 的分母用有效值数,sumField 对全部行求和(无效计 0);
-// variance 遍历全部行且判定用 !== undefined/null(非 isValidNumber)。首刀只保持原行为,不修正。
 export var stdDevField = function stdDevField(field, data) {
-  var validValues = data.filter(function (cur) {
-    return isValidNumber(cur[field]);
-  });
-  var count = validValues.length;
-  if (count === 0) return 0;
-  var mean = sumField(field, data) / count;
-  var variance = _.sumBy(data, 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);
+  var values = valuesOf(field, data);
+  if (!values.length) return 0;
+  var mean = new Exact(sumField(field, data)).div(values.length);
+  var variance = values.reduce(function (sum, value) {
+    return sum.plus(new Exact(value).minus(mean).pow(2));
+  }, new Exact(0)).div(values.length);
+  return resultOf(variance.sqrt(), values);
 };
 export var formatWithCommas = function formatWithCommas(value) {
-  return (value / 1).toLocaleString(undefined, {
-    minimumFractionDigits: 2,
-    maximumFractionDigits: 2
-  });
+  var places = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 2;
+  var _Exact$toFixed$split = new Exact(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 Exact(value).toDecimalPlaces(places).toFixed() : new Exact(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 标准差
@@ -78,21 +90,22 @@ export var computeAggregationRow = function computeAggregationRow(calcColFields,
       switch (i.calculateType) {
         case 'sum':
           {
-            var sumPrecision = typeof i.transactionAmount === 'number' ? i.transactionAmount : 2;
-            var sumValue = Number(sumField(i.field, data).toFixed(sumPrecision));
-            calculateData[i.field] = i.formatWithCommas ? formatWithCommas(sumValue) : sumValue;
+            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 avgPrecision = typeof i.transactionAmount === 'number' ? i.transactionAmount : 2;
-            calculateData[i.field] = Number(avgField(i.field, data).toFixed(avgPrecision));
+            var average = avgField(i.field, data);
+            calculateData[i.field] = roundedResult(average, precisionOf(i, average));
             break;
           }
         case 'standardDeviation':
           {
-            var stdPrecision = typeof i.transactionAmount === 'number' ? i.transactionAmount : 2;
-            calculateData[i.field] = Number(stdDevField(i.field, data).toFixed(stdPrecision));
+            var deviation = stdDevField(i.field, data);
+            calculateData[i.field] = roundedResult(deviation, precisionOf(i, deviation));
             break;
           }
         default:

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

@@ -83,10 +83,11 @@ export declare function mergeInferredColumnType<T extends object>(column: T, dat
  *
  * @param col 原始列定义
  * @param dataType 数据类型（决定是否右对齐，见 {@link toColumnType}）
+ * @param background 单元格底色（hex）。传入则把枚举颜色压/提到够读的对比度；不传则 color 原样输出
  * @returns 处理后的列定义
  * @author nokecy
  */
-export declare function processEnumColumn(col: any, dataType?: DataTypeInference): ColDef;
+export declare function processEnumColumn(col: any, dataType?: DataTypeInference, background?: string): ColDef;
 /**
  * 处理省略列定义
  *