fix: refactor to flat generics with consistent names & patterns

Author: tannerlinsley

docs/framework/react/reference/Field.md

@@ -3,42 +3,47 @@ id: field
 title: Field
 ---
 
-### `FieldComponent<TFormData>`
+### `FieldComponent<TParentData>`
 
 A type alias representing a field component for a specific form data type.
 
 ```tsx
-export type FieldComponent = <TField extends DeepKeys<TFormData>>({
+export type FieldComponent = <TField extends DeepKeys<TParentData>>({
   children,
   ...fieldOptions
 }: {
-  children: (fieldApi: FieldApi<DeepValue<TFormData, TField>, TFormData>) => any
+  children: (
+    fieldApi: FieldApi<DeepValue<TParentData, TField>, TParentData>,
+  ) => any
   name: TField
-} & Omit<FieldOptions<DeepValue<TFormData, TField>, TFormData>, 'name'>) => any
+} & Omit<
+  FieldOptions<DeepValue<TParentData, TField>, TParentData>,
+  'name'
+>) => any
 ```
 
 A function component that takes field options and a render function as children and returns a React component.
 
 ### `Field`
 
 ```tsx
-export function Field<TData, TFormData>({
+export function Field<TData, TParentData>({
   children,
   ...fieldOptions
-}: { children: (fieldApi: FieldApi<TData, TFormData>) => any } & FieldOptions<
+}: { children: (fieldApi: FieldApi<TData, TParentData>) => any } & FieldOptions<
   TData,
-  TFormData
+  TParentData
 >): any
 ```
 
 A functional React component that renders a form field.
 
 - ```tsx
-  children: (fieldApi: FieldApi<TData, TFormData>) => any
+  children: (fieldApi: FieldApi<TData, TParentData>) => any
   ```
   - A render function that takes a field API instance and returns a React element.
 - ```tsx
-  fieldOptions: FieldOptions<TData, TFormData>
+  fieldOptions: FieldOptions<TData, TParentData>
   ```
   - The field options.
 
@@ -47,14 +52,14 @@ The `Field` component uses the `useField` hook internally to manage the field in
 ### `createFieldComponent`
 
 ```tsx
-export function createFieldComponent<TFormData>(
-  formApi: FormApi<TFormData>,
-): FieldComponent<TFormData>
+export function createFieldComponent<TParentData>(
+  formApi: FormApi<TParentData>,
+): FieldComponent<TParentData>
 ```
 
 A factory function that creates a connected field component for a specific form API instance.
 
 - ```tsx
-  formApi: FormApi<TFormData>
+  formApi: FormApi<TParentData>
   ```
   - The form API instance to connect the field component to.

docs/framework/react/reference/fieldApi.md

@@ -3,11 +3,11 @@ id: fieldApi
 title: Field API
 ---
 
-### `FieldApi<TData, TFormData>`
+### `FieldApi<TData, TParentData>`
 
 When using `@tanstack/react-form`, the [core field API](../../reference/fieldApi) is extended with additional methods for React-specific functionality:
 
 - ```tsx
-  Field: FieldComponent<TData, TFormData>
+  Field: FieldComponent<TData, TParentData>
   ```
   - A pre-bound and type-safe sub-field component using this field as a root.

docs/framework/react/reference/useField.md

@@ -3,49 +3,49 @@ id: useField
 title: useField
 ---
 
-### `UseField<TFormData>`
+### `UseField<TParentData>`
 
 A type representing a hook for using a field in a form with the given form data type.
 
 ```tsx
-export type UseField = <TField extends DeepKeys<TFormData>>(
+export type UseField = <TField extends DeepKeys<TParentData>>(
   opts?: { name: TField } & FieldOptions<
-    DeepValue<TFormData, TField>,
-    TFormData
+    DeepValue<TParentData, TField>,
+    TParentData
   >,
-) => FieldApi<DeepValue<TFormData, TField>, TFormData>
+) => FieldApi<DeepValue<TParentData, TField>, TParentData>
 ```
 
 - A function that takes an optional object with a `name` property and field options, and returns a `FieldApi` instance for the specified field.
 
 ### `useField`
 
 ```tsx
-export function useField<TData, TFormData>(
-  opts: FieldOptions<TData, TFormData>,
-): FieldApi<TData, TFormData>
+export function useField<TData, TParentData>(
+  opts: FieldOptions<TData, TParentData>,
+): FieldApi<TData, TParentData>
 ```
 
 A hook for managing a field in a form.
 
 - ```tsx
-  opts: FieldOptions<TData, TFormData>
+  opts: FieldOptions<TData, TParentData>
   ```
   - An object with field options.
 
 #### Returns
 
 - ```tsx
-  FieldApi<TData, TFormData>
+  FieldApi<TData, TParentData>
   ```
   - The `FieldApi` instance for the specified field.
 
 ### `createUseField`
 
 ```tsx
-export function createUseField<TFormData>(
-  formApi: FormApi<TFormData>,
-): UseField<TFormData>
+export function createUseField<TParentData>(
+  formApi: FormApi<TParentData>,
+): UseField<TParentData>
 ```
 
 A function that creates a `UseField` hook bound to the given `formApi`.

docs/reference/fieldApi.md

@@ -11,14 +11,14 @@ Normally, you will not need to create a new `FieldApi` instance directly. Instea
 const fieldApi: FieldApi<TData> = new FieldApi(formOptions: Field Options<TData>)
 ```
 
-### `FieldOptions<TData, TFormData>`
+### `FieldOptions<TData, TParentData>`
 
 An object type representing the options for a field in a form.
 
 - ```tsx
   name
   ```
-  - The field name. If `TFormData` is `unknown`, the type will be `string`. Otherwise, it will be `DeepKeys<TFormData>`.
+  - The field name. If `TParentData` is `unknown`, the type will be `string`. Otherwise, it will be `DeepKeys<TParentData>`.
 - ```tsx
   defaultValue?: TData
   ```
@@ -30,19 +30,19 @@ An object type representing the options for a field in a form.
   - An optional object with default metadata for the field.
 
 - ```tsx
-  onMount?: (formApi: FieldApi<TData, TFormData>) => void
+  onMount?: (formApi: FieldApi<TData, TParentData>) => void
   ```
 
-  - An optional function that takes a param of `formApi` which is a generic type of `TData` and `TFormData`
+  - An optional function that takes a param of `formApi` which is a generic type of `TData` and `TParentData`
 
 - ```tsx
-   onChange?: ValidateFn<TData, TFormData>
+   onChange?: ValidateFn<TData, TParentData>
   ```
 
-  - An optional property that takes a `ValidateFn` which is a generic of `TData` and `TFormData`
+  - An optional property that takes a `ValidateFn` which is a generic of `TData` and `TParentData`
 
 - ```tsx
-    onChangeAsync?: ValidateAsyncFn<TData, TFormData>
+    onChangeAsync?: ValidateAsyncFn<TData, TParentData>
   ```
 
   - An optional property similar to `onChange` but async validation
@@ -55,16 +55,16 @@ An object type representing the options for a field in a form.
   - If set to a number larger than 0, will debounce the async validation event by this length of time in milliseconds
 
 - ```tsx
-    onBlur?: ValidateFn<TData, TFormData>
+    onBlur?: ValidateFn<TData, TParentData>
   ```
 
   - An optional function, when that run when subscribing to blur event of input
 
 - ```tsx
-   onBlurAsync?: ValidateAsyncFn<TData, TFormData>
+   onBlurAsync?: ValidateAsyncFn<TData, TParentData>
   ```
 
-  - An optional function that takes a `ValidateFn` which is a generic of `TData` and `TFormData` happens async
+  - An optional function that takes a `ValidateFn` which is a generic of `TData` and `TParentData` happens async
 
   ```tsx
   onBlurAsyncDebounceMs?: number
@@ -110,13 +110,13 @@ An object type representing the metadata of a field in a form.
   ```
   - A flag indicating whether the field is currently being validated.
 
-### `FieldApiOptions<TData, TFormData>`
+### `FieldApiOptions<TData, TParentData>`
 
 An object type representing the required options for the `FieldApi` class.
 
-- Inherits from `FieldOptions<TData, TFormData>` with the `form` property set as required.
+- Inherits from `FieldOptions<TData, TParentData>` with the `form` property set as required.
 
-### `FieldApi<TData, TFormData>`
+### `FieldApi<TData, TParentData>`
 
 A class representing the API for managing a form field.
 
@@ -127,11 +127,11 @@ A class representing the API for managing a form field.
   ```
   - A unique identifier for the field instance.
 - ```tsx
-  form: FormApi<TFormData>
+  form: FormApi<TParentData>
   ```
   - A reference to the form API instance.
 - ```tsx
-  name: DeepKeys<TFormData>
+  name: DeepKeys<TParentData>
   ```
   - The field name.
 - ```tsx
@@ -143,14 +143,14 @@ A class representing the API for managing a form field.
   ```
   - The current field state.
 - ```tsx
-  options: RequiredByKey<FieldOptions<TData, TFormData>, 'validateOn'>
+  options: RequiredByKey<FieldOptions<TData, TParentData>, 'validateOn'>
   ```
   - The field options with the `validateOn` property set as required.
 
 #### Methods
 
 - ```tsx
-  constructor(opts: FieldApiOptions<TData, TFormData>)
+  constructor(opts: FieldApiOptions<TData, TParentData>)
   ```
   - Initializes a new `FieldApi` instance.
 - ```tsx
@@ -162,7 +162,7 @@ A class representing the API for managing a form field.
   ```
   - Updates the field store with the latest form state.
 - ```tsx
-  update(opts: FieldApiOptions<TData, TFormData>): void
+  update(opts: FieldApiOptions<TData, TParentData>): void
   ```
   - Updates the field instance with new options.
 - ```tsx
@@ -202,7 +202,7 @@ A class representing the API for managing a form field.
   ```
   - Swaps the values at the specified indices.
 - ```tsx
-  getSubField<TName extends DeepKeys<TData>>(name: TName): FieldApi<DeepValue<TData, TName>, TFormData>
+  getSubField<TName extends DeepKeys<TData>>(name: TName): FieldApi<DeepValue<TData, TName>, TParentData>
   ```
   - Gets a subfield instance.
 - ```tsx