@nokecy/qc-ui 1.1.81 → 1.1.83

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

@@ -150,6 +150,15 @@ var ArrayTableInner = (0, _react2.observer)(function (props) {
     return cols;
   }, [sources, props.onRowDrag]); // 移除 field 依赖，避免数据变化时重新计算
 
+  // 懒挂载的格子不创建 Formily 字段，schema 的 default 不会自己写进值：行出现时补一次（每行只补一次）。@author nokecy
+  var lazyDefaults = (0, _react.useMemo)(function () {
+    return (0, _utils.collectLazyDefaults)(stableColumnDefs);
+  }, [stableColumnDefs]);
+  var defaultedRowsRef = (0, _react.useRef)(new WeakSet());
+  (0, _react.useEffect)(function () {
+    if (lazyDefaults.length > 0) (0, _utils.applyLazyDefaults)(field, lazyDefaults, defaultedRowsRef.current);
+  });
+
   // 交给 AgGridReact 的列定义:按 x-component-props.headerGroup 把相邻同组的列合并成列组(多级表头)。
   // stableColumnDefs 保持扁平,懒列识别、列方案还原等内部逻辑仍用它;只有喂给 AG-Grid 的这一份带分组。@author nokecy
   var gridColumnDefs = (0, _react.useMemo)(function () {

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

@@ -4,6 +4,11 @@ export type ReadOnlyFormatterCtx = {
     columnProps: any;
     /** 内层数据字段的 schema(可读 enum / x-component-props) */
     fieldSchema: any;
+    /**
+     * 运行时才确定的选项(field.setDataSource / setFieldState 写入的 dataSource)。
+     * 懒挂载格子没有自己的 Formily 字段时，由调用方取同列已创建字段的选项带进来；有值时优先于 schema 静态选项。
+     */
+    dataSource?: any[];
 };
 export type ReadOnlyFormatter = (value: any, ctx: ReadOnlyFormatterCtx) => string;
 /**

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

@@ -32,6 +32,7 @@ var resolveOptions = function resolveOptions(ctx) {
   var _ref, _ref2, _ref3, _fieldSchema$enum, _fieldSchema$xCompon, _fieldSchema$xCompon2;
   var columnProps = ctx.columnProps,
     fieldSchema = ctx.fieldSchema;
+  if (Array.isArray(ctx.dataSource) && ctx.dataSource.length > 0) return ctx.dataSource;
   var candidate = (_ref = (_ref2 = (_ref3 = (_fieldSchema$enum = fieldSchema === null || fieldSchema === void 0 ? void 0 : fieldSchema.enum) !== null && _fieldSchema$enum !== void 0 ? _fieldSchema$enum : fieldSchema === null || fieldSchema === void 0 || (_fieldSchema$xCompon = fieldSchema['x-component-props']) === null || _fieldSchema$xCompon === void 0 ? void 0 : _fieldSchema$xCompon.options) !== null && _ref3 !== void 0 ? _ref3 : fieldSchema === null || fieldSchema === void 0 || (_fieldSchema$xCompon2 = fieldSchema['x-component-props']) === null || _fieldSchema$xCompon2 === void 0 ? void 0 : _fieldSchema$xCompon2.dataSource) !== null && _ref2 !== void 0 ? _ref2 : columnProps === null || columnProps === void 0 ? void 0 : columnProps.options) !== null && _ref !== void 0 ? _ref : columnProps === null || columnProps === void 0 ? void 0 : columnProps.dataSource;
   return Array.isArray(candidate) ? candidate : [];
 };
@@ -64,20 +65,63 @@ var selectFormatter = function selectFormatter(value, ctx) {
   }
   return mapOptionLabel(value, options);
 };
+
+/**
+ * 日期/时间控件没写 format 时的默认显示格式，与 antd 控件自己的默认一致：
+ * TimePicker 只显示时间；showTime 带到秒；按月/按年选择器只显示到月/年。
+ * 文本态与点开后的控件看到同一个格式，不然 showTime 的列平时只见日期、点开才见时间。
+ */
+var defaultDateFormat = function defaultDateFormat(component, props) {
+  if (component === 'TimePicker') return props !== null && props !== void 0 && props.use12Hours ? 'hh:mm:ss a' : 'HH:mm:ss';
+  if ((props === null || props === void 0 ? void 0 : props.picker) === 'month') return 'YYYY-MM';
+  if ((props === null || props === void 0 ? void 0 : props.picker) === 'year') return 'YYYY';
+  if (props !== null && props !== void 0 && props.showTime) return 'YYYY-MM-DD HH:mm:ss';
+  return 'YYYY-MM-DD';
+};
 var dateFormatter = function dateFormatter(value, ctx) {
-  var _ref6, _ctx$columnProps$form, _ctx$columnProps, _ctx$fieldSchema;
+  var _ctx$fieldSchema, _ctx$columnProps, _ctx$fieldSchema2;
   if (value == null || value === '') return '';
-  var fmt = (_ref6 = (_ctx$columnProps$form = (_ctx$columnProps = ctx.columnProps) === null || _ctx$columnProps === void 0 ? void 0 : _ctx$columnProps.format) !== null && _ctx$columnProps$form !== void 0 ? _ctx$columnProps$form : (_ctx$fieldSchema = ctx.fieldSchema) === null || _ctx$fieldSchema === void 0 || (_ctx$fieldSchema = _ctx$fieldSchema['x-component-props']) === null || _ctx$fieldSchema === void 0 ? void 0 : _ctx$fieldSchema.format) !== null && _ref6 !== void 0 ? _ref6 : 'YYYY-MM-DD';
+  var props = (_ctx$fieldSchema = ctx.fieldSchema) === null || _ctx$fieldSchema === void 0 ? void 0 : _ctx$fieldSchema['x-component-props'];
+  // antd 的 format 还可以是数组/函数，文本态只认字符串，其余回到默认
+  var configured = [(_ctx$columnProps = ctx.columnProps) === null || _ctx$columnProps === void 0 ? void 0 : _ctx$columnProps.format, props === null || props === void 0 ? void 0 : props.format].find(function (f) {
+    return typeof f === 'string' && f;
+  });
+  var fmt = configured !== null && configured !== void 0 ? configured : defaultDateFormat((_ctx$fieldSchema2 = ctx.fieldSchema) === null || _ctx$fieldSchema2 === void 0 ? void 0 : _ctx$fieldSchema2['x-component'], props);
   if (typeof value.format === 'function') return value.format(fmt);
   // 后端回来的多是 ISO 串(2024-10-19T00:00:00)或时间戳:与 Formily readPretty 一致,按 dayjs(value).format(fmt) 显示;
-  // 解析不了的文本(如「待定」)原样显示,不吞掉。dayjs 随 antd 传递依赖引入,本库其他模块已直接使用。
+  // 解析不了的文本(如「待定」、纯时间 08:30:00)原样显示,不吞掉。dayjs 随 antd 传递依赖引入,本库其他模块已直接使用。
   var parsed = (0, _dayjs.default)(value);
   return parsed.isValid() ? parsed.format(fmt) : String(value);
 };
+
+/**
+ * 数字格：按控件的 precision 补齐小数位、按 formatter 属性（千分位、百分号等）显示，
+ * 与点开后的 InputNumber 一致；没配这两项时与原样输出相同。
+ */
+var numberFormatter = function numberFormatter(value, ctx) {
+  var _ctx$fieldSchema$xCo, _ctx$fieldSchema3, _ctx$columnProps$prec, _ctx$columnProps2, _ctx$columnProps$form, _ctx$columnProps3;
+  if (value == null || value === '') return '';
+  var props = (_ctx$fieldSchema$xCo = (_ctx$fieldSchema3 = ctx.fieldSchema) === null || _ctx$fieldSchema3 === void 0 ? void 0 : _ctx$fieldSchema3['x-component-props']) !== null && _ctx$fieldSchema$xCo !== void 0 ? _ctx$fieldSchema$xCo : {};
+  var precision = (_ctx$columnProps$prec = (_ctx$columnProps2 = ctx.columnProps) === null || _ctx$columnProps2 === void 0 ? void 0 : _ctx$columnProps2.precision) !== null && _ctx$columnProps$prec !== void 0 ? _ctx$columnProps$prec : props.precision;
+  var num = Number(value);
+  var base = typeof precision === 'number' && precision >= 0 && Number.isFinite(num) ? num.toFixed(precision) : String(value);
+  var formatter = (_ctx$columnProps$form = (_ctx$columnProps3 = ctx.columnProps) === null || _ctx$columnProps3 === void 0 ? void 0 : _ctx$columnProps3.formatter) !== null && _ctx$columnProps$form !== void 0 ? _ctx$columnProps$form : props.formatter;
+  if (typeof formatter === 'function') {
+    try {
+      return String(formatter(base, {
+        userTyping: false,
+        input: ''
+      }));
+    } catch (_unused) {
+      return base;
+    }
+  }
+  return base;
+};
 var booleanFormatter = function booleanFormatter(value, ctx) {
-  var _ctx$fieldSchema$xCo, _ctx$fieldSchema2, _props$checkedChildre, _props$unCheckedChild;
+  var _ctx$fieldSchema$xCo2, _ctx$fieldSchema4, _props$checkedChildre, _props$unCheckedChild;
   if (value == null || value === '') return '';
-  var props = (_ctx$fieldSchema$xCo = (_ctx$fieldSchema2 = ctx.fieldSchema) === null || _ctx$fieldSchema2 === void 0 ? void 0 : _ctx$fieldSchema2['x-component-props']) !== null && _ctx$fieldSchema$xCo !== void 0 ? _ctx$fieldSchema$xCo : {};
+  var props = (_ctx$fieldSchema$xCo2 = (_ctx$fieldSchema4 = ctx.fieldSchema) === null || _ctx$fieldSchema4 === void 0 ? void 0 : _ctx$fieldSchema4['x-component-props']) !== null && _ctx$fieldSchema$xCo2 !== void 0 ? _ctx$fieldSchema$xCo2 : {};
   var truthy = (_props$checkedChildre = props.checkedChildren) !== null && _props$checkedChildre !== void 0 ? _props$checkedChildre : '是';
   var falsy = (_props$unCheckedChild = props.unCheckedChildren) !== null && _props$unCheckedChild !== void 0 ? _props$unCheckedChild : '否';
   return value ? String(truthy) : String(falsy);
@@ -93,8 +137,8 @@ var registry = {
   Password: textFormatter,
   Text: textFormatter,
   Preview: textFormatter,
-  NumberPicker: textFormatter,
-  InputNumber: textFormatter,
+  NumberPicker: numberFormatter,
+  InputNumber: numberFormatter,
   Select: selectFormatter,
   TreeSelect: selectFormatter,
   Cascader: selectFormatter,
@@ -152,17 +196,17 @@ var registerReadOnlyLabels = exports.registerReadOnlyLabels = function registerR
       if (o && o.value != null) map.set(String(o.value), String((_o$label = o.label) !== null && _o$label !== void 0 ? _o$label : o.value));
     });
   } else {
-    Object.entries(labels !== null && labels !== void 0 ? labels : {}).forEach(function (_ref7) {
-      var _ref8 = _slicedToArray(_ref7, 2),
-        k = _ref8[0],
-        v = _ref8[1];
+    Object.entries(labels !== null && labels !== void 0 ? labels : {}).forEach(function (_ref6) {
+      var _ref7 = _slicedToArray(_ref6, 2),
+        k = _ref7[0],
+        v = _ref7[1];
       return map.set(String(k), String(v));
     });
   }
   var toText = function toText(v) {
-    var _ref9, _v$label, _map$get;
+    var _ref8, _v$label, _map$get;
     if (v == null || v === '') return '';
-    if (_typeof(v) === 'object') return String((_ref9 = (_v$label = v.label) !== null && _v$label !== void 0 ? _v$label : v.value) !== null && _ref9 !== void 0 ? _ref9 : '');
+    if (_typeof(v) === 'object') return String((_ref8 = (_v$label = v.label) !== null && _v$label !== void 0 ? _v$label : v.value) !== null && _ref8 !== void 0 ? _ref8 : '');
     return (_map$get = map.get(String(v))) !== null && _map$get !== void 0 ? _map$get : String(v);
   };
   var formatter = function formatter(value) {

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

@@ -41,3 +41,20 @@ declare const LazyReadOnlyText: (params: any) => React.JSX.Element;
 declare const buildArrayTableColumns: (dataSource: any[], field: ArrayField, sources: ObservableColumnSource[]) => AgGridReactProps['columnDefs'];
 declare const useAddition: () => React.JSX.Element | null;
 export { isColumnComponent, useArrayTableSources, useArrayTableActions, buildArrayTableColumns, useAddition, LazyAgField, LazyReadOnlyText };
+export type LazyColumnDefault = {
+    key: string;
+    value: any;
+};
+/**
+ * 收集懒挂载列上声明了 default 的字段。
+ *
+ * Formily 在字段创建时把 schema 的 default 写进值（值为空时）。懒挂载的格子不创建字段，
+ * 老记录里缺的列、代码直接 push 的行就拿不到默认值，保存时是 null。
+ * 表达式形态的默认值（{{...}}）要求值上下文，这里不处理。@author nokecy
+ */
+export declare const collectLazyDefaults: (columns: any[]) => LazyColumnDefault[];
+/**
+ * 给还没处理过的新增行补默认值：值为空（null/undefined）才写，每行只补一次——
+ * 用户之后把格子清空是有意的，不能再被填回去。已落库的行（带 id）不动。@author nokecy
+ */
+export declare const applyLazyDefaults: (arrayField: any, defaults: LazyColumnDefault[], handled: WeakSet<object>) => void;

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

@@ -3,10 +3,11 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.useArrayTableSources = exports.useArrayTableActions = exports.useAddition = exports.isColumnComponent = exports.buildArrayTableColumns = exports.LazyReadOnlyText = exports.LazyAgField = void 0;
+exports.useArrayTableSources = exports.useArrayTableActions = exports.useAddition = exports.isColumnComponent = exports.collectLazyDefaults = exports.buildArrayTableColumns = exports.applyLazyDefaults = exports.LazyReadOnlyText = exports.LazyAgField = void 0;
 var _react = _interopRequireWildcard(require("react"));
 var _antd = require("antd");
 var _react2 = require("@formily/react");
+var _reactive = require("@formily/reactive");
 var _shared = require("@formily/shared");
 var _jsonSchema = require("@formily/json-schema");
 var _arrayBase = _interopRequireDefault(require("./arrayBase"));
@@ -306,6 +307,20 @@ var hasRequiredRule = function hasRequiredRule(rule) {
   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 规则。
  *
@@ -420,6 +435,28 @@ var LazyAgField = exports.LazyAgField = function LazyAgField(params) {
     };
   }();
 
+  /**
+   * 运行时设置的选项(field.setDataSource / setFieldState dataSource)。
+   *
+   * 只取本格自己的字段：点开过的格子字段还在，失焦卸回文本后仍按名称显示。
+   * 不借同列其他格的选项——选项常常按行不同（如标签类型跟随同行的打印功能），借来的选项会把值映射成别的名称，
+   * 比显示原编码更糟。从未点开过的格子没有字段，要显示名称请把选项写进 Schema（x-component-props.options）。
+   * 仅选项类组件且有值时才查；按精确地址取、放在 untracked 里，不让每个格子都订阅整张字段表。@author nokecy
+   */
+  var liveDataSource = function liveDataSource(liveValue) {
+    var _field$value$indexOf4, _field$value4, _field$value4$indexOf;
+    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 index = (_field$value$indexOf4 = field === null || field === void 0 || (_field$value4 = field.value) === null || _field$value4 === void 0 || (_field$value4$indexOf = _field$value4.indexOf) === null || _field$value4$indexOf === void 0 ? void 0 : _field$value4$indexOf.call(_field$value4, record)) !== null && _field$value$indexOf4 !== void 0 ? _field$value$indexOf4 : -1;
+    if (index < 0) return undefined;
+    var own = (0, _reactive.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 程序化原地
@@ -452,10 +489,12 @@ var LazyAgField = exports.LazyAgField = function LazyAgField(params) {
         node: node
       }));
     }
-    var text = formatter ? formatter(liveValue, {
+    var ctx = {
       columnProps: columnProps,
-      fieldSchema: fieldSchema
-    }) : liveValue == null ? '' : String(liveValue);
+      fieldSchema: fieldSchema,
+      dataSource: activated ? undefined : liveDataSource(liveValue)
+    };
+    var text = formatter ? formatter(liveValue, ctx) : liveValue == null ? '' : String(liveValue);
     // 纯文本占满单元格,点击交给 AG-Grid onCellClicked 激活;样式尽量贴近 Editable 只读态避免点开跳动
     // 只读态(readPretty/disabled/readOnly)的空格不出编辑提示,留空与只读快路径一致
     var pattern = text === '' ? resolveLazyCellPattern(field, record, dataKey, fieldSchema, scope) : undefined;
@@ -472,10 +511,7 @@ var LazyAgField = exports.LazyAgField = function LazyAgField(params) {
       }, resolveEmptyPlaceholder(fieldSchema));
     }
     // 登记了只读渲染器的组件(如带颜色的 Tag)按渲染器出内容,与组件自己的阅读态一致
-    var shown = renderer && text !== '' ? renderer(liveValue, {
-      columnProps: columnProps,
-      fieldSchema: fieldSchema
-    }) : text;
+    var shown = renderer && text !== '' ? renderer(liveValue, ctx) : text;
     return /*#__PURE__*/_react.default.createElement("span", {
       className: "ag-array-table-lazy-text",
       style: {
@@ -653,6 +689,9 @@ var buildArrayTableColumns = exports.buildArrayTableColumns = function buildArra
     // 懒挂载会把它降成「是/否」纯文本(点击才挂出开关),用户会以为开关消失。故可编辑态强制 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 上,
@@ -719,7 +758,7 @@ var buildArrayTableColumns = exports.buildArrayTableColumns = function buildArra
     }
 
     // ② 可编辑懒挂载(排除单击直控的 Switch/Checkbox:须 eager 出真控件)
-    if (!readOnly && formatter && !hasReactions && !forceEager && !isInlineToggle && canFastPath) {
+    if (!readOnly && formatter && !hasReactions && !forceEager && !isInlineToggle && !isIndexWriter && canFastPath) {
       return emit(_objectSpread(_objectSpread(_objectSpread({}, base), valueGetter ? {
         valueGetter: valueGetter
       } : {}), {}, {
@@ -734,7 +773,8 @@ var buildArrayTableColumns = exports.buildArrayTableColumns = function buildArra
           fieldSchema: dataField,
           lazyEditable: true,
           // 供 index.tsx 识别懒列(激活/导航用)
-          required: isRequiredSchema(dataField) // 必填且为空的格必须挂真控件,见 LazyAgField
+          // 必填、或带校验规则且为空的格必须挂真控件，否则没有字段节点，提交时没人校验它，见 LazyAgField
+          required: isRequiredSchema(dataField) || hasValidatorRule(dataField)
         }
       }));
     }
@@ -761,4 +801,54 @@ var useAddition = exports.useAddition = function useAddition() {
     }
     return addition;
   }, 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 (_ref7) {
+    var key = _ref7.key,
+      value = _ref7.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 (_ref8) {
+      var key = _ref8.key,
+        value = _ref8.value;
+      if (row[key] == null) {
+        form.setValuesIn(arrayField.path.concat(index).concat(key), _typeof(value) === 'object' ? JSON.parse(JSON.stringify(value)) : value);
+      }
+    });
+  });
 };

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

@@ -10,10 +10,12 @@ var _arrayBase = require("../array-table/arrayBase");
 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; }
 var _default = exports.default = function _default(props) {
-  var onChange = props.onChange;
+  var onChange = props.onChange,
+    value = props.value;
   var index = _arrayBase.ArrayBase.useIndex();
   (0, _react.useEffect)(function () {
-    onChange(index + 1);
-  }, [index]);
+    // 行号变了、或字段值被外部覆盖/清空(如 setValues、重置)而不等于行号时，重新写入
+    if (value !== index + 1) onChange(index + 1);
+  }, [index, value]);
   return /*#__PURE__*/_react.default.createElement("span", props, "#", index + 1, ".");
 };

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

@@ -17,7 +17,7 @@ import { useField, observer, RecursionField } from "@formily/react";
 import { useFieldSchema } from "@formily/react";
 import { connect, mapProps, mapReadPretty } from "@formily/react";
 import uniqueId from "lodash/uniqueId";
-import { useAddition, buildArrayTableColumns, useArrayTableSources, useArrayTableActions, isColumnComponent } from "./utils";
+import { useAddition, buildArrayTableColumns, useArrayTableSources, useArrayTableActions, isColumnComponent, collectLazyDefaults, applyLazyDefaults } from "./utils";
 import { groupColumnDefs } from "./columnGroup";
 import { ARRAY_TABLE_INDEX_FIELD, hasOwnIndexColumn, makeIndexColumn } from "./indexColumn";
 import { useCellFocus, useKeyboardNavigation, useRowDrag, suppressNativeInputKeys } from "./hooks";
@@ -146,6 +146,15 @@ var ArrayTableInner = observer(function (props) {
     return cols;
   }, [sources, props.onRowDrag]); // 移除 field 依赖，避免数据变化时重新计算
 
+  // 懒挂载的格子不创建 Formily 字段，schema 的 default 不会自己写进值：行出现时补一次（每行只补一次）。@author nokecy
+  var lazyDefaults = useMemo(function () {
+    return collectLazyDefaults(stableColumnDefs);
+  }, [stableColumnDefs]);
+  var defaultedRowsRef = useRef(new WeakSet());
+  useEffect(function () {
+    if (lazyDefaults.length > 0) applyLazyDefaults(field, lazyDefaults, defaultedRowsRef.current);
+  });
+
   // 交给 AgGridReact 的列定义:按 x-component-props.headerGroup 把相邻同组的列合并成列组(多级表头)。
   // stableColumnDefs 保持扁平,懒列识别、列方案还原等内部逻辑仍用它;只有喂给 AG-Grid 的这一份带分组。@author nokecy
   var gridColumnDefs = useMemo(function () {

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

@@ -4,6 +4,11 @@ export type ReadOnlyFormatterCtx = {
     columnProps: any;
     /** 内层数据字段的 schema(可读 enum / x-component-props) */
     fieldSchema: any;
+    /**
+     * 运行时才确定的选项(field.setDataSource / setFieldState 写入的 dataSource)。
+     * 懒挂载格子没有自己的 Formily 字段时，由调用方取同列已创建字段的选项带进来；有值时优先于 schema 静态选项。
+     */
+    dataSource?: any[];
 };
 export type ReadOnlyFormatter = (value: any, ctx: ReadOnlyFormatterCtx) => string;
 /**

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

@@ -26,6 +26,7 @@ var resolveOptions = function resolveOptions(ctx) {
   var _ref, _ref2, _ref3, _fieldSchema$enum, _fieldSchema$xCompon, _fieldSchema$xCompon2;
   var columnProps = ctx.columnProps,
     fieldSchema = ctx.fieldSchema;
+  if (Array.isArray(ctx.dataSource) && ctx.dataSource.length > 0) return ctx.dataSource;
   var candidate = (_ref = (_ref2 = (_ref3 = (_fieldSchema$enum = fieldSchema === null || fieldSchema === void 0 ? void 0 : fieldSchema.enum) !== null && _fieldSchema$enum !== void 0 ? _fieldSchema$enum : fieldSchema === null || fieldSchema === void 0 || (_fieldSchema$xCompon = fieldSchema['x-component-props']) === null || _fieldSchema$xCompon === void 0 ? void 0 : _fieldSchema$xCompon.options) !== null && _ref3 !== void 0 ? _ref3 : fieldSchema === null || fieldSchema === void 0 || (_fieldSchema$xCompon2 = fieldSchema['x-component-props']) === null || _fieldSchema$xCompon2 === void 0 ? void 0 : _fieldSchema$xCompon2.dataSource) !== null && _ref2 !== void 0 ? _ref2 : columnProps === null || columnProps === void 0 ? void 0 : columnProps.options) !== null && _ref !== void 0 ? _ref : columnProps === null || columnProps === void 0 ? void 0 : columnProps.dataSource;
   return Array.isArray(candidate) ? candidate : [];
 };
@@ -58,20 +59,63 @@ var selectFormatter = function selectFormatter(value, ctx) {
   }
   return mapOptionLabel(value, options);
 };
+
+/**
+ * 日期/时间控件没写 format 时的默认显示格式，与 antd 控件自己的默认一致：
+ * TimePicker 只显示时间；showTime 带到秒；按月/按年选择器只显示到月/年。
+ * 文本态与点开后的控件看到同一个格式，不然 showTime 的列平时只见日期、点开才见时间。
+ */
+var defaultDateFormat = function defaultDateFormat(component, props) {
+  if (component === 'TimePicker') return props !== null && props !== void 0 && props.use12Hours ? 'hh:mm:ss a' : 'HH:mm:ss';
+  if ((props === null || props === void 0 ? void 0 : props.picker) === 'month') return 'YYYY-MM';
+  if ((props === null || props === void 0 ? void 0 : props.picker) === 'year') return 'YYYY';
+  if (props !== null && props !== void 0 && props.showTime) return 'YYYY-MM-DD HH:mm:ss';
+  return 'YYYY-MM-DD';
+};
 var dateFormatter = function dateFormatter(value, ctx) {
-  var _ref6, _ctx$columnProps$form, _ctx$columnProps, _ctx$fieldSchema;
+  var _ctx$fieldSchema, _ctx$columnProps, _ctx$fieldSchema2;
   if (value == null || value === '') return '';
-  var fmt = (_ref6 = (_ctx$columnProps$form = (_ctx$columnProps = ctx.columnProps) === null || _ctx$columnProps === void 0 ? void 0 : _ctx$columnProps.format) !== null && _ctx$columnProps$form !== void 0 ? _ctx$columnProps$form : (_ctx$fieldSchema = ctx.fieldSchema) === null || _ctx$fieldSchema === void 0 || (_ctx$fieldSchema = _ctx$fieldSchema['x-component-props']) === null || _ctx$fieldSchema === void 0 ? void 0 : _ctx$fieldSchema.format) !== null && _ref6 !== void 0 ? _ref6 : 'YYYY-MM-DD';
+  var props = (_ctx$fieldSchema = ctx.fieldSchema) === null || _ctx$fieldSchema === void 0 ? void 0 : _ctx$fieldSchema['x-component-props'];
+  // antd 的 format 还可以是数组/函数，文本态只认字符串，其余回到默认
+  var configured = [(_ctx$columnProps = ctx.columnProps) === null || _ctx$columnProps === void 0 ? void 0 : _ctx$columnProps.format, props === null || props === void 0 ? void 0 : props.format].find(function (f) {
+    return typeof f === 'string' && f;
+  });
+  var fmt = configured !== null && configured !== void 0 ? configured : defaultDateFormat((_ctx$fieldSchema2 = ctx.fieldSchema) === null || _ctx$fieldSchema2 === void 0 ? void 0 : _ctx$fieldSchema2['x-component'], props);
   if (typeof value.format === 'function') return value.format(fmt);
   // 后端回来的多是 ISO 串(2024-10-19T00:00:00)或时间戳:与 Formily readPretty 一致,按 dayjs(value).format(fmt) 显示;
-  // 解析不了的文本(如「待定」)原样显示,不吞掉。dayjs 随 antd 传递依赖引入,本库其他模块已直接使用。
+  // 解析不了的文本(如「待定」、纯时间 08:30:00)原样显示,不吞掉。dayjs 随 antd 传递依赖引入,本库其他模块已直接使用。
   var parsed = dayjs(value);
   return parsed.isValid() ? parsed.format(fmt) : String(value);
 };
+
+/**
+ * 数字格：按控件的 precision 补齐小数位、按 formatter 属性（千分位、百分号等）显示，
+ * 与点开后的 InputNumber 一致；没配这两项时与原样输出相同。
+ */
+var numberFormatter = function numberFormatter(value, ctx) {
+  var _ctx$fieldSchema$xCo, _ctx$fieldSchema3, _ctx$columnProps$prec, _ctx$columnProps2, _ctx$columnProps$form, _ctx$columnProps3;
+  if (value == null || value === '') return '';
+  var props = (_ctx$fieldSchema$xCo = (_ctx$fieldSchema3 = ctx.fieldSchema) === null || _ctx$fieldSchema3 === void 0 ? void 0 : _ctx$fieldSchema3['x-component-props']) !== null && _ctx$fieldSchema$xCo !== void 0 ? _ctx$fieldSchema$xCo : {};
+  var precision = (_ctx$columnProps$prec = (_ctx$columnProps2 = ctx.columnProps) === null || _ctx$columnProps2 === void 0 ? void 0 : _ctx$columnProps2.precision) !== null && _ctx$columnProps$prec !== void 0 ? _ctx$columnProps$prec : props.precision;
+  var num = Number(value);
+  var base = typeof precision === 'number' && precision >= 0 && Number.isFinite(num) ? num.toFixed(precision) : String(value);
+  var formatter = (_ctx$columnProps$form = (_ctx$columnProps3 = ctx.columnProps) === null || _ctx$columnProps3 === void 0 ? void 0 : _ctx$columnProps3.formatter) !== null && _ctx$columnProps$form !== void 0 ? _ctx$columnProps$form : props.formatter;
+  if (typeof formatter === 'function') {
+    try {
+      return String(formatter(base, {
+        userTyping: false,
+        input: ''
+      }));
+    } catch (_unused) {
+      return base;
+    }
+  }
+  return base;
+};
 var booleanFormatter = function booleanFormatter(value, ctx) {
-  var _ctx$fieldSchema$xCo, _ctx$fieldSchema2, _props$checkedChildre, _props$unCheckedChild;
+  var _ctx$fieldSchema$xCo2, _ctx$fieldSchema4, _props$checkedChildre, _props$unCheckedChild;
   if (value == null || value === '') return '';
-  var props = (_ctx$fieldSchema$xCo = (_ctx$fieldSchema2 = ctx.fieldSchema) === null || _ctx$fieldSchema2 === void 0 ? void 0 : _ctx$fieldSchema2['x-component-props']) !== null && _ctx$fieldSchema$xCo !== void 0 ? _ctx$fieldSchema$xCo : {};
+  var props = (_ctx$fieldSchema$xCo2 = (_ctx$fieldSchema4 = ctx.fieldSchema) === null || _ctx$fieldSchema4 === void 0 ? void 0 : _ctx$fieldSchema4['x-component-props']) !== null && _ctx$fieldSchema$xCo2 !== void 0 ? _ctx$fieldSchema$xCo2 : {};
   var truthy = (_props$checkedChildre = props.checkedChildren) !== null && _props$checkedChildre !== void 0 ? _props$checkedChildre : '是';
   var falsy = (_props$unCheckedChild = props.unCheckedChildren) !== null && _props$unCheckedChild !== void 0 ? _props$unCheckedChild : '否';
   return value ? String(truthy) : String(falsy);
@@ -87,8 +131,8 @@ var registry = {
   Password: textFormatter,
   Text: textFormatter,
   Preview: textFormatter,
-  NumberPicker: textFormatter,
-  InputNumber: textFormatter,
+  NumberPicker: numberFormatter,
+  InputNumber: numberFormatter,
   Select: selectFormatter,
   TreeSelect: selectFormatter,
   Cascader: selectFormatter,
@@ -146,17 +190,17 @@ export var registerReadOnlyLabels = function registerReadOnlyLabels(component, l
       if (o && o.value != null) map.set(String(o.value), String((_o$label = o.label) !== null && _o$label !== void 0 ? _o$label : o.value));
     });
   } else {
-    Object.entries(labels !== null && labels !== void 0 ? labels : {}).forEach(function (_ref7) {
-      var _ref8 = _slicedToArray(_ref7, 2),
-        k = _ref8[0],
-        v = _ref8[1];
+    Object.entries(labels !== null && labels !== void 0 ? labels : {}).forEach(function (_ref6) {
+      var _ref7 = _slicedToArray(_ref6, 2),
+        k = _ref7[0],
+        v = _ref7[1];
       return map.set(String(k), String(v));
     });
   }
   var toText = function toText(v) {
-    var _ref9, _v$label, _map$get;
+    var _ref8, _v$label, _map$get;
     if (v == null || v === '') return '';
-    if (_typeof(v) === 'object') return String((_ref9 = (_v$label = v.label) !== null && _v$label !== void 0 ? _v$label : v.value) !== null && _ref9 !== void 0 ? _ref9 : '');
+    if (_typeof(v) === 'object') return String((_ref8 = (_v$label = v.label) !== null && _v$label !== void 0 ? _v$label : v.value) !== null && _ref8 !== void 0 ? _ref8 : '');
     return (_map$get = map.get(String(v))) !== null && _map$get !== void 0 ? _map$get : String(v);
   };
   var formatter = function formatter(value) {

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

@@ -41,3 +41,20 @@ declare const LazyReadOnlyText: (params: any) => React.JSX.Element;
 declare const buildArrayTableColumns: (dataSource: any[], field: ArrayField, sources: ObservableColumnSource[]) => AgGridReactProps['columnDefs'];
 declare const useAddition: () => React.JSX.Element | null;
 export { isColumnComponent, useArrayTableSources, useArrayTableActions, buildArrayTableColumns, useAddition, LazyAgField, LazyReadOnlyText };
+export type LazyColumnDefault = {
+    key: string;
+    value: any;
+};
+/**
+ * 收集懒挂载列上声明了 default 的字段。
+ *
+ * Formily 在字段创建时把 schema 的 default 写进值（值为空时）。懒挂载的格子不创建字段，
+ * 老记录里缺的列、代码直接 push 的行就拿不到默认值，保存时是 null。
+ * 表达式形态的默认值（{{...}}）要求值上下文，这里不处理。@author nokecy
+ */
+export declare const collectLazyDefaults: (columns: any[]) => LazyColumnDefault[];
+/**
+ * 给还没处理过的新增行补默认值：值为空（null/undefined）才写，每行只补一次——
+ * 用户之后把格子清空是有意的，不能再被填回去。已落库的行（带 id）不动。@author nokecy
+ */
+export declare const applyLazyDefaults: (arrayField: any, defaults: LazyColumnDefault[], handled: WeakSet<object>) => void;