@nokecy/qc-ui 1.1.80 → 1.1.81

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/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)。
  */

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

@@ -22,7 +22,7 @@ import { useField, useFieldSchema, RecursionField, Observer, useExpressionScope
 import { isArr, lazyMerge } from '@formily/shared';
 import { Schema } from '@formily/json-schema';
 import ArrayBase from "./arrayBase";
-import { fallbackFormatter, getReadOnlyFormatter } from "./readOnlyFormatters";
+import { fallbackFormatter, getReadOnlyFormatter, getReadOnlyRenderer } from "./readOnlyFormatters";
 import { markHeaderGroup } from "./columnGroup";
 import { CellFocusScope } from "./cellFocusScope";
 var isColumnComponent = function isColumnComponent(schema) {
@@ -342,6 +342,7 @@ var 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;
@@ -461,6 +462,11 @@ var LazyAgField = function LazyAgField(params) {
         }
       }, resolveEmptyPlaceholder(fieldSchema));
     }
+    // 登记了只读渲染器的组件(如带颜色的 Tag)按渲染器出内容,与组件自己的阅读态一致
+    var shown = renderer && text !== '' ? renderer(liveValue, {
+      columnProps: columnProps,
+      fieldSchema: fieldSchema
+    }) : text;
     return /*#__PURE__*/React.createElement("span", {
       className: "ag-array-table-lazy-text",
       style: {
@@ -468,7 +474,7 @@ var LazyAgField = function LazyAgField(params) {
         width: '100%',
         cursor: 'text'
       }
-    }, text);
+    }, shown);
   });
 };
 
@@ -488,6 +494,7 @@ var LazyReadOnlyText = function LazyReadOnlyText(params) {
     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;
@@ -497,13 +504,17 @@ var LazyReadOnlyText = function LazyReadOnlyText(params) {
       columnProps: columnProps,
       fieldSchema: fieldSchema
     }) : liveValue == null ? '' : String(liveValue);
+    var shown = renderer && text !== '' ? renderer(liveValue, {
+      columnProps: columnProps,
+      fieldSchema: fieldSchema
+    }) : text;
     return /*#__PURE__*/React.createElement("span", {
       className: "ag-array-table-readonly-text",
       style: {
         display: 'inline-block',
         width: '100%'
       }
-    }, text);
+    }, shown);
   });
 };
 
@@ -623,7 +634,9 @@ var buildArrayTableColumns = function buildArrayTableColumns(dataSource, field,
     var readOnly = isColumnReadOnlyEligible(arrayPattern, dataField, columnProps);
     // 可编辑的数据字段(非 void 操作按钮)即使是业务自定义组件,也按兜底格式化器出懒挂载文本,默认阅读态;
     // 只读列不兜底:自定义只读组件常显示别的字段(如 SiblingText),按自身值出文本会错。@author nokecy
-    var formatter = (_getReadOnlyFormatter = getReadOnlyFormatter(component)) !== null && _getReadOnlyFormatter !== void 0 ? _getReadOnlyFormatter : !readOnly && component && (dataField === null || dataField === void 0 ? void 0 : dataField.type) !== 'void' ? fallbackFormatter : null;
+    // 登记了只读渲染器的组件只读列也走快路径(渲染器出内容,兜底格式化器只用于判空)。@author nokecy
+    var renderer = getReadOnlyRenderer(component);
+    var formatter = (_getReadOnlyFormatter = getReadOnlyFormatter(component)) !== null && _getReadOnlyFormatter !== void 0 ? _getReadOnlyFormatter : (!readOnly || renderer) && component && (dataField === null || dataField === void 0 ? void 0 : dataField.type) !== 'void' ? fallbackFormatter : null;
     var hasReactions = !!(dataField && dataField['x-reactions']);
     if (!readOnly) applyNumberInputDefaults(dataField);
     var forceEager = (columnProps === null || columnProps === void 0 ? void 0 : columnProps.forceAgField) === true;
@@ -656,11 +669,32 @@ var buildArrayTableColumns = function buildArrayTableColumns(dataSource, field,
           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
       } : {}), {}, {
@@ -686,6 +720,7 @@ var buildArrayTableColumns = function buildArrayTableColumns(dataSource, field,
           schema: schema,
           field: field,
           formatter: formatter,
+          renderer: renderer,
           columnProps: columnProps,
           fieldSchema: dataField,
           lazyEditable: true,

package/dist/esm/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/esm/index.js

@@ -35,6 +35,9 @@ useSchemeManager, useGridSchemes, LocalStorageSchemeAdapter, BackendApiSchemeAda
 
 // 导出类型定义
 
+// ArrayTable 格子文本:业务自定义组件登记「值 -> 名称」或自定义格式化器
+export { registerReadOnlyFormatter, registerReadOnlyLabels, registerReadOnlyRenderer } from "./array-table/readOnlyFormatters";
+
 // 集中式方案管理类型
 
 // 注意: 旧的方案管理类型已废弃