feat(rule): support for using the values of other fields in the form in rule functions

src/index.test.ts

@@ -564,4 +564,53 @@ describe('object type field', () => {
     expect(wr.status.obj.isError).true
     expect(wr.status.obj.message).toBe('need truthy')
   })
+
+  // rule callback 可以通过 full 参数获取表单其它的值
+  it('rule callback full params', async () => {
+    const wrapper = useSetup(() => {
+      const { form, status, isError } = useForm({
+        form: () => ({
+          password1: '',
+          password2: '',
+        }),
+        rule: {
+          password1: val => !!val || 'required',
+          password2: (val, full) => full.password1 === val || 'no equal',
+        },
+      })
+      return { form, status, isError }
+    })
+
+    await nextTick()
+    // age
+    expect(wrapper.status.password1.isError).false
+    expect(wrapper.status.password1.message).toBe('')
+    // name
+    expect(wrapper.status.password2.isError).false
+    expect(wrapper.status.password2.message).toBe('')
+    // any error
+    expect(wrapper.isError).false
+
+    wrapper.form.password1 = '123456'
+    await nextTick()
+    expect(wrapper.status.password2.isError).false
+    expect(wrapper.status.password2.message).toBe('')
+
+    wrapper.form.password1 = ''
+    await nextTick()
+    expect(wrapper.status.password2.isError).false
+    expect(wrapper.status.password2.message).toBe('')
+
+    wrapper.form.password2 = '654321'
+    await nextTick()
+    expect(wrapper.status.password2.isError).true
+    expect(wrapper.status.password2.message).toBe('no equal')
+
+    wrapper.form.password1 = '654321'
+    await nextTick()
+    expect(wrapper.status.password2.isError).false
+    expect(wrapper.status.password2.message).toBe('')
+
+    wrapper.unmount()
+  })
 })

src/type/form.ts

@@ -2,16 +2,16 @@ import type { ComputedRef, DeepReadonly, UnwrapNestedRefs } from 'vue'
 import type { FormStatus } from './formStatus'
 import type { Submitter } from './submitter'
 
-export type RuleItem<ValueT = any> = ((val: ValueT) => boolean | string)
+export type RuleItem<ValueT = unknown, FormT = unknown> = ((val: ValueT, full: DeepReadonly<FormT>) => boolean | string)
 
-export type UseFormBuilder<Form extends {} = {}> = () => Form
-export type UseFormRule<FormT extends {}> = {
-  readonly [K in keyof FormT]?: RuleItem<FormT[K]> | RuleItem<FormT[K]>[]
+export type UseFormBuilder<Form extends object> = () => Form
+export type UseFormRule<FormT> = {
+  readonly [K in keyof FormT]?: RuleItem<FormT[K], FormT> | RuleItem<FormT[K], FormT>[]
 }
 export type UseFormDefaultMessage = string
 export type UseFormLazy = boolean
 
-export interface UseFormParam<FormT> {
+export interface UseFormParam<FormT extends object> {
   /** Initial form value */
   form: UseFormBuilder<FormT>
   /** Verification rules */

src/type/formStatus.ts

@@ -15,6 +15,6 @@ export interface StatusItem {
   _ignoreUpdate: IgnoredUpdater
 }
 
-export type FormStatus<FormT extends {}> = {
+export type FormStatus<FormT> = {
   readonly [K in keyof FormT]: StatusItem
 }

src/type/submitter.ts

@@ -1,9 +1,9 @@
 import type { Ref } from 'vue'
 import type { UseFormReturn } from './form'
 
-export type SubmitFunction<FormT = any, FnReturnT = any> = (formData: Omit<UseFormReturn<FormT>, 'submitter'>) => FnReturnT
+export type SubmitFunction<FormT extends object = any, FnReturnT = any> = (formData: Omit<UseFormReturn<FormT>, 'submitter'>) => FnReturnT
 
-export type Submitter<FormT extends {}> = <FnT extends SubmitFunction<FormT>>(
+export type Submitter<FormT extends object> = <FnT extends SubmitFunction<FormT>>(
   fn: FnT,
   options?: CreateSubmitOptions,
 ) => CreateSubmitReturn<FnT>