@hi-ui/form 4.0.0-alpha.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2018 Xiaomi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,11 @@
+# `@hi-ui/form`
+
+> TODO: description
+
+## Usage
+
+```
+const Form = require('@hi-ui/form');
+
+// TODO: DEMONSTRATE API
+```

package/lib/cjs/Form.js

@@ -0,0 +1,106 @@
+/** @LICENSE
+ * @hi-ui/form
+ * https://github.com/XiaoMi/hiui/tree/master/packages/ui/form#readme
+ *
+ * Copyright (c) HIUI <mi-hiui@xiaomi.com>.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+'use strict';
+
+var _typeof = require("@babel/runtime/helpers/typeof");
+
+Object.defineProperty(exports, '__esModule', {
+  value: true
+});
+
+var tslib = require('tslib');
+
+var React = require('react');
+
+var classname = require('@hi-ui/classname');
+
+var env = require('@hi-ui/env');
+
+var context = require('./context.js');
+
+var useForm = require('./use-form.js');
+
+function _interopDefaultLegacy(e) {
+  return e && _typeof(e) === 'object' && 'default' in e ? e : {
+    'default': e
+  };
+}
+
+var React__default = /*#__PURE__*/_interopDefaultLegacy(React);
+
+var _role = 'form';
+
+var _prefix = classname.getPrefixCls(_role); // form 注册表
+
+
+var FORM_REGISTER_TABLE = {};
+/**
+ * TODO: What is Form
+ */
+
+var Form = /*#__PURE__*/React.forwardRef(function (_a, ref) {
+  var _a$prefixCls = _a.prefixCls,
+      prefixCls = _a$prefixCls === void 0 ? _prefix : _a$prefixCls,
+      _a$role = _a.role,
+      role = _a$role === void 0 ? _role : _a$role,
+      className = _a.className,
+      children = _a.children,
+      labelWidth = _a.labelWidth,
+      _a$labelPlacement = _a.labelPlacement,
+      labelPlacement = _a$labelPlacement === void 0 ? 'right' : _a$labelPlacement,
+      colon = _a.colon,
+      rest = tslib.__rest(_a, ["prefixCls", "role", "className", "children", "innerRef", "labelWidth", "labelPlacement", "placement", "verticalAlign", "colon"]);
+
+  var formContext = useForm.useForm(rest);
+  var getRootProps = formContext.getRootProps; // useImperativeHandle(innerRef, () => formContext)
+
+  var providedValue = React.useMemo(function () {
+    return Object.assign({
+      labelWidth: labelWidth,
+      labelPlacement: labelPlacement,
+      colon: colon
+    }, formContext);
+  }, [labelWidth, formContext, labelPlacement, colon]);
+  var cls = classname.cx(prefixCls, className);
+  return (
+    /*#__PURE__*/
+    // @ts-ignore
+    React__default['default'].createElement(context.FormProvider, {
+      value: providedValue
+    }, /*#__PURE__*/React__default['default'].createElement("form", Object.assign({
+      ref: ref,
+      role: role,
+      className: cls
+    }, getRootProps()), children))
+  );
+});
+
+if (env.__DEV__) {
+  Form.displayName = 'Form';
+}
+
+var formExtends = function formExtends(model) {
+  // @ts-ignore
+  if (typeof model.name === 'string') {
+    // @ts-ignore
+    FORM_REGISTER_TABLE[model.name] = model;
+  } else {
+    if (env.__DEV__) {
+      console.log('WARNING: the name should be unique string and not empty.');
+    }
+  }
+};
+
+Object.assign(Form, {
+  "extends": formExtends
+});
+exports.FORM_REGISTER_TABLE = FORM_REGISTER_TABLE;
+exports.Form = Form;
+//# sourceMappingURL=Form.js.map

package/lib/cjs/Form.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Form.js","sources":["../../src/Form.tsx"],"sourcesContent":[null],"names":["_role","_prefix","getPrefixCls","FORM_REGISTER_TABLE","Form","forwardRef","_a","ref","prefixCls","role","className","children","labelWidth","labelPlacement","colon","rest","formContext","useForm","getRootProps","providedValue","useMemo","cls","cx","React","FormProvider","value","__DEV__","displayName","formExtends","model","name","console","log","Object","assign","extends"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAQA,IAAMA,KAAK,GAAG,MAAd;;AACA,IAAMC,OAAO,GAAGC,sBAAAA,CAAaF,KAAbE,CAAhB;;;IAGaC,mBAAmB,GAAkC;AAElE;;;;IAGaC,IAAI,gBAAGC,gBAAAA,CAClB,UACEC,EADF,EAcEC,GAdF;wBAEIC;MAAAA,sCAAYP;mBACZQ;MAAAA,4BAAOT;MACPU,eAAAA;MACAC,cAAAA;MAEAC,gBAAAA;6BACAC;MAAAA,gDAAiB;MAGjBC,WAAAA;MACGC,wBAXL,YAAA,QAAA,aAAA,YAAA,YAAA,cAAA,kBAAA,aAAA,iBAAA,SAAA;;MAeMC,WAAW,GAAGC,eAAAA,CAAQF,IAARE;MAEZC,YAAR,GAAyBF,WAAzB,CAAQE;;MAGFC,aAAa,GAAGC,aAAAA,CAAQ;;AAE1BR,MAAAA,UAAU,EAAVA;AACAC,MAAAA,cAAc,EAAdA;AACAC,MAAAA,KAAK,EAALA;OACGE;AALsB,GAAPI,EAOnB,CAACR,UAAD,EAAaI,WAAb,EAA0BH,cAA1B,EAA0CC,KAA1C,CAPmBM;MAShBC,GAAG,GAAGC,YAAAA,CAAGd,SAAHc,EAAcZ,SAAdY;;;;AAIVC,IAAAA,yBAAAA,cAAAA,CAACC,oBAADD;AAAcE,MAAAA,KAAK,EAAEN;KAArBI,eACEA,yBAAAA,cAAAA,OAAAA;AAAMhB,MAAAA,GAAG,EAAEA;AAAKE,MAAAA,IAAI,EAAEA;AAAMC,MAAAA,SAAS,EAAEW;OAASH,YAAY,GAA5DK,EACGZ,QADHY,CADFA;;AAnCwB,CAAVlB;;AAyEpB,IAAIqB,WAAJ,EAAa;AACXtB,EAAAA,IAAI,CAACuB,WAALvB,GAAmB,MAAnBA;;;AAGF,IAAMwB,WAAW,GAAG,SAAdA,WAAc,CAACC,KAAD;;MAEd,OAAOA,KAAK,CAACC,IAAb,KAAsB,UAAU;;AAElC3B,IAAAA,mBAAmB,CAAC0B,KAAK,CAACC,IAAP,CAAnB3B,GAAkC0B,KAAlC1B;AAFF,SAGO;QACDuB,aAAS;AACXK,MAAAA,OAAO,CAACC,GAARD,CAAY,0DAAZA;;;AAPN,CAAA;;AAYAE,MAAM,CAACC,MAAPD,CAAc7B,IAAd6B,EAAoB;AAAEE,aAASP;AAAX,CAApBK;;"}

package/lib/cjs/FormField.js

@@ -0,0 +1,44 @@
+/** @LICENSE
+ * @hi-ui/form
+ * https://github.com/XiaoMi/hiui/tree/master/packages/ui/form#readme
+ *
+ * Copyright (c) HIUI <mi-hiui@xiaomi.com>.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+'use strict';
+
+Object.defineProperty(exports, '__esModule', {
+  value: true
+});
+
+var React = require('react');
+
+var env = require('@hi-ui/env');
+
+var useFormField = require('./use-form-field.js');
+/**
+ * TODO: What is FormField
+ */
+
+
+var FormField = function FormField(props) {
+  var _a;
+
+  var fieldProps = useFormField.useFormField(props);
+
+  if (! /*#__PURE__*/React.isValidElement(props.children)) {
+    console.warn('FormField must pass a valid element as children.');
+    return (_a = props.children) !== null && _a !== void 0 ? _a : null;
+  }
+
+  return /*#__PURE__*/React.cloneElement(props.children, Object.assign({}, fieldProps));
+};
+
+if (env.__DEV__) {
+  FormField.displayName = 'FormField';
+}
+
+exports.FormField = FormField;
+//# sourceMappingURL=FormField.js.map

package/lib/cjs/FormField.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormField.js","sources":["../../src/FormField.tsx"],"sourcesContent":[null],"names":["FormField","props","fieldProps","useFormField","isValidElement","children","console","warn","cloneElement","__DEV__","displayName"],"mappings":";;;;;;;;;;;;;;;;;;;;AAIA;;;;;IAGaA,SAAS,GAA6B,SAAtCA,SAAsC,CAACC,KAAD;;;MAC3CC,UAAU,GAAGC,yBAAAA,CAAaF,KAAbE;;MAEf,eAACC,oBAAAA,CAAeH,KAAK,CAACI,QAArBD,GAAgC;AACnCE,IAAAA,OAAO,CAACC,IAARD,CAAa,kDAAbA;WACO,MAAAL,KAAK,CAACI,QAAN,UAAA,iBAAA,KAAA,GAAkB;;;sBAGpBG,kBAAAA,CAAaP,KAAK,CAACI,QAAnBG,oBAAkCN,WAAlCM;;;AAUT,IAAIC,WAAJ,EAAa;AACXT,EAAAA,SAAS,CAACU,WAAVV,GAAwB,WAAxBA;;;"}

package/lib/cjs/FormItem.js

@@ -0,0 +1,61 @@
+/** @LICENSE
+ * @hi-ui/form
+ * https://github.com/XiaoMi/hiui/tree/master/packages/ui/form#readme
+ *
+ * Copyright (c) HIUI <mi-hiui@xiaomi.com>.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+'use strict';
+
+var _typeof = require("@babel/runtime/helpers/typeof");
+
+Object.defineProperty(exports, '__esModule', {
+  value: true
+});
+
+var tslib = require('tslib');
+
+var React = require('react');
+
+var env = require('@hi-ui/env');
+
+var FormLabel = require('./FormLabel.js');
+
+var FormMessage = require('./FormMessage.js');
+
+var FormField = require('./FormField.js');
+
+function _interopDefaultLegacy(e) {
+  return e && _typeof(e) === 'object' && 'default' in e ? e : {
+    'default': e
+  };
+}
+
+var React__default = /*#__PURE__*/_interopDefaultLegacy(React);
+/**
+ * TODO: What is FormItem
+ */
+
+
+var FormItem = function FormItem(_a) {
+  var field = _a.field,
+      children = _a.children,
+      valueType = _a.valueType,
+      rest = tslib.__rest(_a, ["field", "children", "valueType"]);
+
+  return /*#__PURE__*/React__default['default'].createElement(FormLabel.FormLabel, Object.assign({}, rest), /*#__PURE__*/React__default['default'].createElement(FormField.FormField, {
+    field: field,
+    valueType: valueType
+  }, children), /*#__PURE__*/React__default['default'].createElement(FormMessage.FormMessage, {
+    field: field
+  }));
+};
+
+if (env.__DEV__) {
+  FormItem.displayName = 'FormItem';
+}
+
+exports.FormItem = FormItem;
+//# sourceMappingURL=FormItem.js.map

package/lib/cjs/FormItem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormItem.js","sources":["../../src/FormItem.tsx"],"sourcesContent":[null],"names":["FormItem","_a","field","children","valueType","rest","React","FormLabel","FormField","FormMessage","__DEV__","displayName"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAOA;;;;;IAGaA,QAAQ,GAA4B,SAApCA,QAAoC,CAACC,EAAD;MAAGC,WAAAA;MAAOC,cAAAA;MAAUC,eAAAA;MAAcC,wBAAjC,QAAA,YAAA,aAAA;;sBAE9CC,yBAAAA,cAAAA,CAACC,mBAADD,oBAAeD,KAAfC,eACEA,yBAAAA,cAAAA,CAACE,mBAADF;AAAWJ,IAAAA,KAAK,EAAEA;AAAOE,IAAAA,SAAS,EAAEA;GAApCE,EACGH,QADHG,CADFA,eAKEA,yBAAAA,cAAAA,CAACG,uBAADH;AAAaJ,IAAAA,KAAK,EAAEA;GAApBI,CALFA;;;AAiBJ,IAAII,WAAJ,EAAa;AACXV,EAAAA,QAAQ,CAACW,WAATX,GAAuB,UAAvBA;;;"}

package/lib/cjs/FormLabel.js

@@ -0,0 +1,135 @@
+/** @LICENSE
+ * @hi-ui/form
+ * https://github.com/XiaoMi/hiui/tree/master/packages/ui/form#readme
+ *
+ * Copyright (c) HIUI <mi-hiui@xiaomi.com>.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+'use strict';
+
+var _typeof = require("@babel/runtime/helpers/typeof");
+
+Object.defineProperty(exports, '__esModule', {
+  value: true
+});
+
+var tslib = require('tslib');
+
+var React = require('react');
+
+var classname = require('@hi-ui/classname');
+
+var env = require('@hi-ui/env');
+
+var context = require('./context.js');
+
+var typeAssertion = require('@hi-ui/type-assertion');
+
+function _interopDefaultLegacy(e) {
+  return e && _typeof(e) === 'object' && 'default' in e ? e : {
+    'default': e
+  };
+}
+
+var React__default = /*#__PURE__*/_interopDefaultLegacy(React);
+
+var _role = 'form-label';
+
+var _prefix = classname.getPrefixCls(_role);
+/**
+ * TODO: What is FormLabel
+ */
+
+
+var FormLabel = /*#__PURE__*/React.forwardRef(function (props, ref) {
+  var _useFormContext = context.useFormContext(),
+      labelWidthContext = _useFormContext.labelWidth,
+      labelPlacement = _useFormContext.labelPlacement,
+      colonContext = _useFormContext.colon,
+      contentPositionContext = _useFormContext.contentPosition;
+
+  var _props$prefixCls = props.prefixCls,
+      prefixCls = _props$prefixCls === void 0 ? _prefix : _props$prefixCls,
+      _props$role = props.role,
+      role = _props$role === void 0 ? _role : _props$role,
+      className = props.className,
+      styleProp = props.style,
+      children = props.children,
+      label = props.label,
+      _props$required = props.required,
+      required = _props$required === void 0 ? false : _props$required,
+      _props$labelWidth = props.labelWidth,
+      labelWidthProp = _props$labelWidth === void 0 ? labelWidthContext : _props$labelWidth,
+      _props$colon = props.colon,
+      colon = _props$colon === void 0 ? colonContext : _props$colon,
+      _props$contentPositio = props.contentPosition,
+      contentPosition = _props$contentPositio === void 0 ? contentPositionContext : _props$contentPositio,
+      rest = tslib.__rest(props, ["prefixCls", "role", "className", "style", "children", "label", "field", "required", "labelWidth", "colon", "contentPosition"]);
+
+  var _useMemo = React.useMemo(function () {
+    if (labelPlacement === 'top') return {
+      labelWidth: '100%',
+      controlWidth: '100%'
+    };
+    var labelWidth = typeAssertion.isNumeric(labelWidthProp) ? Number(labelWidthProp) : labelWidthProp;
+    return {
+      labelWidth: labelWidth,
+      controlWidth: "calc(100% - " + labelWidth + "px)"
+    };
+  }, [labelPlacement, labelWidthProp]),
+      labelWidth = _useMemo.labelWidth,
+      controlWidth = _useMemo.controlWidth; // 指定子元素位置
+
+
+  var contentPositionMemo = React.useMemo(function () {
+    switch (contentPosition) {
+      case 'top':
+        return 'flex-start';
+
+      case 'bottom':
+        return 'flex-end';
+
+      default:
+        return 'center';
+    }
+  }, [contentPosition]);
+  var colonMemo = React.useMemo(function () {
+    return colon ? ':' : null;
+  }, [colon]);
+  var cls = classname.cx(prefixCls, className, required && prefixCls + "--required", labelPlacement && prefixCls + "--placement-" + labelPlacement // error && `${prefixCls}--error`,
+  // validating && `${prefixCls}--validating`
+  );
+  var style = Object.assign(Object.assign({}, styleProp), {
+    alignItems: contentPositionMemo
+  });
+  return /*#__PURE__*/React__default['default'].createElement("div", Object.assign({
+    ref: ref,
+    role: role,
+    className: cls,
+    style: style
+  }, rest), label ? /*#__PURE__*/React__default['default'].createElement("label", {
+    className: prefixCls + "__text",
+    style: {
+      width: labelWidth
+    }
+  }, label, colonMemo) : /*#__PURE__*/React__default['default'].createElement("span", {
+    className: prefixCls + "__indent",
+    style: {
+      width: labelWidth
+    }
+  }), /*#__PURE__*/React__default['default'].createElement("div", {
+    className: prefixCls + "__control",
+    style: {
+      width: controlWidth
+    }
+  }, children));
+});
+
+if (env.__DEV__) {
+  FormLabel.displayName = 'FormLabel';
+}
+
+exports.FormLabel = FormLabel;
+//# sourceMappingURL=FormLabel.js.map

package/lib/cjs/FormLabel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormLabel.js","sources":["../../src/FormLabel.tsx"],"sourcesContent":[null],"names":["_role","_prefix","getPrefixCls","FormLabel","forwardRef","props","ref","useFormContext","labelWidthContext","labelWidth","labelPlacement","colonContext","colon","contentPositionContext","contentPosition","prefixCls","role","className","styleProp","style","children","label","required","labelWidthProp","rest","useMemo","controlWidth","isNumeric","Number","contentPositionMemo","colonMemo","cls","cx","alignItems","React","width","__DEV__","displayName"],"mappings":"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"}

package/lib/cjs/FormList.js

@@ -0,0 +1,166 @@
+/** @LICENSE
+ * @hi-ui/form
+ * https://github.com/XiaoMi/hiui/tree/master/packages/ui/form#readme
+ *
+ * Copyright (c) HIUI <mi-hiui@xiaomi.com>.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+'use strict';
+
+var _typeof = require("@babel/runtime/helpers/typeof");
+
+Object.defineProperty(exports, '__esModule', {
+  value: true
+});
+
+var React = require('react');
+
+var env = require('@hi-ui/env');
+
+var context = require('./context.js');
+
+var funcUtils = require('@hi-ui/func-utils');
+
+var typeAssertion = require('@hi-ui/type-assertion');
+
+function _interopDefaultLegacy(e) {
+  return e && _typeof(e) === 'object' && 'default' in e ? e : {
+    'default': e
+  };
+}
+
+var React__default = /*#__PURE__*/_interopDefaultLegacy(React);
+
+var fieldListSymbol = Symbol('field-list');
+/**
+ * TODO: What is FormList
+ */
+
+var FormList = function FormList(_ref) {
+  var children = _ref.children,
+      nameProp = _ref.name;
+
+  var _useFormContext = context.useFormContext(),
+      values = _useFormContext.values,
+      setFormState = _useFormContext.setFormState; // 唯一 id 生成器
+  // const listCountRef = React.useRef(0)
+  // eslint-disable-next-line react-hooks/exhaustive-deps
+
+
+  var name = typeAssertion.isArray(nameProp) ? nameProp : [nameProp];
+  /**
+   * form List 动态字段更新器
+   */
+
+  var updateFormList = React__default['default'].useCallback(function (stateFunc, alterTouched, alterErrors) {
+    setFormState(function (prev) {
+      var values = funcUtils.setNested(prev.values, name, stateFunc(funcUtils.getNested(prev.values, name)));
+      console.log(values, stateFunc(funcUtils.getNested(prev.values, name)));
+      var updateErrors = typeof alterErrors === 'function' ? alterErrors : stateFunc;
+      var updateTouched = typeof alterTouched === 'function' ? alterTouched : stateFunc;
+      var fieldError = alterErrors ? updateErrors(funcUtils.getNested(prev.errors, name)) : undefined;
+      var fieldTouched = alterTouched ? updateTouched(funcUtils.getNested(prev.touched, name)) : undefined;
+
+      if (!typeAssertion.isArrayNonEmpty(fieldError)) {
+        fieldError = undefined;
+      }
+
+      if (!typeAssertion.isArrayNonEmpty(fieldTouched)) {
+        fieldTouched = undefined;
+      }
+
+      return {
+        values: values,
+        errors: alterErrors ? funcUtils.setNested(prev.errors, name, fieldError) : prev.errors,
+        touched: alterTouched ? funcUtils.setNested(prev.touched, name, fieldTouched) : prev.touched
+      };
+    });
+  }, [name, setFormState]);
+  var add = React__default['default'].useCallback(function (value) {
+    // 维护的 动态 field list
+    updateFormList(function (prev) {
+      return [].concat(asArray(prev), [value]);
+    }, false, false);
+  }, [updateFormList]);
+  var remove = React__default['default'].useCallback(function (index) {
+    updateFormList(function (prev) {
+      return asArray(prev).filter(function (_, idx) {
+        return idx !== index;
+      });
+    }, true, true);
+  }, [updateFormList]);
+  var insertBefore = React__default['default'].useCallback(function (index, value) {
+    updateFormList(function (prev) {
+      return insert(asArray(prev), index, value);
+    }, function (prev) {
+      return insert(asArray(prev), index, null);
+    }, function (prev) {
+      return insert(asArray(prev), index, null);
+    });
+  }, [updateFormList]);
+  var swap = React__default['default'].useCallback(function (aIndex, bIndex) {
+    updateFormList(function (prev) {
+      var copy = [].concat(asArray(prev));
+      var temp = copy[aIndex];
+      copy[aIndex] = copy[bIndex];
+      copy[bIndex] = temp;
+      return copy;
+    }, true, true);
+  }, [updateFormList]);
+  var move = React__default['default'].useCallback(function (fromIndex, toIndex) {
+    updateFormList(function (prev) {
+      var copy = [].concat(asArray(prev));
+      var temp = copy[fromIndex];
+      copy.splice(fromIndex, 1);
+      copy.splice(toIndex, 0, temp);
+      return copy;
+    }, true, true);
+  }, [updateFormList]);
+  var listFields = React__default['default'].useMemo(function () {
+    var list = funcUtils.getNested(values, name) || []; // @ts-ignore
+
+    return list.map(function (value, index) {
+      return {
+        name: '' + index,
+        // field: ++listCountRef.current + '',
+        symbol: fieldListSymbol,
+        value: value
+      };
+    });
+  }, [values, name]);
+
+  if (typeof children !== 'function') {
+    if (env.__DEV__) {
+      console.warn(false, 'FormList only accepts a render function as children.');
+    }
+
+    return null;
+  }
+
+  return children(listFields, {
+    add: add,
+    remove: remove,
+    swap: swap,
+    insertBefore: insertBefore,
+    move: move
+  });
+};
+
+if (env.__DEV__) {
+  FormList.displayName = 'FormList';
+}
+
+var insert = function insert(arr, index, value) {
+  arr = [].concat(arr);
+  arr.splice(index, 0, value);
+  return arr;
+};
+
+var asArray = function asArray(arr) {
+  return typeAssertion.isArray(arr) ? arr : [];
+};
+
+exports.FormList = FormList;
+//# sourceMappingURL=FormList.js.map

package/lib/cjs/FormList.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormList.js","sources":["../../src/FormList.tsx"],"sourcesContent":[null],"names":["fieldListSymbol","Symbol","FormList","children","nameProp","name","useFormContext","values","setFormState","isArray","updateFormList","React","useCallback","stateFunc","alterTouched","alterErrors","prev","setNested","getNested","console","log","updateErrors","updateTouched","fieldError","errors","undefined","fieldTouched","touched","isArrayNonEmpty","add","value","asArray","remove","index","filter","_","idx","insertBefore","insert","swap","aIndex","bIndex","copy","temp","move","fromIndex","toIndex","splice","listFields","useMemo","list","map","symbol","__DEV__","warn","displayName","arr"],"mappings":"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"}

package/lib/cjs/FormMessage.js

@@ -0,0 +1,72 @@
+/** @LICENSE
+ * @hi-ui/form
+ * https://github.com/XiaoMi/hiui/tree/master/packages/ui/form#readme
+ *
+ * Copyright (c) HIUI <mi-hiui@xiaomi.com>.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+'use strict';
+
+var _typeof = require("@babel/runtime/helpers/typeof");
+
+Object.defineProperty(exports, '__esModule', {
+  value: true
+});
+
+var tslib = require('tslib');
+
+var React = require('react');
+
+var classname = require('@hi-ui/classname');
+
+var env = require('@hi-ui/env');
+
+var context = require('./context.js');
+
+function _interopDefaultLegacy(e) {
+  return e && _typeof(e) === 'object' && 'default' in e ? e : {
+    'default': e
+  };
+}
+
+var React__default = /*#__PURE__*/_interopDefaultLegacy(React);
+
+var _role = 'form-message';
+
+var _prefix = classname.getPrefixCls(_role);
+/**
+ * TODO: What is FormMessage
+ */
+
+
+var FormMessage = /*#__PURE__*/React.forwardRef(function (_a, ref) {
+  var _a$prefixCls = _a.prefixCls,
+      prefixCls = _a$prefixCls === void 0 ? _prefix : _a$prefixCls,
+      _a$role = _a.role,
+      role = _a$role === void 0 ? _role : _a$role,
+      className = _a.className,
+      field = _a.field,
+      rest = tslib.__rest(_a, ["prefixCls", "role", "className", "children", "field"]);
+
+  var _useFormContext = context.useFormContext(),
+      getFieldError = _useFormContext.getFieldError; // field 支持数组，递归去设置或者获取对象中的属性值
+  // 如何变成映射的 key，特殊处理化
+
+
+  var message = field ? getFieldError(field) : null;
+  var cls = classname.cx(prefixCls, className);
+  return message ? /*#__PURE__*/React__default['default'].createElement("span", Object.assign({
+    ref: ref,
+    role: role,
+    className: cls
+  }, rest), message) : null;
+});
+
+if (env.__DEV__) {
+  FormMessage.displayName = 'FormMessage';
+}
+
+exports.FormMessage = FormMessage;
+//# sourceMappingURL=FormMessage.js.map

package/lib/cjs/FormMessage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormMessage.js","sources":["../../src/FormMessage.tsx"],"sourcesContent":[null],"names":["_role","_prefix","getPrefixCls","FormMessage","forwardRef","_a","ref","prefixCls","role","className","field","rest","useFormContext","getFieldError","message","cls","cx","React","__DEV__","displayName"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAKA,IAAMA,KAAK,GAAG,cAAd;;AACA,IAAMC,OAAO,GAAGC,sBAAAA,CAAaF,KAAbE,CAAhB;AAEA;;;;;IAGaC,WAAW,gBAAGC,gBAAAA,CACzB,UAACC,EAAD,EAA6EC,GAA7E;wBAAGC;MAAAA,sCAAYN;mBAASO;MAAAA,4BAAOR;MAAOS,eAAAA;MAAqBC,WAAAA;MAAUC,wBAApE,YAAA,QAAA,aAAA,YAAA,SAAA;;wBAC2BC,sBAAAA;MAAlBC,aAAR,mBAAQA;;;;MAIFC,OAAO,GAAGJ,KAAK,GAAGG,aAAa,CAACH,KAAD,CAAhB,GAA0B;MACzCK,GAAG,GAAGC,YAAAA,CAAGT,SAAHS,EAAcP,SAAdO;SAELF,OAAO,gBACZG,yBAAAA,cAAAA,OAAAA;AAAMX,IAAAA,GAAG,EAAEA;AAAKE,IAAAA,IAAI,EAAEA;AAAMC,IAAAA,SAAS,EAAEM;KAASJ,KAAhDM,EAEGH,OAFHG,CADY,GAKV;AAd6B,CAAVb;;AAyC3B,IAAIc,WAAJ,EAAa;AACXf,EAAAA,WAAW,CAACgB,WAAZhB,GAA0B,aAA1BA;;;"}