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

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

@@ -0,0 +1,1130 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useArrayTableSources = exports.useArrayTableActions = exports.useAddition = exports.isColumnComponent = exports.findDataFieldSchema = exports.collectLazyDefaults = exports.buildArrayTableColumns = exports.applyLazyDefaults = exports.LazyReadOnlyText = exports.LazyAgField = void 0;
+var _react = _interopRequireWildcard(require("react"));
+var _antd = require("antd");
+var _formilyReact = require("@nokecy/formily-react");
+var _formilyReactive = require("@nokecy/formily-reactive");
+var _formilyShared = require("@nokecy/formily-shared");
+var _formilyJsonSchema = require("@nokecy/formily-json-schema");
+var _arrayBase = _interopRequireDefault(require("./arrayBase"));
+var _readOnlyFormatters = require("./readOnlyFormatters");
+var _columnGroup = require("./columnGroup");
+var _fixedGuard = require("./fixedGuard");
+var _cellFocusScope = require("./cellFocusScope");
+var _cellEditorMarker = require("./cellEditorMarker");
+var _sorting = require("./sorting");
+var _indexColumn = require("./indexColumn");
+var _gridSequence = require("../shared/gridSequence");
+var _requiredHeader = require("./requiredHeader");
+var _columnAlign = require("./columnAlign");
+var _jsxRuntime = require("react/jsx-runtime");
+var _excluded = ["hide", "sort", "sortIndex", "forceAgField", "headerGroup", "defaultHide", "fixed", "requiredMark", "align"];
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(e) { return e ? t : r; })(e); }
+function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != _typeof(e) && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && Object.prototype.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
+function _objectWithoutProperties(source, excluded) { if (source == null) return {}; var target = _objectWithoutPropertiesLoose(source, excluded); var key, i; if (Object.getOwnPropertySymbols) { var sourceSymbolKeys = Object.getOwnPropertySymbols(source); for (i = 0; i < sourceSymbolKeys.length; i++) { key = sourceSymbolKeys[i]; if (excluded.indexOf(key) >= 0) continue; if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue; target[key] = source[key]; } } return target; }
+function _objectWithoutPropertiesLoose(source, excluded) { if (source == null) return {}; var target = {}; var sourceKeys = Object.keys(source); var key, i; for (i = 0; i < sourceKeys.length; i++) { key = sourceKeys[i]; if (excluded.indexOf(key) >= 0) continue; target[key] = source[key]; } return target; }
+function _regeneratorRuntime() { "use strict"; /*! regenerator-runtime -- Copyright (c) 2014-present, Facebook, Inc. -- license (MIT): https://github.com/facebook/regenerator/blob/main/LICENSE */ _regeneratorRuntime = function _regeneratorRuntime() { return e; }; var t, e = {}, r = Object.prototype, n = r.hasOwnProperty, o = Object.defineProperty || function (t, e, r) { t[e] = r.value; }, i = "function" == typeof Symbol ? Symbol : {}, a = i.iterator || "@@iterator", c = i.asyncIterator || "@@asyncIterator", u = i.toStringTag || "@@toStringTag"; function define(t, e, r) { return Object.defineProperty(t, e, { value: r, enumerable: !0, configurable: !0, writable: !0 }), t[e]; } try { define({}, ""); } catch (t) { define = function define(t, e, r) { return t[e] = r; }; } function wrap(t, e, r, n) { var i = e && e.prototype instanceof Generator ? e : Generator, a = Object.create(i.prototype), c = new Context(n || []); return o(a, "_invoke", { value: makeInvokeMethod(t, r, c) }), a; } function tryCatch(t, e, r) { try { return { type: "normal", arg: t.call(e, r) }; } catch (t) { return { type: "throw", arg: t }; } } e.wrap = wrap; var h = "suspendedStart", l = "suspendedYield", f = "executing", s = "completed", y = {}; function Generator() {} function GeneratorFunction() {} function GeneratorFunctionPrototype() {} var p = {}; define(p, a, function () { return this; }); var d = Object.getPrototypeOf, v = d && d(d(values([]))); v && v !== r && n.call(v, a) && (p = v); var g = GeneratorFunctionPrototype.prototype = Generator.prototype = Object.create(p); function defineIteratorMethods(t) { ["next", "throw", "return"].forEach(function (e) { define(t, e, function (t) { return this._invoke(e, t); }); }); } function AsyncIterator(t, e) { function invoke(r, o, i, a) { var c = tryCatch(t[r], t, o); if ("throw" !== c.type) { var u = c.arg, h = u.value; return h && "object" == _typeof(h) && n.call(h, "__await") ? e.resolve(h.__await).then(function (t) { invoke("next", t, i, a); }, function (t) { invoke("throw", t, i, a); }) : e.resolve(h).then(function (t) { u.value = t, i(u); }, function (t) { return invoke("throw", t, i, a); }); } a(c.arg); } var r; o(this, "_invoke", { value: function value(t, n) { function callInvokeWithMethodAndArg() { return new e(function (e, r) { invoke(t, n, e, r); }); } return r = r ? r.then(callInvokeWithMethodAndArg, callInvokeWithMethodAndArg) : callInvokeWithMethodAndArg(); } }); } function makeInvokeMethod(e, r, n) { var o = h; return function (i, a) { if (o === f) throw new Error("Generator is already running"); if (o === s) { if ("throw" === i) throw a; return { value: t, done: !0 }; } for (n.method = i, n.arg = a;;) { var c = n.delegate; if (c) { var u = maybeInvokeDelegate(c, n); if (u) { if (u === y) continue; return u; } } if ("next" === n.method) n.sent = n._sent = n.arg;else if ("throw" === n.method) { if (o === h) throw o = s, n.arg; n.dispatchException(n.arg); } else "return" === n.method && n.abrupt("return", n.arg); o = f; var p = tryCatch(e, r, n); if ("normal" === p.type) { if (o = n.done ? s : l, p.arg === y) continue; return { value: p.arg, done: n.done }; } "throw" === p.type && (o = s, n.method = "throw", n.arg = p.arg); } }; } function maybeInvokeDelegate(e, r) { var n = r.method, o = e.iterator[n]; if (o === t) return r.delegate = null, "throw" === n && e.iterator.return && (r.method = "return", r.arg = t, maybeInvokeDelegate(e, r), "throw" === r.method) || "return" !== n && (r.method = "throw", r.arg = new TypeError("The iterator does not provide a '" + n + "' method")), y; var i = tryCatch(o, e.iterator, r.arg); if ("throw" === i.type) return r.method = "throw", r.arg = i.arg, r.delegate = null, y; var a = i.arg; return a ? a.done ? (r[e.resultName] = a.value, r.next = e.nextLoc, "return" !== r.method && (r.method = "next", r.arg = t), r.delegate = null, y) : a : (r.method = "throw", r.arg = new TypeError("iterator result is not an object"), r.delegate = null, y); } function pushTryEntry(t) { var e = { tryLoc: t[0] }; 1 in t && (e.catchLoc = t[1]), 2 in t && (e.finallyLoc = t[2], e.afterLoc = t[3]), this.tryEntries.push(e); } function resetTryEntry(t) { var e = t.completion || {}; e.type = "normal", delete e.arg, t.completion = e; } function Context(t) { this.tryEntries = [{ tryLoc: "root" }], t.forEach(pushTryEntry, this), this.reset(!0); } function values(e) { if (e || "" === e) { var r = e[a]; if (r) return r.call(e); if ("function" == typeof e.next) return e; if (!isNaN(e.length)) { var o = -1, i = function next() { for (; ++o < e.length;) if (n.call(e, o)) return next.value = e[o], next.done = !1, next; return next.value = t, next.done = !0, next; }; return i.next = i; } } throw new TypeError(_typeof(e) + " is not iterable"); } return GeneratorFunction.prototype = GeneratorFunctionPrototype, o(g, "constructor", { value: GeneratorFunctionPrototype, configurable: !0 }), o(GeneratorFunctionPrototype, "constructor", { value: GeneratorFunction, configurable: !0 }), GeneratorFunction.displayName = define(GeneratorFunctionPrototype, u, "GeneratorFunction"), e.isGeneratorFunction = function (t) { var e = "function" == typeof t && t.constructor; return !!e && (e === GeneratorFunction || "GeneratorFunction" === (e.displayName || e.name)); }, e.mark = function (t) { return Object.setPrototypeOf ? Object.setPrototypeOf(t, GeneratorFunctionPrototype) : (t.__proto__ = GeneratorFunctionPrototype, define(t, u, "GeneratorFunction")), t.prototype = Object.create(g), t; }, e.awrap = function (t) { return { __await: t }; }, defineIteratorMethods(AsyncIterator.prototype), define(AsyncIterator.prototype, c, function () { return this; }), e.AsyncIterator = AsyncIterator, e.async = function (t, r, n, o, i) { void 0 === i && (i = Promise); var a = new AsyncIterator(wrap(t, r, n, o), i); return e.isGeneratorFunction(r) ? a : a.next().then(function (t) { return t.done ? t.value : a.next(); }); }, defineIteratorMethods(g), define(g, u, "Generator"), define(g, a, function () { return this; }), define(g, "toString", function () { return "[object Generator]"; }), e.keys = function (t) { var e = Object(t), r = []; for (var n in e) r.push(n); return r.reverse(), function next() { for (; r.length;) { var t = r.pop(); if (t in e) return next.value = t, next.done = !1, next; } return next.done = !0, next; }; }, e.values = values, Context.prototype = { constructor: Context, reset: function reset(e) { if (this.prev = 0, this.next = 0, this.sent = this._sent = t, this.done = !1, this.delegate = null, this.method = "next", this.arg = t, this.tryEntries.forEach(resetTryEntry), !e) for (var r in this) "t" === r.charAt(0) && n.call(this, r) && !isNaN(+r.slice(1)) && (this[r] = t); }, stop: function stop() { this.done = !0; var t = this.tryEntries[0].completion; if ("throw" === t.type) throw t.arg; return this.rval; }, dispatchException: function dispatchException(e) { if (this.done) throw e; var r = this; function handle(n, o) { return a.type = "throw", a.arg = e, r.next = n, o && (r.method = "next", r.arg = t), !!o; } for (var o = this.tryEntries.length - 1; o >= 0; --o) { var i = this.tryEntries[o], a = i.completion; if ("root" === i.tryLoc) return handle("end"); if (i.tryLoc <= this.prev) { var c = n.call(i, "catchLoc"), u = n.call(i, "finallyLoc"); if (c && u) { if (this.prev < i.catchLoc) return handle(i.catchLoc, !0); if (this.prev < i.finallyLoc) return handle(i.finallyLoc); } else if (c) { if (this.prev < i.catchLoc) return handle(i.catchLoc, !0); } else { if (!u) throw new Error("try statement without catch or finally"); if (this.prev < i.finallyLoc) return handle(i.finallyLoc); } } } }, abrupt: function abrupt(t, e) { for (var r = this.tryEntries.length - 1; r >= 0; --r) { var o = this.tryEntries[r]; if (o.tryLoc <= this.prev && n.call(o, "finallyLoc") && this.prev < o.finallyLoc) { var i = o; break; } } i && ("break" === t || "continue" === t) && i.tryLoc <= e && e <= i.finallyLoc && (i = null); var a = i ? i.completion : {}; return a.type = t, a.arg = e, i ? (this.method = "next", this.next = i.finallyLoc, y) : this.complete(a); }, complete: function complete(t, e) { if ("throw" === t.type) throw t.arg; return "break" === t.type || "continue" === t.type ? this.next = t.arg : "return" === t.type ? (this.rval = this.arg = t.arg, this.method = "return", this.next = "end") : "normal" === t.type && e && (this.next = e), y; }, finish: function finish(t) { for (var e = this.tryEntries.length - 1; e >= 0; --e) { var r = this.tryEntries[e]; if (r.finallyLoc === t) return this.complete(r.completion, r.afterLoc), resetTryEntry(r), y; } }, catch: function _catch(t) { for (var e = this.tryEntries.length - 1; e >= 0; --e) { var r = this.tryEntries[e]; if (r.tryLoc === t) { var n = r.completion; if ("throw" === n.type) { var o = n.arg; resetTryEntry(r); } return o; } } throw new Error("illegal catch attempt"); }, delegateYield: function delegateYield(e, r, n) { return this.delegate = { iterator: values(e), resultName: r, nextLoc: n }, "next" === this.method && (this.arg = t), y; } }, e; }
+function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) { try { var info = gen[key](arg); var value = info.value; } catch (error) { reject(error); return; } if (info.done) { resolve(value); } else { Promise.resolve(value).then(_next, _throw); } }
+function _asyncToGenerator(fn) { return function () { var self = this, args = arguments; return new Promise(function (resolve, reject) { var gen = fn.apply(self, args); function _next(value) { asyncGeneratorStep(gen, resolve, reject, _next, _throw, "next", value); } function _throw(err) { asyncGeneratorStep(gen, resolve, reject, _next, _throw, "throw", err); } _next(undefined); }); }; }
+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); }
+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; }
+var isColumnComponent = exports.isColumnComponent = function isColumnComponent(schema) {
+  var _schema$xComponent;
+  return ((_schema$xComponent = schema['x-component']) === null || _schema$xComponent === void 0 ? void 0 : _schema$xComponent.indexOf('Column')) > -1;
+};
+var isOperationsComponent = function isOperationsComponent(schema) {
+  var _schema$xComponent2;
+  return ((_schema$xComponent2 = schema['x-component']) === null || _schema$xComponent2 === void 0 ? void 0 : _schema$xComponent2.indexOf('Operations')) > -1;
+};
+var isAdditionComponent = function isAdditionComponent(schema) {
+  var _schema$xComponent3;
+  return ((_schema$xComponent3 = schema['x-component']) === null || _schema$xComponent3 === void 0 ? void 0 : _schema$xComponent3.indexOf('Addition')) > -1;
+};
+
+/** 列 schema 里含 ArrayTable.SortHandle / ArrayBase.SortHandle 拖拽手柄 */
+var containsSortHandle = function containsSortHandle(schema) {
+  var _schema$properties;
+  if (!schema) return false;
+  var component = schema['x-component'];
+  if (typeof component === 'string' && /(?:^|\.)SortHandle$/.test(component)) return true;
+  return Object.values((_schema$properties = schema.properties) !== null && _schema$properties !== void 0 ? _schema$properties : {}).some(containsSortHandle);
+};
+var isActionComponent = function isActionComponent(schema) {
+  var _schema$xComponent4;
+  return schema && ((_schema$xComponent4 = schema['x-component']) === null || _schema$xComponent4 === void 0 ? void 0 : _schema$xComponent4.indexOf('Action')) > -1;
+};
+var useArrayTableSources = exports.useArrayTableSources = function useArrayTableSources() {
+  var arrayField = (0, _formilyReact.useField)();
+  var schema = (0, _formilyReact.useFieldSchema)();
+  var components = _react.default.useContext(_formilyReact.SchemaComponentsContext);
+  var parseSources = function parseSources(schema) {
+    if (isColumnComponent(schema) || isOperationsComponent(schema) || isAdditionComponent(schema)) {
+      var _schema$xComponentP, _schema$xComponentP2, _field$component;
+      if (!((_schema$xComponentP = schema['x-component-props']) !== null && _schema$xComponentP !== void 0 && _schema$xComponentP['dataIndex']) && !schema['name']) return [];
+      var name = ((_schema$xComponentP2 = schema['x-component-props']) === null || _schema$xComponentP2 === void 0 ? void 0 : _schema$xComponentP2['dataIndex']) || schema['name'];
+      var field = arrayField.query(arrayField.address.concat(name)).take();
+      //@ts-ignore
+      var columnProps = (field === null || field === void 0 || (_field$component = field.component) === null || _field$component === void 0 ? void 0 : _field$component[1]) || schema['x-component-props'] || {};
+      var display = (field === null || field === void 0 ? void 0 : field.display) || schema['x-display'];
+      return [{
+        name: name,
+        display: display,
+        //@ts-ignore
+        field: field,
+        schema: schema,
+        columnProps: columnProps,
+        components: components
+      }];
+    } else if (schema.properties) {
+      return schema.reduceProperties(function (buf, schema) {
+        //@ts-ignore
+        return buf.concat(parseSources(schema));
+      }, []);
+    }
+    return [];
+  };
+  var parseArrayItems = function parseArrayItems(schema) {
+    if (!schema) return [];
+    var sources = [];
+    var items = (0, _formilyShared.isArr)(schema) ? schema : [schema];
+    return items.reduce(function (columns, schema) {
+      var item = parseSources(schema);
+      if (item) {
+        return columns.concat(item);
+      }
+      return columns;
+    }, sources);
+  };
+  if (!schema) throw new Error('can not found schema object');
+  return parseArrayItems(schema.items);
+};
+var useArrayTableActions = exports.useArrayTableActions = function useArrayTableActions() {
+  var arrayField = (0, _formilyReact.useField)();
+  var schema = (0, _formilyReact.useFieldSchema)();
+  var parseSources = function parseSources(schema) {
+    if (isActionComponent(schema)) {
+      var _schema$xComponentP3, _schema$xComponentP4, _field$component2;
+      if (!((_schema$xComponentP3 = schema['x-component-props']) !== null && _schema$xComponentP3 !== void 0 && _schema$xComponentP3['dataIndex']) && !schema['name']) return [];
+      var name = ((_schema$xComponentP4 = schema['x-component-props']) === null || _schema$xComponentP4 === void 0 ? void 0 : _schema$xComponentP4['dataIndex']) || schema['name'];
+      var field = arrayField.query(arrayField.address.concat(name)).take();
+      //@ts-ignore
+      var columnProps = (field === null || field === void 0 || (_field$component2 = field.component) === null || _field$component2 === void 0 ? void 0 : _field$component2[1]) || schema['x-component-props'] || {};
+      var display = (field === null || field === void 0 ? void 0 : field.display) || schema['x-display'];
+      return [{
+        name: name,
+        display: display,
+        //@ts-ignore
+        field: field,
+        schema: schema,
+        columnProps: columnProps
+      }];
+    } else if (schema.properties) {
+      return schema.reduceProperties(function (buf, schema) {
+        //@ts-ignore
+        return buf.concat(parseSources(schema));
+      }, []);
+    }
+    return [];
+  };
+  if (!schema) throw new Error('can not found schema object');
+  return schema.properties ? parseSources(schema.properties['actions'] || {}) : [];
+};
+
+/**
+ * 从表单当前数组定位单元格所属行。批量选择可保留 _id/id 并替换整行对象，
+ * AG Grid 在格值未变时仍会复用带旧 data 的渲染器；判空、校验和绑定必须使用当前行。
+ * 不以排序/过滤后的显示行号定位数据，已删除的行也不能绑定到后继行。@author nokecy
+ */
+var resolveCellRow = function resolveCellRow(field, record, node, dataSource) {
+  var _field$value, _node$data;
+  var rows = (_field$value = field === null || field === void 0 ? void 0 : field.value) !== null && _field$value !== void 0 ? _field$value : dataSource;
+  var candidate = (_node$data = node === null || node === void 0 ? void 0 : node.data) !== null && _node$data !== void 0 ? _node$data : record;
+  if (!Array.isArray(rows)) return {
+    index: -1,
+    record: candidate
+  };
+  var index = rows.indexOf(candidate);
+  if (index < 0) {
+    var _ref, _ref2, _candidate$_id;
+    var id = (_ref = (_ref2 = (_candidate$_id = candidate === null || candidate === void 0 ? void 0 : candidate._id) !== null && _candidate$_id !== void 0 ? _candidate$_id : candidate === null || candidate === void 0 ? void 0 : candidate.id) !== null && _ref2 !== void 0 ? _ref2 : record === null || record === void 0 ? void 0 : record._id) !== null && _ref !== void 0 ? _ref : record === null || record === void 0 ? void 0 : record.id;
+    if (id != null) index = rows.findIndex(function (row) {
+      var _row$_id;
+      var rowId = (_row$_id = row === null || row === void 0 ? void 0 : row._id) !== null && _row$_id !== void 0 ? _row$_id : row === null || row === void 0 ? void 0 : row.id;
+      return rowId != null && String(rowId) === String(id);
+    });
+  }
+  return {
+    index: index,
+    record: index >= 0 ? rows[index] : undefined
+  };
+};
+var AgField = function AgField(_ref3) {
+  var value = _ref3.value,
+    record = _ref3.data,
+    dataSource = _ref3.dataSource,
+    schema = _ref3.schema,
+    field = _ref3.field,
+    node = _ref3.node,
+    editorComponent = _ref3.editorComponent;
+  var _resolveCellRow = resolveCellRow(field, record, node, dataSource),
+    index = _resolveCellRow.index;
+  if (index < 0) return null;
+  var children =
+  /*#__PURE__*/
+  //@ts-ignore
+  (0, _jsxRuntime.jsx)(_arrayBase.default.Item, {
+    index: index,
+    record: function record() {
+      var _field$value2;
+      return (_field$value2 = field.value) === null || _field$value2 === void 0 ? void 0 : _field$value2[index];
+    },
+    schema: schema,
+    field: field,
+    children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_formilyReact.RecursionField, {
+      schema: schema,
+      name: index,
+      onlyRenderProperties: true
+    })
+  });
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_cellEditorMarker.CellEditorMarker, {
+    kind: (0, _cellEditorMarker.resolveCellEditorKind)(editorComponent),
+    children: children
+  });
+};
+
+/**
+ * 快路径能否按这个字段名取到值。
+ *
+ * Formily 的字段名是「路径」不是「键」,支持点号嵌套(`item.qty`)、数组下标(`a[0]`)、
+ * 解构(`{value:code,label:name}`)等语法。快路径(只读文本/懒挂载)不挂 Formily 树,
+ * 取值得自己解析。这里只认「点号分段」这一种简单形态,其余一律判不合格 ->
+ * 调用方回退 AgField 全树(由 Formily 自己解析,正确优先于速度)。@author nokecy
+ */
+var isSimpleFieldPath = function isSimpleFieldPath(name) {
+  return !!name && /^[^.{}[\]*]+(\.[^.{}[\]*]+)*$/.test(name);
+};
+
+/**
+ * 解析对象解构字段名 `{value:code,label:name}`(选择器 labelInValue 常用),返回 [对象键, 数据路径] 列表;
+ * 不是对象解构、或成员路径不是简单点号路径时返回 null(调用方回退 AgField 全树)。
+ * 成员可简写成 `{code}`,等同 `{code:code}`。@author nokecy
+ */
+var parseObjectDestructure = function parseObjectDestructure(name) {
+  var matched = name && /^\{([^{}]+)\}$/.exec(name.trim());
+  if (!matched) return null;
+  var members = matched[1].split(',').map(function (part) {
+    return part.split(':').map(function (x) {
+      return x.trim();
+    });
+  });
+  if (members.some(function (m) {
+    return m.length > 2 || !m[0] || !isSimpleFieldPath(m[m.length - 1]);
+  })) return null;
+  return members.map(function (m) {
+    return [m[0], m[m.length - 1]];
+  });
+};
+
+/** 快路径(只读文本/懒挂载)能自己解析取值的字段名:简单点号路径或对象解构 @author nokecy */
+var isFastPathFieldName = function isFastPathFieldName(name) {
+  return isSimpleFieldPath(name) || !!parseObjectDestructure(name);
+};
+
+/**
+ * 按 Formily 字段名从行数据取值。
+ *
+ * 曾经一律按扁平键取 record['item.qty'],而数据在 record.item.qty ->
+ * 嵌套字段名恒 undefined,单元格默认空白,点击挂上全树(按路径解析)才显出真值。
+ *
+ * 在 Observer 里逐层读可观察对象,依赖链完整,程序化改值(setValuesIn)照样刷新。@author nokecy
+ */
+var readByFieldPath = function readByFieldPath(record, path) {
+  if (record == null) return undefined;
+  // 对象解构:与 Formily 一致,按成员路径分别取值拼回 {value, label} 对象 @author nokecy
+  var destructure = path.startsWith('{') ? parseObjectDestructure(path) : null;
+  if (destructure) return Object.fromEntries(destructure.map(function (_ref4) {
+    var _ref5 = _slicedToArray(_ref4, 2),
+      key = _ref5[0],
+      memberPath = _ref5[1];
+    return [key, readByFieldPath(record, memberPath)];
+  }));
+  if (path.indexOf('.') < 0) return record[path];
+  return path.split('.').reduce(function (acc, key) {
+    return acc == null ? undefined : acc[key];
+  }, record);
+};
+
+/** 「选一个」型组件:空值占位说「请选择」,其余说「请输入」 */
+var SELECT_LIKE = new Set(['Select', 'TreeSelect', 'Cascader', 'DatePicker', 'TimePicker', 'Radio.Group', 'Checkbox.Group', 'Transfer']);
+
+/**
+ * 懒挂载空值格显示什么。
+ *
+ * 懒挂载把未激活的可编辑格降成纯文本,值为空时整格一片空白——连输入框边框都没有,
+ * 用户看不出这里能填,以为功能坏了。故空值时按真控件的 placeholder 出淡灰占位,
+ * 点开前后看到同一句话,观感连续。
+ *
+ * 同样的理由 Switch/Checkbox 早就强制 eager 了(见 buildArrayTableColumns 的
+ * isInlineToggle),这里是把那条理由推广到其余可编辑列。@author nokecy
+ */
+var resolveEmptyPlaceholder = function resolveEmptyPlaceholder(fieldSchema) {
+  var _fieldSchema$xCompon;
+  var configured = fieldSchema === null || fieldSchema === void 0 || (_fieldSchema$xCompon = fieldSchema['x-component-props']) === null || _fieldSchema$xCompon === void 0 ? void 0 : _fieldSchema$xCompon.placeholder;
+  if (typeof configured === 'string' && configured) return configured;
+  return SELECT_LIKE.has(fieldSchema === null || fieldSchema === void 0 ? void 0 : fieldSchema['x-component']) ? '请选择' : '请输入';
+};
+
+/** Formily 字段的四种 pattern;x-pattern 求出来不在其中,视为「求不出」 */
+var CELL_PATTERNS = new Set(['editable', 'disabled', 'readOnly', 'readPretty']);
+
+/** 按当前行构造与真实字段一致的表达式作用域，供静默展示与编辑权限共用。@author nokecy */
+var lazyCellScope = function lazyCellScope(arrayField, record, dataKey, scope) {
+  var form = arrayField.form;
+  var _resolveCellRow2 = resolveCellRow(arrayField, record),
+    index = _resolveCellRow2.index;
+  var self = {
+    path: arrayField.path.concat(index).concat(dataKey),
+    address: arrayField.address.concat(index).concat(dataKey),
+    index: index,
+    form: form,
+    parent: arrayField,
+    get value() {
+      return readByFieldPath(record, dataKey);
+    },
+    query: function query(pattern) {
+      return form.query(pattern);
+    }
+  };
+  return (0, _formilyShared.lazyMerge)(scope !== null && scope !== void 0 ? scope : {}, {
+    $form: form,
+    $values: form.values,
+    $self: self,
+    $record: record,
+    $index: index
+  });
+};
+
+/** 静默态编译显示配置，保留原始十进制值并使用当前页面、当前行的格式化规则。@author nokecy */
+var lazyDisplaySchema = function lazyDisplaySchema(arrayField, record, dataKey, schema, scope) {
+  var props = schema === null || schema === void 0 ? void 0 : schema['x-component-props'];
+  if (typeof (props === null || props === void 0 ? void 0 : props.formatter) !== 'string' || !props.formatter.includes('{{')) return schema;
+  var expressionScope = lazyCellScope(arrayField, record, dataKey, scope);
+  var formatter = _formilyJsonSchema.Schema.shallowCompile(props.formatter, expressionScope);
+  if (typeof formatter !== 'function') throw new Error('Cell formatter expression must resolve to a function');
+  return _objectSpread(_objectSpread({}, schema), {}, {
+    'x-component-props': _objectSpread(_objectSpread({}, props), {}, {
+      formatter: formatter,
+      precision: _formilyJsonSchema.Schema.shallowCompile(props.precision, expressionScope)
+    })
+  });
+};
+
+/**
+ * 懒挂载格此刻的 pattern。
+ *
+ * 懒挂载不创建 Formily 字段,拿不到字段实例上求好的 pattern,只能按同一套规则自己求:
+ * 字段自己的 x-pattern 优先(表达式按本行本格的作用域求值,$self 只提供 path/index/value/form/parent/query),
+ * 没写则继承整表 pattern。表达式用到本格没有的能力、抛错或求出非法值时返回 undefined,
+ * 调用方按「可编辑」处理,保持原有提示。@author nokecy
+ */
+var resolveLazyCellPattern = function resolveLazyCellPattern(arrayField, record, dataKey, fieldSchema, scope) {
+  var own = fieldSchema === null || fieldSchema === void 0 ? void 0 : fieldSchema['x-pattern'];
+  if (own == null) return arrayField === null || arrayField === void 0 ? void 0 : arrayField.pattern;
+  if (typeof own !== 'string') return undefined;
+  if (CELL_PATTERNS.has(own)) return own;
+  var form = arrayField === null || arrayField === void 0 ? void 0 : arrayField.form;
+  if (!form || !dataKey) return undefined;
+  try {
+    var result = _formilyJsonSchema.Schema.shallowCompile(own, lazyCellScope(arrayField, record, dataKey, scope));
+    return CELL_PATTERNS.has(result) ? result : undefined;
+  } catch (_unused) {
+    return undefined;
+  }
+};
+
+/**
+ * 值算不算「没填」:null/undefined/空串,或成员全是这类值的数组/对象(如 labelInValue 的
+ * {value:undefined,label:undefined})。0 和 false 是有效值,不算空。@author nokecy
+ */
+var isBlank = function isBlank(value) {
+  if (value == null || value === '') return true;
+  if (Array.isArray(value)) return value.every(isBlank);
+  if (Object.prototype.toString.call(value) === '[object Object]') return Object.values(value).every(isBlank);
+  return false;
+};
+var hasRequiredRule = function hasRequiredRule(rule) {
+  if (rule == null) return false;
+  if (rule === 'required') return true;
+  if (Array.isArray(rule)) return rule.some(hasRequiredRule);
+  if (_typeof(rule) === 'object') return rule.required != null && rule.required !== false;
+  return false;
+};
+
+/**
+ * 数据字段是否挂了任何校验规则。
+ *
+ * 懒挂载的格子没有 Formily 字段，提交时 form.validate 碰不到它。必填规则能静态识别，
+ * 但「自定义 validator 函数里判空」「必填写在校验规则的其他形态里」识别不了——
+ * 这类列的空格子若不挂真控件，空值会绕过校验直接提交。故有校验规则的列，空格子按必填一样挂真控件。
+ * 有值的格子里不合格式的内容不在此列（要挂全部校验过的格子等于取消懒挂载）。@author nokecy
+ */
+var hasValidatorRule = function hasValidatorRule(fieldSchema) {
+  var validator = fieldSchema === null || fieldSchema === void 0 ? void 0 : fieldSchema['x-validator'];
+  if (validator == null || validator === '') return false;
+  return Array.isArray(validator) ? validator.length > 0 : true;
+};
+
+/**
+ * 数据字段是否必填(静态判定):字段上写了 required,或 x-validator 里带 required 规则。
+ *
+ * 判不准(required 写成表达式串)时按必填算:误判必填只是多挂一个控件,
+ * 误判非必填会让空的必填格没人校验——与只读判定同样的安全不对称。
+ * 靠 x-reactions 动态改必填的列本就整列 eager,不走这里。@author nokecy
+ */
+var isRequiredSchema = function isRequiredSchema(fieldSchema) {
+  if (!fieldSchema) return false;
+  var required = fieldSchema.required;
+  if (required === true || typeof required === 'string') return true;
+  return hasRequiredRule(fieldSchema['x-validator']);
+};
+
+/**
+ * 懒挂载单元格渲染器(可编辑列)。
+ *
+ * 已有行的可编辑格被 Editable 装饰器默认转成 readPretty 只读文本态(点击才进编辑),
+ * 但仍挂着完整 Formily 树——这是行多列多滚动卡的主因。本渲染器让每个格在两种形态间切换:
+ *  - 懒挂载文本:只渲染廉价纯文本(复用 readOnlyFormatters),不挂 Formily 树。默认形态。
+ *  - 挂载态:挂 AgField 全树,可编辑、可校验。
+ *
+ * 何时挂载:
+ *  1. 被激活(点击/键盘导航进来):激活态存放在 AG-Grid context.activeCells(Set),
+ *     由 index.tsx 写入并 refreshCells;
+ *  2. 必填且为空:空的必填格必须是真控件,否则没有字段节点,提交时没人校验它。
+ *     不区分新增行、存量行、initialValues 带进来的行——只看「必填且空」。
+ *     例外:Editable 装饰器的非新增行,Editable 自己会把它转成只读态,挂了也不校验,留在文本态。
+ * 何时卸回文本:焦点离开本格,且该字段校验通过(必填的已填上、没有格式错误)。
+ *  必填仍为空或校验有错则留着控件,让用户看见错误——与 Editable 失焦时的判断一致。
+ *  卸掉的只是渲染树,Formily 字段节点与值都还在,再次点击会接着用。
+ *
+ * 校验安全:空的必填格不会卸成文本(见上);其余格卸载前已校验通过。@author nokecy
+ */
+var LazyAgField = exports.LazyAgField = function LazyAgField(params) {
+  var _context$activeCells, _fieldSchema$name;
+  var value = params.value,
+    record = params.data,
+    dataSource = params.dataSource,
+    schema = params.schema,
+    field = params.field,
+    node = params.node,
+    colDef = params.colDef,
+    context = params.context,
+    api = params.api,
+    formatter = params.formatter,
+    renderer = params.renderer,
+    columnProps = params.columnProps,
+    fieldSchema = params.fieldSchema,
+    required = params.required;
+  // hook 必须在下面的条件 return 之前调用
+  var _theme$useToken = _antd.theme.useToken(),
+    token = _theme$useToken.token;
+  var scope = (0, _formilyReact.useExpressionScope)();
+  var _useReducer = (0, _react.useReducer)(function (n) {
+      return n + 1;
+    }, 0),
+    _useReducer2 = _slicedToArray(_useReducer, 2),
+    rerender = _useReducer2[1];
+  var localCells = (0, _react.useRef)(new Set());
+  var activeCells = (_context$activeCells = context === null || context === void 0 ? void 0 : context.activeCells) !== null && _context$activeCells !== void 0 ? _context$activeCells : localCells.current;
+  var key = "".concat(node === null || node === void 0 ? void 0 : node.id, ":").concat(colDef === null || colDef === void 0 ? void 0 : colDef.field);
+  // 内层字段名:Column key 与它可能不一致(设计器形态),取值/找字段节点都按它
+  var dataKey = (_fieldSchema$name = fieldSchema === null || fieldSchema === void 0 ? void 0 : fieldSchema.name) !== null && _fieldSchema$name !== void 0 ? _fieldSchema$name : colDef === null || colDef === void 0 ? void 0 : colDef.field;
+
+  /** 离开本格:校验通过才卸回懒挂载文本。未触碰的空必填格保留控件等待填写。@author nokecy */
+  var handleLeave = /*#__PURE__*/function () {
+    var _ref6 = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee(isStale, hadFocus) {
+      var _field$form, _api$isDestroyed;
+      var current, currentValue, index, cellField, latest, _api$refreshCells;
+      return _regeneratorRuntime().wrap(function _callee$(_context) {
+        while (1) switch (_context.prev = _context.next) {
+          case 0:
+            current = resolveCellRow(field, record, node, dataSource);
+            if (!(current.index < 0)) {
+              _context.next = 3;
+              break;
+            }
+            return _context.abrupt("return");
+          case 3:
+            currentValue = dataKey != null ? readByFieldPath(current.record, dataKey) : value; // 新增行的必填空格会预先挂载以参与提交校验；若用户从未进入该格，不在点击页面其他位置时
+            // 主动触发校验，但已带值的格子仍可恢复静默文本态。@author nokecy
+            if (!(required && isBlank(currentValue) && !hadFocus)) {
+              _context.next = 6;
+              break;
+            }
+            return _context.abrupt("return");
+          case 6:
+            index = current.index; // 字段节点按数据路径找(不含 void 容器);从没挂载过就没有节点,无需校验
+            cellField = index >= 0 && dataKey ? (_field$form = field.form) === null || _field$form === void 0 ? void 0 : _field$form.query(field.path.concat(index).concat(dataKey)).take() : undefined;
+            if (!cellField) {
+              _context.next = 17;
+              break;
+            }
+            _context.prev = 9;
+            _context.next = 12;
+            return cellField.validate();
+          case 12:
+            _context.next = 17;
+            break;
+          case 14:
+            _context.prev = 14;
+            _context.t0 = _context["catch"](9);
+            return _context.abrupt("return");
+          case 17:
+            if (!isStale()) {
+              _context.next = 19;
+              break;
+            }
+            return _context.abrupt("return");
+          case 19:
+            latest = resolveCellRow(field, record, node, dataSource); // 校验期间被替换、删除或移位的行，交给下一次离开重新校验。@author nokecy
+            if (!(latest.index !== index || latest.record !== current.record)) {
+              _context.next = 22;
+              break;
+            }
+            return _context.abrupt("return");
+          case 22:
+            if (!(required && isBlank(dataKey != null ? readByFieldPath(latest.record, dataKey) : undefined))) {
+              _context.next = 24;
+              break;
+            }
+            return _context.abrupt("return");
+          case 24:
+            if (activeCells.delete(key)) {
+              _context.next = 26;
+              break;
+            }
+            return _context.abrupt("return");
+          case 26:
+            rerender();
+            // 激活集合由 ArrayTable 与渲染器共享；退出时也同步通知 AG Grid 刷新本格，
+            // 不再依赖新增行等整表更新来收回已完成编辑的控件。字段节点和值仍保留。
+            // @author nokecy
+            if (node && colDef !== null && colDef !== void 0 && colDef.field && !(api !== null && api !== void 0 && (_api$isDestroyed = api.isDestroyed) !== null && _api$isDestroyed !== void 0 && _api$isDestroyed.call(api))) {
+              api === null || api === void 0 || (_api$refreshCells = api.refreshCells) === null || _api$refreshCells === void 0 || _api$refreshCells.call(api, {
+                rowNodes: [node],
+                columns: [colDef.field],
+                force: true
+              });
+            }
+          case 28:
+          case "end":
+            return _context.stop();
+        }
+      }, _callee, null, [[9, 14]]);
+    }));
+    return function handleLeave(_x, _x2) {
+      return _ref6.apply(this, arguments);
+    };
+  }();
+
+  /**
+   * 运行时设置的选项(field.setDataSource / setFieldState dataSource)。
+   *
+   * 只取本格自己的字段：点开过的格子字段还在，失焦卸回文本后仍按名称显示。
+   * 不借同列其他格的选项——选项常常按行不同（如标签类型跟随同行的打印功能），借来的选项会把值映射成别的名称，
+   * 比显示原编码更糟。从未点开过的格子没有字段，要显示名称请把选项写进 Schema（x-component-props.options）。
+   * 仅选项类组件且有值时才查；按精确地址取、放在 untracked 里，不让每个格子都订阅整张字段表。@author nokecy
+   */
+  var liveDataSource = function liveDataSource(liveValue) {
+    var form = field === null || field === void 0 ? void 0 : field.form;
+    // 只有用「选项映射」格式化器的列（Select 一族，或登记为同一格式化器的组件）才需要运行时选项
+    if (!form || !dataKey || isBlank(liveValue) || formatter !== (0, _readOnlyFormatters.getReadOnlyFormatter)('Select')) return undefined;
+    var _resolveCellRow3 = resolveCellRow(field, record, node, dataSource),
+      index = _resolveCellRow3.index;
+    if (index < 0) return undefined;
+    var own = (0, _formilyReactive.untracked)(function () {
+      return form.query(field.path.concat(index).concat(dataKey)).take();
+    });
+    var source = own === null || own === void 0 ? void 0 : own.dataSource;
+    return Array.isArray(source) && source.length > 0 ? source : undefined;
+  };
+
+  // Observer 让本格反应式跟随内层 Formily 字段值。
+  // record 即 field.value[index] 的可观察对象;在 Observer 里按内层字段名直接读 record[dataKey]
+  // (而非 AG-Grid 渲染时快照的 params.value)建立依赖后,onFieldValueChange/setValuesIn 程序化原地
+  // 改值(行引用不变 → AG-Grid 不刷新该格、外层 observer 也不重渲)时,本格能自行重渲刷新——
+  // 免去调用方加 forceAgField 逃生阀。字段名缺失才回退 params.value。@author nokecy
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_formilyReact.Observer, {
+    children: function children() {
+      var _fieldSchema$xCompon2;
+      var _resolveCellRow4 = resolveCellRow(field, record, node, dataSource),
+        currentRecord = _resolveCellRow4.record;
+      if (!currentRecord) return /*#__PURE__*/(0, _jsxRuntime.jsx)(_jsxRuntime.Fragment, {});
+      var activated = activeCells.has(key);
+      // 已挂载时不读值:挂载后每敲一个字都会变,追踪它会让整棵字段树跟着重渲
+      var liveValue = activated ? undefined : dataKey != null ? readByFieldPath(currentRecord, dataKey) : value;
+      // 解构选择值缺少名称时仍要让业务组件补全名称；有名称后才可降为静默文本。@author nokecy
+      if (!activated && formatter === _readOnlyFormatters.fallbackFormatter && liveValue && _typeof(liveValue) === 'object' && !Array.isArray(liveValue) && liveValue.value != null && (liveValue.label == null || liveValue.label === '' || liveValue.label === liveValue.value) && (fieldSchema === null || fieldSchema === void 0 || (_fieldSchema$xCompon2 = fieldSchema['x-component-props']) === null || _fieldSchema$xCompon2 === void 0 ? void 0 : _fieldSchema$xCompon2.displayField) !== 'value') {
+        return /*#__PURE__*/(0, _jsxRuntime.jsx)(AgField, {
+          value: value,
+          data: currentRecord,
+          dataSource: dataSource,
+          schema: schema,
+          field: field,
+          node: node,
+          editorComponent: fieldSchema === null || fieldSchema === void 0 ? void 0 : fieldSchema['x-component']
+        });
+      }
+      // Editable 装饰器会把非新增行的格转成只读态、不参与校验(见 editable/index.tsx),
+      // 这时挂了没用,还会把灰色「请输入」占位换成只读态的「N/A」,所以留在文本态
+      var editableWillReadPretty = (fieldSchema === null || fieldSchema === void 0 ? void 0 : fieldSchema['x-decorator']) === 'Editable' && currentRecord._isNew !== true;
+      if (!activated && required && !editableWillReadPretty && isBlank(liveValue)) {
+        var _pattern = resolveLazyCellPattern(field, currentRecord, dataKey, fieldSchema, scope);
+        if (_pattern == null || _pattern === 'editable') {
+          // 记进激活集合:用户填了第一个字后值不再为空,但格子仍在编辑,要挂到失焦为止
+          activeCells.add(key);
+          activated = true;
+        }
+      }
+      if (activated) {
+        return /*#__PURE__*/(0, _jsxRuntime.jsx)(_cellFocusScope.CellFocusScope, {
+          onLeave: handleLeave,
+          children: /*#__PURE__*/(0, _jsxRuntime.jsx)(AgField, {
+            value: value,
+            data: currentRecord,
+            dataSource: dataSource,
+            schema: schema,
+            field: field,
+            node: node,
+            editorComponent: fieldSchema === null || fieldSchema === void 0 ? void 0 : fieldSchema['x-component']
+          })
+        });
+      }
+      var displaySchema = fieldSchema;
+      try {
+        if (dataKey) displaySchema = lazyDisplaySchema(field, currentRecord, dataKey, fieldSchema, scope);
+      } catch (_unused3) {
+        // 无法在静默作用域求值时保留真实控件，由 Formily 执行完整编译，不显示错误价格。@author nokecy
+        return /*#__PURE__*/(0, _jsxRuntime.jsx)(AgField, {
+          value: value,
+          data: currentRecord,
+          dataSource: dataSource,
+          schema: schema,
+          field: field,
+          node: node,
+          editorComponent: fieldSchema === null || fieldSchema === void 0 ? void 0 : fieldSchema['x-component']
+        });
+      }
+      var ctx = {
+        columnProps: columnProps,
+        fieldSchema: displaySchema,
+        dataSource: liveDataSource(liveValue)
+      };
+      var text = formatter ? formatter(liveValue, ctx) : liveValue == null ? '' : String(liveValue);
+      // 纯文本占满单元格,点击交给 AG-Grid onCellClicked 激活;样式尽量贴近 Editable 只读态避免点开跳动
+      // 只读态(readPretty/disabled/readOnly)的空格不出编辑提示,留空与只读快路径一致
+      var pattern = text === '' ? resolveLazyCellPattern(field, currentRecord, dataKey, fieldSchema, scope) : undefined;
+      if (text === '' && (pattern == null || pattern === 'editable')) {
+        // 空值:出淡灰 placeholder,让用户看得出这格能填(颜色取 antd 输入框 placeholder 的 token,自动跟随暗色主题)
+        return /*#__PURE__*/(0, _jsxRuntime.jsx)("span", {
+          className: "ag-array-table-lazy-placeholder",
+          style: {
+            display: 'inline-block',
+            width: '100%',
+            cursor: 'text',
+            color: token.colorTextPlaceholder
+          },
+          children: resolveEmptyPlaceholder(fieldSchema)
+        });
+      }
+      // 登记了只读渲染器的组件(如带颜色的 Tag)按渲染器出内容,与组件自己的阅读态一致
+      var shown = renderer && text !== '' ? renderer(liveValue, ctx) : text;
+      return /*#__PURE__*/(0, _jsxRuntime.jsx)("span", {
+        className: "ag-array-table-lazy-text",
+        style: {
+          display: 'inline-block',
+          width: '100%',
+          cursor: 'text'
+        },
+        children: shown
+      });
+    }
+  });
+};
+
+/**
+ * 反应式只读文本渲染器(列级 readPretty 在「可编辑表」里的展示列)。
+ *
+ * 只读纯文本快路径(valueFormatter)经 AG-Grid 缓存 params.value 取值,setValuesIn 程序化原地改值
+ * 不会刷新该格 → 自动带出的外码/描述等只读展示列空白。本渲染器 Observer 读可观察 record[dataKey],
+ * 保持 readPretty 纯文本观感(不挂 Formily 树、不可点编辑),但能跟随 setValuesIn 即时刷新。
+ *
+ * 仅用于「可编辑表的列级 readPretty 展示列」;「整表 readPretty」(明细/详情页,数据经 setValues 整体
+ * 加载,行引用整体替换→AG-Grid 自然刷新)仍走更廉价的静态 valueFormatter 快路径。@author nokecy
+ */
+var LazyReadOnlyText = exports.LazyReadOnlyText = function LazyReadOnlyText(params) {
+  var _fieldSchema$name2;
+  var value = params.value,
+    record = params.data,
+    field = params.field,
+    node = params.node,
+    colDef = params.colDef,
+    formatter = params.formatter,
+    renderer = params.renderer,
+    columnProps = params.columnProps,
+    fieldSchema = params.fieldSchema;
+  var dataKey = (_fieldSchema$name2 = fieldSchema === null || fieldSchema === void 0 ? void 0 : fieldSchema.name) !== null && _fieldSchema$name2 !== void 0 ? _fieldSchema$name2 : colDef === null || colDef === void 0 ? void 0 : colDef.field;
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_formilyReact.Observer, {
+    children: function children() {
+      var currentRecord = resolveCellRow(field, record, node).record;
+      var liveValue = dataKey != null && currentRecord ? readByFieldPath(currentRecord, dataKey) : value;
+      var text = formatter ? formatter(liveValue, {
+        columnProps: columnProps,
+        fieldSchema: fieldSchema
+      }) : liveValue == null ? '' : String(liveValue);
+      var shown = renderer && text !== '' ? renderer(liveValue, {
+        columnProps: columnProps,
+        fieldSchema: fieldSchema
+      }) : text;
+      return /*#__PURE__*/(0, _jsxRuntime.jsx)("span", {
+        className: "ag-array-table-readonly-text",
+        style: {
+          display: 'inline-block',
+          width: '100%'
+        },
+        children: shown
+      });
+    }
+  });
+};
+
+// 在 Column 的子 schema 里递归找到内层数据字段(可读 x-component / x-pattern / x-reactions / enum) @author nokecy
+var findDataFieldSchema = exports.findDataFieldSchema = function findDataFieldSchema(columnSchema, name) {
+  if (!columnSchema || !columnSchema.properties) return null;
+  var matched = null;
+  var firstField = null;
+  var walk = function walk(s) {
+    if (!s || !s.properties) return;
+    s.reduceProperties(function (_, child) {
+      if (matched) return _;
+      var comp = child === null || child === void 0 ? void 0 : child['x-component'];
+      // 兜底:记录第一个带 x-component 的叶子字段(排除 Column/Operations/Addition 等包裹组件)
+      if (!firstField && typeof comp === 'string' && !/Column|Operations|Addition/.test(comp)) {
+        firstField = child;
+      }
+      if ((child === null || child === void 0 ? void 0 : child.name) === name) {
+        matched = child;
+        return _;
+      }
+      walk(child);
+      return _;
+    }, null);
+  };
+  walk(columnSchema);
+  return matched || firstField;
+};
+
+/**
+ * 判断某列是否可走「只读纯文本快路径」(不挂 Formily 树)。
+ *
+ * 安全不对称:误判「可编辑->只读」会丢编辑/校验/reaction 计算(灾难);
+ * 误判「只读->可编辑」只是没优化(无害)。所以仅在能证明永久只读时才放行,其余一律回退。
+ *
+ * @author nokecy
+ */
+var isColumnReadOnlyEligible = function isColumnReadOnlyEligible(arrayPattern, dataField, columnProps) {
+  if ((columnProps === null || columnProps === void 0 ? void 0 : columnProps.forceAgField) === true) return false;
+  // 有 x-reactions:可能运行时切 pattern 或计算字段值,静态判不准 -> 保守回退 AgField
+  if (dataField && dataField['x-reactions']) return false;
+  if (arrayPattern === 'readPretty') return true; // 整表只读(明细/详情页)
+  if (!dataField) return false;
+  if (dataField['x-pattern'] === 'readPretty') return true;
+  if (dataField['x-read-pretty'] === true) return true;
+  return false;
+};
+
+/**
+ * 静态解析 x-reactions 依赖里指向「同表其他列」的列名。
+ *
+ * 懒挂载/只读快路径的格子不创建 Formily 字段，而 reaction 的依赖是按字段节点取值的：
+ * 被依赖列没有字段，依赖读到 undefined，金额=数量×单价这类联动初始显示 0。
+ * 所以被依赖列必须创建字段（走 eager）。选「标记 eager」而不是「预建字段/改读 form values」的理由：
+ * 前者沿用 Formily 自己的求值与订阅路径（字段创建后依赖自动重算），不引入第二套取值逻辑；
+ * 代价只是依赖列失去懒挂载优化，而依赖列通常是少数几列。
+ *
+ * 只认能确定指向本表某一列的写法：相对路径 `.qty`（可带 `#value` 之类的属性后缀）、
+ * 带通配的绝对路径 `items.*.price`（前缀必须是本数组字段）。`..xx`、不带通配的绝对路径、
+ * 表达式串等解析不了的一律忽略，保持原有行为。@author nokecy
+ */
+var collectReactionDependencyColumns = function collectReactionDependencyColumns(arrayField, reactions) {
+  var _arrayField$path, _arrayField$path$toSt, _arrayField$address, _arrayField$address$t;
+  var names = [];
+  var arrayPaths = [arrayField === null || arrayField === void 0 || (_arrayField$path = arrayField.path) === null || _arrayField$path === void 0 || (_arrayField$path$toSt = _arrayField$path.toString) === null || _arrayField$path$toSt === void 0 ? void 0 : _arrayField$path$toSt.call(_arrayField$path), arrayField === null || arrayField === void 0 || (_arrayField$address = arrayField.address) === null || _arrayField$address === void 0 || (_arrayField$address$t = _arrayField$address.toString) === null || _arrayField$address$t === void 0 ? void 0 : _arrayField$address$t.call(_arrayField$address)].filter(Boolean);
+  var take = function take(dep) {
+    var source = typeof dep === 'string' ? dep : dep && _typeof(dep) === 'object' && typeof dep.source === 'string' ? dep.source : null;
+    if (!source || source.includes('{{')) return;
+    var path = source.split('#')[0].trim();
+    if (path.startsWith('..')) return;
+    if (path.startsWith('.')) {
+      var name = path.slice(1);
+      if (name && !name.includes('*') && isFastPathFieldName(name)) names.push(name);
+      return;
+    }
+    var matched = /^(.+)\.\*\.([^.*]+)$/.exec(path);
+    if (matched && arrayPaths.includes(matched[1])) names.push(matched[2]);
+  };
+  var visit = function visit(reaction) {
+    if (!reaction || _typeof(reaction) !== 'object') return;
+    var deps = reaction.dependencies;
+    if (Array.isArray(deps)) deps.forEach(take);else if (deps && _typeof(deps) === 'object') Object.values(deps).forEach(take);
+  };
+  (Array.isArray(reactions) ? reactions : [reactions]).forEach(visit);
+  return names;
+};
+
+/** 明细单元格里的数字输入组件(antd InputNumber 及其 Formily 封装) */
+var NUMBER_INPUT_COMPONENTS = new Set(['NumberPicker', 'InputNumber']);
+
+/**
+ * 明细单元格里的数字输入默认去掉上下步进:不显示上下按钮、不响应方向键步进。
+ *
+ * 上下按钮会压住右对齐数字的末尾;方向键步进则与单元格间的方向键导航冲突——
+ * 在数字格里按 ↑/↓,导航到别的格的同时,被离开的那格数值也被悄悄 +1/-1。
+ * 字段的 x-component-props 里显式写了 controls/keyboard 的以使用方为准。
+ * 只对会挂真控件的列调用(只读快路径没有输入框)。幂等。@author nokecy
+ */
+var applyNumberInputDefaults = function applyNumberInputDefaults(dataField) {
+  if (!dataField || !NUMBER_INPUT_COMPONENTS.has(dataField['x-component'])) return;
+  var props = dataField['x-component-props'];
+  if (props != null && _typeof(props) !== 'object') return; // 整个 props 写成了表达式串,不动
+  dataField['x-component-props'] = _objectSpread({
+    controls: false,
+    keyboard: false
+  }, props);
+};
+
+// 重命名自 useArrayTableColumns:内部无任何 Hook 调用,use 前缀违反 Hook 命名约定且曾在 useMemo 内被调用 @author nokecy
+var buildArrayTableColumns = exports.buildArrayTableColumns = function buildArrayTableColumns(dataSource, field, sources) {
+  var arrayPattern = field === null || field === void 0 ? void 0 : field.pattern;
+  // 被其他列 x-reactions 依赖的列：必须创建字段，见 collectReactionDependencyColumns。
+  var reactionDependencyColumns = new Set();
+  sources.forEach(function (_ref7) {
+    var _findDataFieldSchema;
+    var name = _ref7.name,
+      schema = _ref7.schema,
+      display = _ref7.display;
+    if (display && display !== 'visible') return;
+    if (!isColumnComponent(schema)) return;
+    var reactions = (_findDataFieldSchema = findDataFieldSchema(schema, name)) === null || _findDataFieldSchema === void 0 ? void 0 : _findDataFieldSchema['x-reactions'];
+    if (reactions) collectReactionDependencyColumns(field, reactions).forEach(function (dep) {
+      return reactionDependencyColumns.add(dep);
+    });
+  });
+  return sources.reduce(function (buf, _ref8, key) {
+    var _dataField$xDecorato, _ref9, _getReadOnlyFormatter, _dataField$xComponen, _parseObjectDestructu, _dataField$xComponen2, _dataField$xComponen3, _dataField$xComponen4, _dataField$xComponen5;
+    var name = _ref8.name,
+      columnProps = _ref8.columnProps,
+      schema = _ref8.schema,
+      display = _ref8.display,
+      components = _ref8.components;
+    if (display && display !== 'visible') return buf;
+    if (!isColumnComponent(schema)) return buf;
+
+    // 【关键修复】移除可能干扰用户列状态的属性
+    // 这些属性应该由用户通过列配置（applyColumnState）控制，而不是从 columnDefs 继承
+    // 但保留 width 作为列的初始宽度
+    // 注意：pinned 不再剥离——作为 schema 默认固定列状态生效；用户运行时拖动/保存方案后
+    //       由 applyColumnState 在其后覆盖(用户优先),stableColumnDefs 会话内稳定不重置,故不冲突。@author nokecy
+    var hide = columnProps.hide,
+      sort = columnProps.sort,
+      sortIndex = columnProps.sortIndex,
+      forceAgField = columnProps.forceAgField,
+      headerGroup = columnProps.headerGroup,
+      defaultHide = columnProps.defaultHide,
+      fixed = columnProps.fixed,
+      requiredMark = columnProps.requiredMark,
+      align = columnProps.align,
+      safeColumnProps = _objectWithoutProperties(columnProps, _excluded);
+    // fixed -> pinned 别名:true 等同 'left'(与 antd Table 一致);同时写了 pinned(含显式 null)时 pinned 优先。@author nokecy
+    var pinnedFromFixed = fixed === true ? 'left' : fixed === 'left' || fixed === 'right' ? fixed : undefined;
+    var base = (0, _columnAlign.withColumnAlign)(_objectSpread(_objectSpread(_objectSpread({}, safeColumnProps), safeColumnProps.pinned === undefined && pinnedFromFixed ? {
+      pinned: pinnedFromFixed
+    } : {}), {}, {
+      // 保留 width 作为列的初始宽度
+      width: columnProps.width,
+      //@ts-ignore
+      headerName: columnProps.headerName || columnProps.title,
+      field: name
+    }, defaultHide === true ? {
+      initialHide: true
+    } : {}), align);
+
+    // ArrayTable.SortHandle 列:不挂 Formily 树,直接成为 AG-Grid 的行拖拽手柄列(落点逻辑见 hooks 的 useRowDrag)。
+    // 阅读态/整表只读没有换行能力,只留空列不出手柄。@author nokecy
+    if (containsSortHandle(schema)) {
+      var draggable = arrayPattern === 'editable';
+      return buf.concat((0, _columnGroup.markHeaderGroup)((0, _fixedGuard.markFixedDerived)(_objectSpread(_objectSpread({}, base), {}, {
+        rowDrag: draggable,
+        sortable: false,
+        filter: false,
+        editable: false,
+        valueGetter: function valueGetter() {
+          return '';
+        }
+      }), safeColumnProps.pinned === undefined ? pinnedFromFixed : undefined), headerGroup));
+    }
+
+    // 记下分组名再输出列定义;真正合并成列组在 index.tsx 交给 AG-Grid 之前(groupColumnDefs)做,
+    // 这里产出的仍是扁平列定义。@author nokecy
+    // 由 fixed 别名推导出的固定列记下来,宽度保护(fixedGuard.ts)只会动这些列。@author nokecy
+    var derivedPinned = safeColumnProps.pinned === undefined ? pinnedFromFixed : undefined;
+    var isSequenceColumn = (0, _indexColumn.containsIndexComponent)(schema);
+    var dataField = findDataFieldSchema(schema, name);
+    // 单元格不重复显示 FormItem 标签，字段说明统一由列头提示承载。@author nokecy
+    var fieldTooltip = dataField === null || dataField === void 0 || (_dataField$xDecorato = dataField['x-decorator-props']) === null || _dataField$xDecorato === void 0 ? void 0 : _dataField$xDecorato.tooltip;
+    if (!base.headerTooltip && typeof fieldTooltip === 'string' && !fieldTooltip.includes('{{')) base.headerTooltip = fieldTooltip;
+    var readOnly = isColumnReadOnlyEligible(arrayPattern, dataField, columnProps);
+    var emit = function emit(colDef) {
+      return buf.concat((0, _columnGroup.markHeaderGroup)((0, _fixedGuard.markFixedDerived)(isSequenceColumn ? (0, _gridSequence.withDisplaySequencePolicy)(colDef) : (0, _requiredHeader.withRequiredColumnHeader)(colDef, (0, _requiredHeader.isRequiredColumn)(dataField, requiredMark), readOnly), derivedPinned), isSequenceColumn ? undefined : headerGroup));
+    };
+
+    // 三分流渲染策略:@author nokecy
+    //   ① 只读纯文本(永不可编辑):只读列 + 有格式化器 -> valueFormatter,不挂 Formily 树。
+    //   ② 可编辑懒挂载:可编辑列 + 有格式化器 + 无 reactions + 未强制 eager -> LazyAgField,
+    //      格子先出廉价文本、点击/导航(或必填且为空)才挂全树,焦点离开且校验通过再卸回文本。
+    //   ③ 兜底全树:其余(无格式化器/带 reactions/forceAgField/复杂字段名/只读但无格式化器) -> AgField。
+    var component = dataField === null || dataField === void 0 ? void 0 : dataField['x-component'];
+    // 未声明显示规则的业务组件必须挂载：单位选择器等会读取同行名称或异步加载候选，
+    // 仅把标量码交给 fallback 会跳过这些逻辑。解构值自带名称、显式编码展示及已登记格式化器仍走快路径。
+    // 登记渲染器的组件只读列也可用兜底格式化器判空。@author nokecy
+    var renderer = (0, _readOnlyFormatters.getReadOnlyRenderer)(component);
+    var formatter = (_ref9 = (_getReadOnlyFormatter = (0, _readOnlyFormatters.getReadOnlyFormatter)(component, components)) !== null && _getReadOnlyFormatter !== void 0 ? _getReadOnlyFormatter : (dataField === null || dataField === void 0 || (_dataField$xComponen = dataField['x-component-props']) === null || _dataField$xComponen === void 0 ? void 0 : _dataField$xComponen.displayField) === 'value' ? _readOnlyFormatters.fallbackFormatter : null) !== null && _ref9 !== void 0 ? _ref9 : (!readOnly || renderer) && (renderer || (_parseObjectDestructu = parseObjectDestructure(dataField === null || dataField === void 0 ? void 0 : dataField.name)) !== null && _parseObjectDestructu !== void 0 && _parseObjectDestructu.some(function (_ref10) {
+      var _ref11 = _slicedToArray(_ref10, 1),
+        key = _ref11[0];
+      return key === 'label';
+    })) && component && (dataField === null || dataField === void 0 ? void 0 : dataField.type) !== 'void' ? _readOnlyFormatters.fallbackFormatter : null;
+    var displayColumnProps = formatter && ((0, _readOnlyFormatters.getReadOnlyFormatter)(component, components) !== (0, _readOnlyFormatters.getReadOnlyFormatter)(component) || (dataField === null || dataField === void 0 || (_dataField$xComponen2 = dataField['x-component-props']) === null || _dataField$xComponen2 === void 0 ? void 0 : _dataField$xComponen2.displayField) === 'value') ? {
+      valueFormatter: function valueFormatter(params) {
+        return formatter(params.value, {
+          columnProps: columnProps,
+          fieldSchema: dataField
+        });
+      }
+    } : {};
+    var hasReactions = !!(dataField && dataField['x-reactions']);
+    if (!readOnly) applyNumberInputDefaults(dataField);
+    // 表达式或运行时选项必须创建字段才能求值/加载，不能在没有名称表时直接显示码值。@author nokecy
+    var hasOptionExpression = [dataField === null || dataField === void 0 ? void 0 : dataField.enum, dataField === null || dataField === void 0 || (_dataField$xComponen3 = dataField['x-component-props']) === null || _dataField$xComponen3 === void 0 ? void 0 : _dataField$xComponen3.options, dataField === null || dataField === void 0 || (_dataField$xComponen4 = dataField['x-component-props']) === null || _dataField$xComponen4 === void 0 ? void 0 : _dataField$xComponen4.dataSource, columnProps === null || columnProps === void 0 ? void 0 : columnProps.options, columnProps === null || columnProps === void 0 ? void 0 : columnProps.dataSource].some(function (options) {
+      return typeof options === 'string' && options.includes('{{');
+    });
+    // 可编辑格由 LazyAgField 按当前 scope 编译格式化表达式；静态只读路径仍交给真实字段。@author nokecy
+    var schemaFormatter = dataField === null || dataField === void 0 || (_dataField$xComponen5 = dataField['x-component-props']) === null || _dataField$xComponen5 === void 0 ? void 0 : _dataField$xComponen5.formatter;
+    var hasFormatterExpression = typeof schemaFormatter === 'string' && schemaFormatter.includes('{{');
+    var isReactionDependency = reactionDependencyColumns.has(name) || !!(dataField !== null && dataField !== void 0 && dataField.name) && reactionDependencyColumns.has(dataField.name);
+    var forceEager = (columnProps === null || columnProps === void 0 ? void 0 : columnProps.forceAgField) === true || isReactionDependency || formatter === (0, _readOnlyFormatters.getReadOnlyFormatter)('Select') && hasOptionExpression || readOnly && hasFormatterExpression;
+    // 平时就是真控件的格（必填/带校验规则、带联动、强制 eager）缺省不带 placeholder 时整格空白，与懒挂载格的「请输入/请选择」不一致；
+    // 补上同一句。只补单值的 antd 输入类组件（范围选择的 placeholder 是数组，不碰）。@author nokecy
+    var editorProps = dataField === null || dataField === void 0 ? void 0 : dataField['x-component-props'];
+    if (!readOnly && dataField && (isRequiredSchema(dataField) || hasValidatorRule(dataField) || hasReactions || forceEager) && (0, _cellEditorMarker.resolveCellEditorKind)(dataField['x-component']) && !String(dataField['x-component']).includes('RangePicker') && (editorProps == null || _typeof(editorProps) === 'object' && editorProps.placeholder == null)) {
+      dataField['x-component-props'] = _objectSpread(_objectSpread({}, editorProps !== null && editorProps !== void 0 ? editorProps : {}), {}, {
+        placeholder: resolveEmptyPlaceholder(dataField)
+      });
+    }
+    // Switch/Checkbox 是「单击直控」组件:可编辑态本就该常驻渲染真控件(优化前即如此)。
+    // 懒挂载会把它降成「是/否」纯文本(点击才挂出开关),用户会以为开关消失。故可编辑态强制 eager。
+    // 只读态(下方 ① 路径)仍走「是/否」文本快路径不受影响。@author nokecy
+    var isInlineToggle = component === 'Switch' || component === 'Checkbox';
+    // ArrayTableIndex 靠「挂载时 useEffect 调 onChange(index+1)」把行号写进数据字段(如工艺路线的 sort)。
+    // 懒挂载只出文本、不挂真组件,effect 永远不执行,新增行的行号字段就是空的,故强制 eager。@author nokecy
+    var isIndexWriter = component === 'ArrayTableIndex';
+
+    // formatter 路径(只读快路径/懒挂载)经 AG-Grid params.value 取值,而 params.value 由 colDef.field(=name)驱动。
+    // 但设计器生成的 schema 里 Column key 多为随机 designable-id 且无 dataIndex,真实数据键在内层字段 name 上,
+    // 两者不一致时 record[name] 恒为 undefined → 单元格空白(点击挂 AgField 才按内层字段名显真值)。
+    // 故按内层字段名补 valueGetter(仅在与 name 不一致时,保持 name===字段名 的现状)。@author nokecy
+    var dataFieldName = dataField === null || dataField === void 0 ? void 0 : dataField.name;
+    var valueGetter = !columnProps.valueGetter && dataFieldName && dataFieldName !== name ? function (params) {
+      return readByFieldPath(params === null || params === void 0 ? void 0 : params.data, dataFieldName);
+    } : undefined;
+    // 选择器解构值仍交给渲染器；排序单独提取展示字段，不能把整对象当成相等的文本。@author nokecy
+    if ((!dataField || dataField.type === 'void') && !columnProps.valueGetter && columnProps.sortable == null) base.sortable = false;else if (dataField && !base.comparator) base.comparator = (0, _sorting.createArrayTableComparator)(dataField, columnProps, formatter);
+    // 字段名是路径:`item.qty` 的值在 record.item.qty。快路径自己解析点号分段与对象解构(`{value:a,label:b}`);
+    // 数组解构/下标等其余语法解析不了,回退全树交给 Formily。@author nokecy
+    var canFastPath = !dataFieldName || isFastPathFieldName(dataFieldName);
+
+    // ① 只读纯文本
+    if (readOnly && formatter && canFastPath && !forceEager) {
+      // 列级 readPretty 在「可编辑表」里是展示列(值可能被 setValuesIn 自动带出),静态 valueFormatter
+      // 读 AG-Grid 缓存值不刷新 → 反应式只读渲染。整表 readPretty(明细/详情页,数据 setValues 整体加载、
+      // 行引用整体替换、AG-Grid 自然刷新)仍走更廉价的静态 valueFormatter 快路径。@author nokecy
+      if (arrayPattern !== 'readPretty') {
+        return emit(_objectSpread(_objectSpread(_objectSpread({}, base), valueGetter ? {
+          valueGetter: valueGetter
+        } : {}), {}, {
+          cellRenderer: LazyReadOnlyText,
+          cellRendererParams: {
+            field: field,
+            formatter: formatter,
+            renderer: renderer,
+            columnProps: columnProps,
+            fieldSchema: dataField
+          }
+        }));
+      }
+      if (renderer) {
+        // 登记了渲染器:整表阅读态也出渲染器内容(如 Tag),不退化成纯文字
+        return emit(_objectSpread(_objectSpread(_objectSpread({}, base), valueGetter ? {
+          valueGetter: valueGetter
+        } : {}), {}, {
+          cellRenderer: function cellRenderer(params) {
+            var ctx = {
+              columnProps: columnProps,
+              fieldSchema: dataField
+            };
+            return formatter(params.value, ctx) === '' ? '' : renderer(params.value, ctx);
+          },
+          valueFormatter: function valueFormatter(params) {
+            return formatter(params.value, {
+              columnProps: columnProps,
+              fieldSchema: dataField
+            });
+          }
+        }));
+      }
+      return emit(_objectSpread(_objectSpread(_objectSpread({}, base), valueGetter ? {
+        valueGetter: valueGetter
+      } : {}), {}, {
+        // 显式清掉可能从 safeColumnProps 漏带的 cellRenderer(AG-Grid 中 renderer 优先级高于 formatter)
+        cellRenderer: undefined,
+        valueFormatter: function valueFormatter(params) {
+          return formatter(params.value, {
+            columnProps: columnProps,
+            fieldSchema: dataField
+          });
+        }
+      }));
+    }
+
+    // ② 可编辑懒挂载(排除单击直控的 Switch/Checkbox:须 eager 出真控件)
+    if (!readOnly && formatter && !hasReactions && !forceEager && !isInlineToggle && !isIndexWriter && canFastPath) {
+      return emit(_objectSpread(_objectSpread(_objectSpread({}, base), valueGetter ? {
+        valueGetter: valueGetter
+      } : {}), {}, {
+        cellRenderer: LazyAgField,
+        cellRendererParams: {
+          dataSource: dataSource,
+          schema: schema,
+          field: field,
+          formatter: formatter,
+          renderer: renderer,
+          columnProps: columnProps,
+          fieldSchema: dataField,
+          lazyEditable: true,
+          // 供 index.tsx 识别懒列(激活/导航用)
+          // 必填、或带校验规则且为空的格必须挂真控件，否则没有字段节点，提交时没人校验它，见 LazyAgField
+          required: isRequiredSchema(dataField) || hasValidatorRule(dataField)
+        }
+      }, displayColumnProps));
+    }
+
+    // ③ 兜底全树
+    return emit(_objectSpread(_objectSpread(_objectSpread(_objectSpread({}, base), valueGetter ? {
+      valueGetter: valueGetter
+    } : {}), displayColumnProps), {}, {
+      cellRendererParams: {
+        dataSource: dataSource,
+        schema: schema,
+        field: field,
+        editorComponent: component
+      },
+      cellRenderer: AgField
+    }));
+  }, []);
+};
+
+/**
+ * 找到 schema 里的 ArrayTable.Addition 占位节点,返回它的 x-component-props(新增按钮的 title / defaultValue / onAdd 等)。
+ *
+ * Addition 节点本身不渲染(表格在工具栏画自己的新增按钮),所以不能从渲染出的元素上取 props——
+ * 直接读节点 schema 的 x-component-props,并按当前表达式作用域求一次 `{{...}}` 表达式。
+ * 没有 Addition 节点返回 null。@author nokecy
+ */
+var useAddition = exports.useAddition = function useAddition() {
+  var schema = (0, _formilyReact.useFieldSchema)();
+  var scope = (0, _formilyReact.useExpressionScope)();
+  return schema.reduceProperties(function (addition, childSchema, key) {
+    if (addition) return addition;
+    if (!isAdditionComponent(childSchema)) return addition;
+    var raw = childSchema['x-component-props'];
+    var props = raw && _typeof(raw) === 'object' ? _formilyJsonSchema.Schema.shallowCompile(_objectSpread({}, raw), scope !== null && scope !== void 0 ? scope : {}) : {};
+    return {
+      name: String(key),
+      schema: childSchema,
+      props: props
+    };
+  }, null);
+};
+/** 简单字段名（非路径、非解构），默认值回填只处理这一种 */
+var SIMPLE_FIELD_NAME = /^[A-Za-z_$][\w$]*$/;
+/**
+ * 收集懒挂载列上声明了 default 的字段。
+ *
+ * Formily 在字段创建时把 schema 的 default 写进值（值为空时）。懒挂载的格子不创建字段，
+ * 老记录里缺的列、代码直接 push 的行就拿不到默认值，保存时是 null。
+ * 表达式形态的默认值（{{...}}）要求值上下文，这里不处理。@author nokecy
+ */
+var collectLazyDefaults = exports.collectLazyDefaults = function collectLazyDefaults(columns) {
+  return (columns !== null && columns !== void 0 ? columns : []).filter(function (col) {
+    var _col$cellRendererPara;
+    return col === null || col === void 0 || (_col$cellRendererPara = col.cellRendererParams) === null || _col$cellRendererPara === void 0 ? void 0 : _col$cellRendererPara.lazyEditable;
+  }).map(function (col) {
+    var _fieldSchema$name3;
+    var fieldSchema = col.cellRendererParams.fieldSchema;
+    return {
+      key: String((_fieldSchema$name3 = fieldSchema === null || fieldSchema === void 0 ? void 0 : fieldSchema.name) !== null && _fieldSchema$name3 !== void 0 ? _fieldSchema$name3 : col.field),
+      value: fieldSchema === null || fieldSchema === void 0 ? void 0 : fieldSchema.default
+    };
+  }).filter(function (_ref12) {
+    var key = _ref12.key,
+      value = _ref12.value;
+    return SIMPLE_FIELD_NAME.test(key) && value !== undefined && value !== null && !(typeof value === 'string' && value.includes('{{'));
+  });
+};
+
+/**
+ * 给还没处理过的新增行补默认值：值为空（null/undefined）才写，每行只补一次——
+ * 用户之后把格子清空是有意的，不能再被填回去。已落库的行（带 id）不动。@author nokecy
+ */
+var applyLazyDefaults = exports.applyLazyDefaults = function applyLazyDefaults(arrayField, defaults, handled) {
+  var rows = arrayField === null || arrayField === void 0 ? void 0 : arrayField.value;
+  var form = arrayField === null || arrayField === void 0 ? void 0 : arrayField.form;
+  if (!Array.isArray(rows) || !form || defaults.length === 0) return;
+  rows.forEach(function (row, index) {
+    if (row == null || _typeof(row) !== 'object' || handled.has(row)) return;
+    handled.add(row);
+    // 已落库的行（带 id）保持库里的样子：补默认值会让受控字段凭空出现「变更」，
+    // 已审批的数据保存时还会被要求填变更原因。只补新增行（按钮之外的途径推进来的行）。
+    if (row.id != null || row._id != null) return;
+    defaults.forEach(function (_ref13) {
+      var key = _ref13.key,
+        value = _ref13.value;
+      if (row[key] == null) {
+        form.setValuesIn(arrayField.path.concat(index).concat(key), _typeof(value) === 'object' ? JSON.parse(JSON.stringify(value)) : value);
+      }
+    });
+  });
+};