feat(FormApi): add array methods carray methods clearValues and filterValues

Author: Pascalmh

packages/form-core/tests/FormApi.spec.ts

@@ -2907,4 +2907,26 @@ describe('form api', () => {
     expect(form.state.isValid).toBe(false)
     expect(form.state.canSubmit).toBe(true)
   })
+
+  it('should delete fields when resetting an array field to an empty array', () => {
+    const employees = [
+      {
+        firstName: 'Darcy',
+      },
+    ] as const
+
+    const form = new FormApi({
+      defaultValues: {
+        employees,
+      },
+    })
+    form.mount()
+
+    form.clearValues('employees')
+
+    expect(form.getFieldValue('employees')).toEqual([])
+    expect(form.getFieldValue(`employees[0]`)).toBeUndefined()
+    expect(form.getFieldMeta(`employees[0]`)).toBeUndefined()
+    expect(form.state.values.employees).toStrictEqual([])
+  })
 })