Merge branch 'main' into main

xStrixU · web-flow · commit 5f2678b705cb · 2025-03-20T16:26:10.000+01:00
diff --git a/docs/framework/lit/reference/classes/tanstackformcontroller.md b/docs/framework/lit/reference/classes/tanstackformcontroller.md
@@ -77,7 +77,7 @@ Defined in: [tanstack-form-controller.ts:206](https://github.com/TanStack/form/b
 field<TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync>(fieldConfig, render): object
 ```
 
-Defined in: [tanstack-form-controller.ts:260](https://github.com/TanStack/form/blob/main/packages/lit-form/src/tanstack-form-controller.ts#L260)
+Defined in: [tanstack-form-controller.ts:259](https://github.com/TanStack/form/blob/main/packages/lit-form/src/tanstack-form-controller.ts#L259)
 
 #### Type Parameters
 
@@ -145,7 +145,7 @@ render: renderCallback<TParentData, TName, TData, TOnMount, TOnChange, TOnChange
 hostConnected(): void
 ```
 
-Defined in: [tanstack-form-controller.ts:250](https://github.com/TanStack/form/blob/main/packages/lit-form/src/tanstack-form-controller.ts#L250)
+Defined in: [tanstack-form-controller.ts:249](https://github.com/TanStack/form/blob/main/packages/lit-form/src/tanstack-form-controller.ts#L249)
 
 Called when the host is connected to the component tree. For custom
 element hosts, this corresponds to the `connectedCallback()` lifecycle,
@@ -169,7 +169,7 @@ ReactiveController.hostConnected
 hostDisconnected(): void
 ```
 
-Defined in: [tanstack-form-controller.ts:256](https://github.com/TanStack/form/blob/main/packages/lit-form/src/tanstack-form-controller.ts#L256)
+Defined in: [tanstack-form-controller.ts:255](https://github.com/TanStack/form/blob/main/packages/lit-form/src/tanstack-form-controller.ts#L255)
 
 Called when the host is disconnected from the component tree. For custom
 element hosts, this corresponds to the `disconnectedCallback()` lifecycle,
diff --git a/docs/framework/react/guides/reactivity.md b/docs/framework/react/guides/reactivity.md
@@ -49,4 +49,4 @@ The `form.Subscribe` component is best suited when you need to react to somethin
 
 > The `form.Subscribe` component doesn't trigger component-level re-renders. Anytime the value subscribed to changes, only the `form.Subscribe` component re-renders.
 
-The choice between whether to use `useStore` or `form.Subscibe` mainly boils down to that if it's rendered in the ui, reach for `form.Subscribe` for its optimizations perks, and if you need the reactivity within the logic, then `useStore` is the choice to make.
+The choice between whether to use `useStore` or `form.Subscribe` mainly boils down to that if it's rendered in the ui, reach for `form.Subscribe` for its optimizations perks, and if you need the reactivity within the logic, then `useStore` is the choice to make.
diff --git a/docs/framework/react/guides/ssr.md b/docs/framework/react/guides/ssr.md
@@ -102,7 +102,12 @@ Finally, we'll use `getFormDataFromServer` in our loader to get the state from o
 ```tsx
 // app/routes/index.tsx
 import { createFileRoute } from '@tanstack/react-router'
-import { mergeForm, useForm, useTransform } from '@tanstack/react-form'
+import {
+  mergeForm,
+  useForm,
+  useStore,
+  useTransform,
+} from '@tanstack/react-form'
 
 export const Route = createFileRoute('/')({
   component: Home,
@@ -241,7 +246,12 @@ Finally, we'll use `someAction` in our client-side form component.
 import { useActionState } from 'react'
 import { initialFormState } from '@tanstack/react-form/nextjs'
 // Notice the import is from `react-form`, not `react-form/nextjs`
-import { mergeForm, useForm, useTransform } from '@tanstack/react-form'
+import {
+  mergeForm,
+  useForm,
+  useStore,
+  useTransform,
+} from '@tanstack/react-form'
 import someAction from './action'
 import { formOpts } from './shared-code'
 
@@ -385,7 +395,12 @@ Finally, the `action` will be called when the form submits.
 // routes/_index/route.tsx
 import { Form, useActionData } from '@remix-run/react'
 
-import { mergeForm, useForm, useTransform } from '@tanstack/react-form'
+import {
+  mergeForm,
+  useForm,
+  useStore,
+  useTransform,
+} from '@tanstack/react-form'
 import {
   ServerValidateError,
   createServerValidate,
diff --git a/docs/framework/vue/quick-start.md b/docs/framework/vue/quick-start.md
@@ -23,15 +23,7 @@ const form = useForm({
 
 <template>
   <div>
-    <form
-      @submit="
-        (e) => {
-          e.preventDefault()
-          e.stopPropagation()
-          form.handleSubmit()
-        }
-      "
-    >
+    <form @submit.prevent.stop="form.handleSubmit">
       <div>
         <form.Field name="fullName">
           <template v-slot="{ field }">
diff --git a/docs/reference/classes/fieldapi.md b/docs/reference/classes/fieldapi.md
@@ -163,7 +163,7 @@ The current field state.
 getInfo(): FieldInfo<TParentData>
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1216](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1216)
+Defined in: [packages/form-core/src/FieldApi.ts:1217](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1217)
 
 Gets the field information object.
 
@@ -179,7 +179,7 @@ Gets the field information object.
 getMeta(): FieldMeta<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync>
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1184](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1184)
+Defined in: [packages/form-core/src/FieldApi.ts:1185](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1185)
 
 #### Returns
 
@@ -193,7 +193,7 @@ Defined in: [packages/form-core/src/FieldApi.ts:1184](https://github.com/TanStac
 getValue(): TData
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1166](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1166)
+Defined in: [packages/form-core/src/FieldApi.ts:1167](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1167)
 
 Gets the current field value.
 
@@ -254,7 +254,7 @@ insertValue(
    opts?): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1236](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1236)
+Defined in: [packages/form-core/src/FieldApi.ts:1237](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1237)
 
 Inserts a value at the specified index, shifting the subsequent values to the right.
 
@@ -284,7 +284,7 @@ Inserts a value at the specified index, shifting the subsequent values to the ri
 mount(): () => void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1072](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1072)
+Defined in: [packages/form-core/src/FieldApi.ts:1067](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1067)
 
 Mounts the field instance to the form.
 
@@ -307,7 +307,7 @@ moveValue(
    opts?): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1292](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1292)
+Defined in: [packages/form-core/src/FieldApi.ts:1293](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1293)
 
 Moves the value at the first specified index to the second specified index.
 
@@ -337,7 +337,7 @@ Moves the value at the first specified index to the second specified index.
 pushValue(value, opts?): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1221](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1221)
+Defined in: [packages/form-core/src/FieldApi.ts:1222](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1222)
 
 Pushes a new value to the field.
 
@@ -363,7 +363,7 @@ Pushes a new value to the field.
 removeValue(index, opts?): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1268](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1268)
+Defined in: [packages/form-core/src/FieldApi.ts:1269](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1269)
 
 Removes a value at the specified index.
 
@@ -392,7 +392,7 @@ replaceValue(
    opts?): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1252](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1252)
+Defined in: [packages/form-core/src/FieldApi.ts:1253](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1253)
 
 Replaces a value at the specified index.
 
@@ -444,7 +444,7 @@ Updates the field's errorMap
 setMeta(updater): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1189](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1189)
+Defined in: [packages/form-core/src/FieldApi.ts:1190](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1190)
 
 Sets the field metadata.
 
@@ -466,7 +466,7 @@ Sets the field metadata.
 setValue(updater, options?): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1173](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1173)
+Defined in: [packages/form-core/src/FieldApi.ts:1174](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1174)
 
 Sets the field value and run the `change` validator.
 
@@ -495,7 +495,7 @@ swapValues(
    opts?): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1280](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1280)
+Defined in: [packages/form-core/src/FieldApi.ts:1281](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1281)
 
 Swaps the values at the specified indices.
 
@@ -525,7 +525,7 @@ Swaps the values at the specified indices.
 update(opts): void
 ```
 
-Defined in: [packages/form-core/src/FieldApi.ts:1114](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1114)
+Defined in: [packages/form-core/src/FieldApi.ts:1115](https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1115)
 
 Updates the field instance with new options.
 
diff --git a/examples/angular/array/package.json b/examples/angular/array/package.json
@@ -18,7 +18,7 @@
     "@angular/platform-browser": "^19.2.0",
     "@angular/platform-browser-dynamic": "^19.2.0",
     "@angular/router": "^19.2.0",
-    "@tanstack/angular-form": "^1.1.0",
+    "@tanstack/angular-form": "^1.1.2",
     "rxjs": "^7.8.2",
     "tslib": "^2.8.1",
     "zone.js": "^0.15.0"
diff --git a/examples/angular/simple/package.json b/examples/angular/simple/package.json
@@ -18,7 +18,7 @@
     "@angular/platform-browser": "^19.2.0",
     "@angular/platform-browser-dynamic": "^19.2.0",
     "@angular/router": "^19.2.0",
-    "@tanstack/angular-form": "^1.1.0",
+    "@tanstack/angular-form": "^1.1.2",
     "rxjs": "^7.8.2",
     "tslib": "^2.8.1",
     "zone.js": "^0.15.0"
diff --git a/examples/lit/simple/package.json b/examples/lit/simple/package.json
@@ -9,7 +9,7 @@
     "test:types": "tsc"
   },
   "dependencies": {
-    "@tanstack/lit-form": "^1.1.0",
+    "@tanstack/lit-form": "^1.1.2",
     "lit": "^3.2.1"
   },
   "devDependencies": {
diff --git a/examples/lit/ui-libraries/package.json b/examples/lit/ui-libraries/package.json
@@ -10,7 +10,7 @@
   },
   "dependencies": {
     "@material/web": "^2.2.0",
-    "@tanstack/lit-form": "^1.1.0",
+    "@tanstack/lit-form": "^1.1.2",
     "lit": "^3.2.1"
   },
   "devDependencies": {
diff --git a/examples/react/array/package.json b/examples/react/array/package.json
@@ -9,7 +9,7 @@
     "test:types": "tsc"
   },
   "dependencies": {
-    "@tanstack/react-form": "^1.1.0",
+    "@tanstack/react-form": "^1.1.2",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"
   },
diff --git a/examples/react/compiler/package.json b/examples/react/compiler/package.json
@@ -9,7 +9,7 @@
     "_test:types": "tsc"
   },
   "dependencies": {
-    "@tanstack/react-form": "^1.1.0",
+    "@tanstack/react-form": "^1.1.2",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"
   },
diff --git a/examples/react/field-errors-from-form-validators/package.json b/examples/react/field-errors-from-form-validators/package.json
@@ -9,7 +9,7 @@
     "test:types": "tsc"
   },
   "dependencies": {
-    "@tanstack/react-form": "^1.1.0",
+    "@tanstack/react-form": "^1.1.2",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"
   },
diff --git a/examples/react/large-form/package.json b/examples/react/large-form/package.json
@@ -9,7 +9,7 @@
     "test:types": "tsc"
   },
   "dependencies": {
-    "@tanstack/react-form": "^1.1.0",
+    "@tanstack/react-form": "^1.1.2",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"
   },
diff --git a/examples/react/next-server-actions/package.json b/examples/react/next-server-actions/package.json
@@ -8,7 +8,7 @@
     "_test:types": "tsc"
   },
   "dependencies": {
-    "@tanstack/react-form": "^1.1.0",
+    "@tanstack/react-form": "^1.1.2",
     "@tanstack/react-store": "^0.7.0",
     "next": "15.1.7",
     "react": "^19.0.0",
diff --git a/examples/react/query-integration/package.json b/examples/react/query-integration/package.json
@@ -9,7 +9,7 @@
     "test:types": "tsc"
   },
   "dependencies": {
-    "@tanstack/react-form": "^1.1.0",
+    "@tanstack/react-form": "^1.1.2",
     "@tanstack/react-query": "^5.64.1",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"
diff --git a/examples/react/remix/package.json b/examples/react/remix/package.json
@@ -11,7 +11,7 @@
     "@remix-run/node": "^2.15.3",
     "@remix-run/react": "^2.15.3",
     "@remix-run/serve": "^2.15.3",
-    "@tanstack/react-form": "^1.1.0",
+    "@tanstack/react-form": "^1.1.2",
     "@tanstack/react-store": "^0.7.0",
     "isbot": "^5.1.17",
     "react": "^19.0.0",
diff --git a/examples/react/simple/package.json b/examples/react/simple/package.json
@@ -9,7 +9,7 @@
     "test:types": "tsc"
   },
   "dependencies": {
-    "@tanstack/react-form": "^1.1.0",
+    "@tanstack/react-form": "^1.1.2",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"
   },
diff --git a/examples/react/standard-schema/package.json b/examples/react/standard-schema/package.json
@@ -9,7 +9,7 @@
     "test:types": "tsc"
   },
   "dependencies": {
-    "@tanstack/react-form": "^1.1.0",
+    "@tanstack/react-form": "^1.1.2",
     "arktype": "^2.0.0",
     "react": "^19.0.0",
     "react-dom": "^19.0.0",
diff --git a/examples/react/tanstack-start/package.json b/examples/react/tanstack-start/package.json
@@ -9,8 +9,8 @@
     "start": "vinxi start"
   },
   "dependencies": {
-    "@tanstack/form-core": "^1.1.0",
-    "@tanstack/react-form": "^1.1.0",
+    "@tanstack/form-core": "^1.1.2",
+    "@tanstack/react-form": "^1.1.2",
     "@tanstack/react-router": "^1.112.0",
     "@tanstack/react-start": "^1.112.0",
     "@tanstack/react-store": "^0.7.0",
diff --git a/examples/react/ui-libraries/package.json b/examples/react/ui-libraries/package.json
@@ -14,7 +14,7 @@
     "@mantine/core": "7.16.0",
     "@mantine/hooks": "7.16.0",
     "@mui/material": "6.4.0",
-    "@tanstack/react-form": "^1.1.0",
+    "@tanstack/react-form": "^1.1.2",
     "@yme/lay-postcss": "0.1.0",
     "postcss": "8.5.1",
     "postcss-preset-mantine": "1.17.0",
diff --git a/examples/solid/array/package.json b/examples/solid/array/package.json
@@ -9,7 +9,7 @@
     "preview": "vite preview"
   },
   "dependencies": {
-    "@tanstack/solid-form": "^1.1.0",
+    "@tanstack/solid-form": "^1.1.2",
     "solid-js": "^1.9.4"
   },
   "devDependencies": {
diff --git a/examples/solid/simple/package.json b/examples/solid/simple/package.json
@@ -9,7 +9,7 @@
     "preview": "vite preview"
   },
   "dependencies": {
-    "@tanstack/solid-form": "^1.1.0",
+    "@tanstack/solid-form": "^1.1.2",
     "solid-js": "^1.9.4"
   },
   "devDependencies": {
diff --git a/examples/vue/array/package.json b/examples/vue/array/package.json
@@ -10,7 +10,7 @@
     "serve": "vite preview"
   },
   "dependencies": {
-    "@tanstack/vue-form": "^1.1.0",
+    "@tanstack/vue-form": "^1.1.2",
     "vue": "^3.5.13"
   },
   "devDependencies": {
diff --git a/examples/vue/simple/package.json b/examples/vue/simple/package.json
@@ -10,7 +10,7 @@
     "serve": "vite preview"
   },
   "dependencies": {
-    "@tanstack/vue-form": "^1.1.0",
+    "@tanstack/vue-form": "^1.1.2",
     "vue": "^3.5.13"
   },
   "devDependencies": {
diff --git a/packages/angular-form/package.json b/packages/angular-form/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/angular-form",
-  "version": "1.1.0",
+  "version": "1.1.2",
   "description": "Powerful, type-safe forms for Angular.",
   "author": "tannerlinsley",
   "license": "MIT",
diff --git a/packages/form-core/package.json b/packages/form-core/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/form-core",
-  "version": "1.1.0",
+  "version": "1.1.2",
   "description": "Powerful, type-safe, framework agnostic forms.",
   "author": "tannerlinsley",
   "license": "MIT",
diff --git a/packages/form-core/src/FieldApi.ts b/packages/form-core/src/FieldApi.ts
diff --git a/packages/lit-form/package.json b/packages/lit-form/package.json
diff --git a/packages/lit-form/src/tanstack-form-controller.ts b/packages/lit-form/src/tanstack-form-controller.ts
diff --git a/packages/react-form/package.json b/packages/react-form/package.json
diff --git a/packages/react-form/tests/useField.test.tsx b/packages/react-form/tests/useField.test.tsx
diff --git a/packages/solid-form/package.json b/packages/solid-form/package.json
diff --git a/packages/vue-form/package.json b/packages/vue-form/package.json
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml

Original file line number	Diff line number	Diff line change
@@ -49,4 +49,4 @@ The `form.Subscribe` component is best suited when you need to react to somethin
`49`	`49`
`50`	`50`	> The `form.Subscribe` component doesn't trigger component-level re-renders. Anytime the value subscribed to changes, only the `form.Subscribe` component re-renders.
`51`	`51`
`52`		-The choice between whether to use `useStore` or `form.Subscibe` mainly boils down to that if it's rendered in the ui, reach for `form.Subscribe` for its optimizations perks, and if you need the reactivity within the logic, then `useStore` is the choice to make.
	`52`	+The choice between whether to use `useStore` or `form.Subscribe` mainly boils down to that if it's rendered in the ui, reach for `form.Subscribe` for its optimizations perks, and if you need the reactivity within the logic, then `useStore` is the choice to make.