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

package/dist/esm/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, defaultLayout?: string) => Set<object>;
+/**
+ * 订阅数组下字段的校验反馈,返回「有行内错误文字的行」。
+ *
+ * 不在渲染期读错误(见 collectFeedbackRows 说明),而是挂 Formily 事件:字段校验结束、字段卸载(删行)、表单重置时,
+ * 合并成一次(下一个宏任务)重算;行集合变化才触发重渲。rows 供 AG-Grid 的 getRowHeight 同步读取,
+ * signature(有错误的行下标)变化时调用方让网格重算行高。@author nokecy
+ */
+export declare const useFeedbackRows: (arrayField: ArrayField, defaultLayout?: string) => {
+    rowsRef: import("react").RefObject<Set<object>>;
+    signature: string;
+};

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

@@ -0,0 +1,109 @@
+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 _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); }
+function _createForOfIteratorHelper(o, allowArrayLike) { var it = typeof Symbol !== "undefined" && o[Symbol.iterator] || o["@@iterator"]; if (!it) { if (Array.isArray(o) || (it = _unsupportedIterableToArray(o)) || allowArrayLike && o && typeof o.length === "number") { if (it) o = it; var i = 0; var F = function F() {}; return { s: F, n: function n() { if (i >= o.length) return { done: true }; return { done: false, value: o[i++] }; }, e: function e(_e) { throw _e; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var normalCompletion = true, didErr = false, err; return { s: function s() { it = it.call(o); }, n: function n() { var step = it.next(); normalCompletion = step.done; return step; }, e: function e(_e2) { didErr = true; err = _e2; }, f: function f() { try { if (!normalCompletion && it.return != null) it.return(); } finally { if (didErr) throw err; } } }; }
+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; }
+import { useEffect, useRef, useState } from 'react';
+import { onFieldUnmount, onFieldValidateEnd, onFormReset } from '@nokecy/formily-core';
+import uniqueId from 'lodash/uniqueId';
+
+/**
+ * 默认(loose)反馈布局下,单元格里的校验错误文字画在输入框下方;行高只放得下输入框,
+ * 错误文字会被单元格/下一行/表格底边盖住(formily #4134)。出错的行额外加这么多高度来放它。
+ */
+export var ROW_FEEDBACK_EXTRA_HEIGHT = 24;
+
+/** 这些反馈布局的错误不占行内位置(浮层 / 不显示 / terse 紧凑浮层),不需要撑高行 */
+var OUT_OF_FLOW_LAYOUTS = new Set(['popover', 'none', 'terse']);
+
+/**
+ * 找出当前有「行内错误文字」的行:返回这些行的数据对象(与 AG-Grid rowData 里的元素同一引用)。
+ *
+ * 只看数组元素下的字段错误;装饰器上写了 feedbackLayout: 'popover' | 'none' 的字段错误不占位,不计入。
+ * 这里读的是整张字段表(queryFeedbacks 会遍历数组下所有字段),不要在组件渲染期间调用——
+ * 渲染期读它会让组件订阅字段表,每创建一个字段就重渲一次。请用 useFeedbackRows。@author nokecy
+ */
+export var collectFeedbackRows = function collectFeedbackRows(arrayField, defaultLayout) {
+  var rows = new Set();
+  var form = arrayField === null || arrayField === void 0 ? void 0 : arrayField.form;
+  var value = arrayField === null || arrayField === void 0 ? void 0 : arrayField.value;
+  if (!form || !Array.isArray(value)) return rows;
+  var base = arrayField.address.toString();
+  var baseLength = arrayField.path.length;
+  var _iterator = _createForOfIteratorHelper(form.queryFeedbacks({
+      type: 'error',
+      address: "".concat(base, ".*")
+    })),
+    _step;
+  try {
+    for (_iterator.s(); !(_step = _iterator.n()).done;) {
+      var _feedback$path$segmen, _feedback$path, _feedback$path2, _feedback$path2$toStr, _feedback$path3, _form$query$take$deco, _form$query$take;
+      var feedback = _step.value;
+      var index = Number((_feedback$path$segmen = (_feedback$path = feedback.path) === null || _feedback$path === void 0 || (_feedback$path = _feedback$path.segments) === null || _feedback$path === void 0 ? void 0 : _feedback$path[baseLength]) !== null && _feedback$path$segmen !== void 0 ? _feedback$path$segmen : (_feedback$path2 = feedback.path) === null || _feedback$path2 === void 0 || (_feedback$path2$toStr = (_feedback$path3 = _feedback$path2).toString) === null || _feedback$path2$toStr === void 0 ? void 0 : _feedback$path2$toStr.call(_feedback$path3).split('.')[baseLength]);
+      var row = value[index];
+      if (!Number.isInteger(index) || row == null || _typeof(row) !== 'object') continue;
+      var layout = (_form$query$take$deco = (_form$query$take = form.query(feedback.address).take()) === null || _form$query$take === void 0 || (_form$query$take = _form$query$take.decoratorProps) === null || _form$query$take === void 0 ? void 0 : _form$query$take.feedbackLayout) !== null && _form$query$take$deco !== void 0 ? _form$query$take$deco : defaultLayout;
+      if (OUT_OF_FLOW_LAYOUTS.has(layout)) continue;
+      rows.add(row);
+    }
+  } catch (err) {
+    _iterator.e(err);
+  } finally {
+    _iterator.f();
+  }
+  return rows;
+};
+
+/**
+ * 订阅数组下字段的校验反馈,返回「有行内错误文字的行」。
+ *
+ * 不在渲染期读错误(见 collectFeedbackRows 说明),而是挂 Formily 事件:字段校验结束、字段卸载(删行)、表单重置时,
+ * 合并成一次(下一个宏任务)重算;行集合变化才触发重渲。rows 供 AG-Grid 的 getRowHeight 同步读取,
+ * signature(有错误的行下标)变化时调用方让网格重算行高。@author nokecy
+ */
+export var useFeedbackRows = function useFeedbackRows(arrayField, defaultLayout) {
+  var rowsRef = useRef(new Set());
+  var _useState = useState(''),
+    _useState2 = _slicedToArray(_useState, 2),
+    signature = _useState2[0],
+    setSignature = _useState2[1];
+  useEffect(function () {
+    var form = arrayField === null || arrayField === void 0 ? void 0 : arrayField.form;
+    if (!form) return;
+    var id = uniqueId('array-table-feedback-');
+    var pattern = "".concat(arrayField.address.toString(), ".*");
+    var timer;
+    var refresh = function refresh() {
+      if (timer !== undefined) clearTimeout(timer);
+      timer = setTimeout(function () {
+        timer = undefined;
+        var rows = collectFeedbackRows(arrayField, defaultLayout);
+        rowsRef.current = rows;
+        var value = Array.isArray(arrayField.value) ? arrayField.value : [];
+        var next = value.flatMap(function (row, index) {
+          return rows.has(row) ? [index] : [];
+        }).join(',');
+        setSignature(function (prev) {
+          return prev === next ? prev : next;
+        });
+      }, 0);
+    };
+    form.addEffects(id, function () {
+      onFieldValidateEnd(pattern, refresh);
+      onFieldUnmount(pattern, refresh);
+      onFormReset(refresh);
+    });
+    refresh();
+    return function () {
+      if (timer !== undefined) clearTimeout(timer);
+      form.removeEffects(id);
+    };
+  }, [arrayField, defaultLayout]);
+  return {
+    rowsRef: rowsRef,
+    signature: signature
+  };
+};

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

@@ -0,0 +1,17 @@
+import type { ArrayField } from '@nokecy/formily-core';
+/**
+ * 读取业务行标识；尚未补入表单的行按对象缓存临时标识，不在渲染期间改写表单。
+ * @param row 明细行。
+ * @param generatedIds 当前表格已分配的临时行标识。
+ * @returns AG-Grid 使用的稳定字符串标识。
+ * @author nokecy
+ */
+export declare const getArrayTableRowId: (row: Record<string, any>, generatedIds: WeakMap<object, string>) => string;
+/**
+ * 在 effect 中为缺少业务标识的明细补入可枚举 _id，使业务克隆行时保留 AG-Grid 行身份。
+ * 复用首次渲染已分配的标识，补值本身不会使单元格重挂；已有 _id/id（含 0）保持原值。
+ * @param field 当前明细数组字段。
+ * @param generatedIds 当前表格已分配的临时行标识。
+ * @author nokecy
+ */
+export declare const ensureArrayTableRowIds: (field: ArrayField, generatedIds: WeakMap<object, string>) => void;

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

@@ -0,0 +1,37 @@
+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); }
+import uniqueId from 'lodash/uniqueId';
+
+/**
+ * 读取业务行标识；尚未补入表单的行按对象缓存临时标识，不在渲染期间改写表单。
+ * @param row 明细行。
+ * @param generatedIds 当前表格已分配的临时行标识。
+ * @returns AG-Grid 使用的稳定字符串标识。
+ * @author nokecy
+ */
+export var getArrayTableRowId = function getArrayTableRowId(row, generatedIds) {
+  var _row$_id;
+  var existingId = (_row$_id = row._id) !== null && _row$_id !== void 0 ? _row$_id : row.id;
+  if (existingId != null) return String(existingId);
+  var generatedId = generatedIds.get(row);
+  if (!generatedId) {
+    generatedId = uniqueId('row_');
+    generatedIds.set(row, generatedId);
+  }
+  return generatedId;
+};
+
+/**
+ * 在 effect 中为缺少业务标识的明细补入可枚举 _id，使业务克隆行时保留 AG-Grid 行身份。
+ * 复用首次渲染已分配的标识，补值本身不会使单元格重挂；已有 _id/id（含 0）保持原值。
+ * @param field 当前明细数组字段。
+ * @param generatedIds 当前表格已分配的临时行标识。
+ * @author nokecy
+ */
+export var ensureArrayTableRowIds = function ensureArrayTableRowIds(field, generatedIds) {
+  if (!Array.isArray(field.value)) return;
+  field.value.forEach(function (row, index) {
+    var _row$_id2;
+    if (row == null || _typeof(row) !== 'object' || ((_row$_id2 = row._id) !== null && _row$_id2 !== void 0 ? _row$_id2 : row.id) != null) return;
+    field.form.setValuesIn(field.path.concat(index).concat('_id'), getArrayTableRowId(row, generatedIds));
+  });
+};

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

@@ -0,0 +1,3 @@
+import { type ReadOnlyFormatter } from './readOnlyFormatters';
+/** 按列的展示字段和数据类型比较明细值，保留原始选择对象供表单绑定使用。@author nokecy */
+export declare const createArrayTableComparator: (fieldSchema: any, columnProps: any, formatter: ReadOnlyFormatter | null) => (a: any, b: any) => number;

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

@@ -0,0 +1,40 @@
+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); }
+import Decimal from 'decimal.js';
+import dayjs from 'dayjs';
+import { formatSelectDisplay } from "./readOnlyFormatters";
+
+/** 按列的展示字段和数据类型比较明细值，保留原始选择对象供表单绑定使用。@author nokecy */
+export var createArrayTableComparator = function createArrayTableComparator(fieldSchema, columnProps, formatter) {
+  var _fieldSchema$xCompon, _fieldSchema$xCompon2;
+  var component = String((_fieldSchema$xCompon = fieldSchema === null || fieldSchema === void 0 ? void 0 : fieldSchema['x-component']) !== null && _fieldSchema$xCompon !== void 0 ? _fieldSchema$xCompon : '');
+  var numeric = (fieldSchema === null || fieldSchema === void 0 ? void 0 : fieldSchema.type) === 'number' || (fieldSchema === null || fieldSchema === void 0 ? void 0 : fieldSchema.type) === 'integer' || /^(InputNumber|NumberPicker|DecimalPicker|MoneyPicker)$/.test(component) || [columnProps === null || columnProps === void 0 ? void 0 : columnProps.type].flat().some(function (type) {
+    return type === 'numericColumn' || type === 'numberColumn';
+  });
+  var temporal = /^(DatePicker|TimePicker)(\.|$)/.test(component);
+  var displayField = (fieldSchema === null || fieldSchema === void 0 || (_fieldSchema$xCompon2 = fieldSchema['x-component-props']) === null || _fieldSchema$xCompon2 === void 0 ? void 0 : _fieldSchema$xCompon2.displayField) === 'value' ? 'value' : 'label';
+  var scalar = function scalar(value) {
+    var _value$label;
+    if (value == null) return null;
+    if (Array.isArray(value)) return formatSelectDisplay(value, displayField);
+    if (_typeof(value) === 'object' && ('value' in value || 'label' in value)) return scalar(displayField === 'value' ? value.value : (_value$label = value.label) !== null && _value$label !== void 0 ? _value$label : value.value);
+    if (temporal && dayjs(value).isValid()) return dayjs(value).valueOf();
+    if (numeric || typeof value === 'number' || typeof value === 'boolean') return value;
+    return formatter ? formatter(value, {
+      columnProps: columnProps,
+      fieldSchema: fieldSchema
+    }) : String(value);
+  };
+  return function (a, b) {
+    var left = scalar(a);
+    var right = scalar(b);
+    if (left == null || left === '') return right == null || right === '' ? 0 : -1;
+    if (right == null || right === '') return 1;
+    if (numeric || temporal || typeof left === 'number' && typeof right === 'number') {
+      try {
+        return new Decimal(left).cmp(new Decimal(right));
+      } catch (_unused) {/* 无效数值按展示文字排序。 */}
+    }
+    if (typeof left === 'boolean' && typeof right === 'boolean') return Number(left) - Number(right);
+    return String(left).localeCompare(String(right), 'zh-CN');
+  };
+};

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

@@ -0,0 +1,25 @@
+import React from 'react';
+import type { ColDef } from 'ag-grid-community';
+/**
+ * 合计行（固定在表尾，不随滚动，不参与排序、勾选、序号）。
+ * 键是列的 field（ArrayTable.Column 的 dataIndex / 内层字段名），值是固定内容，或由当前全部明细行算出内容的函数；
+ * 函数在 Observer 里执行，明细任何字段变化都会重算。没有写到的列该格留空。
+ *
+ * @author nokecy
+ */
+export type ArrayTableSummary = Record<string, React.ReactNode | ((rows: any[]) => React.ReactNode)>;
+/** 合计行的承载数据；AG-Grid 要求固定行有数据对象才会渲染单元格 */
+export declare const ARRAY_TABLE_SUMMARY_ROW: {
+    __arrayTableSummary: boolean;
+}[];
+type SummaryCellParams = {
+    colDef?: ColDef;
+    getSummary: () => ArrayTableSummary | undefined;
+    getRows: () => any[];
+};
+/**
+ * 给列定义补上「固定行用合计渲染」的选择器，普通行仍走列原有的渲染器。
+ * 用 cellRendererSelector 而不是替换 cellRenderer：列上依赖 cellRenderer 身份的逻辑（懒挂载识别等）不受影响。
+ */
+export declare const withSummaryCells: (columns: ColDef[], getSummary: SummaryCellParams['getSummary'], getRows: SummaryCellParams['getRows']) => ColDef[];
+export {};

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

@@ -0,0 +1,66 @@
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+import React from 'react';
+import { Observer } from '@nokecy/formily-react';
+
+/**
+ * 合计行（固定在表尾，不随滚动，不参与排序、勾选、序号）。
+ * 键是列的 field（ArrayTable.Column 的 dataIndex / 内层字段名），值是固定内容，或由当前全部明细行算出内容的函数；
+ * 函数在 Observer 里执行，明细任何字段变化都会重算。没有写到的列该格留空。
+ *
+ * @author nokecy
+ */
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Fragment as _Fragment } from "react/jsx-runtime";
+/** 合计行的承载数据；AG-Grid 要求固定行有数据对象才会渲染单元格 */
+export var ARRAY_TABLE_SUMMARY_ROW = [{
+  __arrayTableSummary: true
+}];
+var SummaryCell = function SummaryCell(_ref) {
+  var colDef = _ref.colDef,
+    getSummary = _ref.getSummary,
+    getRows = _ref.getRows;
+  var key = colDef === null || colDef === void 0 ? void 0 : colDef.field;
+  if (!key) return null;
+  return /*#__PURE__*/_jsx(Observer, {
+    children: function children() {
+      var _getSummary;
+      var item = (_getSummary = getSummary()) === null || _getSummary === void 0 ? void 0 : _getSummary[key];
+      var content = typeof item === 'function' ? item(getRows()) : item;
+      return /*#__PURE__*/_jsx(_Fragment, {
+        children: content == null ? null : /*#__PURE__*/_jsx("span", {
+          "data-array-table-summary": key,
+          children: content
+        })
+      });
+    }
+  });
+};
+
+/**
+ * 给列定义补上「固定行用合计渲染」的选择器，普通行仍走列原有的渲染器。
+ * 用 cellRendererSelector 而不是替换 cellRenderer：列上依赖 cellRenderer 身份的逻辑（懒挂载识别等）不受影响。
+ */
+export var withSummaryCells = function withSummaryCells(columns, getSummary, getRows) {
+  return columns.map(function (col) {
+    if (Array.isArray(col.children)) return _objectSpread(_objectSpread({}, col), {}, {
+      children: withSummaryCells(col.children, getSummary, getRows)
+    });
+    return _objectSpread(_objectSpread({}, col), {}, {
+      cellRendererSelector: function cellRendererSelector(params) {
+        var _params$node, _col$cellRendererSele;
+        return (_params$node = params.node) !== null && _params$node !== void 0 && _params$node.rowPinned ? {
+          component: SummaryCell,
+          params: {
+            getSummary: getSummary,
+            getRows: getRows
+          }
+        } : (_col$cellRendererSele = col.cellRendererSelector) === null || _col$cellRendererSele === void 0 ? void 0 : _col$cellRendererSele.call(col, params);
+      }
+    });
+  });
+};

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

@@ -0,0 +1,40 @@
+import type { GridDensity, GridDensityOverrides, GridDensityValues } from '../ag-grid-plus/density';
+/**
+ * Provider 没注入密度时的档位：DESIGN.md §2 把紧凑档定为 ERP 标准页默认。
+ * 原先写死 38，没有对应任何一档；回退到规范默认档，数值全部来自 density.ts。
+ */
+export declare const ARRAY_TABLE_FALLBACK_DENSITY: GridDensity;
+/** 回退档的行高，兼容旧的具名导出；实际行高请用 useArrayTableMetrics。 */
+export declare const ARRAY_TABLE_ROW_HEIGHT: number;
+/**
+ * 解析 ArrayTable 当前密度数值（纯函数，便于测试）。
+ * 网格选项 rowHeight/headerHeight 与主题参数必须同值——AG-Grid 单元格文字的行高
+ * (--ag-internal-content-line-height)是从主题的 --ag-row-height 算的，只设网格选项会让文字的行盒
+ * 仍是主题默认行高，顶在格子上方偏上。所以两处都从这一份数值取。
+ */
+export declare function resolveArrayTableMetrics(density?: GridDensity, overrides?: GridDensityOverrides): GridDensityValues;
+/** 读取 Provider 注入的密度，随 Provider 变化重算（密度运行时切换后行高即时更新）。 */
+export declare function useArrayTableMetrics(): GridDensityValues;
+/**
+ * 格内错误文字的总高度（含 terse 样式的 1px 边框，上下内边距与外边距归零，box-sizing: border-box）。
+ * 文字紧贴输入框下沿（top:100%），输入框高 = 行高 - 3px，所以格底到输入框底的距离是 ROW_FEEDBACK_EXTRA_HEIGHT + 3，
+ * 本值必须不超过它，否则会被行底边线穿过。
+ */
+export declare const ARRAY_TABLE_HELP_LINE_HEIGHT = 20;
+/** 表格里有出错行时挂在网格外层的类名(由 index.tsx 设置) */
+export declare const ARRAY_TABLE_FEEDBACK_CLASS = "ag-array-table-has-feedback";
+/**
+ * 单元格里的表单项与内容区垂直居中(只对使用本主题的网格生效,共用主题不受影响):
+ *  - .ag-cell-wrapper 撑满格子,align-items:center 才起作用(默认只有内容高,贴在格子顶部);
+ *    表格里有出错行时(外层带 ARRAY_TABLE_FEEDBACK_CLASS)内容高度不超过标准行高对应的高度:出错行会被撑高(见 rowFeedback.ts),
+ *    内容仍居中在上面那一段,多出来的高度留给输入框下方的错误文字,出错时输入框不会被挤得上下跳;
+ *  - FormItem 默认 margin-bottom:24px(loose 反馈布局给错误文字预留的位置),会把 Editable 外壳撑到 56px、
+ *    输入框偏上、还超出 37px 的格子,归零;
+ *  - AG-Grid 的 .ag-cell-value 默认 overflow:hidden,会把输入框下方的错误文字剪掉,只在格里正显示错误文字时放开;
+ *  - 错误文字单行显示、超出列宽省略,出错行只多留一行的高度(ROW_FEEDBACK_EXTRA_HEIGHT);
+ *  - 错误提示文字移出文档流(位置仍在输入框下方),出错时输入框不会被挤得上下跳。
+ */
+export declare const ARRAY_TABLE_CELL_FIT_CSS = "\n    .ag-cell .ag-cell-wrapper { height: 100%; max-height: 100%; min-height: 0; }\n    .ag-cell .ag-cell-value { max-height: 100%; min-height: 0; }\n    /* \u672C part \u7684 CSS \u4F1A\u88AB AG-Grid \u5305\u8FDB :where(.ag-theme-xxx) { ... }\uFF08\u5D4C\u5957\uFF09\uFF0C\u88F8\u5199 .has-feedback .ag-cell \u4F1A\u7F16\u8BD1\u6210\n       \u300C\u4E3B\u9898\u5143\u7D20\u7684\u540E\u4EE3 has-feedback\u300D\uFF0C\u800C\u8BE5\u7C7B\u6302\u5728\u4E3B\u9898\u5143\u7D20\u7684\u7956\u5148\u4E0A\uFF0C\u89C4\u5219\u6C38\u8FDC\u4E0D\u547D\u4E2D\u3002\n       \u6240\u4EE5\u7528 & \u663E\u5F0F\u653E\u5728 has-feedback \u4E4B\u540E\uFF08\u7956\u5148\u5199\u6CD5\uFF09\uFF0C\u540C\u65F6\u517C\u5BB9\u7C7B\u540D\u6302\u5728\u4E3B\u9898\u5143\u7D20\u81EA\u8EAB\u7684\u5199\u6CD5\u3002 */\n    .ag-array-table-has-feedback & .ag-cell .ag-cell-wrapper,\n    &.ag-array-table-has-feedback .ag-cell .ag-cell-wrapper { height: min(100%, calc(var(--ag-row-height) - 3px)); }\n    /* \u5BBF\u4E3B\u53EF\u80FD\u5199 .xxx .ant-formily-item { margin-bottom: 12px }\uFF08\u7279\u5F02\u6027 0,3,0\uFF09\uFF1B\u8FD9\u91CC\u53E0\u7C7B\u540D\u5E76 !important\uFF0C\u4EFB\u4F55\u5BBF\u4E3B\u89C4\u5219\u90FD\u538B\u4E0D\u8FC7\uFF0C\n       \u5426\u5219\u683C\u5185\u63A7\u4EF6\u4F1A\u88AB margin \u9876\u5F97\u504F\u4E0A 3-5px\u3002@author nokecy */\n    .ag-cell .ag-cell-wrapper .ant-formily-item.ant-formily-item { margin-bottom: 0 !important; }\n    /* \u6807\u9898\u548C\u8BF4\u660E\u7531\u5217\u5934\u627F\u8F7D\uFF0ClabelWidth:0 \u672C\u8EAB\u4E0D\u4F1A\u9690\u85CF\u5B57\u6BB5\u6807\u9898\u3002@author nokecy */\n    .ag-cell .ant-formily-item-label { display: none; }\n    .ag-cell .ant-formily-item-control { flex: 1; min-width: 0; width: 100%; }\n    /* \u5E26\u5916\u58F3\u7684\u8F93\u5165\u6846\uFF08affix/wrapper\uFF09\u662F inline-flex\uFF0Cantd \u7ED9\u8868\u5355\u9879\u5185\u5BB9\u533A controlHeight \u7684\u6700\u5C0F\u9AD8\u5EA6\u548C\u5BF9\u5E94\u884C\u9AD8\uFF0C\n       \u5916\u58F3\u6309\u57FA\u7EBF\u5BF9\u9F50\u88AB\u9876\u504F\u3002\u5185\u5BB9\u533A\u6539\u6210\u5C45\u4E2D\u7684 flex\uFF08\u5B50\u9879\u88AB\u5757\u5316\uFF0C\u4E0D\u518D\u6709\u57FA\u7EBF\u5BF9\u9F50\uFF09\uFF0C\u6700\u5C0F\u9AD8\u5EA6\u5F52\u96F6\uFF0C\n       \u8868\u5355\u9879\u9AD8\u5EA6\u7531\u63A7\u4EF6\u81EA\u5DF1\u7684\u9AD8\u5EA6\uFF08\u884C\u9AD8-3px\uFF09\u51B3\u5B9A\uFF0C\u4E0D\u8D85\u51FA\u884C\u9AD8\u3002 */\n    .ag-cell .ant-formily-item,\n    .ag-cell .ant-formily-item-control,\n    .ag-cell .ant-formily-item-control-content,\n    .ag-cell .ant-formily-item-control-content-component { min-height: 0 !important; }\n    .ag-cell .ant-formily-item-control-content,\n    .ag-cell .ant-formily-item-control-content-component { display: flex; align-items: center; }\n    .ag-cell .ant-formily-item-control-content-component { flex: 1 1 auto; min-width: 0; }\n    .ag-cell .ant-formily-item-control-content-component > * { flex: 1 1 auto; min-width: 0; }\n    /* \u9519\u8BEF\u6587\u5B57\u9489\u5728\u8F93\u5165\u6846\u6B63\u4E0B\u65B9\uFF08top:100% \u76F8\u5BF9 .ant-formily-item\uFF09\uFF0C\u9AD8\u5EA6\u56FA\u5B9A\u4E3A ARRAY_TABLE_HELP_LINE_HEIGHT\uFF0C\n       \u4E0D\u518D\u4F9D\u8D56\u6587\u6863\u6D41\u91CC\u7684\u9759\u6001\u4F4D\u7F6E\uFF08\u4F1A\u968F margin/\u5C45\u4E2D\u504F\u79FB\uFF0C\u5BFC\u81F4\u88AB\u884C\u5E95\u8FB9\u7EBF\u7A7F\u8FC7\uFF09\u3002 */\n    .ag-cell .ant-formily-item-help { position: absolute; top: 100%; inset-inline-start: 0; margin: 0 !important; padding-block: 0 !important; box-sizing: border-box !important; min-height: 0 !important; height: 20px !important; line-height: 18px !important; max-width: 100%; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }\n    .ag-cell .ag-cell-value:has(.ant-formily-item-help) { overflow: visible; }\n    /* \u5217\u5BF9\u9F50\uFF08align \u5199\u6CD5\uFF09\uFF1B\u6B63\u5728\u7F16\u8F91\u7684\u8F93\u5165\u6846\u8DDF\u968F\u6240\u5728\u5217\u7684\u5BF9\u9F50\uFF0C\u6570\u5B57\u5217\u70B9\u5F00\u7F16\u8F91\u65F6\u4E0D\u4F1A\u8DF3\u5230\u5DE6\u8FB9\u3002@author nokecy */\n    .ag-cell.qc-array-table-align-left { text-align: left; }\n    .ag-cell.qc-array-table-align-center { text-align: center; }\n    .ag-cell.qc-array-table-align-right { text-align: right; }\n    .ag-cell .ant-input-number .ant-input-number-input,\n    .ag-cell .ant-input-affix-wrapper .ant-input,\n    .ag-cell .ant-input.ant-input { text-align: inherit; }\n    .ag-header-cell.qc-array-table-required .ag-header-cell-text::before {\n      content: '*';\n      color: var(--ag-invalid-color);\n      margin-inline-end: 4px;\n    }\n    /* \u5355\u5C42\u6846\uFF1A\u683C\u5185\u63A7\u4EF6\u4E0D\u753B\u81EA\u5DF1\u7684\u8FB9\u6846/\u9634\u5F71/\u5E95\u8272\uFF0C\u6491\u6EE1\u5355\u5143\u683C\uFF1B\n       \u805A\u7126/\u9519\u8BEF/\u9501\u5B9A\u53EA\u7531\u5355\u5143\u683C\u7684 inset \u6846\uFF08\u6216\u5E95\u8272\uFF09\u8868\u8FBE\uFF0C\u4E0D\u5360\u5C3A\u5BF8\uFF0C\u884C\u9AD8\u4E0E\u5355\u5143\u683C\u5C3A\u5BF8\u4E0D\u53D8\u3002\n       \u9009\u62E9\u5668\u5168\u90E8\u9650\u5B9A\u5728 .ag-cell \u5185\uFF0C\u800C\u672C part \u53EA\u6302\u5728 ArrayTable \u7684\u4E3B\u9898\u4E0A\uFF0C\u4E0D\u5F71\u54CD\u8868\u683C\u5916\u7684\u8868\u5355\u3002@author nokecy */\n    .ag-cell .ant-input.ant-input,\n    .ag-cell .ant-input-affix-wrapper.ant-input-affix-wrapper,\n    .ag-cell .ant-input-number.ant-input-number,\n    .ag-cell .ant-input-number-affix-wrapper.ant-input-number-affix-wrapper,\n    .ag-cell .ant-select.ant-select,\n    .ag-cell .ant-select.ant-select .ant-select-selector,\n    .ag-cell .ant-picker.ant-picker,\n    .ag-cell .ant-input-outlined.ant-input-outlined {\n      border: 0 !important;\n      box-shadow: none !important;\n      background: transparent !important;\n      outline: none;\n    }\n    .ag-cell .ant-input-number, .ag-cell .ant-picker, .ag-cell .ant-select, .ag-cell .ant-input-affix-wrapper { width: 100%; }\n    /* \u63A7\u4EF6\u300C\u50CF\u6587\u672C\u300D\uFF1A\u5B57\u53F7\u3001\u6C34\u5E73\u5185\u8FB9\u8DDD\u8DDF\u968F\u5BC6\u5EA6\uFF08\u5355\u5143\u683C\u81EA\u5DF1\u5DF2\u6709 --ag-cell-horizontal-padding\uFF0C\u63A7\u4EF6\u4E0D\u518D\u53E0\u4E00\u5C42\uFF09\uFF0C\n       \u9AD8\u5EA6\u968F\u884C\u9AD8\u3001\u7559 3px \u7ED9\u4E0B\u8FB9\u6846\u4E0E\u5C45\u4E2D\u4F59\u91CF\uFF0C\u4E0D\u6491\u9AD8\u884C\uFF1B\u5BC6\u5EA6\u7531\u4E3B\u9898\u53C2\u6570 rowHeight \u51B3\u5B9A\uFF0C\u4E0D\u5199\u6B7B\u50CF\u7D20\u3002@author nokecy */\n    .ag-cell .ant-input.ant-input,\n    .ag-cell .ant-input-affix-wrapper.ant-input-affix-wrapper,\n    .ag-cell .ant-input-number.ant-input-number,\n    .ag-cell .ant-input-number-affix-wrapper.ant-input-number-affix-wrapper,\n    .ag-cell .ant-select.ant-select,\n    .ag-cell .ant-select.ant-select .ant-select-selector,\n    .ag-cell .ant-picker.ant-picker { font-size: inherit !important; padding-inline: 0 !important; }\n    /* antd 6 \u7684 Select \u6839\u8282\u70B9\u81EA\u5DF1\u5E26\u8FB9\u6846\u4E0E\u5185\u8FB9\u8DDD\uFF08\u6CA1\u6709 .ant-select-selector\uFF09\uFF0C\u4E0A\u4E0B\u5185\u8FB9\u8DDD\u4E5F\u5F52\u96F6\uFF0C\u9AD8\u5EA6\u7531\u4E0B\u9762\u7684 height \u51B3\u5B9A\uFF0C\u5782\u76F4\u5C45\u4E2D\u3002*/\n    .ag-cell .ant-select.ant-select { padding-block: 0 !important; align-items: center; }\n    .ag-cell .ant-input-number .ant-input-number-input,\n    .ag-cell .ant-picker .ant-picker-input > input,\n    .ag-cell .ant-select .ant-select-selection-item,\n    .ag-cell .ant-select .ant-select-selection-search-input,\n    .ag-cell .ant-select .ant-select-content,\n    .ag-cell .ant-select .ant-select-content-item,\n    .ag-cell .ant-select .ant-select-placeholder,\n    .ag-cell .ant-select .ant-select-input { font-size: inherit !important; padding-inline: 0 !important; }\n    .ag-cell .ant-input.ant-input,\n    .ag-cell .ant-input-affix-wrapper.ant-input-affix-wrapper,\n    .ag-cell .ant-input-number.ant-input-number,\n    .ag-cell .ant-input-number-affix-wrapper.ant-input-number-affix-wrapper,\n    .ag-cell .ant-select.ant-select,\n    .ag-cell .ant-select.ant-select .ant-select-selector,\n    .ag-cell .ant-picker.ant-picker { height: calc(var(--ag-row-height) - 3px) !important; min-height: 0 !important; }\n    /* \u5957\u5728\u5916\u58F3\u91CC\u7684\u5185\u5C42\u63A7\u4EF6\u6491\u6EE1\u5916\u58F3\u5373\u53EF\uFF0C\u518D\u8BBE\u540C\u4E00\u9AD8\u5EA6\u4F1A\u52A0\u4E0A\u5916\u58F3 padding \u6EA2\u51FA\uFF1B\u591A\u884C\u6587\u672C\u57DF\u4E0D\u53D7\u9650\u3002*/\n    .ag-cell .ant-input-affix-wrapper .ant-input.ant-input,\n    .ag-cell .ant-input-number-affix-wrapper .ant-input-number-input { height: 100% !important; }\n    /* \u591A\u884C\u6587\u672C\u5728\u56FA\u5B9A\u884C\u9AD8\u7684\u683C\u91CC\u4E0D\u6491\u9AD8\u884C\uFF1A\u9AD8\u5EA6\u53D6\u5355\u884C\u9AD8\uFF0C\u8D85\u51FA\u5185\u5BB9\u5728\u6846\u5185\u6EDA\u52A8 */\n    .ag-cell textarea.ant-input.ant-input { height: calc(var(--ag-row-height) - 3px) !important; min-height: 0 !important; resize: none; overflow-y: auto; line-height: calc(var(--ag-row-height) - 5px) !important; padding-block: 0 !important; }\n    /* Editable \u88C5\u9970\u5668\u5916\u58F3\u9ED8\u8BA4 inline-block\uFF0C\u4F1A\u5728 .ag-cell-value \u7684\u884C\u76D2\u91CC\u6309\u57FA\u7EBF\u5BF9\u9F50\u3001\u88AB\u9876\u504F\uFF1B\u6539\u4E3A\u5757\u7EA7 flex \u4E0E\u5176\u4ED6\u63A7\u4EF6\u4E00\u81F4\u5C45\u4E2D */\n    .ag-cell .ant-formily-editable { display: flex; align-items: center; width: 100%; }\n    /* Select \u6587\u5B57\u884C\u9AD8\u4E0E\u641C\u7D22\u6846\u4F4D\u7F6E\uFF1Aselector \u5F52\u96F6\u5185\u8FB9\u8DDD\u540E\uFF0C\u6587\u5B57\u884C\u9AD8\u53D6\u683C\u5185\u53EF\u7528\u9AD8\u5EA6\uFF0C\u641C\u7D22\u8F93\u5165\u6846\u8D34\u5DE6\uFF0C\u5149\u6807\u4E0D\u9519\u4F4D\u3002*/\n    .ag-cell .ant-select .ant-select-selection-item,\n    .ag-cell .ant-select .ant-select-selection-placeholder,\n    .ag-cell .ant-select .ant-select-selection-search-input,\n    .ag-cell .ant-select .ant-select-content,\n    .ag-cell .ant-select .ant-select-content-item,\n    .ag-cell .ant-select .ant-select-placeholder,\n    .ag-cell .ant-select .ant-select-input { line-height: calc(var(--ag-row-height) - 3px) !important; }\n    .ag-cell .ant-select .ant-select-selection-search { inset-inline: 0 !important; }\n    /* \u6B65\u8FDB\u5668\u4E0E\u65E5\u5386\u56FE\u6807\u5728\u4EFB\u4F55\u72B6\u6001\u90FD\u4E0D\u663E\u793A\uFF08\u4E0E\u6F14\u793A\u4E00\u81F4\uFF1A\u952E\u76D8\u7528\u65B9\u5411\u952E/\u952E\u5165\uFF0C\u9762\u677F\u7531\u70B9\u51FB\u5C55\u5F00\uFF09\uFF1B\n       Input \u53EA\u4FDD\u7559\u6E05\u9664\u56FE\u6807\u3002\u4E0B\u62C9\u7BAD\u5934\u53EA\u5728\u805A\u7126\u6216\u9762\u677F\u5C55\u5F00\u65F6\u51FA\u73B0\u3002@author nokecy */\n    .ag-cell .ant-input-number-handler-wrap { display: none !important; }\n    .ag-cell .ant-picker .ant-picker-suffix { display: none !important; }\n    .ag-cell .ant-input-suffix > :not(.ant-input-clear-icon):not(.ant-input-show-count-suffix) { display: none !important; }\n    .ag-cell .ant-select:not(.ant-select-focused):not(.ant-select-open) .ant-select-arrow,\n    .ag-cell .ant-select:not(.ant-select-focused):not(.ant-select-open) .ant-select-suffix { display: none !important; }\n    /* \u672A\u805A\u7126\u4E14\u4E3A\u7A7A\uFF1A\u5F31\u5360\u4F4D\u4E0E\u666E\u901A\u7A7A\u683C\u4E00\u81F4\uFF0C\u53EA\u7528 placeholder \u8272\uFF0C\u4E0D\u753B\u8F93\u5165\u6846\u5916\u89C2\u3002@author nokecy */\n    .ag-cell .ant-select-selection-placeholder,\n    .ag-cell .ant-select-placeholder,\n    .ag-cell .ant-input::placeholder,\n    .ag-cell .ant-input-number-input::placeholder,\n    .ag-cell .ant-picker input::placeholder { color: var(--ant-color-text-placeholder, rgb(0 0 0 / 25%)) !important; }\n    /* \u5408\u8BA1\u884C\uFF1A\u56FA\u5B9A\u5728\u8868\u5C3E\uFF0C\u5B57\u91CD\u5F3A\u8C03\u3001\u4E0E\u660E\u7EC6\u884C\u4EE5\u4E0A\u8FB9\u7EBF\u5206\u5F00\u3002@author nokecy */\n    .ag-floating-bottom .ag-row { font-weight: 600; background: var(--ant-color-fill-quaternary, rgb(0 0 0 / 4%)); }\n    .ag-cell:focus-within { box-shadow: inset 0 0 0 1px var(--ant-color-primary, #1f5fbf); }\n    .ag-cell:has(.ant-formily-item-error), .ag-cell:has(.ant-formily-item-error):focus-within {\n      box-shadow: inset 0 0 0 1px var(--ant-color-error, #d93025);\n    }\n    .ag-cell:has(.ant-input[disabled], .ant-input-disabled, .ant-input-number-disabled, .ant-select-disabled, .ant-picker-disabled) {\n      background: var(--ant-color-fill-quaternary, rgb(0 0 0 / 4%));\n    }\n  ";
+export declare const arrayTableCellFit: import("ag-grid-community").Part<{}>;
+/** 根据当前 antd 主题与 Provider 密度生成编辑态或阅读态明细表格主题。@author nokecy */
+export declare function useArrayTableTheme(editable?: boolean): import("ag-grid-community").Theme<import("ag-grid-community").CoreParams & import("ag-grid-community").ButtonStyleParams & import("ag-grid-community").CheckboxStyleParams & import("ag-grid-community").TabStyleParams & import("ag-grid-community").InputStyleParams & {}>;

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

@@ -0,0 +1,85 @@
+/**
+ * ArrayTable(明细表格)的 AG-Grid 主题:编辑态(index.tsx)与阅读态(preview.tsx)共用。
+ *
+ * @author nokecy
+ */
+import { createPart } from 'ag-grid-community';
+import { useContext, useMemo } from 'react';
+import { GridPlusContext } from "../ag-grid-plus/context/gridContext";
+import { GRID_DENSITY_PRESETS, resolveGridDensity } from "../ag-grid-plus/density";
+import { useAgGridTheme } from "../ag-grid-plus/theme";
+
+/**
+ * Provider 没注入密度时的档位：DESIGN.md §2 把紧凑档定为 ERP 标准页默认。
+ * 原先写死 38，没有对应任何一档；回退到规范默认档，数值全部来自 density.ts。
+ */
+export var ARRAY_TABLE_FALLBACK_DENSITY = 'compact';
+
+/** 回退档的行高，兼容旧的具名导出；实际行高请用 useArrayTableMetrics。 */
+export var ARRAY_TABLE_ROW_HEIGHT = GRID_DENSITY_PRESETS[ARRAY_TABLE_FALLBACK_DENSITY].rowHeight;
+
+/**
+ * 解析 ArrayTable 当前密度数值（纯函数，便于测试）。
+ * 网格选项 rowHeight/headerHeight 与主题参数必须同值——AG-Grid 单元格文字的行高
+ * (--ag-internal-content-line-height)是从主题的 --ag-row-height 算的，只设网格选项会让文字的行盒
+ * 仍是主题默认行高，顶在格子上方偏上。所以两处都从这一份数值取。
+ */
+export function resolveArrayTableMetrics(density, overrides) {
+  var _resolveGridDensity;
+  return (_resolveGridDensity = resolveGridDensity(density, overrides)) !== null && _resolveGridDensity !== void 0 ? _resolveGridDensity : GRID_DENSITY_PRESETS[ARRAY_TABLE_FALLBACK_DENSITY];
+}
+
+/** 读取 Provider 注入的密度，随 Provider 变化重算（密度运行时切换后行高即时更新）。 */
+export function useArrayTableMetrics() {
+  var _useContext = useContext(GridPlusContext),
+    density = _useContext.density,
+    densityValues = _useContext.densityValues;
+  return useMemo(function () {
+    return resolveArrayTableMetrics(density, densityValues);
+  }, [density, densityValues]);
+}
+
+/**
+ * 格内错误文字的总高度（含 terse 样式的 1px 边框，上下内边距与外边距归零，box-sizing: border-box）。
+ * 文字紧贴输入框下沿（top:100%），输入框高 = 行高 - 3px，所以格底到输入框底的距离是 ROW_FEEDBACK_EXTRA_HEIGHT + 3，
+ * 本值必须不超过它，否则会被行底边线穿过。
+ */
+export var ARRAY_TABLE_HELP_LINE_HEIGHT = 20;
+
+/** 表格里有出错行时挂在网格外层的类名(由 index.tsx 设置) */
+export var ARRAY_TABLE_FEEDBACK_CLASS = 'ag-array-table-has-feedback';
+
+/**
+ * 单元格里的表单项与内容区垂直居中(只对使用本主题的网格生效,共用主题不受影响):
+ *  - .ag-cell-wrapper 撑满格子,align-items:center 才起作用(默认只有内容高,贴在格子顶部);
+ *    表格里有出错行时(外层带 ARRAY_TABLE_FEEDBACK_CLASS)内容高度不超过标准行高对应的高度:出错行会被撑高(见 rowFeedback.ts),
+ *    内容仍居中在上面那一段,多出来的高度留给输入框下方的错误文字,出错时输入框不会被挤得上下跳;
+ *  - FormItem 默认 margin-bottom:24px(loose 反馈布局给错误文字预留的位置),会把 Editable 外壳撑到 56px、
+ *    输入框偏上、还超出 37px 的格子,归零;
+ *  - AG-Grid 的 .ag-cell-value 默认 overflow:hidden,会把输入框下方的错误文字剪掉,只在格里正显示错误文字时放开;
+ *  - 错误文字单行显示、超出列宽省略,出错行只多留一行的高度(ROW_FEEDBACK_EXTRA_HEIGHT);
+ *  - 错误提示文字移出文档流(位置仍在输入框下方),出错时输入框不会被挤得上下跳。
+ */
+export var ARRAY_TABLE_CELL_FIT_CSS = "\n    .ag-cell .ag-cell-wrapper { height: 100%; max-height: 100%; min-height: 0; }\n    .ag-cell .ag-cell-value { max-height: 100%; min-height: 0; }\n    /* \u672C part \u7684 CSS \u4F1A\u88AB AG-Grid \u5305\u8FDB :where(.ag-theme-xxx) { ... }\uFF08\u5D4C\u5957\uFF09\uFF0C\u88F8\u5199 .has-feedback .ag-cell \u4F1A\u7F16\u8BD1\u6210\n       \u300C\u4E3B\u9898\u5143\u7D20\u7684\u540E\u4EE3 has-feedback\u300D\uFF0C\u800C\u8BE5\u7C7B\u6302\u5728\u4E3B\u9898\u5143\u7D20\u7684\u7956\u5148\u4E0A\uFF0C\u89C4\u5219\u6C38\u8FDC\u4E0D\u547D\u4E2D\u3002\n       \u6240\u4EE5\u7528 & \u663E\u5F0F\u653E\u5728 has-feedback \u4E4B\u540E\uFF08\u7956\u5148\u5199\u6CD5\uFF09\uFF0C\u540C\u65F6\u517C\u5BB9\u7C7B\u540D\u6302\u5728\u4E3B\u9898\u5143\u7D20\u81EA\u8EAB\u7684\u5199\u6CD5\u3002 */\n    .".concat(ARRAY_TABLE_FEEDBACK_CLASS, " & .ag-cell .ag-cell-wrapper,\n    &.").concat(ARRAY_TABLE_FEEDBACK_CLASS, " .ag-cell .ag-cell-wrapper { height: min(100%, calc(var(--ag-row-height) - 3px)); }\n    /* \u5BBF\u4E3B\u53EF\u80FD\u5199 .xxx .ant-formily-item { margin-bottom: 12px }\uFF08\u7279\u5F02\u6027 0,3,0\uFF09\uFF1B\u8FD9\u91CC\u53E0\u7C7B\u540D\u5E76 !important\uFF0C\u4EFB\u4F55\u5BBF\u4E3B\u89C4\u5219\u90FD\u538B\u4E0D\u8FC7\uFF0C\n       \u5426\u5219\u683C\u5185\u63A7\u4EF6\u4F1A\u88AB margin \u9876\u5F97\u504F\u4E0A 3-5px\u3002@author nokecy */\n    .ag-cell .ag-cell-wrapper .ant-formily-item.ant-formily-item { margin-bottom: 0 !important; }\n    /* \u6807\u9898\u548C\u8BF4\u660E\u7531\u5217\u5934\u627F\u8F7D\uFF0ClabelWidth:0 \u672C\u8EAB\u4E0D\u4F1A\u9690\u85CF\u5B57\u6BB5\u6807\u9898\u3002@author nokecy */\n    .ag-cell .ant-formily-item-label { display: none; }\n    .ag-cell .ant-formily-item-control { flex: 1; min-width: 0; width: 100%; }\n    /* \u5E26\u5916\u58F3\u7684\u8F93\u5165\u6846\uFF08affix/wrapper\uFF09\u662F inline-flex\uFF0Cantd \u7ED9\u8868\u5355\u9879\u5185\u5BB9\u533A controlHeight \u7684\u6700\u5C0F\u9AD8\u5EA6\u548C\u5BF9\u5E94\u884C\u9AD8\uFF0C\n       \u5916\u58F3\u6309\u57FA\u7EBF\u5BF9\u9F50\u88AB\u9876\u504F\u3002\u5185\u5BB9\u533A\u6539\u6210\u5C45\u4E2D\u7684 flex\uFF08\u5B50\u9879\u88AB\u5757\u5316\uFF0C\u4E0D\u518D\u6709\u57FA\u7EBF\u5BF9\u9F50\uFF09\uFF0C\u6700\u5C0F\u9AD8\u5EA6\u5F52\u96F6\uFF0C\n       \u8868\u5355\u9879\u9AD8\u5EA6\u7531\u63A7\u4EF6\u81EA\u5DF1\u7684\u9AD8\u5EA6\uFF08\u884C\u9AD8-3px\uFF09\u51B3\u5B9A\uFF0C\u4E0D\u8D85\u51FA\u884C\u9AD8\u3002 */\n    .ag-cell .ant-formily-item,\n    .ag-cell .ant-formily-item-control,\n    .ag-cell .ant-formily-item-control-content,\n    .ag-cell .ant-formily-item-control-content-component { min-height: 0 !important; }\n    .ag-cell .ant-formily-item-control-content,\n    .ag-cell .ant-formily-item-control-content-component { display: flex; align-items: center; }\n    .ag-cell .ant-formily-item-control-content-component { flex: 1 1 auto; min-width: 0; }\n    .ag-cell .ant-formily-item-control-content-component > * { flex: 1 1 auto; min-width: 0; }\n    /* \u9519\u8BEF\u6587\u5B57\u9489\u5728\u8F93\u5165\u6846\u6B63\u4E0B\u65B9\uFF08top:100% \u76F8\u5BF9 .ant-formily-item\uFF09\uFF0C\u9AD8\u5EA6\u56FA\u5B9A\u4E3A ARRAY_TABLE_HELP_LINE_HEIGHT\uFF0C\n       \u4E0D\u518D\u4F9D\u8D56\u6587\u6863\u6D41\u91CC\u7684\u9759\u6001\u4F4D\u7F6E\uFF08\u4F1A\u968F margin/\u5C45\u4E2D\u504F\u79FB\uFF0C\u5BFC\u81F4\u88AB\u884C\u5E95\u8FB9\u7EBF\u7A7F\u8FC7\uFF09\u3002 */\n    .ag-cell .ant-formily-item-help { position: absolute; top: 100%; inset-inline-start: 0; margin: 0 !important; padding-block: 0 !important; box-sizing: border-box !important; min-height: 0 !important; height: ").concat(ARRAY_TABLE_HELP_LINE_HEIGHT, "px !important; line-height: ").concat(ARRAY_TABLE_HELP_LINE_HEIGHT - 2, "px !important; max-width: 100%; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }\n    .ag-cell .ag-cell-value:has(.ant-formily-item-help) { overflow: visible; }\n    /* \u5217\u5BF9\u9F50\uFF08align \u5199\u6CD5\uFF09\uFF1B\u6B63\u5728\u7F16\u8F91\u7684\u8F93\u5165\u6846\u8DDF\u968F\u6240\u5728\u5217\u7684\u5BF9\u9F50\uFF0C\u6570\u5B57\u5217\u70B9\u5F00\u7F16\u8F91\u65F6\u4E0D\u4F1A\u8DF3\u5230\u5DE6\u8FB9\u3002@author nokecy */\n    .ag-cell.qc-array-table-align-left { text-align: left; }\n    .ag-cell.qc-array-table-align-center { text-align: center; }\n    .ag-cell.qc-array-table-align-right { text-align: right; }\n    .ag-cell .ant-input-number .ant-input-number-input,\n    .ag-cell .ant-input-affix-wrapper .ant-input,\n    .ag-cell .ant-input.ant-input { text-align: inherit; }\n    .ag-header-cell.qc-array-table-required .ag-header-cell-text::before {\n      content: '*';\n      color: var(--ag-invalid-color);\n      margin-inline-end: 4px;\n    }\n    /* \u5355\u5C42\u6846\uFF1A\u683C\u5185\u63A7\u4EF6\u4E0D\u753B\u81EA\u5DF1\u7684\u8FB9\u6846/\u9634\u5F71/\u5E95\u8272\uFF0C\u6491\u6EE1\u5355\u5143\u683C\uFF1B\n       \u805A\u7126/\u9519\u8BEF/\u9501\u5B9A\u53EA\u7531\u5355\u5143\u683C\u7684 inset \u6846\uFF08\u6216\u5E95\u8272\uFF09\u8868\u8FBE\uFF0C\u4E0D\u5360\u5C3A\u5BF8\uFF0C\u884C\u9AD8\u4E0E\u5355\u5143\u683C\u5C3A\u5BF8\u4E0D\u53D8\u3002\n       \u9009\u62E9\u5668\u5168\u90E8\u9650\u5B9A\u5728 .ag-cell \u5185\uFF0C\u800C\u672C part \u53EA\u6302\u5728 ArrayTable \u7684\u4E3B\u9898\u4E0A\uFF0C\u4E0D\u5F71\u54CD\u8868\u683C\u5916\u7684\u8868\u5355\u3002@author nokecy */\n    .ag-cell .ant-input.ant-input,\n    .ag-cell .ant-input-affix-wrapper.ant-input-affix-wrapper,\n    .ag-cell .ant-input-number.ant-input-number,\n    .ag-cell .ant-input-number-affix-wrapper.ant-input-number-affix-wrapper,\n    .ag-cell .ant-select.ant-select,\n    .ag-cell .ant-select.ant-select .ant-select-selector,\n    .ag-cell .ant-picker.ant-picker,\n    .ag-cell .ant-input-outlined.ant-input-outlined {\n      border: 0 !important;\n      box-shadow: none !important;\n      background: transparent !important;\n      outline: none;\n    }\n    .ag-cell .ant-input-number, .ag-cell .ant-picker, .ag-cell .ant-select, .ag-cell .ant-input-affix-wrapper { width: 100%; }\n    /* \u63A7\u4EF6\u300C\u50CF\u6587\u672C\u300D\uFF1A\u5B57\u53F7\u3001\u6C34\u5E73\u5185\u8FB9\u8DDD\u8DDF\u968F\u5BC6\u5EA6\uFF08\u5355\u5143\u683C\u81EA\u5DF1\u5DF2\u6709 --ag-cell-horizontal-padding\uFF0C\u63A7\u4EF6\u4E0D\u518D\u53E0\u4E00\u5C42\uFF09\uFF0C\n       \u9AD8\u5EA6\u968F\u884C\u9AD8\u3001\u7559 3px \u7ED9\u4E0B\u8FB9\u6846\u4E0E\u5C45\u4E2D\u4F59\u91CF\uFF0C\u4E0D\u6491\u9AD8\u884C\uFF1B\u5BC6\u5EA6\u7531\u4E3B\u9898\u53C2\u6570 rowHeight \u51B3\u5B9A\uFF0C\u4E0D\u5199\u6B7B\u50CF\u7D20\u3002@author nokecy */\n    .ag-cell .ant-input.ant-input,\n    .ag-cell .ant-input-affix-wrapper.ant-input-affix-wrapper,\n    .ag-cell .ant-input-number.ant-input-number,\n    .ag-cell .ant-input-number-affix-wrapper.ant-input-number-affix-wrapper,\n    .ag-cell .ant-select.ant-select,\n    .ag-cell .ant-select.ant-select .ant-select-selector,\n    .ag-cell .ant-picker.ant-picker { font-size: inherit !important; padding-inline: 0 !important; }\n    /* antd 6 \u7684 Select \u6839\u8282\u70B9\u81EA\u5DF1\u5E26\u8FB9\u6846\u4E0E\u5185\u8FB9\u8DDD\uFF08\u6CA1\u6709 .ant-select-selector\uFF09\uFF0C\u4E0A\u4E0B\u5185\u8FB9\u8DDD\u4E5F\u5F52\u96F6\uFF0C\u9AD8\u5EA6\u7531\u4E0B\u9762\u7684 height \u51B3\u5B9A\uFF0C\u5782\u76F4\u5C45\u4E2D\u3002*/\n    .ag-cell .ant-select.ant-select { padding-block: 0 !important; align-items: center; }\n    .ag-cell .ant-input-number .ant-input-number-input,\n    .ag-cell .ant-picker .ant-picker-input > input,\n    .ag-cell .ant-select .ant-select-selection-item,\n    .ag-cell .ant-select .ant-select-selection-search-input,\n    .ag-cell .ant-select .ant-select-content,\n    .ag-cell .ant-select .ant-select-content-item,\n    .ag-cell .ant-select .ant-select-placeholder,\n    .ag-cell .ant-select .ant-select-input { font-size: inherit !important; padding-inline: 0 !important; }\n    .ag-cell .ant-input.ant-input,\n    .ag-cell .ant-input-affix-wrapper.ant-input-affix-wrapper,\n    .ag-cell .ant-input-number.ant-input-number,\n    .ag-cell .ant-input-number-affix-wrapper.ant-input-number-affix-wrapper,\n    .ag-cell .ant-select.ant-select,\n    .ag-cell .ant-select.ant-select .ant-select-selector,\n    .ag-cell .ant-picker.ant-picker { height: calc(var(--ag-row-height) - 3px) !important; min-height: 0 !important; }\n    /* \u5957\u5728\u5916\u58F3\u91CC\u7684\u5185\u5C42\u63A7\u4EF6\u6491\u6EE1\u5916\u58F3\u5373\u53EF\uFF0C\u518D\u8BBE\u540C\u4E00\u9AD8\u5EA6\u4F1A\u52A0\u4E0A\u5916\u58F3 padding \u6EA2\u51FA\uFF1B\u591A\u884C\u6587\u672C\u57DF\u4E0D\u53D7\u9650\u3002*/\n    .ag-cell .ant-input-affix-wrapper .ant-input.ant-input,\n    .ag-cell .ant-input-number-affix-wrapper .ant-input-number-input { height: 100% !important; }\n    /* \u591A\u884C\u6587\u672C\u5728\u56FA\u5B9A\u884C\u9AD8\u7684\u683C\u91CC\u4E0D\u6491\u9AD8\u884C\uFF1A\u9AD8\u5EA6\u53D6\u5355\u884C\u9AD8\uFF0C\u8D85\u51FA\u5185\u5BB9\u5728\u6846\u5185\u6EDA\u52A8 */\n    .ag-cell textarea.ant-input.ant-input { height: calc(var(--ag-row-height) - 3px) !important; min-height: 0 !important; resize: none; overflow-y: auto; line-height: calc(var(--ag-row-height) - 5px) !important; padding-block: 0 !important; }\n    /* Editable \u88C5\u9970\u5668\u5916\u58F3\u9ED8\u8BA4 inline-block\uFF0C\u4F1A\u5728 .ag-cell-value \u7684\u884C\u76D2\u91CC\u6309\u57FA\u7EBF\u5BF9\u9F50\u3001\u88AB\u9876\u504F\uFF1B\u6539\u4E3A\u5757\u7EA7 flex \u4E0E\u5176\u4ED6\u63A7\u4EF6\u4E00\u81F4\u5C45\u4E2D */\n    .ag-cell .ant-formily-editable { display: flex; align-items: center; width: 100%; }\n    /* Select \u6587\u5B57\u884C\u9AD8\u4E0E\u641C\u7D22\u6846\u4F4D\u7F6E\uFF1Aselector \u5F52\u96F6\u5185\u8FB9\u8DDD\u540E\uFF0C\u6587\u5B57\u884C\u9AD8\u53D6\u683C\u5185\u53EF\u7528\u9AD8\u5EA6\uFF0C\u641C\u7D22\u8F93\u5165\u6846\u8D34\u5DE6\uFF0C\u5149\u6807\u4E0D\u9519\u4F4D\u3002*/\n    .ag-cell .ant-select .ant-select-selection-item,\n    .ag-cell .ant-select .ant-select-selection-placeholder,\n    .ag-cell .ant-select .ant-select-selection-search-input,\n    .ag-cell .ant-select .ant-select-content,\n    .ag-cell .ant-select .ant-select-content-item,\n    .ag-cell .ant-select .ant-select-placeholder,\n    .ag-cell .ant-select .ant-select-input { line-height: calc(var(--ag-row-height) - 3px) !important; }\n    .ag-cell .ant-select .ant-select-selection-search { inset-inline: 0 !important; }\n    /* \u6B65\u8FDB\u5668\u4E0E\u65E5\u5386\u56FE\u6807\u5728\u4EFB\u4F55\u72B6\u6001\u90FD\u4E0D\u663E\u793A\uFF08\u4E0E\u6F14\u793A\u4E00\u81F4\uFF1A\u952E\u76D8\u7528\u65B9\u5411\u952E/\u952E\u5165\uFF0C\u9762\u677F\u7531\u70B9\u51FB\u5C55\u5F00\uFF09\uFF1B\n       Input \u53EA\u4FDD\u7559\u6E05\u9664\u56FE\u6807\u3002\u4E0B\u62C9\u7BAD\u5934\u53EA\u5728\u805A\u7126\u6216\u9762\u677F\u5C55\u5F00\u65F6\u51FA\u73B0\u3002@author nokecy */\n    .ag-cell .ant-input-number-handler-wrap { display: none !important; }\n    .ag-cell .ant-picker .ant-picker-suffix { display: none !important; }\n    .ag-cell .ant-input-suffix > :not(.ant-input-clear-icon):not(.ant-input-show-count-suffix) { display: none !important; }\n    .ag-cell .ant-select:not(.ant-select-focused):not(.ant-select-open) .ant-select-arrow,\n    .ag-cell .ant-select:not(.ant-select-focused):not(.ant-select-open) .ant-select-suffix { display: none !important; }\n    /* \u672A\u805A\u7126\u4E14\u4E3A\u7A7A\uFF1A\u5F31\u5360\u4F4D\u4E0E\u666E\u901A\u7A7A\u683C\u4E00\u81F4\uFF0C\u53EA\u7528 placeholder \u8272\uFF0C\u4E0D\u753B\u8F93\u5165\u6846\u5916\u89C2\u3002@author nokecy */\n    .ag-cell .ant-select-selection-placeholder,\n    .ag-cell .ant-select-placeholder,\n    .ag-cell .ant-input::placeholder,\n    .ag-cell .ant-input-number-input::placeholder,\n    .ag-cell .ant-picker input::placeholder { color: var(--ant-color-text-placeholder, rgb(0 0 0 / 25%)) !important; }\n    /* \u5408\u8BA1\u884C\uFF1A\u56FA\u5B9A\u5728\u8868\u5C3E\uFF0C\u5B57\u91CD\u5F3A\u8C03\u3001\u4E0E\u660E\u7EC6\u884C\u4EE5\u4E0A\u8FB9\u7EBF\u5206\u5F00\u3002@author nokecy */\n    .ag-floating-bottom .ag-row { font-weight: 600; background: var(--ant-color-fill-quaternary, rgb(0 0 0 / 4%)); }\n    .ag-cell:focus-within { box-shadow: inset 0 0 0 1px var(--ant-color-primary, #1f5fbf); }\n    .ag-cell:has(.ant-formily-item-error), .ag-cell:has(.ant-formily-item-error):focus-within {\n      box-shadow: inset 0 0 0 1px var(--ant-color-error, #d93025);\n    }\n    .ag-cell:has(.ant-input[disabled], .ant-input-disabled, .ant-input-number-disabled, .ant-select-disabled, .ant-picker-disabled) {\n      background: var(--ant-color-fill-quaternary, rgb(0 0 0 / 4%));\n    }\n  ");
+export var arrayTableCellFit = createPart({
+  feature: 'arrayTableCellFit',
+  css: ARRAY_TABLE_CELL_FIT_CSS
+});
+
+/** 根据当前 antd 主题与 Provider 密度生成编辑态或阅读态明细表格主题。@author nokecy */
+export function useArrayTableTheme() {
+  var editable = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : false;
+  var metrics = useArrayTableMetrics();
+  // 叠加而非替换：useAgGridTheme 把密度的字号/行高/表头高/水平内边距写进主题，随后只追加本表格的部件。
+  var agGridTheme = useAgGridTheme({
+    density: metrics
+  });
+  return useMemo(function () {
+    var previewTheme = agGridTheme.withPart(arrayTableCellFit);
+    return editable ? previewTheme.withParams({
+      focusShadow: 'none',
+      rangeSelectionBorderColor: 'transparent',
+      rangeSelectionBackgroundColor: 'transparent'
+    }) : previewTheme;
+  }, [agGridTheme, editable]);
+}

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

@@ -0,0 +1,3 @@
+import React from 'react';
+/** 明细表格的区域标题：左侧 3px 主色竖条 + 加粗文字（DESIGN.md §5.2 次级工具栏） */
+export declare const ArrayTableTitle: React.FC<React.PropsWithChildren>;

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

@@ -0,0 +1,24 @@
+import React from 'react';
+
+/** 明细表格的区域标题：左侧 3px 主色竖条 + 加粗文字（DESIGN.md §5.2 次级工具栏） */
+import { jsx as _jsx } from "react/jsx-runtime";
+import { jsxs as _jsxs } from "react/jsx-runtime";
+export var ArrayTableTitle = function ArrayTableTitle(_ref) {
+  var children = _ref.children;
+  return /*#__PURE__*/_jsxs("span", {
+    style: {
+      display: 'inline-flex',
+      alignItems: 'center',
+      gap: 8,
+      fontWeight: 600
+    },
+    children: [/*#__PURE__*/_jsx("span", {
+      style: {
+        width: 3,
+        height: 14,
+        background: 'var(--ind-primary, var(--ant-color-primary))',
+        borderRadius: 1
+      }
+    }), children]
+  });
+};

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

@@ -0,0 +1,72 @@
+import React from 'react';
+import { AgGridReactProps } from 'ag-grid-react';
+import { ArrayField } from '@nokecy/formily-core';
+import { Schema } from '@nokecy/formily-json-schema';
+import { ObservableColumnSource } from './interface';
+declare const isColumnComponent: (schema: Schema) => boolean;
+declare const useArrayTableSources: () => ObservableColumnSource[];
+declare const useArrayTableActions: () => ObservableColumnSource[];
+/**
+ * 懒挂载单元格渲染器(可编辑列)。
+ *
+ * 已有行的可编辑格被 Editable 装饰器默认转成 readPretty 只读文本态(点击才进编辑),
+ * 但仍挂着完整 Formily 树——这是行多列多滚动卡的主因。本渲染器让每个格在两种形态间切换:
+ *  - 懒挂载文本:只渲染廉价纯文本(复用 readOnlyFormatters),不挂 Formily 树。默认形态。
+ *  - 挂载态:挂 AgField 全树,可编辑、可校验。
+ *
+ * 何时挂载:
+ *  1. 被激活(点击/键盘导航进来):激活态存放在 AG-Grid context.activeCells(Set),
+ *     由 index.tsx 写入并 refreshCells;
+ *  2. 必填且为空:空的必填格必须是真控件,否则没有字段节点,提交时没人校验它。
+ *     不区分新增行、存量行、initialValues 带进来的行——只看「必填且空」。
+ *     例外:Editable 装饰器的非新增行,Editable 自己会把它转成只读态,挂了也不校验,留在文本态。
+ * 何时卸回文本:焦点离开本格,且该字段校验通过(必填的已填上、没有格式错误)。
+ *  必填仍为空或校验有错则留着控件,让用户看见错误——与 Editable 失焦时的判断一致。
+ *  卸掉的只是渲染树,Formily 字段节点与值都还在,再次点击会接着用。
+ *
+ * 校验安全:空的必填格不会卸成文本(见上);其余格卸载前已校验通过。@author nokecy
+ */
+declare const LazyAgField: (params: any) => React.JSX.Element;
+/**
+ * 反应式只读文本渲染器(列级 readPretty 在「可编辑表」里的展示列)。
+ *
+ * 只读纯文本快路径(valueFormatter)经 AG-Grid 缓存 params.value 取值,setValuesIn 程序化原地改值
+ * 不会刷新该格 → 自动带出的外码/描述等只读展示列空白。本渲染器 Observer 读可观察 record[dataKey],
+ * 保持 readPretty 纯文本观感(不挂 Formily 树、不可点编辑),但能跟随 setValuesIn 即时刷新。
+ *
+ * 仅用于「可编辑表的列级 readPretty 展示列」;「整表 readPretty」(明细/详情页,数据经 setValues 整体
+ * 加载,行引用整体替换→AG-Grid 自然刷新)仍走更廉价的静态 valueFormatter 快路径。@author nokecy
+ */
+declare const LazyReadOnlyText: (params: any) => React.JSX.Element;
+declare const findDataFieldSchema: (columnSchema: Schema, name: string) => any;
+declare const buildArrayTableColumns: (dataSource: any[], field: ArrayField, sources: ObservableColumnSource[]) => AgGridReactProps['columnDefs'];
+/**
+ * 找到 schema 里的 ArrayTable.Addition 占位节点,返回它的 x-component-props(新增按钮的 title / defaultValue / onAdd 等)。
+ *
+ * Addition 节点本身不渲染(表格在工具栏画自己的新增按钮),所以不能从渲染出的元素上取 props——
+ * 直接读节点 schema 的 x-component-props,并按当前表达式作用域求一次 `{{...}}` 表达式。
+ * 没有 Addition 节点返回 null。@author nokecy
+ */
+declare const useAddition: () => {
+    name: string;
+    schema: Schema;
+    props: Record<string, any>;
+} | null;
+export { findDataFieldSchema, isColumnComponent, useArrayTableSources, useArrayTableActions, buildArrayTableColumns, useAddition, LazyAgField, LazyReadOnlyText };
+export type LazyColumnDefault = {
+    key: string;
+    value: any;
+};
+/**
+ * 收集懒挂载列上声明了 default 的字段。
+ *
+ * Formily 在字段创建时把 schema 的 default 写进值（值为空时）。懒挂载的格子不创建字段，
+ * 老记录里缺的列、代码直接 push 的行就拿不到默认值，保存时是 null。
+ * 表达式形态的默认值（{{...}}）要求值上下文，这里不处理。@author nokecy
+ */
+export declare const collectLazyDefaults: (columns: any[]) => LazyColumnDefault[];
+/**
+ * 给还没处理过的新增行补默认值：值为空（null/undefined）才写，每行只补一次——
+ * 用户之后把格子清空是有意的，不能再被填回去。已落库的行（带 id）不动。@author nokecy
+ */
+export declare const applyLazyDefaults: (arrayField: any, defaults: LazyColumnDefault[], handled: WeakSet<object>) => void;