doui-react 1.0.0

package/es/form/hook/provider.js

@@ -0,0 +1,21 @@
+import _objectWithoutProperties from "@babel/runtime/helpers/esm/objectWithoutProperties";
+var _excluded = ["children"];
+import { createContext, useContext } from 'react';
+import { jsx as _jsx } from "@emotion/react/jsx-runtime";
+var FormCtx = /*#__PURE__*/createContext({});
+export function FormProvider(_ref) {
+  var children = _ref.children,
+    props = _objectWithoutProperties(_ref, _excluded);
+  return _jsx(FormCtx.Provider, {
+    value: props,
+    children: children
+  });
+}
+export function useFormContext() {
+  return useContext(FormCtx);
+}
+export function useFormValue() {
+  var _useFormContext = useFormContext(),
+    values = _useFormContext.values;
+  return values;
+}

package/es/form/hook/use-form.d.ts

@@ -0,0 +1,2 @@
+import { FormInstance } from "..";
+export declare function useForm(): FormInstance;

package/es/form/hook/use-form.js

@@ -0,0 +1,335 @@
+import _objectSpread from "@babel/runtime/helpers/esm/objectSpread2";
+import _regeneratorRuntime from "@babel/runtime/helpers/esm/regeneratorRuntime";
+import _asyncToGenerator from "@babel/runtime/helpers/esm/asyncToGenerator";
+import { runDevOrJest, wait } from "../../api";
+import { Form } from 'antd';
+import delay from 'delay';
+import _ from 'lodash';
+import { useUpdate } from 'react-use';
+import { registerMethods } from "../component/constant";
+import { parseFormFailedError, transformKeyToPath, transformNameToPath, transformPathToName } from "../component/utils";
+var pathMap = {
+  initForm: '__INTERNAL__.initForm',
+  name: '__INTERNAL__.name',
+  items: '__INTERNAL__.items',
+  itemsStatus: '__INTERNAL__.itemsStatus',
+  loading: '__INTERNAL__.loading',
+  errors: '__INTERNAL__.errors',
+  methods: '__INTERNAL__.methods'
+};
+export function useForm() {
+  var form = Form.useForm()[0];
+  var update = useUpdate();
+
+  // 防止重复初始化
+  if (_.get(form, pathMap.initForm)) {
+    return form;
+  }
+  _.set(form, pathMap.initForm, true);
+  var methods = [registerAndCallMethod, updateForm, setError, setValue, getValue, validate, reset, submit, getName, processFormItems, processFormItemsStatus, getFieldInstance, getFormList, focus];
+  methods.forEach(function (fn) {
+    return fn(form, update);
+  });
+  return form;
+}
+function registerAndCallMethod(form) {
+  var path = pathMap.methods;
+  form.registerMethod = function (name, fn) {
+    _.set(form, "".concat(path, ".").concat(name), fn);
+  };
+  form.callMethod = function (name) {
+    for (var _len = arguments.length, args = new Array(_len > 1 ? _len - 1 : 0), _key = 1; _key < _len; _key++) {
+      args[_key - 1] = arguments[_key];
+    }
+    return _.invoke.apply(_, [form, "".concat(path, ".").concat(name)].concat(args));
+  };
+}
+function getValue(form) {
+  form.getValue = function (name) {
+    var path = transformNameToPath(name);
+    return path ? form.getFieldValue(path) : form.getFieldsValue(true);
+  };
+}
+function setError(form) {
+  form.setError = /*#__PURE__*/function () {
+    var _ref = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee(nameOrParams, message) {
+      var errors, internalErrors;
+      return _regeneratorRuntime().wrap(function _callee$(_context) {
+        while (1) switch (_context.prev = _context.next) {
+          case 0:
+            _context.next = 2;
+            return wait(function () {
+              return !form.callMethod(registerMethods.getLoading);
+            });
+          case 2:
+            errors = [];
+            if (_.isString(nameOrParams) || _.isArray(nameOrParams)) {
+              errors.push({
+                name: transformNameToPath(nameOrParams),
+                errors: [message || '']
+              });
+            } else {
+              errors = _.map(nameOrParams, function (value, name) {
+                return {
+                  name: transformNameToPath(name),
+                  errors: [value]
+                };
+              });
+            }
+            form.setFields(errors);
+
+            // 暂存 errors， 实时校验需要获取 errors
+            internalErrors = getInternalErrors(form);
+            _.forEach(errors, function (error) {
+              return _.set(internalErrors, error.name, error.errors[0]);
+            });
+            form.callMethod(registerMethods.triggerValidate);
+          case 8:
+          case "end":
+            return _context.stop();
+        }
+      }, _callee);
+    }));
+    return function (_x, _x2) {
+      return _ref.apply(this, arguments);
+    };
+  }();
+  form.registerMethod(registerMethods.getInternalErrors, function (name) {
+    var internalErrors = getInternalErrors(form);
+    return _.get(internalErrors, name);
+  });
+  form.registerMethod(registerMethods.resetInternalError, function (name) {
+    var internalErrors = getInternalErrors(form);
+    if (name) {
+      _.unset(internalErrors, name);
+    } else {
+      _.set(form, pathMap.errors, {});
+    }
+
+    // reset itemsStatus
+    form.callMethod(registerMethods.setItemsStatus, name);
+  });
+  form.resetError = function (name) {
+    var nameList = _.castArray(name);
+    var fields = nameList.map(function (x) {
+      return {
+        name: transformNameToPath(x),
+        errors: []
+      };
+    });
+    form.setFields(fields);
+    _.forEach(nameList, function (name) {
+      return form.callMethod(registerMethods.resetInternalError, name);
+    });
+  };
+}
+function getInternalErrors(form) {
+  var errors = _.get(form, pathMap.errors);
+  if (errors) {
+    return errors;
+  }
+  var defaultErrors = {};
+  _.set(form, pathMap.errors, defaultErrors);
+  return defaultErrors;
+}
+function setValue(form, update) {
+  form.setValue = function (nameOrParams, value) {
+    if (_.isString(nameOrParams) || _.isArray(nameOrParams)) {
+      var name = transformNameToPath(nameOrParams);
+      // 该方法会替换 Value
+      form.setFieldValue(name, value);
+    } else {
+      var values = transformKeyToPath(nameOrParams);
+      // 该方法会 Merge Value，同时会清空状态
+      form.setFieldsValue(values);
+    }
+    update();
+  };
+}
+function validate(form) {
+  form.validate = /*#__PURE__*/_asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee2() {
+    var _len2,
+      args,
+      _key2,
+      _args2 = arguments;
+    return _regeneratorRuntime().wrap(function _callee2$(_context2) {
+      while (1) switch (_context2.prev = _context2.next) {
+        case 0:
+          _context2.next = 2;
+          return wait(function () {
+            return !form.callMethod(registerMethods.getLoading);
+          });
+        case 2:
+          for (_len2 = _args2.length, args = new Array(_len2), _key2 = 0; _key2 < _len2; _key2++) {
+            args[_key2] = _args2[_key2];
+          }
+          return _context2.abrupt("return", form.callMethod.apply(form, [registerMethods.internalValidate].concat(args)));
+        case 4:
+        case "end":
+          return _context2.stop();
+      }
+    }, _callee2);
+  }));
+  form.registerMethod(registerMethods.internalValidate, /*#__PURE__*/function () {
+    var _ref3 = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee3(name, options) {
+      var path, nameList;
+      return _regeneratorRuntime().wrap(function _callee3$(_context3) {
+        while (1) switch (_context3.prev = _context3.next) {
+          case 0:
+            _context3.prev = 0;
+            if (!name) {
+              _context3.next = 8;
+              break;
+            }
+            path = transformNameToPath(name);
+            nameList = _.isString(name) ? [path] : path;
+            _context3.next = 6;
+            return form.validateFields(nameList, options);
+          case 6:
+            _context3.next = 10;
+            break;
+          case 8:
+            _context3.next = 10;
+            return form.validateFields(_objectSpread({
+              validateOnly: true
+            }, options));
+          case 10:
+            return _context3.abrupt("return", true);
+          case 13:
+            _context3.prev = 13;
+            _context3.t0 = _context3["catch"](0);
+            form.callMethod(registerMethods.onValidateFailed, parseFormFailedError(_context3.t0));
+            return _context3.abrupt("return", false);
+          case 17:
+          case "end":
+            return _context3.stop();
+        }
+      }, _callee3, null, [[0, 13]]);
+    }));
+    return function (_x3, _x4) {
+      return _ref3.apply(this, arguments);
+    };
+  }());
+}
+function reset(form) {
+  form.reset = function (name) {
+    if (name) {
+      var path = transformNameToPath(name);
+      var nameList = _.isString(name) ? [path] : path;
+      _.forEach(nameList, function (name) {
+        return form.callMethod(registerMethods.resetInternalError, name);
+      });
+      form.resetFields(nameList);
+      return;
+    }
+    form.callMethod(registerMethods.resetInternalError);
+    form.resetFields();
+  };
+}
+function submit(form) {
+  var originalSubmit = form.submit;
+  form.submit = /*#__PURE__*/_asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee4() {
+    var err;
+    return _regeneratorRuntime().wrap(function _callee4$(_context4) {
+      while (1) switch (_context4.prev = _context4.next) {
+        case 0:
+          _context4.prev = 0;
+          originalSubmit();
+          // 修复submit和validateFields同时调用时，某种场景会出现的bug
+          _context4.next = 4;
+          return delay(20);
+        case 4:
+          _context4.next = 6;
+          return form.validateFields();
+        case 6:
+          return _context4.abrupt("return", form.getValue());
+        case 9:
+          _context4.prev = 9;
+          _context4.t0 = _context4["catch"](0);
+          err = parseFormFailedError(_context4.t0);
+          return _context4.abrupt("return", Promise.reject(err));
+        case 13:
+        case "end":
+          return _context4.stop();
+      }
+    }, _callee4, null, [[0, 9]]);
+  }));
+}
+function updateForm(form, update) {
+  form.update = update;
+}
+function getName(form) {
+  var id = runDevOrJest(_.uniqueId('form_'), 'form');
+  var path = pathMap.name;
+  _.set(form, path, id);
+  form.getName = function () {
+    return _.get(form, path);
+  };
+}
+function processFormItems(form) {
+  var path = pathMap.items;
+  form.setItems = function (items) {
+    return _.set(form, path, items);
+  };
+  form.getItems = function (name) {
+    var items = _.get(form, path) || [];
+    if (name) {
+      var namePath = transformPathToName(name);
+      return _.find(items, function (item) {
+        return transformPathToName(item.name) === namePath;
+      });
+    }
+    return items;
+  };
+}
+function processFormItemsStatus(form) {
+  var path = pathMap.itemsStatus;
+  form.registerMethod(registerMethods.setItemsStatus, function (name, errors) {
+    if (!name) {
+      return _.set(form, path, {});
+    }
+    var namePath = transformPathToName(name);
+    var fullPath = "".concat(path, ".").concat(namePath);
+    if (_.isEmpty(errors)) {
+      return _.unset(form, fullPath);
+    }
+    _.set(form, fullPath, errors);
+  });
+  form.registerMethod(registerMethods.getItemsStatus, function (name) {
+    var namePath = transformPathToName(name);
+    var fullPath = name ? "".concat(path, ".").concat(namePath) : path;
+    var errors = _.get(form, fullPath);
+    return removeEmptyError(errors);
+  });
+  form.getError = function (name) {
+    return form.callMethod(registerMethods.getItemsStatus, name);
+  };
+}
+function removeEmptyError(error) {
+  if (!_.isPlainObject(error)) {
+    return error;
+  }
+  var processed = _.mapValues(error, removeEmptyError);
+  return _.omitBy(processed, _.isEmpty);
+}
+function getFieldInstance(form) {
+  form.getFieldInstance = function (name) {
+    var _form$getItems;
+    return (_form$getItems = form.getItems(name)) === null || _form$getItems === void 0 ? void 0 : _form$getItems.refs.current;
+  };
+}
+function getFormList(form) {
+  // @ts-ignore
+  form.getFormList = function (name) {
+    var list = _(form.getItems()).map('formListContext').compact().unionBy('name').value();
+    return name ? _.find(list, {
+      name: name
+    }) : list;
+  };
+}
+function focus(form) {
+  form.focus = function (name, option) {
+    var _form$getFieldInstanc;
+    (_form$getFieldInstanc = form.getFieldInstance(name)) === null || _form$getFieldInstanc === void 0 || _form$getFieldInstanc.focus(option);
+  };
+}

package/es/form/index.d.ts

@@ -0,0 +1,3 @@
+export * from './component';
+export * from './hook';
+export * from './type';

package/es/form/index.js

@@ -0,0 +1,3 @@
+export * from "./component";
+export * from "./hook";
+export * from "./type";

package/es/form/style/form-item.d.ts

@@ -0,0 +1,3 @@
+import { FormItemProps, FormItemPropsWithType } from "..";
+export declare function getFormItemWidth({ width, type }: FormItemPropsWithType): string | number | undefined;
+export declare function getFormItemStyle({ labelWidth, controlWidth, requiredMark, layout, type, ...props }: FormItemProps): string;

package/es/form/style/form-item.js

@@ -0,0 +1,38 @@
+import _taggedTemplateLiteral from "@babel/runtime/helpers/esm/taggedTemplateLiteral";
+import _objectWithoutProperties from "@babel/runtime/helpers/esm/objectWithoutProperties";
+var _templateObject, _templateObject2, _templateObject3, _templateObject4, _templateObject5;
+var _excluded = ["labelWidth", "controlWidth", "requiredMark", "layout", "type"];
+import { transformValueWithStyleUnit } from "../../api";
+import { getWidthAndFlex } from "../../stack/style";
+import { css } from '@emotion/css';
+import { useUnsetWidthKeys } from "../component/constant";
+export function getFormItemWidth(_ref) {
+  var width = _ref.width,
+    type = _ref.type;
+  if (width) {
+    return width;
+  }
+  if (useUnsetWidthKeys.includes(type)) {
+    return 'unset';
+  }
+}
+export function getFormItemStyle(_ref2) {
+  var labelWidth = _ref2.labelWidth,
+    controlWidth = _ref2.controlWidth,
+    _ref2$requiredMark = _ref2.requiredMark,
+    requiredMark = _ref2$requiredMark === void 0 ? true : _ref2$requiredMark,
+    layout = _ref2.layout,
+    type = _ref2.type,
+    props = _objectWithoutProperties(_ref2, _excluded);
+  var baseStyle = css(_templateObject || (_templateObject = _taggedTemplateLiteral(["\n    &.ant-form-item {\n      min-width: 0;\n\n      .ant-form-item-label {\n        width: ", ";\n\n        .ant-form-item-tooltip {\n          color: inherit;\n          font-size: 13px;\n          margin-inline-start: unset;\n          margin-left: 3px;\n        }\n      }\n\n      .ant-form-item-control-input {\n        width: ", ";\n      }\n\n      .ant-form-item-required::before {\n        display: ", ";\n      }\n\n      ", "\n      ", "\n      ", "\n    }\n  "])), transformValueWithStyleUnit(labelWidth), transformValueWithStyleUnit(controlWidth), requiredMark ? undefined : 'none', layout === 'horizontal' && getHorizontalStyle(), layout === 'vertical' && getVerticalStyle(), type === 'tree' && treeItemStyle());
+  return css(_templateObject2 || (_templateObject2 = _taggedTemplateLiteral(["\n    ", "\n    ", "\n  "])), getWidthAndFlex(props), baseStyle);
+}
+function getHorizontalStyle() {
+  return css(_templateObject3 || (_templateObject3 = _taggedTemplateLiteral(["\n    .ant-form-item-row {\n      flex-direction: row;\n    }\n\n    .ant-form-item-label {\n      padding-bottom: 0;\n\n      > label {\n        height: 32px;\n        margin-right: 8px;\n      }\n    }\n\n    .ant-form-item-control {\n      flex: 1;\n      min-width: 0;\n    }\n  "])));
+}
+function getVerticalStyle() {
+  return css(_templateObject4 || (_templateObject4 = _taggedTemplateLiteral(["\n    .ant-form-item-row {\n      flex-direction: column;\n    }\n\n    .ant-form-item-label {\n      > label {\n        height: auto;\n        margin-bottom: 4px;\n      }\n\n      .ant-form-item-required::before {\n        position: unset;\n      }\n    }\n  "])));
+}
+function treeItemStyle() {
+  return css(_templateObject5 || (_templateObject5 = _taggedTemplateLiteral(["\n    &,\n    .ant-form-item-row,\n    .ant-form-item-control,\n    .ant-form-item-control-input,\n    .ant-form-item-control-input-content {\n      height: 100%;\n    }\n  "])));
+}

package/es/form/style/index.d.ts

@@ -0,0 +1,7 @@
+import { FormProps } from "..";
+export * from './form-item';
+type WrapperProps = Pick<FormProps, 'labelWidth' | 'formItemMarginBottom'>;
+declare const style: {
+    wrapper: ({ labelWidth, formItemMarginBottom }: WrapperProps) => import("@emotion/react").SerializedStyles;
+};
+export default style;

package/es/form/style/index.js

@@ -0,0 +1,13 @@
+import _taggedTemplateLiteral from "@babel/runtime/helpers/esm/taggedTemplateLiteral";
+var _templateObject;
+import { commonFontFamily, transformValueWithStyleUnit } from "../../api";
+import { css } from '@emotion/react';
+export * from "./form-item";
+var style = {
+  wrapper: function wrapper(_ref) {
+    var labelWidth = _ref.labelWidth,
+      formItemMarginBottom = _ref.formItemMarginBottom;
+    return css(_templateObject || (_templateObject = _taggedTemplateLiteral(["\n    ", "\n\n    .ant-form-item {\n      margin-bottom: ", ";\n    }\n\n    .ant-form-item-label {\n      width: ", ";\n    }\n\n    .ant-form-item-with-help .ant-form-item-explain {\n      line-height: 1.1;\n      padding: 4px 0;\n\n      .ant-form-item-explain-error + .ant-form-item-explain-error {\n        margin-top: 2px;\n      }\n    }\n\n    &.ant-form-horizontal {\n      .ant-form-item-required::before {\n        position: absolute;\n        left: -10px;\n      }\n    }\n\n    &.ant-form-vertical {\n      .ant-form-item-label {\n        padding-bottom: 2px;\n      }\n    }\n\n    // disabled \u65F6\u4E5F\u9700\u8981\u663E\u793A error \u6846\n    .ant-picker-status-error.ant-picker,\n    .ant-select-status-error.ant-select:not(.ant-select-customize-input) .ant-select-selector,\n    .ant-input-status-error:not(.ant-input-borderless),\n    .ant-input-number-status-error:not(.ant-input-number-borderless),\n    .ant-input-affix-wrapper-status-error:not(.ant-input-affix-wrapper-borderless) {\n      border-color: #ff4d4f;\n    }\n  "])), commonFontFamily, transformValueWithStyleUnit(formItemMarginBottom), transformValueWithStyleUnit(labelWidth));
+  }
+};
+export default style;

package/es/form/type/form-item.d.ts

@@ -0,0 +1,141 @@
+import { FunctionReturn, Refs } from "../../api";
+import { CheckboxProps } from "../../checkbox";
+import { DatePickerProps, RangePickerProps } from "../../date-picker";
+import { CommonParams, FormListContext, FormValues } from "..";
+import { InputProps } from "../../input";
+import { RadioProps } from "../../radio";
+import { SelectOptions, SelectProps } from "../../select";
+import { SwitchProps } from "../../switch";
+import { TreeSelectProps } from "../../tree-select";
+import { FormItemProps as AntdFormItemProps } from 'antd/lib/form/FormItem';
+import { SliderRangeProps, SliderSingleProps } from 'antd/lib/slider';
+import { Rule } from 'rc-field-form/lib/interface';
+import { ReactElement, ReactNode } from 'react';
+import { InputComponentType, OtherComponentType } from '../component/form-item';
+type SliderProps = SliderSingleProps | SliderRangeProps;
+type UnionType = Omit<AntdFormItemProps & InputProps & SelectProps & TreeSelectProps & SwitchProps & RadioProps & CheckboxProps & SliderProps, 'rules' | 'type' | 'disabled' | 'options' | 'required'>;
+/**
+ * @noExtends
+ */
+export interface FormItemProps extends UnionType {
+    /**
+     * @description 表单类型
+     * @default input
+     */
+    type?: InputComponentType | OtherComponentType;
+    /**
+     * @description 表单名称，支持层级嵌套，如：a.b.c
+     * @default (必选)
+     */
+    name?: string;
+    /**
+     * @description 是否禁用
+     */
+    disabled?: boolean | ((values: FormValues, params: CommonParams) => boolean);
+    /**
+     * @description 选择框下拉选项
+     * @link SelectOptions: /components/select#select-option
+     */
+    options?: SelectOptions | ((values: FormValues, params: OptionsParams) => FunctionReturn<SelectOptions>);
+    /**
+     * @description 是否必填
+     */
+    required?: boolean | string;
+    /**
+     * @description 校验 `value` 是否在 `options` 中
+     * @default false
+     */
+    requiredInOptions?: boolean | string;
+    /**
+     * @description 自定义校验
+     */
+    validator?(params: ValidatorProps): FunctionReturn<string | void>;
+    /**
+     * @description 是否过滤选项中不存在的值
+     * @default false
+     * @replaceAll boolean | "useFirstOption" | string | number
+     */
+    filterNotExistValue?: boolean | string | number | 'useFirstOption';
+    /**
+     * @description 是否显示
+     * @default true
+     */
+    show?: boolean | ((values: FormValues, params: CommonParams) => boolean);
+    /**
+     * @link FormItemRule: https://4x.ant.design/components/form-cn/#Rule
+     */
+    rules?: FormItemRule[];
+    /**
+     * @description 日期选择器属性（当 `type` 为 `date`、`rangeDate` 时生效）
+     * @link DatePickerProps | RangePickerProps: /components/date-picker#api
+     */
+    dateProps?: DatePickerProps | RangePickerProps;
+    /**
+     * @description flex 布局属性
+     * @default 1
+     */
+    flex?: number | string;
+    /**
+     * @description label 宽度
+     */
+    labelWidth?: number | string;
+    /**
+     * @description 输入框宽度
+     */
+    controlWidth?: number | string;
+    /**
+     * @description 布局方式
+     * @default horizontal
+     */
+    layout?: 'horizontal' | 'vertical';
+    preserveStatus?: boolean;
+    /**
+     * @description 自定义渲染
+     */
+    render?: (params: RenderProps) => ReactElement;
+    /**
+     * @description 子节点
+     */
+    children?: ReactNode | ((params: RenderChildrenProps) => ReactNode);
+    formListContext?: FormListContext;
+    dependencies?: string[];
+    removeErrorOnBlur?: boolean;
+    __noCollectState__?: boolean;
+}
+export interface FormItemContext extends Pick<FormItemPropsWithType, 'type' | 'optionDependencies' | 'loading' | 'rules' | 'formListContext'> {
+    name: string;
+    options?: SelectOptions;
+    refs: Refs;
+}
+export interface OptionsParams extends CommonParams {
+    search: string;
+}
+export interface RenderProps extends CommonParams, FormItemProps {
+    id: string;
+    name: string;
+    refs: Refs;
+    collectState(item: Partial<FormItemContext>): void;
+}
+interface RenderChildrenProps {
+    id: string;
+    refs: Refs;
+    value?: any;
+    onChange?(value: any): void;
+    onBlur?(event: any): void;
+    onFocus?(event: any): void;
+}
+export type FormItemRenderProps = Partial<RenderProps>;
+export type FormItemChildrenProps = Partial<RenderChildrenProps>;
+export type FormItemPropsWithType = FormItemProps & {
+    type: string;
+    name: string;
+};
+export interface ValidatorProps extends CommonParams {
+    value: any;
+    item: FormItemProps;
+}
+export type FormItemRule = {
+    validateOnMount?: boolean;
+    validator?: FormItemProps['validator'];
+} | Omit<Rule, 'validator'>;
+export {};

package/es/form/type/form-item.js

@@ -0,0 +1 @@
+export {};

package/es/form/type/form-list.d.ts

@@ -0,0 +1,91 @@
+import { ButtonProps } from "../../button";
+import { FormItemProps, FormValues } from "..";
+import { ListOperation } from "../../hooks";
+import { FormListFieldData } from 'antd/lib/form/FormList';
+import { ReactNode } from 'react';
+export interface FormListContext extends FormListCommonProps {
+    name: FormItemProps['name'];
+}
+/**
+ * @noExtends
+ */
+export interface FormListProps extends FormItemProps {
+    /**
+     * @description 表单名称，支持层级嵌套，如：a.b.c
+     */
+    name: FormItemProps['name'];
+    /**
+     * @description 每一项渲染函数
+     */
+    item?: ReactNode | ((props: FormListItemProps) => ReactNode);
+    /**
+     * @description 渲染函数
+     */
+    children?(props: FormListChildrenProps): ReactNode;
+    /**
+     * @description 是否在新增时，聚焦第一个输入框
+     * @default true
+     */
+    focusFirstOnAdd?: boolean | string;
+}
+export interface FormListItemProps extends FormListCommonProps {
+    /**
+     * @description 当前项的索引
+     */
+    index: number;
+    /**
+     * @description 当前项的值
+     */
+    value: any;
+    /**
+     * @description 更新当前项的值
+     */
+    onChange(value?: any): void;
+}
+export interface FormListChildrenProps extends FormListCommonProps {
+    /**
+     * @description 当前 `List` 中，所有表单项的内容
+     */
+    component: ReactNode;
+}
+type FormListOperation = Omit<ListOperation, 'value'>;
+export interface FormListCommonProps extends FormListOperation {
+    /**
+     * @description 表单值
+     */
+    values: FormValues;
+    /**
+     * @description 当前 `List` 中，所有表单字段
+     */
+    fields: FormListFieldData[];
+    /**
+     * @description 错误信息
+     */
+    errors: ReactNode[];
+    warnings: ReactNode[];
+}
+/**
+ * @noExtends
+ */
+export interface FormListActionProps extends ButtonProps {
+    /**
+     * @description 操作类型
+     * @replaceAll "add" | "remove" | "moveUp" | "moveDown" | "move"
+     */
+    operation: keyof Omit<FormListOperation, 'update'>;
+    /**
+     * @description 新增时的默认值（当 `operation` 为 `add` 时生效）
+     */
+    defaultValue?: any;
+    /**
+     * @description 插入位置，默认为数组末尾（当 `operation` 为 `add` 时生效）
+     */
+    insertIndex?: number;
+    /**
+     * @description 当前项的索引（当 `operation` 为 `remove` 时，`index` 为数组支持批量删除，不传时，则清空所有项）
+     */
+    index?: number | number[];
+    from?: number;
+    to?: number;
+}
+export {};

package/es/form/type/form-list.js

@@ -0,0 +1 @@
+export {};