@carefrees/form-utils-react-taro 0.0.4

package/README.md

@@ -0,0 +1,9 @@
+# 表单工具
+
+- [ ] 表单项
+- [ ] 隐藏表单项
+- [ ] 空表单项
+- [ ] list表单项
+- [ ] layout分组标题
+- [ ] 依赖项表单项更新
+- [ ] 通知表单项更新

package/esm/formItem/index.d.ts

@@ -0,0 +1,11 @@
+import { LayoutFormItemProps } from './../layout/layout.formItem';
+import { FormItemAttrOptions } from '../hooks/attr/attr.FormItem';
+import React from 'react';
+export interface FormItemProps extends FormItemAttrOptions, LayoutFormItemProps {
+    /**不进行样式渲染*/
+    noStyle?: boolean;
+}
+/**表单项*/
+export declare const FormItem: React.MemoExoticComponent<(props: Partial<FormItemProps>) => import("react/jsx-runtime").JSX.Element>;
+/**隐藏表单项*/
+export declare const FormHideItem: React.MemoExoticComponent<(props: FormItemProps) => import("react/jsx-runtime").JSX.Element>;

package/esm/formItem/index.js

@@ -0,0 +1,70 @@
+import * as __WEBPACK_EXTERNAL_MODULE_react_jsx_runtime_225474f2__ from "react/jsx-runtime";
+import * as __WEBPACK_EXTERNAL_MODULE__layout_layout_formItem_js_c84059c5__ from "../layout/layout.formItem.js";
+import * as __WEBPACK_EXTERNAL_MODULE__hooks_attr_attr_FormItem_js_9b75aef3__ from "../hooks/attr/attr.FormItem.js";
+import * as __WEBPACK_EXTERNAL_MODULE__hooks_useFormItemParentName_js_ed96cda3__ from "../hooks/useFormItemParentName.js";
+import * as __WEBPACK_EXTERNAL_MODULE__hooks_register_register_FormHideItem_js_2b23597a__ from "../hooks/register/register.FormHideItem.js";
+import * as __WEBPACK_EXTERNAL_MODULE_react__ from "react";
+const FormItemInstance = /*#__PURE__*/ (0, __WEBPACK_EXTERNAL_MODULE_react__.memo)((props)=>{
+    const { labelMode, noStyle, onlyRuleStyle, label, helpText, extra, errorLayout, required, showColon, colSpan, rowSpan, ...rest } = props;
+    const { children, ruleInstance, formItemInstance, htmlFor, validateResult } = (0, __WEBPACK_EXTERNAL_MODULE__hooks_attr_attr_FormItem_js_9b75aef3__.useFormItemAttr)({
+        ...rest
+    });
+    if (noStyle) return /*#__PURE__*/ (0, __WEBPACK_EXTERNAL_MODULE_react_jsx_runtime_225474f2__.jsx)(__WEBPACK_EXTERNAL_MODULE__hooks_useFormItemParentName_js_ed96cda3__.FormItemParentNameProvider, {
+        name: formItemInstance.name,
+        sort: formItemInstance.sort,
+        children: children
+    });
+    return /*#__PURE__*/ (0, __WEBPACK_EXTERNAL_MODULE_react_jsx_runtime_225474f2__.jsx)(__WEBPACK_EXTERNAL_MODULE__hooks_useFormItemParentName_js_ed96cda3__.FormItemParentNameProvider, {
+        name: formItemInstance.name,
+        sort: formItemInstance.sort,
+        children: /*#__PURE__*/ (0, __WEBPACK_EXTERNAL_MODULE_react_jsx_runtime_225474f2__.jsx)(__WEBPACK_EXTERNAL_MODULE__layout_layout_formItem_js_c84059c5__.LayoutFormItem, {
+            labelMode: labelMode,
+            onlyRuleStyle: onlyRuleStyle,
+            required: required || ruleInstance?.isRequired?.(),
+            label: label,
+            helpText: helpText,
+            extra: extra,
+            errorLayout: errorLayout,
+            showColon: showColon,
+            colSpan: colSpan,
+            rowSpan: rowSpan,
+            htmlFor: htmlFor,
+            validateResult: validateResult,
+            children: children
+        })
+    });
+});
+const FormItem = /*#__PURE__*/ (0, __WEBPACK_EXTERNAL_MODULE_react__.memo)((props)=>{
+    const { name } = props;
+    if (name) return /*#__PURE__*/ (0, __WEBPACK_EXTERNAL_MODULE_react_jsx_runtime_225474f2__.jsx)(FormItemInstance, {
+        ...props,
+        name: name
+    });
+    const { labelMode, onlyRuleStyle, label, helpText, extra, errorLayout, required, showColon, colSpan, rowSpan, children } = props;
+    return /*#__PURE__*/ (0, __WEBPACK_EXTERNAL_MODULE_react_jsx_runtime_225474f2__.jsx)(__WEBPACK_EXTERNAL_MODULE__layout_layout_formItem_js_c84059c5__.LayoutFormItem, {
+        labelMode: labelMode,
+        onlyRuleStyle: onlyRuleStyle,
+        required: required,
+        label: label,
+        helpText: helpText,
+        extra: extra,
+        errorLayout: errorLayout,
+        showColon: showColon,
+        colSpan: colSpan,
+        rowSpan: rowSpan,
+        children: children
+    });
+});
+const FormHideItem = /*#__PURE__*/ (0, __WEBPACK_EXTERNAL_MODULE_react__.memo)((props)=>{
+    const { name, sort, isJoinParentField } = props;
+    const { isHide } = (0, __WEBPACK_EXTERNAL_MODULE__hooks_register_register_FormHideItem_js_2b23597a__.useRegisterFormHideItem)({
+        name,
+        sort: sort,
+        isJoinParentField
+    });
+    if (isHide) return /*#__PURE__*/ (0, __WEBPACK_EXTERNAL_MODULE_react_jsx_runtime_225474f2__.jsx)(__WEBPACK_EXTERNAL_MODULE_react__.Fragment, {});
+    return /*#__PURE__*/ (0, __WEBPACK_EXTERNAL_MODULE_react_jsx_runtime_225474f2__.jsx)(FormItemInstance, {
+        ...props
+    });
+});
+export { FormHideItem, FormItem };

package/esm/formList/index.d.ts

@@ -0,0 +1,27 @@
+import { RegisterFormListOptions } from './../hooks/register/register.FormList';
+import { RuleInstanceBase, FormItemInstanceBase, FormListInstanceBase } from '@carefrees/form-utils';
+import React from 'react';
+export interface FormListChildrenProps {
+    /**数据集合*/
+    fields: {
+        name: number;
+        key: number;
+    }[];
+    /**添加*/
+    onAdd: (initialValue?: Object) => void;
+    /**删除*/
+    onDelete: (index: number | number[]) => void;
+    /**移动*/
+    onMove: (from: number, to: number) => void;
+}
+export interface FormListProps extends RegisterFormListOptions {
+    children: (options: FormListChildrenProps, instances: {
+        ruleInstance: RuleInstanceBase;
+        formItemInstance: FormItemInstanceBase;
+        formListInstance: FormListInstanceBase;
+    }) => React.ReactNode;
+}
+/**form list 组件*/
+export declare const FormList: React.MemoExoticComponent<(props: FormListProps) => import("react/jsx-runtime").JSX.Element>;
+/**隐藏 form list item 组件*/
+export declare const FormHideList: React.MemoExoticComponent<(props: FormListProps) => import("react/jsx-runtime").JSX.Element>;

package/esm/formList/index.js

@@ -0,0 +1,40 @@
+import * as __WEBPACK_EXTERNAL_MODULE_react_jsx_runtime_225474f2__ from "react/jsx-runtime";
+import * as __WEBPACK_EXTERNAL_MODULE__hooks_register_register_FormList_js_6f2f394b__ from "../hooks/register/register.FormList.js";
+import * as __WEBPACK_EXTERNAL_MODULE__hooks_useFormList_js_058846bf__ from "../hooks/useFormList.js";
+import * as __WEBPACK_EXTERNAL_MODULE__hooks_useFormItemParentName_js_ed96cda3__ from "../hooks/useFormItemParentName.js";
+import * as __WEBPACK_EXTERNAL_MODULE__hooks_register_register_FormHideItem_js_2b23597a__ from "../hooks/register/register.FormHideItem.js";
+import * as __WEBPACK_EXTERNAL_MODULE_react__ from "react";
+const FormList = /*#__PURE__*/ (0, __WEBPACK_EXTERNAL_MODULE_react__.memo)((props)=>{
+    const { children, ...rest } = props;
+    const { formListInstance, ruleInstance, formItemInstance } = (0, __WEBPACK_EXTERNAL_MODULE__hooks_register_register_FormList_js_6f2f394b__.useRegisterFormList)(rest);
+    return /*#__PURE__*/ (0, __WEBPACK_EXTERNAL_MODULE_react_jsx_runtime_225474f2__.jsx)(__WEBPACK_EXTERNAL_MODULE__hooks_useFormList_js_058846bf__.FormListInstanceContext.Provider, {
+        value: formListInstance,
+        children: /*#__PURE__*/ (0, __WEBPACK_EXTERNAL_MODULE_react_jsx_runtime_225474f2__.jsx)(__WEBPACK_EXTERNAL_MODULE__hooks_useFormItemParentName_js_ed96cda3__.FormItemParentNameProvider, {
+            name: formListInstance.name,
+            sort: formListInstance.sort,
+            children: children({
+                fields: formListInstance.getFields(),
+                onAdd: formListInstance.onAdd,
+                onDelete: formListInstance.onDelete,
+                onMove: formListInstance.onMove
+            }, {
+                ruleInstance,
+                formItemInstance,
+                formListInstance
+            })
+        })
+    });
+});
+const FormHideList = /*#__PURE__*/ (0, __WEBPACK_EXTERNAL_MODULE_react__.memo)((props)=>{
+    const { name, sort, isJoinParentField } = props;
+    const { isHide } = (0, __WEBPACK_EXTERNAL_MODULE__hooks_register_register_FormHideItem_js_2b23597a__.useRegisterFormHideItem)({
+        name,
+        sort: sort,
+        isJoinParentField
+    });
+    if (isHide) return /*#__PURE__*/ (0, __WEBPACK_EXTERNAL_MODULE_react_jsx_runtime_225474f2__.jsx)(__WEBPACK_EXTERNAL_MODULE_react__.Fragment, {});
+    return /*#__PURE__*/ (0, __WEBPACK_EXTERNAL_MODULE_react_jsx_runtime_225474f2__.jsx)(FormList, {
+        ...props
+    });
+});
+export { FormHideList, FormList };

package/esm/hooks/attr/attr.FormItem.d.ts

@@ -0,0 +1,48 @@
+import { RuleInstanceBase, FormInstanceBase, FormItemInstanceBase } from '@carefrees/form-utils';
+import { RegisterFormItemOptions } from '../register/register.FormItem';
+import React from 'react';
+export interface FormItemAttrOptions extends RegisterFormItemOptions {
+    /**依赖更新项*/
+    dependencies?: string[];
+    /**通知 只用于校验规则提示 字段 */
+    noticeOnlyRuleDataField?: string[];
+    /**通知父级字段监听方法更新*/
+    isNoticeParentField?: boolean;
+    /**通知watch监听方法更新*/
+    noticeWatchField?: string[];
+    /**是否保护值(不进行表单项组件卸载重置初始值)*/
+    preserve?: boolean;
+    /**重写规则*/
+    useRules?: (ruleInstance: RuleInstanceBase, form: FormInstanceBase, formItemInstance: FormItemInstanceBase) => void;
+    /**输入框属性重写*/
+    useAttrs?: (attrs: any, form: FormInstanceBase, formItemInstance: FormItemInstanceBase) => any;
+    /**输入框属性*/
+    attrs?: any;
+    /**传递组件字段*/
+    valuePropName?: string;
+    /**取值字段(默认和valuePropName值相同)*/
+    getValuePath?: string;
+    /**自定义获取值*/
+    getValueFromEvent?: (event: any, form: FormInstanceBase, formItemInstance: FormItemInstanceBase) => any;
+    /**值格式化*/
+    formatValue?: (value: any, form: FormInstanceBase, formItemInstance: FormItemInstanceBase, event: any) => any;
+    /**触发数据更新之后触发（用于数据联动之类的）*/
+    onAfterUpdate?: (value: any, form: FormInstanceBase, formItemInstance: FormItemInstanceBase, event: any) => void;
+    /**事件名称*/
+    trigger?: string;
+    /**子元素*/
+    children?: React.ReactNode;
+}
+/**表单项参数*/
+export declare const useFormItemAttr: (options: FormItemAttrOptions) => {
+    children: string | number | boolean | React.ReactElement<any, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode>;
+    form: FormInstanceBase<any>;
+    formItemInstance: FormItemInstanceBase;
+    ruleInstance: RuleInstanceBase;
+    onChange: (event: any) => void;
+    htmlFor: string;
+    validateResult: {
+        tip: string | (string | undefined)[];
+        isInvalid: boolean;
+    };
+};

package/esm/hooks/attr/attr.FormItem.js

@@ -0,0 +1,61 @@
+import * as __WEBPACK_EXTERNAL_MODULE__carefrees_form_utils_f42d2666__ from "@carefrees/form-utils";
+import * as __WEBPACK_EXTERNAL_MODULE__register_register_FormItem_js_448be97f__ from "../register/register.FormItem.js";
+import * as __WEBPACK_EXTERNAL_MODULE__useHtmlFor_js_30172224__ from "../useHtmlFor.js";
+import * as __WEBPACK_EXTERNAL_MODULE_react__ from "react";
+const useFormItemAttr = (options)=>{
+    const { trigger = 'onChange', dependencies, noticeOnlyRuleDataField, isNoticeParentField, noticeWatchField, preserve, valuePropName = 'value', getValuePath = valuePropName, getValueFromEvent, formatValue, onAfterUpdate, useAttrs, useRules, attrs, children, ...rest } = options;
+    const { formItemInstance, form, ruleInstance, newName } = (0, __WEBPACK_EXTERNAL_MODULE__register_register_FormItem_js_448be97f__.useRegisterFormItem)({
+        ...rest
+    });
+    formItemInstance.dependencies = dependencies;
+    formItemInstance.noticeOnlyRuleDataField = noticeOnlyRuleDataField;
+    formItemInstance.isNoticeParentField = isNoticeParentField;
+    formItemInstance.onAfterUpdate = onAfterUpdate;
+    formItemInstance.noticeWatchField = noticeWatchField;
+    formItemInstance.preserve = preserve;
+    const oldValue = form.getFieldValue(newName);
+    const onValueChange = (event)=>{
+        try {
+            let value = event;
+            const target = event?.detail || event?.target;
+            if ('function' == typeof getValueFromEvent) value = getValueFromEvent(event, form, formItemInstance);
+            else if (event && target && 'object' == typeof target && getValuePath in target) value = (0, __WEBPACK_EXTERNAL_MODULE__carefrees_form_utils_f42d2666__.get)(target, getValuePath);
+            if ('function' == typeof formatValue) value = formatValue(value, form, formItemInstance, event);
+            if (oldValue !== value) {
+                form.updatedFieldValue(newName, value, 'validate');
+                formItemInstance.onAfterUpdate?.(value, form, formItemInstance, event);
+                if (Array.isArray(formItemInstance.noticeWatchField) && formItemInstance.noticeWatchField.length) form.noticeWatch(formItemInstance.noticeWatchField);
+                if (Array.isArray(formItemInstance.noticeOnlyRuleDataField) && formItemInstance.noticeOnlyRuleDataField.length) form.onlyValidate(formItemInstance.noticeOnlyRuleDataField);
+                if (formItemInstance.isNoticeParentField && formItemInstance.parentDataField) form.notice(formItemInstance.parentDataField);
+            }
+        } catch (error) {
+            console.log(error);
+        }
+    };
+    formItemInstance.onChange = onValueChange;
+    const htmlFor = (0, __WEBPACK_EXTERNAL_MODULE__useHtmlFor_js_30172224__.useHtmlFor)(newName);
+    formItemInstance.htmlFor = htmlFor;
+    const control = {
+        [trigger]: onValueChange,
+        ...attrs,
+        name: newName,
+        id: htmlFor,
+        [valuePropName]: oldValue
+    };
+    const newControl = useAttrs?.(control, form, formItemInstance) || control;
+    formItemInstance.control = newControl;
+    useRules?.(ruleInstance, form, formItemInstance);
+    const validateResult = (0, __WEBPACK_EXTERNAL_MODULE_react__.useMemo)(()=>ruleInstance.getValidateResult(), [
+        ruleInstance.messages
+    ]);
+    return {
+        children: /*#__PURE__*/ (0, __WEBPACK_EXTERNAL_MODULE_react__.isValidElement)(children) ? /*#__PURE__*/ (0, __WEBPACK_EXTERNAL_MODULE_react__.cloneElement)(children, newControl) : children,
+        form,
+        formItemInstance,
+        ruleInstance,
+        onChange: onValueChange,
+        htmlFor,
+        validateResult
+    };
+};
+export { useFormItemAttr };

package/esm/hooks/register/register.FormHideItem.d.ts

@@ -0,0 +1,9 @@
+import { RegisterFormItemOptions } from './register.FormItem';
+interface RegisterFormHideItemOptions extends Omit<RegisterFormItemOptions, 'rules'> {
+}
+/**注册表单隐藏表单项到表单实例中*/
+export declare const useRegisterFormHideItem: (options: RegisterFormHideItemOptions) => {
+    form: import("@carefrees/form-utils").FormInstanceBase<any>;
+    isHide: any;
+};
+export {};

package/esm/hooks/register/register.FormHideItem.js

@@ -0,0 +1,31 @@
+import * as __WEBPACK_EXTERNAL_MODULE_react__ from "react";
+import * as __WEBPACK_EXTERNAL_MODULE__carefrees_form_utils_f42d2666__ from "@carefrees/form-utils";
+import * as __WEBPACK_EXTERNAL_MODULE__useFormItemParentName_js_a729dfb1__ from "../useFormItemParentName.js";
+import * as __WEBPACK_EXTERNAL_MODULE__useForm_js_2c14e707__ from "../useForm.js";
+import * as __WEBPACK_EXTERNAL_MODULE__useUpdate_js_b5f1687a__ from "../useUpdate.js";
+const useRegisterFormHideItem = (options)=>{
+    const { name, sort, isJoinParentField = true } = options;
+    const form = (0, __WEBPACK_EXTERNAL_MODULE__useForm_js_2c14e707__.useFormInstance)();
+    const _update = (0, __WEBPACK_EXTERNAL_MODULE__useUpdate_js_b5f1687a__.useUpdate)();
+    const { newName, newSort } = (0, __WEBPACK_EXTERNAL_MODULE__useFormItemParentName_js_a729dfb1__.useFormItemParentName)({
+        name,
+        sort,
+        isJoinParentField
+    });
+    const hideItemInstance = (0, __WEBPACK_EXTERNAL_MODULE_react__.useRef)(new __WEBPACK_EXTERNAL_MODULE__carefrees_form_utils_f42d2666__.FormHideItemInstanceBase().ctor(newName)).current;
+    const isHide = form.getFieldHideValue(newName);
+    hideItemInstance.instance = form;
+    hideItemInstance.updated = _update.current;
+    hideItemInstance.sort = newSort;
+    (0, __WEBPACK_EXTERNAL_MODULE_react__.useEffect)(()=>{
+        const unMount = form.registerFormHideItem(hideItemInstance);
+        return ()=>unMount();
+    }, [
+        newName
+    ]);
+    return {
+        form,
+        isHide
+    };
+};
+export { useRegisterFormHideItem };

package/esm/hooks/register/register.FormItem.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @description 注册组件
+ */
+import { RuleInstanceBase } from '@carefrees/form-utils';
+import type { RuleItem } from 'async-validator';
+export interface RegisterFormItemOptions {
+    /**字段*/
+    name: string;
+    /**规则*/
+    rules?: RuleItem[];
+    /**排序值*/
+    sort?: string;
+    /**是否拼接父级字段*/
+    isJoinParentField?: boolean;
+}
+/**注册表单项到表单实例中*/
+export declare const useRegisterFormItem: (options: RegisterFormItemOptions) => {
+    ruleInstance: RuleInstanceBase;
+    formItemInstance: import("@carefrees/form-utils").FormItemInstanceBase;
+    form: import("@carefrees/form-utils").FormInstanceBase<any>;
+    parentName: string;
+    newName: string;
+};

package/esm/hooks/register/register.FormItem.js

@@ -0,0 +1,42 @@
+import * as __WEBPACK_EXTERNAL_MODULE_react__ from "react";
+import * as __WEBPACK_EXTERNAL_MODULE__carefrees_form_utils_f42d2666__ from "@carefrees/form-utils";
+import * as __WEBPACK_EXTERNAL_MODULE__useUpdate_js_b5f1687a__ from "../useUpdate.js";
+import * as __WEBPACK_EXTERNAL_MODULE__useForm_js_2c14e707__ from "../useForm.js";
+import * as __WEBPACK_EXTERNAL_MODULE__useFormItem_js_cd5761e5__ from "../useFormItem.js";
+import * as __WEBPACK_EXTERNAL_MODULE__useFormItemParentName_js_a729dfb1__ from "../useFormItemParentName.js";
+const useRegisterFormItem = (options)=>{
+    const { name, rules, sort, isJoinParentField = true } = options;
+    const form = (0, __WEBPACK_EXTERNAL_MODULE__useForm_js_2c14e707__.useFormInstance)();
+    const { newName, newSort, parentName } = (0, __WEBPACK_EXTERNAL_MODULE__useFormItemParentName_js_a729dfb1__.useFormItemParentName)({
+        name,
+        sort,
+        isJoinParentField
+    });
+    const ruleInstance = (0, __WEBPACK_EXTERNAL_MODULE_react__.useRef)(new __WEBPACK_EXTERNAL_MODULE__carefrees_form_utils_f42d2666__.RuleInstanceBase()).current;
+    (0, __WEBPACK_EXTERNAL_MODULE_react__.useMemo)(()=>ruleInstance.ctor(newName, rules), [
+        rules,
+        newName
+    ]);
+    ruleInstance.instance = form;
+    ruleInstance.sort = newSort;
+    const formItemInstance = (0, __WEBPACK_EXTERNAL_MODULE__useFormItem_js_cd5761e5__.useFormItem)();
+    (0, __WEBPACK_EXTERNAL_MODULE_react__.useMemo)(()=>formItemInstance.ctor(newName, ruleInstance), []);
+    formItemInstance.instance = form;
+    formItemInstance.sort = newSort;
+    formItemInstance.parentDataField = parentName;
+    const _updated = (0, __WEBPACK_EXTERNAL_MODULE__useUpdate_js_b5f1687a__.useUpdate)();
+    formItemInstance.updated = _updated.current;
+    ruleInstance.updated = _updated.current;
+    (0, __WEBPACK_EXTERNAL_MODULE_react__.useEffect)(()=>{
+        const unMount = form.registerFormItem(formItemInstance);
+        return ()=>unMount();
+    }, []);
+    return {
+        ruleInstance,
+        formItemInstance,
+        form,
+        parentName,
+        newName
+    };
+};
+export { useRegisterFormItem };

package/esm/hooks/register/register.FormList.d.ts

@@ -0,0 +1,9 @@
+import { RegisterFormItemOptions } from './register.FormItem';
+export interface RegisterFormListOptions extends RegisterFormItemOptions {
+}
+/**注册表单List到表单实例中*/
+export declare const useRegisterFormList: (options: RegisterFormListOptions) => {
+    ruleInstance: import("@carefrees/form-utils").RuleInstanceBase;
+    formItemInstance: import("@carefrees/form-utils").FormItemInstanceBase;
+    formListInstance: import("@carefrees/form-utils").FormListInstanceBase;
+};

package/esm/hooks/register/register.FormList.js

@@ -0,0 +1,31 @@
+import * as __WEBPACK_EXTERNAL_MODULE_react__ from "react";
+import * as __WEBPACK_EXTERNAL_MODULE__register_FormItem_js_53f62622__ from "./register.FormItem.js";
+import * as __WEBPACK_EXTERNAL_MODULE__useFormList_js_fe5717d9__ from "../useFormList.js";
+const useRegisterFormList = (options)=>{
+    const { ...rest } = options;
+    const { ruleInstance, formItemInstance, form, newName, parentName } = (0, __WEBPACK_EXTERNAL_MODULE__register_FormItem_js_53f62622__.useRegisterFormItem)({
+        ...rest
+    });
+    const formListInstance = (0, __WEBPACK_EXTERNAL_MODULE__useFormList_js_fe5717d9__.useFormList)();
+    (0, __WEBPACK_EXTERNAL_MODULE_react__.useMemo)(()=>formListInstance.ctor(newName), [
+        newName
+    ]);
+    formListInstance.instance = form;
+    formListInstance.rule = ruleInstance;
+    formListInstance.sort = options.sort;
+    formListInstance.formItemInstance = formItemInstance;
+    formListInstance.parentDataField = parentName;
+    (0, __WEBPACK_EXTERNAL_MODULE_react__.useEffect)(()=>{
+        const unMount = form.registerFormList(options.name, formListInstance);
+        return ()=>unMount();
+    }, [
+        options.name,
+        formListInstance
+    ]);
+    return {
+        ruleInstance,
+        formItemInstance,
+        formListInstance
+    };
+};
+export { useRegisterFormList };

package/esm/hooks/register/register.form.d.ts

@@ -0,0 +1,3 @@
+import { FormInstanceBase } from '@carefrees/form-utils';
+/**注册表单实例到多表单收集实例中*/
+export declare const useRegisterForm: (form: FormInstanceBase, name?: string) => import("@carefrees/form-utils").MultipleInstanceBase;

package/esm/hooks/register/register.form.js

@@ -0,0 +1,17 @@
+import * as __WEBPACK_EXTERNAL_MODULE_react__ from "react";
+import * as __WEBPACK_EXTERNAL_MODULE__useMultipleForm_js_ddedf30e__ from "../useMultipleForm.js";
+const useRegisterForm = (form, name)=>{
+    const multipleForm = (0, __WEBPACK_EXTERNAL_MODULE__useMultipleForm_js_ddedf30e__.useMultipleFormInstance)();
+    (0, __WEBPACK_EXTERNAL_MODULE_react__.useEffect)(()=>{
+        let onMounted;
+        if (name) onMounted = multipleForm.ctor(name, form);
+        return ()=>{
+            onMounted?.();
+        };
+    }, [
+        name,
+        form
+    ]);
+    return multipleForm;
+};
+export { useRegisterForm };

package/esm/hooks/useAttrs.d.ts

@@ -0,0 +1,25 @@
+import type { LayoutFormItemProps } from '../layout/layout.formItem';
+export interface AttrsOptions {
+    /**列数据*/
+    colCount?: number;
+    /**规则校验失败错误提示位置*/
+    errorLayout?: LayoutFormItemProps['errorLayout'];
+    /**label显示模式*/
+    labelMode?: LayoutFormItemProps['labelMode'];
+    /**是否显示label后的冒号*/
+    showColon?: boolean;
+    /**表单项 className*/
+    formItemClassName?: string;
+    /**表单项 style*/
+    formItemStyle?: React.CSSProperties;
+    /**表单项 label  className*/
+    formItemLabelClassName?: string;
+    /**表单项 label  style*/
+    formItemLabelStyle?: React.CSSProperties;
+    /**输入框底部边框*/
+    inputBordered?: boolean;
+}
+/**公共属性 Context */
+export declare const AttrsContext: import("react").Context<AttrsOptions>;
+/**子项中获取公共属性*/
+export declare const useAttrs: () => AttrsOptions;

package/esm/hooks/useAttrs.js

@@ -0,0 +1,10 @@
+import * as __WEBPACK_EXTERNAL_MODULE_react__ from "react";
+const AttrsContext = (0, __WEBPACK_EXTERNAL_MODULE_react__.createContext)({
+    colCount: 4,
+    errorLayout: 'left-bottom',
+    labelMode: 'top',
+    showColon: true,
+    inputBordered: true
+});
+const useAttrs = ()=>(0, __WEBPACK_EXTERNAL_MODULE_react__.useContext)(AttrsContext);
+export { AttrsContext, useAttrs };

package/esm/hooks/useForm.d.ts

@@ -0,0 +1,7 @@
+import { FormInstanceBase } from '@carefrees/form-utils';
+/**表单实例 Context */
+export declare const FormInstanceContext: import("react").Context<FormInstanceBase<any>>;
+/**子项中获取表单实例*/
+export declare function useFormInstance<T = any>(): FormInstanceBase<T>;
+/**初始化表单实例*/
+export declare function useForm<T = any>(form?: FormInstanceBase<T>): FormInstanceBase<T>;

package/esm/hooks/useForm.js

@@ -0,0 +1,13 @@
+import * as __WEBPACK_EXTERNAL_MODULE__carefrees_form_utils_f42d2666__ from "@carefrees/form-utils";
+import * as __WEBPACK_EXTERNAL_MODULE_react__ from "react";
+const FormInstanceContext = (0, __WEBPACK_EXTERNAL_MODULE_react__.createContext)(new __WEBPACK_EXTERNAL_MODULE__carefrees_form_utils_f42d2666__.FormInstanceBase());
+function useFormInstance() {
+    return (0, __WEBPACK_EXTERNAL_MODULE_react__.useContext)(FormInstanceContext);
+}
+function useForm(form) {
+    const ref = (0, __WEBPACK_EXTERNAL_MODULE_react__.useRef)();
+    if (!ref.current) if (form) ref.current = form;
+    else ref.current = new __WEBPACK_EXTERNAL_MODULE__carefrees_form_utils_f42d2666__.FormInstanceBase();
+    return ref.current;
+}
+export { FormInstanceContext, useForm, useFormInstance };

package/esm/hooks/useFormItem.d.ts

@@ -0,0 +1,7 @@
+import { FormItemInstanceBase } from '@carefrees/form-utils';
+/**表单项实例 Context */
+export declare const FormItemInstanceContext: import("react").Context<FormItemInstanceBase>;
+/**子项中获取表单项实例*/
+export declare const useFormItemInstance: () => FormItemInstanceBase;
+/**s初始化 表单项实例*/
+export declare const useFormItem: (formItem?: FormItemInstanceBase) => FormItemInstanceBase;

package/esm/hooks/useFormItem.js

@@ -0,0 +1,11 @@
+import * as __WEBPACK_EXTERNAL_MODULE__carefrees_form_utils_f42d2666__ from "@carefrees/form-utils";
+import * as __WEBPACK_EXTERNAL_MODULE_react__ from "react";
+const FormItemInstanceContext = (0, __WEBPACK_EXTERNAL_MODULE_react__.createContext)(new __WEBPACK_EXTERNAL_MODULE__carefrees_form_utils_f42d2666__.FormItemInstanceBase());
+const useFormItemInstance = ()=>(0, __WEBPACK_EXTERNAL_MODULE_react__.useContext)(FormItemInstanceContext);
+const useFormItem = (formItem)=>{
+    const ref = (0, __WEBPACK_EXTERNAL_MODULE_react__.useRef)();
+    if (!ref.current) if (formItem) ref.current = formItem;
+    else ref.current = new __WEBPACK_EXTERNAL_MODULE__carefrees_form_utils_f42d2666__.FormItemInstanceBase();
+    return ref.current;
+};
+export { FormItemInstanceContext, useFormItem, useFormItemInstance };

package/esm/hooks/useFormItemParentName.d.ts

@@ -0,0 +1,30 @@
+export declare const FormItemParentNameContext: import("react").Context<{
+    name: string;
+    sort: string;
+}>;
+export interface FormItemParentNamOptions {
+    /**字段*/
+    name: string;
+    /**排序*/
+    sort?: string;
+    /**是否拼接父级字段*/
+    isJoinParentField?: boolean;
+}
+interface FormItemParentNameProviderProps extends Omit<FormItemParentNamOptions, 'isJoinParentField'> {
+    children?: React.ReactNode;
+}
+export declare const FormItemParentNameProvider: (props: FormItemParentNameProviderProps) => import("react").FunctionComponentElement<import("react").ProviderProps<{
+    name: string;
+    sort: string;
+}>>;
+/**表单项获取父级字段*/
+export declare const useFormItemParentName: (options: FormItemParentNamOptions) => {
+    newName: string;
+    newSort: string;
+    parentItem: {
+        name: string;
+        sort: string;
+    };
+    parentName: string;
+};
+export {};

package/esm/hooks/useFormItemParentName.js

@@ -0,0 +1,61 @@
+import * as __WEBPACK_EXTERNAL_MODULE_react__ from "react";
+const FormItemParentNameContext = (0, __WEBPACK_EXTERNAL_MODULE_react__.createContext)({
+    name: '',
+    sort: ''
+});
+const FormItemParentNameProvider = (props)=>{
+    const { name, sort, children } = props;
+    const value = (0, __WEBPACK_EXTERNAL_MODULE_react__.useMemo)(()=>({
+            name,
+            sort
+        }), [
+        name,
+        sort
+    ]);
+    return (0, __WEBPACK_EXTERNAL_MODULE_react__.createElement)(FormItemParentNameContext.Provider, {
+        value,
+        children
+    });
+};
+const useFormItemParentName = (options)=>{
+    const { isJoinParentField = true, sort, name } = options;
+    const parentItem = (0, __WEBPACK_EXTERNAL_MODULE_react__.useContext)(FormItemParentNameContext);
+    const parentName = parentItem.name;
+    const parentSort = parentItem.sort;
+    const newName = (0, __WEBPACK_EXTERNAL_MODULE_react__.useMemo)(()=>{
+        if (parentName && isJoinParentField) {
+            if (/^\./.test(`${name}`)) ;
+            else if (name) return [
+                parentName,
+                '.',
+                name
+            ].filter(Boolean).join('');
+            return [
+                parentName,
+                name
+            ].filter(Boolean).join('');
+        }
+        return [
+            name
+        ].filter(Boolean).join('');
+    }, [
+        isJoinParentField,
+        name,
+        parentName
+    ]);
+    const newSort = (0, __WEBPACK_EXTERNAL_MODULE_react__.useMemo)(()=>[
+            isJoinParentField ? parentSort : '',
+            sort
+        ].filter(Boolean).join('-'), [
+        isJoinParentField,
+        parentSort,
+        sort
+    ]);
+    return {
+        newName,
+        newSort,
+        parentItem,
+        parentName: parentName
+    };
+};
+export { FormItemParentNameContext, FormItemParentNameProvider, useFormItemParentName };

package/esm/hooks/useFormList.d.ts

@@ -0,0 +1,7 @@
+import { FormListInstanceBase } from '@carefrees/form-utils';
+/**表单List实例 Context */
+export declare const FormListInstanceContext: import("react").Context<FormListInstanceBase>;
+/**子项中获取表单List实例*/
+export declare const useFormListInstance: () => FormListInstanceBase;
+/**初始化 表单List实例*/
+export declare const useFormList: (formList?: FormListInstanceBase) => FormListInstanceBase;

package/esm/hooks/useFormList.js

@@ -0,0 +1,11 @@
+import * as __WEBPACK_EXTERNAL_MODULE__carefrees_form_utils_f42d2666__ from "@carefrees/form-utils";
+import * as __WEBPACK_EXTERNAL_MODULE_react__ from "react";
+const FormListInstanceContext = (0, __WEBPACK_EXTERNAL_MODULE_react__.createContext)(new __WEBPACK_EXTERNAL_MODULE__carefrees_form_utils_f42d2666__.FormListInstanceBase());
+const useFormListInstance = ()=>(0, __WEBPACK_EXTERNAL_MODULE_react__.useContext)(FormListInstanceContext);
+const useFormList = (formList)=>{
+    const ref = (0, __WEBPACK_EXTERNAL_MODULE_react__.useRef)();
+    if (!ref.current) if (formList) ref.current = formList;
+    else ref.current = new __WEBPACK_EXTERNAL_MODULE__carefrees_form_utils_f42d2666__.FormListInstanceBase();
+    return ref.current;
+};
+export { FormListInstanceContext, useFormList, useFormListInstance };

package/esm/hooks/useHtmlFor.d.ts

@@ -0,0 +1 @@
+export declare const useHtmlFor: (suffix: string) => string;