@nokecy/qc-ui 1.1.72 → 1.1.74

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

@@ -43,7 +43,7 @@ var _requestParams = require("./utils/requestParams");
 var _errors = require("./errors");
 var _logger = require("./utils/logger");
 var _entityExtensionColumns = require("./utils/entityExtensionColumns");
-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 _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 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; }
@@ -117,6 +117,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 = (0, _2.useGridPlusColumnState)(),
     onSaveColumnState = _useGridPlusColumnSta.onSaveColumnState,
@@ -470,7 +472,7 @@ function AgGridPlus(props) {
     if (col.valueEnum && Array.isArray(col.valueEnum)) {
       // 枚举列渲染只走一处实现，见 columnProcessors.processEnumColumn
       // （命中上色、未命中交给 col.enumFallbackRenderer，都没配则回原始码）
-      return (0, _columnProcessors.processEnumColumn)(col, dataType);
+      return (0, _columnProcessors.processEnumColumn)(col, dataType, valueEnumContrast ? token.colorBgContainer : undefined);
     }
     if (col.type || typeof col.cellRenderer == "string") {
       return (0, _columnProcessors.mergeInferredColumnType)(col, dataType);
@@ -576,7 +578,7 @@ function AgGridPlus(props) {
       });
     }
     return cols;
-  }, [_react.default.Children.count(children), props.columnDefs, extensibleColumns, gridKey, entityType, hostEntityExtensions, typeInferenceRow]);
+  }, [_react.default.Children.count(children), props.columnDefs, extensibleColumns, gridKey, entityType, hostEntityExtensions, typeInferenceRow, valueEnumContrast ? token.colorBgContainer : undefined]);
 
   // 稳定化 gridParams 和 sortColumn 的引用(深比较,内容不变即复用旧引用)
   var stableGridParams = useDeepCompareStable(gridParams);

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

@@ -1,13 +1,17 @@
 "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.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; }
+var _lodash = require("lodash");
+var _businessDecimal = require("../../utils/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
@@ -16,63 +20,68 @@ function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e;
 /** 分组表头只是展示结构；原生固定合计行要读取所有叶子数值列。@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,
+      transactionAmount: column.transactionAmount,
       formatWithCommas: column.formatWithCommas
     }];
   });
 };
+
+/** 精确数值字符串参与汇总；空值、非法文本及非有限数字跳过。@author nokecy */
 var isValidNumber = exports.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);
 };
-var sumField = exports.sumField = function sumField(field, data) {
-  return _lodash.default.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();
+};
+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) {
-  // 分子分母口径统一为「有效数字」,避免除零得 NaN
-  var validValues = data.filter(function (cur) {
-    return cur && isValidNumber(cur[field]);
-  });
-  if (validValues.length === 0) return 0;
-  var sum = _lodash.default.sumBy(validValues, function (cur) {
-    return cur[field];
-  });
-  return sum / validValues.length;
+  var values = valuesOf(field, data);
+  return values.length ? resultOf(new _businessDecimal.BusinessDecimal(sumField(field, data)).div(values.length), values) : 0;
 };
-
-// 注:现存口径小瑕疵——mean 的分母用有效值数,sumField 对全部行求和(无效计 0);
-// variance 遍历全部行且判定用 !== undefined/null(非 isValidNumber)。首刀只保持原行为,不修正。
 var stdDevField = exports.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 = _lodash.default.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 _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) {
-  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 _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 标准差
@@ -86,21 +95,22 @@ var computeAggregationRow = exports.computeAggregationRow = function computeAggr
       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/cjs/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;
 /**
  * 处理省略列定义
  *

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

@@ -18,6 +18,7 @@ var _antd = require("antd");
 var _antdV = require("@formily/antd-v5");
 var _lodash = require("lodash");
 var _constants = require("./constants");
+var _valueEnumColor = require("./valueEnumColor");
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
 function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
@@ -145,10 +146,11 @@ function mergeInferredColumnType(column, dataType) {
  *
  * @param col 原始列定义
  * @param dataType 数据类型（决定是否右对齐，见 {@link toColumnType}）
+ * @param background 单元格底色（hex）。传入则把枚举颜色压/提到够读的对比度；不传则 color 原样输出
  * @returns 处理后的列定义
  * @author nokecy
  */
-function processEnumColumn(col, dataType) {
+function processEnumColumn(col, dataType, background) {
   var _defaultItems$0$value, _defaultItems$;
   var valueEnum = col === null || col === void 0 ? void 0 : col.valueEnum;
   if (!valueEnum || !Array.isArray(valueEnum)) {
@@ -181,7 +183,8 @@ function processEnumColumn(col, dataType) {
         // 没配颜色的枚举项曾经默认成 '#ffffff'——白底白字，那一列直接看不见。
         // 消费端为此在 global.less 里加了一整套 [style*="color: white"] → 紫色 的覆盖来擦屁股，
         // 顺带把别的颜色也一起改了。这里改成 inherit，跟着单元格的正文色走。@author nokecy
-        var color = match.color || 'inherit';
+        // 传了 background 才启用对比度适配（AgGridPlus 的 valueEnumContrast）；否则 color 按 CSS 原样输出。@author nokecy
+        var color = background ? (0, _valueEnumColor.toGridTextColor)(match.color, background) : match.color || 'inherit';
         return /*#__PURE__*/_react.default.createElement("span", {
           style: {
             color: color,

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

@@ -0,0 +1,17 @@
+/** antd Tag 语义档名。 */
+export type SemanticPreset = 'default' | 'processing' | 'success' | 'warning' | 'error';
+/** 语义档名 → 表格文字色（白底实测 ≥4.5:1）。 */
+export declare const semanticTextColors: Record<SemanticPreset, string>;
+/**
+ * 把任意 valueEnum.color 收成表格可用的 CSS 色。
+ *
+ * @param color 枚举项上的 color（语义档、预设名、hex 或缺省）
+ * @param background 单元格底色（hex）；不传按白底。深色底提亮、浅色底压暗
+ */
+export declare const toGridTextColor: (color?: string, background?: string) => string;
+/** 把枚举转成 `valueEnum` 可用的副本（color 一定是当前底色可读的 CSS 色值），不修改源数组。 */
+export declare const gridValueEnum: <T extends {
+    color?: string | undefined;
+}>(items: readonly T[], background?: string) => (T & {
+    color: string;
+})[];

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

@@ -0,0 +1,99 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.toGridTextColor = exports.semanticTextColors = exports.gridValueEnum = void 0;
+var _contrast = require("../../utils/contrast");
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); } /**
+ * `valueEnum.color` 的表格文字色适配。
+ *
+ * 同一份状态/类别枚举有两个消费方，对 `color` 的要求不同：
+ * - antd `<Tag color>` 接受语义档名（`'success'` / `'warning'` …）和预设色名（`'cyan'`）；
+ * - AgGridPlus 的 `valueEnum` 把 `color` 直接当 **CSS color** 渲染表格文字。
+ *
+ * 直接透传会让这几类取值在表格里「字看不见」：语义档名与预设名不是合法 CSS
+ * （`'cyan'` 是 `#00ffff`，`'default'` 根本不合法）；hex 太浅（`#d9d9d9` 白底 1.3:1、`#52c41a` 2.3:1）。
+ * 这里把任意 color 收成当前底色上够读（WCAG 正文 4.5:1）的 CSS 色，缺省/无法解析写成 `inherit`，
+ * 跟随单元格正文色。已经够读的 hex 原样返回，所以重复调用是幂等的。
+ *
+ * 语义档色值经 `contrastRatio` 实测：白底均 ≥4.5:1（green-7/orange-7 只有 3.4~3.6:1，不能想当然）。
+ *
+ * @author nokecy
+ */
+/** antd Tag 语义档名。 */
+
+var WHITE = '#ffffff';
+
+/** 语义档名 → 表格文字色（白底实测 ≥4.5:1）。 */
+var semanticTextColors = exports.semanticTextColors = {
+  default: '#595959',
+  processing: '#0958d9',
+  success: '#237804',
+  warning: '#ad4e00',
+  error: '#cf1322'
+};
+
+/** antd Tag 预设名 / 常见 CSS 色名 → 起始 hex，再交给对比度压色。 */
+var namedColorHex = {
+  cyan: '#00ffff',
+  aqua: '#00ffff',
+  geekblue: '#2f54eb',
+  blue: '#0000ff',
+  orange: '#ffa500',
+  gold: '#ffd700',
+  lime: '#00ff00',
+  volcano: '#fa541c',
+  magenta: '#ff00ff',
+  fuchsia: '#ff00ff',
+  purple: '#800080',
+  red: '#ff0000',
+  green: '#008000',
+  pink: '#ffc0cb',
+  yellow: '#ffff00',
+  white: '#ffffff',
+  silver: '#c0c0c0'
+};
+var parseHex = function parseHex(color) {
+  var raw = color.trim();
+  if (!/^#([0-9a-f]{3}|[0-9a-f]{6})$/i.test(raw)) return undefined;
+  return raw.length === 4 ? "#".concat(raw[1]).concat(raw[1]).concat(raw[2]).concat(raw[2]).concat(raw[3]).concat(raw[3]).toLowerCase() : raw.toLowerCase();
+};
+
+/** 底色是否为深色表面。 */
+var isDarkSurface = function isDarkSurface(background) {
+  return (0, _contrast.relativeLuminance)(background) < 0.18;
+};
+
+/**
+ * 把任意 valueEnum.color 收成表格可用的 CSS 色。
+ *
+ * @param color 枚举项上的 color（语义档、预设名、hex 或缺省）
+ * @param background 单元格底色（hex）；不传按白底。深色底提亮、浅色底压暗
+ */
+var toGridTextColor = exports.toGridTextColor = function toGridTextColor(color, background) {
+  if (!color) return 'inherit';
+  var hex = semanticTextColors[color] || namedColorHex[color.toLowerCase()] || parseHex(color);
+  if (!hex) return 'inherit';
+  var surface = background && parseHex(background) ? background : WHITE;
+  if (isDarkSurface(surface)) return (0, _contrast.lightenUntilContrast)(hex, {
+    against: surface
+  });
+  return (0, _contrast.contrastRatio)(hex, surface) >= 4.5 ? hex : (0, _contrast.darkenUntilContrast)(hex, {
+    against: surface
+  });
+};
+
+/** 把枚举转成 `valueEnum` 可用的副本（color 一定是当前底色可读的 CSS 色值），不修改源数组。 */
+var gridValueEnum = exports.gridValueEnum = function gridValueEnum(items, background) {
+  return items.map(function (item) {
+    return _objectSpread(_objectSpread({}, item), {}, {
+      color: toGridTextColor(item.color, background)
+    });
+  });
+};

package/dist/cjs/dialogSelect/index.d.ts

@@ -2,7 +2,11 @@ import { SelectProps } from 'antd/lib/select';
 import React from 'react';
 import { ColDef, ColGroupDef } from 'ag-grid-community';
 import type { PagedApiAdapter } from '../adapters';
+import './index.less';
+/** 选择窗口的行选择模式。 */
+type DialogSelectionMode = 'single' | 'multiple';
 interface IDialogSelectProps extends SelectProps<any> {
+    /** 隐藏选择窗口入口（输入框内的后缀图标），只保留输入与下拉。 */
     hideBtn?: boolean;
     request?: any;
     columnDefs?: (ColDef | ColGroupDef)[] | null;
@@ -13,6 +17,31 @@ interface IDialogSelectProps extends SelectProps<any> {
     useAutoComplete?: boolean;
     /** 分页 API 适配器(默认 ABP)。@author nokecy */
     pagedApiAdapter?: PagedApiAdapter;
+    /** 选择窗口宽度，默认 960。 */
+    modalWidth?: number | string;
+    /** 选择窗口层级，默认 9999（高于抽屉、其他弹窗）。 */
+    dialogZIndex?: number;
+    /** 选择窗口中的行选择模式；缺省按 `mode` 推断，外层 Select 仍可保持单值。 */
+    dialogMode?: DialogSelectionMode;
+    /** 选择窗口表格的初始分页大小；不影响外层 Select。 */
+    dialogPageSize?: number;
+    /** 选择窗口表格可选分页大小。 */
+    dialogPageSizeOptions?: number[];
+    /** 选择窗口表格的列方案标识。 */
+    dialogGridKey?: string;
+    /** 已由业务限定范围的本地候选；传入后不再请求接口，表格直接筛选完整候选集且不分页。 */
+    dialogDataSource?: any[];
+    /** 业务限制下不可带入的行；单击、确认和双击共用该条件。 */
+    dialogIsRowSelectable?: (row: any) => boolean;
+    /** 自定义选择窗口内容；确认时回传所选行。传入后不再渲染内置的表格窗口。 */
+    dialogRenderer?: (context: {
+        open: boolean;
+        mode: DialogSelectionMode;
+        onCancel: () => void;
+        onConfirm: (rows: any[]) => void;
+    }) => React.ReactNode;
+    /** 选择窗口里使用的表格组件，默认 `AgGridPlus`；宿主可注入自己封装过的表格基座。 */
+    gridComponent?: React.ComponentType<any>;
 }
 declare const DialogSelect: (props: IDialogSelectProps) => React.JSX.Element;
 export { IDialogSelectProps };