@nokecy/qc-ui 1.1.79 → 1.1.81

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

@@ -453,18 +453,8 @@ function AgGridPlus(props) {
     return undefined;
   };
 
-  // 辅助函数: 自定义单元格渲染器
-  var cellRenderer = function cellRenderer(params) {
-    var value = params.value,
-      node = params.node,
-      colDef = params.colDef;
-    //@ts-ignore
-    if (node.isRowPinned() || !colDef.customCellRenderer) {
-      return value;
-    }
-    //@ts-ignore
-    return colDef.customCellRenderer(params);
-  };
+  // 辅助函数: 自定义单元格渲染器（无自定义渲染器时显示 valueFormatter 的结果，见 renderDefaultCell）
+  var cellRenderer = _columnProcessors.renderDefaultCell;
 
   // 辅助函数: 处理单个列配置
   var processColumnConfig = function processColumnConfig(col, data) {

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

@@ -95,13 +95,24 @@ export declare function processEnumColumn(col: any, dataType?: DataTypeInference
  * @returns 处理后的列定义
  */
 export declare function processEllipsisColumn(col: any): ColDef;
+/**
+ * 默认单元格渲染：固定行（合计等）显示原值；数据行有自定义渲染器（`customCellRenderer`）时交给它；
+ * 否则显示 `valueFormatted`（列上配了 `valueFormatter` 时由 AG Grid 算好），没配则显示原值。
+ *
+ * 以前这里直接返回 `params.value`，普通列（没有 `type`、没有自定义渲染器）上写的 `valueFormatter`
+ * 被绕过：状态码列显示原码、「0/1」列显示 0/1，而不是格式化后的文字。
+ * 固定行保持原行为：格式化函数多按数据行写，空值常被格式化成「—」，不能让合计行冒出占位符。
+ *
+ * @author nokecy
+ */
+export declare function renderDefaultCell(params: ICellRendererParams): any;
 /**
  * 创建自定义单元格渲染器包装
  *
- * @param customRenderer 自定义渲染器
+ * @param _customRenderer 保留参数，实际取列上的 `customCellRenderer`
  * @returns 包装后的渲染器
  */
-export declare function createCellRenderer(customRenderer: any): (params: ICellRendererParams) => any;
+export declare function createCellRenderer(_customRenderer?: any): typeof renderDefaultCell;
 /**
  * 构建查询表单项
  *

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

@@ -12,6 +12,7 @@ exports.inferDataType = inferDataType;
 exports.mergeInferredColumnType = mergeInferredColumnType;
 exports.processEllipsisColumn = processEllipsisColumn;
 exports.processEnumColumn = processEnumColumn;
+exports.renderDefaultCell = renderDefaultCell;
 exports.toColumnType = toColumnType;
 var _react = _interopRequireDefault(require("react"));
 var _antd = require("antd");
@@ -245,26 +246,36 @@ function processEllipsisColumn(col) {
   });
 }
 
+/**
+ * 默认单元格渲染：固定行（合计等）显示原值；数据行有自定义渲染器（`customCellRenderer`）时交给它；
+ * 否则显示 `valueFormatted`（列上配了 `valueFormatter` 时由 AG Grid 算好），没配则显示原值。
+ *
+ * 以前这里直接返回 `params.value`，普通列（没有 `type`、没有自定义渲染器）上写的 `valueFormatter`
+ * 被绕过：状态码列显示原码、「0/1」列显示 0/1，而不是格式化后的文字。
+ * 固定行保持原行为：格式化函数多按数据行写，空值常被格式化成「—」，不能让合计行冒出占位符。
+ *
+ * @author nokecy
+ */
+function renderDefaultCell(params) {
+  var _node$isRowPinned;
+  var value = params.value,
+    valueFormatted = params.valueFormatted,
+    node = params.node,
+    colDef = params.colDef;
+  if (node !== null && node !== void 0 && (_node$isRowPinned = node.isRowPinned) !== null && _node$isRowPinned !== void 0 && _node$isRowPinned.call(node)) return value;
+  var customRenderer = colDef === null || colDef === void 0 ? void 0 : colDef.customCellRenderer;
+  if (!customRenderer) return valueFormatted !== null && valueFormatted !== void 0 ? valueFormatted : value;
+  return customRenderer(params);
+}
+
 /**
  * 创建自定义单元格渲染器包装
  *
- * @param customRenderer 自定义渲染器
+ * @param _customRenderer 保留参数，实际取列上的 `customCellRenderer`
  * @returns 包装后的渲染器
  */
-function createCellRenderer(customRenderer) {
-  return function (params) {
-    var value = params.value,
-      node = params.node,
-      colDef = params.colDef;
-
-    // 固定行或没有自定义渲染器时，直接返回值
-    if (node.isRowPinned() || !colDef.customCellRenderer) {
-      return value;
-    }
-
-    // 使用自定义渲染器
-    return colDef.customCellRenderer(params);
-  };
+function createCellRenderer(_customRenderer) {
+  return renderDefaultCell;
 }
 
 /**

package/dist/cjs/array-table/readOnlyFormatters.d.ts

@@ -1,3 +1,4 @@
+import type { ReactNode } from 'react';
 export type ReadOnlyFormatterCtx = {
     /** 列的 x-component-props(headerName/width/options/format 等) */
     columnProps: any;
@@ -15,6 +16,31 @@ export type ReadOnlyFormatter = (value: any, ctx: ReadOnlyFormatterCtx) => strin
 export declare const fallbackFormatter: ReadOnlyFormatter;
 /** 消费方扩展自定义只读列的显示逻辑 */
 export declare const registerReadOnlyFormatter: (component: string, formatter: ReadOnlyFormatter) => void;
+/** 值 -> 名称表:对象 `{ '10': '参与' }`,或与 Select 同形的选项数组 `[{ label, value }]` */
+export type ReadOnlyLabels = Record<string, string> | Array<{
+    label?: any;
+    value?: any;
+}>;
+/**
+ * 给业务自定义选择器登记「值 -> 名称」,ArrayTable 未激活的格子与只读列按名称出文本。
+ *
+ * 业务组件(如「执行动作」「是否参与校验」这类固定选项的选择器)不在内置注册表里,
+ * 格子文本会走兜底格式化器把原值原样显示(10、00 这类编码)。在组件模块里调用一次即可,
+ * 所有用到该 x-component 的列都生效;同一组件在不同 Schema 里注册名不同时传名字数组。
+ * 按 String 宽松比对(容忍后端返回数字/字符串漂移);labelInValue 对象显示其 label;
+ * 数组逐个映射后逗号拼接;表里没有的值原样显示。@author nokecy
+ */
+export declare const registerReadOnlyLabels: (component: string | string[], labels: ReadOnlyLabels) => void;
+/** 只读渲染器:按值出一段 React 内容(如组件自己的阅读态 Tag),格子未激活和只读列都用它显示 */
+export type ReadOnlyRenderer = (value: any, ctx: ReadOnlyFormatterCtx) => ReactNode;
+/**
+ * 给业务自定义组件登记只读渲染器。登记后 ArrayTable 可编辑列未激活的格子、只读列都渲染它的返回内容,
+ * 与组件自己的阅读态一致(例如带颜色的 Tag),仍不挂 Formily 字段树。空值不调用渲染器(出占位/留空)。
+ * 只要文字时用 registerReadOnlyLabels;两者都登记时显示走渲染器。@author nokecy
+ */
+export declare const registerReadOnlyRenderer: (component: string | string[], renderer: ReadOnlyRenderer) => void;
+/** 取某组件类型的只读渲染器,未登记返回 null */
+export declare const getReadOnlyRenderer: (component: string | undefined) => ReadOnlyRenderer | null;
 /**
  * 取某组件类型的只读格式化器。命中返回函数,未命中返回 null(调用方回退 AgField)。
  */

package/dist/cjs/array-table/readOnlyFormatters.js

@@ -3,9 +3,15 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.registerReadOnlyFormatter = exports.getReadOnlyFormatter = exports.fallbackFormatter = void 0;
+exports.registerReadOnlyRenderer = exports.registerReadOnlyLabels = exports.registerReadOnlyFormatter = exports.getReadOnlyRenderer = exports.getReadOnlyFormatter = exports.fallbackFormatter = void 0;
 var _dayjs = _interopRequireDefault(require("dayjs"));
 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; }
 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); } /**
  * 只读列「纯文本快路径」格式化器注册表
  *
@@ -127,6 +133,68 @@ var registerReadOnlyFormatter = exports.registerReadOnlyFormatter = function reg
   registry[component] = formatter;
 };
 
+/** 值 -> 名称表:对象 `{ '10': '参与' }`,或与 Select 同形的选项数组 `[{ label, value }]` */
+
+/**
+ * 给业务自定义选择器登记「值 -> 名称」,ArrayTable 未激活的格子与只读列按名称出文本。
+ *
+ * 业务组件(如「执行动作」「是否参与校验」这类固定选项的选择器)不在内置注册表里,
+ * 格子文本会走兜底格式化器把原值原样显示(10、00 这类编码)。在组件模块里调用一次即可,
+ * 所有用到该 x-component 的列都生效;同一组件在不同 Schema 里注册名不同时传名字数组。
+ * 按 String 宽松比对(容忍后端返回数字/字符串漂移);labelInValue 对象显示其 label;
+ * 数组逐个映射后逗号拼接;表里没有的值原样显示。@author nokecy
+ */
+var registerReadOnlyLabels = exports.registerReadOnlyLabels = function registerReadOnlyLabels(component, labels) {
+  var map = new Map();
+  if (Array.isArray(labels)) {
+    labels.forEach(function (o) {
+      var _o$label;
+      if (o && o.value != null) map.set(String(o.value), String((_o$label = o.label) !== null && _o$label !== void 0 ? _o$label : o.value));
+    });
+  } else {
+    Object.entries(labels !== null && labels !== void 0 ? labels : {}).forEach(function (_ref7) {
+      var _ref8 = _slicedToArray(_ref7, 2),
+        k = _ref8[0],
+        v = _ref8[1];
+      return map.set(String(k), String(v));
+    });
+  }
+  var toText = function toText(v) {
+    var _ref9, _v$label, _map$get;
+    if (v == null || v === '') return '';
+    if (_typeof(v) === 'object') return String((_ref9 = (_v$label = v.label) !== null && _v$label !== void 0 ? _v$label : v.value) !== null && _ref9 !== void 0 ? _ref9 : '');
+    return (_map$get = map.get(String(v))) !== null && _map$get !== void 0 ? _map$get : String(v);
+  };
+  var formatter = function formatter(value) {
+    return Array.isArray(value) ? value.map(toText).filter(Boolean).join(', ') : toText(value);
+  };
+  (Array.isArray(component) ? component : [component]).forEach(function (name) {
+    return registerReadOnlyFormatter(name, formatter);
+  });
+};
+
+/** 只读渲染器:按值出一段 React 内容(如组件自己的阅读态 Tag),格子未激活和只读列都用它显示 */
+
+var renderers = {};
+
+/**
+ * 给业务自定义组件登记只读渲染器。登记后 ArrayTable 可编辑列未激活的格子、只读列都渲染它的返回内容,
+ * 与组件自己的阅读态一致(例如带颜色的 Tag),仍不挂 Formily 字段树。空值不调用渲染器(出占位/留空)。
+ * 只要文字时用 registerReadOnlyLabels;两者都登记时显示走渲染器。@author nokecy
+ */
+var registerReadOnlyRenderer = exports.registerReadOnlyRenderer = function registerReadOnlyRenderer(component, renderer) {
+  (Array.isArray(component) ? component : [component]).forEach(function (name) {
+    renderers[name] = renderer;
+  });
+};
+
+/** 取某组件类型的只读渲染器,未登记返回 null */
+var getReadOnlyRenderer = exports.getReadOnlyRenderer = function getReadOnlyRenderer(component) {
+  var _renderers$component;
+  if (!component) return null;
+  return (_renderers$component = renderers[component]) !== null && _renderers$component !== void 0 ? _renderers$component : null;
+};
+
 /**
  * 取某组件类型的只读格式化器。命中返回函数,未命中返回 null(调用方回退 AgField)。
  */

package/dist/cjs/array-table/utils.js

@@ -351,6 +351,7 @@ var LazyAgField = exports.LazyAgField = function LazyAgField(params) {
     colDef = params.colDef,
     context = params.context,
     formatter = params.formatter,
+    renderer = params.renderer,
     columnProps = params.columnProps,
     fieldSchema = params.fieldSchema,
     required = params.required;
@@ -470,6 +471,11 @@ var LazyAgField = exports.LazyAgField = function LazyAgField(params) {
         }
       }, resolveEmptyPlaceholder(fieldSchema));
     }
+    // 登记了只读渲染器的组件(如带颜色的 Tag)按渲染器出内容,与组件自己的阅读态一致
+    var shown = renderer && text !== '' ? renderer(liveValue, {
+      columnProps: columnProps,
+      fieldSchema: fieldSchema
+    }) : text;
     return /*#__PURE__*/_react.default.createElement("span", {
       className: "ag-array-table-lazy-text",
       style: {
@@ -477,7 +483,7 @@ var LazyAgField = exports.LazyAgField = function LazyAgField(params) {
         width: '100%',
         cursor: 'text'
       }
-    }, text);
+    }, shown);
   });
 };
 
@@ -497,6 +503,7 @@ var LazyReadOnlyText = exports.LazyReadOnlyText = function LazyReadOnlyText(para
     record = params.data,
     colDef = params.colDef,
     formatter = params.formatter,
+    renderer = params.renderer,
     columnProps = params.columnProps,
     fieldSchema = params.fieldSchema;
   var dataKey = (_fieldSchema$name2 = fieldSchema === null || fieldSchema === void 0 ? void 0 : fieldSchema.name) !== null && _fieldSchema$name2 !== void 0 ? _fieldSchema$name2 : colDef === null || colDef === void 0 ? void 0 : colDef.field;
@@ -506,13 +513,17 @@ var LazyReadOnlyText = exports.LazyReadOnlyText = function LazyReadOnlyText(para
       columnProps: columnProps,
       fieldSchema: fieldSchema
     }) : liveValue == null ? '' : String(liveValue);
+    var shown = renderer && text !== '' ? renderer(liveValue, {
+      columnProps: columnProps,
+      fieldSchema: fieldSchema
+    }) : text;
     return /*#__PURE__*/_react.default.createElement("span", {
       className: "ag-array-table-readonly-text",
       style: {
         display: 'inline-block',
         width: '100%'
       }
-    }, text);
+    }, shown);
   });
 };
 
@@ -632,7 +643,9 @@ var buildArrayTableColumns = exports.buildArrayTableColumns = function buildArra
     var readOnly = isColumnReadOnlyEligible(arrayPattern, dataField, columnProps);
     // 可编辑的数据字段(非 void 操作按钮)即使是业务自定义组件,也按兜底格式化器出懒挂载文本,默认阅读态;
     // 只读列不兜底:自定义只读组件常显示别的字段(如 SiblingText),按自身值出文本会错。@author nokecy
-    var formatter = (_getReadOnlyFormatter = (0, _readOnlyFormatters.getReadOnlyFormatter)(component)) !== null && _getReadOnlyFormatter !== void 0 ? _getReadOnlyFormatter : !readOnly && component && (dataField === null || dataField === void 0 ? void 0 : dataField.type) !== 'void' ? _readOnlyFormatters.fallbackFormatter : null;
+    // 登记了只读渲染器的组件只读列也走快路径(渲染器出内容,兜底格式化器只用于判空)。@author nokecy
+    var renderer = (0, _readOnlyFormatters.getReadOnlyRenderer)(component);
+    var formatter = (_getReadOnlyFormatter = (0, _readOnlyFormatters.getReadOnlyFormatter)(component)) !== null && _getReadOnlyFormatter !== void 0 ? _getReadOnlyFormatter : (!readOnly || renderer) && component && (dataField === null || dataField === void 0 ? void 0 : dataField.type) !== 'void' ? _readOnlyFormatters.fallbackFormatter : null;
     var hasReactions = !!(dataField && dataField['x-reactions']);
     if (!readOnly) applyNumberInputDefaults(dataField);
     var forceEager = (columnProps === null || columnProps === void 0 ? void 0 : columnProps.forceAgField) === true;
@@ -665,11 +678,32 @@ var buildArrayTableColumns = exports.buildArrayTableColumns = function buildArra
           cellRenderer: LazyReadOnlyText,
           cellRendererParams: {
             formatter: formatter,
+            renderer: renderer,
             columnProps: columnProps,
             fieldSchema: dataField
           }
         }));
       }
+      if (renderer) {
+        // 登记了渲染器:整表阅读态也出渲染器内容(如 Tag),不退化成纯文字
+        return emit(_objectSpread(_objectSpread(_objectSpread({}, base), valueGetter ? {
+          valueGetter: valueGetter
+        } : {}), {}, {
+          cellRenderer: function cellRenderer(params) {
+            var ctx = {
+              columnProps: columnProps,
+              fieldSchema: dataField
+            };
+            return formatter(params.value, ctx) === '' ? '' : renderer(params.value, ctx);
+          },
+          valueFormatter: function valueFormatter(params) {
+            return formatter(params.value, {
+              columnProps: columnProps,
+              fieldSchema: dataField
+            });
+          }
+        }));
+      }
       return emit(_objectSpread(_objectSpread(_objectSpread({}, base), valueGetter ? {
         valueGetter: valueGetter
       } : {}), {}, {
@@ -695,6 +729,7 @@ var buildArrayTableColumns = exports.buildArrayTableColumns = function buildArra
           schema: schema,
           field: field,
           formatter: formatter,
+          renderer: renderer,
           columnProps: columnProps,
           fieldSchema: dataField,
           lazyEditable: true,

package/dist/cjs/index.d.ts

@@ -29,6 +29,8 @@ export type * from "./importModal";
 export type * from "./fullScreenAlert";
 export type * from "./RuleBuilder";
 export type { ColumnConfig } from "./array-table/columnHelper";
+export { registerReadOnlyFormatter, registerReadOnlyLabels, registerReadOnlyRenderer } from "./array-table/readOnlyFormatters";
+export type { ReadOnlyFormatter, ReadOnlyFormatterCtx, ReadOnlyLabels, ReadOnlyRenderer } from "./array-table/readOnlyFormatters";
 export type { CentralizedColumnScheme, QueryScheme, SchemeStorageAdapter, SchemeSyncDataDto, CurrentSchemeDto, SchemeStorageConfig, LocalStorageAdapterConfig, BackendApiAdapterConfig, UseSchemeManagerConfig, GridPlusContextValue, GlobalConfigPermissions, } from "./ag-grid-plus";
 export * from './adapters';
 export * from "./readPretty";

package/dist/cjs/index.js

@@ -48,6 +48,9 @@ var _exportNames = {
   FlagsSelector: true,
   MatchItem: true,
   RegexRailroadDiagram: true,
+  registerReadOnlyFormatter: true,
+  registerReadOnlyLabels: true,
+  registerReadOnlyRenderer: true,
   createEntitySelect: true,
   ExportButton: true,
   buildExportUrl: true,
@@ -380,6 +383,24 @@ Object.defineProperty(exports, "nonNegativeDecimal", {
     return _businessDecimal.nonNegativeDecimal;
   }
 });
+Object.defineProperty(exports, "registerReadOnlyFormatter", {
+  enumerable: true,
+  get: function get() {
+    return _readOnlyFormatters.registerReadOnlyFormatter;
+  }
+});
+Object.defineProperty(exports, "registerReadOnlyLabels", {
+  enumerable: true,
+  get: function get() {
+    return _readOnlyFormatters.registerReadOnlyLabels;
+  }
+});
+Object.defineProperty(exports, "registerReadOnlyRenderer", {
+  enumerable: true,
+  get: function get() {
+    return _readOnlyFormatters.registerReadOnlyRenderer;
+  }
+});
 Object.defineProperty(exports, "relativeLuminance", {
   enumerable: true,
   get: function get() {
@@ -505,6 +526,7 @@ var _standardFormDialog = require("./standardFormDialog");
 var _deleteConfirm = _interopRequireDefault(require("./deleteConfirm"));
 var _RuleBuilder = require("./RuleBuilder");
 var _RegexEditor = require("./components/RegexEditor");
+var _readOnlyFormatters = require("./array-table/readOnlyFormatters");
 var _adapters = require("./adapters");
 Object.keys(_adapters).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;

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 { mergeInferredColumnType, processEllipsisColumn, processEnumColumn } from "./utils/columnProcessors";
+import { mergeInferredColumnType, processEllipsisColumn, processEnumColumn, renderDefaultCell } from "./utils/columnProcessors";
 import AdvancedQueryBuilder from "./queryForm/AdvancedQueryBuilder";
 import { v4 as uuidv4 } from 'uuid';
 import Setting from "./setting";
@@ -445,18 +445,8 @@ function AgGridPlus(props) {
     return undefined;
   };
 
-  // 辅助函数: 自定义单元格渲染器
-  var cellRenderer = function cellRenderer(params) {
-    var value = params.value,
-      node = params.node,
-      colDef = params.colDef;
-    //@ts-ignore
-    if (node.isRowPinned() || !colDef.customCellRenderer) {
-      return value;
-    }
-    //@ts-ignore
-    return colDef.customCellRenderer(params);
-  };
+  // 辅助函数: 自定义单元格渲染器（无自定义渲染器时显示 valueFormatter 的结果，见 renderDefaultCell）
+  var cellRenderer = renderDefaultCell;
 
   // 辅助函数: 处理单个列配置
   var processColumnConfig = function processColumnConfig(col, data) {

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

@@ -95,13 +95,24 @@ export declare function processEnumColumn(col: any, dataType?: DataTypeInference
  * @returns 处理后的列定义
  */
 export declare function processEllipsisColumn(col: any): ColDef;
+/**
+ * 默认单元格渲染：固定行（合计等）显示原值；数据行有自定义渲染器（`customCellRenderer`）时交给它；
+ * 否则显示 `valueFormatted`（列上配了 `valueFormatter` 时由 AG Grid 算好），没配则显示原值。
+ *
+ * 以前这里直接返回 `params.value`，普通列（没有 `type`、没有自定义渲染器）上写的 `valueFormatter`
+ * 被绕过：状态码列显示原码、「0/1」列显示 0/1，而不是格式化后的文字。
+ * 固定行保持原行为：格式化函数多按数据行写，空值常被格式化成「—」，不能让合计行冒出占位符。
+ *
+ * @author nokecy
+ */
+export declare function renderDefaultCell(params: ICellRendererParams): any;
 /**
  * 创建自定义单元格渲染器包装
  *
- * @param customRenderer 自定义渲染器
+ * @param _customRenderer 保留参数，实际取列上的 `customCellRenderer`
  * @returns 包装后的渲染器
  */
-export declare function createCellRenderer(customRenderer: any): (params: ICellRendererParams) => any;
+export declare function createCellRenderer(_customRenderer?: any): typeof renderDefaultCell;
 /**
  * 构建查询表单项
  *

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

@@ -229,26 +229,36 @@ export function processEllipsisColumn(col) {
   });
 }
 
+/**
+ * 默认单元格渲染：固定行（合计等）显示原值；数据行有自定义渲染器（`customCellRenderer`）时交给它；
+ * 否则显示 `valueFormatted`（列上配了 `valueFormatter` 时由 AG Grid 算好），没配则显示原值。
+ *
+ * 以前这里直接返回 `params.value`，普通列（没有 `type`、没有自定义渲染器）上写的 `valueFormatter`
+ * 被绕过：状态码列显示原码、「0/1」列显示 0/1，而不是格式化后的文字。
+ * 固定行保持原行为：格式化函数多按数据行写，空值常被格式化成「—」，不能让合计行冒出占位符。
+ *
+ * @author nokecy
+ */
+export function renderDefaultCell(params) {
+  var _node$isRowPinned;
+  var value = params.value,
+    valueFormatted = params.valueFormatted,
+    node = params.node,
+    colDef = params.colDef;
+  if (node !== null && node !== void 0 && (_node$isRowPinned = node.isRowPinned) !== null && _node$isRowPinned !== void 0 && _node$isRowPinned.call(node)) return value;
+  var customRenderer = colDef === null || colDef === void 0 ? void 0 : colDef.customCellRenderer;
+  if (!customRenderer) return valueFormatted !== null && valueFormatted !== void 0 ? valueFormatted : value;
+  return customRenderer(params);
+}
+
 /**
  * 创建自定义单元格渲染器包装
  *
- * @param customRenderer 自定义渲染器
+ * @param _customRenderer 保留参数，实际取列上的 `customCellRenderer`
  * @returns 包装后的渲染器
  */
-export function createCellRenderer(customRenderer) {
-  return function (params) {
-    var value = params.value,
-      node = params.node,
-      colDef = params.colDef;
-
-    // 固定行或没有自定义渲染器时，直接返回值
-    if (node.isRowPinned() || !colDef.customCellRenderer) {
-      return value;
-    }
-
-    // 使用自定义渲染器
-    return colDef.customCellRenderer(params);
-  };
+export function createCellRenderer(_customRenderer) {
+  return renderDefaultCell;
 }
 
 /**

package/dist/esm/array-table/readOnlyFormatters.d.ts

@@ -1,3 +1,4 @@
+import type { ReactNode } from 'react';
 export type ReadOnlyFormatterCtx = {
     /** 列的 x-component-props(headerName/width/options/format 等) */
     columnProps: any;
@@ -15,6 +16,31 @@ export type ReadOnlyFormatter = (value: any, ctx: ReadOnlyFormatterCtx) => strin
 export declare const fallbackFormatter: ReadOnlyFormatter;
 /** 消费方扩展自定义只读列的显示逻辑 */
 export declare const registerReadOnlyFormatter: (component: string, formatter: ReadOnlyFormatter) => void;
+/** 值 -> 名称表:对象 `{ '10': '参与' }`,或与 Select 同形的选项数组 `[{ label, value }]` */
+export type ReadOnlyLabels = Record<string, string> | Array<{
+    label?: any;
+    value?: any;
+}>;
+/**
+ * 给业务自定义选择器登记「值 -> 名称」,ArrayTable 未激活的格子与只读列按名称出文本。
+ *
+ * 业务组件(如「执行动作」「是否参与校验」这类固定选项的选择器)不在内置注册表里,
+ * 格子文本会走兜底格式化器把原值原样显示(10、00 这类编码)。在组件模块里调用一次即可,
+ * 所有用到该 x-component 的列都生效;同一组件在不同 Schema 里注册名不同时传名字数组。
+ * 按 String 宽松比对(容忍后端返回数字/字符串漂移);labelInValue 对象显示其 label;
+ * 数组逐个映射后逗号拼接;表里没有的值原样显示。@author nokecy
+ */
+export declare const registerReadOnlyLabels: (component: string | string[], labels: ReadOnlyLabels) => void;
+/** 只读渲染器:按值出一段 React 内容(如组件自己的阅读态 Tag),格子未激活和只读列都用它显示 */
+export type ReadOnlyRenderer = (value: any, ctx: ReadOnlyFormatterCtx) => ReactNode;
+/**
+ * 给业务自定义组件登记只读渲染器。登记后 ArrayTable 可编辑列未激活的格子、只读列都渲染它的返回内容,
+ * 与组件自己的阅读态一致(例如带颜色的 Tag),仍不挂 Formily 字段树。空值不调用渲染器(出占位/留空)。
+ * 只要文字时用 registerReadOnlyLabels;两者都登记时显示走渲染器。@author nokecy
+ */
+export declare const registerReadOnlyRenderer: (component: string | string[], renderer: ReadOnlyRenderer) => void;
+/** 取某组件类型的只读渲染器,未登记返回 null */
+export declare const getReadOnlyRenderer: (component: string | undefined) => ReadOnlyRenderer | null;
 /**
  * 取某组件类型的只读格式化器。命中返回函数,未命中返回 null(调用方回退 AgField)。
  */

package/dist/esm/array-table/readOnlyFormatters.js

@@ -1,3 +1,9 @@
+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; }
 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); }
 /**
  * 只读列「纯文本快路径」格式化器注册表
@@ -121,6 +127,68 @@ export var registerReadOnlyFormatter = function registerReadOnlyFormatter(compon
   registry[component] = formatter;
 };
 
+/** 值 -> 名称表:对象 `{ '10': '参与' }`,或与 Select 同形的选项数组 `[{ label, value }]` */
+
+/**
+ * 给业务自定义选择器登记「值 -> 名称」,ArrayTable 未激活的格子与只读列按名称出文本。
+ *
+ * 业务组件(如「执行动作」「是否参与校验」这类固定选项的选择器)不在内置注册表里,
+ * 格子文本会走兜底格式化器把原值原样显示(10、00 这类编码)。在组件模块里调用一次即可,
+ * 所有用到该 x-component 的列都生效;同一组件在不同 Schema 里注册名不同时传名字数组。
+ * 按 String 宽松比对(容忍后端返回数字/字符串漂移);labelInValue 对象显示其 label;
+ * 数组逐个映射后逗号拼接;表里没有的值原样显示。@author nokecy
+ */
+export var registerReadOnlyLabels = function registerReadOnlyLabels(component, labels) {
+  var map = new Map();
+  if (Array.isArray(labels)) {
+    labels.forEach(function (o) {
+      var _o$label;
+      if (o && o.value != null) map.set(String(o.value), String((_o$label = o.label) !== null && _o$label !== void 0 ? _o$label : o.value));
+    });
+  } else {
+    Object.entries(labels !== null && labels !== void 0 ? labels : {}).forEach(function (_ref7) {
+      var _ref8 = _slicedToArray(_ref7, 2),
+        k = _ref8[0],
+        v = _ref8[1];
+      return map.set(String(k), String(v));
+    });
+  }
+  var toText = function toText(v) {
+    var _ref9, _v$label, _map$get;
+    if (v == null || v === '') return '';
+    if (_typeof(v) === 'object') return String((_ref9 = (_v$label = v.label) !== null && _v$label !== void 0 ? _v$label : v.value) !== null && _ref9 !== void 0 ? _ref9 : '');
+    return (_map$get = map.get(String(v))) !== null && _map$get !== void 0 ? _map$get : String(v);
+  };
+  var formatter = function formatter(value) {
+    return Array.isArray(value) ? value.map(toText).filter(Boolean).join(', ') : toText(value);
+  };
+  (Array.isArray(component) ? component : [component]).forEach(function (name) {
+    return registerReadOnlyFormatter(name, formatter);
+  });
+};
+
+/** 只读渲染器:按值出一段 React 内容(如组件自己的阅读态 Tag),格子未激活和只读列都用它显示 */
+
+var renderers = {};
+
+/**
+ * 给业务自定义组件登记只读渲染器。登记后 ArrayTable 可编辑列未激活的格子、只读列都渲染它的返回内容,
+ * 与组件自己的阅读态一致(例如带颜色的 Tag),仍不挂 Formily 字段树。空值不调用渲染器(出占位/留空)。
+ * 只要文字时用 registerReadOnlyLabels;两者都登记时显示走渲染器。@author nokecy
+ */
+export var registerReadOnlyRenderer = function registerReadOnlyRenderer(component, renderer) {
+  (Array.isArray(component) ? component : [component]).forEach(function (name) {
+    renderers[name] = renderer;
+  });
+};
+
+/** 取某组件类型的只读渲染器,未登记返回 null */
+export var getReadOnlyRenderer = function getReadOnlyRenderer(component) {
+  var _renderers$component;
+  if (!component) return null;
+  return (_renderers$component = renderers[component]) !== null && _renderers$component !== void 0 ? _renderers$component : null;
+};
+
 /**
  * 取某组件类型的只读格式化器。命中返回函数,未命中返回 null(调用方回退 AgField)。
  */