form-driver 0.1.0

package/types/framework/Assembly.d.ts

@@ -0,0 +1,59 @@
+import { ClassType } from "react";
+import { MFieldSchemaAnonymity, MProp, MValidationFail } from './Schema';
+import { MType, PluginType } from "../types/MType";
+export declare type MORPH = "readable" | "editor";
+export declare type VIEWER = ClassType<MProp, any, any>;
+/** 统一的视觉样式 */
+export interface MTheme {
+    /** 数据未知时展示 */
+    readonly READABLE_UNKNOWN: string;
+    /** 数据为空的时候展示 */
+    readonly READABLE_BLANK: string;
+    /** 数据有问题时展示 */
+    readonly READABLE_INVALID: string;
+    /** 代码有问题时展示 */
+    readonly READABLE_ERROR: string;
+    /** @deprecated theme的名字 */
+    readonly themeName: "antMiddle" | string;
+}
+export interface EDITOR {
+    editor: string;
+    type: string;
+    readable: string;
+}
+/**
+ * 注册viewer，type，morph（viewer和type之间的关联）
+ */
+export declare class Assembly {
+    types: {
+        [name: string]: MType;
+    };
+    viewers: {
+        [name: string]: VIEWER;
+    };
+    editors: {
+        [name: string]: EDITOR;
+    };
+    morph: {
+        [name: string]: {
+            [typeName: string]: string | ClassType<MProp, any, any>;
+        };
+    };
+    theme: MTheme;
+    toReadable: (s: MFieldSchemaAnonymity, v: any, parent: any) => string;
+    /** 根据定义返回View，返回nil表示没有可用的View */
+    getViewerOf(f: MFieldSchemaAnonymity, morph: MORPH): ClassType<any, any, any>;
+    validate(s: MFieldSchemaAnonymity, v: any, path?: string): MValidationFail | undefined;
+    addViewer(name: string, v: VIEWER): void;
+    addEditor(name: string, v: EDITOR): void;
+    /**
+     * 增加一种数据类型
+     * 例：
+     *  const hpOrg = {name: "hpOrg", type: {validators: ..., toReadable: ...}, editor: HPOrgEditor, readable: "DivViewer"}
+     *  addType(hpOrg)
+     * @param typeParam 类型的描述对象
+     */
+    addType(typeParam: PluginType): void;
+    constructor();
+}
+export declare const assembly: Assembly;

package/types/framework/Init.d.ts

@@ -0,0 +1,4 @@
+/**
+ * 确保m3已经初始化ensureM3
+ */
+export declare function ensureM3(): void;

package/types/framework/M3.d.ts

@@ -0,0 +1,6 @@
+import React from 'react';
+import { M3Prop } from './MViewer';
+declare const M3: (props: React.PropsWithChildren<M3Prop & {
+    debug?: boolean;
+}>) => JSX.Element;
+export default M3;

package/types/framework/MContext.d.ts

@@ -0,0 +1,11 @@
+import React from 'react';
+import { MViewerProp } from './MViewer';
+export interface MContextDef {
+    /** 根配置 */
+    rootProps: MViewerProp;
+    /** 表单是否是强制校验状态 */
+    forceValid: boolean;
+    /** 将表单设置为强制校验*/
+    setForceValid: (b: boolean) => void;
+}
+export declare const MContext: React.Context<MContextDef>;

package/types/framework/MFieldViewer.d.ts

@@ -0,0 +1,8 @@
+import React from "react";
+import { MProp } from './Schema';
+/**
+ * 一个字段的视图
+ */
+export declare class MFieldViewer extends React.Component<MProp, any> {
+    render(): JSX.Element;
+}

package/types/framework/MUtil.d.ts

@@ -0,0 +1,180 @@
+/// <reference types="react" />
+import moment from "moment";
+import { M3UISpec, MEnumField, MFieldSchema, MFieldSchemaAnonymity, MValidationFail } from './Schema';
+import { JSONSchema6 } from 'json-schema';
+export declare type HideMap = {
+    [fieldName: string]: boolean;
+};
+export declare let MUtil: {
+    /**
+     * 每次调用，返回不一样的数字
+     * @returns
+     */
+    unique(): number;
+    /**
+     * 枚举字段可以写成空格分隔的字符串，也能写成MEnumField[]，这个函数将两种形式转换成统一的MEnumField[]
+     * @deprecated 改成用MUtils.option
+     */
+    standardFields: (fs: string | MEnumField[] | undefined) => MEnumField[];
+    /**
+     * 获取enumFields或者setFields，返回标准的MEnumField[]
+     * @param f 如果f是nil，返回[]
+     */
+    option: (f: MFieldSchemaAnonymity) => MEnumField[];
+    /** 如果出错了，返回这么个元素，可能用在BaseEditor子类或者其他的东西上 */
+    error: (msg: string, schema?: MFieldSchema | MFieldSchemaAnonymity) => JSX.Element;
+    sign: (v: number | null | undefined) => number | null;
+    /**
+     * 当前设备是不是个手机（或者类似手机的设备，比如ipad上运行iphone app中的webview）
+     */
+    phoneLike: () => boolean;
+    /**
+     * 计算文字的宽度
+     * @param text
+     */
+    antdTextWidth(text?: string): number;
+    /**
+     * 从数组中删掉一个元素
+     * @param a 这个数组会被改变的
+     * @param element 要删的元素
+     * @returns 修改后的数组（如果它不是nil）
+     */
+    arrayRemove: (a: any[] | null | undefined, element: any) => any[];
+    fieldOfLayout: (fields: MFieldSchema[], spec: M3UISpec) => MFieldSchema[];
+    /**
+     * 跟lodash的get一样，除了：
+     * 1. path是nil时返回undefined
+     * 2. path是""时返回原始对象
+     * @param a
+     * @param path
+     */
+    get: (a?: any | null, path?: string | null) => any;
+    /**
+     * a : database
+     * v : newValue
+     * 跟lodash的set一样，除了path是""时等效于_.assign(a, v)
+     */
+    set: (a: any | null, path: string | null, v: any) => void;
+    debug: (d: any, ...optionalParams: any[]) => void;
+    /**
+     * 填入默认值
+     * @param schema 你懂得
+     * @param database 数据库，会被修改的
+     * @param path 路径
+     */
+    applyDefaultValue: (schema: MFieldSchema, database: any, path: string) => void;
+    filterHide: (schema: MFieldSchema, database: any[] | object) => any;
+    /**
+     * 计算哪些field、segment需要隐藏
+     * 支持ShowIfFunc里的函数
+     * TODO 如果segment隐藏，里面的字段全都要隐藏
+     * @returns 示例：
+     * let {name,role,gender,alias,birthday,company,position,tel,email,citizenship,politicsCode,companyArch,address,work,edu,assistant,student,mib} = data;
+     * return {politicsCode: !(citizenship=='中国大陆'),"segment:学员信息": !(_.intersection(role, ['校友']).length > 0))}
+     * @param objectFields
+     * @param uispec 用来计算segment是不是要展示，不填就不计算
+     */
+    hideMap: (database: any, objectFields: MFieldSchema[], uispec?: M3UISpec) => HideMap;
+    /**
+     * 计算 showIf 的值
+     * @returns Boolean
+     * @param database
+      * @param objectFields
+     */
+    isShow: (database: any, objectFields: MFieldSchema[], showIfExpr: string) => any;
+    scoreOf: (f: MFieldSchema, database: any) => number;
+    /**
+     * 查找fs依赖（通过showIf）的所有字段
+     * @param fs
+     * @param all
+     * @returns fs依赖的所有字段，包含fs。这个数组中下标小的元素，依赖下标大的元素
+     */
+    dependency: (fs: MFieldSchema[], all: MFieldSchema[]) => any[];
+    /**
+     * 用moment格式化
+     * @param s 原始数据，参见moment
+     * @param srcFormat 原始数据的格式，默认x(时间戳)
+     * @param dstFormat 转换成的数据格式，默认YYYY年MM月DD日
+     * @param fallback 如果原始数据是nil，返回fallback
+     */
+    momentFormat: (s: moment.MomentInput, srcFormat?: string, dstFormat?: string, fallback?: string) => string;
+    /**
+     * 将标准的json schema转换成m3的schema
+     * @param e json schema
+     * @param base 如果填了一个对象，转换出的属性会放在这个对象上
+     * @param template 如果有子结构，创建子结构的模板
+     */
+    jsonSchema2MFieldSchema: (e: JSONSchema6, base?: MFieldSchema, template?: Partial<MFieldSchema>) => MFieldSchema;
+    /**
+     * 修改一个对象里的key
+     * @param object 要修改的对象，
+     * @param renameTo
+     * @param removeNotExistKey 是否在结果里面去除renameTo里不存在的key
+     * @returns 返回一个改过key名字的新对象
+     */
+    renameKey: (object: any, renameTo: {
+        [oldKey: string]: string;
+    }, removeNotExistKey?: boolean) => any;
+    /** 啥也不干的空回调 */
+    doNothing: () => void;
+    /**
+     * 去掉arr中的undefined和null，拼出来一个json path
+     */
+    jsonPath: (...arr: any[]) => string;
+    /**
+     * 获取一个json path的父path。
+     * @param path 如果path是空的返回也是空的
+     */
+    parentPath: (path: string) => string;
+    /**
+     * 校验一个schema
+     * @param s 要校验的schema
+     * @returns 空数组表示校验通过，否则返回校验错误信息
+     */
+    validateSchema: (s: MFieldSchema, parentPath?: string) => MValidationFail[];
+    /**
+     * 参考https://stackoverflow.com/questions/3362471/how-can-i-call-a-javascript-constructor-using-call-or-apply
+     * 示例： var d = applyToConstructor(Date, [2008, 10, 8, 00, 16, 34, 254]);
+     * @param constructor
+     * @param argArray
+     */
+    applyToConstructor: (constructor: any, argArray: any) => any;
+    /**
+     * 执行表达式或者回调函数
+     * @param exprOrFunction 表达式或者回调函数
+     * @param paramName 参数名字
+     * @param paramValue 参数值
+     * @param fallback 如果exprOrFunction无效，返回fallback
+     * @param _this this指针
+     */
+    evalExprOrFunction: (exprOrFunction: any, paramName: string[], paramValue: any[], fallback?: any, _this?: any) => any;
+    /**
+     * 读取url参数，转换成map
+     * @param hashPrefix nil表示不读取hash里的参数，字符串表示读取hash里的参数，并加上这个前缀返回。默认是返回，但前缀是空字符串
+     */
+    getQuery: (hashPrefix?: string) => any;
+    /**
+     * 动态创建一个CSS样式
+     * @param css css内容，会被写进style标签里
+     * @param id <style>的id，可以没有。如果已经存在，会被覆盖掉。
+     */
+    setCss: (css: string, id?: string) => void;
+    /**
+     * escape数值
+     * @param str - 字符串
+     * @returns 会带上引号，类似"abc"，str=nil时会返回""
+     */
+    escapeCsv: (str?: string) => string;
+    /**
+     * 判断两个值是否相同
+     * @param v1 一个值
+     * @param v2 另一个值
+     * @param tolerate true用==判断，false用===判断
+     */
+    isEquals: (v1: any, v2: any, tolerate: boolean) => boolean;
+};
+/** 压缩数组，如果只有一个元素时，它是数据本身，多于一个元素时才是数组 */
+export declare type CompactArrayType<T> = T | T[];
+export declare let CompactArray: {
+    indexOf: <T>(ca?: CompactArrayType<T>, d?: T) => -1 | number;
+};

package/types/framework/MViewer.d.ts

@@ -0,0 +1,75 @@
+import React from "react";
+import { AFTER_CHANGE_CALLBACK, MFieldSchema, M3UISpec } from "../framework/Schema";
+import "./MViewer.less";
+import { MORPH } from './Assembly';
+import { PersistantConf } from "./Persistant";
+export interface MViewerProp {
+    schema: MFieldSchema;
+    database: any;
+    layout?: M3UISpec;
+    style?: React.CSSProperties;
+    morph: MORPH;
+    onSubmit?: (finalData: any) => Promise<any>;
+    afterChange?: AFTER_CHANGE_CALLBACK;
+    wrapper?: (elem: React.ReactElement, schema: Partial<MFieldSchema>) => React.ReactElement;
+    formItemWrapper?: (elem: React.ReactElement, schema: Partial<MFieldSchema>) => React.ReactElement;
+    /** 持久存储选项，nil表示不持久存储 */
+    persistant?: PersistantConf;
+}
+export interface M3Prop {
+    schema: MFieldSchema | MFieldSchema[];
+    database: any;
+    layout?: M3UISpec;
+    style?: React.CSSProperties;
+    morph: MORPH;
+    onSubmit?: (finalData: any) => Promise<any>;
+    afterChange?: AFTER_CHANGE_CALLBACK;
+    wrapper?: (elem: React.ReactElement, schema: Partial<MFieldSchema>) => React.ReactElement;
+    formItemWrapper?: (elem: React.ReactElement, schema: Partial<MFieldSchema>) => React.ReactElement;
+    /** 持久存储选项，nil表示不持久存储 */
+    persistant?: PersistantConf;
+}
+interface State {
+    forceValid: boolean;
+    ctrlVersion: number;
+}
+/**
+ * 一个完整的表单
+ */
+export declare class MViewer extends React.Component<MViewerProp, State> {
+    database: any;
+    constructor(p: MViewerProp);
+    recover(): void;
+    render(): JSX.Element;
+}
+/**
+ * 提交按钮
+  示例1，使用默认的提交样式：
+  <MViewer schema={schema} database={database} morph="editor">
+    <SubmitBar onSubmit={(d:any) => ...返回一个Promise} />
+  </MViewer>
+
+  示例2，自定义样式：
+  <MViewer schema={schema} database={database} morph="editor">
+    <SubmitBar onSubmit={(d:any) => ...返回一个Promise} >
+      <Button>提交</Button>
+    </SubmitBar>
+  </MViewer>
+
+  示例3，提交完成前，禁用提交按钮：
+  <MViewer schema={schema} database={database} morph="editor">
+    <SubmitBar onSubmit={(d:any) => ...返回一个Promise} >
+      {
+        loading => <Button loading={loading}>提交</Button>
+      }
+    </SubmitBar>
+  </MViewer>
+ * @param props
+ */
+export declare function SubmitBar(props: {
+    style?: React.CSSProperties;
+    onSubmit?: (finalData: any) => Promise<any>;
+    children?: React.ReactNode | ((loading: boolean) => React.ReactNode);
+}): JSX.Element;
+export declare function useM3Database(initValue: any): [any, React.Dispatch<any>];
+export {};

package/types/framework/MViewerDebug.d.ts

@@ -0,0 +1,11 @@
+import React from "react";
+import { MViewerProp } from './MViewer';
+/**
+ * 调试和理解MViewer，使用时除了多一个debug props，完全和MViewer一样
+ * debug=true时，通过tab同时展示viewer及其database和schema
+ * debug=false时，仅展示viewer
+ * @param props 用来调试viewer
+ */
+export declare function MViewerDebug(props: React.PropsWithChildren<MViewerProp & {
+    debug?: boolean;
+}>): JSX.Element;

package/types/framework/Persistant.d.ts

@@ -0,0 +1,17 @@
+import { AFTER_CHANGE_CALLBACK } from "./Schema";
+/**
+ * MViewer的配置
+ */
+export interface PersistantConf {
+    /** 持久存储的localStorageKey前缀 */
+    localStorageKeyPrefix: string;
+    /** 是否询问恢复至缓存 */
+    useConfirm?: Boolean;
+    /** 如何合并database和persistant数据，默认是local覆盖database */
+    override?: (database: any, local: any) => void;
+}
+export declare const PersistantTool: {
+    load: (database: any, persistant?: PersistantConf, updateViewer?: any) => void;
+    patchAfterChange: (afterChange: AFTER_CHANGE_CALLBACK, persistant?: PersistantConf) => AFTER_CHANGE_CALLBACK;
+    clear: (persistant?: PersistantConf) => void;
+};

package/types/framework/Schema.d.ts

@@ -0,0 +1,306 @@
+/// <reference types="react" />
+import { MORPH, VIEWER, Assembly } from './Assembly';
+export declare type ValueConst = string | boolean | number;
+export interface MEnumField {
+    /** 选项文案 */
+    label?: string;
+    /** 选项html */
+    html?: string;
+    /** 选项的showIf */
+    showIf?: boolean;
+    /** 选项html */
+    value: ValueConst;
+    exclusive?: string;
+    score?: number;
+    children?: MEnumField[];
+}
+/** 匿名的MFieldSchema，没有name字段 */
+export declare type MFieldSchemaAnonymity = Omit<MFieldSchema, "name">;
+/** JS表达式 */
+export declare type JSEXPR = string;
+/** 如何适配屏幕 */
+export declare type SCREEN_ADAPTION = 
+/** 强制使用适应大屏的控件 */
+"big" | 
+/** 强制使用适应小屏的控件 */
+"phone";
+/** M3 单元的 schema */
+export interface MFieldSchema {
+    type?: string;
+    name: string;
+    label?: string;
+    /** 编辑器，editor:<viewer名字> 是 viewerFor: {morph:"editor", name:<viewer名字>} 的简写 */
+    editor?: string | VIEWER;
+    /** 查看器，readable:<viewer名字> 是 viewerFor: {morph:"readable", name:<viewer名字>} 的简写 */
+    readable?: string | VIEWER;
+    /** 选项 */
+    option?: MEnumField[] | string;
+    /** @deprecated 旧版本字段，新版本用 options */
+    enumFields?: string | MEnumField[];
+    /** @deprecated 旧版本字段，新版本用 options */
+    setFields?: string | MEnumField[];
+    /** 如果选项是不完全的，要设置这个值，允许用户自己输入 */
+    openOption?: MFieldSchemaAnonymity;
+    /** @deprecated 旧版本字段，新版本用 openOption */
+    enumOpen?: MFieldSchemaAnonymity;
+    /** @deprecated 旧版本字段，新版本用 openOption */
+    setOpen?: MFieldSchemaAnonymity;
+    /**
+     * 默认值
+     * object上设置defaultValue后，其字段的defaultValue就无效了
+     */
+    defaultValue?: ValueConst;
+    /**
+     * 表单控件的属性（对应 antd 组件的 api）
+     */
+    props?: any;
+    /** 最多输入多少行，默认1，表示单行字符串 */
+    stringLines?: number;
+    /** 最小值/最小长度/至少选几项 (include) */
+    min?: number;
+    /** 最大值/最大长度/最多选几项 (include) */
+    max?: number;
+    /** 是否是必选项 */
+    required?: boolean;
+    /** 当表达式成立时认为表单中有这个字段，不成立时字段不展示，也不会输出数据 */
+    showIf?: JSEXPR;
+    /** 分栏数 */
+    column?: number;
+    /** 展示前格式化值。
+     * string=js模板字符串，可用变量包括:
+     *    value是数据值
+     *    _ 是lodash
+     *    readable是原来默认的toReadable函数转换后的字符串
+     *    READABLE_UNKNOWN/READABLE_BLANK/READABLE_INVALID/READABLE_ERROR：这些值参考MTheme
+     * 函数=就不用解释了，自己可以随意发挥了
+     */
+    toReadable?: string | ((v: any, parent: any, assembly: Assembly) => string);
+    /**
+     * true表示值不是严格匹配
+     * 例如枚举的value是number时，传入字符串也可以匹配
+     */
+    tolerate?: boolean;
+    /** 是否强制使用大屏或者小屏的控件，默认是自动 */
+    screenAdaption?: SCREEN_ADAPTION;
+    /** 展示时显示的后缀 */
+    postfix?: string;
+    /** 会展示为一个问号图标，点击弹出提示 */
+    popoverDesc?: React.ReactNode;
+    /** undefined表示 这个字段不是必填的，否则表示此字段不填时的提示信息*/
+    requiredMessage?: string;
+    /** 有的字段是多个框，可能需要多个placeholder */
+    placeholder?: string | string[];
+    objectFields?: MFieldSchema[];
+    /** 对象类型中，哪些字段作为标题展示成readable，默认是第一个字段 */
+    objectLabelFields?: string[];
+    /** 字符串是不是允许全部填空格/t/n，默认不允许 */
+    stringAllowSpaceOnly?: boolean;
+    /** 矩阵类型的配置 */
+    matrix?: {
+        /** 矩阵的横轴选项 */
+        x: string | MEnumField[];
+        /** 矩阵的纵轴选项 */
+        y: string | MEnumField[];
+        /** 每行最多选几个，默认1 */
+        maxX?: number;
+        /** 每行最少选几个，默认1 */
+        minX?: number;
+        /** 每列最多选几个，默认无限多个 */
+        maxY?: number;
+        /** 每列最少选几个，默认1 */
+        minY?: number;
+        /** 开放项的配置，开放项是y轴最后一个选项 */
+        open?: {
+            label: string;
+        };
+    };
+    /** 数组成员类型 */
+    arrayMember?: MFieldSchemaAnonymity;
+    /** 数组增加一项的按钮文案 */
+    arrayAddLabel?: string;
+    /** experience类型配置 */
+    experience?: {
+        /** 除了起始时间，至今选项外，还要有什么字段 */
+        members: MFieldSchema[];
+        /** 允许时间段重叠，默认是不能重叠 */
+        overlap?: boolean;
+    };
+    /** dateRange 类型配置 */
+    dateRange?: {
+        /** 是否隐藏至今按钮 */
+        hideTillNow?: boolean;
+        /** 是否能选择时间 */
+        showTime?: boolean;
+    };
+    /** 数据格式 */
+    dataFormat?: "x" | "YYYYMMDD" | /** 用于时间日期类型字段的数据格式，参考moment，例如x表示数据是时间戳，YYYYMMDD表示数据是形如19990130的字符串 */ string;
+    /**
+     * 例如：
+     * 4.5 与去年同期(2019 年 1 月初-6 月底)相比，您的收入
+     * (1)增长了约___万元 (2)下降了约___万元 (3)基本没有变化
+     */
+    intDiff?: {
+        incLabel: string;
+        incLabelPostfix: string;
+        decLabel: string;
+        decLabelPostfix: string;
+        keep: string;
+    };
+    /** 可以自己写个样式，会作用于antd元素上 */
+    css?: any;
+    /** 删除这个字段数据时的提示，不写会直接删除，不提示 */
+    removeConfirm?: string;
+    /**
+     * most case size 字段通常有多少个字符(string)/项(array)，或者用css写长度
+     * 布局器会尽量让小于mcs的值可以不需要滚动就展示出来
+     * string/ 最好配上
+     * 不完全enum/不完全set，可以配，默认是最长的候选值的字符数
+     * 完全enum/完全set，不用配
+     */
+    mcs?: number | string;
+    /** ui规约 */
+    uispec?: M3UISpec;
+    /** 用于hpOrg类型*/
+    hpOrg?: {
+        /** 空格表示根 */
+        rootId: string;
+    };
+    ossFile?: {
+        type: "HP_GO" | "HP_SECOBJ";
+        /** 预览大小，单位像素 */
+        previewSize?: number;
+        arguments: {
+            genName: boolean;
+            ossKeyPath: string;
+            permissionPolicyOr: string;
+        } | {
+            appName: string;
+        } | any;
+    };
+    /** 装饰物的html */
+    decoration?: {
+        subType?: "rich" | "segmentLabel" | "submitBar" | "operations";
+        HTML?: string;
+        submitLabel?: string;
+        segmentLabel?: string;
+        operations?: {
+            label: React.ReactNode;
+            handler: (data: any) => void;
+        }[];
+    };
+    /**
+     * 来自远程的数据，用于下拉搜索框.
+     * 例如对于如下远程数据
+     * {
+          "data": {
+              "pagination": {
+                  ...
+              },
+              "list": [
+                  { "id": 33219, "name": "张媛", "brief": "掌阅科技股份有限公司" },
+                  { "id": 86576, "name": "张步镇", "brief": "广州速道信息科技有限公司" }
+              ]
+          }
+      }
+      remote配置示例：
+        remote:{
+          url: ... ,
+          dataPath: "data.list",
+          valuePath: "id",
+          labelExpr: "name + '(' + brief + ')'"
+        }
+     */
+    remote?: {
+        /** 数据url，可以用${q}引用用户输入的查询关键字 */
+        url: string;
+        /** url返回的json中，数据list的路径 */
+        dataPath: string;
+        /** 在dataPath下，值字段路径 */
+        valuePath: JSEXPR;
+        /** 在dataPath下，标题字段的表达式 */
+        labelExpr: JSEXPR;
+    };
+    a?: {
+        urlExpr?: ((value: any, parent: any) => React.ReactNode) | JSEXPR;
+        labelExpr?: ((value: any, parent: any) => React.ReactNode) | JSEXPR;
+        onClick?: (value: any, parent: any) => void;
+        /** 在当前页面打开 */
+        currentPage?: boolean;
+    };
+    /** 元素的style */
+    style?: React.CSSProperties;
+    /** 布局方式，垂直（vertical）、水平（horizontal） */
+    layoutHint?: "v" | "h";
+    /** 其他插件的配置 */
+    options?: any;
+    /** 业务数据 */
+    bizData?: any;
+}
+/**
+ * 数据变化时回调
+ * final=true表示回调是因为类似失去焦点导致的，此后不会再有变化回调
+ * final=false表示回调是因为用户操作导致的，不处理的话也不会导致最终数据不一致，因为后续会有final=true的回调。
+ * 对于暂存表单等比较重的操作，应该仅在final=true时触发，以减少调用次数
+ */
+export declare type AFTER_CHANGE_CALLBACK = (path: string, v: any, final: boolean) => void;
+export interface MProp {
+    /** database的数据描述 */
+    schema: MFieldSchemaAnonymity;
+    /** json格式数据 */
+    database: any;
+    /** 编辑database中的字段路径 */
+    path: string;
+    /** 元素形态 */
+    morph: MORPH;
+    /** database有任何变化时回调 */
+    afterChange?: AFTER_CHANGE_CALLBACK;
+    /** @deprecated 直接上层。有时parent是谁，会影响渲染字段 */
+    parent?: MFieldSchemaAnonymity;
+    /** 强制展示校验信息 */
+    forceValid?: boolean;
+    /**
+     * 要求元素展示删除按钮
+     * true=父元素是array(或object），要求子元素展示删除按钮
+     * false=父元素是array(或object），子元素可以展示删除按钮，但disable
+     * undefined=子元素不能展示删除按钮
+     */
+    removeButton?: boolean;
+    /** 禁用元素 */
+    disable?: boolean;
+    /** 是否隐藏边框，例如在表格中就不需要边框 */
+    hideBorder?: boolean;
+    /** 额外的控件，比如AArrayGrid里加个按钮 */
+    extra?: JSX.Element;
+    style?: React.CSSProperties;
+    className?: string;
+}
+export interface M3UISpecSegmentItem {
+    label: string;
+    fields: string[];
+    showIf?: string;
+    name?: string;
+    /** 如果要支持分段编辑提交，要设置此回调 */
+    onSubmit?: (segment: M3UISpecSegmentItem, segmentData: any, done: () => void) => void;
+    /** 设置分段根元素的style */
+    style?: React.CSSProperties;
+}
+export interface M3UISpec {
+    type: "segmentForm" | "stepForm" | "flowForm";
+    layout: "horizontal" | "vertical";
+    comma?: string;
+    labelAlign?: "left" | "right";
+    segments?: M3UISpecSegmentItem[];
+}
+export interface MValidationFail {
+    /** 错误信息，空字符串表示因为子元素错误导致的，因为子元素已经展示错误了，父元素就不需要再展示了 */
+    message: string;
+    /** 数据的路径 */
+    path: string;
+}
+/**
+ * 校验结果
+ * MValidationFail: 校验直接失败，不再经过下一个校验器
+ * pass: 直接通过校验，不再经过下一个校验器了（例如 required=false时，数值是nil, 可以直接pass，否则之后的校验器都要处理nil）
+ * undefined: 表示让下一个校验器再校验
+ */
+export declare type MValidationResult = MValidationFail | "pass" | undefined;