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

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

@@ -0,0 +1,115 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useFeedbackRows = exports.collectFeedbackRows = exports.ROW_FEEDBACK_EXTRA_HEIGHT = void 0;
+var _react = require("react");
+var _formilyCore = require("@nokecy/formily-core");
+var _uniqueId = _interopRequireDefault(require("lodash/uniqueId"));
+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 _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; }
+/**
+ * 默认(loose)反馈布局下,单元格里的校验错误文字画在输入框下方;行高只放得下输入框,
+ * 错误文字会被单元格/下一行/表格底边盖住(formily #4134)。出错的行额外加这么多高度来放它。
+ */
+var ROW_FEEDBACK_EXTRA_HEIGHT = exports.ROW_FEEDBACK_EXTRA_HEIGHT = 24;
+
+/** 这些反馈布局的错误不占行内位置(浮层 / 不显示),不需要撑高行 */
+var OUT_OF_FLOW_LAYOUTS = new Set(['popover', 'none']);
+
+/**
+ * 找出当前有「行内错误文字」的行:返回这些行的数据对象(与 AG-Grid rowData 里的元素同一引用)。
+ *
+ * 只看数组元素下的字段错误;装饰器上写了 feedbackLayout: 'popover' | 'none' 的字段错误不占位,不计入。
+ * 这里读的是整张字段表(queryFeedbacks 会遍历数组下所有字段),不要在组件渲染期间调用——
+ * 渲染期读它会让组件订阅字段表,每创建一个字段就重渲一次。请用 useFeedbackRows。@author nokecy
+ */
+var collectFeedbackRows = exports.collectFeedbackRows = function collectFeedbackRows(arrayField) {
+  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;
+      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 = 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;
+      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
+ */
+var useFeedbackRows = exports.useFeedbackRows = function useFeedbackRows(arrayField) {
+  var rowsRef = (0, _react.useRef)(new Set());
+  var _useState = (0, _react.useState)(''),
+    _useState2 = _slicedToArray(_useState, 2),
+    signature = _useState2[0],
+    setSignature = _useState2[1];
+  (0, _react.useEffect)(function () {
+    var form = arrayField === null || arrayField === void 0 ? void 0 : arrayField.form;
+    if (!form) return;
+    var id = (0, _uniqueId.default)('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);
+        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 () {
+      (0, _formilyCore.onFieldValidateEnd)(pattern, refresh);
+      (0, _formilyCore.onFieldUnmount)(pattern, refresh);
+      (0, _formilyCore.onFormReset)(refresh);
+    });
+    refresh();
+    return function () {
+      if (timer !== undefined) clearTimeout(timer);
+      form.removeEffects(id);
+    };
+  }, [arrayField]);
+  return {
+    rowsRef: rowsRef,
+    signature: signature
+  };
+};

package/dist/cjs/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/cjs/array-table/rowIdentity.js

@@ -0,0 +1,43 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getArrayTableRowId = exports.ensureArrayTableRowIds = void 0;
+var _uniqueId = _interopRequireDefault(require("lodash/uniqueId"));
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+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); }
+/**
+ * 读取业务行标识；尚未补入表单的行按对象缓存临时标识，不在渲染期间改写表单。
+ * @param row 明细行。
+ * @param generatedIds 当前表格已分配的临时行标识。
+ * @returns AG-Grid 使用的稳定字符串标识。
+ * @author nokecy
+ */
+var getArrayTableRowId = exports.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 = (0, _uniqueId.default)('row_');
+    generatedIds.set(row, generatedId);
+  }
+  return generatedId;
+};
+
+/**
+ * 在 effect 中为缺少业务标识的明细补入可枚举 _id，使业务克隆行时保留 AG-Grid 行身份。
+ * 复用首次渲染已分配的标识，补值本身不会使单元格重挂；已有 _id/id（含 0）保持原值。
+ * @param field 当前明细数组字段。
+ * @param generatedIds 当前表格已分配的临时行标识。
+ * @author nokecy
+ */
+var ensureArrayTableRowIds = exports.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/cjs/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/cjs/array-table/sorting.js

@@ -0,0 +1,46 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.createArrayTableComparator = void 0;
+var _decimal = _interopRequireDefault(require("decimal.js"));
+var _dayjs = _interopRequireDefault(require("dayjs"));
+var _readOnlyFormatters = require("./readOnlyFormatters");
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+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 */
+var createArrayTableComparator = exports.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 (0, _readOnlyFormatters.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 && (0, _dayjs.default)(value).isValid()) return (0, _dayjs.default)(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.default(left).cmp(new _decimal.default(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/cjs/array-table/theme.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 行高 38:放得下 32px 高的输入框。网格选项 rowHeight 与主题参数 rowHeight 必须同值——
+ * AG-Grid 单元格文字的行高(--ag-internal-content-line-height)是从主题的 --ag-row-height 算的,
+ * 只设网格选项会让文字的行盒仍是主题默认行高(29.6-3=26.6px),顶在 37px 的格子上方(偏上约 4.5px)。
+ */
+export declare const ARRAY_TABLE_ROW_HEIGHT = 38;
+/** 表格里有出错行时挂在网格外层的类名(由 index.tsx 设置) */
+export declare const ARRAY_TABLE_FEEDBACK_CLASS = "ag-array-table-has-feedback";
+/** 根据当前 antd 主题生成编辑态或阅读态明细表格主题。@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/cjs/array-table/theme.js

@@ -0,0 +1,57 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.ARRAY_TABLE_ROW_HEIGHT = exports.ARRAY_TABLE_FEEDBACK_CLASS = void 0;
+exports.useArrayTableTheme = useArrayTableTheme;
+var _agGridCommunity = require("ag-grid-community");
+var _react = require("react");
+var _theme = require("../ag-grid-plus/theme");
+/**
+ * ArrayTable(明细表格)的 AG-Grid 主题:编辑态(index.tsx)与阅读态(preview.tsx)共用。
+ *
+ * @author nokecy
+ */
+
+/**
+ * 行高 38:放得下 32px 高的输入框。网格选项 rowHeight 与主题参数 rowHeight 必须同值——
+ * AG-Grid 单元格文字的行高(--ag-internal-content-line-height)是从主题的 --ag-row-height 算的,
+ * 只设网格选项会让文字的行盒仍是主题默认行高(29.6-3=26.6px),顶在 37px 的格子上方(偏上约 4.5px)。
+ */
+var ARRAY_TABLE_ROW_HEIGHT = exports.ARRAY_TABLE_ROW_HEIGHT = 38;
+
+/** 表格里有出错行时挂在网格外层的类名(由 index.tsx 设置) */
+var ARRAY_TABLE_FEEDBACK_CLASS = exports.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);
+ *  - 错误提示文字移出文档流(位置仍在输入框下方),出错时输入框不会被挤得上下跳。
+ */
+var arrayTableCellFit = (0, _agGridCommunity.createPart)({
+  feature: 'arrayTableCellFit',
+  css: "\n    .ag-cell .ag-cell-wrapper { height: 100%; }\n    .".concat(ARRAY_TABLE_FEEDBACK_CLASS, " .ag-cell .ag-cell-wrapper { height: min(100%, ").concat(ARRAY_TABLE_ROW_HEIGHT - 3, "px); }\n    .ag-cell .ant-formily-item { margin-bottom: 0; }\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    .ag-cell .ant-formily-item-help { position: absolute; 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  ")
+});
+
+/** 根据当前 antd 主题生成编辑态或阅读态明细表格主题。@author nokecy */
+function useArrayTableTheme() {
+  var editable = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : false;
+  var agGridTheme = (0, _theme.useAgGridTheme)();
+  return (0, _react.useMemo)(function () {
+    var previewTheme = agGridTheme.withParams({
+      rowHeight: ARRAY_TABLE_ROW_HEIGHT
+    }).withPart(arrayTableCellFit);
+    return editable ? previewTheme.withParams({
+      focusShadow: 'none',
+      rangeSelectionBorderColor: 'transparent',
+      rangeSelectionBackgroundColor: 'transparent'
+    }) : previewTheme;
+  }, [agGridTheme, editable]);
+}

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

@@ -0,0 +1,71 @@
+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 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 { 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;