@tanstack/form-core 0.20.3 → 0.21.1

package/src/tests/FormApi.spec.ts

@@ -324,6 +324,23 @@ describe('form api', () => {
     expect(form.getFieldValue('names')).toStrictEqual(['test', 'other'])
   })
 
+  it("should insert an array field's value as first element", () => {
+    const form = new FormApi({
+      defaultValues: {
+        names: ['one', 'two', 'three'],
+      },
+    })
+    form.mount()
+    form.insertFieldValue('names', 0, 'other')
+
+    expect(form.getFieldValue('names')).toStrictEqual([
+      'other',
+      'one',
+      'two',
+      'three',
+    ])
+  })
+
   it("should run onChange validation when pushing an array field's value", () => {
     const form = new FormApi({
       defaultValues: {
@@ -352,9 +369,55 @@ describe('form api', () => {
     form.mount()
     form.insertFieldValue('names', 1, 'other')
 
+    expect(form.getFieldValue('names')).toStrictEqual([
+      'one',
+      'other',
+      'two',
+      'three',
+    ])
+  })
+
+  it("should insert an array field's value at the end if the index is higher than the length", () => {
+    const form = new FormApi({
+      defaultValues: {
+        names: ['one', 'two', 'three'],
+      },
+    })
+    form.mount()
+    form.insertFieldValue('names', 10, 'other')
+
+    expect(form.getFieldValue('names')).toStrictEqual([
+      'one',
+      'two',
+      'three',
+      'other',
+    ])
+  })
+
+  it("should replace an array field's value", () => {
+    const form = new FormApi({
+      defaultValues: {
+        names: ['one', 'two', 'three'],
+      },
+    })
+    form.mount()
+    form.replaceFieldValue('names', 1, 'other')
+
     expect(form.getFieldValue('names')).toStrictEqual(['one', 'other', 'three'])
   })
 
+  it("should do nothing when replacing an array field's value with an index that doesn't exist", () => {
+    const form = new FormApi({
+      defaultValues: {
+        names: ['one', 'two', 'three'],
+      },
+    })
+    form.mount()
+    form.replaceFieldValue('names', 10, 'other')
+
+    expect(form.getFieldValue('names')).toStrictEqual(['one', 'two', 'three'])
+  })
+
   it("should run onChange validation when inserting an array field's value", () => {
     const form = new FormApi({
       defaultValues: {
@@ -400,7 +463,7 @@ describe('form api', () => {
 
     expect(field1.state.meta.errors).toStrictEqual([])
 
-    await form.insertFieldValue('names', 0, { first: 'other' })
+    await form.replaceFieldValue('names', 0, { first: 'other' })
 
     expect(field1.state.meta.errors).toStrictEqual(['Invalid value'])
   })

package/src/tests/util-types.test-d.ts

@@ -41,6 +41,18 @@ assertType<
   | 'meta.mainUser.age'
 >(0 as never as NestedSupport)
 
+/**
+ * Properly handles deep partial object nesting like so:
+ */
+type NestedPartialSupport = DeepKeys<{ meta?: { mainUser?: User } }>
+assertType<
+  | 'meta'
+  | 'meta.mainUser'
+  | 'meta.mainUser.name'
+  | 'meta.mainUser.id'
+  | 'meta.mainUser.age'
+>(0 as never as NestedPartialSupport)
+
 /**
  * Properly handles `object` edgecase nesting like so:
  */

package/src/util-types.ts

@@ -60,7 +60,7 @@ type PrefixTupleAccessor<
 }[TIndex]
 
 type PrefixObjectAccessor<T extends object, TDepth extends any[]> = {
-  [K in keyof T]: K extends string | number
+  [K in keyof T]-?: K extends string | number
     ?
         | PrefixFromDepth<K, TDepth>
         | `${PrefixFromDepth<K, TDepth>}${DeepKeys<T[K], [TDepth]>}`
@@ -71,19 +71,17 @@ export type DeepKeys<T, TDepth extends any[] = []> = TDepth['length'] extends 5
   ? never
   : unknown extends T
     ? PrefixFromDepth<string, TDepth>
-    : object extends T
-      ? PrefixFromDepth<string, TDepth>
-      : T extends readonly any[] & IsTuple<T>
-        ? PrefixTupleAccessor<T, AllowedIndexes<T>, TDepth>
-        : T extends any[]
-          ? PrefixArrayAccessor<T, [...TDepth, any]>
-          : T extends Date
-            ? never
-            : T extends object
-              ? PrefixObjectAccessor<T, TDepth>
-              : T extends string | number | boolean | bigint
-                ? ''
-                : never
+    : T extends readonly any[] & IsTuple<T>
+      ? PrefixTupleAccessor<T, AllowedIndexes<T>, TDepth>
+      : T extends any[]
+        ? PrefixArrayAccessor<T, [...TDepth, any]>
+        : T extends Date
+          ? never
+          : T extends object
+            ? PrefixObjectAccessor<T, TDepth>
+            : T extends string | number | boolean | bigint
+              ? ''
+              : never
 
 type PrefixFromDepth<
   T extends string | number,