@nokecy/qc-ui-components 0.0.0-stage → 2.0.0-beta.0

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

@@ -0,0 +1,19 @@
+import type { ColDef } from 'ag-grid-community';
+/** 默认序号列的字段名;不对应任何数据字段,值由 valueGetter 按行位置生成 */
+export declare const ARRAY_TABLE_INDEX_FIELD = "__arrayTableIndex";
+/** schema 里含 ArrayTable.Index / ArrayBase.Index 之类的序号组件 */
+export declare const containsIndexComponent: (schema: any) => boolean;
+/**
+ * 表格是否已经自己写了序号列(某个可见列里放了 ArrayTable.Index)。
+ * 写了就不再加默认序号列,免得出现两列序号;「行号」等业务数据列不算序号列。@author nokecy
+ */
+export declare const hasOwnIndexColumn: (sources: Array<{
+    schema: any;
+    display?: string;
+}>) => boolean;
+/**
+ * 默认序号列:按行在表格里的位置编号(1 起),不依赖业务行号或主键,与列表页的序号一致。
+ * 固定在左侧、位于勾选列之后，不可隐藏/拖动/排序;合计等固定行不编号。
+ * 增删行、拖动换行后由 ArrayTable 在 onRowDataUpdated 里刷新本列,见 index.tsx。@author nokecy
+ */
+export declare const makeIndexColumn: () => ColDef;

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

@@ -0,0 +1,52 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.makeIndexColumn = exports.hasOwnIndexColumn = exports.containsIndexComponent = exports.ARRAY_TABLE_INDEX_FIELD = void 0;
+var _gridSequence = require("../shared/gridSequence");
+/** 默认序号列的字段名;不对应任何数据字段,值由 valueGetter 按行位置生成 */
+var ARRAY_TABLE_INDEX_FIELD = exports.ARRAY_TABLE_INDEX_FIELD = '__arrayTableIndex';
+
+/** schema 里含 ArrayTable.Index / ArrayBase.Index 之类的序号组件 */
+var containsIndexComponent = exports.containsIndexComponent = function containsIndexComponent(schema) {
+  var _schema$properties;
+  if (!schema) return false;
+  var component = schema['x-component'];
+  // ArrayTable.Index / ArrayBase.Index，以及业务常用的 ArrayTableIndex（还会把行号写进数据字段）
+  if (typeof component === 'string' && /(?:^|\.)(?:Array(?:Table)?)?Index$/.test(component)) return true;
+  return Object.values((_schema$properties = schema.properties) !== null && _schema$properties !== void 0 ? _schema$properties : {}).some(containsIndexComponent);
+};
+
+/**
+ * 表格是否已经自己写了序号列(某个可见列里放了 ArrayTable.Index)。
+ * 写了就不再加默认序号列,免得出现两列序号;「行号」等业务数据列不算序号列。@author nokecy
+ */
+var hasOwnIndexColumn = exports.hasOwnIndexColumn = function hasOwnIndexColumn(sources) {
+  return sources.some(function (_ref) {
+    var schema = _ref.schema,
+      display = _ref.display;
+    return (!display || display === 'visible') && containsIndexComponent(schema);
+  });
+};
+
+/**
+ * 默认序号列:按行在表格里的位置编号(1 起),不依赖业务行号或主键,与列表页的序号一致。
+ * 固定在左侧、位于勾选列之后，不可隐藏/拖动/排序;合计等固定行不编号。
+ * 增删行、拖动换行后由 ArrayTable 在 onRowDataUpdated 里刷新本列,见 index.tsx。@author nokecy
+ */
+var makeIndexColumn = exports.makeIndexColumn = function makeIndexColumn() {
+  return (0, _gridSequence.withDisplaySequencePolicy)({
+    field: ARRAY_TABLE_INDEX_FIELD,
+    headerName: '序号',
+    width: 60,
+    pinned: 'left',
+    resizable: false,
+    valueGetter: function valueGetter(params) {
+      var _params$node, _params$node2;
+      if ((_params$node = params.node) !== null && _params$node !== void 0 && _params$node.rowPinned) return '';
+      var rowIndex = (_params$node2 = params.node) === null || _params$node2 === void 0 ? void 0 : _params$node2.rowIndex;
+      return rowIndex == null ? '' : rowIndex + 1;
+    }
+  });
+};

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

@@ -0,0 +1,64 @@
+import { ArrayBaseMixins } from "@nokecy/formily-antd";
+import { FieldDisplayTypes, GeneralField } from "@nokecy/formily-core";
+import { Schema } from "@nokecy/formily-json-schema";
+import { AgGridReactProps } from "ag-grid-react";
+import React from "react";
+/**
+ * ArrayTable.Column 的 x-component-props 里 qc-ui 自己认的扩展属性;
+ * 其余属性(width、headerName、pinned 等)按 AG-Grid 列定义处理。
+ *
+ * @author nokecy
+ */
+interface ArrayTableColumnProps {
+    /** 提交时必填的列头提示；由业务配置决定，不会把草稿字段改为必填。@author nokecy */
+    requiredMark?: boolean;
+    /**
+     * 表头分组名(多级表头,仅一级)。
+     * 相邻且 headerGroup 相同的列合并成一个列组,分组名作为组头;
+     * 同名但不相邻的列各自成组;不写则该列不分组。
+     */
+    headerGroup?: string;
+    /**
+     * 默认隐藏:为 true 时该列首次出现时是隐藏的,用户可在列设置里打开,列方案(applyColumnState)优先。
+     * 对应 AG-Grid 的 initialHide。注意 hide 在 ArrayTable 里不生效(状态归列方案管),要默认隐藏请用它。
+     */
+    defaultHide?: boolean;
+    /**
+     * 固定列(antd Table 写法):'left' | 'right' | true(等同 'left')。
+     * 映射成 AG-Grid 的 pinned;同时写了 pinned 时以 pinned 为准。
+     */
+    fixed?: "left" | "right" | boolean;
+    /** 固定列(AG-Grid 写法),优先于 fixed;显式 null 表示不固定 */
+    pinned?: "left" | "right" | null;
+}
+interface ObservableColumnSource {
+    /** 当前 SchemaField 的组件表，用于读取业务组件的展示规则。@author nokecy */
+    components?: Record<string, any>;
+    field: GeneralField;
+    columnProps: ArrayTableColumnProps & Record<string, any>;
+    schema: Schema;
+    display: FieldDisplayTypes;
+    name: string;
+}
+/** 公共明细表格的业务属性。@author nokecy */
+export type ArrayTableProps = AgGridReactProps & {
+    height?: number | string;
+    gridKey: string;
+    onRowDrag?: boolean;
+    disabled?: boolean;
+    /** 默认对配置标准删除入口的可编辑明细开放批量删除；false 可显式关闭。 */
+    batchRemove?: boolean;
+    onRemove?: (index: number) => void;
+    /**
+     * fixed 别名的宽度保护阈值(0~1,默认 0.5):固定列(左+右)总宽超过表格宽度的这个比例时,
+     * 取消由 fixed 推导的固定列(左固定从最靠内侧开始,右固定优先保留),表格变宽后恢复。
+     * 显式写的 pinned 不受影响。传 1 或 Infinity 关闭保护。
+     */
+    fixedColumnsMaxRatio?: number;
+};
+/** ArrayTable 自己认的属性(其余按 AgGridReact 属性处理) */
+type ArrayTableOwnProps = Omit<ArrayTableProps, keyof AgGridReactProps>;
+type ComposedArrayTable = React.FC<React.PropsWithChildren<ArrayTableProps>> & ArrayBaseMixins & {
+    Column?: any;
+};
+export { ArrayTableOwnProps, ComposedArrayTable, ObservableColumnSource, ArrayTableColumnProps };

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

@@ -0,0 +1,5 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});

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

@@ -0,0 +1,3 @@
+import { ComposedArrayTable } from "./interface";
+declare const ArrayTable: ComposedArrayTable;
+export default ArrayTable;

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

@@ -0,0 +1,75 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _react = _interopRequireDefault(require("react"));
+var _formilyReact = require("@nokecy/formily-react");
+var _utils = require("./utils");
+var _index = require("../ag-grid-plus/index");
+var _theme = require("./theme");
+var _indexColumn = require("./indexColumn");
+var _gridSequence = require("../shared/gridSequence");
+var _jsxRuntime = require("react/jsx-runtime");
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+//@ts-ignore
+var ArrayTable = function ArrayTable(props) {
+  var _buildArrayTableColum;
+  var height = props.height;
+  var arrayTablePreviewTheme = (0, _theme.useArrayTableTheme)();
+  var field = (0, _formilyReact.useField)();
+  var dataSource = Array.isArray(field.value) ? field.value.slice() : [];
+  var sources = (0, _utils.useArrayTableSources)();
+  var columns = (_buildArrayTableColum = (0, _utils.buildArrayTableColumns)(dataSource, field, sources)) !== null && _buildArrayTableColum !== void 0 ? _buildArrayTableColum : [];
+  // 阅读态与编辑态共用默认序号规则，已有序号列时不重复添加。@author nokecy
+  var showDefaultIndex = columns.length > 0 && !(0, _indexColumn.hasOwnIndexColumn)(sources);
+  if (showDefaultIndex) {
+    columns.unshift((0, _indexColumn.makeIndexColumn)());
+  }
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)("div", {
+    style: {
+      height: height ? height : 400
+    },
+    children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_index.AgGridPlus, {
+      gridOptions: {
+        enableCellTextSelection: true,
+        ensureDomOrder: true
+      },
+      getRowId: function getRowId(_ref) {
+        var data = _ref.data;
+        return data._id || data.id;
+      },
+      hideTool: true,
+      search: false,
+      theme: arrayTablePreviewTheme,
+      rowHeight: _theme.ARRAY_TABLE_ROW_HEIGHT,
+      onGridReady: function onGridReady(event) {
+        var _props$onGridReady;
+        (0, _gridSequence.installDisplaySequenceOrder)(event.api);
+        (_props$onGridReady = props.onGridReady) === null || _props$onGridReady === void 0 || _props$onGridReady.call(props, event);
+      },
+      pagination: false,
+      onSortChanged: function onSortChanged(event) {
+        var _props$onSortChanged;
+        if (showDefaultIndex) event.api.refreshCells({
+          columns: [_indexColumn.ARRAY_TABLE_INDEX_FIELD],
+          force: true
+        });
+        (_props$onSortChanged = props.onSortChanged) === null || _props$onSortChanged === void 0 || _props$onSortChanged.call(props, event);
+      },
+      onRowDataUpdated: function onRowDataUpdated(event) {
+        // 阅读态明细替换或重排后刷新序号，不向表单写入编号。@author nokecy
+        if (showDefaultIndex) {
+          event.api.refreshCells({
+            columns: [_indexColumn.ARRAY_TABLE_INDEX_FIELD],
+            force: true
+          });
+        }
+      },
+      columnDefs: columns,
+      rowData: dataSource
+    })
+  });
+};
+var _default = exports.default = ArrayTable;

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

@@ -0,0 +1,60 @@
+import type { ReactNode } from 'react';
+/** 选择器的展示字段；只影响回显，不改变 labelInValue 的提交值。@author nokecy */
+export type SelectDisplayField = 'value' | 'label';
+/** 从选择值提取展示文字；编码展示不能因描述为空或过期而改变。@author nokecy */
+export declare const formatSelectDisplay: (value: any, displayField?: SelectDisplayField) => string;
+/** 给选择组件声明与其回显一致的表格格式化器，组件别名和不同页面各自生效。@author nokecy */
+export declare const withReadOnlyFormatter: <T>(component: T, formatter: ReadOnlyFormatter) => T & {
+    readOnlyFormatter: ReadOnlyFormatter;
+};
+export type ReadOnlyFormatterCtx = {
+    /** 列的 x-component-props(headerName/width/options/format 等) */
+    columnProps: any;
+    /** 内层数据字段的 schema(可读 enum / x-component-props) */
+    fieldSchema: any;
+    /**
+     * 运行时才确定的选项(field.setDataSource / setFieldState 写入的 dataSource)。
+     * 懒挂载格子没有自己的 Formily 字段时，由调用方取同列已创建字段的选项带进来；有值时优先于 schema 静态选项。
+     */
+    dataSource?: any[];
+};
+export type ReadOnlyFormatter = (value: any, ctx: ReadOnlyFormatterCtx) => string;
+/**
+ * 兜底格式化器:注册表里没有的组件(业务自定义的选择器、输入框等),可编辑列按它出懒挂载文本。
+ *
+ * 显示与控件失焦时看到的一致:原始值原样显示;labelInValue 对象 / 解构字段({value,label})显示 label,
+ * 没有 label 才显示 value;数组逐个显示后逗号拼接。显示需要按编码查名称等特殊逻辑的组件,
+ * 消费方用 registerReadOnlyFormatter 注册专用格式化器覆盖。@author nokecy
+ */
+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)。
+ */
+export declare const getReadOnlyFormatter: (component: string | undefined, components?: Record<string, any>) => ReadOnlyFormatter | null;

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

@@ -0,0 +1,282 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.withReadOnlyFormatter = exports.registerReadOnlyRenderer = exports.registerReadOnlyLabels = exports.registerReadOnlyFormatter = exports.getReadOnlyRenderer = exports.getReadOnlyFormatter = exports.formatSelectDisplay = exports.fallbackFormatter = void 0;
+var _dayjs = _interopRequireDefault(require("dayjs"));
+var _optionValue = require("../shared/optionValue");
+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); } /**
+ * 只读列「纯文本快路径」格式化器注册表
+ *
+ * 背景:ArrayTable 每个可见单元格默认挂一棵完整 Formily 字段树(AgField),
+ * 行虚拟化滚动时整行销毁重建,列多必然掉帧。只读列没有编辑/校验/写回,
+ * 完全可以不挂 Formily 树、改用 AG-Grid 的 valueFormatter 出纯文本。
+ *
+ * 本注册表负责「内层组件类型 -> 显示文本」的映射。命中返回格式化器,
+ * 未命中返回 null —— 调用方据此安全回退 AgField(正确优先于速度)。
+ *
+ * 取舍:这是 Formily readPretty 之外的一份精简显示逻辑,可能与定制 readPretty
+ * 发散。靠「未命中即回退 + 消费方可 registerReadOnlyFormatter 扩展」控制风险。
+ *
+ * @author nokecy
+ */
+/** 选择器的展示字段；只影响回显，不改变 labelInValue 的提交值。@author nokecy */
+
+/** 从选择值提取展示文字；编码展示不能因描述为空或过期而改变。@author nokecy */
+var formatSelectDisplay = exports.formatSelectDisplay = function formatSelectDisplay(value) {
+  var _value$label;
+  var displayField = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 'label';
+  if (value == null) return '';
+  if (Array.isArray(value)) return value.map(function (item) {
+    return formatSelectDisplay(item, displayField);
+  }).filter(Boolean).join(', ');
+  if (_typeof(value) === 'object') return formatSelectDisplay(displayField === 'value' ? value.value : (_value$label = value.label) !== null && _value$label !== void 0 ? _value$label : value.value, displayField);
+  return String(value);
+};
+
+/** 给选择组件声明与其回显一致的表格格式化器，组件别名和不同页面各自生效。@author nokecy */
+var withReadOnlyFormatter = exports.withReadOnlyFormatter = function withReadOnlyFormatter(component, formatter) {
+  return Object.assign(component, {
+    readOnlyFormatter: formatter
+  });
+};
+/** 从字段 schema / 列 props 里尽量取到 Select 的可选项(value->label 映射用) */
+var resolveOptions = function resolveOptions(ctx) {
+  var _ref, _ref2, _ref3, _fieldSchema$enum, _fieldSchema$xCompon, _fieldSchema$xCompon2;
+  var columnProps = ctx.columnProps,
+    fieldSchema = ctx.fieldSchema;
+  if (Array.isArray(ctx.dataSource) && ctx.dataSource.length > 0) return ctx.dataSource;
+  var candidate = (_ref = (_ref2 = (_ref3 = (_fieldSchema$enum = fieldSchema === null || fieldSchema === void 0 ? void 0 : fieldSchema.enum) !== null && _fieldSchema$enum !== void 0 ? _fieldSchema$enum : fieldSchema === null || fieldSchema === void 0 || (_fieldSchema$xCompon = fieldSchema['x-component-props']) === null || _fieldSchema$xCompon === void 0 ? void 0 : _fieldSchema$xCompon.options) !== null && _ref3 !== void 0 ? _ref3 : fieldSchema === null || fieldSchema === void 0 || (_fieldSchema$xCompon2 = fieldSchema['x-component-props']) === null || _fieldSchema$xCompon2 === void 0 ? void 0 : _fieldSchema$xCompon2.dataSource) !== null && _ref2 !== void 0 ? _ref2 : columnProps === null || columnProps === void 0 ? void 0 : columnProps.options) !== null && _ref !== void 0 ? _ref : columnProps === null || columnProps === void 0 ? void 0 : columnProps.dataSource;
+  return Array.isArray(candidate) ? candidate : [];
+};
+
+/** 单个值映射成 label:兼容 labelInValue 对象、{label,value} 选项、原始值 */
+var mapOptionLabel = function mapOptionLabel(value, options) {
+  var _ref4, _hit$label;
+  if (value == null) return '';
+  // labelInValue: 值本身就是 { label, value }
+  if (_typeof(value) === 'object') {
+    var label = value.label;
+    return label != null && label !== value.value ? String(label) : mapOptionLabel(value.value, options);
+  }
+  // 定长码值可能带补齐空格；与编辑控件、列表使用同一选项匹配规则。@author nokecy
+  var hit = (0, _optionValue.findOptionByValue)(options, value, function (o) {
+    return o && _typeof(o) === 'object' ? o.value : o;
+  });
+  if (hit && _typeof(hit) === 'object') return String((_ref4 = (_hit$label = hit.label) !== null && _hit$label !== void 0 ? _hit$label : hit.value) !== null && _ref4 !== void 0 ? _ref4 : value);
+  return String(value);
+};
+var textFormatter = function textFormatter(value) {
+  return value == null ? '' : String(value);
+};
+var selectFormatter = function selectFormatter(value, ctx) {
+  var _ctx$fieldSchema;
+  if (value == null) return '';
+  if (((_ctx$fieldSchema = ctx.fieldSchema) === null || _ctx$fieldSchema === void 0 || (_ctx$fieldSchema = _ctx$fieldSchema['x-component-props']) === null || _ctx$fieldSchema === void 0 ? void 0 : _ctx$fieldSchema.displayField) === 'value') return formatSelectDisplay(value, 'value');
+  var options = resolveOptions(ctx);
+  // 多选:数组 -> 逗号拼接
+  if (Array.isArray(value)) {
+    return value.map(function (v) {
+      return mapOptionLabel(v, options);
+    }).filter(Boolean).join(', ');
+  }
+  return mapOptionLabel(value, options);
+};
+
+/**
+ * 日期/时间控件没写 format 时的默认显示格式，与 antd 控件自己的默认一致：
+ * TimePicker 只显示时间；showTime 带到秒；按月/按年选择器只显示到月/年。
+ * 文本态与点开后的控件看到同一个格式，不然 showTime 的列平时只见日期、点开才见时间。
+ */
+var defaultDateFormat = function defaultDateFormat(component, props) {
+  if (component === 'TimePicker') return props !== null && props !== void 0 && props.use12Hours ? 'hh:mm:ss a' : 'HH:mm:ss';
+  if ((props === null || props === void 0 ? void 0 : props.picker) === 'month') return 'YYYY-MM';
+  if ((props === null || props === void 0 ? void 0 : props.picker) === 'year') return 'YYYY';
+  if (props !== null && props !== void 0 && props.showTime) return 'YYYY-MM-DD HH:mm:ss';
+  return 'YYYY-MM-DD';
+};
+var dateFormatter = function dateFormatter(value, ctx) {
+  var _ctx$fieldSchema2, _ctx$columnProps, _ctx$fieldSchema3;
+  if (value == null || value === '') return '';
+  var props = (_ctx$fieldSchema2 = ctx.fieldSchema) === null || _ctx$fieldSchema2 === void 0 ? void 0 : _ctx$fieldSchema2['x-component-props'];
+  // antd 的 format 还可以是数组/函数，文本态只认字符串，其余回到默认
+  var configured = [(_ctx$columnProps = ctx.columnProps) === null || _ctx$columnProps === void 0 ? void 0 : _ctx$columnProps.format, props === null || props === void 0 ? void 0 : props.format].find(function (f) {
+    return typeof f === 'string' && f;
+  });
+  var fmt = configured !== null && configured !== void 0 ? configured : defaultDateFormat((_ctx$fieldSchema3 = ctx.fieldSchema) === null || _ctx$fieldSchema3 === void 0 ? void 0 : _ctx$fieldSchema3['x-component'], props);
+  if (typeof value.format === 'function') return value.format(fmt);
+  // 后端回来的多是 ISO 串(2024-10-19T00:00:00)或时间戳:与 Formily readPretty 一致,按 dayjs(value).format(fmt) 显示;
+  // 解析不了的文本(如「待定」、纯时间 08:30:00)原样显示,不吞掉。dayjs 随 antd 传递依赖引入,本库其他模块已直接使用。
+  var parsed = (0, _dayjs.default)(value);
+  return parsed.isValid() ? parsed.format(fmt) : String(value);
+};
+
+/**
+ * 数字格：按控件的 precision 补齐小数位、按 formatter 属性（千分位、百分号等）显示，
+ * 与点开后的 InputNumber 一致；没配这两项时与原样输出相同。
+ */
+var numberFormatter = function numberFormatter(value, ctx) {
+  var _ctx$fieldSchema$xCo, _ctx$fieldSchema4, _ctx$columnProps$prec, _ctx$columnProps2, _ctx$columnProps$form, _ctx$columnProps3;
+  if (value == null || value === '') return '';
+  var props = (_ctx$fieldSchema$xCo = (_ctx$fieldSchema4 = ctx.fieldSchema) === null || _ctx$fieldSchema4 === void 0 ? void 0 : _ctx$fieldSchema4['x-component-props']) !== null && _ctx$fieldSchema$xCo !== void 0 ? _ctx$fieldSchema$xCo : {};
+  var precision = (_ctx$columnProps$prec = (_ctx$columnProps2 = ctx.columnProps) === null || _ctx$columnProps2 === void 0 ? void 0 : _ctx$columnProps2.precision) !== null && _ctx$columnProps$prec !== void 0 ? _ctx$columnProps$prec : props.precision;
+  var num = Number(value);
+  var base = typeof precision === 'number' && precision >= 0 && Number.isFinite(num) ? num.toFixed(precision) : String(value);
+  var formatter = (_ctx$columnProps$form = (_ctx$columnProps3 = ctx.columnProps) === null || _ctx$columnProps3 === void 0 ? void 0 : _ctx$columnProps3.formatter) !== null && _ctx$columnProps$form !== void 0 ? _ctx$columnProps$form : props.formatter;
+  if (typeof formatter === 'function') {
+    try {
+      return String(formatter(base, {
+        userTyping: false,
+        input: ''
+      }));
+    } catch (_unused) {
+      return base;
+    }
+  }
+  return base;
+};
+var booleanFormatter = function booleanFormatter(value, ctx) {
+  var _ctx$fieldSchema$xCo2, _ctx$fieldSchema5, _props$checkedChildre, _props$unCheckedChild;
+  if (value == null || value === '') return '';
+  var props = (_ctx$fieldSchema$xCo2 = (_ctx$fieldSchema5 = ctx.fieldSchema) === null || _ctx$fieldSchema5 === void 0 ? void 0 : _ctx$fieldSchema5['x-component-props']) !== null && _ctx$fieldSchema$xCo2 !== void 0 ? _ctx$fieldSchema$xCo2 : {};
+  var truthy = (_props$checkedChildre = props.checkedChildren) !== null && _props$checkedChildre !== void 0 ? _props$checkedChildre : '是';
+  var falsy = (_props$unCheckedChild = props.unCheckedChildren) !== null && _props$unCheckedChild !== void 0 ? _props$unCheckedChild : '否';
+  return value ? String(truthy) : String(falsy);
+};
+
+/**
+ * 内置注册表。key 为 Formily x-component 名。
+ * 未列出的组件类型 -> getReadOnlyFormatter 返回 null -> 回退 AgField。
+ */
+var registry = {
+  Input: textFormatter,
+  'Input.TextArea': textFormatter,
+  Password: textFormatter,
+  Text: textFormatter,
+  Preview: textFormatter,
+  NumberPicker: numberFormatter,
+  InputNumber: numberFormatter,
+  Select: selectFormatter,
+  TreeSelect: selectFormatter,
+  Cascader: selectFormatter,
+  'Radio.Group': selectFormatter,
+  'Checkbox.Group': selectFormatter,
+  DatePicker: dateFormatter,
+  TimePicker: dateFormatter,
+  Switch: booleanFormatter,
+  Checkbox: booleanFormatter
+};
+
+/**
+ * 兜底格式化器:注册表里没有的组件(业务自定义的选择器、输入框等),可编辑列按它出懒挂载文本。
+ *
+ * 显示与控件失焦时看到的一致:原始值原样显示;labelInValue 对象 / 解构字段({value,label})显示 label,
+ * 没有 label 才显示 value;数组逐个显示后逗号拼接。显示需要按编码查名称等特殊逻辑的组件,
+ * 消费方用 registerReadOnlyFormatter 注册专用格式化器覆盖。@author nokecy
+ */
+var fallbackFormatter = exports.fallbackFormatter = function fallbackFormatter(value, ctx) {
+  var _ctx$fieldSchema6;
+  if (value == null || value === '') return '';
+  if (((_ctx$fieldSchema6 = ctx.fieldSchema) === null || _ctx$fieldSchema6 === void 0 || (_ctx$fieldSchema6 = _ctx$fieldSchema6['x-component-props']) === null || _ctx$fieldSchema6 === void 0 ? void 0 : _ctx$fieldSchema6.displayField) === 'value') return formatSelectDisplay(value, 'value');
+  if (Array.isArray(value)) return value.map(function (v) {
+    return fallbackFormatter(v, ctx);
+  }).filter(Boolean).join(', ');
+  if (typeof value === 'boolean') return booleanFormatter(value, ctx);
+  if (_typeof(value) === 'object') {
+    var _value$label2;
+    if (typeof value.format === 'function') return dateFormatter(value, ctx);
+    var shown = (_value$label2 = value.label) !== null && _value$label2 !== void 0 ? _value$label2 : value.value;
+    return shown == null ? '' : String(shown);
+  }
+  return String(value);
+};
+
+/** 消费方扩展自定义只读列的显示逻辑 */
+var registerReadOnlyFormatter = exports.registerReadOnlyFormatter = function registerReadOnlyFormatter(component, formatter) {
+  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 (_ref5) {
+      var _ref6 = _slicedToArray(_ref5, 2),
+        k = _ref6[0],
+        v = _ref6[1];
+      return map.set(String(k), String(v));
+    });
+  }
+  var toText = function toText(v) {
+    if (v == null || v === '') return '';
+    if (_typeof(v) === 'object') return v.label != null && v.label !== v.value ? String(v.label) : toText(v.value);
+    var key = (0, _optionValue.findOptionByValue)(Array.from(map.keys()), v, function (key) {
+      return key;
+    });
+    return key === undefined ? String(v) : map.get(key);
+  };
+  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)。
+ */
+var getReadOnlyFormatter = exports.getReadOnlyFormatter = function getReadOnlyFormatter(component, components) {
+  var _registry$component;
+  if (!component) return null;
+  var control = component.split('.').reduce(function (current, key) {
+    return current === null || current === void 0 ? void 0 : current[key];
+  }, components);
+  if (typeof (control === null || control === void 0 ? void 0 : control.readOnlyFormatter) === 'function') return control.readOnlyFormatter;
+  return (_registry$component = registry[component]) !== null && _registry$component !== void 0 ? _registry$component : null;
+};

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

@@ -0,0 +1,5 @@
+import type { ColDef } from 'ag-grid-community';
+/** 字段规则与提交专用标识共同决定列头提示；格式校验不等于必填。@author nokecy */
+export declare function isRequiredColumn(schema: any, submitRequired?: unknown): boolean;
+/** 只改变编辑表头的样式和提示，保留原始列名以供复制、导出、排序及列方案使用。@author nokecy */
+export declare function withRequiredColumnHeader(column: ColDef, required: boolean, readOnly: boolean): ColDef;

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

@@ -0,0 +1,40 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.isRequiredColumn = isRequiredColumn;
+exports.withRequiredColumnHeader = withRequiredColumnHeader;
+function _toConsumableArray(arr) { return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableSpread(); }
+function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread 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 _iterableToArray(iter) { if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter); }
+function _arrayWithoutHoles(arr) { if (Array.isArray(arr)) return _arrayLikeToArray(arr); }
+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 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); }
+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); }
+/** 字段规则与提交专用标识共同决定列头提示；格式校验不等于必填。@author nokecy */
+function isRequiredColumn(schema, submitRequired) {
+  if (submitRequired === true || (schema === null || schema === void 0 ? void 0 : schema.required) === true) return true;
+  var validators = Array.isArray(schema === null || schema === void 0 ? void 0 : schema['x-validator']) ? schema['x-validator'] : [schema === null || schema === void 0 ? void 0 : schema['x-validator']];
+  return validators.some(function (rule) {
+    return rule && _typeof(rule) === 'object' && rule.required === true;
+  });
+}
+
+/** 只改变编辑表头的样式和提示，保留原始列名以供复制、导出、排序及列方案使用。@author nokecy */
+function withRequiredColumnHeader(column, required, readOnly) {
+  if (!required || readOnly) return column;
+  var original = column.headerClass;
+  return _objectSpread(_objectSpread({}, column), {}, {
+    headerTooltip: column.headerTooltip ? "".concat(column.headerTooltip, "\uFF08\u5FC5\u586B\uFF09") : '必填',
+    headerClass: function headerClass(params) {
+      var classes = typeof original === 'function' ? original(params) : original;
+      return Array.from(new Set([].concat(_toConsumableArray(Array.isArray(classes) ? classes : classes ? [classes] : []), ['qc-array-table-required'])));
+    }
+  });
+}

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

@@ -0,0 +1,26 @@
+/// <reference types="react" />
+import type { ArrayField } from '@nokecy/formily-core';
+/**
+ * 默认(loose)反馈布局下,单元格里的校验错误文字画在输入框下方;行高只放得下输入框,
+ * 错误文字会被单元格/下一行/表格底边盖住(formily #4134)。出错的行额外加这么多高度来放它。
+ */
+export declare const ROW_FEEDBACK_EXTRA_HEIGHT = 24;
+/**
+ * 找出当前有「行内错误文字」的行:返回这些行的数据对象(与 AG-Grid rowData 里的元素同一引用)。
+ *
+ * 只看数组元素下的字段错误;装饰器上写了 feedbackLayout: 'popover' | 'none' 的字段错误不占位,不计入。
+ * 这里读的是整张字段表(queryFeedbacks 会遍历数组下所有字段),不要在组件渲染期间调用——
+ * 渲染期读它会让组件订阅字段表,每创建一个字段就重渲一次。请用 useFeedbackRows。@author nokecy
+ */
+export declare const collectFeedbackRows: (arrayField: ArrayField) => Set<object>;
+/**
+ * 订阅数组下字段的校验反馈,返回「有行内错误文字的行」。
+ *
+ * 不在渲染期读错误(见 collectFeedbackRows 说明),而是挂 Formily 事件:字段校验结束、字段卸载(删行)、表单重置时,
+ * 合并成一次(下一个宏任务)重算;行集合变化才触发重渲。rows 供 AG-Grid 的 getRowHeight 同步读取,
+ * signature(有错误的行下标)变化时调用方让网格重算行高。@author nokecy
+ */
+export declare const useFeedbackRows: (arrayField: ArrayField) => {
+    rowsRef: import("react").RefObject<Set<object>>;
+    signature: string;
+};