amis-core 6.2.2 → 6.3.0

package/esm/renderers/Form.js

@@ -1,5 +1,5 @@
 /**
- * amis-core v6.2.2
+ * amis-core v6.3.0
  * Copyright 2018-2024 fex
  */
 
@@ -9,7 +9,7 @@ import { Renderer } from '../factory.js';
 import { FormStore } from '../store/form.js';
 import { evalExpression, filter } from '../utils/tpl.js';
 import { getExprProperties } from '../utils/filter-schema.js';
-import { promisify, isEmpty, until, noop, difference, isVisible, repeatCount, buildTestId, qsparse, isObjectShallowModified, SkipOperation } from '../utils/helper.js';
+import { promisify, isEmpty, until, noop, difference, isVisible, repeatCount, qsparse, isObjectShallowModified, SkipOperation } from '../utils/helper.js';
 import debounce from 'lodash/debounce';
 import flatten from 'lodash/flatten';
 import find from 'lodash/find';
@@ -35,7 +35,7 @@ import 'lodash/isString';
 import 'lodash/isBoolean';
 import '../utils/image.js';
 import 'lodash/isPlainObject';
-import 'lodash/isEqual';
+import isEqual from 'lodash/isEqual';
 import '../actions/Action.js';
 import '../utils/resize-sensor.js';
 import 'react-overlays/useRootClose';
@@ -52,6 +52,7 @@ import '../utils/validations.js';
 import '../utils/resolveCondition.js';
 import { reaction } from 'mobx';
 import '../utils/Animation.js';
+import groupBy from 'lodash/groupBy';
 
 var Form = /** @class */ (function (_super) {
     __extends(Form, _super);
@@ -66,6 +67,7 @@ var Form = /** @class */ (function (_super) {
         });
         // 如果开启了 lazyChange，需要一个 flush 方法把队列中值应用上。
         _this.flushing = false;
+        _this.emittedData = null;
         _this.onInit = _this.onInit.bind(_this);
         _this.handleAction = _this.handleAction.bind(_this);
         _this.handleQuery = _this.handleQuery.bind(_this);
@@ -268,7 +270,7 @@ var Form = /** @class */ (function (_super) {
     };
     Form.prototype.onInit = function () {
         return __awaiter(this, void 0, void 0, function () {
-            var _a, onInit, store, persistData, submitOnInit, data, initedAt, hooks;
+            var _a, onInit, store, persistData, submitOnInit, data, initedAt, hooks, groupedHooks;
             return __generator(this, function (_b) {
                 switch (_b.label) {
                     case 0:
@@ -280,8 +282,23 @@ var Form = /** @class */ (function (_super) {
                         initedAt = store.initedAt;
                         store.setInited(true);
                         hooks = this.hooks['init'] || [];
-                        return [4 /*yield*/, Promise.all(hooks.map(function (hook) { return hook(data); }))];
+                        groupedHooks = groupBy(hooks, function (item) {
+                            return item.__enforce === 'prev'
+                                ? 'prev'
+                                : item.__enforce === 'post'
+                                    ? 'post'
+                                    : 'normal';
+                        });
+                        return [4 /*yield*/, Promise.all((groupedHooks.prev || []).map(function (hook) { return hook(data); }))];
                     case 1:
+                        _b.sent();
+                        //  有可能在前面的步骤中删除了钩子，所以需要重新验证一下
+                        return [4 /*yield*/, Promise.all((groupedHooks.normal || []).map(function (hook) { return hooks.includes(hook) && hook(data); }))];
+                    case 2:
+                        //  有可能在前面的步骤中删除了钩子，所以需要重新验证一下
+                        _b.sent();
+                        return [4 /*yield*/, Promise.all((groupedHooks.post || []).map(function (hook) { return hooks.includes(hook) && hook(data); }))];
+                    case 3:
                         _b.sent();
                         if (!isAlive(store)) {
                             return [2 /*return*/];
@@ -479,11 +496,13 @@ var Form = /** @class */ (function (_super) {
         var _a = this.props, store = _a.store, onReset = _a.onReset;
         store.reset(onReset);
     };
-    Form.prototype.addHook = function (fn, type) {
+    Form.prototype.addHook = function (fn, type, enforce) {
         var _this = this;
         if (type === void 0) { type = 'validate'; }
         this.hooks[type] = this.hooks[type] || [];
-        this.hooks[type].push(type === 'flush' ? fn : promisify(fn));
+        var hook = type === 'flush' ? fn : promisify(fn);
+        hook.__enforce = enforce;
+        this.hooks[type].push(hook);
         return function () {
             _this.removeHook(fn, type);
             fn = noop;
@@ -534,9 +553,11 @@ var Form = /** @class */ (function (_super) {
                             return [2 /*return*/];
                         }
                         diff = difference(store.data, store.pristine);
-                        if (skipIfNothingChanges && !Object.keys(diff).length) {
+                        if (skipIfNothingChanges &&
+                            (!Object.keys(diff).length || isEqual(store.data, this.emittedData))) {
                             return [2 /*return*/];
                         }
+                        this.emittedData = store.data;
                         changeProps = [store.data, diff, this.props];
                         return [4 /*yield*/, dispatchEvent('change', createObject(data, store.data))];
                     case 1:
@@ -656,7 +677,7 @@ var Form = /** @class */ (function (_super) {
                         if ((dispatcher === null || dispatcher === void 0 ? void 0 : dispatcher.prevented) || submitEvent) {
                             return [2 /*return*/];
                         }
-                        store.setCurrentAction(action);
+                        store.setCurrentAction(action, this.props.resolveDefinitions);
                         if (action.actionType === 'reset-and-submit') {
                             store.reset(this.handleReset(action));
                         }
@@ -692,10 +713,28 @@ var Form = /** @class */ (function (_super) {
                                                     this.reloadTarget(filterTarget(action.target, values), values);
                                             }
                                             else if (action.actionType === 'dialog') {
-                                                store.openDialog(data, undefined, action.callback, delegate || this.context);
+                                                return [2 /*return*/, new Promise(function (resolve) {
+                                                        store.openDialog(data, undefined, function (confirmed, value) {
+                                                            var _a;
+                                                            (_a = action.callback) === null || _a === void 0 ? void 0 : _a.call(action, confirmed, value);
+                                                            resolve({
+                                                                confirmed: confirmed,
+                                                                value: value
+                                                            });
+                                                        }, delegate || _this.context);
+                                                    })];
                                             }
                                             else if (action.actionType === 'drawer') {
-                                                store.openDrawer(data);
+                                                return [2 /*return*/, new Promise(function (resolve) {
+                                                        store.openDrawer(data, undefined, function (confirmed, value) {
+                                                            var _a;
+                                                            (_a = action.callback) === null || _a === void 0 ? void 0 : _a.call(action, confirmed, value);
+                                                            resolve({
+                                                                confirmed: confirmed,
+                                                                value: value
+                                                            });
+                                                        });
+                                                    })];
                                             }
                                             else if (isEffectiveApi(action.api || api, values)) {
                                                 finnalAsyncApi_1 = action.asyncApi || asyncApi;
@@ -818,27 +857,45 @@ var Form = /** @class */ (function (_super) {
                             })];
                     case 8:
                         if (action.type === 'reset' || action.actionType === 'reset') {
-                            store.setCurrentAction(action);
+                            store.setCurrentAction(action, this.props.resolveDefinitions);
                             store.reset(onReset);
                         }
                         else if (action.actionType === 'clear') {
-                            store.setCurrentAction(action);
+                            store.setCurrentAction(action, this.props.resolveDefinitions);
                             store.clear(onReset);
                         }
                         else if (action.actionType === 'validate') {
-                            store.setCurrentAction(action);
+                            store.setCurrentAction(action, this.props.resolveDefinitions);
                             return [2 /*return*/, this.validate(true, throwErrors, true, true)];
                         }
                         else if (action.actionType === 'dialog') {
-                            store.setCurrentAction(action);
-                            store.openDialog(data, undefined, action.callback, delegate || this.context);
+                            store.setCurrentAction(action, this.props.resolveDefinitions);
+                            return [2 /*return*/, new Promise(function (resolve) {
+                                    store.openDialog(data, undefined, function (confirmed, value) {
+                                        var _a;
+                                        (_a = action.callback) === null || _a === void 0 ? void 0 : _a.call(action, confirmed, value);
+                                        resolve({
+                                            confirmed: confirmed,
+                                            value: value
+                                        });
+                                    }, delegate || _this.context);
+                                })];
                         }
                         else if (action.actionType === 'drawer') {
-                            store.setCurrentAction(action);
-                            store.openDrawer(data);
+                            store.setCurrentAction(action, this.props.resolveDefinitions);
+                            return [2 /*return*/, new Promise(function (resolve) {
+                                    store.openDrawer(data, undefined, function (confirmed, value) {
+                                        var _a;
+                                        (_a = action.callback) === null || _a === void 0 ? void 0 : _a.call(action, confirmed, value);
+                                        resolve({
+                                            confirmed: confirmed,
+                                            value: value
+                                        });
+                                    });
+                                })];
                         }
                         else if (action.actionType === 'ajax') {
-                            store.setCurrentAction(action);
+                            store.setCurrentAction(action, this.props.resolveDefinitions);
                             if (!isEffectiveApi(action.api)) {
                                 return [2 /*return*/, env.alert(__("\u5F53 actionType \u4E3A ajax \u65F6\uFF0C\u8BF7\u8BBE\u7F6E api \u5C5E\u6027"))];
                             }
@@ -890,7 +947,7 @@ var Form = /** @class */ (function (_super) {
                                 })];
                         }
                         else if (action.actionType === 'reload') {
-                            store.setCurrentAction(action);
+                            store.setCurrentAction(action, this.props.resolveDefinitions);
                             if (action.target) {
                                 this.reloadTarget(filterTarget(action.target, data), data);
                             }
@@ -935,7 +992,7 @@ var Form = /** @class */ (function (_super) {
             targets[0].props.type === 'form') {
             this.handleBulkChange(values[0], false);
         }
-        store.closeDialog(true);
+        store.closeDialog(true, values);
     };
     Form.prototype.handleDialogClose = function (confirmed) {
         if (confirmed === void 0) { confirmed = false; }
@@ -952,7 +1009,7 @@ var Form = /** @class */ (function (_super) {
             onChange &&
                 onChange(store.data, difference(store.data, store.pristine), this.props);
         }
-        store.closeDrawer(true);
+        store.closeDrawer(true, values);
     };
     Form.prototype.handleDrawerClose = function () {
         var store = this.props.store;
@@ -975,7 +1032,7 @@ var Form = /** @class */ (function (_super) {
                 type: 'button',
                 actionType: 'dialog',
                 dialog: dialog
-            });
+            }, _this.props.resolveDefinitions);
             store.openDialog(ctx, undefined, function (confirmed) {
                 resolve(confirmed);
             }, _this.context);
@@ -1116,14 +1173,14 @@ var Form = /** @class */ (function (_super) {
         return render("".concat(region ? "".concat(region, "/") : '').concat(key), subSchema, subProps);
     };
     Form.prototype.renderBody = function () {
-        var _a = this.props, body = _a.body, mode = _a.mode, className = _a.className, cx = _a.classnames, debug = _a.debug, debugConfig = _a.debugConfig, $path = _a.$path, store = _a.store, columnCount = _a.columnCount, render = _a.render, staticClassName = _a.staticClassName, _b = _a.static, isStatic = _b === void 0 ? false : _b, loadingConfig = _a.loadingConfig, testid = _a.testid;
+        var _a = this.props, body = _a.body, mode = _a.mode, className = _a.className, cx = _a.classnames, debug = _a.debug, debugConfig = _a.debugConfig, $path = _a.$path, store = _a.store, columnCount = _a.columnCount, render = _a.render, staticClassName = _a.staticClassName, _b = _a.static, isStatic = _b === void 0 ? false : _b, loadingConfig = _a.loadingConfig; _a.testid;
         var restError = store.restError;
         var WrapperComponent = this.props.wrapperComponent ||
             (/(?:\/|^)form\//.test($path) ? 'div' : 'form');
         var padDom = repeatCount(columnCount && Array.isArray(body)
             ? (columnCount - (body.length % columnCount)) % columnCount
             : 0, function (index) { return (React.createElement("div", { className: cx("Form-item Form-item--".concat(mode, " is-placeholder")), key: index })); });
-        return (React.createElement(WrapperComponent, __assign({ className: cx("Form", "Form--".concat(mode || 'normal'), columnCount ? "Form--column Form--column-".concat(columnCount) : null, staticClassName && isStatic ? staticClassName : className, isStatic ? 'Form--isStatic' : null), onSubmit: this.handleFormSubmit, noValidate: true }, buildTestId(testid)),
+        return (React.createElement(WrapperComponent, { className: cx("Form", "Form--".concat(mode || 'normal'), columnCount ? "Form--column Form--column-".concat(columnCount) : null, staticClassName && isStatic ? staticClassName : className, isStatic ? 'Form--isStatic' : null), onSubmit: this.handleFormSubmit, noValidate: true },
             React.createElement("input", { type: "submit", style: { display: 'none' } }),
             debug
                 ? render('form-debug-json', __assign({ type: 'json', value: store.data, ellipsisThreshold: 120, className: cx('Form--debug') }, debugConfig))

package/esm/renderers/Item.d.ts

@@ -292,6 +292,62 @@ export interface FormBaseControl extends BaseSchemaWithoutType {
      * 远端校验表单项接口
      */
     validateApi?: string | BaseApiObject;
+    /**
+     * 自动填充，当选项被选择的时候，将选项中的其他值同步设置到表单内。
+     *
+     */
+    autoFill?: {
+        [propName: string]: string;
+    } | {
+        /**
+         * 是否为参照录入模式，参照录入会展示候选值供用户选择，而不是直接填充。
+         */
+        showSuggestion?: boolean;
+        /**
+         * 自动填充 api
+         */
+        api?: BaseApiObject | string;
+        /**
+         * 是否展示数据格式错误提示，默认为不展示
+         * @default true
+         */
+        silent?: boolean;
+        /**
+         * 填充时的数据映射
+         */
+        fillMappinng?: {
+            [propName: string]: any;
+        };
+        /**
+         * 触发条件，默认为 change
+         */
+        trigger?: 'change' | 'foucs';
+        /**
+         * 弹窗方式，当为参照录入时用可以配置
+         */
+        mode?: 'popOver' | 'dialog' | 'drawer';
+        /**
+         * 当参照录入为抽屉时可以配置弹出位置
+         */
+        position?: string;
+        /**
+         * 当为参照录入时可以配置弹出容器的大小
+         */
+        size?: string;
+        /**
+         * 参照录入展示的项
+         */
+        columns?: Array<any>;
+        /**
+         * 参照录入时的过滤条件
+         */
+        filter?: any;
+    };
+    /**
+     * @default fillIfNotSet
+     * 初始化时是否把其他字段同步到表单内部。
+     */
+    initAutoFill?: boolean | 'fillIfNotSet';
 }
 export interface FormItemBasicConfig extends Partial<RendererConfig> {
     type?: string;
@@ -338,7 +394,7 @@ export interface FormItemProps extends RendererProps {
     onBulkChange?: (values: {
         [propName: string]: any;
     }, submitOnChange?: boolean) => void;
-    addHook: (fn: Function, mode?: 'validate' | 'init' | 'flush') => () => void;
+    addHook: (fn: Function, mode?: 'validate' | 'init' | 'flush', enforce?: 'prev' | 'post') => () => void;
     removeHook: (fn: Function, mode?: 'validate' | 'init' | 'flush') => void;
     renderFormItems: (schema: Partial<FormSchemaBase>, region: string, props: any) => JSX.Element;
     onFocus: (e: any) => void;
@@ -361,7 +417,6 @@ export interface FormItemProps extends RendererProps {
     };
     error?: string;
     showErrorMsg?: boolean;
-    testid?: string;
 }
 export type FormControlProps = RendererProps & {
     onOpenDialog: (schema: Schema, data: any) => Promise<any>;
@@ -372,24 +427,29 @@ export interface FormItemConfig extends FormItemBasicConfig {
     component: FormControlComponent;
 }
 export declare class FormItemWrap extends React.Component<FormItemProps> {
-    reaction: Array<() => void>;
     lastSearchTerm: any;
     target: HTMLElement;
+    mounted: boolean;
+    initedOptionFilled: boolean;
+    initedApiFilled: boolean;
+    toDispose: Array<() => void>;
     constructor(props: FormItemProps);
-    componentDidUpdate(prevProps: FormItemProps): void;
     componentDidMount(): void;
+    componentDidUpdate(prevProps: FormItemProps): void;
     componentWillUnmount(): void;
     handleFocus(e: any): void;
     handleBlur(e: any): void;
     handleAutoFill(type: string): void;
     updateAutoFillData(context: any): void;
-    syncAutoFill: import("lodash").DebouncedFunc<(term: any, reload?: boolean) => void>;
-    buildSchema(): React.JSX.Element | {
+    syncApiAutoFill: import("lodash").DebouncedFunc<(term: any, forceLoad?: boolean, skipIfExits?: any) => Promise<void>>;
+    syncOptionAutoFill(selectedOptions: Array<any>, skipIfExits?: boolean): void;
+    buildAutoFillSchema(): React.JSX.Element | {
         type: any;
         className: string;
         title: any;
         size: any;
         body: {
+            wrapWithPanel: boolean;
             type: string;
             title: string;
             className: string;
@@ -496,7 +556,9 @@ export declare function asFormItem(config: Omit<FormItemConfig, 'component'>): (
     contextType: React.Context<{
         storeType: string;
     } & import("mobx-state-tree/dist/internal").NonEmptyObject & {
-        readonly fetcher: any;
+        readonly fetcher: any; /**
+         * 显示一个小图标, 鼠标放上去的时候显示提示内容, 这个小图标跟 label 在一起
+         */
         readonly notify: any;
         readonly isCancel: (value: any) => boolean;
         readonly __: import("..").TranslateFn<any>;
@@ -513,12 +575,11 @@ export declare function asFormItem(config: Omit<FormItemConfig, 'component'>): (
             readonly hasChildren: boolean;
             readonly children: any[];
         } & {
-            onChildStoreDispose(child: any): void;
+            onChildStoreDispose(child: any): void; /**
+             * 字段名，表单提交时的 key，支持多层级，用.连接，如： a.b.c
+             */
             syncProps(props: any, prevProps: any, list?: string[]): void;
             dispose: (callback?: (() => void) | undefined) => void;
-            /**
-             * 配置当前表单项展示模式
-             */
             addChildId: (id: string) => void;
             removeChildId: (id: string) => void;
         } & import("mobx-state-tree").IStateTreeNode<import("mobx-state-tree").IModelType<{
@@ -534,18 +595,14 @@ export declare function asFormItem(config: Omit<FormItemConfig, 'component'>): (
             readonly hasChildren: boolean;
             readonly children: any[];
         } & {
-            onChildStoreDispose(child: any): void;
+            onChildStoreDispose(child: any): void; /**
+             * 字段名，表单提交时的 key，支持多层级，用.连接，如： a.b.c
+             */
             syncProps(props: any, prevProps: any, list?: string[]): void;
             dispose: (callback?: (() => void) | undefined) => void;
-            /**
-             * 配置当前表单项展示模式
-             */
             addChildId: (id: string) => void;
             removeChildId: (id: string) => void;
         }, import("mobx-state-tree")._NotCustomized, import("mobx-state-tree")._NotCustomized>>;
-        /**
-         * @deprecated 用 description 代替
-         */
         readonly stores: {
             [propName: string]: {
                 id: string;
@@ -560,12 +617,11 @@ export declare function asFormItem(config: Omit<FormItemConfig, 'component'>): (
                 readonly hasChildren: boolean;
                 readonly children: any[];
             } & {
-                onChildStoreDispose(child: any): void;
+                onChildStoreDispose(child: any): void; /**
+                 * 字段名，表单提交时的 key，支持多层级，用.连接，如： a.b.c
+                 */
                 syncProps(props: any, prevProps: any, list?: string[]): void;
                 dispose: (callback?: (() => void) | undefined) => void;
-                /**
-                 * 配置当前表单项展示模式
-                 */
                 addChildId: (id: string) => void;
                 removeChildId: (id: string) => void;
             } & import("mobx-state-tree").IStateTreeNode<import("mobx-state-tree").IModelType<{
@@ -581,12 +637,11 @@ export declare function asFormItem(config: Omit<FormItemConfig, 'component'>): (
                 readonly hasChildren: boolean;
                 readonly children: any[];
             } & {
-                onChildStoreDispose(child: any): void;
+                onChildStoreDispose(child: any): void; /**
+                 * 字段名，表单提交时的 key，支持多层级，用.连接，如： a.b.c
+                 */
                 syncProps(props: any, prevProps: any, list?: string[]): void;
                 dispose: (callback?: (() => void) | undefined) => void;
-                /**
-                 * 配置当前表单项展示模式
-                 */
                 addChildId: (id: string) => void;
                 removeChildId: (id: string) => void;
             }, import("mobx-state-tree")._NotCustomized, import("mobx-state-tree")._NotCustomized>>;
@@ -611,12 +666,11 @@ export declare function asFormItem(config: Omit<FormItemConfig, 'component'>): (
             readonly hasChildren: boolean;
             readonly children: any[];
         } & {
-            onChildStoreDispose(child: any): void;
+            onChildStoreDispose(child: any): void; /**
+             * 字段名，表单提交时的 key，支持多层级，用.连接，如： a.b.c
+             */
             syncProps(props: any, prevProps: any, list?: string[]): void;
             dispose: (callback?: (() => void) | undefined) => void;
-            /**
-             * 配置当前表单项展示模式
-             */
             addChildId: (id: string) => void;
             removeChildId: (id: string) => void;
         } & import("mobx-state-tree").IStateTreeNode<import("mobx-state-tree").IModelType<{
@@ -632,12 +686,11 @@ export declare function asFormItem(config: Omit<FormItemConfig, 'component'>): (
             readonly hasChildren: boolean;
             readonly children: any[];
         } & {
-            onChildStoreDispose(child: any): void;
+            onChildStoreDispose(child: any): void; /**
+             * 字段名，表单提交时的 key，支持多层级，用.连接，如： a.b.c
+             */
             syncProps(props: any, prevProps: any, list?: string[]): void;
             dispose: (callback?: (() => void) | undefined) => void;
-            /**
-             * 配置当前表单项展示模式
-             */
             addChildId: (id: string) => void;
             removeChildId: (id: string) => void;
         }, import("mobx-state-tree")._NotCustomized, import("mobx-state-tree")._NotCustomized>>;
@@ -654,12 +707,11 @@ export declare function asFormItem(config: Omit<FormItemConfig, 'component'>): (
             readonly hasChildren: boolean;
             readonly children: any[];
         } & {
-            onChildStoreDispose(child: any): void;
+            onChildStoreDispose(child: any): void; /**
+             * 字段名，表单提交时的 key，支持多层级，用.连接，如： a.b.c
+             */
             syncProps(props: any, prevProps: any, list?: string[]): void;
             dispose: (callback?: (() => void) | undefined) => void;
-            /**
-             * 配置当前表单项展示模式
-             */
             addChildId: (id: string) => void;
             removeChildId: (id: string) => void;
         } & import("mobx-state-tree").IStateTreeNode<import("mobx-state-tree").IModelType<{
@@ -675,19 +727,20 @@ export declare function asFormItem(config: Omit<FormItemConfig, 'component'>): (
             readonly hasChildren: boolean;
             readonly children: any[];
         } & {
-            onChildStoreDispose(child: any): void;
+            onChildStoreDispose(child: any): void; /**
+             * 字段名，表单提交时的 key，支持多层级，用.连接，如： a.b.c
+             */
             syncProps(props: any, prevProps: any, list?: string[]): void;
             dispose: (callback?: (() => void) | undefined) => void;
-            /**
-             * 配置当前表单项展示模式
-             */
             addChildId: (id: string) => void;
             removeChildId: (id: string) => void;
         }, import("mobx-state-tree")._NotCustomized, import("mobx-state-tree")._NotCustomized>>): void;
     } & import("mobx-state-tree").IStateTreeNode<import("mobx-state-tree").IModelType<{
         storeType: import("mobx-state-tree").IType<string | undefined, string, string>;
     }, {
-        readonly fetcher: any;
+        readonly fetcher: any; /**
+         * 显示一个小图标, 鼠标放上去的时候显示提示内容, 这个小图标跟 label 在一起
+         */
         readonly notify: any;
         readonly isCancel: (value: any) => boolean;
         readonly __: import("..").TranslateFn<any>;
@@ -704,12 +757,11 @@ export declare function asFormItem(config: Omit<FormItemConfig, 'component'>): (
             readonly hasChildren: boolean;
             readonly children: any[];
         } & {
-            onChildStoreDispose(child: any): void;
+            onChildStoreDispose(child: any): void; /**
+             * 字段名，表单提交时的 key，支持多层级，用.连接，如： a.b.c
+             */
             syncProps(props: any, prevProps: any, list?: string[]): void;
             dispose: (callback?: (() => void) | undefined) => void;
-            /**
-             * 配置当前表单项展示模式
-             */
             addChildId: (id: string) => void;
             removeChildId: (id: string) => void;
         } & import("mobx-state-tree").IStateTreeNode<import("mobx-state-tree").IModelType<{
@@ -725,18 +777,14 @@ export declare function asFormItem(config: Omit<FormItemConfig, 'component'>): (
             readonly hasChildren: boolean;
             readonly children: any[];
         } & {
-            onChildStoreDispose(child: any): void;
+            onChildStoreDispose(child: any): void; /**
+             * 字段名，表单提交时的 key，支持多层级，用.连接，如： a.b.c
+             */
             syncProps(props: any, prevProps: any, list?: string[]): void;
             dispose: (callback?: (() => void) | undefined) => void;
-            /**
-             * 配置当前表单项展示模式
-             */
             addChildId: (id: string) => void;
             removeChildId: (id: string) => void;
         }, import("mobx-state-tree")._NotCustomized, import("mobx-state-tree")._NotCustomized>>;
-        /**
-         * @deprecated 用 description 代替
-         */
         readonly stores: {
             [propName: string]: {
                 id: string;
@@ -751,12 +799,11 @@ export declare function asFormItem(config: Omit<FormItemConfig, 'component'>): (
                 readonly hasChildren: boolean;
                 readonly children: any[];
             } & {
-                onChildStoreDispose(child: any): void;
+                onChildStoreDispose(child: any): void; /**
+                 * 字段名，表单提交时的 key，支持多层级，用.连接，如： a.b.c
+                 */
                 syncProps(props: any, prevProps: any, list?: string[]): void;
                 dispose: (callback?: (() => void) | undefined) => void;
-                /**
-                 * 配置当前表单项展示模式
-                 */
                 addChildId: (id: string) => void;
                 removeChildId: (id: string) => void;
             } & import("mobx-state-tree").IStateTreeNode<import("mobx-state-tree").IModelType<{
@@ -772,12 +819,11 @@ export declare function asFormItem(config: Omit<FormItemConfig, 'component'>): (
                 readonly hasChildren: boolean;
                 readonly children: any[];
             } & {
-                onChildStoreDispose(child: any): void;
+                onChildStoreDispose(child: any): void; /**
+                 * 字段名，表单提交时的 key，支持多层级，用.连接，如： a.b.c
+                 */
                 syncProps(props: any, prevProps: any, list?: string[]): void;
                 dispose: (callback?: (() => void) | undefined) => void;
-                /**
-                 * 配置当前表单项展示模式
-                 */
                 addChildId: (id: string) => void;
                 removeChildId: (id: string) => void;
             }, import("mobx-state-tree")._NotCustomized, import("mobx-state-tree")._NotCustomized>>;
@@ -802,12 +848,11 @@ export declare function asFormItem(config: Omit<FormItemConfig, 'component'>): (
             readonly hasChildren: boolean;
             readonly children: any[];
         } & {
-            onChildStoreDispose(child: any): void;
+            onChildStoreDispose(child: any): void; /**
+             * 字段名，表单提交时的 key，支持多层级，用.连接，如： a.b.c
+             */
             syncProps(props: any, prevProps: any, list?: string[]): void;
             dispose: (callback?: (() => void) | undefined) => void;
-            /**
-             * 配置当前表单项展示模式
-             */
             addChildId: (id: string) => void;
             removeChildId: (id: string) => void;
         } & import("mobx-state-tree").IStateTreeNode<import("mobx-state-tree").IModelType<{
@@ -823,12 +868,11 @@ export declare function asFormItem(config: Omit<FormItemConfig, 'component'>): (
             readonly hasChildren: boolean;
             readonly children: any[];
         } & {
-            onChildStoreDispose(child: any): void;
+            onChildStoreDispose(child: any): void; /**
+             * 字段名，表单提交时的 key，支持多层级，用.连接，如： a.b.c
+             */
             syncProps(props: any, prevProps: any, list?: string[]): void;
             dispose: (callback?: (() => void) | undefined) => void;
-            /**
-             * 配置当前表单项展示模式
-             */
             addChildId: (id: string) => void;
             removeChildId: (id: string) => void;
         }, import("mobx-state-tree")._NotCustomized, import("mobx-state-tree")._NotCustomized>>;
@@ -845,12 +889,11 @@ export declare function asFormItem(config: Omit<FormItemConfig, 'component'>): (
             readonly hasChildren: boolean;
             readonly children: any[];
         } & {
-            onChildStoreDispose(child: any): void;
+            onChildStoreDispose(child: any): void; /**
+             * 字段名，表单提交时的 key，支持多层级，用.连接，如： a.b.c
+             */
             syncProps(props: any, prevProps: any, list?: string[]): void;
             dispose: (callback?: (() => void) | undefined) => void;
-            /**
-             * 配置当前表单项展示模式
-             */
             addChildId: (id: string) => void;
             removeChildId: (id: string) => void;
         } & import("mobx-state-tree").IStateTreeNode<import("mobx-state-tree").IModelType<{
@@ -866,19 +909,20 @@ export declare function asFormItem(config: Omit<FormItemConfig, 'component'>): (
             readonly hasChildren: boolean;
             readonly children: any[];
         } & {
-            onChildStoreDispose(child: any): void;
+            onChildStoreDispose(child: any): void; /**
+             * 字段名，表单提交时的 key，支持多层级，用.连接，如： a.b.c
+             */
             syncProps(props: any, prevProps: any, list?: string[]): void;
             dispose: (callback?: (() => void) | undefined) => void;
-            /**
-             * 配置当前表单项展示模式
-             */
             addChildId: (id: string) => void;
             removeChildId: (id: string) => void;
         }, import("mobx-state-tree")._NotCustomized, import("mobx-state-tree")._NotCustomized>>): void;
     }, import("mobx-state-tree")._NotCustomized, import("mobx-state-tree")._NotCustomized>>>;
     ComposedComponent: React.ComponentType<any>;
 } & hoistNonReactStatic.NonReactStatics<any, {}> & {
-    ComposedComponent: any;
+    ComposedComponent: any; /**
+     * 字段名，表单提交时的 key，支持多层级，用.连接，如： a.b.c
+     */
 } & {
     ComposedComponent: any;
 };