@nokecy/qc-ui 1.1.45 → 1.1.47

package/dist/cjs/ag-grid-plus/ag-gridPlus.js

@@ -10,6 +10,7 @@ var _antd = require("antd");
 var _react = _interopRequireWildcard(require("react"));
 var _agGridEnterprise = require("ag-grid-enterprise");
 var _theme = require("./theme");
+var _useTypeInferenceRow = require("./hooks/useTypeInferenceRow");
 require("./index.less");
 var _queryForm = _interopRequireDefault(require("./queryForm"));
 var _toolBar = _interopRequireDefault(require("./toolBar"));
@@ -315,16 +316,8 @@ function AgGridPlus(props) {
     };
   }, []);
 
-  // 【修复】缓存第一次数据用于类型推断,避免 rowData 更新时重新计算 colDefs
-  // 原因: getTableColumns 只需要第一行数据来推断列的数据类型(数字列自动求和)
-  //      类型推断应该只在初始化时进行一次,后续数据更新不应改变列定义
-  var firstRowDataRef = (0, _react.useRef)(null);
-  (0, _react.useEffect)(function () {
-    // 只在首次有数据时保存
-    if (!firstRowDataRef.current && rowData.length > 0) {
-      firstRowDataRef.current = rowData[0];
-    }
-  }, [rowData]);
+  // 用于列类型推断的首行数据。为什么必须是 state 而不是 ref,见该 hook 的注释。@author nokecy
+  var typeInferenceRow = (0, _useTypeInferenceRow.useTypeInferenceRow)(rowData);
 
   /**
    * 【P0 + P1 优化】使用派生状态应用方案（单向数据流）
@@ -625,7 +618,7 @@ function AgGridPlus(props) {
   // 计算所有列定义(包括隐藏的列)
   // 【修复】移除 rowData 依赖,使用缓存的首行数据进行类型推断
   var allColDefs = (0, _react.useMemo)(function () {
-    var dataForTypeInference = firstRowDataRef.current || (rowData.length > 0 ? rowData[0] : {});
+    var dataForTypeInference = typeInferenceRow || (rowData.length > 0 ? rowData[0] : {});
     var cols = getTableColumns([dataForTypeInference]);
     allColDefsRef.current = cols; // 同步更新 ref
 
@@ -645,7 +638,7 @@ function AgGridPlus(props) {
       });
     }
     return cols;
-  }, [_react.default.Children.count(children), props.columnDefs, extensibleColumns, gridKey, entityType, hostEntityExtensions]);
+  }, [_react.default.Children.count(children), props.columnDefs, extensibleColumns, gridKey, entityType, hostEntityExtensions, typeInferenceRow]);
 
   // 稳定化 gridParams 和 sortColumn 的引用(深比较,内容不变即复用旧引用)
   var stableGridParams = useDeepCompareStable(gridParams);
@@ -1052,7 +1045,7 @@ function AgGridPlus(props) {
     // 【默认逻辑】没有方案配置时，使用原有的列定义生成逻辑
     // 使用缓存的首行数据进行类型推断,而不是当前的 rowData
     // 这样 rowData 更新时不会触发 colDefs 重新计算
-    var dataForTypeInference = firstRowDataRef.current || (rowData.length > 0 ? rowData[0] : {});
+    var dataForTypeInference = typeInferenceRow || (rowData.length > 0 ? rowData[0] : {});
     var columnDefs = getTableColumns([dataForTypeInference]);
 
     // 递归应用 columnCellClass 配置
@@ -1090,7 +1083,9 @@ function AgGridPlus(props) {
   // 【关键】优先依赖派生状态
   derivedColumnDefs, _react.default.Children.count(children), props.columnDefs, extensibleColumns, columnCellClass,
   // ref.current 变更不触发重渲染,作依赖无效;改依赖真正的数据源 allColDefs(memo 值) @author nokecy
-  allColDefs]);
+  allColDefs,
+  // 首批数据到达时重算一次,否则数值列的右对齐永远推断不出来 @author nokecy
+  typeInferenceRow]);
 
   // 构建查询表单项（带 order 属性）
   var queryFormItems = (0, _react.useMemo)(function () {

package/dist/cjs/ag-grid-plus/hooks/useTypeInferenceRow.d.ts

@@ -0,0 +1,18 @@
+/**
+ * 挑出用于列类型推断的那一行数据。
+ *
+ * 列的数据类型（数值列自动求和并右对齐）是靠首行数据的字段类型推断出来的，
+ * 而这个推断**只该做一次**：之后的数据更新不应该改变列定义，否则翻页、筛选都会重排列。
+ *
+ * 必须返回 state 而不是 ref。这里踩过一次：
+ * 原本用 `useRef` 缓存首行，而消费它的 `useMemo` 依赖数组里又没有 rowData，
+ * 于是异步加载的表格首次渲染时 rowData 为空 → 推断不出类型 → 数据到达后写进 ref
+ * 却不触发重渲染 → 列定义永久停留在「无类型」。表现是数值列该右对齐却一直左对齐，
+ * 不报错、不崩溃，只能靠盯着某一列发现。
+ *
+ * 用 state 就同时满足两件事：首批数据到达时触发一次重算，之后不再变。
+ *
+ * @author nokecy
+ */
+export declare function useTypeInferenceRow(rowData: any[] | undefined | null): any;
+export default useTypeInferenceRow;

package/dist/cjs/ag-grid-plus/hooks/useTypeInferenceRow.js

@@ -0,0 +1,43 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+exports.useTypeInferenceRow = useTypeInferenceRow;
+var _react = require("react");
+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; }
+/**
+ * 挑出用于列类型推断的那一行数据。
+ *
+ * 列的数据类型（数值列自动求和并右对齐）是靠首行数据的字段类型推断出来的，
+ * 而这个推断**只该做一次**：之后的数据更新不应该改变列定义，否则翻页、筛选都会重排列。
+ *
+ * 必须返回 state 而不是 ref。这里踩过一次：
+ * 原本用 `useRef` 缓存首行，而消费它的 `useMemo` 依赖数组里又没有 rowData，
+ * 于是异步加载的表格首次渲染时 rowData 为空 → 推断不出类型 → 数据到达后写进 ref
+ * 却不触发重渲染 → 列定义永久停留在「无类型」。表现是数值列该右对齐却一直左对齐，
+ * 不报错、不崩溃，只能靠盯着某一列发现。
+ *
+ * 用 state 就同时满足两件事：首批数据到达时触发一次重算，之后不再变。
+ *
+ * @author nokecy
+ */
+function useTypeInferenceRow(rowData) {
+  var _useState = (0, _react.useState)(null),
+    _useState2 = _slicedToArray(_useState, 2),
+    row = _useState2[0],
+    setRow = _useState2[1];
+  (0, _react.useEffect)(function () {
+    if (!row && rowData && rowData.length > 0) {
+      setRow(rowData[0]);
+    }
+  }, [rowData, row]);
+  return row;
+}
+var _default = exports.default = useTypeInferenceRow;

package/dist/cjs/ag-grid-plus/utils/emptyState.js

@@ -24,7 +24,9 @@ function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" ==
 /** 四支文案，按支覆盖。不传的支走默认。 */
 
 var DEFAULT_EMPTY_TEXTS = exports.DEFAULT_EMPTY_TEXTS = {
-  error: '数据加载失败，请点上方「重试」',
+  // 不写方位：重试按钮就渲染在这句话正下方（见 shared/NoRowsOverlay）。
+  // 原文写的是「请点上方「重试」」，方位指错了。@author nokecy
+  error: '数据加载失败，可点下方按钮重试',
   noPermission: '没有查看该数据的权限，请联系系统管理员',
   noResult: '没有符合当前筛选条件的数据，试试放宽或清空筛选条件',
   noData: '暂无数据'

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

@@ -141,6 +141,34 @@ var AgField = function AgField(_ref) {
   return children;
 };
 
+/**
+ * 快路径能否按这个字段名取到值。
+ *
+ * Formily 的字段名是「路径」不是「键」,支持点号嵌套(`item.qty`)、数组下标(`a[0]`)、
+ * 解构(`{value:code,label:name}`)等语法。快路径(只读文本/懒挂载)不挂 Formily 树,
+ * 取值得自己解析。这里只认「点号分段」这一种简单形态,其余一律判不合格 ->
+ * 调用方回退 AgField 全树(由 Formily 自己解析,正确优先于速度)。@author nokecy
+ */
+var isSimpleFieldPath = function isSimpleFieldPath(name) {
+  return !!name && /^[^.{}[\]*]+(\.[^.{}[\]*]+)*$/.test(name);
+};
+
+/**
+ * 按 Formily 字段名从行数据取值。
+ *
+ * 曾经一律按扁平键取 record['item.qty'],而数据在 record.item.qty ->
+ * 嵌套字段名恒 undefined,单元格默认空白,点击挂上全树(按路径解析)才显出真值。
+ *
+ * 在 Observer 里逐层读可观察对象,依赖链完整,程序化改值(setValuesIn)照样刷新。@author nokecy
+ */
+var readByFieldPath = function readByFieldPath(record, path) {
+  if (record == null) return undefined;
+  if (path.indexOf('.') < 0) return record[path];
+  return path.split('.').reduce(function (acc, key) {
+    return acc == null ? undefined : acc[key];
+  }, record);
+};
+
 /**
  * 懒挂载单元格渲染器(可编辑列)。
  *
@@ -187,7 +215,7 @@ var LazyAgField = exports.LazyAgField = function LazyAgField(params) {
   // 免去调用方加 forceAgField 逃生阀。字段名缺失才回退 params.value。@author nokecy
   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;
   return /*#__PURE__*/_react.default.createElement(_react2.Observer, null, function () {
-    var liveValue = dataKey != null && record ? record[dataKey] : value;
+    var liveValue = dataKey != null && record ? readByFieldPath(record, dataKey) : value;
     var text = formatter ? formatter(liveValue, {
       columnProps: columnProps,
       fieldSchema: fieldSchema
@@ -224,7 +252,7 @@ var LazyReadOnlyText = exports.LazyReadOnlyText = function LazyReadOnlyText(para
     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__*/_react.default.createElement(_react2.Observer, null, function () {
-    var liveValue = dataKey != null && record ? record[dataKey] : value;
+    var liveValue = dataKey != null && record ? readByFieldPath(record, dataKey) : value;
     var text = formatter ? formatter(liveValue, {
       columnProps: columnProps,
       fieldSchema: fieldSchema
@@ -317,7 +345,7 @@ var buildArrayTableColumns = exports.buildArrayTableColumns = function buildArra
     //   ① 只读纯文本(永不可编辑):只读列 + 有格式化器 -> valueFormatter,不挂 Formily 树。
     //   ② 可编辑懒挂载:可编辑列 + 有格式化器 + 无 reactions + 未强制 eager -> LazyAgField,
     //      存量格先出廉价文本、点击/导航才挂全树(挂了不卸)。
-    //   ③ 兜底全树:其余(无格式化器/带 reactions/forceAgField/只读但无格式化器) -> AgField。
+    //   ③ 兜底全树:其余(无格式化器/带 reactions/forceAgField/复杂字段名/只读但无格式化器) -> AgField。
     var dataField = findDataFieldSchema(schema, name);
     var component = dataField === null || dataField === void 0 ? void 0 : dataField['x-component'];
     var formatter = (0, _readOnlyFormatters.getReadOnlyFormatter)(component);
@@ -335,12 +363,14 @@ var buildArrayTableColumns = exports.buildArrayTableColumns = function buildArra
     // 故按内层字段名补 valueGetter(仅在与 name 不一致时,保持 name===字段名 的现状)。@author nokecy
     var dataFieldName = dataField === null || dataField === void 0 ? void 0 : dataField.name;
     var valueGetter = dataFieldName && dataFieldName !== name ? function (params) {
-      var _params$data;
-      return params === null || params === void 0 || (_params$data = params.data) === null || _params$data === void 0 ? void 0 : _params$data[dataFieldName];
+      return readByFieldPath(params === null || params === void 0 ? void 0 : params.data, dataFieldName);
     } : undefined;
+    // 字段名是路径:`item.qty` 的值在 record.item.qty。快路径自己解析,只认点号分段;
+    // 解构(`{value:a,label:b}`)/数组下标等复杂语法解析不了,回退全树交给 Formily。@author nokecy
+    var canFastPath = !dataFieldName || isSimpleFieldPath(dataFieldName);
 
     // ① 只读纯文本
-    if (readOnly && formatter) {
+    if (readOnly && formatter && canFastPath) {
       // 列级 readPretty 在「可编辑表」里是展示列(值可能被 setValuesIn 自动带出),静态 valueFormatter
       // 读 AG-Grid 缓存值不刷新 → 反应式只读渲染。整表 readPretty(明细/详情页,数据 setValues 整体加载、
       // 行引用整体替换、AG-Grid 自然刷新)仍走更廉价的静态 valueFormatter 快路径。@author nokecy
@@ -371,7 +401,7 @@ var buildArrayTableColumns = exports.buildArrayTableColumns = function buildArra
     }
 
     // ② 可编辑懒挂载(排除单击直控的 Switch/Checkbox:须 eager 出真控件)
-    if (!readOnly && formatter && !hasReactions && !forceEager && !isInlineToggle) {
+    if (!readOnly && formatter && !hasReactions && !forceEager && !isInlineToggle && canFastPath) {
       return buf.concat(_objectSpread(_objectSpread(_objectSpread({}, base), valueGetter ? {
         valueGetter: valueGetter
       } : {}), {}, {

package/dist/esm/ag-grid-plus/ag-gridPlus.js

@@ -29,6 +29,7 @@ ModuleRegistry.registerModules([AllEnterpriseModule]);
 
 // 导入 AG-Grid v33 主题
 import { agGridTheme } from "./theme";
+import { useTypeInferenceRow } from "./hooks/useTypeInferenceRow";
 import "./index.less";
 import FormRender from "./queryForm";
 import ToolBar from "./toolBar";
@@ -307,16 +308,8 @@ function AgGridPlus(props) {
     };
   }, []);
 
-  // 【修复】缓存第一次数据用于类型推断,避免 rowData 更新时重新计算 colDefs
-  // 原因: getTableColumns 只需要第一行数据来推断列的数据类型(数字列自动求和)
-  //      类型推断应该只在初始化时进行一次,后续数据更新不应改变列定义
-  var firstRowDataRef = useRef(null);
-  useEffect(function () {
-    // 只在首次有数据时保存
-    if (!firstRowDataRef.current && rowData.length > 0) {
-      firstRowDataRef.current = rowData[0];
-    }
-  }, [rowData]);
+  // 用于列类型推断的首行数据。为什么必须是 state 而不是 ref,见该 hook 的注释。@author nokecy
+  var typeInferenceRow = useTypeInferenceRow(rowData);
 
   /**
    * 【P0 + P1 优化】使用派生状态应用方案（单向数据流）
@@ -617,7 +610,7 @@ function AgGridPlus(props) {
   // 计算所有列定义(包括隐藏的列)
   // 【修复】移除 rowData 依赖,使用缓存的首行数据进行类型推断
   var allColDefs = useMemo(function () {
-    var dataForTypeInference = firstRowDataRef.current || (rowData.length > 0 ? rowData[0] : {});
+    var dataForTypeInference = typeInferenceRow || (rowData.length > 0 ? rowData[0] : {});
     var cols = getTableColumns([dataForTypeInference]);
     allColDefsRef.current = cols; // 同步更新 ref
 
@@ -637,7 +630,7 @@ function AgGridPlus(props) {
       });
     }
     return cols;
-  }, [React.Children.count(children), props.columnDefs, extensibleColumns, gridKey, entityType, hostEntityExtensions]);
+  }, [React.Children.count(children), props.columnDefs, extensibleColumns, gridKey, entityType, hostEntityExtensions, typeInferenceRow]);
 
   // 稳定化 gridParams 和 sortColumn 的引用(深比较,内容不变即复用旧引用)
   var stableGridParams = useDeepCompareStable(gridParams);
@@ -1044,7 +1037,7 @@ function AgGridPlus(props) {
     // 【默认逻辑】没有方案配置时，使用原有的列定义生成逻辑
     // 使用缓存的首行数据进行类型推断,而不是当前的 rowData
     // 这样 rowData 更新时不会触发 colDefs 重新计算
-    var dataForTypeInference = firstRowDataRef.current || (rowData.length > 0 ? rowData[0] : {});
+    var dataForTypeInference = typeInferenceRow || (rowData.length > 0 ? rowData[0] : {});
     var columnDefs = getTableColumns([dataForTypeInference]);
 
     // 递归应用 columnCellClass 配置
@@ -1082,7 +1075,9 @@ function AgGridPlus(props) {
   // 【关键】优先依赖派生状态
   derivedColumnDefs, React.Children.count(children), props.columnDefs, extensibleColumns, columnCellClass,
   // ref.current 变更不触发重渲染,作依赖无效;改依赖真正的数据源 allColDefs(memo 值) @author nokecy
-  allColDefs]);
+  allColDefs,
+  // 首批数据到达时重算一次,否则数值列的右对齐永远推断不出来 @author nokecy
+  typeInferenceRow]);
 
   // 构建查询表单项（带 order 属性）
   var queryFormItems = useMemo(function () {

package/dist/esm/ag-grid-plus/hooks/useTypeInferenceRow.d.ts

@@ -0,0 +1,18 @@
+/**
+ * 挑出用于列类型推断的那一行数据。
+ *
+ * 列的数据类型（数值列自动求和并右对齐）是靠首行数据的字段类型推断出来的，
+ * 而这个推断**只该做一次**：之后的数据更新不应该改变列定义，否则翻页、筛选都会重排列。
+ *
+ * 必须返回 state 而不是 ref。这里踩过一次：
+ * 原本用 `useRef` 缓存首行，而消费它的 `useMemo` 依赖数组里又没有 rowData，
+ * 于是异步加载的表格首次渲染时 rowData 为空 → 推断不出类型 → 数据到达后写进 ref
+ * 却不触发重渲染 → 列定义永久停留在「无类型」。表现是数值列该右对齐却一直左对齐，
+ * 不报错、不崩溃，只能靠盯着某一列发现。
+ *
+ * 用 state 就同时满足两件事：首批数据到达时触发一次重算，之后不再变。
+ *
+ * @author nokecy
+ */
+export declare function useTypeInferenceRow(rowData: any[] | undefined | null): any;
+export default useTypeInferenceRow;

package/dist/esm/ag-grid-plus/hooks/useTypeInferenceRow.js

@@ -0,0 +1,37 @@
+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; }
+import { useEffect, useState } from 'react';
+
+/**
+ * 挑出用于列类型推断的那一行数据。
+ *
+ * 列的数据类型（数值列自动求和并右对齐）是靠首行数据的字段类型推断出来的，
+ * 而这个推断**只该做一次**：之后的数据更新不应该改变列定义，否则翻页、筛选都会重排列。
+ *
+ * 必须返回 state 而不是 ref。这里踩过一次：
+ * 原本用 `useRef` 缓存首行，而消费它的 `useMemo` 依赖数组里又没有 rowData，
+ * 于是异步加载的表格首次渲染时 rowData 为空 → 推断不出类型 → 数据到达后写进 ref
+ * 却不触发重渲染 → 列定义永久停留在「无类型」。表现是数值列该右对齐却一直左对齐，
+ * 不报错、不崩溃，只能靠盯着某一列发现。
+ *
+ * 用 state 就同时满足两件事：首批数据到达时触发一次重算，之后不再变。
+ *
+ * @author nokecy
+ */
+export function useTypeInferenceRow(rowData) {
+  var _useState = useState(null),
+    _useState2 = _slicedToArray(_useState, 2),
+    row = _useState2[0],
+    setRow = _useState2[1];
+  useEffect(function () {
+    if (!row && rowData && rowData.length > 0) {
+      setRow(rowData[0]);
+    }
+  }, [rowData, row]);
+  return row;
+}
+export default useTypeInferenceRow;

package/dist/esm/ag-grid-plus/utils/emptyState.js

@@ -15,7 +15,9 @@ function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" ==
 /** 四支文案，按支覆盖。不传的支走默认。 */
 
 export var DEFAULT_EMPTY_TEXTS = {
-  error: '数据加载失败，请点上方「重试」',
+  // 不写方位：重试按钮就渲染在这句话正下方（见 shared/NoRowsOverlay）。
+  // 原文写的是「请点上方「重试」」，方位指错了。@author nokecy
+  error: '数据加载失败，可点下方按钮重试',
   noPermission: '没有查看该数据的权限，请联系系统管理员',
   noResult: '没有符合当前筛选条件的数据，试试放宽或清空筛选条件',
   noData: '暂无数据'

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

@@ -134,6 +134,34 @@ var AgField = function AgField(_ref) {
   return children;
 };
 
+/**
+ * 快路径能否按这个字段名取到值。
+ *
+ * Formily 的字段名是「路径」不是「键」,支持点号嵌套(`item.qty`)、数组下标(`a[0]`)、
+ * 解构(`{value:code,label:name}`)等语法。快路径(只读文本/懒挂载)不挂 Formily 树,
+ * 取值得自己解析。这里只认「点号分段」这一种简单形态,其余一律判不合格 ->
+ * 调用方回退 AgField 全树(由 Formily 自己解析,正确优先于速度)。@author nokecy
+ */
+var isSimpleFieldPath = function isSimpleFieldPath(name) {
+  return !!name && /^[^.{}[\]*]+(\.[^.{}[\]*]+)*$/.test(name);
+};
+
+/**
+ * 按 Formily 字段名从行数据取值。
+ *
+ * 曾经一律按扁平键取 record['item.qty'],而数据在 record.item.qty ->
+ * 嵌套字段名恒 undefined,单元格默认空白,点击挂上全树(按路径解析)才显出真值。
+ *
+ * 在 Observer 里逐层读可观察对象,依赖链完整,程序化改值(setValuesIn)照样刷新。@author nokecy
+ */
+var readByFieldPath = function readByFieldPath(record, path) {
+  if (record == null) return undefined;
+  if (path.indexOf('.') < 0) return record[path];
+  return path.split('.').reduce(function (acc, key) {
+    return acc == null ? undefined : acc[key];
+  }, record);
+};
+
 /**
  * 懒挂载单元格渲染器(可编辑列)。
  *
@@ -180,7 +208,7 @@ var LazyAgField = function LazyAgField(params) {
   // 免去调用方加 forceAgField 逃生阀。字段名缺失才回退 params.value。@author nokecy
   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;
   return /*#__PURE__*/React.createElement(Observer, null, function () {
-    var liveValue = dataKey != null && record ? record[dataKey] : value;
+    var liveValue = dataKey != null && record ? readByFieldPath(record, dataKey) : value;
     var text = formatter ? formatter(liveValue, {
       columnProps: columnProps,
       fieldSchema: fieldSchema
@@ -217,7 +245,7 @@ var LazyReadOnlyText = function LazyReadOnlyText(params) {
     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__*/React.createElement(Observer, null, function () {
-    var liveValue = dataKey != null && record ? record[dataKey] : value;
+    var liveValue = dataKey != null && record ? readByFieldPath(record, dataKey) : value;
     var text = formatter ? formatter(liveValue, {
       columnProps: columnProps,
       fieldSchema: fieldSchema
@@ -310,7 +338,7 @@ var buildArrayTableColumns = function buildArrayTableColumns(dataSource, field,
     //   ① 只读纯文本(永不可编辑):只读列 + 有格式化器 -> valueFormatter,不挂 Formily 树。
     //   ② 可编辑懒挂载:可编辑列 + 有格式化器 + 无 reactions + 未强制 eager -> LazyAgField,
     //      存量格先出廉价文本、点击/导航才挂全树(挂了不卸)。
-    //   ③ 兜底全树:其余(无格式化器/带 reactions/forceAgField/只读但无格式化器) -> AgField。
+    //   ③ 兜底全树:其余(无格式化器/带 reactions/forceAgField/复杂字段名/只读但无格式化器) -> AgField。
     var dataField = findDataFieldSchema(schema, name);
     var component = dataField === null || dataField === void 0 ? void 0 : dataField['x-component'];
     var formatter = getReadOnlyFormatter(component);
@@ -328,12 +356,14 @@ var buildArrayTableColumns = function buildArrayTableColumns(dataSource, field,
     // 故按内层字段名补 valueGetter(仅在与 name 不一致时,保持 name===字段名 的现状)。@author nokecy
     var dataFieldName = dataField === null || dataField === void 0 ? void 0 : dataField.name;
     var valueGetter = dataFieldName && dataFieldName !== name ? function (params) {
-      var _params$data;
-      return params === null || params === void 0 || (_params$data = params.data) === null || _params$data === void 0 ? void 0 : _params$data[dataFieldName];
+      return readByFieldPath(params === null || params === void 0 ? void 0 : params.data, dataFieldName);
     } : undefined;
+    // 字段名是路径:`item.qty` 的值在 record.item.qty。快路径自己解析,只认点号分段;
+    // 解构(`{value:a,label:b}`)/数组下标等复杂语法解析不了,回退全树交给 Formily。@author nokecy
+    var canFastPath = !dataFieldName || isSimpleFieldPath(dataFieldName);
 
     // ① 只读纯文本
-    if (readOnly && formatter) {
+    if (readOnly && formatter && canFastPath) {
       // 列级 readPretty 在「可编辑表」里是展示列(值可能被 setValuesIn 自动带出),静态 valueFormatter
       // 读 AG-Grid 缓存值不刷新 → 反应式只读渲染。整表 readPretty(明细/详情页,数据 setValues 整体加载、
       // 行引用整体替换、AG-Grid 自然刷新)仍走更廉价的静态 valueFormatter 快路径。@author nokecy
@@ -364,7 +394,7 @@ var buildArrayTableColumns = function buildArrayTableColumns(dataSource, field,
     }
 
     // ② 可编辑懒挂载(排除单击直控的 Switch/Checkbox:须 eager 出真控件)
-    if (!readOnly && formatter && !hasReactions && !forceEager && !isInlineToggle) {
+    if (!readOnly && formatter && !hasReactions && !forceEager && !isInlineToggle && canFastPath) {
       return buf.concat(_objectSpread(_objectSpread(_objectSpread({}, base), valueGetter ? {
         valueGetter: valueGetter
       } : {}), {}, {