@nokecy/qc-ui 1.1.54 → 1.1.55

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

@@ -30,7 +30,6 @@ var _constants = require("./utils/constants");
 var _emptyState = require("./utils/emptyState");
 var _processColumnGroups = _interopRequireDefault(require("./_utils/processColumnGroups"));
 var _processFormColumnState = _interopRequireDefault(require("./_utils/processFormColumnState"));
-var _antdV = require("@formily/antd-v5");
 var _locale = require("./locale");
 var _gridContext = require("./context/gridContext");
 var _queryFormContext = require("./context/queryFormContext");
@@ -468,57 +467,9 @@ function AgGridPlus(props) {
   var processColumnConfig = function processColumnConfig(col, data) {
     var dataType = getDataType(data, col.field || '', col.valueEnum);
     if (col.valueEnum && Array.isArray(col.valueEnum)) {
-      var _defaultItems$0$value, _defaultItems$;
-      // 统计默认值
-      var valueEnum = col.valueEnum; // 保存引用以便TypeScript理解
-      var defaultItems = valueEnum.filter(function (item) {
-        return item.default;
-      });
-      var isMultiple = defaultItems.length > 1;
-      var defaultValue = isMultiple ? defaultItems.map(function (item) {
-        return item.value;
-      }) : (_defaultItems$0$value = (_defaultItems$ = defaultItems[0]) === null || _defaultItems$ === void 0 ? void 0 : _defaultItems$.value) !== null && _defaultItems$0$value !== void 0 ? _defaultItems$0$value : undefined;
-      var valueFormatter = function valueFormatter(params) {
-        var match = valueEnum.find(function (item) {
-          return item.value == params.value;
-        });
-        return match ? match.label : params.value;
-      };
-      return _objectSpread(_objectSpread(_objectSpread({}, (0, _columnProcessors.toColumnType)(dataType)), col), {}, {
-        cellRenderer: function cellRenderer(params) {
-          var match = valueEnum.find(function (item) {
-            return item.value == params.value;
-          });
-          if (match) {
-            // 没配颜色的枚举项曾经默认成 '#ffffff'——白底白字，那一列直接看不见。
-            // 消费端为此在 global.less 里加了一整套 [style*="color: white"] → 紫色的覆盖来擦屁股，
-            // 顺带把别的颜色也一起改了。这里改成 inherit，跟着单元格的正文色走。@author nokecy
-            var color = match.color || 'inherit';
-            return /*#__PURE__*/_react.default.createElement("span", {
-              style: {
-                color: color,
-                backgroundColor: 'transparent',
-                fontWeight: 500
-              }
-            }, match.label);
-          }
-          return params.value;
-        },
-        filterParams: _objectSpread(_objectSpread({}, col.filterParams || {}), {}, {
-          valueFormatter: valueFormatter
-        }),
-        searchComponent: _antdV.Select,
-        searchComponentProps: {
-          options: col.valueEnum.map(function (item) {
-            return {
-              label: item.label,
-              value: item.value
-            };
-          }),
-          mode: isMultiple ? "multiple" : undefined,
-          defaultValue: defaultValue
-        }
-      });
+      // 枚举列渲染只走一处实现，见 columnProcessors.processEnumColumn
+      // （命中上色、未命中交给 col.enumFallbackRenderer，都没配则回原始码）
+      return (0, _columnProcessors.processEnumColumn)(col, dataType);
     }
     if (col.type || typeof col.cellRenderer == "string") {
       return _objectSpread({}, col);

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

@@ -1,4 +1,4 @@
-import { GridApi, ColDef, ColGroupDef } from "ag-grid-community";
+import { GridApi, ColDef, ColGroupDef, ICellRendererParams } from "ag-grid-community";
 import { AgGridReactProps } from "ag-grid-react";
 import React, { CSSProperties, ReactNode } from "react";
 import type { GridPlusError } from "./errors";
@@ -157,6 +157,16 @@ interface AgGridColumnPropsClone extends ColDef {
         color?: string;
         default?: boolean;
     }>;
+    /**
+     * `valueEnum` **未命中**时的渲染接管（`null` / `undefined` / 空串 / 后端新增码值都走这里）。
+     *
+     * 不传则原样输出该值（历史行为，向后兼容）。业务侧用它输出中性「—」/「未知（原码）」：
+     * ```tsx
+     * enumFallbackRenderer: ({ value }) => <span style={{ color: '#595959' }}>{enumDisplayText(value)}</span>
+     * ```
+     * 命中枚举项时不会调用它（那一支有固定的上色渲染）。
+     */
+    enumFallbackRenderer?: (params: ICellRendererParams) => ReactNode;
     searchComponent?: ReactNode | JSX.Element | ((props: any) => JSX.Element);
     searchComponentProps?: any;
     searchSort?: number;

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

@@ -4,7 +4,7 @@
  * 此文件定义了 AgGridPlus 组件的所有核心类型接口,
  * 用于替换代码中的 any 类型,提高类型安全性
  */
-import { ColumnState, GridApi, ColDef } from 'ag-grid-community';
+import { ColumnState, GridApi, ColDef, ICellRendererParams } from 'ag-grid-community';
 import { ReactNode } from 'react';
 /**
  * 分页状态
@@ -132,6 +132,12 @@ export interface ExtendedColDef extends ColDef {
     ellipsis?: boolean;
     /** 枚举值配置 */
     valueEnum?: ValueEnumItem[];
+    /**
+     * `valueEnum` **未命中**时的渲染接管（`null` / `undefined` / 空串 / 后端新增码值都走这里）。
+     * 不传则原样输出该值（历史行为，向后兼容）。业务侧据此输出中性「—」/「未知（原码）」。
+     * 命中枚举项的渲染不受它影响。
+     */
+    enumFallbackRenderer?: (params: ICellRendererParams) => ReactNode;
     /** 自定义搜索组件 */
     searchComponent?: ReactNode | ((props: any) => JSX.Element);
     /** 搜索组件属性 */

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

@@ -66,11 +66,23 @@ export declare function toColumnType(dataType?: DataTypeInference): {
     type?: string;
 };
 /**
- * 处理枚举列定义
+ * 处理枚举列定义 —— **枚举列渲染的唯一实现**。
+ *
+ * `cellRenderer` 必须在 `...col` 展开**之后**写入：否则业务传入的 `cellRenderer` 会把枚举映射盖掉，
+ * 列退回原始码；反过来，业务也无法靠自己的 `cellRenderer` 接管枚举列（这正是本函数的职责边界）。
+ *
+ * 命中枚举项：按 `match.color` 上色。`color` 是 **CSS 颜色**，语义档名（`success` 等）不是合法 CSS，
+ * 会被浏览器静默忽略、整列退回正文色 —— 消费方需用 `gridValueEnum()` 之类适配层先转成色值。
+ *
+ * **未命中枚举**（`null` / `undefined` / 空串 / 后端新增了码值而前端枚举未跟上）：
+ * - 列上配了 `enumFallbackRenderer` → 交给它渲染。业务侧据此输出中性「—」/「未知（原码）」，
+ *   不必再改壳；
+ * - 没配 → 原样返回该值（历史行为，保持向后兼容）。
  *
  * @param col 原始列定义
- * @param dataType 数据类型
+ * @param dataType 数据类型（决定是否右对齐，见 {@link toColumnType}）
  * @returns 处理后的列定义
+ * @author nokecy
  */
 export declare function processEnumColumn(col: any, dataType?: DataTypeInference): ColDef;
 /**

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

@@ -123,20 +123,33 @@ function toColumnType(dataType) {
 }
 
 /**
- * 处理枚举列定义
+ * 处理枚举列定义 —— **枚举列渲染的唯一实现**。
+ *
+ * `cellRenderer` 必须在 `...col` 展开**之后**写入：否则业务传入的 `cellRenderer` 会把枚举映射盖掉，
+ * 列退回原始码；反过来，业务也无法靠自己的 `cellRenderer` 接管枚举列（这正是本函数的职责边界）。
+ *
+ * 命中枚举项：按 `match.color` 上色。`color` 是 **CSS 颜色**，语义档名（`success` 等）不是合法 CSS，
+ * 会被浏览器静默忽略、整列退回正文色 —— 消费方需用 `gridValueEnum()` 之类适配层先转成色值。
+ *
+ * **未命中枚举**（`null` / `undefined` / 空串 / 后端新增了码值而前端枚举未跟上）：
+ * - 列上配了 `enumFallbackRenderer` → 交给它渲染。业务侧据此输出中性「—」/「未知（原码）」，
+ *   不必再改壳；
+ * - 没配 → 原样返回该值（历史行为，保持向后兼容）。
  *
  * @param col 原始列定义
- * @param dataType 数据类型
+ * @param dataType 数据类型（决定是否右对齐，见 {@link toColumnType}）
  * @returns 处理后的列定义
+ * @author nokecy
  */
 function processEnumColumn(col, dataType) {
   var _defaultItems$0$value, _defaultItems$;
-  if (!col.valueEnum || !Array.isArray(col.valueEnum)) {
+  var valueEnum = col === null || col === void 0 ? void 0 : col.valueEnum;
+  if (!valueEnum || !Array.isArray(valueEnum)) {
     return col;
   }
 
   // 统计默认值
-  var defaultItems = col.valueEnum.filter(function (item) {
+  var defaultItems = valueEnum.filter(function (item) {
     return item.default;
   });
   var isMultiple = defaultItems.length > 1;
@@ -146,14 +159,15 @@ function processEnumColumn(col, dataType) {
 
   // 值格式化函数
   var valueFormatter = function valueFormatter(params) {
-    var match = col.valueEnum.find(function (item) {
+    var match = valueEnum.find(function (item) {
       return item.value == params.value;
     });
     return match ? match.label : params.value;
   };
-  return _objectSpread(_objectSpread(_objectSpread({}, dataType), col), {}, {
+  var fallbackRenderer = col.enumFallbackRenderer;
+  return _objectSpread(_objectSpread(_objectSpread({}, toColumnType(dataType)), col), {}, {
     cellRenderer: function cellRenderer(params) {
-      var match = col.valueEnum.find(function (item) {
+      var match = valueEnum.find(function (item) {
         return item.value == params.value;
       });
       if (match) {
@@ -169,6 +183,9 @@ function processEnumColumn(col, dataType) {
           }
         }, match.label);
       }
+      if (typeof fallbackRenderer === 'function') {
+        return fallbackRenderer(params);
+      }
       return params.value;
     },
     filterParams: _objectSpread(_objectSpread({}, col.filterParams || {}), {}, {
@@ -176,7 +193,7 @@ function processEnumColumn(col, dataType) {
     }),
     searchComponent: _antdV.Select,
     searchComponentProps: {
-      options: col.valueEnum.map(function (item) {
+      options: valueEnum.map(function (item) {
         return {
           label: item.label,
           value: item.value

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 { toColumnType } from "./utils/columnProcessors";
+import { processEnumColumn, toColumnType } from "./utils/columnProcessors";
 import AdvancedQueryBuilder from "./queryForm/AdvancedQueryBuilder";
 import { v4 as uuidv4 } from 'uuid';
 import Setting from "./setting";
@@ -49,7 +49,6 @@ import { DEFAULT_PAGE_SIZE_OPTIONS } from "./utils/constants";
 import { hasEffectiveFilter, resolveEmptyBranch, resolveEmptyText } from "./utils/emptyState";
 import processColumnGroups from "./_utils/processColumnGroups";
 import flattenColumnState from "./_utils/processFormColumnState";
-import { Select } from '@formily/antd-v5';
 import { localeText } from "./locale";
 import { GridPlusContext } from "./context/gridContext";
 import { QueryFormContext } from "./context/queryFormContext";
@@ -460,57 +459,9 @@ function AgGridPlus(props) {
   var processColumnConfig = function processColumnConfig(col, data) {
     var dataType = getDataType(data, col.field || '', col.valueEnum);
     if (col.valueEnum && Array.isArray(col.valueEnum)) {
-      var _defaultItems$0$value, _defaultItems$;
-      // 统计默认值
-      var valueEnum = col.valueEnum; // 保存引用以便TypeScript理解
-      var defaultItems = valueEnum.filter(function (item) {
-        return item.default;
-      });
-      var isMultiple = defaultItems.length > 1;
-      var defaultValue = isMultiple ? defaultItems.map(function (item) {
-        return item.value;
-      }) : (_defaultItems$0$value = (_defaultItems$ = defaultItems[0]) === null || _defaultItems$ === void 0 ? void 0 : _defaultItems$.value) !== null && _defaultItems$0$value !== void 0 ? _defaultItems$0$value : undefined;
-      var valueFormatter = function valueFormatter(params) {
-        var match = valueEnum.find(function (item) {
-          return item.value == params.value;
-        });
-        return match ? match.label : params.value;
-      };
-      return _objectSpread(_objectSpread(_objectSpread({}, toColumnType(dataType)), col), {}, {
-        cellRenderer: function cellRenderer(params) {
-          var match = valueEnum.find(function (item) {
-            return item.value == params.value;
-          });
-          if (match) {
-            // 没配颜色的枚举项曾经默认成 '#ffffff'——白底白字，那一列直接看不见。
-            // 消费端为此在 global.less 里加了一整套 [style*="color: white"] → 紫色的覆盖来擦屁股，
-            // 顺带把别的颜色也一起改了。这里改成 inherit，跟着单元格的正文色走。@author nokecy
-            var color = match.color || 'inherit';
-            return /*#__PURE__*/React.createElement("span", {
-              style: {
-                color: color,
-                backgroundColor: 'transparent',
-                fontWeight: 500
-              }
-            }, match.label);
-          }
-          return params.value;
-        },
-        filterParams: _objectSpread(_objectSpread({}, col.filterParams || {}), {}, {
-          valueFormatter: valueFormatter
-        }),
-        searchComponent: Select,
-        searchComponentProps: {
-          options: col.valueEnum.map(function (item) {
-            return {
-              label: item.label,
-              value: item.value
-            };
-          }),
-          mode: isMultiple ? "multiple" : undefined,
-          defaultValue: defaultValue
-        }
-      });
+      // 枚举列渲染只走一处实现，见 columnProcessors.processEnumColumn
+      // （命中上色、未命中交给 col.enumFallbackRenderer，都没配则回原始码）
+      return processEnumColumn(col, dataType);
     }
     if (col.type || typeof col.cellRenderer == "string") {
       return _objectSpread({}, col);

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

@@ -1,4 +1,4 @@
-import { GridApi, ColDef, ColGroupDef } from "ag-grid-community";
+import { GridApi, ColDef, ColGroupDef, ICellRendererParams } from "ag-grid-community";
 import { AgGridReactProps } from "ag-grid-react";
 import React, { CSSProperties, ReactNode } from "react";
 import type { GridPlusError } from "./errors";
@@ -157,6 +157,16 @@ interface AgGridColumnPropsClone extends ColDef {
         color?: string;
         default?: boolean;
     }>;
+    /**
+     * `valueEnum` **未命中**时的渲染接管（`null` / `undefined` / 空串 / 后端新增码值都走这里）。
+     *
+     * 不传则原样输出该值（历史行为，向后兼容）。业务侧用它输出中性「—」/「未知（原码）」：
+     * ```tsx
+     * enumFallbackRenderer: ({ value }) => <span style={{ color: '#595959' }}>{enumDisplayText(value)}</span>
+     * ```
+     * 命中枚举项时不会调用它（那一支有固定的上色渲染）。
+     */
+    enumFallbackRenderer?: (params: ICellRendererParams) => ReactNode;
     searchComponent?: ReactNode | JSX.Element | ((props: any) => JSX.Element);
     searchComponentProps?: any;
     searchSort?: number;

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

@@ -4,7 +4,7 @@
  * 此文件定义了 AgGridPlus 组件的所有核心类型接口,
  * 用于替换代码中的 any 类型,提高类型安全性
  */
-import { ColumnState, GridApi, ColDef } from 'ag-grid-community';
+import { ColumnState, GridApi, ColDef, ICellRendererParams } from 'ag-grid-community';
 import { ReactNode } from 'react';
 /**
  * 分页状态
@@ -132,6 +132,12 @@ export interface ExtendedColDef extends ColDef {
     ellipsis?: boolean;
     /** 枚举值配置 */
     valueEnum?: ValueEnumItem[];
+    /**
+     * `valueEnum` **未命中**时的渲染接管（`null` / `undefined` / 空串 / 后端新增码值都走这里）。
+     * 不传则原样输出该值（历史行为，向后兼容）。业务侧据此输出中性「—」/「未知（原码）」。
+     * 命中枚举项的渲染不受它影响。
+     */
+    enumFallbackRenderer?: (params: ICellRendererParams) => ReactNode;
     /** 自定义搜索组件 */
     searchComponent?: ReactNode | ((props: any) => JSX.Element);
     /** 搜索组件属性 */

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

@@ -66,11 +66,23 @@ export declare function toColumnType(dataType?: DataTypeInference): {
     type?: string;
 };
 /**
- * 处理枚举列定义
+ * 处理枚举列定义 —— **枚举列渲染的唯一实现**。
+ *
+ * `cellRenderer` 必须在 `...col` 展开**之后**写入：否则业务传入的 `cellRenderer` 会把枚举映射盖掉，
+ * 列退回原始码；反过来，业务也无法靠自己的 `cellRenderer` 接管枚举列（这正是本函数的职责边界）。
+ *
+ * 命中枚举项：按 `match.color` 上色。`color` 是 **CSS 颜色**，语义档名（`success` 等）不是合法 CSS，
+ * 会被浏览器静默忽略、整列退回正文色 —— 消费方需用 `gridValueEnum()` 之类适配层先转成色值。
+ *
+ * **未命中枚举**（`null` / `undefined` / 空串 / 后端新增了码值而前端枚举未跟上）：
+ * - 列上配了 `enumFallbackRenderer` → 交给它渲染。业务侧据此输出中性「—」/「未知（原码）」，
+ *   不必再改壳；
+ * - 没配 → 原样返回该值（历史行为，保持向后兼容）。
  *
  * @param col 原始列定义
- * @param dataType 数据类型
+ * @param dataType 数据类型（决定是否右对齐，见 {@link toColumnType}）
  * @returns 处理后的列定义
+ * @author nokecy
  */
 export declare function processEnumColumn(col: any, dataType?: DataTypeInference): ColDef;
 /**

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

@@ -108,20 +108,33 @@ export function toColumnType(dataType) {
 }
 
 /**
- * 处理枚举列定义
+ * 处理枚举列定义 —— **枚举列渲染的唯一实现**。
+ *
+ * `cellRenderer` 必须在 `...col` 展开**之后**写入：否则业务传入的 `cellRenderer` 会把枚举映射盖掉，
+ * 列退回原始码；反过来，业务也无法靠自己的 `cellRenderer` 接管枚举列（这正是本函数的职责边界）。
+ *
+ * 命中枚举项：按 `match.color` 上色。`color` 是 **CSS 颜色**，语义档名（`success` 等）不是合法 CSS，
+ * 会被浏览器静默忽略、整列退回正文色 —— 消费方需用 `gridValueEnum()` 之类适配层先转成色值。
+ *
+ * **未命中枚举**（`null` / `undefined` / 空串 / 后端新增了码值而前端枚举未跟上）：
+ * - 列上配了 `enumFallbackRenderer` → 交给它渲染。业务侧据此输出中性「—」/「未知（原码）」，
+ *   不必再改壳；
+ * - 没配 → 原样返回该值（历史行为，保持向后兼容）。
  *
  * @param col 原始列定义
- * @param dataType 数据类型
+ * @param dataType 数据类型（决定是否右对齐，见 {@link toColumnType}）
  * @returns 处理后的列定义
+ * @author nokecy
  */
 export function processEnumColumn(col, dataType) {
   var _defaultItems$0$value, _defaultItems$;
-  if (!col.valueEnum || !Array.isArray(col.valueEnum)) {
+  var valueEnum = col === null || col === void 0 ? void 0 : col.valueEnum;
+  if (!valueEnum || !Array.isArray(valueEnum)) {
     return col;
   }
 
   // 统计默认值
-  var defaultItems = col.valueEnum.filter(function (item) {
+  var defaultItems = valueEnum.filter(function (item) {
     return item.default;
   });
   var isMultiple = defaultItems.length > 1;
@@ -131,14 +144,15 @@ export function processEnumColumn(col, dataType) {
 
   // 值格式化函数
   var valueFormatter = function valueFormatter(params) {
-    var match = col.valueEnum.find(function (item) {
+    var match = valueEnum.find(function (item) {
       return item.value == params.value;
     });
     return match ? match.label : params.value;
   };
-  return _objectSpread(_objectSpread(_objectSpread({}, dataType), col), {}, {
+  var fallbackRenderer = col.enumFallbackRenderer;
+  return _objectSpread(_objectSpread(_objectSpread({}, toColumnType(dataType)), col), {}, {
     cellRenderer: function cellRenderer(params) {
-      var match = col.valueEnum.find(function (item) {
+      var match = valueEnum.find(function (item) {
         return item.value == params.value;
       });
       if (match) {
@@ -154,6 +168,9 @@ export function processEnumColumn(col, dataType) {
           }
         }, match.label);
       }
+      if (typeof fallbackRenderer === 'function') {
+        return fallbackRenderer(params);
+      }
       return params.value;
     },
     filterParams: _objectSpread(_objectSpread({}, col.filterParams || {}), {}, {
@@ -161,7 +178,7 @@ export function processEnumColumn(col, dataType) {
     }),
     searchComponent: Select,
     searchComponentProps: {
-      options: col.valueEnum.map(function (item) {
+      options: valueEnum.map(function (item) {
         return {
           label: item.label,
           value: item.value